规格文档库 showjiangnan/dsh-specs

DSH 智能开发规格库

本仓库把 DeepSeek Harness（简称 DSH，一个把模型、工具、会话和界面组合成智能编码程序的插件式框架）的产品、架构、运行流程、扩展点与质量约束整理成适合 Codex、Claude Code 等智能编码工具按需读取的文档工程。它服务于两类工作：基于 DSH 做长期二次开发，以及为 DSH 开发新的插件、能力提供方和集成服务。

这里不包含 DSH 产品源码，也不能单独构建或运行 DSH。文档是从上游源码仓库的固定 commit 提取并复核的规格快照；开始实现前，编码工具仍须在匹配的源码 checkout 中核对代码、测试和配置。

最短接管路径

建议把规格库与源码仓库放在同一个工作区：

工作区/ ├── deepseek-harness/ # DSH 源码 └── dsh-specs/ # 本规格库

让智能编码工具依次读取：

1. AGENTS.md：本仓库的读取、证据和维护规则；
2. 智能编码工具接管指南：按任务控制上下文范围；
3. ARCHITECTURE.md：系统级短入口；
4. 文档导航：进入产品、前端、后端、质量或具体子系统。

给 Codex 或 Claude Code 的首条指令可以是：

先阅读 dsh-specs/AGENTS.md 和 dsh-specs/docs/开发/智能编码工具接管指南.zh.md。
本次任务是：。
以 dsh-specs 作为导航和约束，以 deepseek-harness 当前源码与测试作为实现事实；区分已验证事实、文档声明和推断，并引用具体文件与符号。

Claude Code 会通过根目录的 CLAUDE.md 读取同一份代理说明；支持 AGENTS.md 的工具可直接从根目录建立上下文。

文档地图

| 区域 | 回答的问题 |
| docs/产品/ | DSH 为谁解决什么问题，当前承诺和假设是什么 |
| docs/架构/ | 系统如何组合，模块如何依赖，运行时怎样流动 |
| docs/前端/ | 浏览器端如何启动、管理状态、扩展和渲染 |
| docs/后端/ | Host 如何启动、处理请求、持久化并隔离执行 |
| docs/开发/ | 如何搭建源码、理解框架并开发插件 |
| docs/参考/ | 服务、事件、类型、工具和配置的查阅材料 |
| docs/质量/ | 测试、安全、可靠性和变更证据要求 |
| docs/规划/ | 有边界的进行中计划与仍有价值的完成记录 |

文档文件使用中文语义名；无 .zh 后缀的文件保存英文内容，.zh.md 保存简体中文内容，配套 .i18n.yaml 记录两种语言最后一次确认一致时的内容哈希。

来源与可信边界

当前文档整理提交是 e72527180a3ccde6378944b021b9440572ab17e4，它直接基于公开上游 commit 47f943859bef60e4160492346772ded9b24f765a。内部文档链接留在本仓库；未收录的源码、测试、配置、生成器和完整决策历史固定到公开上游基线，避免上游后续变化悄悄改写当前快照的含义。

完整的提取范围、同步步骤和冲突处理见来源与同步。实现时若使用不同的上游 commit，必须把差异列为待验证项，不能把本仓库文档当作比当前代码更高的事实来源。

维护与校验

本仓库的校验器只使用 Node.js 标准库，不需要安装依赖：

npm run docs:check
git diff --check

它检查中文语义路径、Markdown 本地链接与锚点、双语配对结构、配对哈希和文本结尾。DSH 的构建、测试、类型检查、生成 freshness（生成结果是否仍与源码一致）和运行验证必须在上游源码 checkout 中完成。

维护者：showjiangnan。许可证沿用上游项目，见 LICENSE。