五个 Lab

从跑起来读插件树，到零 fork 换 provider，再到让 agent 现场造工具。每个 Lab 结尾都有同题对比。

最后核对于 v0.1.1-rc.2 · commit b150a551b8 · 2026-08-22

五个 Lab，从「跑起来」一路到「让 agent 现场造工具」。它们互为前置，但每一个都能独立读完。

每个 Lab 的结尾都有一个固定栏目：同样这件事，在别家要几步。对比即教学——一件事在这里是两段配置、在别处是一个 fork，这个差异比任何架构图都直观。

先说清楚哪些步骤本站没有替你跑过

命令与配置形态取自本仓库的源码、README 与 CLI 参考（核对于 commit b150a55），但本站没有在你的机器上跑过它们。凡是依赖你本地环境或第三方 API key 的步骤，都标了待核对。跑不通时，以 dsh --help 和仓库当前的 apps/cli/reference/README.md 为准。

五个 Lab

#	Lab	你会得到什么	时长
01	跑起来 + 读懂插件树	一双能读 `--dump-config` 的眼睛，和一份你自己机器上的插件清单	30 min
02	零 fork 换掉一个 provider	一份属于你的 profile 补丁层；仓库改动行数：0	20 min
03	写一个最小的树外插件	一个 prompt section + 一个工具，装在 profile 里	45 min
04	复刻一个 web search provider	照着真实 provider 的骨架裁出的一个新后端	60 min
05	让 agent 现场造一个工具	七个 `cordis_*` 动词走一遍，看见「注册即 effect」	25 min

开始之前：一次性准备

Node ^22.19 || >=24，以及 pnpm（仓库锁在 [email protected]）
一个 DEEPSEEK_API_KEY（Lab 1 之后的每一个都要真跑一次对话）
一个你不介意弄坏的 profile。别拿你天天用的那个做实验。

两种跑法，Lab 里都能用：

从 npm 跑（不需要 clone）

$ npx @deepseek-ai/dsh web

从源码跑（Lab 4 需要）

$ git clone https://github.com/deepseek-ai/deepseek-harness.git
$ cd deepseek-harness
$ pnpm install
$ pnpm run build      # 准备仓库产物
$ pnpm dsh web        # 用刚才的产物跑，不重新构建