<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Dsh on All about Raspberry Pi</title><link>https://hugozhu.site/tags/dsh/</link><description>Recent content in Dsh on All about Raspberry Pi</description><generator>Hugo</generator><language>en</language><lastBuildDate>Tue, 17 Nov 2026 00:00:00 +0000</lastBuildDate><atom:link href="https://hugozhu.site/tags/dsh/index.xml" rel="self" type="application/rss+xml"/><item><title>把数字员工「编译」出来：profile 组装里的静默坑</title><link>https://hugozhu.site/post/2026/451-compiling-digital-employee-profile-assembly/</link><pubDate>Tue, 17 Nov 2026 00:00:00 +0000</pubDate><guid>https://hugozhu.site/post/2026/451-compiling-digital-employee-profile-assembly/</guid><description>&lt;blockquote&gt;
&lt;p&gt;面向在 Agent harness 上做应用的工程师。你已经会写插件、调 persona。这篇讲一件更朴素的事：&lt;strong&gt;一个员工的定义，是怎么变成一个能跑的进程目录的&lt;/strong&gt; —— 以及这一步里那些「违反时不报错」的坑。&lt;/p&gt;
&lt;p&gt;案例来自本仓库：跑在 DeepSeek Harness（dsh）上的钉钉数字员工。入口是 &lt;code&gt;make build&lt;/code&gt;，实现在 &lt;code&gt;bin/employee&lt;/code&gt; 的 &lt;code&gt;build()&lt;/code&gt;。dsh 底座本身的理念与细节，见 &lt;a href="https://hugozhu.site/post/2026/368-dsh-microkernel-to-b-philosophy/"&gt;DSH 微内核架构：数字员工的 To B 哲学&lt;/a&gt; 和 &lt;a href="https://hugozhu.site/post/2026/348-dsh-three-details-reversible-effects/"&gt;一切皆插件：DeepSeek Harness 真正硬核的是三个细节&lt;/a&gt;；本篇只讲组装的工程。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;a href="https://hugozhu.site/img/2026/compiling-digital-employee.png"&gt;&lt;img src="https://hugozhu.site/img/2026/compiling-digital-employee-thumb.jpg" alt="Compiling a Digital Employee: The Silent Traps of Profile Assembly"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2 id="一为什么叫编译"&gt;一、为什么叫「编译」&lt;/h2&gt;
&lt;p&gt;这个项目里没有 tsc、没有 webpack，但有一个货真价实的编译步骤：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-gdscript3" data-lang="gdscript3"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="n"&gt;employees&lt;/span&gt;&lt;span class="o"&gt;/&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;name&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;/&lt;/span&gt; &lt;span class="err"&gt;──&lt;/span&gt;&lt;span class="n"&gt;make&lt;/span&gt; &lt;span class="n"&gt;build&lt;/span&gt;&lt;span class="err"&gt;──▶&lt;/span&gt; &lt;span class="k"&gt;var&lt;/span&gt;&lt;span class="o"&gt;/&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;name&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;/&lt;/span&gt; &lt;span class="err"&gt;──&lt;/span&gt;&lt;span class="n"&gt;make&lt;/span&gt; &lt;span class="n"&gt;start&lt;/span&gt;&lt;span class="err"&gt;──▶&lt;/span&gt; &lt;span class="n"&gt;dsh&lt;/span&gt; &lt;span class="err"&gt;进程&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="err"&gt;（源：&lt;/span&gt;&lt;span class="n"&gt;SPEC&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="n"&gt;patch&lt;/span&gt;&lt;span class="err"&gt;）&lt;/span&gt; &lt;span class="err"&gt;（产物：&lt;/span&gt;&lt;span class="n"&gt;profile&lt;/span&gt;&lt;span class="err"&gt;）&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;把它当编译看，是因为它满足编译的三个性质：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;确定性&lt;/strong&gt;：同一份源（&lt;code&gt;_base.patch.yml&lt;/code&gt; + &lt;code&gt;_runtime.patch.yml&lt;/code&gt; + 员工 &lt;code&gt;patch.yml&lt;/code&gt; + 锁文件）产出同一个 profile。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;单一事实来源&lt;/strong&gt;：「这个员工能干什么」只看源，不看产物。产物里改的东西下一次 build 就没了。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;产物可丢弃&lt;/strong&gt;：&lt;code&gt;var/&amp;lt;name&amp;gt;/&lt;/code&gt; 整目录 gitignore，删掉重跑 build 即可重建（会话状态除外，那是运行期数据，不是产物）。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;第 3 条反过来约束了设计：&lt;strong&gt;凡是必须手工在产物目录里做一次的事，都是 bug。&lt;/strong&gt; 后面会看到好几处为此付出的代价。&lt;/p&gt;
&lt;p&gt;仓库里其实有三个编译步骤，形状一样：&lt;/p&gt;
&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;编译&lt;/th&gt;
 &lt;th&gt;源&lt;/th&gt;
 &lt;th&gt;产物&lt;/th&gt;
 &lt;th&gt;入口&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;profile 组装&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;employees/&lt;/code&gt; + 插件&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;var/&amp;lt;name&amp;gt;/profile/&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;make build&lt;/code&gt;&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;知识库索引&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;knowledge/&lt;/code&gt; + manifest&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;var/kb/index.json&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;make kb-compile&lt;/code&gt;&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;npm 运行模板&lt;/td&gt;
 &lt;td&gt;已跟踪的公开源文件&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;dist/template/&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;pnpm run build:npm&lt;/code&gt;&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;本文主讲第一个，第二个在第八节。&lt;/p&gt;</description></item></channel></rss>