把数字员工「编译」出来:profile 组装里的静默坑

Compiling a Digital Employee: The Silent Traps of Profile Assembly

面向在 Agent harness 上做应用的工程师。你已经会写插件、调 persona。这篇讲一件更朴素的事:一个员工的定义,是怎么变成一个能跑的进程目录的 —— 以及这一步里那些「违反时不报错」的坑。

案例来自本仓库:跑在 DeepSeek Harness(dsh)上的钉钉数字员工。入口是 make build,实现在 bin/employee 的 build()。dsh 底座本身的理念与细节,见 DSH 微内核架构:数字员工的 To B 哲学 和 一切皆插件:DeepSeek Harness 真正硬核的是三个细节;本篇只讲组装的工程。

Compiling a Digital Employee: The Silent Traps of Profile Assembly

一、为什么叫「编译」

这个项目里没有 tsc、没有 webpack,但有一个货真价实的编译步骤:

employees/<name>/   ──make build──▶   var/<name>/   ──make start──▶   dsh 进程
(源:SPEC + patch)                    (产物:profile)

把它当编译看,是因为它满足编译的三个性质:

  1. 确定性:同一份源(_base.patch.yml + _runtime.patch.yml + 员工 patch.yml + 锁文件)产出同一个 profile。
  2. 单一事实来源:「这个员工能干什么」只看源,不看产物。产物里改的东西下一次 build 就没了。
  3. 产物可丢弃:var/<name>/ 整目录 gitignore,删掉重跑 build 即可重建(会话状态除外,那是运行期数据,不是产物)。

第 3 条反过来约束了设计:凡是必须手工在产物目录里做一次的事,都是 bug。 后面会看到好几处为此付出的代价。

仓库里其实有三个编译步骤,形状一样:

编译源产物入口
profile 组装employees/ + 插件var/<name>/profile/make build
知识库索引knowledge/ + manifestvar/kb/index.jsonmake kb-compile
npm 运行模板已跟踪的公开源文件dist/template/pnpm run build:npm

本文主讲第一个,第二个在第八节。

[Read More]