dsh-toolkit — DeepSeek Harness 好用化工具箱

状态：pre-alpha（开发者预览） 本仓库围绕 DeepSeek Harness 官方 Discussions 2764 帖挖掘出的 173 条真实痛点开发。 ⚠️ 诚实声明：DSH 官方明确「未来将出现破坏兼容性的变更」，本仓库所有包随 DSH 快速迭代； 版本号代表仓库演进，不代表生产可用性。详见下方「完成度矩阵」。

这仓库是什么 / 不是什么

是：围绕真实痛点的开源尝试——环境体检、中文知识库、3 个最小插件、可靠性控制层（Guardian）。 不是：开箱即用的生产工具。它处于 pre-alpha，部分包只有工具层、缺 UI/持久化（见完成度矩阵）。

完成度矩阵（诚实版）

包	定位	工具层	UI	持久化	测试	真实 DSH 安装验证	说明
packages/dsh-doctor	环境体检 CLI（8 项）	✅	—	—	✅ 3/3	—（CLI 直跑）	v0.1 可用
packages/guardian	可靠性控制层（scan/plan/apply/verify/rollback，15 项检测）	✅	—	✅ 凭证+备份	✅ 7/7	✅ web 配置可解析	新增主推；scan 检测 15 项
packages/dsh-at-file	@ 引用工作区文件	✅ 工具层	❌ 无 composer @ 弹窗	—	✅ 5/5	✅ 可安装可加载	UI 是已知缺口（贡献点）
packages/dsh-cost-dashboard	会话费用估算	✅ 工具层	❌ 无仪表盘	❌ 仅内存	✅ 4/4	✅ 可安装可加载	持久化+预算告警是缺口（贡献点）
packages/dsh-vision-bridge	图片→VLM→文本桥	✅ 最小 API 原型	—	—	✅ 4/4	✅ 可安装可加载	依赖外部 VLM 上游
docs/	中文知识库 11 篇	—	—	—	—	—	含 173 痛点全集 + 20 方向
promo/	推广素材 4 件套	—	—	—	—	—	公众号/B站/小红书/X

图例：✅ 已实现并验证 · ❌ 已知缺口（欢迎贡献） · — 不适用

快速开始

# 0. 环境体检（15 项，含配置可解析/插件格式/凭据权限）
node packages/guardian/src/guardian.mjs scan
node packages/guardian/src/guardian.mjs verify   # 生成机器可读验收凭证

# 1. 测试（23 个用例）
npm install
npm test

# 2. 插件真实安装验证（隔离 DSH_HOME）
node scripts/verify-install.mjs packages/dsh-at-file web

给 DSH 的建议插件（独立于本仓库，成熟度高）

dsh plugin --profile web add dshmarket
dsh plugin --profile web add @liustack/modlens@3.17.2    # 视觉（锁版本！）
dsh plugin --profile web add @linxin666/dsh-web-ui-all    # Web UI 全家桶

为什么值得看 / 值得贡献

• 痛点驱动：每个包对应官方 Discussions 真实帖号（见各包 README），不拍脑袋
• 诚实标注：完成度矩阵明示每包缺什么——贡献点清晰
• 可验证：23/23 测试 + 真实 DSH 安装验证（隔离环境）+ CI green
• 官方路径：DSH 暂不收 PR，但欢迎插件/文档/带补丁报告——本仓库是这三件事的合集
• MIT：放心用、放心改、放心传播

生态定位（不卷插件数量）

三个插件方向已有社区领先者（视觉 modlens 2.7k★、@file omdsh-dev/dsh-at-file 318★、成本 dsh-web-ui 3.9k★）。 本仓库的差异化是 Guardian 控制层——回答生态里没人回答的：能不能装、会不会坏、能不能恢复、证据在哪。

目录

dsh-toolkit/
├── packages/
│   ├── guardian/           # 🛡 可靠性控制层（scan/plan/apply/verify/rollback）★主推
│   ├── dsh-doctor/         # 环境体检 CLI（8 项，guardian scan 前身）
│   ├── dsh-at-file/        # @ 文件引用工具（UI 缺口）
│   ├── dsh-cost-dashboard/ # 费用估算工具（持久化缺口）
│   └── dsh-vision-bridge/  # 视觉桥工具（依赖外部 VLM）
├── docs/                   # 中文知识库（173 痛点/20 方向/兼容矩阵）
├── scripts/                # verify-install / verify-format
├── promo/                  # 推广素材
├── CONTRIBUTING.md
└── LICENSE                 # MIT

License

MIT © SIMON-WORLD