HiWhaleW/dsh-toolbox

DSH Toolbox

面向 DeepSeek Harness 的本地优先工具箱。
将产品研究、上下文切换、插件预检和兼容性监控整合在一个注重安全的可视化控制面板中。

在线交互演示
·
五分钟安装
·
报告问题

[!NOTE]
在线版本是一个安全的演示：健康检查、Bundle 开关、变更计划、活动和回滚均在当前浏览器的内存中模拟，刷新后即重置。它绝不会连接到访问者的计算机，也不会读取 DSH Profile、API 凭据或 SQLite 数据。请安装本地版本以连接真实的 DSH 工作流。

[!IMPORTANT]
实验性 MVP · 仅限非商业用途。 DeepSeek Harness 仍处于 Developer Preview 阶段，升级可能会影响 Profile Bundle 的兼容性。本项目为独立开发，与 DeepSeek 无关联，也未获得其认可。

什么是 DSH Toolbox？

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

默认情况下，没有账户、托管后端、行为分析、遥测、后台注册表检查或自动升级。真实运行时数据保留在本地 SQLite 中。Profile 变更始终从计划开始，写入前需要用户确认，并留下可审计的事务记录。

五个组件

| 组件 | 日常用途 | 工具数 |
| --- | --- | ---: |
| @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 Profile，检查 Bundle，规划并验证变更，创建备份和报告，并安全回滚。 | CLI / 控制平面 |

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

在线演示与本地安装

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

要求

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

只读的 Switchboard 检查无需 PATH 上的 DSH CLI 即可工作。应用或回滚变更默认需要该 CLI，因为成功的 dsh --profile  --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 CLI，请安装它：

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

五分钟安装

克隆源代码，创建四个 npm tarball，并将它们安装到一个 DSH profile 中：

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 distsh
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 层。使用相同的 profile 启动 DSH：
sh
dsh --profile toolbox

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

每个包都固定了可靠地进行树外安装所需的小型 DSH 工具定义运行时。没有安装生命周期脚本。

打开 DSH Switchboard GUI

DSH Switchboard 是 DeepSeek Harness 的本地设置应用。它会显示已安装的 Profile 和 Profile Bundle，检查某个 Profile 是否可以启动，预览每一处更改，并保留备份，以便安全地回滚更改。

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

- DSH Profiles — 检查某个 Profile，运行其 DSH 健康检查，查看已安装的 Bundle，并规划启用/禁用更改。
- Plugins — 查看 Bundle 清单及其兼容性状态。
- Activity — 检查本地计划、验证、已应用的更改和回滚。
- Settings — 查看检测到的 DSH 运行时和本地数据位置。

当你在各视图之间切换时，最近的活动会始终显示在右侧。长列表会在各自的 panel 内滚动，因此整个应用框架保持固定且易读。

本地备份对话框还提供了一个明确的 Back up now 操作。这些手动 Profile 快照可以在之后恢复；在恢复某个快照之前，Switchboard 会先将当前 Profile 保存为新的恢复点，然后恢复选定的快照并运行 DSH 配置验证。如果验证失败，它会尝试自动返回到该恢复点。

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

然后打开 http://127.0.0.1:4173/。服务器仅监听本地计算机。它从 $DSH_HOME/profiles 读取 Profile，绝不显示 API 凭据值，并且在写入 Profile 文件之前需要经过一个审查步骤。

从命令行使用 DSH Switchboard

Switchboard 目前是一个以源码分发的技术预览版，并且不是任何 DSH profile 的 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 命令会立即将当前 Profile 的可恢复快照保存到 Switchboard 的私有本地数据目录中。恢复手动快照时，会先创建一个新的恢复点，并使用 DSH 验证恢复后的 Profile。

变更类命令采用计划优先（plan-first）策略，除非带有 --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 和 架构 RFC。

如何使用这些插件

这些包在 DSH 内部注册工具；它们不是独立的 shell 命令。请让 agent 运行指定的工具，或者描述期望的结果，让 DSH 自行选择。

产品研究工作台

建议流程：

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) 页面。默认情况下，它会阻止回环地址、私有地址、链路本地地址、元数据地址以及其他非公开目标。需要身份验证的爬取、浏览器 Cookie、绕过 CAPTCHA 以及社交媒体抓取均不在 MVP 范围内。

上下文 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() 注册表。它会贡献一个有界的运行时上下文快照，并且不会替换部署 persona、沙箱策略或审批策略。

插件预检

示例请求：

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

预检是静态且只读的：它不会运行脚本、安装依赖、跟随符号链接或联系注册表。扫描结果干净并不构成安全保证。

兼容性雷达

示例请求：

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 报告。生成的报告不加载任何远程脚本。运行时数据库、报告、导出文件、会话、环境文件和 Cookie 均被仓库的 .gitignore 排除，但你在每次提交前仍应检查暂存的更改。

研究报告和导出文件可能包含源文本、引文、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 和行为准则。提交贡献即表示你同意其可依据本仓库当前的非商业许可证进行分发。