面向在 Agent harness 上做应用的工程师。你已经会写插件、调 persona。这篇讲一件更朴素的事:一个员工的定义,是怎么变成一个能跑的进程目录的 —— 以及这一步里那些「违反时不报错」的坑。
案例来自本仓库:跑在 DeepSeek Harness(dsh)上的钉钉数字员工。入口是
make build,实现在bin/employee的build()。dsh 底座本身的理念与细节,见 DSH 微内核架构:数字员工的 To B 哲学 和 一切皆插件:DeepSeek Harness 真正硬核的是三个细节;本篇只讲组装的工程。
一、为什么叫「编译」
这个项目里没有 tsc、没有 webpack,但有一个货真价实的编译步骤:
employees/<name>/ ──make build──▶ var/<name>/ ──make start──▶ dsh 进程
(源:SPEC + patch) (产物:profile)
把它当编译看,是因为它满足编译的三个性质:
- 确定性:同一份源(
_base.patch.yml+_runtime.patch.yml+ 员工patch.yml+ 锁文件)产出同一个 profile。 - 单一事实来源:「这个员工能干什么」只看源,不看产物。产物里改的东西下一次 build 就没了。
- 产物可丢弃:
var/<name>/整目录 gitignore,删掉重跑 build 即可重建(会话状态除外,那是运行期数据,不是产物)。
第 3 条反过来约束了设计:凡是必须手工在产物目录里做一次的事,都是 bug。 后面会看到好几处为此付出的代价。
仓库里其实有三个编译步骤,形状一样:
| 编译 | 源 | 产物 | 入口 |
|---|---|---|---|
| profile 组装 | employees/ + 插件 | var/<name>/profile/ | make build |
| 知识库索引 | knowledge/ + manifest | var/kb/index.json | make kb-compile |
| npm 运行模板 | 已跟踪的公开源文件 | dist/template/ | pnpm run build:npm |
本文主讲第一个,第二个在第八节。
[Read More]