本地工具箱 HiWhaleW/dsh-toolbox

DSH Toolbox

DeepSeek Harness 的本地优先工具箱。
产品调研、上下文切换、插件预检、兼容性监控，全都收进一个以安全为核心的图形控制面板。

在线交互演示

五分钟安装

反馈问题

[!NOTE]
在线版本是安全的演示：健康检查、Bundle 开关、变更计划、活动记录和回滚都在当前浏览器内存里模拟，刷新即重置。它绝不会连接访客的电脑，也不会读取 DSH 配置档、API 凭据或 SQLite 数据。想接入真实的 DSH 工作流，请安装本地版本。

[!IMPORTANT]
实验性 MVP · 仅限非商业用途。 DeepSeek Harness 仍处于 Developer Preview 阶段，升级可能影响配置档 Bundle 的兼容性。本项目独立开发，与 DeepSeek 无隶属关系，也未获其背书。

DSH Toolbox 是什么？

DSH Toolbox 是 DeepSeek Harness 的配套工具，面向个人、本地优先的工作流。四个插件以原生 DSH 配置档 Bundle 的形式运行。DSH Switchboard 跑在活动的 Harness 进程之外，用来检查配置档、跑健康检查、预览 Bundle 变更、创建备份，并安全回滚变更。

默认没有账号、没有托管后端、没有行为分析、没有遥测、没有后台注册表检查，也不会自动升级。真实运行时数据留在本地 SQLite。配置档变更一律先出计划，写入前需要用户确认，并留下可审计的事务记录。

五个组件

| 组件 | 日常用途 | 工具数 |
| @dsh-toolbox/product-research-workbench | 导入 URL 或文本证据，整理发现，评估机会，备份项目，生成 Markdown/HTML 报告。 | 12 |
| @dsh-toolbox/context-switchboard | 把任务路由到有界上下文，激活原生运行时上下文，并支持回滚。 | 10 |
| @dsh-toolbox/plugin-preflight | 安装前检查本地 Bundle，涵盖包语义、能力、策略、SBOM 数据和指纹。 | 2 |
| @dsh-toolbox/compatibility-radar | 发现 Bundle，与目标运行时对比，保存并比较快照，生成升级报告。 | 7 |
| @dsh-toolbox/dsh-switchboard | 发现 DSH 配置档，检查 Bundle，规划并校验变更，创建备份和报告，安全回滚。 | 命令行 / 控制平面 |

前四个组件是各自独立安装的 DSH 配置档 Bundle。第五个是统一的本地控制平面。Product Research Workbench 及相关报告支持 Markdown 和 HTML 输出，运行时数据默认存入 SQLite。

在线演示 vs. 本地安装

| 能力 | 在线演示 | 本地安装 |
| 浏览四个视图和固定活动侧边栏 | 可用 | 可用 |
| 切换配置档、筛选活动、查看 Bundle 方案 | 在浏览器内存中模拟 | 连接真实本地数据 |
| 运行 dsh --dump-config 健康检查 | 模拟成功结果 | 真实执行命令 |
| 写入配置档、创建备份、回滚、生成报告 | 不写入；刷新后重置 | 确认方案后真实执行 |
| 数据去向 | 当前浏览器内存 | 用户电脑上的 SQLite 和私有目录 |

环境要求

- Node.js ^22.19.0 || >=24.0.0（内置 node:sqlite）
- npm，用于打包本地 bundle
- @deepseek-ai/dsh@0.1.1-rc.2
- 一个你有权修改的本地 DSH 配置档

只读的 Switchboard 检查不需要 PATH 上有 DSH 命令行。应用或回滚变更默认需要命令行，因为 dsh --profile <name> --dump-config 成功执行才是运行时安全闸门。

经过测试的运行时组合如下：

| 组件 | 测试版本 |
| DeepSeek Harness | 0.1.1-rc.2 |
| DSH Tools | 0.1.1-rc.2 |
| Cordis | 4.0.1 |
| Node.js | 24.x 以及声明的 22.19+ 范围 |

CI 在 Ubuntu 上以 Node.js 22.19.0 和 24.x 运行完整的检查与打包 dry-run 矩阵。另有 windows-latest 任务，验证 Switchboard 能否在不启用 shell 执行的情况下检测并执行 npm 安装的 dsh.cmd shim。

如果还没有固定版本的 DSH 命令行，先安装：

npm install --global @deepseek-ai/dsh@0.1.1-rc.2
dsh --version

五分钟安装

克隆源码，创建四个 npm tarball，然后安装到一个 DSH 配置档：

git clone https://github.com/HiWhaleW/dsh-toolbox.git
cd dsh-toolbox

mkdir -p dist
npm pack --workspace @dsh-toolbox/product-research-workbench --pack-destination dist
npm pack --workspace @dsh-toolbox/context-switchboard --pack-destination dist
npm pack --workspace @dsh-toolbox/plugin-preflight --pack-destination dist
npm pack --workspace @dsh-toolbox/compatibility-radar --pack-destination dist

dsh plugin --profile toolbox add ./dist/dsh-toolbox-product-research-workbench-0.2.1.tgz
dsh plugin --profile toolbox add ./dist/dsh-toolbox-context-switchboard-0.2.1.tgz
dsh plugin --profile toolbox add ./dist/dsh-toolbox-plugin-preflight-0.2.1.tgz
dsh plugin --profile toolbox add ./dist/dsh-toolbox-compatibility-radar-0.2.1.tgz

dsh --profile toolbox --dump-config

最后一条命令应该会显示全部四个 bundle 层。用同一个配置档启动 DSH： sh
dsh --profile toolbox

你也可以只安装自己需要的 tarball。打包不会执行插件代码，也不需要先装好仓库依赖。在仓库根目录执行 npm install 之后，也可以直接从 checkout 路径安装，但 tarball 更符合 npm 打包语义，是经过验证的可移植流程。

每个包都固定了少量 DSH 工具定义运行时，用来保证在树外安装时也能可靠运行。没有安装生命周期脚本。

打开 DSH Switchboard GUI

DSH Switchboard 是 DeepSeek Harness 的本地设置应用。它会显示装了哪些配置档和配置档 bundle，检查某个配置档能否启动，预览每一处改动，并保留备份，以便安全回滚。

导航会在中间面板打开四个工作视图：

- DSH Profiles —— 查看配置档，运行它的 DSH 健康检查，查看已安装的 bundle，规划启用/停用改动。
- Plugins —— 查看 bundle 清单及其兼容性状态。
- Activity —— 查看本地计划、校验、已应用的改动和回滚。
- Settings —— 查看检测到的 DSH 运行时和本地数据位置。

你在视图之间切换时，右侧会一直显示最近的活动记录。长列表在各自面板内部滚动，所以整个应用框架保持固定，始终清晰可读。

本地备份对话框还有一个明确的 Back up now 操作。这些手动配置档快照之后可以恢复；恢复某个快照之前，Switchboard 会先把当前配置档保存为新的恢复点，然后恢复选中的快照，并运行 DSH 配置校验。如果校验失败，它会尝试自动回到那个恢复点。

从仓库 checkout 运行： sh
pnpm install --frozen-lockfile
pnpm switchboard:gui

然后打开 http://127.0.0.1:4173/。服务器只监听本机。它从 $DSH_HOME/profiles 读取配置档，从不显示 API 凭据的值，写入配置档文件之前必须先经过一步确认。

从命令行使用 DSH Switchboard

Switchboard 目前是以源码分发的技术预览版，不是任何 DSH 配置档的 npm 依赖。从 checkout 运行： sh
npm run switchboard -- detect
npm run switchboard -- profiles
npm run switchboard -- inspect toolbox
npm run switchboard -- health toolbox
npm run switchboard -- backup toolbox

backup 命令会立刻把当前配置档保存成可恢复的快照，存放在 Switchboard 的私有本地数据目录里。恢复手动快照时，会先创建一个新的恢复点，再用 DSH 校验恢复后的配置档。

变更类命令都先出计划，只有带上 --apply 才会真正改动：

npm run switchboard -- bundle disable toolbox @dsh-toolbox/context-switchboard
npm run switchboard -- bundle disable toolbox @dsh-toolbox/context-switchboard --apply
npm run switchboard -- history

Switchboard 会保留 SHA-256 状态指纹、原子写入备份和 SQLite 回执。它会拒绝过期计划，也不会在用户后续编辑之后强行回滚。参见 Switchboard README 和 architecture RFC。

如何使用这些插件

这些包在 DSH 内部注册工具，并不是独立的 shell 命令。让智能体运行指定的工具，或者描述你想要的结果，由 DSH 来挑选。

Product Research Workbench

建议流程：

research_create → research_add_source → research_extract
→ research_evidence_add (optional human correction)
→ research_analyze → research_report

示例请求：

Create a research project called "Local AI research workflows".
Import this pasted interview text, extract evidence, analyze the opportunities,
and generate both Markdown and HTML reports.

URL 导入接受公开、无需认证的 http(s) 页面。默认会拦截 loopback、私有、link-local、metadata 以及其他非公开目标。需要认证的抓取、浏览器 cookie、绕过 CAPTCHA、社交媒体爬取都不在 MVP 范围内。

Context Switchboard

建议流程：

context_profile_save → context_route → context_activate
→ context_current / context_history → context_rollback

示例请求：

Save a context profile named "DSH plugin development" with the keywords
"dsh", "cordis", and "plugin"; use a 1,200-token budget. Route this task,
activate the best profile, and show me the activation receipt.

激活走的是 DSH 原生的 systemPrompt.context() 注册表。它只贡献一份有大小限制的运行时上下文快照，不会替换部署人设、沙箱策略或审批策略。

Plugin Preflight

示例请求：

Run plugin_preflight_scan on packages/context-switchboard and explain every
finding before I install it. Then create the Markdown and HTML audit report.

Preflight 是静态、只读的：它不运行脚本、不安装依赖、不跟随符号链接、也不访问注册表。扫描干净并不等于安全保证。

Compatibility Radar

示例请求：

Discover DSH bundles under packages, check them against DSH Tools 0.1.1-rc.2,
Cordis 4.0.1 和你当前的 Node 版本，然后保存一份兼容性快照。

改动 DSH 或 Cordis 版本之前，再保存一份快照，用 compatibility_diff 或 compatibility_report 找出回归问题。Radar 从不自动升级软件。

本地数据与输出

| 插件 | 默认本地数据 |
| Product Research Workbench | ~/.local/share/dsh-toolbox/product-research-workbench |
| Context Switchboard | ~/.local/share/dsh-toolbox/context-switchboard |
| Plugin Preflight | ~/.local/share/dsh-toolbox/plugin-preflight |
| Compatibility Radar | ~/.local/share/dsh-toolbox/compatibility-radar |
| DSH Switchboard | ~/.local/share/dsh-toolbox/dsh-switchboard |

这些插件和控制平面使用 SQLite，并在适用时生成 Markdown 和自包含 HTML 报告。生成的报告不加载任何远程脚本。仓库的 .gitignore 已排除运行时数据库、报告、导出、会话、环境文件和 cookie，但每次提交前你仍应检查暂存的改动。

研究报告和导出可能包含源文本、引文、URL、本地路径、项目名称、受版权保护的材料或个人信息。分享前请先审阅。完整边界见 PRIVACY.md 和 SECURITY.md。

许可证：仅限非商业用途

DSH Toolbox 0.2.1 及更高版本以源码公开形式发布，采用 PolyForm Noncommercial License 1.0.0。

许可证允许的用途包括个人学习、研究、实验、业余项目、教育、慈善/非营利工作、公共研究、公共安全、环境保护，以及许可证定义的政府工作。

不允许商业用途。 不得将本软件、修改版本或衍生作品用于直接或间接的商业利益，包括付费产品或服务、创收运营、商业咨询交付物，或内部业务收益。若本摘要与许可证原文有出入，以许可证原文为准。

此限制适用于 DSH Toolbox 原始代码。DeepSeek Harness、Cordis、DSH Tools 及其他依赖仍遵循各自的许可证；见 THIRD_PARTY_NOTICES.md。

历史说明：此前已按 MIT 分发的旧版本副本，仍受随附于这些副本的授权约束。0.2.1 的许可证变更不追溯撤销已授予的权利。

贡献

贡献前请阅读 CONTRIBUTING.md 和行为准则。提交贡献即表示你同意其可按仓库当前的非商业许可证分发。