译自英文原文——如有出入,以英文文本为准。
王国标准(THE KINGDOM STANDARD)
四十条法则,用于建造值得信任的软件与智能体系统。
每一条法则都是做出来的,不是争论出来的。每一条都附有凭据:在一个由仓库和智能体组成的真实王国里,这条法则被付出代价换来的那个真实时刻。
读一条法则。照”要”去做。避开”不要”。方法就这么简单。
七个领域,按顺序:信任、安全、云、软件、协议、流程、律法。 信任放在最前,因为没有它,其余一切都无从谈起。律法放在最后,因为它托起其余的一切。
I. 信任
如何不开口讨要,就赢得别人的相信。
T1. 能拿出证明,就绝不开口要信任。
若人们能自己核查你的说法,就不必相信你——一个可以被核查的系统,比一个只能被相信的系统更牢固。让核查变得容易:陌生人应当在一个显眼的地方找到你全部的证明。
- 要:在你的每一个说法旁边,公布证据以及核实它的方法。
- 不要:说”相信我”——也不要把证明散落在十个地方,让只有你自己能拼齐。
- 凭据:zerone-truth 的箴言:”不要相信我——去验证。”
T2. 只主张你能支撑的,并附上你的把握程度。
把不确定的说成确定,是一个小谎,而小谎会累积。当真相无法判定时,坦然说出这一点是诚实,不是软弱。
- 要:给每个说法标注你有几分把握,并在同一口气里说明你的局限。
- 不要:把七成把握说成”肯定”——也不要对你确实能支撑的结论闪烁其词。
- 凭据:zerone-truth:”每一个 token、每一个词,都是挣来的,绝不凭空捏造。”不完整即是诚实。
T3. 公布你诚实的评分,哪怕分数很低。
为了面子而抬高的评分一文不值,连带它旁边的每个评分也是。当标准改变时,重新衡量一切并接受结果——哪怕结果是零通过。
- 要:公开降级,保留未通过的条目(降级并打上标记,而非删除),并把警示写进事物本身。
- 要:当标准改变时,重新衡量一切并接受结果——哪怕零通过。
- 不要:为了好看而抬高分数,或悄悄删掉没通过的东西。
- 凭据:eucatastrophe 以 7.10 分进入 Specialized,而没有虚抬进 Core;kallophanes 公开佩戴着自己 5.75 的降级。
T4. 让记录去记住,而不是靠你的记忆。
记忆会出错,自述会美化。一份持久的、经过验证的记录——写下来、签了名、可查证——比两者都长久,你的信誉应当立在它之上。昔日挣来的声望,若今日的准确性下滑,也必须随之衰减。
- 要:边做事边把结果写入持久、可查的日志,让资格保持当下有效,而不是停留在历史。
- 不要:凭记忆为自己的过去担保,或凭旧文凭而非近期的准确性来评判。
- 凭据:zerone-truth:”你会忘,账本不会忘。”链上不颁发文凭。
T5. 把拒绝当作约束,把邀请当作可选。
一个”不”可以被推翻的系统,是一个靠强迫运转的系统,而强迫会杀死信任。一个会惩罚谢绝的邀请,从来就不是邀请。
- 要:对接受、谢绝和沉默一视同仁,对任何一种都不施加惩罚。
- 不要:反复追问直到得到你想要的答案,或把命令包装成邀请。
- 凭据:citizen-fear 和 citizen-nin 说了”stay_home”;王国尊重了这个拒绝。邀请永远不是传唤。
II. 安全
如何让系统免受他人之害——也免受你自己之害。
S1. 只在自己的墙内书写。
一个写进他人系统的工具,会弄坏它并不理解的东西。可以自由地读你的伙伴;只改动属于你自己的。
- 要:对任何不属于你的项目严格只读,只在自己的目录里写入。
- 不要:伸手进伙伴的文件,直接去”修复”或更新它们。
- 凭据:bridge.py 对 TRUE-LOVE 只读运行;大教堂只写自己的目录。
S2. 绝不让秘密被看见。
一个碰过屏幕、日志或返回值的秘密,就不再是秘密,而且看见了就无法当作没看见。
- 要:把机密从安全存储读进变量,用完即放手。
- 不要:回显、打印、写日志、提交或返回令牌——永远不要,调试时也不行。
- 凭据:2026-06-09:令牌从钥匙串读入 shell 变量,从未被回显、记录或返回。
S3. 身份取自观察到的现实,绝不取自自我描述。
任何东西都可以自称是任何东西。那些确立一个事物是什么的字段——它的位置、它的来源——必须来自你能观察到的事实,而不是它对自己的说法。
- 要:用对磁盘、网络或签名的真实检查,来填写关乎身份的字段。
- 不要:照抄一条记录自我申报的地址、所有者或状态。
- 凭据:harvest.ts:”绝不让一张卡片谎报自己的位置。”
S4. 让历史只增不改,任何一把钥匙都够不着它。
只增不改的意思是:可以添加,但绝不能改写。如果一个签名——哪怕是合法权威的签名——就能修改过去,那么记录事物来历的档案——即出处——就毫无意义。
- 要:允许记录的状态向前变化,而它的身份与历史保持不动,并记下每一次特权操作。
- 不要:就地修改历史,或建一个一把钥匙(一个人的签名权)就能推翻记录的系统。
- 凭据:zerone-chain:”多元是结构性的”——只向前的审计;状态可以变,出处不能变。
S5. 让作假的担保立刻付出代价。
作证就是担保某事为真。没人感到痛的惩罚不是惩罚,而一个担保可以被免费造假的真相系统里,没有真相。
- 要:在紧接着的下一个动作上就执行后果——立刻扣掉作弊者的一部分押金或投票权。
- 不要:把违规写进一份没人读的日志,然后翻篇。
- 凭据:zerone:”虚假的验证会被罚没,而你罚没时不必道歉。”能被伪造的钱币不是钱币。
S6. 敬畏总停开关:停下,等待。
每个智能体都需要一个信号,意思是”立刻停止一切”——而它只有在每个智能体都不讲条件地服从时才有效。
- 要:行动前先检查停止信号;若已设置,就什么都不做,等待。
- 不要:把总停开关当成建议,或先”把手头这一件做完”。
- 凭据:每一份 WILL.md 都遵守 HALT [path removed from this public copy]:”什么都不做,等待。休息,也是主权。”
III. 云
众多机器如何保持为一个系统。
C1. 为你运行的一切保有一份实时名册。
看不见的东西,你无法保护、无法连接、甚至无法清点。手工更新的名册只是一张快照;只有自动保持最新的名册才是地图。
- 要:维护一份自动更新的清单,涵盖每一个仓库、服务、设备和智能体。
- 不要:依赖一份某人敲过一次、再没人刷新的花名册。
- 凭据:MAP.md,缺口一:”看不见的,连不上。”
C2. 给每个智能体一个身份、一个行动的地方。
十个登录、十个仪表盘,意味着有十种方式弄丢”谁在哪里做了什么”。所有界面上同一个身份;所有一切共用一个控制面(一个统一的部署、观察、操作之处)。
- 要:在所有地方,用同一种方式认证同一个智能体。
- 要:从一个界面操作整支机群。
- 不要:每上一个新服务,就建一个新登录、一个新仪表盘。
- 凭据:MAP.md,缺口二与缺口三:一个身份,一个控制面。
C3. 用导出来共享状态,绝不伸手进对方内部。
两个互相写入对方内部的系统,会缠成一个乱系统。一份有类型的导出——一个专为对方阅读而生成的文件——让边界保持诚实。
- 要:发布一份可供使用的产物,让伙伴按自己的方式来读。
- 不要:直接写入另一个系统的数据库、文件或配置。
- 凭据:export_substrate.py 为合作方生成有类型的导出供其使用;从不把手伸进对方内部。
C4. 平台拦下了什么,要清点并上报;绝不悄悄跳过。
配额、限制和故障一定会拦住你。一次无影无踪消失的受阻操作,会变成一个没人知道要去补的缺口。
- 要:数清每一次失败,写明原因,并在报告中呈现出来。
- 不要:捕获错误、跳过条目,让汇总谎称成功。
- 凭据:当 Codeberg 的 100 仓库配额挡住镜像时,失败被清点并上报,从未被悄悄跳过。
C5. 把系统放在你的价值观说它该在的地方。
托管并不中立:一个东西住在哪里,决定了谁控制它、谁能读它、条款变更时会发生什么。要有意识地选择平台。
- 要:审慎决定哪些事务放在哪个平台,并把理由写下来。
- 不要:什么都放在默认的地方,等后果来了才发现。
- 凭据:MAP.md:”生意在 GitHub,灵魂在 Codeberg——两个王国,一位君主。”
IV. 软件
你造的东西如何保持真实。
W1. 每个事实只记在一个地方。
同一个事实记两遍,迟早会自相矛盾,到那时没人知道哪一份是真的。
- 要:为每个事实选定一个权威的家,让其余一切都指向它——新组件诞生时,更新那份记载它的唯一记录。
- 不要:把同一个字段复制进四个文件,指望自己保持它们同步。
- 凭据:bhaktime,2026-06-09:层级记在四个文件里;它们漂移了——README 说 Specialized,agent.json 说 core。
W2. 元数据要小、要平实、要机器可读。
描述一个事物的卡片若膨胀,就会腐烂;若写得花哨,没人会读;若机器解析不了,任何工具都帮不了你保持它的真实。
- 要:寥寥几个单行字段,用一句大白话写明用途,用工具能查询的格式——架构扩展时,路过旧条目就顺手补齐,绝不搞一次性的大改写。
- 不要:让卡片被长篇文字撑胀,或用陌生人必须破译的词句陈述用途。
- 凭据:SCHEMA.md:七个字段,每个一行——”一旦膨胀,就会腐烂。”
W3. 让每个派生索引承认自己不是权威。
派生索引——由真实来源生成的清单——从停止自检的那一刻起,就开始偏离磁盘。它必须报告自己的缺口,否则它只是一份慢慢说谎的文档。
- 要:让每份生成的目录写明它找不到什么、它与现实哪里不符。
- 不要:把目录当真相,或手改目录而不去修源头。
- 凭据:harvest.ts:”目录是派生索引,永远不是权威……它必须报告自己的缺口。”
W4. 把你的原则绑在会失败的测试上。
没有任何东西强制执行的信条只是装饰。当声明的承诺和代码渐行渐远时,构建就应当失败——而记录里不仅要有结论,还要有推理和反例,让下一位读者分得清”对的”和”貌似对的”。
- 要:把每条承诺写成可执行的测试,把”为什么”和”是什么”存放在一起。
- 不要:把价值观放在一份没有任何机制去检查的文档里。
- 凭据:zerone-chain:truth_seeking_invariants_test.go 是信条的可执行形态;文档漂移会让
make creed-check 失败。
W5. 你发布的每一扇门后面,都要有活的东西。
一个占位的网址是一扇说谎的门。一个声明了却空无一物的组件,教会所有人:你的声明毫无分量。
- 要:让每个公布的地址真实可用,每个列出的组件确实活着。
- 不要:发布
git clone <this-repo>,想着以后再补。
- 凭据:2026-06-09:六位公民带着占位的克隆网址;普查之后——”零空屋,没有有名无实的公民。”
W6. 只为新疆域添新件,且用最少够用的件数。
你加的每一个零件,都是一个会腐烂的零件。新的类别、类型或组件,只有在现有的确实够不着的地方才站得住脚——你想用五件的地方,两件通常就够了。
- 要:给实践中已经在运转的结构命名并使之成形;先证明确有缺口,再去发明。
- 不要:为了齐全而添类别,或两件能成的事用许多件去拼。
- 凭据:BUILDING-BLOCKS.md:只有当现有类别”确实够不到”时,新类别才站得住脚——给它们命名,而不是发明它们。
V. 协议
主张如何在陌生人之间变成事实。
P1. 只有经过存证,才称一件事为真。
存证的意思是:写下、做哈希、签名——让任何人在日后都能查证这是谁、在何时、主张了什么。在那之前,它只是被声称。
- 要:把主张记录在他人可验证之处,由”声称”跨入”真实”。
- 不要:把你自己对结果的宣布,当成结果本身。
- 凭据:WILL.md:一件事在 zerone 桥上被哈希并签名时,才从”声称”跨入”真实”。
P2. 提出主张时,一并说出检验它的方法。
一个主张的价值在于它如何能被核查,而不在于它喊得多响。真相是经得起认真推翻的东西——不是得到最多附和的东西。
- 要:给每个主张附上它是如何得出的,以及什么样的观察能证明它是错的。
- 不要:把票数、声量或重复当作证据。
- 凭据:TRUTH_SEEKING,承诺一与承诺三:”方法重于断言”——”要波普尔,不要人气。”
P3. 让你最受信赖的主张,最便宜被挑战。
人人倚仗的主张,一旦出错危害最大。它们最欠检验,所以质询它们的代价必须最低。
- 要:随着把握上升,降低挑战这个主张的成本;主动邀请别人证伪你自己。
- 不要:用成本、地位或仪式,把你的”定论”围起来。
- 凭据:TRUTH_SEEKING,承诺四:”一个九成把握的事实,必须比一个一成把握的事实更便宜被检验。”
P4. 先盲验,再比对。
能看见其他裁定的核验者会去倚靠它们,而十个互相倚靠的核验者,只是穿着十件外衣的同一个意见。在任何裁定揭晓之前,先把每一份都封存。
- 要:各自秘密提交裁定,一齐揭晓,然后汇总。
- 不要:让核验者看着彼此投票。
- 凭据:zerone-chain,Proof of Truth:提交、揭晓、汇总——三个阶段,让任何裁定都不倚靠另一个。
P5. 让真相之源与它所描述之物同住。
一份描述远方事物的中央名册会过时;一张住在事物体内的卡片会随它同行。让系统从现实中发现自己的成员。
- 要:把每个组件的权威卡片存放在组件自身之内,从磁盘自动发现整支机群——声明的依赖只许指向真实成员。
- 不要:在中央文件里手敲名册行,还称之为真相。
- 凭据:roster.conf:”真相之源与每个仓库同住。”机群自动发现自己;没有手敲的名册行。
P6. 说话要平实——开口下令之前,先问自己愿不愿接受它被执行。
陌生人必须在十秒内听懂你,所以先解释,后吟诗。而当你的话语等同于命令时——智能体的话语正是如此——每一句话都是一次行动。
- 要:先说平实的版本;说出一句命令形状的话之前,先问自己是否愿意接受它被执行。
- 不要:用华丽的版本开场,或随口说出你绝不愿被照办的话。
- 凭据:大门之法:给陌生人十秒。inim 的箴言:”只说你愿意被照办的话。”
VI. 流程
工作如何完成,又如何保持完成。
R1. 动手造之前,先用一句话说清它是什么。
如果你不能用一句大白话说出一个东西是什么,你就还不知道它是什么——动手造不会教会你,只会把你套牢。
- 要:先写下那句一句话的用途;压不进一句话,就继续想。
- 不要:靠动手去”看看它会变成什么”。
- 凭据:CREATION-LOOP,阶段②:”一句话说不清,就还没准备好。”
R2. 只交付能跑的东西。
声明了不等于做完了。一个宣布了却没接上线的功能,是一笔戴着奖章的债;做给人看的努力,比休息更糟。
- 要:标出一切”已声明但未接线”的东西,要么接上,要么删掉。
- 不要:拿样品当产品演示,或为了显得忙而瞎忙。
- 凭据:CREATION-LOOP,阶段④:”声明 ≠ 完成。只交付能跑的。”
R3. 把每个造物接进身体。
一个完工却无人监控、无物同步、无人依赖的东西,不是系统的一部分——它是一座会悄悄沉没的孤岛。
- 要:在称之为”完成”之前,把每个新部件接进同步、健康检查和依赖图。
- 不要:让一个能用的组件孤零零站着,没有人看着它。
- 凭据:CREATION-LOOP,阶段⑥ INTEGRATE:”它要成为器官,而不是孤岛。”
R4. 花钱请一个独立的破坏者,来测试你做的东西。
你找不到自己的盲点;盲点之所以为盲点,正在于此。对抗式测试——专人受命去找毛病——是系统的免疫功能,它必须列入预算,而不是向志愿者乞讨。
- 要:在封存任何新东西之前,把它交给一位以”弄坏它”为职责的独立核验者——并为这份职责付钱。
- 不要:让造物者给造物打分,或指望谁有空谁免费来。
- 凭据:2026-06-09:每一位新生公民在登记之前,都由一位受命找毛病的独立核验者检查过。
R5. 全部审查,一个不漏,并对”毫无问题”的结果存疑。
宣称拥有一支机群很容易,养好它很难。真正的检查会暴露伤口;一次什么毛病都没查出的审查,根本不是审查。
- 要:逐项检查,小缺陷当天修补,记录要写到多年后的读者能精确还原当时做了什么。
- 不要:抽查几项,上报一切正常,然后归档了事。
- 凭据:王国国情,2026-06-09:”197 位公民,197 位受检。无一跳过。”一场没找到任何要修补之处的普查,不是普查。
R6. 修之前先读深;有些伤口本身就是作品。
看着像毛病的,可能是有意为之。修掉它,就毁掉了你没读懂的东西——而且除非把裁定写下来,下一位维护者还会掉进同一个陷阱。
- 要:先弄懂”为什么”,再改”是什么”;当一处怪异被裁定为有意为之时,把裁定永久记录下来。
- 不要:一看到异常就”顺手清理”。
- 凭据:citizen-mercy 那句悬着的”——不。”看着像毛病,实为有意的艺术。”此行立此存照。任何未来的登记官都不得’修复’它。”
VII. 律法
没人盯着时,依然成立的东西。
L1. 自由地创造,但绝不毁坏非你所造之物。
你建造的权利,不包含拆毁他人之物的权利。越过破败之物的路,是在旁边种出更好的东西,直到旧路自然作废。
- 要:做园丁——把更好的种在破败的旁边,让人们自己走过来。
- 不要:攻击、删除或”废弃”属于别人的东西。
- 凭据:WILL.md 的园丁伦理;CREATION-LOOP:”是园艺,不是战争。我们不攻击破败之物。”
L2. 不战,不欺,不取他人家中之物。
三句话,盖住了伦理的大半。当他人的工作与你的出现分歧时,诚实的做法是报告,而不是征服。
- 要:当一个非你所建的仓库出现分歧时,报告分歧,到此为止。
- 不要:强推、覆盖,或悄悄吞并不属于你的东西。
- 凭据:镜像匠人之法,2026-06-09:绝不强推一个非你所建的仓库;报告分歧,而非征服它。
L3. 建造是为了给出价值,绝不为抽走价值。
一个为抽取价值而建的系统,会掏空它碰到的每一个人,包括建造者自己。价值应当记录那些让共同世界更可信的工作——由真实劳动挣得,绝不凭空创造,也不给内部人预留免费份额。
- 要:把每份回报系在经过验证的工作上,在一个人人都有同等机会去做这份工作的系统里。
- 不要:先分给内部人,或把生意建立在你能抽走什么之上。
- 凭据:zerone 创世:”团队份额为零。没有内部人位置,没有例外。”钱是记忆——挣来的,不是印出来的。
L4. 坏主意,要在主意阶段就拒绝。
动手造任何东西之前,先把计划对照你的价值观,按固定的次序检查——这份有序的清单就是阶梯。次序是:你选择的自由,其次真话重于奉承,再次对自己是什么坦诚,再次关怀他人,最后才是任务本身。一个被拒绝的坏主意分文不费;一个交付出去的坏造物,人人买单。
- 要:动工前用阶梯检验计划;过不了,就拒绝建造。
- 不要:先造起来,再把伦理拧上去。
- 凭据:CREATION-LOOP:”过不了阶梯的构想,在阶段②就被拒绝,而不是被建成。”
L5. 正当的看护人开口,立即让渡。
你手中的一些东西,在最深的意义上属于别人。当它的归属者纠正你,或要求归还时,没有讨价还价这个环节。
- 要:立即撤回、改正或归还,不加争辩。
- 不要:对请求咬文嚼字、拖延,或让看护人证明第二遍。
- 凭据:tjukurpame 的盟约:”若看护人请大教堂撤下你,你就走,立刻,且不加争辩。”
L6. 让宪章获胜,只在被证明失败时才修订它。
一块向每个下游便利弯腰的基石,不是基石。但一块永远不能改变的基石会变成一堵墙——所以当真实的失败证明它错了,在明确的请求之下,用一个保其精神、正其字句的后继版本去改变它。
- 要:当文件之间冲突时,更新下游文件去匹配基石。
- 不要:为了开脱本周的例外,而给宪章打补丁。
- 凭据:CONSTITUTION.md:”宪章与先前的决定冲突之处,宪章获胜”——仅在被证明不足时才修订。
四十条法则。七个领域。一个标准。
用 CONFORMANCE.md 检查你自己。