深度参考：给"想真正开发 DSH"的你
主线四课带你从入门到精通（会用 → 懂 → 用它做东西 → 把它调成合自己用）。如果你还想更往下钻——想真正搞懂 DSH 内部怎么组织、怎么按它的真实接口写东西——这里是给你备的深度参考。
这里的内容对应真源码（我读的是机器上这套
@deepseek-ai/dsh的中文说明文档）。主线里只"点到为止"，深度、证据、真格式都放这儿。
这里有什么
| 页面 | 讲什么 | 适合谁 |
|---|---|---|
| 文件系统 | 系统对象 + 三向索引 + 带证据的一次旅程——DSH 到底怎么组织数据 | 想懂"数据从哪来、去哪"的 |
| 真实接口 | 接口清单 + agent/工具事件 + defineTool 真例 + 插件加载 | 真要写工具/插件的 |
| 定位速查 | "我想干嘛 → 去哪个文件 + 命令 + 模块" 一张表 | 想快速找到动哪儿的 |
一句话读懂 DSH 的内容分层
目录只是表象；DSH 其实是"一组对象 + 一组读写它们的过程"。 你只要记住：
- 配置区（
~/.dsh）＝你的偏好（设置/角色/会话/凭证） - 工作区（
D:\DSH）＝你干活（项目/技能/工作协议） - 框架本体（desktop-shell/…/node_modules/@deepseek-ai）＝系统引擎（别乱动）
红线（比技巧重要）
- 别名/密钥（
.credentials.yaml）：含密钥，别外泄、别提交到 git。 - 框架本体（
node_modules/@deepseek-ai/*）：系统的东西，别改，要扩展用ctx.*接缝。 - 会话目录（
.dsh/sessions/）：过程记录，别手动删，会丢历史。