Appearance
参考资料与出处索引
本章把所有章节引用的来源汇总为索引，方便统一查证。所有内容以 deepseek-ai/deepseek-harness
main分支 HEAD 为准；本地源码镜像位于deepseek-harness-src/。
项目主页与入门
| 资源 | 说明 | GitHub |
|---|---|---|
| 项目 README（中） | 简介、运行、社区 | README.zh.md |
| dsh CLI README | 入口模式、参数归属、profile | apps/cli/README.md |
| 用户指南 | Web UI 使用、模型配置、Python SDK | docs/user/ |
| Cordis | 底层插件框架 | github.com/cordiverse/cordis |
| Cordis 论文 | A Programming Paradigm for Spatiotemporal Composability | github.com/cordiverse/paper |
官方架构与概念文档
| 资源 | 说明 |
|---|---|
| docs/architecture.md | 架构：组合、核心包、事件、轮次流程、会话日志、seam、扩展归属 |
| docs/architecture.zh.md | 同上（中文） |
| docs/cordis-primer.md | Cordis 五个概念、派发模式、waterfall 语义、Loader 配置 |
| docs/cordis-tutorial/ | 七章动手教程（01 插件 → 07 进入 harness） |
| docs/capability-seams.md | 能力缝与核心服务全景（生成图 + 表格） |
| docs/module-graph.md | 包依赖图（生成） |
| docs/agent-lifecycle.md | 轮次/步骤时序图 |
| docs/tool-execution-pipeline.md | 工具执行管线可视化 |
| docs/event-producer-consumer.md | 事件生产方/消费方矩阵 |
| docs/defensive-patterns.md | 七条防御模式 |
| docs/glossary.md | 官方术语表 |
| docs/config-catalog.md | 插件配置目录（生成） |
| docs/tool-catalog.md | 全量工具目录（生成） |
| docs/persistence-catalog.md | 持久会话事件目录（生成） |
| docs/testing.md | 测试策略 |
| docs/development.md | 开发指南 |
| docs/subsystems/ | 每子系统一页参考（core、tools、session、sandbox、subagent、workflow、jobs、goal、schedule、compaction、spill、skills、web、plan、approval 等） |
| docs/cookbook/ | 实操手册（工具、LLM 适配器、包、Chat 节点等） |
关键包 README（按模块）
设计决策（Agent Notes 精选）
外部链接
- 仓库：github.com/deepseek-ai/deepseek-harness
- Discussions：GitHub Discussions
- 插件话题：github.com/topics/dsh-plugin
- npm 包：www.npmjs.com/package/@deepseek-ai/dsh
版本与时效声明
- 本站基于 2025 年 8 月的
main分支 HEAD 编写； - DSH 处于开发者预览阶段，API 可能破坏性变更；
- 本地镜像
deepseek-harness-src/为 shallow clone（depth 1），如需更新：git -C deepseek-harness-src fetch --depth 1 origin main && git -C deepseek-harness-src reset --hard origin/main。