跳至内容

DSH 读源码手账

基线 aa6c361a · 上游 0.1.1-rc.2社区自建 · 非官方2026 年 8 月

不用装环境,也不用 API key。这本手账把 DSH 拆成三块:课程、实验、索引。 左边盖你的章,右边挑一块开始——读完一条算一条。

从这里开始

我第一次来

先认六个词:插件、服务、事件、Profile、Bundle、Turn。 只读网页,什么都不装,读完你就能画出仓库的地图。

六个词读完,第一课就算过了,别贪多。

打开第一课 →

照着任务单走

不想做选择题就抄作业:15 分钟任务单按顺序点开页面,最后写下第一条带源码证据的学习记录 ——看过哪个文件、看到了什么、还没证明什么。

记录要落到具体文件上哦,「大概看懂了」不算数。

开始任务单 →

想动手写插件

先跑最小示例的单元测试和 lint。示例跑绿只证明示例没坏; 真实 DSH 的运行证据另算,教材里两种账分开记。

没跑过就写「已验证」……阿溟会顺着网线来找你的。

查看最小示例 →

顺手玩一下 · 一次 Turn 的形状

  1. 1输入进来
  2. 2组装请求
  3. 3模型与工具循环
  4. 4落成日志
  5. 5下一条 Turn

输入进来一条用户消息交给 Agent,一次 Turn 开始。

1 / 5

缩微模型只讲形状;能逐步验证的完整证据在Turn 流程实验室

整本手账的目录

① 认识 DSH

00 开始这里 · 01 仓库地图 · 02 Cordis 与插件树 · 25 动手任务单 · 27 工具预算决策卡

② 主链路精读

03 核心文件精读 · 04 Agent 与 Turn · 05 Session 日志与恢复 · 06 LLM 与工具执行 · 07 Host/Client 与发布

③ 插件与生态

10 扩展边界 · 11 写一个合规插件 · 13 工具插件契约 · 15 Bundle / Profile / Loader · 22 工具可见性 · 28 最小插件工作台

④ 实验与治理

16 学习工作簿 · 19 测试卸载证据 · 29 质量检查与审阅 · 33 可视化实验协议 · 34 作者的判断与理由

形象致敬社区的 DeepSeek 鲸鱼娘二创——原型:上善无形「溟月」、ZipZipPipe 女仆装版(CC BY-NC-SA 4.0,非商用)。 本站吉祥物为原创演绎,与 DeepSeek AI 无关。