波仔
🐳 附录 核心术语与快速演进
📄 一句话概括

DSH 主版本还是 0，接口、插件、配置都可能变——版本会变，判断不变，这是这一课唯一不失效的东西。

📝 本节和前面几节的关系

附录 A 收了术语；这一页是本课最后一篇，交代【它还在变】这件事。

一、版本这件事

本课实测：npx @deepseek-ai/dsh 拉到 0.2.0-rc.2。

所以本课所有实测数字都标了日期，以官方当期文档为准。

二、哪部分稳、哪部分活

把本课用到的数字分两类：

学前者，查后者——这也是 1.5 那句话的落地方式。

三、视觉模型与插件生态

教材把这两件列在【快速演进】里，道理是一样的：

两边一起变，中间那一层就得靠结构而不是靠接口活下来。

四、收官这一句

全书 95 篇讲下来，最结实的一条是：

版本会变，判断不变——

这四条不依赖任何一个函数名，也不依赖任何一个版本号。

五、动手 Demo：快速演进中的 DSH（附录 B）

本课实测的三条【现在的样子】：

facts = [("版本", "0.2.0-rc.2"), ("默认配置树", "1259 行"),
         ("顶层注册项", "183"), ("本课实验改动", "4~24 行")]
for k, v in facts:
    print("  %-11s %s" % (k, v))
print("  版本会变, 判断不变")

实跑输出：

--------------------------------------------------------------------
快速演进中的 DSH（附录 B）
--------------------------------------------------------------------
  本课实测的三条【现在的样子】：

  看的方面     实测到的情况                   该抱什么态度
  -------------------------------------------------------------------
  版本         npx 拉到 0.2.0-rc.2            主版本 0＝接口不承诺
  配置树       默认 1259 行，改动只差几行     结构稳、细节活
  插件生态     183 个注册项、一个包多入口     会长、会拆、会改名
  官方文档     以当前文档为准                 教材只是某一时刻的快照
  -------------------------------------------------------------------

  所以收官这句要写清：**版本会变，判断不变**——
  能力留接缝、边界先划、规矩只写一遍、一切留证据。

  这四条，是这一课唯一不随版本失效的东西。

版本会变，判断不变——这是全书唯一不随版本失效的一句。 把数字分两类：结构偏稳、数量偏活——学前者，查后者。 全书到此结束：导读 ＋ 8 章 ＋ 2 个附录，共 95 篇。

30 秒实验

  1. 去官方仓库看一眼当前版本号，跟你读这一课时记的比一比。
  2. 从本课抄下来的数字里，挑出三个【明天可能就变了】的。
  3. 把四条判断抄在便签上——它们不用改。

常见误区

  1. 错误：预览版的东西学了会白学。——纠正：预览版正适合看结构——接口还没定型时，哪些是权衡、哪些是必然，反而更清楚。
  2. 错误：数字变了，前面的笔记就废了。——纠正：数字是证据，不是结论——笔记里的判断依赖的是结构，不是那几个数。
  3. 错误：学完这一课就算是会 DSH 了。——纠正：学完的是怎么装一套 Harness——DSH 只是这套结构的一个现成实现。
自测三问（点开对答案） 1. 本课实测的版本号是多少？ —— **0.2.0-rc.2**——`0` 开头说明接口不承诺兼容，`rc` 说明还在预览候选。 2. 哪部分偏稳、哪部分偏活？ —— **结构偏稳**（平面／作用域／生命周期／管线／事实库），**数量与名字偏活**（183、58、具体包名与字段）——学前者，查后者。 3. 收官这一句是什么？ —— **版本会变，判断不变**——能力留接缝、边界先划、规矩只写一遍、一切留证据。

相关笔记