dsh-toolkit
August 24, 2026 · View on GitHub
状态：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