追加型台账

架构决策记录

只追加、不改写:决策被推翻时新增一条取代它,旧条目原样留着 —— 抹掉「我们错过」这条信息,同一个坑会再踩一次。

真相源:.claude/harness/ADR.md · 本页是它的构建产物,改内容改那份文件、重新构建即更新

Harness 架构决策记录(ADR)

本文件由 harness-engineering.md §十一 整段外迁(2026-08-13),逐字原样搬运、零改写。
架构正文见 ../harness-engineering.md;正文中的 ADR-NN 引用一律指向本文件。
ADR 是不可变追加记录:既有条目只能被新条目 supersede,禁止改写。

决策记录全表

#日期决策理由与边界
ADR-1312026-11-03快速型号与上下文宽度进型号配置,只设在角色行上、不随类;走代理的角色这两列必填,起会话与改配置两处都核;换族时没说到的两列清空;代理地址进型号配置文件、全文件一个值、不许带口令;会话命令发起、叫醒、恢复任何会话之前一律洗掉继承来的代理六项;占位令牌与两项开关是代理那条路的常量;执行体照旧用派它的会话的环境。补充 ADR-130,ADR-130 原样不动为了:「Codex分担」。病根:走代理的会话起的时候只带了代理地址与占位令牌两项,漏了代理这条路要的另外四项 —— 快速型号、上下文宽度与两项开关;客户端自己的缺省快速型号是 Claude 型号,过代理会被换掉或拒,缺省的压缩窗口超过上游收得下的长度。代理地址写死在代码常量里,换地址要改代码。会话命令只洗了子代理型号与推理档那四项,走代理的会话起的走官方的会话,会继承代理地址悄悄进代理。BOSS 要「主要模型是哪个,快速模型是哪个,模型的上下文宽度是多少」都能配。决定:① 两列只设在角色行上、不随类:七个会话角色各自那一行可写「快速型号」「上下文宽度」,两类那一行不设、带了的整句不收 —— 同一类里各角色走的路不一样,类上设哪一族的快速型号都会让走另一条路的那几位被族核对拒掉,宽度也跟着路走;型号与推理档照旧随类。② 走代理的两列必填,起会话与改配置两处都核:没写的,走代理的拒绝起会话并附补设的固定话,不退回写死的值、也不用客户端缺省;走官方的不带、由客户端用它自己的缺省;改型号配置的那一刻照同一个判法也核,有角色算下来走代理却缺两列或缺代理地址,这句话不收 —— 不然改一下类的型号,就有角色要等到被起会话时才被拒,接力断在半路;改代理地址那一句只核地址本身,设代理很少、切型号常有,两样各一句、互不卡。快速型号要与走的路同一族;宽度是整数,下限 10 万,上限走代理的 90 万(实测约 92 万能过、约 95 万被上游拒)、走官方的 100 万。③ 换族清空两列:一句话说完哪个角色走的路变了(不论是改了它自己那一行还是改了它所属的类),这句没说到的两列清空,一句话就能切回 Claude;切到代理的同一句里必须带两列。④ 代理地址进配置文件,不许带口令:全文件一个值、不按角色分(眼下只有一个本机代理),一句固定话能改;只认 http 或 https 开头,不许带用户名或口令(这份文件会提交进版本库,口令写进去就进了提交历史),不许带空格和引号;没有地址时只拒走代理的那几位,不退回写死的地址。⑤ 起会话前一律洗掉继承来的代理六项:发起、叫醒、恢复三条路都经同一处,先洗掉代理地址、占位令牌、快速型号、上下文宽度、两项开关六项,走代理的再照本行配置带齐,不在父会话的值上叠(父会话的两列是它自己那一行的);不洗,走代理的会话起的走官方的会话会悄悄进代理。⑥ 占位令牌与两项开关是代理那条路的常量、不进配置:它们是代理这条路能正常工作的条件,不是谁的偏好。⑦ 执行体照旧用派它的会话的环境:执行体跑在那个会话进程里,没有自己单独的环境,不看这两列。代理起不来时拒绝报文写明连的地址,并同时附双击启动代理、带完整路径的重新授权「!」命令、地址不对就说那一句三句,不单独认是不是授权问题。不取的:两列设在类上(理由见 ①);没写时退回写死的值或用客户端缺省(缺省的快速型号是 Claude 型号、缺省窗口超过上游上限);只在起会话时核、改配置时不核(理由见 ②);换族不清空(切回 Claude 要多说两句);代理地址按角色分;起会话前只洗走官方的、或只在发起那条路洗;把占位令牌与两项开关做成可配的;代理起不来时去分辨是不是授权问题(只判成没成、附原话就够)。升哪一位:整个框架升第二位 —— 新增一类东西(配置多两列与代理地址、改代理地址的固定话、洗环境多六项),两类、认法与派发闸都没改写;agent 架构升第三位 —— X大脑 定义里固定话那一句与走代理的会话出问题时给切回句的规矩。守不到:见架构详图 §十五「型号与推理档」末尾的「守不到」—— 宽度上限照实测定,上游变了机器不知道;走官方而没写两列时客户端的缺省机器不核;两项开关是平台的环境变量,平台改了名字或不再认,机器不知道。机制在:架构详图 §十五「型号与推理档」、§十七「型号配置」;体系守护技能说明 model-settings 一节。
ADR-1302026-11-02型号配置按角色覆盖、不取消「类」:七个会话角色可按角色单独设一行,没写的随所属的类;走哪条路由型号推出(gpt 打头的经本机代理,其余走官方);代理不通当场拒绝、不退回 Claude。取代 ADR-127「不做」里「按角色细分的句式(BOSS 只认两类)」那一条;ADR-127 原样不动为了:「Codex分担」。病根:型号配置只分主控类、执行类两类,要把项目经理、复盘经理、运维经理切到 Codex(gpt 型号,经本机代理)用 Codex 的额度分担 Claude 的用量,就得能单独调一个角色;会话命令只认 Claude 型号、不会带代理,而后台会话的代理地址只能写进起会话时的内联设置(写在命令前的环境变量不管用,作业由常驻后台服务起)。BOSS 要「一张清晰的配置表:哪个会话、通过哪个方式、调用哪个大模型、哪个推理档」,任何一个都能单独调。决定:① 按角色覆盖,类照旧:配置文件照旧有主控类、执行类两类,多一栏可选的「按角色」;七个会话角色(X大脑、产品架构师、Harness架构师、产品经理、项目经理、复盘经理、运维经理)谁写了一行就用它自己的型号与推理档,没写的随所属的类,一行都没写时与只分两类时逐个相同,配置文件不用迁移。单独设的角色仍归原来的类:认主控类会话、派发闸照旧只认主控类名单与执行类的推理档,不看「按角色」;执行体不单独设,执行类会话派的继承派它那一位自己那一行,主控类会话派的照旧必须带执行类的推理档。固定话多认两句:「型号配置:<角色> <型号写法> <档>」单独设,「型号配置:<角色> 跟随」回到类的值,认法照 ADR-127;改配置命令多认 --role,与 --class 二选一;七个角色的名单只住固定话常量一处;型号写法多认 gpt 那一族。查看命令印七个角色加执行体每个一行的有效表(角色、路、型号、推理档、来自哪里),这张表就是 BOSS 要的那张;改表里的值不立需求、随时改,改表的样子(加一列、加一种角色、改句式)才走需求。② 走哪条路由型号推出,不进固定话:型号以 gpt 打头的经本机代理(地址只住型号配置命令一处常量),其余走官方;官方没有 gpt 型号,Claude 型号经代理会被代理换成别的型号,这两种组合之外的写法本来就不能用,让人写路只多一处写错的机会。会话命令给走代理的那一位在内联设置的环境变量里带代理地址与占位令牌两项,走官方的不带。③ 代理不通当场拒绝、不退回 Claude:发起、叫醒、恢复要走代理的那一位之前先向本机代理发一次最小的真请求,没成就不起、不叫、不拉这一位,附代理原话并写明先启动代理;悄悄退回会让 BOSS 以为在用 Codex 的额度、实际花的是 Claude 的,同一个角色也会忽而这家忽而那家、出了事分不清。只探端口探不出授权失效,起了之后第一回合才报错,不算当场。不取的:甲 —— 取消「类」、配置文件改成七个角色加执行体逐行的平表:派发闸要改写成按派它的会话自己那一行判,agent 设计页与 x-agent 规范页要改、多一个系统规范单元,配置文件受写保护、只归 BOSS,要给他一条「!」迁移命令、迁完再删;BOSS 要的两样(一张清楚的逐行表、能单独调任何一个)乙都给了,差别只在配置文件本身不是平表(平表由查看命令印),改动面约是甲的一半,不碰派发闸。另设一类「辅助类」(BOSS 要细到每个会话角色)。路写进固定话、代理不通退回 Claude(理由同上)。起之前那次请求分辨授权失效与回答的型号对不对(只判成没成、附代理原话就够)。会话命令替 BOSS 起代理。第二个代理地址、辅助型号映射(实测只带两项就通,真要时再加进句式)。升哪一位:整个框架升第二位 —— 新增一类东西(按角色覆盖、逐行有效表、走代理的那一路),两类、认法与派发闸都没改写;agent 架构升第三位 —— X大脑 定义只多写角色那一句与 --role,设计页正文不动。守不到:见架构详图 §十五「型号与推理档」末尾的「守不到」,要紧的几样 —— 设成 gpt 的会话会把对话内容(含仓里的代码与文档)经本机代理送到 ChatGPT 账号(§二「对话内容送到哪」);Codex 写的中文与对规矩的遵从和 Claude 不同,守卫、检测、测试拦不住「说得不清楚」;干到一半代理掉线或授权过期,会话停在报错上,机器不自动切回 Claude;叫醒、恢复按此刻配置里那一行判走不走代理,会话起了之后配置又改过的那一位会判错一次;X大脑 窗口是 BOSS 手起的,它那一行设成 gpt 时代理通不通机器不核。机制在:架构详图 §十五「型号与推理档」、§二「对话内容送到哪」;体系守护技能说明 model-settings 一节;宪法不改。
ADR-1292026-11-02核准者跟着登记的主控走:核准者是会话登记册里此刻登记的主控,登记册读不出来或没登记主控时照旧是最近一笔确认所在的会话。取代 ADR-111 里「核准者是最近一笔确认所在的会话」那一句;ADR-111 原样不动为了:「日志拆分」。病根:核准认的是「最近一笔确认所在的会话」—— 当年会话登记册还没有,这是机器拿得到的最接近主控的东西;登记册有了之后,「说话只认主控」已经按登记册认主控,核准没跟上。主控换了窗口,旧窗口签过的需求签字之后的任何过程改动都核准不了,重签又因五样没变签不了,排队的六条都撞上这堵墙。决定:核准者是会话登记册里此刻登记的主控(与「说话只认主控」同一个认法:仓里与镜像两处对得上);登记册读不出来或没登记主控时,照旧是最近一笔确认所在的会话。不是当时的办理会话、不是自底定下以来写过机器镜像的会话、机器镜像查得到写证据,这三条照旧作用在核准者身上。核准一笔记下当时登记的主控,读的一端按它认核准者、不重读登记册(登记册会变,旧核准不因此追溯作废);没记这一栏的老核准照旧只认签字会话。办理会话就是签字会话的,照旧没有核准路。需求履历里接任主控核准的一笔写明「接任的主控」。取代:ADR-111 里「核准者是最近一笔确认所在的会话」那一句;ADR-111 原样不动。不做:另记接任史(登记册里此刻的主控本身就是接任的结果,换主控由会话命令把关);探签字会话的死活(会出现谁都核不了的状态);改登记册的形状;核准预览那句与三查结果单、验收区的显示(两个文件不在本条签字时的落点表里,并进「账本加锁」)。守不到:机器核的是登记册里登记的主控,不是用户本人,登记册的可信度就是这条规矩的可信度(靠会话命令把关、守卫写保护、仓里与镜像两处互核);读的一端信核准那一笔里记下的主控,经记账口在进程内手造一笔核准者与记下的主控相同的核准,读的一端看不出(与办理会话、写过机器镜像的会话同一条边界);登记册读不出来或没登记主控时,签字会话没了就没有核准路,要重签。
ADR-1282026-11-02记录分状态与日志、Harness 说明书只写当前、技能说明只预载索引。取代宪法 §六.11 与架构详图 §十五「记录分几类、放哪」里「记录只靠写法规矩」的口径;旧条目一个字不改为了:「日志拆分」。病根:状态与日志混住,宪法 §六.11 只是写法规矩,没有一处机器标识。测试的上游盖着日志、床运行时读真仓的记录,每签字、封版一次就作废,站点床要静默窗口;守卫每一轮、每次回话重读已完结需求与早已结束的会话的账;Harness 的说明书夹着来历,架构详图就有约 610 行;每个执行体一起手装进整本技能说明(体系守护那本 216KB)和两份不分场合的规则书,测试工程师起手 15 万 token。决定:① 状态与日志的判法 —— 判定代码按内容判的是状态,只供复查的是日志,日志自己的完整性核对不算按内容判;工作区地图加属性「记录」(状态、日志、否),盘点表里每类记录各落一个区,地板钉住;状态与日志分路径存,会变成日志的在写明的时点挪进日志区(账本与验收单在提交并推送成功之后,会话台账在会话已结束且写过的文件都已提交之后;会话台账的保留期不变、仍是 30 天,挪账那一步顺手清 ended/ 里 30 天前的日期目录);变更历史、需求履历里的 record.json 与 releases.json、发布台账 RELEASES.md、跑床账标状态,RECORD.md、决策记录、复盘记录、计划归档等标日志。② 日志三不。运行器的卫生检查常驻,不许床的上游盖记录区(状态、日志都算;只追加小床一张例外,只准删不准加);床不读真仓的日志在交付时用日志换空对照查一次(只读夹具与假仓;列目录、核存在、数名字不算读;状态类记录的真仓核对留在原床里;站点床与只追加小床两张例外),不做常驻的读追踪(用户 11-01 定的 B);「判定代码不按日志内容判」写进架构详图 §十五、由复盘守,不立机器闸;框架自己的检测新增「真相源不写来历」(改到的文件整份判、全量只报数)。③ Harness 说明书只写当前:先分诊,在用的按统一的剥离规则一次剥净(按文件并发,剥前剥后的 diff 交独立复盘抽查),作废的连指针删,拿不准的由 X大脑 定;架构详图从头到尾只写当前;说明书、注释、规则书同一条写法规矩。④ 自研技能说明里超过约 8KB 的六本只留一页索引,其余进按需读的参考文档(移动端与模块下线不拆);执行体定义里的 skills 一行照旧,预载的只是索引;四端开发规则与字段命名参考写适用范围。⑤ 宪法 §六.11 升成存在性声明;机制写在架构详图 §十五、§十六、§十八。⑥ X大脑 按最佳最合适自定纯技术取舍(用户 11-01 授权):架构详图 §十五 角色表里 X大脑 那一行写明,仍要用户定的只剩六类(需求确认与验收照代签设置、线上写入的授权、做不做与先后、只有用户能判的、只归用户的设置、花钱的事),其余技术取舍 X大脑 听取架构师的结论与理由后直接定、不再转问,定了写进「我替你拿的主意」、当场告知、实施仍要用户签字一,按需读取、用不上的不硬控;取舍的先后是先省 token,再在不多花 token 的前提下吃满电脑资源提速(用户 11-01 定,写进 §十五「怎么派工」);X大脑 的定义里只加一句指针,宪法不动。取代:宪法 §六.11 与架构详图 §十五「记录分几类、放哪」里「记录只靠写法规矩」的口径;旧条目一个字不改。不做:34 份系统规范与 21 份业务架构文档的去来历(随用随剥);站点床里的来历检查(G50);一次封完;版本契约、封版核心与封版记录的任何改动;原话账拆分(增长慢、只有机器读);发布档案(回滚与增量上传要用);需求履历拆文件;第三方文档;代码注释扫一遍;规则书适用范围的机器闸(补上两份即可);常驻的读追踪(交付时查一次就够,用户定的 B);查床读状态类记录(那几张床读的是状态,不改)。守不到:来历闸对没剥过的规范与业务说明书只在被改到时整份判、全量只报数;床不读真仓日志只在交付那一刻用日志换空对照查过,以后新写的床不写明依赖、直接读的,机器不当场拦,靠复盘;日志换空对照只找得出靠日志内容才绿的床,读了日志、换空也不改结论的看不见;挪账只在提交并推送成功之后,推送没成功的留在第一层;「判定代码不按日志内容判」只靠复盘;来历闸只认日期、版本号这类写法,换一种说法写来历它看不见;代码注释里的来历只靠写法规矩;X大脑 的记忆不受治;规则书写不写适用范围,机器不拦:新建规则书漏写,就会被每个会话和执行体常驻装载,靠复盘发现(宪法 §六.7);会话死在半路、留下没提交的写,它的台账一直留在第一层。升哪一位:框架升第一位(改写了「记录只靠写法规矩」这一口径,账本与台账完结后换了住处,新增一个属性、一道检测闸与运行器常驻的卫生检查;同一版里还改了「谁能核准」的认法与改坏对照的造法);agent 架构第三位(分诊若删执行体文件就第二位);项目架构第三位。
ADR-1272026-11-01型号与推理档是配置,不是写死的规矩:各角色的型号与推理档只放一份文件 .claude/model-settings.json,分主控类(X大脑、产品架构师、Harness架构师)与执行类(其余会话角色与全部执行体,主控类会话派出的执行体也在内)两类、各一对型号加推理档;改配置只有一条路 —— BOSS 对 X大脑 说固定话「型号配置:<类> <型号写法> <档>」,X大脑 跑 harness.js --action=model-settings --do=set,命令核到 BOSS 在本会话里说的新鲜原话才改,不立需求、不升版、不封版;会话命令按类带型号与推理档、起完照横幅核;执行体文件写 model: inherit、不写 effort,跟着派它的会话走;守卫的派发闸不放派发带型号、只放执行类的推理档、主控类会话派执行体必须带它;规范与守卫里一处不写死具体型号与推理档;要 BOSS 亲手做的事一律做成一条他用「!」粘贴运行的受信脚本。取代 ADR-117 里讲会话型号的那一半(两位架构师 opus、其余 sonnet 的名单,子代理照项目设置跑 Sonnet 5.5),取代 agent-effort-max 那条需求定下、x-agent 的 NS-COMMON-0009 守着的「执行体推理档逐字 max」口径。旧条目一个字不改。宪法不改为了:「型号配置」。病根:型号与推理档写死在三处 —— 会话命令里的名单与常量、项目设置里强制子代理型号的两个键、每份执行体文件里的 effort: max;x-agent 的 NS-COMMON-0009 还逼执行体文件「逐字等于 max」,NS-COMMON-0005 的型号白名单写死了具体型号名;新模型隔不了多久就出一个,每换一次都要立需求、升版、封版,BOSS 说「这个是配置,不应该被硬控」。决定:① 一份文件、两类、各一对:型号与推理档只放 .claude/model-settings.json,每类一对「型号 + 推理档」、各记自己的最后改动与用过的原话(没有版本字段、没有封印、没有来源标记);主控类是 X大脑、产品架构师、Harness架构师,初始取 Opus 5.5 max;执行类是其余会话角色与全部执行体(主控类会话派出的执行体也在内),初始取 Opus 5.5 xhigh;初始值靠 BOSS 落地后说的两句固定话建起来。主控类有哪几位只写在型号配置命令的一份常量里,会话命令与守卫都读它,架构详图 §十五 指向它。文件不归任何版本单元,工作区地图给它一区:不受治、保护只标脊柱不标判官、入库。② 改配置只有一条路,与代签设置同一个做法:BOSS 对 X大脑 说固定话「型号配置:<类> <型号写法> <档>」(一行同时定一类的型号与推理档;一条消息里可以连说两行、每类一行,按行认 —— 每行独占一整行、整行逐字原样,行首尾空白不算,行里夹别的字或写在行中间的不认,别的行忽略;同一条消息里两类可以各用一次,用过的行号按类各记各的),X大脑 跑 --do=set(每类各跑一次),命令在原话账本里核到 BOSS 在本会话里说的、晚于这一类自己最后改动、没用过的这一行(行里的类、型号、推理档与命令参数逐项相同)才改,值没变不写、那一行也不算用掉;任何会话的写文件工具和命令行都写不了这份文件(写保护、永不放行名单),执行体跑不了 set(守卫按 agent_id 拦)。型号写法认三种 —— 人话「族名 版本」规整成 claude- 加族名小写、版本里的点换成横线,完整型号名,官方别名 —— 不对着型号名单核;推理档只许 low、medium、high、xhigh、max;读不出、JSON 坏、缺一类、推理档不在五个里、型号规整不出来,会话命令与守卫一律拒绝并点名怎么修,不退回写死的旧值。③ 会话命令按类带型号与推理档:按这位角色所属的类读配置、带 --model 与 --effort,起完照横幅核同一个值,并在起 claude 子进程前洗掉继承来的子代理型号、强制开关与推理档四个环境变量(CLAUDE_CODE_SUBAGENT_MODEL、CLAUDE_CODE_SUBAGENT_MODEL_FORCE、CLAUDE_CODE_SUBAGENT_EFFORT、CLAUDE_CODE_EFFORT_LEVEL;后台作业的环境取自起它那条进程的环境、起新会话时用、叫醒旧作业时原样重放,不洗的话某个会话环境里带着的旧值会顺着会话命令起的子进程一路带进新会话与它派的执行体);X大脑 的启动命令由配置算出,型号配置命令的 show 与登记主控的报文都印整行;读配置每次读盘、不缓存,改完新起的会话生效,已在跑的不动。④ 执行体一律跑执行类,不再自带型号与推理档:执行体文件写 model: inherit、不写 effort,跟着派它的会话走;执行类会话派的继承的就是执行类;主控类会话派的,派发时必须带执行类的推理档;项目设置里强制子代理型号的两个键拿掉(由 BOSS 用「!」脚本拿);NS-COMMON-0009 只核写法、不核值,NS-COMMON-0005 收成「写了只许 inherit」。⑤ 具体值规范与守卫里一处不写死:守卫的派发闸对每一次派执行体(不分类型、复盘者也走)判入参 —— 型号不写或写 inherit 放,写了别的一律拦;带推理档的只放等于配置里执行类推理档的;主控类会话(登记的主控与登记册里角色在主控类名单里的会话,执行体在其中再派也算)派执行体必须带它,不带也拦,报文写明该带什么;配置读不出时执行类会话不带参数的派发照放,其余拦;守卫只拦不改写,里面没有任何型号字面量。它取代原来只管复盘者、只放 sonnet 两种写法的型号闸。⑥ 要 BOSS 亲手做的事一律做成一条受信脚本命令:BOSS 在 X大脑 窗口用「!」开头粘贴运行,脚本先打印预览(改前改后)再动手,X大脑 读输出核对,不让 BOSS 开编辑器、找行号;守卫拦模型经 Bash 工具跑这类命令(含预览,不分主控、常驻还是执行体),「!」不经守卫所以只有 BOSS 跑得了;命令做的事是代码里登记的闭集。先落两处:拿掉项目设置里强制执行体型号的两个键(project-settings),提交项目设置与型号配置文件(settings-commit,一份文件一个提交、不推送,代签设置文件不在名单里);两条用 && 连成一行粘一次。不做:出厂值写进代码(第一次改配置之后它就是过期的旧值,配置文件靠 BOSS 落地后说的两句建起来,首次 set 可以只写一类);按角色细分的句式(BOSS 只认两类);往 --settings 里注入子代理型号(那是第二个出处);守卫改写派发参数、自动补推理档(守卫只拦不改,平台若不照办改写,执行体会静默跑成主控类的档,拦是看得见的,报文写明该带什么)。升哪一位:整个框架升第一位 —— 改写了「型号按角色写死在会话命令里」这一既有契约;agent 架构升第一位 —— 改写了它自己立的「执行体一律 effort: max、型号由项目设置强制」;x-agent 升第一位 —— NS-COMMON-0009、NS-COMMON-0005 改口径;项目架构升第三位 —— 项目页只把一句写死的事实换成指向型号配置,流水线设计没变。守不到:机器认不出是谁改的配置(BOSS 用编辑器手改与脚本直写在文件上分不开,也不提示;手改不动最后改动,所以手改之前说过、还没用掉的固定话仍算新鲜);原话账本只在本机,换电脑后要 BOSS 再说一次;型号名格式对而平台不认,要等下一次起会话的横幅核对才抓到;派发带的推理档平台照不照办、执行体的推理档在对话记录里看不看得到,只能靠平台;两类型号不同时,主控类会话派的执行体型号跟主控类走,守卫只核推理档(两类同型号、只分推理档,用不上);已在跑的会话改不了(型号在起会话那一刻定),常驻会话要等重起才跟新配置;已经带着那四个环境变量的旧作业(会话命令洗不到它们身上)叫醒时仍重放旧值,已在跑的会话(含 X大脑 的窗口,按新启动命令重开才干净)自己派的执行体仍被强制,要换新只能删了再发起;平台以后再有别的会把型号或推理档带进新会话的变量,名字要补进那份名单;洗环境这一条没有真环境的实测,只有床里用假 claude 看环境;用脚本转一道去跑「!」命令,守卫看不见,两条命令都是闭集,做的正是 BOSS 要的那件事,绕过去也无害。机制在:架构详图 §十五「型号与推理档」「要 BOSS 亲手做的事」、§八 环1「派执行体通道」「会话命令与敏感命令」;体系守护技能说明的 model-settings、project-settings 与 settings-commit 三节;x-agent 条款书 ARCH-A02、ARCH-A05;宪法不改。
ADR-1262026-11-01守卫与检测引擎余下的按路径判断改问同一张工作区地图,只换读法、答案逐条不变:守卫里按路径分类的判断(命令判定零件的写保护谓词与判业务目录、需求零件的受治与判决依据、测试面零件的上游组与测试根、收尾处理的规则书分类)经唯一入口 guard/map-reader.js 问地图(两段都装、折小写开关只给守卫、读不到原样抛、用到才装);读不到地图时要用地图的动作一律按拦并点名「文件:行」与修法,原话入账、会话开始、改配置、收尾记写证据不碰地图,说话那一道永远退出 0、不吞原话,认签字读不到时这一句签字不生效;读坏之后施工区判断、免检写区、判业务目录时的施工区早退写死在守卫里,准跑脚本树的四个根写死并钉住,地基目录自己的保护由地板判;地板补齐守卫今天保护着的全部条目;五份名册里有地图对应物的导出与 module-detector 的三个常量改成加载时从地图名册算出,地图新增六张名册,元规范里一处覆盖令牌判断读名册;测试面上游组的目录与文件取自地图属性「测试面上游」;对拍台补补录语料、补录金标准、新适配器与两张处置表;沙箱复制点全带地基目录。取代 ADR-114 里「检测引擎只在索引与目录遍历两处读工作区地图」那一句、决定③里「五份名册一个字不动」与「缺地基目录时照常 require」两处、决定⑦里「被单文件抄走的引擎文件加载时不依赖地基目录」那一处,以及「守不到」里「守卫本步不读地图,所以地图读坏时检测被拦、工具调用不被拦,抢修态留第 3a 步」那半句;取代 ADR-115 决定④整条(「守卫本步不读地图」、五份名册原样不动、「第 3a 步守卫有抢修态、改成惰性加载之后再迁」那个前提);补充 ADR-115 决定①②(上游组的目录与文件改取自地图属性)。旧条目一个字不改。宪法不改为了:「守卫读地图」。病根:全仓「这个路径是什么」散在很多处判断里;ADR-114 只让检测引擎的索引与目录遍历两处读了地图,守卫里按路径分类的判断(登记在案的有两百多处)、引擎余下的名单与正则、五份名册、元规范里一处覆盖令牌判断还各抄各的,改一条路径规矩要改很多处、漏一处就静默分叉;取证又发现地图余段从来没对着守卫核过(对不上的有四十八格,其中判决依据整个属性对不上),地板缺守卫今天保护着的好几类条目,守卫抄进沙箱的点绝大多数没带地基目录,对拍台把地图的视图对金标准只比了真路径,怪路径只在两个地图读法之间互比、从没对过金标准。决定:① 守卫经唯一入口问地图,用到才装:guard/map-reader.js 顶层只装 Node 自带的东西,读取模块与地板第一次问才装;入口恒以折小写、两段都装的读者问(折小写开关只给守卫,引擎与脚本照旧区分大小写,读取模块的缓存键含这个标志);读不到就把读取模块的错原样抛,不改写、不包一层、不叠重试(读到半截先重读一次只在读取模块里做);调用方先做它入口自己今天的路径归一再问,今天直接对原始写法比字符串的判断(受治、顶层围栏的路径预筛)用名册成员或写死的前缀表做同样的比较;换不成仓根相对的写法、带 $ ~ % 的写法、无锚怪癖、目录自身节点、判业务目录时的怪名字走老支,答案就是改读之前的答案。不需要按路径判断的事件与工具调用不装、不读;原话入账、会话开始(含读计划状态那一步)、收尾记写证据三条路连间接经过的零件也不碰地图,改配置同样;认流程那条链(planStates → flowCheck → flowStamp → flowOf、sessionGate、workAreaStateOf)上的名单与字面量全部写死并钉住。② 读不到地图时要用地图的动作按拦:缺、空、格式错、读到半截重读仍坏、越过地板、被改宽,以及读取模块的代码本身装不上,都算读不到;报文点名「文件:行」、原因、按拦的交代与修法;哪一处都不把读不到当成不受治、不保护、没有手机端放行(本来就有 catch 吞错的几处遇到地图的错一律原样往上抛,每个 catch 先问 isMapError);说话那一道永远退出 0、不吞原话,认签字读不到时这一句签字不生效;写后记账照记写证据、写后提醒可见地跳过;回归套件的失败矩阵把入口算一列。③ 读坏之后守卫自己的修复路径:施工区判断、免检写区、判业务目录时的施工区早退写死在守卫里,准跑脚本树的四个根写死并钉住(至少核四个根仍在名册「受治根」里);地基目录自己的保护由地板(代码)判、不问地图数据 —— 入口的视图查询对地基目录里的路径,五个保护类视图直接由地板答;于是有在办需求时可以在它的施工区副本里修好地图、经换入帮手换进真仓,守卫照签字放行;没有在办需求时新需求签不了字,只剩急救开闸。④ 地板补齐、余段以守卫为准、新名册六张:地板补进守卫今天保护着而此前没有的条目(会话登记册目录、代签设置文件、定时任务文件、提交命令与开工命令、会话命令与代签命令模块、守卫「路径里含这一段就算」的任意深度写法)和保护区、装配产物、发布档案、免检写区的受治根四类,只许加;余段逐属性对着守卫核过、以守卫为准改值(受治数据层补成受治、执行体定义的脊柱收窄到 .claude/agents/*.md、车道的值等),与设计目标不同的几组标「过渡」保住今天的答案;路径规则加三种写法(连续几段 seq、只对哪些路径起作用 under、起点不是仓根那一段 nested);新增六张名册:单元根、版本契约跳过名、没有配对规范的规则书、覆盖令牌、裁判五样、判定代码;判决依据五样与判定代码住进名册,不靠改「判官」属性的值(它恰好等于脊柱加引擎承牙,比五样大得多)。⑤ 车道按改地图的值办:属性「车道」闭集只留业务流程与 Harness 流程,规则书、系统架构、计划三个区和没写值的区读作 Harness 流程,内核母本读作业务流程;规范流程只经单元 spec:* 认出,认车道时单元先于区的值,落点里没有单元的行才按路径认,那张路径表写死并钉住。⑥ 五份名册里有地图对应物的导出从地图算出:defaults.js、terminals.js、test-roots.js、rule-books.js、version-contract.js 与 module-detector.js 的三个冻结常量加载时读一次地图引擎段的名册,导出名、形状、值、顺序不变,名册不存在或写歪一律抛、不给默认值;改读那一次逐张名册做过多加、少一个成员的等值证明,证明完拆掉名册钉住床与旧名单快照(引擎一侧的快照夹具,对拍台一侧的两份快照与读它们的床和工具),对拍台不再读旧名单快照,落地后名册只有地图这一份账;check.js 里读「计划区」「来源」两个余段属性的几处与单元前缀留字面量,由引擎常量床核与地图一致;判据注入的门面多露名册附加信息;元规范覆盖令牌判断读名册「覆盖令牌」。引擎的匹配器与各处自写的通配一个不换。⑦ 测试面上游组取自地图:上游组(检测引擎、内核、部署门入口、运行器)各对应属性「测试面上游」的一个取值,组里的目录与文件是直接写了这个值的那些区的区路径,经入口的 zonePaths 取;判定模块里只留组的显示名、挂哪些面族、哪份文件只取标记区段;加载不读地图、第一次读到某一组才问、按地图代数记,读不到原样抛、记成基础设施异常;检测引擎组的内容不变(引擎段数据与读取模块、地板、匹配函数三件代码加引擎脚本目录,余段不在其内)。⑧ 沙箱:凡把守卫树、五份名册文件、版本契约或引擎整树抄进沙箱的点都带上地基目录(不需要的写理由),守卫一侧的点登记在另立的数组 guardPoints 里,points 原有的成员与含义不变、运行器不改,覆盖床的扫描扩到守卫树。⑨ 证明:对拍台补补录语料(金标准之后守卫里新增的特殊路径,单独成份、原语料指纹不动)与补录金标准(原有适配器在补录语料上的答案、新适配器在原语料上的答案,取自基线提交的老代码,主金标准一个字不动)、新适配器 A58 至 A62、补登记表与守卫处置表、引擎读地图处置表(每行恰好一个去向,双向对账);换入真仓之后当场自检(冒烟,加对每个入库文件问写保护、受治、判决依据、落点范围四样,与换入之前逐个相同);延迟改读前与落地时各量一次、不设门槛。⑩ 会改答案的一律不在这一条:抢修态、注入的完整性核对、按名跳过的目录落在业务源码区时当场报出、把「过渡」那几组翻过来、各处自写通配收成一种方言,都归「新增拦截」;取证中确认的两个守卫漏洞(mv 来源与 rm 目标只比受保护样本表与「目录加 /_」,样本表里没有的上级目录可以被整份挪走或删掉;签字会话用 curl -o 往受保护文件落盘)记在欠下的,去向同样是「新增拦截」。否决过:直接拿地图的「判官」属性当判决依据五样(比守卫的五样大得多,会对执行体定义、项目设置、锁清单等多拦,属「新增拦截」;也不能靠把 manifest.js 改成「否」修,地板会在装载时拒绝);在读取模块里对所有读者一刀折小写(引擎等其他读者今天区分大小写,一刀折会改它们的答案);把施工区判断、免检写区、判业务目录时的施工区早退、准跑脚本树也改成读地图(地图一坏,施工区副本里也写不了、换入帮手与 why.js 跑不了、新需求签不了字,只剩急救开闸);守卫一侧的复制点并进 points(运行器把它当「不做按点替换」的名单读,守卫一侧几十张床会被静默排除出改坏对照);新写共用的「复制守卫进沙箱」帮手(要同时动几十个点,还撞正在拆分的守卫巨床);把 check.js 里读「计划区」「来源」的几处挪进引擎段、或让引擎装余段(都会牵动射程缓存键与四族床记录)。重新采纳:ADR-114 否决过「引擎常量全部改成由地图算出」(守卫、logger、封版链加载时就读地图,地图读坏连只加载常量的进程一起坏),这一条把五份名册改成从地图算出,是对那条否决的重新采纳 —— 守卫的零件加载时不读、用到才装,读坏时连累的是真要用名册的进程,不是每个会话的每次工具调用。与既有决策的关系:取代 ADR-114 与 ADR-115 里上面点名的几处,旧条目一个字不改;ADR-113 的地板只许加、不许减原样成立(本条给地板加了几类条目);ADR-115 决定①②③ 的段数据、会话台账判据组、有意改动清单带组号与档位仍成立,只是上游组的目录与文件改取自地图;两个裁判各判什么、三条主流程的闭环、签字与开工、发布与提交都不变。升哪一位:整个框架升第一位 —— 守卫与引擎改读地图、五份名册来源改变、地图读不到时守卫要用地图的动作改成按拦,是改写既有契约。不做的:认仓根、认树根的几十处(归「工作树一」);三份规范判据改读名册附加信息、去掉暂留抄本,与 x-deploy 044 改读(各自单立);技能脚本与治理站点构建器(归「脚本读地图」);材料侧的抄本读 .claude(照旧不读,由对拍床钉住);决定⑩点名的会改答案的几项与两个守卫漏洞;车道表里「真仓直改,不做副本」那一句与项目架构设计页的相应说法(归「工作树一」);延迟预算床(归「新增拦截」)。守不到:见架构详图 §十八「守卫读地图与读坏了怎么办」末尾的「守不到」与 §十八末尾的「守不到」,这里不抄全;要紧的几样 —— 对拍只对语料里的路径成立;地图读坏期间真仓里除施工区副本之外要问路径的写都被拦(含计划目录与被签字放行的地基目录文件),没有在办需求时新需求签不了字、只剩急救开闸,抢修态没做;需求履历放行栏等显示类读不到地图时静默丢;读取模块自己有语法错时引擎一侧装载口的报文偏弱(仍拦、仍点名);独立求值器与读取模块对 under 点名的名册写在规则后面、区路径末尾 X/** 两处口径不同(只对非法数据与真数据里没有的写法有分别);折小写只给守卫,同一张地图对只差大小写的路径守卫与引擎可能答不同;名册落地后没有常驻的等值床,往地图里改名册成员靠区的说明、签字与封版;单元名前缀与显示名、风险标记里母本与内核一项、写保护的扣除项、认命令词这几样写死而不钉,地图里改了对应的区守卫不跟着变,靠签字与封版。机制在:架构详图 §十八 的「引擎读地图」「守卫读地图与读坏了怎么办」「测试面上游」,§十六「对拍台与有意改动清单」,§八「零件用到才装」「写保护的六个判断条件」「认车道」;宪法不改。
ADR-1252026-10-28规矩固化一:把只记在记忆里的做事规矩写进真相源 —— 宪法加第 10 条「刹车规矩」、第 11 条「记录最少」与第 12 条「规矩当场固化」,每份执行体定义「禁区」末尾加统一的一行通则,X大脑 除签字题外不弹窗并在每轮回复末尾附「待你回话」小卡片,插队只认红灯与提速两种,合并只看是不是改同一处,等用户回话时不空等,排队的需求提前备料,全仓静默窗口里除被放行的那一位仓内任何文件都不写,对抗审查官定义加「核查六问」一节,测试工程师、产品经理、X大脑 定义各补一句指向它,体系守护技能说明加「命令行写法」一节,项目经理定义与 agent 设计页里「改派不归它」的旧说法订正为「指名改派归它、自助改派不归它」,加一张核字在场的床。取代 ADR-120 决定④ 里插一条优化的口径(会让接下来几步做错、或每一步都要多花不少时间的才插),取代架构详图 §十五「怎么派工」⑤ 里「主控这一侧同一条:要用户定的事一律给选项」那一半。旧条目一个字不改为了:「规矩固化一」。病根:一批做事规矩只记在 X大脑 的记忆里,会话压缩、重开或换人就丢,同一类毛病因此一再出现:被平台的安全检查拦下的动作,换个写法、换个会话、换个型号接着撞,被拦过的会话一叫醒又接着撞;用户被问同一件事,要他定的事没有统一的问法、也没有未回话的清单;选项弹窗一开,X大脑 整个会话停住,别的会话的消息也接不了;等用户回话的空档里,不依赖他的活没人先派;排在后面、已签字的需求,在前一条测试、验收、发布的这段时间里干等;过程文件进了计划目录与主控线目录、会话又删不动,只好叫用户去删;被计划或清单引用的设计稿放进系统临时目录,被系统的存储感知清掉;项目经理定义与 agent 设计页写着「改派不归它」,而技能说明与守卫都认项目经理跑指名改派;核「提速了、过了、做完了」的说法时该问的几问只在 X大脑 的记忆里,审查官、测试工程师、产品经理核证据时没有统一的问法;发布、站点床、跑整面床这几个全仓共用的窗口开着时,窗口里仍有人写仓内文件、跑重命令(站点床把取材面在床运行期间的变动判成漂移而红,发布要的是封着的那一份,机器上多一个重命令池里的床就慢到顶住超时上限被杀成红),宣布窗口开始或结束之前也没先确认命令真的起了或停了;用户定下的规矩只在会话里说一句「记下了」,会话一压缩或重开就没了,又被忘记。决定:① 宪法 §六 在第 9 条后加三条:第 10 条「刹车规矩」、第 11 条「记录最少」、第 12 条「规矩当场固化」,都只写定性、不写机制名与文件路径;第 10、11 条的细则指到架构详图 §十五,两个选项名(并进本条重签、急救开闸)是机制,只写在详图里;第 12 条的做法(记忆里标落点、「待固化」一行)只写在 X大脑 定义里,没有详图指针,详图「宪法只留定性,机制各在哪」那张表也不为这三条加行。② 架构详图 §十五 加两段:「刹车规矩」写什么算被平台的安全检查拦下、怎么停、怎么报、同样的失败连着两次也停、修法要改自己占着的判定代码或守卫时报 X大脑 并带两个选项、要靠诀窍才过得去的机器关口报框架毛病、被拦过的会话不再叫醒(要接着办由 X大脑 定,项目经理起新的产品经理会话并指名改派,照原样送出握手之后另加一句写明新会话不碰被拦的那段内容)、机器之间传大段内容传位置加指纹;「记录分几类、放哪」把记录分成真相源、历史、计划与账、主控线、被计划或清单引用的设计稿、过程文件、日志七类并写各放哪,被计划或清单引用的设计稿不算过程文件、放耐久处(有计划的放计划目录,还没立计划的放主控线的设计目录;不放系统临时目录),过程文件不进计划目录与主控线目录、也不叫用户去删,执行体的心得写进交回的报告。③ 每份执行体定义的「禁区」末尾加统一的一行「通则」指到宪法 §六.10、§六.11(心得那一半指到架构详图「记录分几类、放哪」;X大脑 那份是「告诉用户」的变体),新增执行体漏写由新床当场红;五份定义的「流程指针」另加一行「命令行写法」。④ 插队(下一步开工前插一条优化)只认两种:红灯(接下来几步照现在这样做会做错,或做不下去)与提速(做了立刻让后面所有项目都提速的,像测试优化),其余一律排进待立项目清单、不插队;去向仍是三种,减法审仍过一次。⑤ 主控一侧:签字题用弹窗,除签字题外不弹窗等回话,非签字事项用文字问、写成好回的选项,并在每一轮回复的最后附「待你回话」小卡片,用户回了哪条才拿掉哪条。⑥ 并不并只看是不是改同一处,互不相干的各立一条、各按自己真实的档走。⑦ 等用户回话时不空等:每次停下来等他之前先问一句,等他的这段时间里哪些活不管他怎么定都要做,先派出去;已签字、开了工的需求等重签时,办理会话先在自己施工区的副本里开建、真仓一个字不动,重签之后才换入;排队的需求没有施工区,只做准备;派执行体按文件分人并行。⑧ 排队的需求提前备料:签了字、在排队的需求,在前一条测试、验收、发布的这段时间里提前备料 —— 最终文字、代码和测试的草稿先写在系统临时目录或计划目录,前一条封版之后再对着它的最终版预套共享文件,开工当场只核指纹、落笔、跑床;排队的需求仍不动受治文件(架构详图 §十五「怎么派工」⑦);备料草稿被计划引用的,按被计划或清单引用的设计稿那一类放计划目录,不算过程文件。⑨ 全仓静默窗口:架构详图 §十五「跑整面床、发布两个全仓共用的窗口」一段加「全仓静默窗口」—— 发布、跑整面床这两个窗口开着时,以及单跑站点床的那几分钟,除被放行的那一位,仓内任何文件都不写(计划目录、research、总账、待立项目清单、记忆都算,建站和别的命令替你写的也算),也不跑全仓搜索、普查、跑床这类重命令;要备的料和要记的话只写系统临时目录,窗口一结束第一件事再落进仓里;窗口从被放行的那一位报「命令真起了」才算开始,它报「做完了」、并且那条命令真退出了才算结束,宣布窗口开始、作废或结束之前先确认跑着的那条命令真的已经起了或停了;§九「谁改了站点的源谁就可以建」那一句加括号,窗口开着时除外;项目经理、运维经理、X大脑 定义各补一句。⑩ 体系守护技能说明加「命令行写法」一节(所有 node 命令,不放 bash 围栏),retro 一节补办理会话号取法与对话记录位置,叫醒与改派两处各补一句被拦过的会话不叫醒。⑪ 订正:项目经理(和主控)可以跑指名改派,自助改派由接手的那个会话自己跑;项目经理定义的「命令行只跑」补一个「指名改派」子项,agent 设计页项目经理那一页同口径。⑫ 核查六问:对抗审查官定义新增「核查六问」一节(有没有意义、真能抓住、真跑了没有、有没有偷用、有没有弄假、有没有放松,外加改前改后同口径对比,逐问怎么看只在这一处写全);测试工程师(前两问)、产品经理(后四问)、X大脑(代签验收那一条,带六个问名)定义各补一句指向它;架构详图不为六问加段。⑬ 加一张新床核这些字在场并带改坏对照,宪法对表那张床同批改到第 1 到 12 条。与既有决策的关系:取代 ADR-120 决定④ 里插一条优化的口径,ADR-120 的其余部分(复盘经理、耗时表与红旗、去向三种、减法审)原样成立;取代架构详图 §十五「怎么派工」⑤ 里主控一侧「一律给选项」那一半,产品经理一侧「要用户动手只用对话框」不变;排队备料的草稿「系统临时目录或计划目录」在全仓静默窗口里收窄成只写系统临时目录,窗口外不变;三条主流程的闭环、五类架构、签字与开工、发布与提交、守卫与检测引擎都不变。不做的:给项目架构设计页「按节点回报」与架构详图「怎么派工」③ 的「任何时候都报」清单各加两样(被平台的安全检查拦下、同样的失败连着两次)—— 这两样已含在「任何时候的红灯与黄灯」的红灯里,加了是重复,项目架构设计页因此这条不动;立项命令打印的派工底稿的回报清单加两样,同理;立项命令「共用资源的规矩」多一条、接力命令派复盘那一步多印一行 —— 刹车规矩已在宪法与每份执行体定义的通则行里,派复盘那一处的起因已在拿掉,多印一行反而可能被多拷;「停手记号」命令 —— 平台的安全检查拦下这件事守卫看不见;让守卫去猜哪句话是规矩 —— 规矩是语义,提醒会变成噪音;机器闸(放行询问的报文多一句要碰判定代码、会话命令叫醒前读看板状态栏写着「停手等回话」就拒、主控线目录里的文件会话能清、残留清理、全仓静默窗口加标记并让守卫拦窗口里的写)—— 要碰判定代码或守卫,并进来这条就从写说明书变成难事,归待立项目「规矩固化二」。升哪一位:整个框架升第二位 —— 新增一类东西(三条宪法规矩、三段详图〔含全仓静默窗口〕、一节技能说明、一张床);非签字事项不弹窗、插队门槛、并不并三处是改口收窄,都靠纪律,没有改写任何机器认的命令、账本或闸。agent 架构升第一位 —— 22 份执行体定义的「禁区」都变了。项目架构不升。守不到:见架构详图 §十五「刹车规矩」一段的「守不到」(记录类的几样也并在那一段里,「记录分几类、放哪」一段指回它)和「跑整面床、发布两个全仓共用的窗口」一段里「全仓静默窗口」的「守不到」,这里不再抄全;非签字不弹窗、等用户回话时不空等、排队的需求提前备料、核查六问有没有照问这几样全靠纪律,见「怎么派工」的「今天靠什么」。机制在架构详图 §十五「遇到顶层问题的两种走法」「刹车规矩」「记录分几类、放哪」「怎么派工」⑤⑥⑦「跑整面床、发布两个全仓共用的窗口」一段,§九 一句的括号;宪法 §六.10 至 §六.12 只写定性。
ADR-1242026-10-28收尾不挡下一条:接力命令清理归档之前只问机器当场答得出的事(先决的几样不变,再问跑床与建站两把锁没人拿着);复盘经理的复盘和遗留、发现的去向挪到归档之后在后台办,不再挡归档、提交和下一条开工。复盘记录搬到主控线目录下的复盘记录目录(台账类,随下一个提交进库;提交命令、开工条件、工作区地图一个字不动,一条需求一个提交不变),多认一行「去向:」;归档时建骨架,收尾单第一栏「过程复盘」一节与第三栏在归档那一刻定格,第三栏去向默认写「后台办理中」。取代 ADR-120 里「接力命令归档之前只多问一样『复盘记录里的结论写了没有』」那一半,以及它所说的发现进第三栏、由「去向都定过」那一样管;取代 ADR-106 里「验收完结之后跑接力命令就刷新收尾单,遗留去向都由主控定过(不再是默认的「后放」)、没人在跑床或建站就归档」中「遗留去向都由主控定过」那一半,连同它守不到里「收尾单的去向是谁定的机器不认,只认它不再是默认的「后放」两个字」(「没人在跑床或建站就归档」那一半原样成立)。旧条目一个字不改为了:「收尾不挡下一条」。用户 10-28 原话:「肯定根治啊,而且越早越好啊!难道不是么?这个类似发布提速一样,只要处理好了,后面全部受益啊!对不对?」病根:下一条要开工,要等上一条提交(同一块排队)和归档(收尾与归档那一关);提交要等环收尾(已发布且已归档);归档要等复盘经理写完结论、复杂化审查官做完减法审、X大脑 定完去向、产品经理改好第三栏 —— 四个会话依次接龙,每一环都没有时限。最近五条专项从验收完结到提交等了 66 到 83 分(有一条等站点批量发布,354 分);复盘与去向只让其中一条的归档晚于发布 25 分,另两条的归档紧贴在站点发布窗口之后 1 到 3 分,是因为发布本身还要 49 到 68 分;发布提速(ADR-123)把发布压短之后,复盘记录写完加去向的 64 到 75 分就成了链上最长的一段。复盘与去向是为以后改进的,不是为这一条做对。可泛化的根因:关口只留机器当场答得出、且不答会弄坏东西的事(锁);为以后改进用的活放到后台,不挡链。决定:① 归档只问锁:接力命令第 3 步归档之前问的(清理归档零件的 archiveHolds)从三样减到一样,没人拿着跑床锁与建站锁(判不了的锁照拦);去掉「复盘记录里的结论写了」和「第三栏每条去向不是默认的『后放』」。先决的几样(账本可信、完结笔在、履历封死、收尾单五栏齐、登记文件每行有着落、施工区合规)不变;手跑带执行开关照旧什么都不问。锁留着,是因为归档搬的是站点取材面,别人正在建站或跑站点床时搬,它们读到的是半截。② 后到的东西放哪、怎么进库:复盘记录挪到主控线目录下的复盘记录目录,一条专项一个文件,文件名是需求名加 .md;写法照旧(「结论:」一行、「发现:」下每条以「- 」打头),多一个记号 —— 一行「去向:…」,由项目经理在 X大脑 定完、清单与总账记完之后补,没有遗留也没有发现的写「去向:无」;机器只认这三个记号,写得对不对不核(原来也不核)。清理归档这一次调用真搬了计划时(接力命令与手跑带执行开关走同一处),文件不在才建骨架(一行注释加一行空的「结论:」),已在不覆盖;建不成只说一句、不影响归档;已归档的重跑不补建。主控线目录整棵是台账类(工作区地图 plan-main-line 区,入库取「台账」),提交命令把台账随下一个提交一起带上,所以后补的复盘记录与清单随下一次提交进库,本条自己的提交带的是归档那一刻的骨架;一条需求一个提交不变。需求履历(守卫写,脊柱加判官)与归档里的收尾单、看板(归档那一刻定格)之后不再改。③ 收尾单定格:第一栏「过程复盘」一节,每条完结的专项归档前那次刷新都写(以前要有复盘记录才写):表和红旗从账本现算(这时施工区副本里的跑床行还在,归档把施工区删了之后现跑读不到),最后一行「结论:」有就抄、没有写「后台办理中,复盘经理写在……」;第三栏遗留逐条列出、去向默认写「后台办理中」(原来的「后放」会被读成已经定了的去向),不再带复盘记录里的发现(「过程:」);归档前办理会话已经改过的去向照旧保留。④ 去向记在清单与总账:发现与遗留的去向仍由 X大脑 定(先过复杂化审查官的减法审,三种去向与门槛不变,见架构详图「遇到顶层问题的两种走法」),交项目经理记:并进或排进清单的记待立项目清单,各线一览那一行写「N 条:并 a、不立 b」,不立而值得留理由的记总账里按「禁止复杂化」不立的那张表;记完在复盘记录末尾补一行「去向:…」。⑤ 看得见:十态仍是十个态,名字与次序不动;第 7、8 态产品经理的下一步去掉「把遗留清单发主控定去向、照它改好收尾单……去向都定过」,改成「跑接力命令收尾……没人在跑床或建站就归档;复盘与去向不挡,在后台办」;十态清单里后台没办完的新式专项(复盘记录文件在而结论或去向没到)挂一行「后台还在办」;结案报告多一栏「后台收尾」。老式专项(没有这个文件)不显示;接力命令末尾不另印提醒。守卫验收完结那句回话同批改:去掉「把遗留清单发主控定去向、照它改好收尾单」与「去向都定过」,多一句复盘与去向在后台办,判断一个字不动。⑥ 角色:产品经理验收完结后只跑接力命令收尾、结束一轮、报「没有待办」,不再转遗留清单、不再等复盘记录、不再改第三栏,提交完仍由项目经理关它的会话;复盘经理起关不变,记录写在新位置,计划已归档的看板与机器镜像去归档目录读;项目经理多管三件(记去向、补「去向」一行、巡检看十态清单里挂的行);X大脑 定完去向交项目经理记。不做的:新增态;新增挡人的闸(后台没办完不挡提交、下一条的开工与签字);自动提交;让归档等锁(轮询);排队一览新增一段(十态清单已显示,两处显示同一件事只多出钉着的断言);接力命令末尾多印一句提醒、已归档重跑补建骨架(减法审砍,罕见的建不成由复盘经理自己建文件兜);在治理站点上显示迟到的复盘结论(要显示,另立一条给站点加一页);改宪法;改提交命令、开工命令、开工条件的判法、发布门、工作区地图;把全仓的「收尾与归档」关改成按单元挡;动已归档的老收尾单与老复盘记录(老的原样留着,新规矩只管新完结的,十态与清单靠复盘记录目录里有没有这个文件分新老)。与既有决策的关系:不改两个裁判各判什么;ADR-120 里新设复盘经理、耗时表与红旗、发现先过减法审再定去向、会话命令认一类角色、手跑归档不问这几样原样成立;ADR-106 里的车道、风险标记、签字核、接力命令分三段与「没人在跑床或建站」原样成立;ADR-97 的「收尾与归档」那一关(已完结没归档的需求挡新的需求开工)原样成立,只是归档不再等复盘和去向。守不到:① 后台收尾被忘记,只靠十态清单的显示和项目经理的巡检催,机器不拦;② 机器只核复盘记录里有没有「结论:」「去向:」两个记号,写得对不对、去向是不是 X大脑 定的、每条是不是都记了不核;③ 骨架只在这一次调用真搬了计划时建(接力命令与手跑带执行开关一样),已归档的重跑不补、建不成只说一句,这几种和本条落地之前归档的老计划一样按老式显示,十态清单里看不到它们的后台收尾,复盘经理自己建文件也行;④ 归档之后现跑耗时表读不到施工区副本里的跑床行,跑床那几项(含由它们亮的红旗)以收尾单第一栏定格的表为准,发布、归档、提交几段在定格那一刻多半还没发生、以现跑的表为准;⑤ 迟到的复盘记录和清单在下一次提交之前只在工作树里,一直没有下一次提交就一直不入库(提交命令对台账区里的文件不问是哪个会话写的、一并带上;只剩台账区改动时提交命令不会单独成一笔提交);⑥ 治理站点上看不到迟到的结论;⑦ 「下一步开工前插一条优化」的窗口缩小,插不上时变成立项排在下一条后面;⑧ 站点发布仍攒着发时,下一条照样等那一批。升哪一位:整个框架、项目架构、agent 架构各升第一位 —— 框架里归档之前问什么、完结之后三步怎么停、十态下一步、收尾单与复盘记录的写法,是改写既有契约;项目架构第五节「终点与发布状态」里清理归档那道关口的内容变了(连带阶段六的图 9 与图注);agent 架构里复盘经理的写域、产品经理与项目经理的职责边界变了(它的变更历史自己写明写域、禁区变了升第一位)。机制在架构详图 §八「清理归档」「收尾单与治理站点一格」「接力命令」「过程复盘的耗时表与红旗」(含新增的「后台收尾」一段)、§十四 十态表第 7、8 行、§十五 角色表与「遇到顶层问题的两种走法」、§十六「跑床分道并发」里「每次跑床记一行」那一条、§十七 术语表;设计在项目架构设计页阶段六(图 9)、第五节与第十节、agent 架构设计页的复盘经理一页与硬控清单第 50 行。
ADR-1232026-10-28发布提速:静态站点的发布前测试按整机预算开池同时跑(部署门入口的函数床照旧一张接一张);备份通过之后,发布档案的上传目录只留「这一次真要写的文件」(由备份已记的线上指纹与本版发布清单现算:指纹不同或线上没有的),只传它们,assets 检查点也只核它们,没变的文件不传不核。取代 ADR-121(床并行与床账)决定①里「运行器的进程内调用(发布前测试、部署门入口)缺省仍是 1,照旧一张接一张、当场真跑,两处出口一个字没动」的发布前测试那一半(部署门入口照旧);取代 ADR-110 里「发布前测试照旧一张接一张」那一句;取代 ADR-91 里「新文件传完、换首页之前把每个文件在每个访问入口各比一遍」的范围(改成只比这一次写的文件)。旧条目一个字不改为了:「发布提速」。病根:10-27 那两次治理站点发布分别用了 37 分钟和 68 分钟、全员静默:发布前 36 张床一张接一张(按跑床账各张最近一次用时合计约 21 分);上传与核对每次都是全站 716 个文件,核对每遍两个入口 1432 次请求、每遍 8–10 分,一个文件偶发超时(等满 3 次 × 60 秒)就整步不过、整轮重来,一次发布白核 18.5 分;而两次发布之间真变的只有 90 个文件。决定:① 发布前测试开池:发布准备调运行器时带上整机预算给的路数(预算读不出就直接报错);池只决定哪些床一起跑、不改红绿,发布前照样当场真跑;部署门入口的函数床照旧一张接一张(要在真函数目录里装配内核)。② 只传新增与改动的:备份那一步照旧读全站、留底本,它已记下每个文件此刻的线上指纹;拿它与本版发布清单比,指纹不同或线上没有的就是这一次真要写的文件(现算,不另存一栏);备份通过后把发布档案的上传目录收成这些文件;发布清单照旧记全站,换首页、清理、回滚都按清单算;要写的是零个就不传。③ 只核这一次写的:assets 检查点在每个入口上只核这一次真要写的文件;没变的不传、不核 —— 备份那一步从默认域名读到的就是本版要的内容,上传碰不到它们。核对窄到只剩这一次写的文件后,一个文件偶发卡住时,原样重跑一次整步只核这些文件,不再白核全站。不做的:提高同时下载的路数 —— 只核改动的之后一遍只有几十到一百多个文件,路数不是瓶颈;另量开池的路数 —— 用床并行与床账量定的整机预算;静默只框到准备完 —— 每次上传新内容都进部署门、当场核全仓单元都封着,要改就动发布出口的判决依据,归工作树一;收窄站点发布带上的体系守护技能床 —— 要先证明构建器不读那些脚本;没过的隔一会儿单独再核、单次请求超时 60 秒改 20 秒、默认域名先探路 —— 核对窄了之后原样重跑一次只核这一次写的文件,代价小,用户签字一时定了不做。守不到:没变的文件不再核,它在访问域名那一头若被缓存弄坏,这一次核不到(它上一次变的那次核过);备份到上传之间线上被别人换过版本,算出的「要写的文件」就不准 —— 同一时刻只有运维经理一处发布,靠纪律,备份那一步已有的「线上换过版本就拒绝」照旧;开池能省多少,前提是床并行与床账(ADR-121)让那几张起 git 的床进了池,还在池外独占跑的省不到,用时的下限由池里最慢的那一张床(站点床)定;池整体作废时会退回一张接一张重跑,那一遍比不开池还慢;再核、20 秒时限、默认域名先探路都不做之后,默认域名整个不通时,核对要对这一次写的每个文件各等满 3 次 × 60 秒才报(按约 90 个文件、6 路同时算,约 45 分钟)—— 默认域名直通桶、很少出这种事,记着就行。升哪一位:整个框架与 x-deploy 规范域各升第一位 —— 发布前测试开池、assets 检查点的核对范围,都是改写既有契约。
ADR-1222026-10-27派独立复盘只给程序生成的一段短表头(派发表头),审查官自己用读文件工具去读账本目录里的任务说明;守卫派发时核提示词恰好等于此刻现算的表头,复盘者收尾时再核表头、核它把说明从第 1 行读到了最后一行;旧的「提示词逐字等于说明全文」删掉、不并存。取代 ADR-87「边界」里点名的「提示词逐字等于程序生成」这一半(改成:提示词逐字等于程序生成的派发表头),其余半句(只派对抗审查者、连续三次不过要用户发话、结论行的固定格式、最新一次入账复盘过了才能完结)不变。旧条目一个字不改为了:「床并行与床账」。病根:守卫要证明的是「审查官手里的说明是程序生成的那一份」,旧办法却让派它的会话把说明全文逐字抄进提示词来证明。这条需求的说明约 39KB、一万九千字上下,大计划到过约九万字;抄这么长一段既慢,又会被平台的安全检查拦 —— 2026-10-27 一天里派复盘被拦了 8 次,而用户当天定的底线是被拦下就停:不重抄、不改写、不换会话、不换型号,所以复盘派不出去。病根不在抄的人,在做法:把几万字交给模型复述,等于把「证明」放在最不可靠的一环上,需求越大这条路越窄。可泛化的根因:机器之间传大段内容,传位置加指纹,不让模型复述。决定:① 表头:复盘说明命令(harness.js --action=review-brief)的标准输出只印一段几行的派发表头,说明全文照旧写进账本目录的 <名>.review-brief.md(账 .review-brief.json 在同目录),不再打印;接力命令七步走完,末尾把同一段原样印出来、前后各一行分隔线(免得复制时多拷旁边的说明句和环的态)、最后一行仍是复盘说明的编号。表头由守卫需求零件里一个函数(dispatchHeadOf)按账和说明文件现算,说明生成程序、接力命令、守卫三处都调它,算法只一份;说明正文的内容指纹(sha256 前 8 位,就是任务编号)与说明第一行(标记行)的拼法也挪进需求零件,全仓只此一处。口径写死:说明文件 = 标记行 + 两个换行 + 正文 + 一个换行;内容指纹算的是正文(去掉第一行、一个空行和末尾那一个换行;留着末尾换行算出来是别的指纹,所有表头就都出不来);「最后一行」N = 说明文件按换行拆开、去掉末尾空串之后的行数(briefLinesOf,表头里的「共 N 行」与读全的判定都用它)。表头只做三件事:认领(标记行:任务编号、计划名、结果单编号)、指路(说明文件的仓根相对路径)、交代怎么读(用读文件工具从第 1 行读到最后一行、写明共几行,一次读不完分段读);判法、需求、标准、结论行的格式都只在说明文件里,表头一个字不抄;表头里不写仓根(命令与守卫是两个进程,各自取仓根,盘符大小写、斜杠写法可能不同,写进去就可能逐字对不上)。出得来表头的条件只有三条:账与说明文件都读得出(编号是 8 位十六进制、有结果单编号);说明文件第一行逐字等于由账拼出的标记行(计划名也在这一行里);说明正文现算的内容指纹等于账里的编号 —— 任一不成立就没有表头(这也补上了一处此前没人核的:说明文件被改过、与账对不上)。写不进账本目录、或写完现算不出表头,命令退出码 1、什么都不印。编号就是指纹,不另造第二个数;32 位对防撞车、防写到一半够用,防人为伪造靠账本目录的写保护(进程内直接写是既有边界)。② 派发这一关(写前钩子 Agent 通道里复盘派出那一道):提示词带复盘任务说明标记时,在账本目录里找「现算的表头与提示词逐字相同(只忽略首尾空白与换行风格)」的那一份计划(headSlugOf,取代 briefSlugOf),找到才放,计划名从那一份取、不从提示词里读(改表头里的计划名绕不开连续三次不过的拦);找不到就拦:抄说明全文、表头里改一个字或加减一句话、改计划名、说明正文被改过、账或说明文件不在、生成之后又重新生成而手里是旧表头,都在此;报文只有一条固定话,以「复盘任务的提示词必须原样是程序生成的派发表头」打头,后面写怎么办(先跑复盘说明命令,把印出来的表头整段原样当提示词、不加字不删字;任务说明全文在账本目录的文件里,审查官自己读,不要抄进提示词)。带名字、类型、型号、账本被改过、连续三次不过要用户发话这几道原样不动。③ 收尾这一关(SubagentStop 复盘者那一支):可信条件里「提示词逐字等于说明全文」换成「提示词逐字等于此刻现算的表头」,再加一项「读全了」,其余(账在、编号一致、内容编号等于此刻、对抗审查执行体、结果单编号、没被续跑、不重复)不动。「读全了」(briefReadAllIn,纯函数,自己包住、出错按没读全;守卫收尾那一支调它时再包一层,因为守卫里任何抛错都是退出码 2、结论就丢)看复盘者的执行体记录(取读取情况的部分单独成 readCoverageIn):记录里读这份说明文件的调用(调用参数里的文件路径归一后——反斜杠换成正斜杠,比较用守卫现成的 keyOf,Windows 上不分大小写、别的系统区分——与这份说明文件的仓根相对路径整串相等、或以「/」加它结尾;只比后缀不行,读了别的计划的说明不算);按工具调用编号配对取这些调用的结果,没报错且带行号的才算(结果是一整串字或文字块数组都认;读超限的报错一句话、没有行号,不算);各次读到的行号取并集(同一次读在记录里还有请求拷贝里的副本,不按次数累计)盖住 1 到最后一行(空行在记录里是行号加制表符、后面什么都没有,不能丢;读到的结果会多出一个幻影行 N+1,多出来不碍事,漏最后一行 N 必须判没读全);读到的第 1 行里的任务编号等于账里的编号。搜索工具的调用里没有 file_path、命令行读更没有,所以它们读的不认。回话分五种说,缘由前面是「复盘者没有把任务说明读全:」:没有对说明文件的读取;对说明文件的读取都报了错(如超限)、没有读到内容;有读取但一行行号都认不出(平台记录的写法可能变了,读法可能失效,报 X大脑);第 N 行起没读到;读到的首行编号与表头不符;函数自己出错说「读取记录判不了」。不可信的那一笔照记、标不可信、不计入连败。结论行、结果单编号、记账字段、续跑与去重、连着三次不过要用户发话、对抗审查官、型号、不带名字这几道一个字不动。④ 旧路删掉、不并存:需求零件里整份说明比对、说明生成程序打印全文那一路、接力命令末尾「拿复盘说明原样派」那句、各处说明里「原样当提示词」的话、床里拿整份说明当提示词的夹具,一并换成表头 —— 并存就是两种写法,而全文那条路正是被平台拦的那条;不留「说明读不了时的折叠版」(读不了是账本目录坏了,该修;折叠版仍是复述)。⑤ 说明文件与账的文件名后缀收成需求零件里的两个常量和两个函数(BRIEF_SUFFIX、BRIEF_LEDGER_SUFFIX、briefFileOf、briefRelOf),守卫、说明生成程序、接力命令里拼这两个文件名的地方都改调它们;清理归档自己的固定后缀名单与留底文件名(.review-briefs.jsonl)不动。⑥ 说明正文里加两句,防审查官自己动手:预算句改成「十分钟左右,工具调用三十次以内(读这份说明本身的几次不计入)」,免得为省调用少读;纪律里加「不要运行复盘说明命令或接力命令重新生成说明(会换掉你正在读的这份说明)」。⑦ 不可信的原因不落账:复盘笔里没有原因栏、不记原因码,原因只在复盘者收尾那一刻守卫回的话里;三查里那句旧话(「最新复盘的任务说明不是程序生成的那一份(不可信)」)改成不指某一个原因,把可能的几种列出来;履历里的那一句不动。否决:折叠版(说明读不了时给缩短的全文):仍是复述,还丢上下文;让守卫把短提示词改写成全文:多一个隐形机制,平台怎么对待被改写的输入没有实测;让会话手写短提示词:提示词能带着审查官走(第三次独立复盘抓出的正文前面塞话),所以只能是程序生成的那一段;装读文件的实时钩子:要用户亲手改钩子接线,而执行体记录里已经有证据;只给表头、不核读全:旧办法保证审查官手里一定有全文,不核读全就把这条保证悄悄放掉了;不算说明文件的指纹、编号只靠账:说明文件被改或写到一半没人发现,现算只是几行代码;另设表头文件:表头由账和说明文件现算,不多一个要清理的过程文件。与既有决策的关系:不改两个裁判各判什么;ADR-87 里其余部分(判法只对着签过字的标准、遗留、预算、固定检查、结论行的固定格式、「最新一次入账复盘过了才能完结」)原样成立;第三次独立复盘抓出的「复盘者的提示词必须是程序生成的、不能被塞进别的话」的用意不变,只是「程序生成的那一份」由说明全文变成派发表头,说明全文改由指纹对着账核。升哪一位:整个框架升第一位 —— 派复盘的提示词由说明全文改成表头、旧写法被拦,是改写既有契约,守卫判法同批改写并新增「读全」;项目架构与 agent 架构各升第三位(订正:设计页里讲派发与核对的几处对表,环节、关口、写域、经谁核、禁区的主语都没动)。守不到:① 审查官读的过程中说明被换成别的内容、读完又换回原样:要在生成程序之外写账本目录,与既有「进程内直接写」同一条边界。② 「读全」靠执行体记录里读这份说明文件的结果的写法(行号加制表符):平台改了写法,复盘会全记成不可信(往安全的方向错),要更新读法;回话里「有读取但一行行号都认不出」那一种就是这个信号,话里写明「报 X大脑」;床里的夹具照真记录写,抓不到平台以后的变化,所以复盘者明明读了、却被记成没读全时,停下报 X大脑,不重派、不换法子。③ 读全不等于读懂、读对:读了没用上机器不判,由三查与验收兜。④ 用搜索工具或命令行读说明的不认(它们的调用里没有 file_path),可能误伤按片段读的审查官;定义与表头里都写明用读文件工具。⑤ 平台的安全检查会不会连几行的表头也拦,这里保证不了:拦了就停下报 X大脑,不重试、不改写、不换会话、不换型号。⑥ 派出之后不能续跑审查官:续跑记不可信(既有),要再复盘就重派一个。⑦ 不可信的原因不落账:复盘笔里没有原因栏,原因只在复盘者收尾那一刻守卫回的话里;三查按可能的几种原因说、不指某一个,读不全的复盘不会在三查里被说成「提示词不对」,要回头看当时守卫回的话;履历里「结论不可信」那一句沿用固定写法、不分原因。机制在架构详图 §八「复盘进关口」「接力命令」与 §十七 术语表「派发表头」,设计在项目架构设计页阶段四与第十节、agent 架构设计页的硬控清单与对抗审查官一节。
ADR-1212026-10-27床并行与床账:并行数只由一份整机预算定,跑床的命令行入口与开发流 VERIFY 缺省按它开池同时跑(只选中一张照旧一张接一张,运行器的进程内调用缺省仍一张接一张);追踪器认得更多的「干净」(只读 git、不带改写开关的 oxlint、整串只是一条 node 命令的 shell 形态、嵌套运行器沿用令牌、床自己在测试根下建的仓内沙箱),准入册带口径版本;守卫主自测拆成按组同时跑的几张床;造副本带账、补环境,换入之后按指纹把副本跑出的床账收回真仓;改坏对照按点跑、按指纹记账;施工区副本里的运行时账与射程缓存和真仓同级写保护;每次跑床记一行,耗时表数得出并行度、CPU 占用和同一张床跑了几次。取代 ADR-110 决定①里命令行入口缺省一张接一张、开发期三处带 4 到 6 的那一半(运行器进程内调用缺省一张接一张不变),取代 ADR-110 决定②里「干净」的两处(「没写真仓」再加床自己的仓内沙箱,「没起碰真仓的非 node 子进程」里只读 git、oxlint 与单条 node 命令的那一半),取代 ADR-112 决定④里施工区对写保护答「不保护」盖住副本床账与射程缓存的那一半,取代 ADR-120 守不到里「跑床账只记每张床最近一次」那一条。旧条目一个字不改为了:「床并行与床账」。病根:一条改守卫的难事里约 1,120 次跑床,87% 是同一张床第二次及以后,重复集中在三处边界:副本里跑过的到真仓又重跑、直跑的不入账、守卫主自测一整张约 330 秒反复跑。同时跑也没起来:484 张次里只有 16% 进池,独占的 72% 是副本里准入册冷着、没有追踪结论;判脏与持锁的二十几张重床把独占道撑到约 30 分钟,4 路整仓约 42 分钟、只比串行快两成;本机 CPU 长期只用两三成。用户要求资源用足、固化进体系,不靠哪个角色记得。决定:① 整机预算:并行数只由一份整机预算定,函数与系数只写在 core/machine-budget.js 一处:路数是按逻辑核数算的路数(核数除以 2 取整)与按空闲内存算的路数(空闲内存减 4 GB 再除以 1.5 GB 取整)两者的小者,夹在 1 到 16 之间;它放在运行器旁边、判定口径区之外,运行器自己也不 require 它,改系数不作废别的床的旧记录。跑床的命令行入口(harness.js 跑床那一段)不带 --jobs 时取它交给运行器当缺省路数的上限,运行器再与这一轮真要跑的张数(--stale 沿用掉的不算)取小者;只选中一张时照旧一张接一张、不带追踪,封版命令逐张补跑因此一字不变;两张以上的小批照旧过「起池划不划算」那一道;--jobs 放宽到 1 到 16,池的上限提到 16。接力命令与开发流 VERIFY 起床时不再写死路数,吃命令行入口的缺省;运行器的进程内调用(发布前测试、部署门入口)缺省仍是 1,照旧一张接一张、当场真跑,两处出口一个字没动。系数的定法与实测:机器静时整仓各跑 8、12、16 路,量出拐点;2026-10-27 在本机(22 个逻辑核)量过:8 路 14 分 32 秒、12 路 13 分 57 秒、16 路 13 分 51 秒,8 到 12 路省 35 秒、12 到 16 路只省 6 秒,拐点在 12 路上下;缺省取保守值(每路按占两个逻辑核、1.5 GB 内存算,留 4 GB 给系统与别的程序),本机得 11 路,比拐点小一路、差不到 1%,所以系数没动;换入真仓后第一遍带追踪的整仓(缺省 11 路)27 分钟,其中含各床头一次在独占道学准入结论的一轮。② 追踪器认得更多的「干净」(追踪口径第 2 版,放宽):床起的只读 git 不再算「碰真仓的非 node 子进程」—— 子命令取追踪器自己的只读名单(status、ls-files、rev-parse、check-ignore 之类),那份名单只许是守卫只读 git 名单 GIT_RO(command-policy.js 导出,原样不动)的子集,由一张床核;子命令之前的开关是封闭清单,只认 -c <白名单键=值>(显示类、只读类的键:core.quotepath、core.excludesFile、core.autocrlf、user.name、user.email、commit.gpgsign=false、color.*、status.* 等)、--no-pager、--no-optional-locks,别的一律判脏,不再「认识几个开关就跳过几个」再往后找子命令;子命令之后带写文件或起程序的开关(-c、--output、-O、--ext-diff)照旧判脏;追踪器给它注入 GIT_OPTIONAL_LOCKS=0(不为刷新缓存去写索引,不要求命令自带);环境里追踪器载入之后才出现、或值改过的起程序的变量(GIT_ 打头的除 GIT_OPTIONAL_LOCKS,加 PAGER、LESSOPEN、LESSCLOSE、EDITOR、VISUAL、SSH_ASKPASS、SSH_ASKPASS_REQUIRE、ASKPASS)判脏。检测引擎起的不带改写开关(--fix 一系、--output 一系、--init、--write)的 oxlint 同样不算。shell 形态起的命令整串只是一条 node 命令(不含与号、竖线、分号、小于号、大于号、反引号、美元符、括号、脱字符、百分号、感叹号和换行)的,和换了环境变量的 node 子进程一样接上追踪,带这些符号的照旧判脏;fork 带的 execPath 不是当前这个 node 的不算 node。床里再起的运行器沿用外层这张床的令牌 —— 外层追踪器照常给内层床注入追踪,内层床的写记进外层同一份日志、由外层这张床一并判,内层自己的追踪读不到日志、既不判干净也不判脏(此前另起一套令牌,外层看是嵌套的追踪会话、记脏,床里再起运行器的床永远进不了池)。床自己在测试根(x-test)下按现成写法(zzharness-、zzmeta- 打头、名字以进程号结尾,与跑完顺手清、清理归档同一个认法)建的沙箱目录,里面的写不算写真仓,两个条件都要满足:名字里的进程号在这张床的进程树里(床起的驱动之类子进程的也认),运行器读日志那一刻这个目录已经不在了;按字面路径判。其余在仓内工作目录起或参数带仓内路径的非 node 进程(git add、git commit 之类的写命令,git -C,taskkill,PowerShell)仍判脏。准入册带口径版本:册头只留一个版本数,每条结论带它判时的那一版(缺的按册头算);运行器里一张口径表写明每一版是放宽还是收紧,改追踪口径必须同批加一行;一条结论走到此刻的版本,跨过的各行全是放宽 ⇒ 只作废判脏的(登记独占的不动)、判干净的不动,跨过任何一行收紧、或册子比运行器还新 ⇒ 全部作废。③ 守卫主自测拆块:驱动(verify-harness.js,一份平铺的顺序脚本)按组之间的依赖拆成 27 组,每组一个闸,组表写在驱动开头;--groups=甲,乙 只跑点名的组(按组表先后),--list-groups 印组表,点了表外的名字退出码 2。床:原路径 verify-harness.test.js 一块(签字作废与范围外点名、清理归档、验收回话、定档排队与顶层围栏、施工区、车道上机这几组),verify-harness-blk1 到 blk5 五块(blk1 需求对账起头、复盘者、签字题、执行体与组队;blk2 零件用到才装、零件坏了、故障注入对照表;blk3 脊柱只读、静态托管发布面、命令行直接发布、新运作命令、路由闸、命令判定后段;blk4 命令判定前段、孤儿规则书、部署与 DDL 门及钩子、MCP 墙、剥离臂与代码推送面;blk5 联调与发布门、部署门总预算、射程缓存、开工注入),往真仓里放东西的两组(h1-real 种临时判据与条款书、mg24 手建内核夹具)单拎成探针小床 verify-harness-probe.test.js,持锁、永远独占;另有核对床 verify-harness-groups.test.js —— 各块点名的组合起来恰好是全部组、每组恰好一处闸、持锁的只能是探针小床;它的被测只有驱动,而驱动在空壳对照的永不掏空名单里,所以床头用 @covers 点名各块床的源码,空壳把它们读成空、本床即红,空壳对照才有目标,不必在豁免名册里登记。按依赖拆:共用的定义挪到驱动开头一段(只是定义不带状态);共用同一条沙箱状态链的组并进同一块,拆不开的两处是静态托管发布面五节(共用发布档案夹具、网站注册表夹具与床门桩文件的先后状态)和零件三节(共用一份守卫副本与两张缓存);只靠前一组留下的状态的两组,各在本组开头自己摆好。驱动沙箱建在 x-test/zzharness-<标签>-<进程号>(进程号是驱动进程的,驱动是床的子进程),各块互不相同,能同时跑。换入真仓后在独占道里量到各块里最长的一块 72 秒(拆之前整张约 330 秒)。不按改动挑块:守卫入口一次装全部零件,块床的被测文件仍是整个守卫,守卫一改,各块的旧记录一起作废;块床不手搭检测引擎、不新增把引擎整树抄进沙箱的写法。④ 床账跨根:造副本时带账、补环境 —— 真仓的床账 beds.json 与准入册 bed-trace.json 只读拷进副本的 .claude/tmp/ledger(来源不动;都先读得懂才拷,正被写坏的不带并明说;不进指纹清单;.claude/tmp 里别的一个都不带),副本头一轮不再重跑真仓早过了的床;按名字不带的手机端包 miniprogram_npm 原样补回;来源仓根上那一层 node_modules 原样拷进副本(检测引擎找 oxlint 是按「仓根/node_modules/.bin」查的、不顺上级目录找,副本里没有这一层,增量检测一碰 js 或 ts 就报「Oxlint 未安装」,收尾环的床跟着红),其余各层不补、预览与执行都点名,检测引擎要的 typescript 不在根层,打印一句在副本里跑检测时该设的 NODE_PATH。换入帮手换入全做对了之后,同一个进程里拿运行器那把仓库级跑床锁(别处在跑最长等 45 分钟),让真仓的判定模块(test-faces.js 的 reclaimLedger)重算指纹,副本账里与真仓此刻指纹逐张相同的条目原样收进真仓(连时刻都不改),对不上的一条不收;同一指纹两边都有记录时红的算数(严重度 FAIL 等于 ERROR,高于 SKIP、SKIP-EXEMPT、PASS,副本更红的盖掉真仓的,真仓更红或一样的留着);只动床账的 beds 一节,封版记录、部署门记录、准入册都不收。拿不到跑床锁、判定模块装不上、收回途中出错:换入照常成功、收回跳过并明说、真仓的账一个字不动,之后任何一次从这个副本换入成功时再收;副本里没有床账就不收;换入有一个文件没换对、被拒、restore 都不收。缺环境的床在副本里本来就红或自报跳过,原样收回,没有「缺环境却收成绿」的路。判定模块账本的读写没有自己的锁,靠调用方已持仓库级跑床锁,写用临时文件改名不留半截。⑤ 改坏对照按点跑:入口 harness.js --action=beds --bite-list=<改坏清单文件>(--only 挑点,--jobs 指定路数)。清单由做改坏对照的那条需求自己写,放在它的计划目录里,一行一个点,竖线隔开五段:床路径、被改文件(仓根相对)、类(守卫、模块、判据)、原文、替换成;# 打头的行是注释;原文必须在被改文件里恰好出现一次,零次或多次的点记「出错」、不记咬不咬住。运行器拿跑床锁,在沙箱里按点替换着跑那张床;几路同时跑,只对准入册里判过干净、没自报持锁、不经部署门的床开并行,其余一张接一张。三样造法沿用空壳对照现成的:守卫另做一份守卫副本(.claude/hooks 去掉 tests)经环境变量交给床;模块与判据(判据文档里内嵌着检测器)用预加载桩把被改文件的读取、加载与复制成沙箱用的那一份(copyFileSync)换成替换后的内容,真文件原样,桩禁止写被改文件,对照前后比被改文件的内容指纹、对不上记「出错」并点名;登记在部署门的函数床不做(要动部署门入口)。结论三种:咬住(床变红且桩确实被命中)、没咬住(桩命中、床仍全绿)、出错。只对账本里对当前内容已经通过的床做,不是的先带 --stale 经运行器跑绿。结论按「床 + 被改文件 + 两者此刻的内容指纹 + 点号」记进床账每张床记录上的改坏栏 points(键是 <被改文件>@<内容指纹前 8 位>#<点号>,点号是把「类 + 原文 + 替换成」拼起来取 sha256 的前 8 位;值是 { res, at, pt });判定模块导出 bitePointId、bitePointFresh(此刻床指纹与被改文件指纹下已有这个点的结论就不重跑,打「沿用」,旧结论是没咬住或出错的,沿用也算未过)与 recordBitePoint(账里这张床没有对当前内容的记录就没处记、抛);出错里只有内容决定的才记(原文不是恰好一次、类与被改文件对不上、桩没命中),超时、进程异常、床本身红、被改文件在对照期间被改了这类可能是一时的,只报不记(记了会把重跑挡住)。改坏栏只记结论、不参与「过没过」的判定,收尾、封版、发布认的仍是空壳对照;这个动作不碰床账里各床的红绿与空壳对照、不写准入册,没咬住与出错退出码 1。桩够不着的:整目录复制(cpSync)带走被改文件的(自己抄检测引擎整树的床就是)、异步读取、非 node 子进程、桩自己,打不到就是「桩没命中」、记出错,逼着换一张床或换一个点。⑥ 施工区副本里的运行时账与射程缓存和真仓同级写保护:副本里的 .claude/tmp/ledger(床账与准入册等运行时账)和 .claude/tmp/.scope-cache(检测引擎的射程缓存)照真仓写保护,编辑工具与命令行都写不了,办理会话自己也一样 —— 副本床账里的结论会在换入之后被收回真仓,账若能随手改,把一条红改成绿、指纹照旧对得上,假绿就顺着收回进了真仓;射程缓存放一份键对得上、射程缩小的进去,副本里的检测就漏文件,红的床在副本里变绿、又被收回,所以收回真仓的结论不能比真仓自己记的更好改。只这两处:副本里 .claude/tmp 下别的子目录(需求账、会话登记册、装配标记)、守卫(.claude/hooks)、运行器、换入帮手照旧不保护、照旧能写;运行器与检测引擎在进程内写这两处,不经这道闸。实现在守卫命令判定模块 command-policy.js 的脊柱谓词开头两行,排在「施工区不保护」那一句前面,原来各自排在后面的两条已挪走;同一个模块导出 GIT_RO,供追踪器的只读 git 名单那张床核子集。⑦ 每次跑床记一行,耗时表数得出:运行器每真跑了床(n 大于 0;--stale 全都沿用、只列不跑的不记)就往 .claude/tmp/ledger/bed-runs/<YYYY-MM-DD>.log 追加一行 JSON,放在账本目录下的子目录、后缀 .log(会话台账把账本目录根里每个 .jsonl 都当会话账读);写入用进程内的文件写、不经守卫,写入时顺手清文件名日期早于 30 天前的 .log;字段全必填、数值都是整数:v、t0(拿到跑床锁、真开始跑的那一刻,排锁等的时间不算进墙钟,免得并行度被稀释成假低)、t1(床全跑完、账记完的那一刻,卫生检查之前)、jobs、n、pool、solo(pool 加 solo 等于 n)、beds、bedMs、cpu(这段时间整机 CPU 占用,取开跑和跑完两次 os.cpus() 的差)、sid、root(仓根不在 x-test/zz-work/ 里面写 repo,在里面写 copy:<计划目录名>/<副本名>)。命令行入口与进程内调用(发布前测试、部署门入口)都写,换了判定模块或锁文件的自测演练不写(免得自测往真仓账里写假行;要核记行本身的床明传 runLog: true);写不进只打印一行,不影响这一轮床的结论与退出码。耗时表只读这些行:真仓里的行按 sid 认这条需求的办理会话(含它派的执行体,同一个会话号),施工区副本里记的行留在副本自己的账本目录里、按这条需求的施工区就地全算(清理归档之前读得到);跑床账 beds.json 只给封版时刻和休眠判断里「全仓有动静」的证据,不再数次数,生成器里没人再写的旧读支删掉、不留两条读路。表上加「跑床并行度」(床自报用时之和除以跑床墙钟合计)与「跑床期间 CPU 占用」(按墙钟加权平均)两项;红旗验收之后按 8 条门槛查、在办期仍按 3 条(拦截、命令、空档),新加的两条是低于才亮 —— 并行度低于 3、CPU 占用低于 40%(拿表上显示的数比;经运行器跑床的墙钟合计不到 10 分钟,样本太小不判);「同一张床跑得太多次」按这些行里的床清单数,直跑的不在内;表头写「按 N 条门槛查」,N 是查几种、不是亮了几条(常量 FLAG_KINDS)。「独立复盘」一段没有派出记录时(审查官不带名字派、守卫只记带名字的派出,所以实际一直没有)改取审查官在会话账里第一笔带执行体名的动静,两样用同一个过滤(落在开工到完结之间、不早于最后一次封版),不再退到最后一次封版,两样都没有这一段写「—」。「跑床只经唯一运行器」写进体系守护技能说明与架构详图:直跑不记账、不记行、不进耗时表,不能当通过的依据,直跑机器不拦,只是不被数到。不做的:直跑自己记账 —— 跳过口径、残留检查、空壳对照都在运行器里,直跑也记账就多了第二个裁判;接力里检测与跑床同时起 —— 检测红就停是接力的语义,能同跑的只有进池的床,省的只是增量检测那几秒到一分钟;检测引擎接整机预算 —— 接力里的检测是增量的、不走线程池,全量检测没有调用方会去设它;按改动只跑主自测的几块 —— 说不清;读得宽的床另立收窄机制 —— 进池之后重跑不贵,证明了不读才逐张收窄;函数床进池与函数床的改坏对照 —— 要改部署门入口;检测引擎与运行器上游的作废收窄 —— 判定口径真变了,靠进池做快;几个会话的跑床同时进池、几处跑床合起来不超过预算的机器级计数,连同数直跑、拦直跑 —— 要等账本加锁,并进待立项目「同时进池」那一条。与既有决策的关系:不改两个裁判各判什么,不改空壳对照(ADR-67)与发布前测试的口径;ADR-110 里其余部分(准入只认带追踪的独占跑、结论绑床文件与夹具、两道快照、污染窗口、池里红绝不改绿、小批不起池)原样成立;运行器的上游组仍是判定口径区加整个 bite/ 目录,bite/ 下新增 points.js、write-trace.js 改了,换入真仓后全体床的旧记录因此作废、第一轮是全量打底;machine-budget.js 在上游组之外,改系数只让体系守护自己的床重跑。旧条目一个字不改。升哪一位:整个框架升第一位 —— 跑床的命令行入口缺省由一张接一张改成缺省开池、施工区对写保护答「不保护」收窄,都是改写既有契约;项目架构设计页只订正两处讲法,升第三位。守不到:① 追踪口径:起程序的环境变量只对着追踪器载入时的快照比(载入之后才出现、或值改过的判脏)—— 被追踪的父进程把变量放进 node 子进程的环境、子进程再起 git,在子进程里算「本来就有」,看不出来;载入时就有的变量(例如指向仓内的 GIT_TRACE)git 真写了文件,追踪看不见;HOME、USERPROFILE、XDG_CONFIG_HOME(换 git 读的配置)和 PATH(换 git 本身)没有列进去;起程序的配置写在 git 自己的配置文件里,命令行上看不出来(往仓内 .git/config 写是追踪得到的写,仓外的全局配置不归追踪器管);git diff、git describe --dirty 在 GIT_OPTIONAL_LOCKS=0 下仍可能刷新 .git/index(只改时间戳、不改内容);git -C 判脏,所以用它的两张床(work-area-copy.test.js、workspace-completeness.test.js)留在独占道,要进池得改成 cwd 写法;床的仓内沙箱豁免按字面路径判,床往同名目录里写了别的东西、或床外预置的目录联接把写引到别处,追踪都看不出;追踪器盯父进程只看进程号还在不在。② 池:池协调器杀进程树时用同步调用卡住事件循环,期间已经退出的好床可能被记超时;池越宽,掐着时限的床越容易在忙时超时变红(照旧独占复跑归因、红不改绿);守卫目录里 team-gates.test.js 的 T5b 在池里偶尔红、独占跑绿,运行器已把它登记独占,原因没查清;副本与真仓、几个会话同时跑床时各按整机预算开池,合起来会超,要等「同时进池」那一条的机器级计数;全量检测照旧按核数定线程,和宽池同时跑时两边共用一台机器;缺省路数的系数按机器静时量出的拐点取保守值,机器忙时快不到那么多。③ 床账跨根:收回只认指纹逐位相同 —— 指纹证明内容相同、证明不了环境相同,所以副本补不齐环境的床在副本里红或自报跳过、原样收回(红的算数);反过来副本里缺了某样东西却照样通过的床(悄悄少测、又不自报跳过,这本来就违反「跳过不是通过」),它的绿会被收回;node 进程里直接改副本账,和真仓账本一样守不到;封版命令、部署门入口写账不一定在跑床锁里,收回把读-合并-写压在最后一小段,仍有极小的丢一笔窗口;收回等锁最长 45 分钟,而工具里单条命令最长 10 分钟,运行器占锁超过 10 分钟时换入命令会被工具超时杀掉 —— 换入早已做完、收回没做,下一次换入成功时再收。④ 写保护的例外:守卫只按路径字面判,把副本里的 .claude/tmp 整个挪走、写完再挪回来拦不住;签字放行的永不放行名单锚在仓根,施工区副本里新保护的这两处账不在其内,落点表盖住 x-test 下面的需求,它的办理会话能写自己副本里的账;工作区地图的数据与读取模块(.claude/hooks/workspace/ 下的 floor.js 与 map-engine.jsonl)仍把施工区写成不受写保护,没有同批改。⑤ 记一行与耗时表:清理归档之后读不到施工区里的行,同一张床跑了几次只数经运行器跑的,账本目录里清掉的旧行不计入,直跑这一条只写进说明,数与拦都要等「同时进池」那一条;行是运行器自己写的,进程在写之前被杀就没有那一行;并行度的分母是整趟跑床的墙钟,含运行器自己的开销与池里排队,小批偏低,命令跑到一半机器睡了那一段也算进墙钟;CPU 占用是整机的,分不出是谁占的。⑥ 一处没订正:plan-wrapup.js 约 353 行的注释仍写着「六条红旗」,它不在这条需求的落点里,没有改。机制在架构详图 §十六「跑床分道并发」「床账跨根」「改坏对照按点跑」与 §八「项目自带」「过程复盘的耗时表与红旗」,设计在项目架构设计页第十节「施工区放哪」。
ADR-1202026-10-26复盘经理:新设一位「用时起、用完关」的经理,每个专项验收完结之后复盘这一程(补上 PDCA 的 A);不新增流程;接力命令归档之前只多问一样「复盘记录里的结论写了没有」。旧条目一个字不改为了:「复盘经理」。理由:独立复盘只判交付对不对,验收完结之后没有人回头看这一程时间花在哪、哪里卡、哪里反复,同样的耗时(同一张床反复跑、同一种拦截反复出现、一条命令跑半小时、一小时没动静)下一条照旧再来一遍。用户原话:「类似项目经理,运维经理一样,我期望构建一个新的经理,流程节点给到项目经理的专项闭环之后发起的,然后把结果报备X大脑」。决定:① 复盘经理只作会话用,项目经理在专项验收完结时起、它报完结果后关,和发布同时进行;它跑耗时表那条只读命令,按这条专项的档写结论与发现,只写专项计划目录里的 RETRO.md,报 X大脑,不定去向、不派执行体。② 耗时表与红旗由机器出,门槛的数只写在生成器一处;十态对在办的需求多打一行红旗,在办期只认拦截、命令、空档三种(同一张床反复跑与某一段超上限只在验收之后算,在办期接力命令反复跑床是常态,会常亮);全仓会话的台账同时一笔都没有、也没有命令在跑的长空档单列为「休眠」,不算等待、不算卡住。③ 收尾单第一栏多一节「过程复盘」(表每次刷新时从账本现算,不抄进复盘记录),发现进第三栏、每条标「过程:」。④ 发现先过一次复杂化审查官的减法审,再由 X大脑 逐条定「下一步开工前插一条优化 / 排进清单 / 不立」,会让接下来几步做错、或每一步都要多花不少时间的才插,与停线、记一笔同一个口径,判法只写在架构详图「遇到顶层问题的两种走法」一处。⑤ 会话命令多认一类角色:起它要带专项名,列会话时不点名它不在,恢复时不自动拉它。⑥ 手跑归档的执行开关和现有两样一样不问结论。为什么是一位经理、不是一条新流程:流程按落点认、按档分手续;过程复盘不动受治文件、不按落点分,每个专项验收完结之后都要有,是三条主流程闭环里一个固定的步骤,不是又一类事;新开流程要改车道表和认流程的守卫,而沿用会话命令、多认一类角色就够了。为什么归档只挡一样:不挡,赶时间时必被跳过;挡得多,每个专项都为复盘多等。结论一句话,小事几分钟写完,和发布同时做,挡不着验收和发布;发现进了第三栏,由「去向都定过」那一样管;架构师的改法不挡。不做的:新增第六条流程;把表抄进复盘记录;每个专项都深挖;让复盘经理自己定去向。守不到:结论写得对不对、挖得深不深,机器不判,只核写没写;卡住的命令账本里看不见,只能用多久没动静近似;跑床账只记每张床最近一次的结果、没有逐次历史,「同一张床反复跑」这条红旗要等账里带上逐次记录才会亮;休眠把「机器开着、全体会话却都在等」的长空档也认成休眠,命令跑到一半机器睡了的那一段算进这条命令的时长;用户在控制台里手工做的步骤账本里没有;复盘经理写的结论与发现原样进收尾单、会随治理站点公开,不贴命令原文由它的定义管、机器不过滤。升哪一位:整个框架与 agent 架构各升第二位(新增一类东西)。
ADR-1192026-10-26签字与开工分开:签字一不再被单元挡,可以提前签好几份,开得了工就当场开、开不了就排队;开工才占版本单元、放行写、算在办,占到这一条提交完;排队的需求等项目经理(或主控)跑开工命令。取代 ADR-94 的同一块排队、ADR-97 的收尾与归档硬控、ADR-106 的改判定代码同一时刻只办一条这三道在签字那一刻「签不上」的那一半(判法不变,从拒签改成判开不开得了工;ADR-94 的定档与上限、办理会话、顶层围栏,ADR-97 的登记与清理,ADR-106 的认流程与最低档都不动),取代 ADR-98 里一道确认题多选要求几份计划落点单元两两不相交的那一条,取代 ADR-98 里项目架构环的启动是守卫记下签字一那一刻的定义(改成开工那一刻),补 ADR-100 里联调与正式发布核「在办」的读法(排队的不算在办)。旧条目一个字不改为了:「代签到底」。理由:签字一是用户对做什么的点头,占版本单元的是动手、不是签字;签字一要能提前签、一次签几份,用户不再做一条、等一条、签一条。单元空着时签字那一刻就是开工,账本里那一笔与普通的确认一模一样,靠签字造在办需求的床与直读确认那一笔的读者都不用跟着改、也不用多按一次开工;只有前面有人占着,才多出「排队」与「开工」两步。占到提交完、不是到验收完结:工作树之前大家在一棵树上,同一单元的下一条一开工就会动前一条交付的文件,前一条的发布会被版本比对拦住(下一条的单元在施工,全仓发不出去),它的提交里也会混进下一条还没验收的改动;占到提交完,这两件事都不会发生。前一条从验收到提交多出来的那一段(主要是发治理站点),后一条本来就得等它发完才能动,不是新多出来的等待,只是由机器管住。决定:① 签字与开工分开:签字一仍只由用户本人签,锁住的五样、签字时的落点表、档与车道、办理会话、受保护格放行的授权都照常记;开了工才占单元、放行写、算在办。② 开工条件三样,签字那一刻与开工命令判的是同一个函数:它要占的单元上没有开了工没完结的需求,也没有完结那一笔记着「要提交」而账本里还没有「提交」那一笔的需求;它碰到判定代码时没有别的开了工没完结的需求也碰着;仓里没有已完结、计划还留在计划目录的需求。③ 签字那一刻:三样都满足就当场开工(记基线、占单元、放行写,账本里那一笔就是确认那一笔);有一样不满足就记成带「排队」标的确认——不记基线、不占单元、不放行写,也不拒签,回话写明在等什么。④ 「开没开工」只有一个判法:账本里有「开工」那一笔,或有一笔确认不带「排队」标;一旦开了工就一直算开了工,所以没有排队标的确认、排队的重签时开得了工的那一笔,都算那一刻开工。账本校验只验链与镜像、不认事件种类,新加的「开工」「提交」两种事件不报警。⑤ 还没开工的(第一次签、排队的重签)三样逐个单元全判,不走「上次签过字就不查」的捷径(排队的那一笔没占任何东西,走捷径会把它当成已占着、两条同占);已经开了工的重签只查新加进来的单元与新碰到的判定代码,已占着的单元、已碰着的判定代码、阶段六的关口不查,被别人占着照旧拒签、点名,不退回排队(退回去就放开了它手里的单元,下一条开工会动到它做了一半的文件)。⑥ 开工命令:体系守护技能的开工动作,不带执行开关只预览;只有会话登记册里的主控与项目经理跑得了(身份取自会话环境里的会话号);依次核这条需求签了字一、还没开工、签字没作废、账本可信,再核开工条件三样;都过才记开工基线与开工那一笔,并叫醒这条需求的产品经理(会话号不变、办理会话不变)、经消息告诉它开工。命令受写保护、算判决依据(「三查」那一样,开工基线是三查的底),与提交命令一样写账本,不认换守卫目录的环境变量与命令行换仓根。⑦ 排队的需求:不占单元、不放行写、不算在办——不挡正式发布、开不了联调、封版的「为了」绑不上它,三查、接力命令、验收完结、代签、验收区、出题、复盘说明都拒它并说「还没开工」;签字照旧会作废(五样变了要重签,过程改动照旧由主控核准),排队的签字作废后状态仍是排队、另带「要重签」的标;核准过程改动时排队的需求不查单元占用与判定代码占用,开工那一刻整张落点表重判。⑧ 谁占着单元从账本认:占到提交完的那一段,前一条已经完结、计划多半已归档,不在计划目录里,所以开工条件的占用者在计划目录之外另从需求账本认(完结那一笔记着「要提交」、还没有「提交」那一笔的,按它签字时留底的单元与目录算占着)。⑨ 读「在办」的各处按开了工认:只认在办才放行的读者自然把排队排除在外;取反型的读者(验收完结、代签、验收区、出题、排队一览、十态、复盘说明、封版绑需求的作废那一支)显式补「还没开工」一支;直读确认那一笔的(基线、联调零件里计划不见了从账本认在办、履历的总用时)一律问「开没开过工」与开工基线;发布登记给落点表盖得住的需求记「联调」一格,问的也是账本里开没开工,排队的不记。⑩ 一道确认题的多选放开:不再要求几份计划的落点单元两两不相交(那条要求的理由是先签上的占住单元、后一条当场被挡,用户白勾一条,现在后一条只是排队);验收完结照旧一份一份签。⑪ 十态不加态、态名一个不动:排队并进第 2 态「已立项」,下一步分两种(没签的,主控弹确认题;签了在排队的,排到由项目经理或主控跑开工命令、叫醒产品经理);项目架构环的启动改成开工那一刻(当场开工的就是签字那一刻),需求履历仍在签字一那一刻建、状态仍只有在办与完结两种,「总用时」从开工算。⑫ 点名:每次回话在「待清理归档」那一行之外,已完结、完结那一笔记着「要提交」、还没有「提交」那一笔的点名「待提交」,「提交」那一笔记着没推成的点名「待补推」,两行从账本认、只提醒不拦;「待清理归档」那一行后面的半句写「它搬走之前,新的需求开不了工」。⑬ 提交命令末尾印出这一次放开了哪些单元、此刻开得了工的是谁,主控转给项目经理,下一条的开工不用等下一次巡检;先后仍归项目经理排、主控拍板。⑭ 没有「排队」标的确认一律算签字那一刻开工;完结那一笔不带「要提交」的不占单元,提交命令也不碰它。升哪一位:整个框架改写既有契约(签字一不再被单元挡、项目架构环的启动改定义、「在办」改指开了工的),与 ADR-118 同在整个框架升第一位的那一版里。不做的:每一笔签字都排队、再由开工命令开工——单元空着时签字那一刻就是开工,靠签字造在办需求的床与直读确认那一笔的读者都不用跟着改;加第十一态——排队并进「已立项」,十态的名字不动(散在十几份文件里);提交后自动开工、环收尾那一刻自动提交——先后归项目经理排,提交只是主控一条命令,命令末尾印出此刻开得了工的需求,下一条开工不用等巡检;单元只占到验收完结——前一条的发布会被下一条的施工中单元拦住,提交里也会混进下一条没验收的改动。有了工作树之后:开工改成进自己的树开工、不再占单元,排队挪到合并那一步;「开工」这一笔留着,「占到提交完」这一条和提交命令里「共用一棵树时只提交这一条的」那一段由工作树那两项改,到时另立决策记录。守不到:签了排队的计划,排得越久越可能因为前面的项目改动而要重签,锁住的五样变没变机器核,计划还合不合时宜机器不核;开工的先后归项目经理排、主控拍板,机器只管同一单元同一时刻只开工一条、碰判定代码的同一时刻也只开工一条,谁先谁后不核,开工命令按会话号认登记册里的主控与项目经理,执行体与派它的会话同号,主控或项目经理派出去的执行体也跑得了——开工条件照样全由机器核,最坏是先后排错;单元占到提交完,前一条的发布卡住(比如后台那一格要用户亲手构建),同一单元的下一条就开不了工,只能等它发完、提交,用户自己用 ! 命令把它提交了的,主控再跑一次提交命令,它认出东西已在库里、照常打标签、记「提交」那一笔,单元就放开(开工条件只读账本、不碰 git);不同单元的两条可以同时开工,但全仓发布要求全部单元都封着,先完结的那一条要等另一条把它的单元封了版才发得出去,工作树之后从主干发,这一条随之没了;环收尾到提交、提交到下一条开工,机器只在每次回话里点名「待提交」「待补推」,不替人跑命令,跑不跑、什么时候跑靠主控与项目经理巡检;账本追加没有跨进程排队,开工是账本的又一个新写入者,同一时刻两个会话往同一份账本追加,链可能断(断了照旧判成账本被改过、照拦,不会放过),同理签字与开工、或两次开工恰好同一时刻判同一个单元,两边都看到空着,可能两条同占——判与记之间没有锁,并进后面的账本加锁一起加;治理站点的项目页把排队的需求显示成「在办」(构建器把没完结的一律当在办),不报错、不挡什么,单列「排队」留给「五类架构跟得上」那一项。机制在架构详图 §八「签字与开工分开」「同一块排队」「开工命令」、§十四(十态与启动)、§十五(角色表、提速的八条规矩)。
ADR-1182026-10-26代签到底:验收一签同时授权这条需求的发布与提交,机器按项目名提交、打项目标签、顺手推;命令行里的 git 一律只读,提交只经一条受信的提交命令;钥匙石与代签设置机器从不替用户提交;存档点提醒退役;换入帮手多一个「删」;十态命令对已提交的需求出结案报告;代授权发布治理站点按「这条需求有没有治理站点一格」认。取代 ADR-05「保护改为 hook 可见性 + 用户审 commit 硬闸」的后一半、ADR-15「诚实残余……唯一权威=用户审 commit diff」那一句、ADR-93 里「到了存档点由守卫在收尾时直接对用户说一句」那一样、ADR-98 与 ADR-116 里「只发治理站点的需求才连带授权、别的发布面单次授权」的口径(代授权那条路照旧)。旧条目一个字不改为了:「代签到底」。理由:验收已经核过做成的东西,发布与提交只是把核过的那一份放上线、放进库,再要一次授权不多核任何东西;提交只经一条受信命令、命令行一律只读,比办理会话随手 add、commit 与谁都提交不了两头都稳;历史只增不改,用户随时按项目标签回看。决定:① 验收一签同时授权发布与提交(发布授权的口径见下)。② 提交命令:环收尾(已发布、已归档)之后由主控跑体系守护的提交动作,不带执行开关只预览、带了才做;命令本身不限谁跑,它核的是这条需求的验收与环收尾;跑之前依次核五样 —— 这条需求已完结且完结那一笔记着要提交、环收尾成立、还没提交过、在主干上且暂存区里的路径都在这一次要提交的清单里、交付的每个文件此刻仍是验收那一刻的内容(或库里已有验收之后提交的、与工作区一致的版本),哪一样不过就停、什么都不写;只提交这条需求验收过的交付、它的履历与归档、台账(工作区地图「入库」属性为台账的,加主控线与已完结需求的发布段),不带别的需求还没走完的一切;提交说明三段(标题以短名打头、一个空行、「需求:需求名」一行),打带说明的项目标签 req/<需求名>,只推主干与这一个标签、原子推送、只许正常推,被拒、断网、缺凭据、超时都留在本地、重跑补推;账本里记「提交」那一笔,做到一半出错的重跑时从缺的那一步接着做、不重复提交;用户手工提交过的现场认出来、照常打标签记账;命令受写保护、算判决依据(「发布出口」那一样),不认换守卫目录的环境变量与命令行换仓根。③ 命令行里的 git 一律只读,不分是不是办理会话;symbolic-ref 只放读一个名字,带两个参数、-d、-m 都拦;报文指向提交命令,退回、重置永远不做;提交命令因此是真仓里写 git 的唯一一条受信的路。④ 钥匙石与代签设置(.claude/settings.json、.claude/sign-settings.json)机器从不提交 —— 提交命令里点名的一份短名单,只许加不许减;它们与库里不一样时每次提交点一次名,等用户亲手看、亲手提交。⑤ 存档点提醒退役:它的前提是存档归用户、守卫平时一个字不提;现在每条需求环收尾之后机器就提交,再对用户说「可以存档」是叫他做一件不归他做的事;剩下没人提交的(钥匙石与代签设置、不归任何需求的改动)由提交命令每次点名。⑥ 换入帮手多一个「删」:签字放行只管写、不管删,要删受保护文件(存档点那两份的退役就是)只能由换入帮手做 —— 清单里标删的文件先备份、问同一份放行、再删,恢复时放回。⑦ 结案报告:十态命令带计划名查一条已提交的需求时,末尾印五行加一行提交号(交付了什么、发了哪几格、还要用户上传的端、遗留去了哪、代签凭什么),全取自履历、发布段、收尾单与账本,项目经理转 X大脑、X大脑 原样转用户。发布授权的口径:验收完结那一签(亲签,或照代签设置代签)同时授权这条需求该发的每一格各发一次,出问题立刻回滚算同一次;亲签的凭 X大脑 转来的验收原话,代签的凭代签记录,机器核带「代授权」标记的这一条路;「只有只发治理站点的需求才连带」那一层取消;不随验收的发布(重发、每天的站点、静态站点回滚到更早的版本)、生产构建、开发中途的联调授权照旧另要单次授权。代授权发治理站点:治理站点发的是此刻封过版的整棵受治树,原料目录只占其中一小块,只改受治文档的需求落点里没有它,按目录对落点表就一律被挡在门外,而该不该发这一站本来就是这条需求有没有「治理站点」一格;这一格有没有的判法只有一份,住守卫的联调零件,发布登记转调它,部署门、云函数脚本出口、静态站点发布准备三处问同一个;答有、没有、判不了,授权门把判不了当没有、拦下并说判不了,发布登记把判不了当有;后台、手机网页版、官网这些别的站点照旧按落点表认,「要发的内容等于验收那一刻」那一道不变。ADR-15 预注册的那一条(威胁模型升级时用服务端分支保护)不触发:参与者没变,推送用用户自己的凭据,变的只是提交这个动作交给了一条受信命令。升哪一位:整个框架升第一位。不做的:发布标签(每个发布号一个标签)—— 发布号记在需求履历的发布段里、随提交进库,按项目标签就找得到,再打一套用不上;一次提交几条需求(合并提交)—— 一条需求一个提交、一个标签,用户回看的单位就是一条需求,同一处同一时刻只落一条,撞不上,目录重叠、单元不同的那一种等后一条先提交就行;环收尾那一刻机器自己提交 —— 先后归项目经理排,提交只是主控一条命令;改项目设置的权限名单(加 git commit、push)—— 守卫的命令行只读已经挡住手滑,改设置要用户开闸,不值得;远程主干保护 —— 只归用户,写进守不到;提交只限主控跑 —— 它核的是验收与环收尾,谁按都一样。守不到:亲签那条路机器不核转来的是不是用户的原话;治理站点这一支只信履历里记的落点表,不核它与盘上的文件对不对得上;推送的远程是不是公开、凭据过期要不要人点,机器不知道,凭据管理器的真实行为床里造不出来;脚本进程里直接调 git,守卫看不见,命令行只读只防手滑;用户自己的提交(! 命令、他自己的终端)机器不核,他手工提交过某条需求的东西,提交命令认它已在库里、照常打标签、记那一笔;提交说明的标题与结案报告照抄履历、发布段、收尾单与账本,那几份写错这里跟着错;核完内容到放进暂存区之间别的会话改了交付文件,查不出;账本追加没有跨进程排队,提交是账本的一个新写入者,同一时刻两个会话往同一份账本追加,链可能断(断了照旧判成账本被改过、照拦);没有需求在办时主控线与账本的改动不会自己进库,等下一条需求提交时随它带上;用户事后按标签看 diff 是纪律,机器不逼;远程主干不被强推要在 GitHub 上开保护,只归用户。
ADR-1172026-10-25会话型号按角色给:两位架构师(产品架构师、Harness架构师)的会话起成 Opus 5.5,其余(项目经理、运维经理、各专项的产品经理)起成 Sonnet 5.5,推理档仍然是最高;起完照旧对着横幅核,型号按这位的角色核;子代理(执行体)照项目设置仍是 Sonnet 5.5,被派出去当执行体的架构师也是执行体、同样跑 Sonnet 5.5;X大脑 的启动命令不变。取代 ADR-116 里讲会话型号的那一半(会话都用同一个型号),ADR-116 的其余部分(含「会话型号与子代理型号分开定」)不动。旧条目一个字不改为了:「会话型号」。病根:所有会话和执行体共用同一个账号的额度,会话都用最强型号,额度撑不住;会话命令起的会话里,只有出设计的两位架构师需要最强型号。决定:① 会话命令起会话时按这位的角色带型号 —— 名单里是两位架构师,起成 opus,其余起成 sonnet,「其余」是用户定的规则本身、不是兜底,推理档的常量 max 不动;② 起完核横幅里的型号家族(Opus / Sonnet),不是这位角色该用的就当失败:把刚起的会话停掉删掉、登记册不动,报文写明这位角色要哪个型号;③ 角色到型号的对照只写在架构详图 §十五「型号与推理档」一处,体系守护技能说明只指向它。谁定的:用户 10-25 的话 ——「X大脑和双架构师作为最高的架构设计者需要opus5.5MAX,其他所有的执行体都是sonnet5.5」「我们没有那么多的token啊」。升哪一位:整个框架升第二位 —— 设计内容变了,没有改写既有契约。守不到:平台收不收 --model sonnet、Sonnet 会话的横幅写成什么,床里只用假的 claude 命令,没有实测;第一次起 Sonnet 会话时要看一眼横幅,对不上时命令按设计把刚起的会话停掉删掉并点名原因,不会留下错型号的会话。
ADR-1162026-10-25新运作:除 X大脑 窗口外的会话都由系统用官方后台会话自己发起,用户在 agent view 里看;项目经理、运维经理、产品架构师、Harness架构师做成各管一摊的常驻会话,每个专项一位产品经理会话从立项到归档端到端负责(取代「工作会话」,管部署的叫运维经理,取代「部署会话」);会话一律 Opus 5.5 最高档、子代理一律 Sonnet 5.5;X大脑 即首席产品官,只谈需求、定事、弹签字题、统管各专项的产品经理,设计拆给两位架构师;新增复杂化审查官,宪法加「禁止复杂化」并写下取舍原则(取舍只问最佳最合适,规模与成本不作为理由;也是两位架构师做设计的第一条要求);五类架构里的「框架架构」改叫「Harness架构」;agent 栏目的图换成项目架构的样子;加代签设置:验收完结、验收后的发布授权和开发中途的联调授权可在用户设置允许的类别里由 X大脑 代用户点头(产品专项、Harness专项两个开关,现在都是代签),签字一、改设置只归用户,改设置不立项;开闸跟着签字一授权、到时机器放行,手动开闸只在急救时用。取代 ADR-102 里主控三样中的「出设计」和「项目经理是被派的执行体、没有自己的会话」两处,取代 ADR-75、ADR-78 里「两次签字都由用户本人签」和 ADR-99 里「一切线上写入都要用户单次授权」两处中「只能用户本人」的部分,补 ADR-101、ADR-105、ADR-90、ADR-61;补充并取代 ADR-111「范围 = 签字时的目录和单元加核准过的」中对受保护文件放行的读法(放行读得更窄:只认签字时的落点表算出的受保护格,核准加进来的格不放行,核准减掉的格也不再放行)。旧条目一个字不改为了:「新运作」。病根:每条新需求的工作会话都要用户亲手开窗口,用户不在就无法实施;主控一边谈需求一边出设计、记会话号、盯进度,上下文被挤占;没有专人管业务架构和 harness 架构,harness 瑕疵没有固定的回报通道;复杂化没有专人看守;五类架构里框架那一类的叫法没有说出它就是 harness 本身;各位的叫法和他们管的那一摊对不上;harness 的大部分东西用户无法自行验收,签字二只是形式,却最阻碍开发的连续。决定:① 会话命令九个子动作(含改名)放体系守护技能;送进会话的话只许是固定句(守卫不记它、不认它是签字),任何会话不经受信脚本直接跑 claude 都拦,会话登记册目录受守卫保护;② 会话登记册(和平台的会话名册是两回事)原子写、两处存、锁可过期,身份取会话号,主控由交互种类且名叫 X大脑 的会话登记;③ 四位常驻各管一摊,项目经理靠定时巡检保持在线,运维经理做常驻后台会话(实测证实 bypass 档能用云端工具);④ 命名「需求短名-类别-档」(类别三选一:产品、Harness、规范;档三选一:小事、成条、难事),角色不进名字;⑤ 架构师出设计,瑕疵走固定通道,常驻不是办理会话、受治文件由产品经理派人写;⑥ 复杂化审查官三个时点、四种判断,宪法只写定性;⑦ 改名只改五类架构这一类的叫法与管它的架构师;⑧ 十六张图全部重画成内联 SVG;⑨ 取舍理念写进宪法 §六 第 9 条、两位架构师定义的第一条要求和审查官的边界;⑩ 每个专项一位产品经理(新执行体 x-product-manager,只作会话用):立项在签字一之前、命令在自己会话里跑、从第一笔就是办理会话,收尾归档也归它;⑪ 「工作会话」「部署会话」两个叫法在这条需求落点里的现行文件中一处不剩;⑫ 会话型号与子代理型号分开定;⑬ 代签设置:两个开关按专项类别分(产品专项;Harness专项含规范),设置文件不归版本单元、工作区地图声明它受保护,改设置不立项(用户在 X大脑 窗口说四句固定话之一,或手改);每条计划签字一时定「验收谁签」,放宽要用户说、收紧走核准;代签命令核三样(登记的主控、设置允许、这条是代签),关口与用户亲签同一套,验收区先留证据,履历写明「X大脑 代签」;部署门和各条发布出口认代签记录,设置改回亲签就拦;这条需求落地前签了字一的计划验收照旧用户签;⑭ 开闸跟着签字走:落点表里落在受保护文件上的格由计划工具自动标出来,签字一就是开闸的授权(签字一只能用户本人签、从不代签);实施时守卫照常在岗,写一个受保护文件要同时满足四样才放行(办理会话 —— 只认签字时记下的会话、登记册里登记的这条需求的产品经理会话、主控或项目经理指名的改派;签过的受保护格且核准后现行落点表里还有;这条需求在办;不在永不放行名单里),范围只含脊柱与检测引擎承牙两类,写文件工具、命令行、换入帮手认同一份放行,完结、归档、签字作废自动收回;签后经核准加进来的格不放行受保护文件、要放行得先核准、再让用户重签(重签只有签字作废时才有,没作废就只能请用户手动开闸换入,补签放行没做),减格不用;永不放行名单(各本账、履历、锁清单、代签设置、会话登记册、项目设置等)永远不放;放行评估出错一律按不放行、不外抛;手动开闸留作急救;这条需求自己换守卫的那一批(批 2)还要用户最后手动开一次闸,并进整批换入的那一个窗口、关闸后做金丝雀,批 2 装上放行之后复盘后再改这几个受保护文件不用再开;⑮ 实测定下的写法:叫醒与恢复一律不带参数(带任何参数续上都会复制出同名副本);会话名必须唯一;改名靠停掉后不带参数续上、首句写「/rename 新名」,做成第九个子动作;--agent 起的会话严格守工具白名单;循环定时任务 7 天到期,巡检满 6 天前重建;运维经理常驻靠 bypass 档(项目设置里早已批准了云端工具服务,这条需求不改项目设置)。谁定的:用户 10-24 的话 ——「当前的所有新项目的会话都是我发起的,我不在项目就无法实施」「未来我不用开好多好多窗口」(会话由系统自己发起);「我的理念是“不考虑规模,我不考虑成本,我只关注是否最佳最合适的方案啊!我只是禁止复杂化”」(取舍原则);「因为harness的大部分东西,我是无法自行验收的,因为他太底层了,我的签字只是一个形式」「他太阻碍开发的连续性了」(代签);「只要在架构设计阶段设计了需要开闸,那我再签字的时候其实就代表我允许这次开闸,那到时机了,不需要我手工开闸,因为我已经授权了」(开闸跟着签字走);命名里的类别叫法、恢复命令由主控跑、守卫文件的报文与注释一并改、守卫动判法的七处、Harness专项含规范、联调归代签、设置缺了按亲签、四句固定话,是主控与办理这条需求的会话定的口径,本条照它写。升哪一位:整个框架改写既有契约(签字记录由一条路变成两条、开闸由手动改名停闸变成跟着签字走、运作方式整段、叫法)升第一位;同一条需求里 agent 架构升第一位(多位执行体的写域、经谁核、禁区变了,会话这一层的分法由「工作会话、部署会话」改成「常驻会话、产品经理会话」),项目架构升第一位(流水线的环节有加有减:加起产品经理会话、代签与实施中机器放行,减用户亲手开窗口与常规的开闸、关闸节点)。守不到(写进 agent 架构设计页与项目架构设计页的诚实边界):(a) 实测只在本机 Claude Code 2.1.310 上做过,官方升级后行为可能变,命令里留字段自检;agent view 是官方的预览功能,界面和字段可能变,X大脑 这种交互窗口不出现在 agent view 里,它头上写的「新会话默认 Sonnet 5.5 · low effort」是本机用户设置,发起时显式带型号和推理档,不受它影响;实测没测到或看不出的有:agent view 里卡住的会话显示成什么、循环任务真满 7 天到期的那一刻、权限档 auto 遇到没批准的云端工具服务会怎样、托管设置里有没有免确认开关、子代理的实际型号只有会话自述为证。(b) 固定句只防「机器话被认成用户的话」,防不了有人手打同一句固定句;定时触发的话(项目经理的巡检)进不进说话钩子没测过,真环境实测核。(c) 常驻会话不是任何需求的办理会话,只能写计划目录,落笔的受治文件由办理会话(产品经理)派执行体写,也不写任何需求的机器镜像。(d) X大脑 派出的执行体和它是同一个会话号:四条敏感命令按 agent_id 拦执行体,防得住执行体,防不住主控会话本身被冒用;运维经理只认发件名是 X大脑 的跨会话消息当授权或代签中转,发件名认得出叫 X大脑、认不出是不是主控本人。(e) 登记册被手改、会话号被冒用、主控登记被冒用,机器挡不全,镜像只能发现单边改动;代签命令认 X大脑 靠登记册,登记册的口子也是代签的口子。(f) X大脑 代验时判断得对不对机器判不了,证据留在看板验收区、用户随时抽查;用户本人授权的发布与联调机器照旧不核,机器核的只有带代授权标记这一条路,亲签关掉的是代授权这条路、不是门强制用户在场。(g) 用户用编辑器手改代签设置,账本里不留原话,只能靠设置文件里「最后改动」一栏对不上账本时提示一句,编辑器手改和脚本直写在文件上分不开。(h) 项目设置会热加载,急救时手动开闸是整关,那一刻全部在跑的会话同时失去守卫;能改守卫的人就能改放行的判定,办理会话往签过的文件里写了什么机器挡不住,靠标准、测试床、独立复盘把关;新守卫出错时恢复命令还跑不跑得了,实施时核,跑不了写进诚实边界和急救步骤。(i) 权限确认不能代答,后台会话一律免确认模式,守卫的钩子才是真正的闸,免确认开关要用户设置里开着;后台会话的环境以后台服务起来那一刻为准;在新目录或新克隆里起后台会话得先由人信任一次;项目经理与主控都不在时消息发不出去也不补发,靠看板状态栏兜底。(j) 真重启电脑的恢复没演,只演了停服务再拉回,用量上限把会话打断之后的拉回也没测过。(k) 两位架构师是不是真照逻辑链、数据链、功能链去想,复杂化审查官判得对不对,取舍原则有没有被偷偷拿成本当理由,机器都判不了,靠复盘和用户抽查。(l) 叫法清扫床只数现行文件里的旧叫法,判不了改过的句子通不通顺;落在别的单元里没改的旧叫法,在那些单元空出来之前读起来会和现行叫法不一致。机制在架构详图 §二(参与者与威胁模型)、§八(L4 写前拦截里的保护与放行)、§十五(角色表、签字机制与发布授权、取舍原则与复杂化审查官)、§十七(术语表),设计在 agent 架构设计页与项目架构设计页。恢复演练补洞(常驻四位起来做过一遍恢复演练之后补的,仍记在本条里):演练实测出三处,各补一层 —— ① 说话钩子分不出用户敲的字和定时任务触发时送进来的话(官方的钩子输入里没有来源字段,官方文档明写定时任务触发也走这个钩子;项目经理建的探针定时任务触发后被原样记成了用户原话),补上 (b) 里「进不进说话钩子没测过」那一句:说话只认主控(会话登记册读得出而且登记了主控之后,签字说法与用户亲口说的「重建登记册」「改代签设置」只认主控会话里说的,别的会话里出现这样的话不记进原话账本、不认作签字);环 1 拦定时任务(提示词里含签字说法或用户亲口说的固定话的一律拦,登记着的非主控会话只许建提示词整句恰好等于巡检固定句的,落盘的定时任务文件进写保护与永不放行名单);巡检句是固定句(项目经理的巡检提示词一字不改取自守卫常量,说话钩子遇到它与发起、叫醒、恢复同一待遇);没堵的是定时任务送进来的普通话在没登记的会话里仍被记成原话、定时任务文件被脚本直接写守卫看不见、说话只认主控以登记册读得出且登记了主控为前提;守卫因此多动三处,合前七处共十处。② 运维经理头一次开机时云端工具服务连接超时(30 秒)、会话里一个云端工具都没有,后台会话没人点 /mcp,stdio 方式的服务启动失败官方没有自动重试,补运维经理云端工具自愈三层:工具白名单补 mcp__cloudbase__auth、定义里写开工先核云端工具、会话命令在它被发起或叫醒或恢复之后读它自己的会话记录核连上没有(没连上停掉再不带参数叫醒一次,还不行报主控;靠定义与命令,不是硬控),发起命令的设置里带 MCP_TIMEOUT(90 秒),最后兜底是用户在 agent view 里发 /mcp reconnect cloudbase;读记录文件的格式官方没承诺,MCP_TIMEOUT 在后台会话里生不生效官方文档没写、/mcp reconnect 不点进会话能不能发官方文档写明而本机没实测。③ 补上 (j):恢复演过的是停掉后台会话再拉回(会话号全没变,答得出工具名,记得停之前的对话,不带参数续上之后仍能写主仓),真重启电脑的恢复仍没演过;发起命令另有两处小改:读横幅的等待放宽到 120 秒、握手内容开头直接写会话自己的短号。补正(对着守卫代码核出来的):上面 ① 里「没堵的」第一项写窄了,应读作定时任务送进来的普通话在主控与没登记的会话里仍被记成原话 —— 环 1 对主控和没登记的会话只拦含签字说法或固定话的提示词,普通话放行,只有登记着的非主控会话另受只许建巡检句的约束;影响有限:签不成字,只是往原话账本里灌机器话,复盘连着三次不过后「要用户发话」那一道按派复盘的会话号读原话账本,在登记着的会话(含产品经理)里解不开,在主控与没登记的会话里解得开。补正二(换入前的独立审查查出的):「登记册可用」全仓只能有一个标准 —— 守卫读登记册此前只读仓里那一份、不核用户目录里的镜像,会话命令却在两处对不上时拒绝,于是换电脑只拷了仓里那份登记册时,登记主控被拒、而「会话登记册:重建」那句又被说话钩子当成非主控窗口里说的丢掉,两头互相指、签字全锁;订成守卫的 registryOf 经会话命令的 readState 读,命令判不可用守卫也当没有登记主控,重建在任何窗口里说都记得上(会话命令模块装不上才退回宽松读)。补正三(本机重启实测六轮之后):运维经理删了重起三轮、停了叫醒三轮,每轮都连上了(16 到 49 秒),一轮没连上的都没有,所以 MCP_TIMEOUT 在后台会话里生不生效没测出来(要等某一次真出现没连上、原因里带 N 毫秒才分得出),「没连上就停掉再叫醒一次」那条路真环境里一次都没触发;/mcp reconnect 不点进会话能不能发仍没测;停了再叫醒会话号不变、会话之间消息的收件地址每次都换,给常驻发消息一律写名字。
ADR-1152026-10-24工作区地图在测试面机制里按段登记,有意改动清单带组号与档位,守卫这一步不读地图:引擎段数据文件(map-engine.jsonl)与读取模块、地板、匹配函数三件代码登记进「检测引擎」上游组并给这个组加挂引擎面,余段(map-rest.jsonl)不登记;会话台账的判据组指纹多登记同样四个文件、登记的文件缺了不抛;对拍台的有意改动清单每条带组号和档位(纯函数档、读盘档),快档回放只对账纯函数档的条目,全量证明对账全部条目;守卫(含它懒加载的引擎常量和版本契约)本步原样不动,由名册钉住床与脱钩床守着。补充 ADR-64(运行器上游收窄)与第 0 步立的对拍台的读法,旧条目一个字不改。宪法不改为了:「地图立起来」(工作区地基第 1 步)。病根:新文件落在守卫目录下,现行规则自动把它们记成守卫面的被测文件,但引擎、规范、技能三族约 300 张床依赖了它却不会作废;全挂的代价是以后每次改地图哪怕只改守卫才读的属性都作废约 330 张床;而守卫的加载路径(terminals.js、test-roots.js 加载时就 require,版本契约在签字、收尾、归档时懒加载)一旦读地图,地图读坏会把所有会话的工具调用一起拦死。第 0 步立的有意改动清单没有「组」与「档」,快档(只问纯函数)和全量证明(要读盘的也问)两种回放没法分开对账。决定:① 测试面机制只能整个文件挂上游(区段只有运行器那一对固定标记,JSON 没有注释),所以地图分两个数据文件:引擎段(词表、名册、区树骨架、引擎要读的属性存在与检测)登记进 UPSTREAM.engine.files,余段不登记;读取模块、地板、匹配函数三件代码同样登记;UPSTREAM.engine.families 多挂 engine,引擎面的新床因此不用逐张写 @covers(对拍台目录下的床用到 zz-tools、zz-fixtures 这类不算夹具的目录,照旧用 @covers 点名;map-equivalence.test.js 要核余段,另点名 map-rest.jsonl)。咬合床逐族断言:改余段,引擎、规范、技能三族的记录不作废(除上面那一张);改引擎段或三件代码,三族作废;守卫族因为地基目录本来就在它的被测范围里,两种改动都作废。② 会话台账 detectPrint 多登记同样四个文件(DETECT_FILES),文件缺了不抛、把「缺」记进指纹,免得缺地基目录的沙箱或换进去那一刻每个事件都装的台账零件坏掉。③ 有意改动清单头登记组号表(每组条数、档位、说明),每条带组号、档位(pure 或 state,与适配器自己的档、与组的档都相同)、why 以组号开头;快档回放只对账 pure 档的条目,全量证明对账全部;没归组、条数与签字一不符、档位放错、多登记了没发生的差异一律红。规矩:组由用户在签字一点头;签字之后新发现的差异先报主控,同因同类的由主控核准、验收时逐笔列给用户,不同类的要重签。④ 守卫本步不读地图:terminals.js、test-roots.js、rule-books.js、version-contract.js、defaults.js 原样不动,名册钉住床核它们与地图里的名册逐项一致;脱钩床在缺地基目录的小沙箱里装守卫的各个零件并真调一次 detectPrint,断言装得上、不抛、拦与放的结论不变;第 3a 步守卫有抢修态、改成惰性加载之后再迁。否决过:整个地基目录挂引擎、规范、技能三族(一行搞定,代价是以后每次改地图作废约 330 张床);「摘要挂载」(读取模块给每个视图算摘要进床指纹,最准,但测试面机制要能执行读取模块,现在没有,留到读地图的读者多了再议);把有意改动清单做成快档与全量各一份(两份清单必然漂移)。与既有决策的关系:补充 ADR-64、ADR-67 里讲上游组与干净结论随上游作废的读法,旧条目一个字不改。升哪一位:整个框架新增一类东西(地基目录、测试面按段登记)升第二位。守不到:咬合床证明的是「小固件仓里改了哪个文件、哪几族的床指纹变不变」,不证明引擎实际读到的地图文件恰好是登记的那四个 —— 另有一条用文件读取记录器跑引擎索引与遍历、断言读到的地图文件不超出登记范围的对拍,但读取记录器只在被测的那一次运行里有效;余段属性被引擎段的视图间接依赖时(引擎段目前不引用余段)会漏作废,设计上引擎段不许引用余段,why.js --check 核属性归段。机制在架构详图 §十六、§十八。
ADR-1142026-10-24检测引擎只在索引与目录遍历两处读工作区地图,按用到才读,两处共用一个跳过判断,合并只许多跳不许少跳;引擎里的三张跳过名册、端名册、测试根、规则书名册和版本契约这一步一个字不动;判据拿地图只经一个注入键 workspaceMap(只读取数口、只看引擎段、进程级只建一次);射程缓存键多算地图这一样;地图自己的匹配函数先影子运行、引擎现行匹配器不换。补充 ADR-110 与 ADR-112 ⑨ 里「索引与目录遍历两种视图分叉」的现状,旧条目一个字不改为了:「地图立起来」。病根:索引与检测器自己走目录树对同一个目录结论不同(点开头目录、测试根里的东西遍历看得见、索引看不见);跳过规则散在 indexer.js 的四条判断和 file.js 的七八处遍历里;defaults.js 被 constants/index.js 整体展开、logger 也 require,每个引擎进程、工作线程和封版链都会被拉进地图依赖,地图读坏就连只加载常量的进程一起坏。决定:① 新增 scanners/walk-skip.js,skipper() 造出一次遍历用的跳过函数 (rel, name) → boolean:目录名册、点开头(.claude 除外)、测试根、路径前缀表四条与迁移前索引的写法逐字相同,再加第五条 —— 地图里目录所在的区「检测」是「不扫」就不进;第五条只问扫描根(顶层物加 .claude)之下的目录,扫描根之外索引从不进、地图的答案没有意义,遍历从仓根往下走也不因此多跳;地图没声明的路径(无区)答「无区」,不跳也不抛;地图按用到才读(skipper() 造出来时不读,第一次走到第五条才装载),读不到抛 WorkspaceMapError 点名文件与行号,要建索引的检测随之被拦(含收尾与部署门起的 check.js 和覆盖闸)—— 这是预期的「读不到就拦」。② indexer.js 的目录判断改调它(名册、点开头两条原样保留在原处,测试根与路径前缀两条搬进共用判断,行为不变);file.js 的 scanDirectory、按标识文件找目录的两个 walker(普通与四件套模式)、无索引回退各在原有条件之上再问它(四件套探测函数 hasMiniprogramPageQuartet 只在一个进不去的分支里被调,是死代码,本步不动),「项目自带」加的 ignoredByPath 点全部保留;合并只多跳:遍历从此不再看见点开头目录与测试根里的东西。③ defaults.js、terminals.js、test-roots.js、rule-books.js、version-contract.js 一个字不动、导出名与形状值与改前逐项相同,缺地基目录时 require 它们与 constants/index.js 照常通过;名册钉住床核它们与地图里对应名册逐项一致。④ 判据注入键 workspaceMap:只露 zoneOf、attrOf、roster、why 四个只读取数口,只看引擎段(问余段属性抛错);读取模块装不上(沙箱缺地基目录)时造 tools 不抛、给一个四个口全抛的占位,用到才抛;缺注入(手搭 tools)由判据自己抛;本步不新增任何判据去读它,手搭 tools 的床逐个列清单。⑤ 射程缓存键多算第五样:地图引擎段与读取模块、地板、匹配函数三件代码的原样字节,余段不进键。⑥ 地图的匹配函数 glob.js 以引擎现行 matchFilePattern 的五步为基线、自写不依赖 minimatch,本步只服务地图;差分床拿 matchFilePattern 逐位对拍(仓里在用的模式、对拍台的 33 个写法、固定种子的随机写法),不认得的写法(取反、字符集等)当场抛错。⑦ 引擎整树被拷进沙箱的床(覆盖床扫出 15 处:11 处各补一行带地基目录,4 处刻意不带)逐处登记,覆盖床现场重扫核对;被单文件抄走的引擎文件加载时不依赖地基目录。否决过:引擎常量全部改成由地图算出(守卫、logger、封版链加载时就读地图,地图读坏连只加载常量的进程一起坏);两种视图各留一套(继续分叉);让引擎在加载时读地图(同上);用环境变量让引擎读别处的地图(读一份宽松的地图等于绕过地板外的一切);本步就把引擎现行匹配器换成 glob.js(会改变 -m 的射程,约 246 张规范床靠它驱动,风险高,换的那一步另定);地图的区路径写成「任意深度叫这个名字的目录」(设计稿 M1 的病根,名字一刀切)。与既有决策的关系:补充 ADR-110(路径级忽略表)与 ADR-112 ⑨(遍历也读这张表)里讲两种视图分叉的现状 —— 现在连目录名册、点开头、测试根也收成一种,旧条目一个字不改。升哪一位:整个框架新增一类东西升第二位。守不到:遍历收成一种视图后不再看见点开头目录与测试根这一类变化不在对拍台回放里,靠全量检测前后对比(只比此刻的盘)兜;沙箱床刻意拷不全引擎时要自己补带地基目录,覆盖床核的是「带了」,核不到「该不该带」;引擎侧读不到地图即拦,而守卫本步不读地图,所以地图读坏时检测被拦、工具调用不被拦,抢修态留第 3a 步。机制在架构详图 §七「路径级忽略」、§十八。
ADR-1132026-10-24工作区地图:全仓「这个路径是什么、归谁、能不能动、算不算」只写一份,住新目录 .claude/hooks/workspace/(地基目录)—— 两个数据文件(引擎段 map-engine.jsonl、余段 map-rest.jsonl,JSON、一条记录一行、t 字段在前、末行带条数的结束记录、出处就是行号)、读取模块(只用 Node 自带模块、按自己位置找数据、读不到就拦并点名文件与行号、绝不退回旧值)、写在代码里只许加严的地板(有棘轮床)、地图自己用的匹配函数、一条问为什么的命令、指纹口径的骨架;第 1 步把地图数据定成与今天的口径一致(对金标准逐路径一致,唯一有意改动 D3:.claude/bak 下 20 个文件不再进检测引擎的索引),其余已定的有意改动留给读它的那一步。宪法不改,仓根 CLAUDE.md 指针表多一行指向地图为了:「地图立起来」(工作区地基第 1 步,难事)。病根:「这个路径是什么」没有主人 —— 精确普查数出按路径判断的地方共 809 处(检测引擎 162、守卫 167、技能脚本 242、材料侧与站点 238),散落的小名单 164 条,同一个目录在不同读者那里结论不一,改一条规矩漏一处就静默分叉;设计稿第六节把它定为分十五步的长路,第 1 步是引擎这一侧。决定:① 格式:JSON、一条记录一行,行号天然是出处,一行坏了只点名那一行,半截写入只会坏最后一行、重读一次就好;只用 JSON.parse,不自写带位置的分词器;对拍台的独立求值器改一层读法就能接着用,作为读取模块的第二份独立实现做差分对照;分两个文件是因为测试面机制只能整个文件挂上游(ADR-115)。② 数据模型:区的树(每个路径落在最深的那个声明过的区,子区继承、写了就覆盖,区路径一律按整块算)、闭集词表(每个取值要么有区在用、要么登记成「预留」并写明哪一步第一次用它)、名册(带指向引擎旧名单的 legacy 字段)、对象认法、视图(对属性的选择式)、路径规则(按路径里某一段的名字叠加属性,为了与今天的答案逐路径一致而原样搬来)。③ 读不到就拦:文件缺、空、有一行不是 JSON、读到半截(先重读一次)、未知键、取值不在闭集、越过地板、被改宽,各抛一次错并点名文件与行号。④ 地板:今天的脊柱、引擎承牙、受治根、必跳名、地基目录自身,写在代码里的冻结集合,不依赖地图里的任何文件;地图只能在地板之上加严;只许加、不许减,退役一项必须走一条框架需求并在签字一里单列请用户点头;对拍台金标准里今天的答案是棘轮床的样本。⑤ 决定「Y」:地图数据是「今天的口径」而不是设计稿的终局 —— 设计稿定的八处与今天不同的地方(D1 build、worktrees 改按路径;D4 docs/ 与 .claude/bak 加会话不许直接写;D5 .claude/docs 整个归框架受治;D6 x-temp 两份 .gitignore 不再受治;D7 保护判法改成从根按前缀算;D8 x-vpn、x-proxy 量仓时跳过;D9 业务端目录里 140 个非代码文件;M8 判决依据收成一个属性)只在读它的那一步才会出现,写进第二张表列给用户点头;本步地图对每个有金标准适配器的属性与金标准逐路径一致,唯一例外是 D3(索引读它,本步就生效,检测结论零变化,因为本来就没有规范管 .claude/bak)。⑥ 完整性闸:每个入库路径、每个盘上路径都必须落进一个声明过的非兜底的区;私人区、嵌套仓、施工区按整块声明;35 个灰区逐一归区。否决过:单文件加排版好看的 JSON 加自写带位置的分词器(多约 100 行读取代码,地图本来不是给人读的);自创行式文本(要自己写解析器,没有现成工具);把守卫也改读地图(地图读坏会把所有会话的工具调用一起拦死,ADR-115);终局口径一步到位(八处有意改动要读它的那一步才有读者去核对,没有读者的值无法验证);任意深度叫这个名字的目录这种一刀切写法(设计稿 M1 的病根)。与既有决策的关系:补充 ADR-111(签字只锁五样)里「设计范围」的读法 —— 地图本身不是设计范围,改地图属改框架;旧条目一个字不改。升哪一位:整个框架新增一类东西升第二位(v6.2.0)。守不到:地图与金标准在 8004 条真路径上逐路径一致,怪路径(大小写、反斜杠、.. 折叠、盘符写法)由守卫那一侧自己归一,第 3a 步守卫改读地图时要在读的一端按守卫的写法先归一;属性写对没写对机器只能对有金标准适配器的那些核,其余靠独立复盘抽查;完整性闸看得出「没落进任何区」和「歧义」,看不出「落进了错的区」;保护的判法本步仍是「路径里含这一段就算」,地板里只有从仓根起算的锚定写法。机制在架构详图 §十八,设计在主控线设计目录的设计稿与第 1 步笔记。
ADR-1122026-10-23项目自带:办一条需求用到的东西都放在项目文件夹里,换电脑时把整个项目文件夹拷过去就能接着干 —— 每条需求在项目里有自己的施工区文件夹 x-test/zz-work/<需求名>/,副本、备份、探针放这里,守卫隔开别的需求的会话,清理归档整份删;登记的单位由「逐个仓外目录」换成这一个文件夹;Claude 的记忆文件搬进项目;换电脑清单写进项目架构设计页。补充并取代 ADR-97 里「仓外临时目录由守卫自动登记、搬之前逐行核登记文件」的读法(现行:施工区整份删,老计划留下的登记文件照旧逐行核),旧条目一个字不改。宪法 §六.8 不改,§六.5 只改一句待办去向为了:「项目自带」。病根:用户 10-21 三次说:「所以逻辑上我们应该按照项目的维度啊!每次项目实施的时候,就再x-test里面构建自己的项目目录,然后只能再自己的项目目录里面构建本次项目所有的临时文件和测试文件」「我不期望项目里面的东西导出再项目外面放来放去,万一未来换电脑了,目录会导致不存在而报错,懂我啥意思嘛?你再梳理下看下什么东西还放在项目外的,都梳理一下」。此前一条需求的副本、备份、探针散在系统临时目录里,靠守卫自动登记、清理归档逐行核;Claude 的记忆文件放在用户目录里,换电脑就丢;换电脑要做什么只在脑子里。决定:① 原则:办一条需求用到的东西都放在项目文件夹里;必须留在项目外的只有三类,换电脑清单里逐类写理由 —— Claude Code 平台自己的目录(会话记录、会话临时目录、用户级设置、信任与授权),本机装的工具与账号登录态,只活一次运行的东西(测试假仓、运行器的锁与输出放系统临时目录,云函数上传包永远在项目外:云开发的打包器按忽略清单剥掉 sys/,放在项目里发上去的就是缺了内核的包)。测试假仓搬进项目留给后面的「测试用工作树」。② 单位是施工区:x-test/zz-work/<需求名>/,需求名就是计划的目录名;放在 x-test 下是因为忽略清单里 x-test/zz* 那一行早就盖住它、测试根里以 zz 打头的目录不当床,不新增忽略规则。③ 守卫隔开别的会话,隔离是有边界的:往施工区里写(编辑工具,和命令行里认得出落点的全部写)、跑里面的脚本,只放这条需求的办理会话;别的需求的办理会话、没签字的会话、施工区根与根下散文件一律拦,报文三句(归谁、你是谁、怎么办)。死区只许删、不许写:需求已完结、计划已归档、计划已不在、还没签字的施工区,删除类动词谁都放,包括没签字的会话 —— 要清它不该需要一条在办的需求;账本被改过的需求的区既不算死区也不让删,先查清。换入前的预审后加严几处:区名那一段带展开写法(通配、方括号、花括号、反斜杠转义、变量)一律拦 —— 死区谁都能删,字面是死区的路径一展开就成了别人的活区;没签字的会话删死区的免检只给磁盘上真有、路径干净、一路没有联接的路径;删除类命令穿过联接(含联接后面写尾斜杠)对办理会话也拦,因为 Git Bash 的 rm -rf 联接/ 会跟进去删它指向的真目录;cd / pushd 进别人的区再跑相对路径的脚本按当前目录算落点;install -d 的单个操作数也进写清单。④ 写保护的五个谓词对施工区答「不保护」,施工区也不受治、不记写证据:副本里得改得动守卫、引擎、执行体定义才叫副本,换进真仓那一步由换入帮手与写前拦截把关(目标是受保护文件而闸没开就拒绝,开闸仍是用户的动作)。⑤ 清理归档整份删,不跟着联接走;盘点多列停滞区、只列不删;老计划留下的登记文件(含归档里的)照旧读、照旧清,不并存两套规矩的意思是新计划不再产生它;守卫写后记账不再登记,落在系统临时目录里的副本只回一句提醒。系统临时目录里我们自己程序留下的老残留不做常驻扫描代码,验收前一次性手工清。⑥ 造副本只经体系守护的动作:决定带什么不带什么(本机才有、带明文密钥的 .env 一族、.mcp.json、.npmrc、各层 .claude/settings.local.json 按文件名不带,要用由办理会话显式放进去),副本根默认放一个空的 .git 文件当标记(实验:副本在仓内不放标记,git 顺着往上找到真仓;空 .git 目录挡不住;空 .git 文件让 git 一律以退出码 128 报错、绝不往上找,与副本在仓外时相同;环境变量法漏设就静默读真仓,不选);要在副本里跑整套回归的加 --git,改建沙箱版本库(git init、提交一次基线、alternates 指回真仓的对象库,仍不往上找)—— 标记副本里任何 git 命令都退出码 128,唯一运行器的卫生检查与对拍台按提交读源码都要真 git,换入前的预审才抓到(带筛选的床里看不出);换入帮手的备份目录可以放在目标根的施工区里(不能放在来源根里面,也不能放在目标根里施工区之外),复制之后被别人删掉的目标也算漂移而拒绝(否则会被原样复活),换入中途出错时把恢复命令一并打出来;平台读副本里的文件会把嵌套的 CLAUDE.md 与 rules 当指令加载,项目设置里的 claudeMdExcludes 排除(实测管用),副本里的自研技能说明排除不了,接受。⑦ 记忆搬进项目:自动记忆目录改到项目里主控线的目录下,文件入库;设法是 autoMemoryDirectory 写在本机的项目本地设置里(不入库、绝对路径),不做目录联接。⑧ 顺手订正:核准命令的指纹开关由 --print 改叫 --fp(守卫查 node 求值开关时连脚本后面的参数一起看,--print 会被当成求值拦下;守卫的安全墙不放宽);几处与实际对不上的文字同批订正。⑨ 检测引擎的遍历也读路径级忽略表:IGNORED_PATH_PREFIXES 加 x-test/zz-work,scanners/file.js 自己走目录树的几个遍历函数新加 ignoredByPath 读同一张表(不另建第二张名单);名单里原有的 .claude/tmp 因此对遍历也生效 —— 这改变了 ADR-110 里「检测器自己走目录树时仍看得见 .claude/tmp、两种视图分叉」那条诚实边界的现状(分叉没有了;没有规范的射程落在 .claude/tmp 下,对拍台回放零差异,对任何规范的检测结论没有影响),旧条目一个字不改。否决过:对施工区的写保护谓词也答「保护」(副本里就改不了守卫,副本没有意义);把施工区列进落点表一格(备份与副本本来就不该占一格,x-test 开头的目录还会被认成业务流程、与 Harness 混在一起);副本里用环境变量让 git 读副本(漏设一次就静默读真仓);造副本一律建沙箱版本库(要多花一次整仓的 add 与提交,只跑带筛选的床用不上,所以要整套回归的才加 --git);做常驻的系统临时目录残留扫描(随机后缀的目录名里没有进程号,认不准会误删别人的东西);整个排除副本里的 SKILL.md(副本里的床要核说明与脚本)。与既有决策的关系:补充并取代 ADR-97 里「登记到会话草稿目录下的第一层」「搬之前逐行核登记文件」两处的读法;ADR-95、ADR-98 里讲「各会话在仓库外面的临时副本」的动机照旧,旧条目一个字不改;ADR-110 里 .claude/tmp 遍历看得见那条诚实边界的现状见上 ⑨。升哪一位:整个框架新增一类东西(施工区、造副本与换入两个动作)升第二位;项目架构设计页新增一节内容升第二位;agent 架构只订正执行体文件与设计页里的几句,升第三位。守不到:隔离只拦编辑工具和命令行里认得出落点的写,脚本进程里自己写的东西、带变量通配的落点、经联接或硬链接绕出去的写、云端工具往本地落盘的写拦不住;BOSS 手动 git clean -xdf 会清空全部施工区(含换入前的备份);要留的记录与施工材料分没分开机器不核;记忆目录的设置对已开着的会话不保证生效,搬完要请开着的会话重开;计划目录下的文件命令行删不了,作废的记忆只能改写成作废说明并从索引里拿掉;NT 前缀与 UNC 管理共享写法折不回仓根相对路径(受治业务文件的需求闸本来就有这个洞);写命令全集之外的命令(find -exec rm、xargs rm、shred -u、split、tar -C、curl -o、git clone、Windows 的 copy / move / xcopy / robocopy / rd / attrib 等)拦不住;cd 带变量、pushd +N、popd 之后当前目录算不出,相对路径的脚本只能照字面判;写类命令经联接写进真目录拦不住(只拦删除类);标记副本跑不了整套回归,要整套的加 --git;沙箱版本库只往自己的对象库里写(床里钉着:沙箱里提交、打标签之后真仓的 .git 一个字节没变,沙箱里没配远端、推不出去,拿掉 alternates 沙箱自己的历史与对象照样齐全),但真仓哪天 gc --prune 清掉不再被引用的提交(比如改写历史之后),还活着的沙箱借读那些提交就报缺对象(沙箱自己的基线对象是它自己写的,不受影响),所以沙箱只活一条需求、用完随施工区整份删。机制在架构详图 §八「项目自带」「清理归档硬控」,设计在项目架构设计页第十节「施工区放哪」「换电脑清单」。
ADR-1112026-10-21签字只锁五样:需求那一句话、要用户亲手验的清单、三个自报(动钱、动权限与身份、改已发布表字段类型或删功能)、流程、档;其余细化 —— 标准的措辞与条数、自动用例的一切、亲手验用例的「在哪看、怎么验」、同一流程之内加或换的版本单元、落点表里的目录与格 —— 签字之后改了不让签字作废,叫「待核准」,由用户最近一笔签字所在的会话(主控)核准,机器记账、验收时逐条(旧到新)列给用户;「落点表」指签字时的目录加核准过的目录,「设计范围」在签字那一刻由用户确认。补充并取代 ADR-74、ADR-83、ADR-85、ADR-98、ADR-106 里讲「签字锁住整份计划(含落点表里每个目录),目录一改签字作废」或写死判决依据条数的读法;五条原文一个字不改,读它们时按本条的定义读。宪法 §六.8 不改为了:「少重签」。病根:用户 10-20 说「各种重签,如果都没有什么变化,或者一些小改动,却没有改需求,可以不需要反复重签」;10-21 说「我签字的是需求啊……只要总体需求不变,过程的东西就由你来签啊」「我的理解应该是我之前需求和验收,中间应该尽可能少的让我反复重签,特别是没有需求的情况下」,并在弹窗里选了「只锁五样(推荐)」。此前签字锁住整份计划,目录、措辞、用例、单元一改就作废,用户为同一件事反复签字。决定:① 签过字的内容就是五样:需求那一句话;要用户亲手验的清单(哪几条、每条验什么、条数);动钱、动权限与身份、改已发布字段类型或删功能三个自报;档;流程(业务、Harness、规范认成哪条,机器从落点表算)。内容编号盖前四样;流程不进编号,签字那一笔记下,之后每次判断逐次和此刻从落点表算出的比,不一样签字当场作废,算不出来点名「判不了」、不作废。② 其余过程签字之后改了不作废,由最近一笔确认所在的会话核准,机器记一笔(核准者、时刻、改了什么旧到新、新增覆盖多少个受治文件、判资格用的事实),验收时逐条列旧到新;核准不是代签,签字仍只有用户本人签两次。③ 核准者必须是最近一笔确认所在的会话,不是当时的办理会话(含改派接手的),不是自最近一笔确认或核准以来写过这份机器镜像的任何会话,机器镜像此刻的内容还要查得到写证据;判资格的事实记进事件,读的一端按它重算,事后改派或碰机器镜像不追溯作废以前合规的核准。④ 每笔核准机器重判,碰到五样中任何一样就拒绝并按类写出路,另有四道拦悄悄改松(需求没有标准对着、用例的标准不存在、自动用例或点名的测试变少要显式带开关、加业务域单元要显式带单元名,后两类清单置顶标红、独立复盘必须作答);流程变了(认成另一条、混成一条)由逐次比对当场判签字作废、不靠标记,核准命令碰到已作废的计划直接拒,要用户重签(混成一条的先拆开);核准时要请用户重签的只有两类 —— 风险标记新增、档的下限升高 —— 加上没有核准路的需求,带执行开关时账本另写一笔「需重签」标记(只绑待核准清单、只对它前面那一笔确认有效,重签之后自动作废),签字随即作废;单元不认得、条数超了档的上限不写标记。⑤ 范围 = 签字时的目录和单元加核准过的:放行类读窄(顶层围栏、联调放行的放行面与放行的单元、写后提醒、收尾对账、封版认领、封版命令把「为了」解析到需求、三查的第一查和第三查、签字作废与计划已搬走的需求的范围),拦人类读宽(同一块排队、判定代码占着、正式发布门),车道判断读此刻整张落点表;核准记录与待核准清单并入三查结果单编号,核准一笔复盘作废;独立复盘必查核准过的标准与用例的改动;验收清单最后多一个必勾项「签字之后的过程改动我看过、认可」,不勾就是不过;确认区只改两处(「需求」「范围」两组里的话,和标记引起的重签的横幅只写一句原因)。⑥ 「设计范围」在签字那一刻由用户确认,之后单元之内、流程之内的细化由主控核准并在验收时列明;架构详图里「设计范围」的定义同批改成「签字时确认的版本单元与流程,加之后核准过的目录」。⑦ 没有核准路的需求(办理会话就是签字会话,或签字会话自己写过机器镜像、写者查不到)待核准的过程改动当作实质,签字作废,重签时一并带进新的签字。⑧ 老签字按留的底比(只比底里有的项),没留底的一律重签。⑨ 核准命令算在判决依据的「三查」这一样里(不多出一样),进脊柱写保护名单与判决依据名单;宪法不改。否决过:把落点表整个从签字锁里拿掉、不要核准(范围悄悄变大);让办理会话自己核准自己的改动;把办理过的会话记成永久名单(主控碰一下机器镜像就永远进了名单);核准者只排除最后一个写过机器镜像的会话(主控改一处、办理会话再改一个字,最后的写者成了办理会话);给内容编号加一个键让所有在办需求整批重签;流程变了也写「需重签」标记(流程变了逐次比对当场就作废,标记只会多一层状态);重签界面只列改动、折起没变的(这一版不做,记在欠下的)。与既有决策的关系:补充并取代 ADR-74(签字锁住整份计划的读法)、ADR-83(签字门核落点单元与「设计范围」的读法)、ADR-85(签字一那一笔把编号盖住的内容整份留底、重签逐条比对的读法)、ADR-98(确认题与验收单编号的读法)、ADR-106(「判决依据只指五样」「签字锁住的目录」的读法)里讲签字锁住整份计划或写死判决依据条数的部分,旧条目一个字不改。不改两个裁判判什么,不改宪法 §六.8 那一句「签过字的内容一改,签字作废」—— 变的只是「签过字的内容」指哪几样。升哪一位:整个框架改写既有契约(签字锁什么)升第一位;项目架构设计页是某一道关口(阶段一的签字)的射程变化、升第二位。守不到:机器认不出核准者是不是主控本人,只核三件事;办理会话就是签字会话、或签字会话自己写过机器镜像的需求没有核准路,待核准的改动当作实质、要用户重签;「需重签」标记只在有人跑核准命令时才落下,没人跑的话待核准让验收前的三查报红,不会悄悄放过;办理会话在自己的进程里冒用签字会话的会话号去调记账口,读的一端看不出;写证据只在机器镜像此刻的内容查不到时才认得出脚本、拷贝、编辑器写的,夹在两笔有证据的写中间的认不出;新增的目录有多宽只列文件数、不判;还没建出来的目录机器认不出归哪个单元;老签字的底里没有每条用例对着哪条标准、也没有落点表按格的行,这两样守不到;签字会话没了之后没有核准路,靠改一处锁住的内容逼出重签,机器不会自己发现;等用户重签期间别动待核准清单,动了的话「需重签」标记会静默失效(标记绑的是清单);标准与用例的措辞放松了是不是把需求改松,机器判不了,靠独立复盘的必查项和验收时逐条看,机器只列旧到新并拦三道悄悄改松。机制在架构详图 §八「需求对账」里的「签字只锁五样、过程由主控核准」一段,设计在项目架构设计页阶段一、阶段四与第八节「诚实边界」。
ADR-1102026-10-20测试床分道并发:缺省照旧一张接一张;开 --jobs 才起并发池,这一轮全部床带写追踪;只有在带追踪的独占跑里证明不写真仓的床能进池(结论绑床文件与夹具,不绑被测物);池里谁越界,污染窗口里的床红绿都不算、独占重跑;池里红绝不改绿;发布前测试照旧一张接一张。同一条里:选床认法以带上游的反查为准;增量检测提前起 oxlint、射程跳过 .claude/tmp;测试闭环体检去重;复盘者型号检查只放行 Sonnet 5.5 的两种写法为了:「检测提速·并发」。病根:运行器整仓一把锁、逐张串行,别的会话跑床都排在后面。实测整仓全量一遍:机器安静时串行 51.4 分钟(演练副本,3086.6 秒);开 4 路并发后同等负载的对照是 41.9 分钟(2511.3 秒),每轮全量省约 9.6 分钟(18.6%);真仓上第一轮(全独占带追踪,等于一遍带追踪的串行)36.4 分钟,第二轮 27.1 分钟(短 25.6%)。签字稿写的「全量约 40 分钟、并发每 9 天省 92–96 分钟」是按 188 次跑床记录逐次模拟的乐观值,不是实测,实测的单次提速比它小得多,不当承诺(提速被独占道卡住上限:真仓第二轮 1626 秒里 1321 秒、81% 在独占道,演练副本第二轮 2511 秒里 1847 秒、74% 在独占道,两个数各出自各自的口径)。可床里有一批会动真仓(种探针、改业务目录、写被忽略目录),直接并发会互相污染,红绿就不可信。决定:① --jobs 缺省 1,一字不变(不起池、不注入追踪);开发期三处带 4 到 6(接力跑床、开发流 VERIFY、命令行全量),发布前测试不带。② 准入:默认全部独占;在带追踪的独占跑里干净的床,结论绑床文件与夹具,进池。干净 = 有载入行、没写真仓(只豁免射程缓存与 beds-last)、没起碰真仓的非 node 子进程、worker 都被注入;床头不许自报豁免。③ 写追踪是 bite/ 下的预加载文件:枚举 fs 全部导出,没归类的算写;每床一个令牌传给子孙;逐笔同步追加,走启动时存下的低层原函数(不用会回头调导出对象的 appendFileSync,否则被后载入的围栏拦下,真仓第一轮演出来的),任何情况下不往床的标准输出和标准错误写字,日志写不进就补 logfail、补不上就删日志,运行器判脏;盯运行器进程号。④ 第二道:快照是 git status -uall 的路径加内容哈希,加追踪册派生的被忽略目录清单;先用会话台账的写证据排除别的会话的编辑。⑤ 越界:污染窗口从第一次越界写起、到还原或轮末,窗口里的床红绿都不算、独占重跑,越界的那张登记独占并点名;分不出谁写的,整池作废一次、余下改串行,不无限重试。⑥ 池里红:独占复跑归因,账上仍记红;池里红而独占绿的登记独占,下一次跑才变绿。⑦ 选床认法以带上游的「文件 → 面」反查为准:对拍床核每个面的被测范围,跑出的不一致默认补反查(只多选、不漏选),证明床不读才收窄被测范围,零不一致才过。⑧ 增量检测提前起 oxlint;射程与射程缓存按路径跳过 .claude/tmp,检测器自己走目录树仍看得见,两种视图分叉写进诚实边界。⑨ 测试闭环体检用只给它用的批量函数(faceStatusBatch,新增),为批量没改闸用的函数(faceStatusRaw、bedState、judge、testPrintRaw)里的任何一处,三处抛错语义照旧;这几个函数里只有一处因运行器那条要求而改:重面阈值求和改用 recMs 取数(faceStatusRaw 与 judgeRaw 各一行,并发池里的床按独占用时判),与体检无关;它们共用的 fileHash 另变成薄包装,多了一个只在体检批量期间才生效的模块内私有记忆(auditMemo,平时为空,为空时直接走原来的逻辑,结果不变)。⑩ 复盘者型号检查只放行 sonnet 与 claude-sonnet-5-5,与 x-agent 型号白名单同口径,haiku 与旧版照旧拦;用户 10-20 在弹窗里选过「删掉」,预审指出整删会在关掉强制开关时放过 haiku、并让 agent 架构设计页一句失真,改为收窄,签字时用户点头。否决过:函数床合批(部署门入口自己也记账,合批红、回退绿会把红洗成绿);追踪结论绑被测物(被测物一改就回独占,收益吃不到);只靠 git 快照(看不见被忽略目录与已脏文件的原地改);只按时间重叠作废(越界床崩了留下的残留会污染之后不重叠的床);规范级线程池(报文重放、全局输出、小批反慢);收尾检测子进程并发(每轮只剩零点几秒可省,还会和跑床并发抢核);整删型号检查(理由见 ⑩)。与既有决策的关系:不改两个裁判判什么,不改空壳对照(ADR-67)与发布前测试的口径;运行器上游补整个 bite/,bite.js、bite-stub.js 改了从此也作废旧记录。升哪一位:第二位(新增并发池与写追踪这一类东西,不改写既有契约,也不是纯订正)。守不到:非 node 子进程,追踪只按工作目录与参数判,真写了什么看不见:工作目录落在仓里、或参数里有仓根路径的算脏;工作目录在仓外、参数里又没有仓根路径,却用相对路径往仓里写的,追踪看不见,交第二道快照;追踪看不见的写若落在被忽略目录里、又从没被追踪册记过,第二道也看不见,两道都比不出来(用例演出来,写进诚实边界);池里两张床经网络端口或系统临时目录里的固定名互相干扰,只做过抽查;体检是时点快照,不是闸。机制在架构详图 §十六「跑床分道并发」一节(选床对拍与体检去重在同章,引擎少等在 §七「路径级忽略」与 §八 环3,型号检查在 §八 环1「派执行体通道」)。
ADR-1092026-10-16项目架构的六道门改用阶段命名:一条需求依次走六个阶段 —— 需求与设计、实施与落地、测试与验证、复盘与验收、部署与上线、收尾与归档,每个阶段结束处一道关口(依次是签「确认」;只改签过的范围;两个裁判都过;复盘过、签「验收完结」;发布前的核对都过;归档之后下一条才能立项);门号改叫阶段号,「收场」一律换掉;各关口的判法一样不改为了:「车道上机」(并进来的这一件,用户 10-16 点了「并进车道上机」)。病根:六道门的名字取的是那一道核做的动作(签字、范围、裁判、完结、发布、收场),读起来是六个动作,不是一条项目过程的六个阶段。用户原话:「这个阶段的文字也不对啊!应该按照阶段名字命名的吧?……你看过哪一个项目管理的第一阶段的名字叫“签字”第二阶段叫“范围”啊……我们项目架构是有一套专业的项目过程管理的命名才对啊!」「改为什么与什么,比如需求与设计,实施与落地,测试与验证,这样可以对其啊,对不对啊?」。决定:① 六个阶段依次叫需求与设计、实施与落地、测试与验证、复盘与验收、部署与上线、收尾与归档;每个阶段一句「这一阶段做什么」写在项目架构设计页那个阶段的小标题下面(以加粗的「这一阶段做什么」打头),治理站点的首屏从那里取,字只写这一处。② 关口在每个阶段结束处,依次是签「确认」、只改签过的范围、两个裁判都过、复盘过并签「验收完结」、发布前的核对都过、归档之后下一条才能立项;阶段五的关口是发布前几道核对合起来(部署门、两条发布出口、发布前测试、版本比对与核验收完结),不叫「发布门」,免得与守卫那道「部署门」混。③ 门号一律改叫阶段号(门一 → 阶段一 …),讲那一道核写「阶段 N 的关口」,讲结构的「六道门」写「六个阶段」、讲拦人的写「六道关口」;项目架构设计页「二」那一节改叫「二、六个阶段与关口」,六个小标题写成「阶段 N 阶段名:关口」,图名写成「图 N 阶段 N 阶段名」,图注第一句写成「这一阶段管闭环的第…」。④ 「收场」一律换掉,分三种:讲阶段六那一道核的写「阶段六的关口」或「收尾与归档那一关」;讲整个阶段的写「收尾与归档」(「没人收场」写成「没人做收尾与归档」);九格第 ⑨ 格的格名改叫「会话清空」(只换这一格的名字,九格的结构与格里的字不动,设计页的图与站点「一条线」同名)。守卫回话里那一段的开头「收场:」改成「收尾与归档:」,排队一览第五段改叫「卡在收尾与归档」,出题与用法说明同改;代码注释里当「用完收拾干净」讲的「收场」不是名字,照留。⑤ 检测引擎与封版命令给人看的报文里讲门的几句跟着改(「守着六个阶段那几道关口的是框架的床」);治理站点的项目栏目照新名出 —— 目录树、阶段页、首屏六层(阶段名、这一阶段做什么、橙色关口牌)、「一条线」(横梁上的格号照旧)、六张卡的卡头三行(「阶段 N」小牌、阶段名、橙色关口牌,关口牌单独一行),英文小字 DESIGN、BUILD、VERIFY、ACCEPT、RELEASE、ARCHIVE;Agent 栏目首屏轨道图上「项目架构」那一格跟着 agent 设计页写「六个阶段」;首屏插图的规矩「门的叠层」改叫「阶段的叠层」、「门一律橙色」改「关口一律橙色」。⑥ 只改名字:锚点 g1 到 g6、各关口的判法、八个环节、九格的结构与格里的字、十态、「部署门」(守卫一道闸的名字)、「两个裁判」、入口页与首页泛称的「硬门」都不改。改到哪:项目架构设计页、架构详图、体系守护与业务开发两份技能说明、agent 架构设计页与两份执行体定义、站点规范的条款书、判据与架构页、治理站点的构建器、项目页、Agent 栏目页与说明、守卫的回话、排队一览与出题、检测引擎与封版命令的报文,以及钉着旧名的几张床。升哪一位:与 ADR-106 同一版(整个框架与项目架构不另升);agent 架构只改写法,升第三位;站点规范同一版里另有需求 8(履历页换用户目录),按那一件升第二位。否决过:只换名字、门号照留(「门一 需求与设计」)—— 用户要的是阶段命名,门号留着读起来仍是一道道门;给八个环节逐个另起名 —— 与状态机、十态重复,环节是阶段里面的步;「收场」留作阶段六关口那一道核的名字(与「部署门」「两个裁判」同一个口径、改动少)—— 旧名留在回话与报文里,下一个人读不懂,名字要全局统一。与既有决策的关系:补 ADR-83(立项目架构时「五道硬门各写射程边界」,现行是六个阶段各写关口卡在哪)与 ADR-97(流水线的第六道门「收场」,现叫阶段六收尾与归档、那一道核叫阶段六的关口);两条原文不动。ADR-107 讲图的画法那半句「门一律橙色」照留,以本条 ⑤ 为准。守不到:决策记录、需求履历与封过的变更历史里的旧门名是历史,不改;读旧记录时照这张对照认:门一签字 = 阶段一需求与设计,门二范围 = 阶段二实施与落地,门三裁判 = 阶段三测试与验证,门四完结 = 阶段四复盘与验收,门五发布 = 阶段五部署与上线,门六收场 = 阶段六收尾与归档。同一版里先写下、还没封的 ADR-106、ADR-108 讲门号的几处随这一版改成阶段号。站点上的英文小字只是翻译、简述写得准不准,机器都不核。机制在架构详图 §八(各关口的判法,只换叫法)与 §十四;设计在项目架构设计页第二节。
ADR-1082026-10-16只改业务设计页的需求只随治理站点上线:发布登记推一条需求该发的格时,落点表里业务域那一行的目录全落在业务架构目录 .claude/arch/business/ 下的,不按这个域的端推格,这条需求带上「治理站点」一格;取代 ADR-100 里「只有业务域落点的需求不带治理站点一格」那一款里只改设计文档的那一种为了:「车道上机」(并进来的这一件,用户 10-16 选「并进车道上机(推荐)」)。病根:ADR-100 那一款的原意是业务需求要发的是代码,不该再等一次攒着发的站点;可只改域设计文档的业务需求没有代码要发,照旧推法按域描述的端推出一串端格、又不带站点格 —— 端格发不成(没有代码可发),站点格又没有,这条需求永远走不到环收尾。谁发现的:业务图修正那条需求(只改 21 个域的设计页)推出 82 格、没有「治理站点」一格,部署会话只读查出。决定:发布登记推一条需求该发的格时,落点表里业务域那一行的目录至少写了一条、而且条条都落在业务架构目录 .claude/arch/business/ 下(只改域的设计文档、变更历史与锁清单,不碰代码与数据),这个域就不按端推格,这条需求带上「治理站点」一格(有一行这样的就带);业务域那一行有目录落在代码或数据上的,照旧推各端的格;一条目录都没写的业务域行不算,照旧按端推(宁可多推端格,不漏掉该发的端格);几个业务域两种都有的,两样都推;落点只有业务域、又没有哪一行只改业务设计页的,照旧不带「治理站点」一格。十态判已发布与收尾单第四栏用的是同一份推法。已完结的这类需求不用重签,下一次跑发布登记就照新推法重推。取代 ADR-100 里「只有业务域落点的需求不带治理站点一格」那一款里只改设计文档的那一种;那一款对改代码的业务需求照旧成立,ADR-100 别的决定不变、原文不动。升哪一位:与 ADR-106 同一版。守不到:推法只看落点表里写下的目录,写计划的人把代码目录漏写进业务域那一行,机器照只改设计文档推格(阶段二的关口照样拦范围外的写)。机制在架构详图 §八「收尾单与治理站点一格」③ 与「发布登记的新记法」二、§十五「三个全仓共用的窗口」、§十七 入口表业务需求那一行;设计在项目架构设计页第五节。
ADR-1072026-10-16更正 ADR-105 决定 ④ 的画法:项目架构设计页的图照用户挑定的画法 —— 彩色、圆角、柔和阴影,颜色只表示角色;ADR-105 写成「白底、细线框、直角、不填底」是写反了。只更正那半句,ADR-105 别的决定不变为了:「车道上机」(并进来的守卫小需求)。更正什么:ADR-105 第四个决定写「页里难看的图照站点统一的画法重画(白底、细线框、直角、不填底,图里的字不小于 12 像素)」,写反了。用户在流程立法审核点四挑定、实际交付的是彩色、圆角、柔和阴影,一页之内颜色只表示角色(金是用户、蓝是主控、青是机器),门一律橙色,图里的字不小于 12 像素;项目架构变更历史 v4.5.0 与流程立法履历的标准 9 都照此写。决策记录只追加,ADR-105 原文不动,那半句以本条为准。谁发现的:流程立法的独立复盘(流程立法遗留第 11、12 条)。与既有决策的关系:只更正 ADR-105 决定 ④ 里画法那半句,ADR-105 别的决定不变。
ADR-1062026-10-16车道上机:签「确认」那一刻守卫按落点认流程、按七个风险标记算最低档,写低了签不上,认出的流程与最低档记进签字;签字锁住的目录碰到判定代码的需求同一时刻只办一条;「判决依据」只指五样、「判定代码」是判决依据加守卫、检测引擎、测试运行器;出题、立项与复盘说明照车道走;顺带修三样(发站点当场重查、签字没记上说原因、完结之后收尾归档交给接力命令);守卫核复盘者只认条目类型是 user。取代 ADR-105 里「认流程、最低档、裁判单车道都靠纪律,下一条需求起靠机器」那一部分为了:「车道上机」。决定:签「确认」那一刻,守卫按落点认流程、按七个风险标记算最低档(看签字锁住的目录:落点表加用例点名的测试),写低了签不上;认出的流程与最低档记进签字那一笔、不进内容编号,新加的两栏自报为真时才进;记过车道的重签照新核。签字锁住的目录碰到判定代码的需求同一时刻只办一条;「判决依据」只指三查、复盘说明、封版命令、发布出口、版本契约五样,「判定代码」指判决依据加守卫、检测引擎(不含各规范的判据与床)、测试运行器,这两份名单与写保护名单只写在守卫一处常量里,文档里一个词一个意思。主控派工时先认车道照旧靠纪律,签字那一刻机器再认一遍;运维、分析两条不签字,照旧靠纪律。出题命令多一句车道,立项命令按车道在看板「步骤」页签填一段这条车道走哪几步(不做成勾选框),开闸节点注明可划掉;复盘说明照抄车道表的「复盘」一格(只提示看哪里,过不过仍只按签过字的标准判)。顺带修三样:收窄到原料目录的站点发布(治理站点、官网、手机端网页版),别的会话名下内容没变、以前查过干净的文件当场按当前判据重查(子进程、有时限、跑不完按拦),不再要那个会话结束一轮;用户的话或选项看起来是签字却没记上,一律当场说原因,验收那一支重算放进子进程、有时限、子进程只算不写;验收完结之后跑接力命令就刷新收尾单,遗留去向都由主控定过(不再是默认的「后放」)、没人在跑床或建站就归档。并进的守卫小事:守卫核复盘者只认条目类型是 user,拿掉只给床留的扁平造法那一支。取代 ADR-105 里「认流程、最低档、裁判单车道都靠纪律,下一条需求起靠机器」那一部分。升哪一位:整个框架与项目架构各升第二位 —— 签「确认」那一刻多了三道核(框架新增一类闸,项目架构阶段一的关口新增硬控)。否决过:签字之前用改后的判据扫全仓(今天的检测引擎只认仓里的规范);每颗改过的闸各一个咬合证明(空壳对照按整份规范算);放宽钩子的时限(要改项目设置、治标);选床收窄(量过只省不到一分钟);三份看板模板、运维操作单模板与发布技能说明里另抄的四栏(多出来的副本以后改一次要改几遍,一份模板按车道填就够);落点表写好后按目录重打开闸节点(注明可划掉就够)。守不到:两栏自报机器不对代码核;签字时不核格里的目录归不归旁边那个单元(写计划的人能借单元名挑流程,业务域封版时版本契约照旧会挡);主控派工时认车道、运维与分析两条认流程仍靠纪律;规范流程的影响面扫描、咬合证明、不留旧账三个环节仍靠纪律;三查要整读全部台账,台账越长重算越慢,机器很忙时会一直回「过一会儿再点」;内核清单 x-core/tools/manifest.js 受写保护、归业务域,碰它的需求按母本与内核算难事,但不进「改判定代码同一时刻只办一条」;开闸、关闸两个节点划不划靠写计划的人;收尾单的去向是谁定的机器不认,只认它不再是默认的「后放」两个字。机制在架构详图 §八(「认车道」「像签字却没记上,一律说原因」「接力命令」与环1「部署门」里的当场重查)、§十四 十态表、§十五(车道表、七个风险标记、跨流程的五条规矩)、§十七(「判决依据、判定代码」);设计在项目架构设计页阶段一、阶段四、阶段五、阶段六、第五节、第八节与第十节。
ADR-1052026-10-15流程立法:需求按落点分五条流程 —— Harness 流程、规范流程、业务流程三条主流程,运维流程、分析流程两条辅助;每条按大小分三档,一共十五条车道,派工先认车道;五类架构说成自上而下的五层,各答一个问题;立一条规矩:每一类架构的设计只写当前这一版的完整内容,版本与历史只进变更历史与决策记录,机制只写在架构详图一处 —— 项目架构设计页照它整页重写、难看的图重画。取代 ADR-99 决定 ① 里「四类同一条流水线」那一部分、ADR-101 决定 ① 里「五类架构说设计写在哪」那一部分,改说 ADR-101 决定 ⑤ 的「五类需求一条流水线」;补 ADR-93、ADR-94为了:「流程立法」这条需求。病根:不管改多小、改在哪,只要碰到受治文件就是一整条需求,宪法与设计里写的是同一条流水线、同一张三档表。10-15 只读盘点的现状:一条需求的最小闭环 9 格 25 步,六道门上 47 道机器硬控,351 张测试床约 1.1 万条用例;历史 23 条需求里,小事从第一次签字到验收完结 27–37 分钟,成条的事中位 4 小时 49 分,难事中位 6 小时 46 分,计划建出到第一次签字中位 56 分钟。时间大头不在改,在证明改对了(跑床、独立复盘、开闸窗口、发布);同样改一个标题,改在条款书或后台页面一张床都不跑,改在守卫要开闸、整面重跑 —— 可手续那一半每一种都一样。三档只量了大小,没分改的是什么东西:改宪法、改一份规范、改一个业务页面,走的是同一张表。另外,宪法第三节「两把尺子」只说五类架构「设计写在哪」,五类之间是什么关系没有说法。谁定的:用户 10-15 在需求整理里定(原话要点:「我觉得我们不应该所有的场景全部套用一条项目流程,这会非常冗余,非常缓慢」;「是不是每一个场景也有低中高复杂度拆分导致流程细节不一致」;「吧只读流程改为分析吧,就是分析流程的意思,专门做分析用的」「他是业务流程的入口」;「运维流程就是专注于部署管理,版本管理……暂时先不加入测试环境」;「以前是3个架构,现在是5个架构……顶端是业务,底部是harness框架」;「暂时先不开并发,因为我要的是稳定」),签了这条需求的确认;审核点三他看了项目架构设计页,说「这里面的文字内容太多太多了……各个架构设计里面的东西应该就是最新且唯一的啊,就是当前版本的完整内容啊」「就这个状态机的这种UI图,非常不好看啊」,在三个选项里选了「需求一里就整页重写」并重签了确认;各批改动由他在审核点逐批看过;流程、档、车道、风险标记、五层的名字与说法是主控照方案冻住的口径。四个决定:① 按落点分五条流程。改宪法、框架的机制(检测、守卫、工作流)、项目架构、agent 架构,以及五层怎么写、怎么管,走 Harness 流程;改一份系统规范走规范流程;业务需求走业务流程 —— 这三条是主流程,每一档都走宪法第六节第 8 条的闭环(两次签字、封版、独立复盘、三查、验收完结)。不改仓、只动线上的部署与版本走运维流程;只分析、不改任何东西的走分析流程,它是所有流程的入口 —— 这两条是辅助,不立需求,一改仓里的文件就回到主流程。走哪条由落点定、不由人选。② 每条流程按大小分三档,车道 = 流程 × 档,一共十五条。三条主流程的三档叫小事、成条的事、难事,就是机器镜像里「档」那一栏的三个值,三条主流程用同一张上限表;运维叫例行、常规、紧急,分析叫快问、分析与体检、需求整理,这两条的档名不进机器镜像。每条车道是什么、走哪几步、跑哪些床、复盘几轮、谁来做,写在架构详图第十五节的车道表;另立七个风险标记定最低档、规范流程的七个环节与跨流程的五条规矩。宪法运作方式里「派工先分级」改成「派工先认车道」。③ 五类架构是自上而下的五层,各答一个问题:业务架构答「做什么、为什么做」,系统架构答「按什么规范写」,项目架构答「怎么一步步做成」,agent 架构答「谁来做」,框架架构答「凭什么保证做对」;从上往下读是落地,从下往上读是管控;规范管写法,它的检测对每一层的文件都起作用、横着管各层,所以五层不是严格的上下级。六层仍是框架架构里讲的控制骨架,执行体纵贯六层、不占层号 —— 两把尺子量的不是同一件事。④ 设计只写当前这一版:每一类架构的设计只写当前这一版的完整内容,正文里不写版本号与「此前」这类历史,一个单元改过什么只写在它的变更历史与决策记录里;机制细节只写在架构详图一处,各设计页写一句指向、不抄。项目架构设计页照这一条整页重写,字数砍到原来的一半以下,节名、锚点、门的小标题与图 1、各门图的写法照旧(站点构建器按名册认它们);页里难看的图照站点统一的画法重画(白底、细线框、直角、不填底,图里的字不小于 12 像素),状态机那张先画,用户看过预览、点了头的才落。这一版只立法、不上机:今天靠机器的只有签「确认」那一刻按档核条数上限(三条主流程同一张表)与原有的各道门;认流程、最低档、裁判单车道都靠纪律,下一条需求起靠机器。车道表把现行的两处做法照方案改了:成条的事由「在仓库外面的副本上写好测好、要一次开闸窗口落进仓」改成开一次闸、真仓直改;难事删掉「落地前在副本上做一轮限时预审」,改成签字之前派多路只读设计一次、决策记录草稿随签字一一起签;小事一行不再写「碰了写保护文件、按条数仍核成小事的交工作会话办」—— 落点里有写保护文件至少是成条的事(风险标记第一条)。升哪一位:整个框架升第一位 —— 宪法改写了第三节、第四节既有的两段说法(第二节与第六节第 1 条跟着对齐);项目架构升第二位 —— 它的设计页多了五条流程与十五条车道这一层说法(整页重写只改写法,不另升)。否决过:所有场景继续套一条流水线(用户否决:冗余、缓慢);把五层说成严格的上下级(会盖住规范的检测横着管各层);这一条就把车道做进守卫(先把宪法与设计立清楚,机器认车道单立一条需求,免得两样一起改、各说各的);Harness 难事先签设计、再签实施(等于多签一次字,与宪法「签两次字」冲突);业务小事免独立复盘(暂不免:业务这条线还没真跑过,等实跑有了数据再议,宪法第六节第 8 条不改);不走需求流水线直接改(机器只认签过字的需求,写不进受治文件、封不了版、发不了站点)。这一次不做的:机器按落点认流程、按风险标记算最低档、把车道锁进签字、裁判单车道(下一条需求);执行体改名、新增与按流程分队(后面的需求);治理站点首页的五层图与五条流程图、项目架构设计页里的新图(后面的需求,样子由用户定);测试环境、上线后的巡检与告警、云函数的回滚通道(等业务要正式上线时再立);其余设计页(agent 架构设计页、各系统规范的架构页、业务域文档、架构详图本身)里的版本注记与「此前」这类历史,随各自的线清。与既有决策的关系:取代 ADR-99 决定 ① 里「四类同一条流水线」那一部分 —— 入口、谁写计划、执行体、封版命令、发布面合成一张表,改框架与改项目架构没有专属工作流、封版用元治理的封版命令,两个封版入口转调同一个核心,这些不动;变的是一条需求先按落点认流程,三条主流程共用那一套闭环。取代 ADR-101 决定 ① 里「五类架构说设计写在哪」那一部分 —— agent 架构不是六层之外的又一层、执行体不占层号,这一半不动。ADR-101 决定 ⑤「五类需求一条流水线」随之改说五类需求分三条主流程走,入口表那一行不动。补 ADR-93 —— 「先分级、再选路」那一段名字不改,三档表换成车道表。补 ADR-94 —— 签字那一刻按档核条数上限不变,三条主流程用同一张上限表。旧条目不动。边界(守不到):(a) 认流程、最低档、裁判单车道这一版都靠纪律:机器今天不按落点算流程,写错流程、写低了档照样签得上(只有条数上限挡着)。(b) 运维与分析不立需求,它们的车道没有任何机器认;运维照原来的部署门与授权规矩走,分析只读(非办理会话写受治文件写前就拦)。(c) 车道表里的步骤、派谁、复盘几轮是规矩,机器看不见;办得超了、复盘轮数超了照旧只点名。(d) 三处名字一字不差由体系守护总自测守着;宪法写得清不清楚、有没有混进机制细节,机器判不了。(e) 「设计只写当前这一版」机器今天只守项目架构设计页一页(正文里没有版本号与「此前」、字数不到改之前那一版的一半,体系守护总自测核);别的设计页靠写的人与复盘者,图好不好看靠用户看预览。机制在架构详图 §十四「设计只写当前这一版」、§十五(「先分级、再选路」车道表、七个风险标记、规范流程的七个环节、跨流程的五条规矩、角色表主控一行)、§十七(术语表「流程」「车道」「风险标记」「操作单」「档」、入口表上方那一句)、§四、§六;设计在项目架构设计页第一节与第十节。
ADR-1042026-10-14顶层收尾小修:写给人看的时刻一律按本机时间写、标明时区;收尾环报「封版之后删掉了这个文件」时先提示是不是误删,给出签字基线里那份文件的指纹与带计划名的核对命令。补 ADR-83、ADR-103为了:「顶层收尾小修」这条需求。病根:两处,都撞过。① 需求履历、复盘说明、发布段、三查结果单里写出的时刻直接取世界协调时、不标时区,比本机早八小时、凌晨的跨天,治理站点上看得见 —— 10-10 主控照履历把一条 9 点多完结的需求报成 1 点多,还据此误判跨会话消息晚到了八小时。② 探针误删真仓出过两次:派出去的执行体把探针脚本写在仓外,起脚本时的当前目录却是真仓,脚本里一个相对路径就落到真仓的受治文件上(10-10 那一次把架构详图删了六分钟)。脚本进程里的写与删写前看不见、写后没有文件级写证据,第一个报出来的是收尾环 —— 而它给的出路只有升版并封版,照做就把一次误删封成了一版(v4.32.0 起封版还会自动认领落点表里没有写证据的删除,ADR-103 边界 (b))。谁定的:用户 10-14 要把待立项目清零(原话「禁止复杂化,不是必须的我们就选择不做」),五十九条筛到只剩这一条顶层收尾,并签了这条需求的确认;只做这几处、框架升第三位,写在计划里由他确认。两个决定:① 写给人看的时刻按本机时间写、标明时区。上面四处一律经同一个函数写成「年-月-日 时:分 时区偏移」,形如 2026-10-14 20:42 +08:00,偏移从本机取、不写死东八区;机器读的照旧(履历机器版里的毫秒数,账本、签字基线、结果单与复盘说明留档的 json 里的时刻),判先后、判发布读的是它们,所以这一改不动任何判定。已经封死的履历不重写,在办的在下一次重签或完结时照新写法重生成;发布段里按台账推出来的那几格下一次重算时换成新写法。② 收尾的误删提示。版本契约报「封版之后删掉(或移出)了这个文件、还没升版」、或框架锁极简比对报「删掉了」,而那个文件此刻真的不在时,收尾报文最前面先多几行:先问是不是探针误删,是就把文件原样放回,别照后面原来的话去升版、封版或重建站点;给出在办需求签字基线里那份文件的指纹(放回的那一份要算出同一个指纹)与带计划名的核对命令(放回之后跑它,这个文件不再出现在改动里才算放回原样)。只多几行提示,拦不拦、红几处不变。取舍:为什么误删只提示、不拦也不自动放回 —— 收尾分不出删掉的是误删还是这条需求本来要删的(脚本进程里的删没有写证据,与 ADR-103 自动认领同一个边界);自动放回要一份可信的原件,签字基线里只有指纹、没有内容。所以只给判断的依据(基线里的指纹)与核对的办法(带计划名的核对命令),放不放回由人定。为什么写本机时间、而不是照旧写世界协调时再标上时区 —— 读的人在本机:用户说的时间、守卫「正在办」那一行、主控报的时刻都是本机时间,只标时区不换算,读的人照样要自己加八小时。升哪一位:整个框架升第三位 —— 时刻换写法、收尾多一句提示,连同这一版里立项命令与验收题的两处小改、几句旧话改口,都是订正与写法、记账方式的改动,没有新增闸,既有各道门的判法没有改写。与既有决策的关系:补 ADR-83 —— 履历的结构与封死都不变,给人读的那一份时刻换写法。补 ADR-103 —— 删除的自动认领不变(封版那一刻照旧不问是谁删的),收尾环在报「删掉了」时先说一句误删提示。旧条目不动。边界(守不到):(a) 时刻写的是写下那一刻的本机时区,机器换过时区的,同一条需求前后几段的偏移会不同;这一版之前封死的履历里照旧是世界协调时。(b) 误删提示只在本会话被拦下、报「删掉了」时出(替无主改动复核的那一段不出),被改坏而没删掉的文件没有这句话;签字基线里没有这个文件就只能照实说没有;放回的原件要自己找(仓外副本、别的会话抄的原件、会话记录里读过的整段),git 的恢复命令照旧不许用;探针在真仓目录里起仓外脚本这件事本身照旧没有机器挡,靠派工时写死的探针三句。机制在架构详图 §八(「项目架构与封存履历」里「写给人看的时刻」一段、「清理归档」③、「收尾单与治理站点一格」③、「履历多两栏」①、环3「版本契约」里的误删提示)、§十三(第 2 关、诚实边界 ⑪)。
ADR-1032026-10-14守卫判错与补闸:六处真撞过的判错与缺口各收一个口子 —— ① 守卫写需求履历时,落点表也照需求、标准、用例、遗留那样剥掉指向计划目录的路径,剥掉处那句话改说「完结后搬进归档」;② 封版命令自动认领无主的删除:落在这一版「为了」那条在办需求签过字的落点表里的照封,认领写进封版报文与封版记录、不写进锁清单;③ 发布登记的「已生效」一格改认版本契约的单元名册,业务域以外的单元都出;④ 派发闸先查平台内置名单、再查名册,名册里有同名的行也拦;⑤ 接力命令第一步遇到一份规范都不适用的改动,照「没有规范覆盖」走过;⑥ 盯盘上状态的床登记进守卫目录的一张名单,盯的路径进它的指纹,三类有测试的封版当场重跑只因路径变了而作废的床,收尾只提示。补 ADR-83、ADR-95、ADR-69、ADR-100、ADR-98、ADR-62,收窄 ADR-102 决定 ⑤ 的一处实现,接上 ADR-101 那一版留下的一句守不到为了:「守卫判错与补闸」这条需求。病根:六处,前五处是 10-13 到 10-14 真撞过或复盘点出的,第六处是一个记账缺口。① 守卫在签字一那一刻写需求履历时,把需求、签字原话、标准、用例、遗留里指向计划目录的路径剥掉,落点表却原样抄进去 —— 落点里列了计划目录下某个文件的计划,写出的履历就带着计划路径,治理规范「真相源不引施工计划」那颗闸当场红,用户只好多签一次(10-14);剥掉处换上的那句话还写着「完结后删」,而 v4.24.0(ADR-95)起计划完结后是搬进归档。② 开闸期间删掉的受治文件没有写证据,落在无主一栏,封版命令对无主的改动一律保留旧指纹:删除没封进去,锁清单里留着一份已经不在盘上的文件,这个单元一封完就又是改过的 —— 10-14 agent 架构因此多封了一版。③ 发布登记出「已生效」那一格认的是写死的单元前缀(框架、规范、项目架构,业务总览另写一句),v4.30.0 加的 agent 架构不在里面,此后每条带 agent 架构落点的需求发布段都少这一格(v4.30.0 的变更历史里照实记着没改)。④ 派发闸拦平台内置的通用执行体(Explore、Plan、general-purpose、claude、fork),靠的是它们「本来就不在名册里」—— 名册里加一行同名的、执行体目录下放一份同名文件,闸就把它放出去(10-14 复盘者点出)。⑤ 接力命令第一步的增量检测,把「退出码 0 却一个字没打印」一律判成没跑成(防检测程序被换成什么都不做);可改动文件一份规范都不适用时,检测程序本来就是这样 —— 一条只改说明文件的需求整条停在第一步,后面几步只能手跑(10-14)。⑥ 有些床的检查直接针对真仓库盘上的情况(某个目录里有哪些东西、某条路径在不在),而那些路径不在床的指纹里:路径变了,旧的「通过」照样在收尾、补跑、体检、三查、封版各处被沿用 —— 10-13 看板规范那张盯计划归档目录的床,就这样把一条该红的死条目藏了一天。谁定的:用户 10-14 要主控把待立项目里真实存在、真需要改的挑出来,「切记不要复杂化」,能并发就并发,并签了这条需求的确认。只收真撞过的五处加盯状态那一处、审计里其余的守卫条目留在待立项目清单、认领不写进锁清单,是主控替他拿的主意;盯状态的床怎么算,签字之前由体系工程师只读设计好写进计划,设计不成立就在签字之前删掉这一条 —— 都写在计划里,由他签字确认。六个决定:① 履历的落点表同一个剥法。落点表(逐格的目录写法)与用例点名的床清单,同需求、签字原话、标准、用例、遗留走同一个函数,给人读的与机器读的两份都剥;剥掉处那句话改成「(计划目录,完结后搬进归档)」,剥法本身没改。已经封死的履历不重写(封死的履历按盘上的两份文件核产出指纹,生成口径变了不牵动它们),在办的完结时照新口径重生成。② 封版自动认领落点里的删除。无主一栏里的删除 —— 台账里没有任何会话的写证据(主人会话已结束、已不在线而按无主处理的那几种不算,它们有主人)、文件此刻已不在盘上 —— 同时落在这一版「为了」解析到的那条在办需求此刻的落点表里(与三查认「范围里」同一个判法)、又在本单元的锁清单里,不用带认领开关、照封;认领了哪几个写进封版报文(预览说「将自动认领」,封完说「已自动认领」),封版记录多一栏认领清单(为了哪条需求、哪几个文件、为什么能认)。代码不判「是不是开闸期间删的」,只认没有写证据。判法住封版命令(seal.js 包一层,记录交守卫的测试面判定模块写),不动检测引擎:锁清单照旧由引擎写。那条需求不在办、需求零件装不上、锁清单读不了,一个都不认;落点外的删除照旧算无主、保留旧指纹;无主的修改照旧要带认领开关。③ 「已生效」认单元名册。发布登记问版本契约现成的单元名册,业务域以外的单元(整个框架、系统规范域、项目架构、agent 架构、业务总览)各出一格「已生效」,不再写死几种前缀;名册里此刻没有、但与名册里某个单元同一类(冒号前那一段相同,业务域除外)的也认 —— 后来撤掉的规范域,全量重算时不会把早已「已发布」的需求翻回去;都认不出(或名册读不了)就单独标一格「认不出的单元」,不无声丢。不改引擎。④ 派发闸先认内置名单、再查名册。平台自带的两个工具型照旧在读名册之前就放;平台内置的那几种(不分大小写)接着就拦、报文写明是平台内置的名字,不看名册 —— 名册里有同名的行、执行体目录下有同名文件照拦,名册读不到时报的也是这一句;名册只用来写「换成谁」,那一句不再列名册里写着内置名字的行;然后才是「在名册里而且定义文件在的放,其余拦」。⑤ 接力命令认一种合法的沉默。第一步逐批看,退出码 0 而没打印时,先问检测引擎现成的射程(增量检测那一段同一套:索引器、规范发现、射程缓存,元规范不算):这一批一份规范都不适用就照「没有规范覆盖」走过、打印一句说明;有规范适用而没打印的照旧判没跑成,射程判不了也算没跑成。不改引擎。代价:每个一字不打印的批次都要算一次射程,没有缓存时一次约九秒。⑥ 盯盘上状态的床:名单加指纹,封版当场重跑。守卫目录新建一张名单(state-watch.json),写明哪些床盯哪些路径:落地时 19 张床、66 项,每项写了为什么盯,逐张读床核过再抄进去;设计初稿列的发布流水线床没登记 —— 它盯的发布脚本目录本来就在它自己的指纹里。名单上的床把盯的路径此刻的样子(在不在、是文件还是目录、有哪些名字,不读内容)算进指纹,路径一变,旧「通过」在各处同时作废;三类有测试的封版(整个框架、系统规范域、业务域)共用的测试前置先照账本判一遍,挑出只因盯的路径变了而作废的床,执行时交唯一运行器当场逐张重跑(每张等运行器的锁最多 45 分钟)、再判,重跑没过就不封并点名;预览只列出会重跑哪几张;路径没变的不重跑,床本身、夹具、被测文件或上游改过的照旧不代跑;收尾环对这种床不算到任何会话头上,只提示、不拦。名单里点名的床不在了、名单写坏了,唯一运行器的全量卫生检查报出来并计入失败。床本身一行不改。代价:路径没变时只多几次查目录;变了只重跑变了的那几张 —— 规范域封版多一到十几秒,整个框架封版最坏几张同时变约五分钟、平时多为零;装上那一刻名单上的床旧记录各作废一次,在下一次相关封版里补跑一回(这一条自己封框架时,会自动重跑收尾环床、版本契约床、端类金丝雀床三张)。三处取舍:盯状态的床为什么用名单加指纹、不用「封版一律重跑」 —— 一律重跑,什么都没变时整个框架每次封版也要多跑约五分钟;而且只有封版那一处重跑,收尾、补跑、体检、三查照旧沿用旧结论,毛病没改,只是挪到封版时再查一次。指纹让「路径变了」直接作废这张床的旧记录,五处同时看见、认的是同一个面状态,不另起一套认法;名单让代价只落在会被路径牵动的那几张床上。名单不从床里自动推(床读真仓的写法五花八门,静态推必漏),也不让床头声明(要改床的写法,这条需求写明不做;床头写错了静默不触发,比不写更坏);集中在守卫目录一张表上,受脊柱写保护、是整个框架锁住的内容,改它要开闸、要升版。派发闸为什么把内置名单排在名册之前 —— 这道闸要挡的就是平台内置的通用执行体:名册上该有人干的活由它们顶着,是派发闸立起来的原因(ADR-102 决定 ⑤),拦下它们的理由不该是「名册里恰好没有」。名册是设计页里的一张表、执行体目录是一个目录,往里加一行、放一份文件都是正常的改动,闸不该因为它们而松;名字撞上内置的那几个时,平台派出去的到底是哪一个,守卫也判不了。也没有改成在 x-agent 的名册闸里禁止与内置同名的行 —— 框架判自己不借系统规范的闸(宪法:框架操作系统四件套、绝不依赖它们),而且名册闸在检测时才判,派的那一下才是要拦的时刻。认领为什么不写进锁清单 —— 锁清单由检测引擎写(版本契约的唯一实现),写进去要开检测引擎那把锁、改契约代码,这条需求只收守卫与脚本的口子,不扩范围;锁清单记的是这一版锁住了哪些文件、各是什么内容,不是改动是谁的、怎么进来的 —— 认领是封版那一刻的归属判断,归封版记录与当时的报文。代价照实认下:锁清单里看不出哪个文件是认领封进去的,要看封版记录与当时的报文,本机账本清过就查不到了。升哪一位:整个框架升第二位 —— 新增一类东西(盯状态的名单与封版前置里的重跑、封版的一种自动认领),既有各道门的判法没有改写。否决过:封版时把整面床一律重跑(见上);收尾环硬拦盯状态的床(挪路径的多半是别的会话、别的需求,拦下的往往不是挪它的人,它们的闭环点放在封版);把整个仓库的文件清单算进指纹(任何改动都让它作废,等于没有沿用);无主的修改也自动认领(修改有内容,没有写证据就分不出是谁在途的改动,悄悄封进去等于封了没人看过的内容 —— 这正是认领开关要人显式说一句的原因);只要是删除就认、不看落点表(会把别的需求的删除或误删封进这一版);签字时拒绝落点表里列计划目录下的文件(有的需求合法地要改计划目录里的东西,多一道拒绝只是把毛病挪到签字那一刻);让检测引擎在没有规范适用时也打印一句(要动引擎,这条不动;接力命令只听现成的裁判);把「退出码 0 而没打印」那一判整个拿掉(防检测程序被换成什么都不做的那一道就没了);在发布登记写死的前缀里补一个 agent(下次再加一类单元又要回来改)。这一次不做的:已关会话名下从没查过干净的文件仍等 24 小时;执行体文件三处认法口径不一(版本契约只认下一层、名册闸递归子目录、围栏按目录前缀);审计里其余的守卫条目(正式发布自动登记、业务格按改了什么推、作废一条需求的出路等)—— 都留在待立项目清单;不改任何检测判据、不改计划模板;「复盘者收尾两次、第二笔打红第一查」那一条 v4.27.0 早已修好,不是要改的事。与既有决策的关系:补 ADR-83 —— 生成履历时剥计划路径的范围补上落点表;剥掉处那句话照 ADR-95 改口(ADR-95 写明当时没改这一句、也没改回填说明,这一次改前一句,回填的照旧不改)。补 ADR-69 —— 按会话归属封版、认领开关都不变,多一种不用开关的认领,只限删除、只限这一版所为那条在办需求签过字的落点表;ADR-50、ADR-82 的无主认法不变。补 ADR-100 —— 发布登记的新记法不变,「已生效」那一格改认单元名册;接上 ADR-101 那一版变更历史里记着的守不到(发布登记认单元名的那一处还没有 agent 架构)。收窄 ADR-102 决定 ⑤ 的一处实现:拦平台内置类型不再靠名册里没有它,其余判法不变。补 ADR-98 —— 接力命令「每一步核产物」不变,第一步多认一种合法的沉默。补 ADR-62 与 ADR-61 —— 测试跟着单元定版、按张记录都不变,名单上的床指纹多一样东西,三类有测试的封版的测试前置多一步重跑;v4.17.0「只跑不新鲜的」认的仍是同一个面状态。旧条目不动。顺手改口(不涉及判定,记在变更历史里):守卫本体文首两处注释(顶层围栏补上 agent 架构、派发闸照新判法写)、回归套件三处「顶层三类」的注释改成现行说法、需求零件两处旧注释(治理站点一格、授权在哪说)、元治理四件套脚本一句「三层同一个流程」、元治理规则书场景 F 的封版单子补上项目架构与业务总览、架构详图三处讲「项目经理」改名时点的写法统一。边界(守不到):(a) 履历只剥 .claude/plan/ 起头的写法(反斜杠写的也认);这一版之前封死的履历不重写,那句占位照旧是旧的。(b) 删除的自动认领不问是谁删的 —— 没有写证据就分不出是这条需求删的还是别人误删的,落在落点表里就封进去,落点表写得越宽、误认的面越大;认领只记在封版报文与本机的封版记录里。(c) 派发闸的内置名单写死在守卫里:平台新加的内置类型要人来加,加之前它只靠名册里没有它被拦;守卫不核名册里有没有与内置同名的行,只在派的那一下拦;写前拦截摘下期间照旧不在岗。(d) 「没有规范覆盖」信的是检测引擎的射程:射程把有规范管的文件算成没有、检测程序又恰好一个字没打印,第一步会照实走过 —— 要两样同时出错。(e) 「已生效」认名册之后,名册里业务域以外的单元一律算落盘即生效:以后加一类自己另有线上发布面的单元,发布登记照旧只给它出「已生效」,要回来改;名册读不了的那一次,业务域以外的单元全标成认不出、判不了,需求翻不了「已发布」(只会更慢翻,不会误翻)。(f) 盯状态的床:名单靠人维护(新床盯了状态却没登记、床改了盯的路径而名单没跟上,照旧沿用旧结论;卫生检查只核点名的床在不在);只看路径在不在、有哪些名字,不看文件内容;依赖整个仓库的床没法按路径记;两次封版之间没有人主动重跑;框架封版只核守卫、检测引擎、技能三类床,规范床要等那份规范自己封版、业务域的床等那个域封版;封版前的需求对账排在测试前置之前,用例点名的床若在名单上、只因盯的路径变了而作废,会先按用例没闭环拒封、轮不到当场重跑,要先手跑那张床;名单文件被删掉就当空名单,兜着的只有版本契约(它是整个框架锁住的文件);「封版、运行器、账本」这整条链没有一张床从头到尾验过。机制在架构详图 §八(「项目架构与封存履历」②、「清理归档」⑧、「收尾单与治理站点一格」里「「已生效」一格出给谁」、「接力命令」、「派发闸」、环3 分账里讲无主的那一条与「测试新鲜度」)、§十三(第 3 关「删除的自动认领」与诚实边界 ⑪)、§十六(「盯盘上状态的床」、「卫生检查」⑥、「封版的测试前置」里当场重跑那一条、「封版记录」)。
ADR-1022026-10-13agent 架构二期:项目经理成了一位执行体、接住流水线的运行面,主控收窄成决策、出设计、弹签字题三样,原来叫「项目经理」的那一面改叫「关口」;守卫加派发闸 —— 名册外的执行体类型派不出去(平台内置的通用类型也拦,只放两个工具型),写域越界只在收尾点名;授权在哪说、谁动手六处统一成一句;规范裁判官下线,拟增的六位里建三位、三位内核工程师不建;已关掉的会话名下没复核的改动不再干等 24 小时。推翻执行体注册表里两句旧定论(「视觉设计不单设 agent」「项目经理是这套体系本身」),取代 ADR-75 决定 ⑧ 里「项目经理」这个叫法与规范裁判官那一位、ADR-98 里「别的发布面仍在部署会话说」那一句、ADR-99 决定 ⑤ 里「线上删除由运维发布专家做」那半句,收窄 ADR-99 决定 ③ 与 ADR-101 决定 ④,接上 ADR-101 留给下一条的三件,补 ADR-94 决定 ⑧、ADR-93、ADR-90、ADR-82、ADR-11为了:「agent架构二期」这条需求。病根:agent 架构立层之后做了一次全链路审计(十位只读审查,七十四条发现),结论是这一层画出来了、还派不动 —— 今天不靠人传话,一条业务需求从提出走不到上线。派谁写成半硬而实际是软:守卫只拦复盘派谁,立项命令把入口表整张打印、不按单元筛,入口表还缺四位现有的执行体。名册里有几位只在纸上、设计页拟增的六位没有文件、按名字派不出去,而队形里把它们写成必经的一步;这几类活今天真实发生,是名册外的通用执行体或越出写域的执行体在干。规范裁判官的活早被接力命令、执行体停下那道关、收尾环与部署门接走,它的报告没有机器读,六份执行体的「输出经谁核」却还写着它。发布与联调的授权在哪说,真相源之间说法相反:agent 架构设计页写对主控说、由它转,另外几处写在部署会话说,照哪一边办都有一处不合规。流水线的运行面 —— 立项排期、派工握手与回报、进度与阻塞、遗留去向、收尾归档 —— 全由主控手工顶着:它是唯一的转话者,被对话框占住时全线停,一条线停了没人发现,「谁在等它转什么」只在它的上下文里、一压缩就丢。另有一处守卫缺陷:一个会话关掉之后,它名下封版之后还没复核的文件,要等它最后一笔动静满 24 小时才轮到别的会话替它复核,这期间发布被拦,只能请用户进那个旧会话结束一轮 —— 两个晚上各撞了一次。谁定的:用户 10-13 定了五样 —— 要对 agent 架构做全链路分析,查断点、查永不激活、看能不能覆盖当前产品从开发到上线;硬控对 agent 架构必须真有用,不能是幻想;每类架构都要有专家,项目架构缺一位项目经理;先验收立层那一条,二期把审计与项目经理一起做;已关掉的会话卡住发布这个设计缺陷要修,不排在二期后面、并进二期一起做。图里「你」这一方叫 BOSS 也是他定的。其余几样是办这条需求的会话替他拿的主意,写进计划由他签字确认:名册谁去谁留;授权口径那一句(他 10-08 定的「只和主控说话」在发布上的落法);派发闸连平台内置的通用类型一起拦,而写域只点名不拦;立项命令两头都接;项目经理归治理类,不签字、不弹题、不放行;agent 架构升第一位;判会话在不在线读平台的会话名册,只对此刻的内容曾经查过干净的文件提前复核,名册读不了就退回 24 小时。八个决定:① 项目经理是一位执行体,管流水线的运行面。职责六样:立项分级与排期、派工握手与回报节点、超时没回报就叫人、进度与阻塞跟踪、风险与资源(用量与窗口)、遗留去向台账与收尾归档。写域是计划目录与总账,不写代码、不写受治文件;不签字、不弹题、不替关口放行;不决策 —— 档、派谁、先后、遗留去向它只出方案,拍板归主控;不派执行体。它平时由主控派(每次醒来派它核一遍总账);验收完结之后刷新收尾单与清理归档那两下,在办那条需求的会话里由领队派它跑,清理归档执行之前经领队点头,收尾单里写错的那几行仍由办理会话改。名册里归治理类(流水线运行面)。它不在回合里醒不过来,所以「超时叫人」定成主控每次醒来派它核一遍,不是到点自动叫。② 主控收窄成三样:决策、出设计、弹签字题。用户的话仍只对它说 —— 签字、开闸、授权、叫停与恢复由它逐字转给该收的会话,转的是用户的原话。运行面的事它不再亲手做,每次醒来先派项目经理核一遍总账。独立复盘连续三次不过之后的那一次复盘由它在用户对它说过话之后派 —— 机器只认派复盘的那个会话里用户说过话,而用户只和它说话。这条路照代码读是通的,没有实跑过;实跑不通时退回老办法 —— 用户去那个工作会话说一句,由那个工作会话再派。③ 原来叫「项目经理」的那一面改叫「关口」。这套体系本身管放行的那一面 —— 计划、守卫的各道门、三查、封版、验收单 —— 管的事一样没变,只是把名字让给执行体。架构详图的角色表与术语表、执行体注册表同批用同一个叫法。④ 名册对到十九位,三处一致、有闸。规范裁判官下线:它跑检测与测试床的活由接力命令、执行体停下那道关、收尾环、封版命令与部署门接着。设计页拟增的六位里,站点工程师、视觉设计师、调研员建成文件 —— 这三类活今天真实发生;移动端内核、网页版运行时、服务端内核三位不建 —— 它们要顶替的那两位本身还没被派过,拆了只是一份纸上的执行体变成三份,写域照旧在小程序前端专家与云函数专家名下。设计页不再有「拟增」那张表。名册表、注册表、执行体目录三处一致:名册表对文件由原有的名册闸守,注册表对名册表由 x-agent 规范新加的一颗闸守。每位执行体的写域、工具、触发词按真实干的活写准,写域一行里的目录一律用反引号包住。⑤ 派谁硬一档:名册外的类型派不出去。守卫在写前对「派执行体」那一下加一道派发闸:派出的类型不在名册就拦,不写类型也拦,平台内置的 Explore、Plan、general-purpose、claude、fork 一律拦,只放平台自带的两个工具型 claude-code-guide 与 statusline-setup,名册读不到也拦,名册里有这一行而定义文件不在同样拦。这一道叫「派发闸」,守卫报文以「环1 派发:」打头;架构详图里原先也叫过「派发闸」的那一道 —— 连着三次不过不让再派复盘 —— 改叫「复盘派出那一道」,报文以「环1 复盘:」打头,判法没动。立项命令按落点单元筛出该派的执行体并打印名单 —— 命令行给了单元按它筛,没给而这份计划已经在就照它机器镜像里的落点表筛,两样都没有才整张打印并写明没给单元;入口表补齐,主控之外的每一位至少出现一次,每一行写明项目经理的接力点。业务编排器给各端打印执行体名与技能两样。执行体用编辑工具写到了它「写域」一行那些目录之外,收尾环点名那一笔、不拦。⑥ 授权在哪说、谁动手,六处同一句:BOSS 只对 X大脑 说,X大脑 逐字转给部署会话,部署会话以转来的原话为准、照发布技能自己动手、量大派运维发布专家,机器不核。(这一句里 BOSS 就是用户、X大脑 就是主控。)六处是 agent 架构设计页「联动与硬控」、架构详图第十五节角色表与第十七节入口表、项目架构设计页门五、发布技能说明顶部、开发规则书开篇、部署规范的条款。授权仍是用户的一句话、每一次线上写入都要、单次有效不跨轮;只发治理站点的需求凭「验收完结」那句话连带授权照旧,那句话也是对主控说的。⑦ 设计页的硬控清单照代码判。「联动与硬控」每一行判成硬、半硬、软三者之一并写明出处:硬是机器在某个关口真会拦、或由机器自己做;半硬是机器认一半、人补一半;软是规矩。主控的身份由半硬改回软(硬的只有那份定义文件);机器早就有而设计页没写的补成行,不存在的删掉。⑧ 已关掉的会话名下没复核的改动不再干等 24 小时。ADR-82 把「主人会话已结束」定成最后一笔台账事件在 24 小时之前;这一次多一种认法 —— 主人会话不在线(本机的会话名册里没有它,或它的进程已经不在),而且这个文件此刻的内容曾经查过干净(旧结论只是因为判据或引擎变了才作废,封版之后就是这种),任一会话收尾时就按无主替它复核、结论按内容记回;部署门只读查看那一侧用同一个判法,报文写明主人已不在线。主人还在线的、此刻的内容从没查过干净的,照旧。会话名册读不了时照旧按 24 小时判 —— 只会更严、不会更松。这类文件落在无主一栏,封版命令的认领开关可以认领它们;三查那边仍按别的会话认,没变。升哪一位:整个框架升第二位 —— 新增一道闸与一个命令开关。同一条需求里 agent 架构升第一位(名册与硬控口径都改写了),x-agent 规范新增一颗闸、升第二位,部署规范只改讲授权在哪说的那一句、升第三位;项目架构设计页同批改口,升哪一位记在它自己的变更历史里。否决过:把审计的七十四条并进「agent架构立层」做完再验收(用户定了先验收;并进去要再锁整个框架几天、再签两三次);守卫按写域硬拦执行体写文件(今天真实的活里就有越域在干的,先点名看清谁越、越到哪,再定拦不拦;拦错会把正在干活的执行体当场卡死);只拦名册外的自定义名字、放过平台内置的通用类型(平台对不存在的类型本来就报找不到,那样的闸等于没有;顶名册的活正是通用类型在干);让项目经理替主控弹签字题(签字题只能由领队弹,守卫按弹题的会话记签字,项目经理是执行体、没有自己的会话);把三位内核工程师建出来(见 ④);把审计里守卫与发布门那一组发现并进这一条(那一组改的是发布门的判法与发布脚本,与改名册、设计页不在同一块,紧跟着另办)。这一次不做的:让机器核授权(ADR-99 否决过、ADR-100 列为不做,理由没变 —— 机器认不出会话身份,授权是用户的一句话,做出来只会是假闸);给项目经理配机器计时与接力回执(要动守卫的事件接线);审计里归守卫与发布门的那一组 —— 正式发布自动登记、业务各格按改了什么推、已完结到已发布有人负责到底、云函数回滚与线上出事的紧急通道、部署门对数据写与证书的比对范围、作废一条需求的正式出路、账本的仓外镜像不绑本机路径、会话地址作废后的重发、在子目录开会话不加载项目设置;第二个云环境(今天联调即上生产);支付域与内核母本的版本单元,以及把整个框架这个单元拆小、让改守卫的几条需求能同时办;新页面要的线上菜单节点与角色授权、小程序原生包、师傅端脚手架;仓根与服务端目录下两份与规矩相反的说明文件。与既有决策的关系:推翻执行体注册表里两句旧定论。一句是「视觉设计不单设 agent」(2026-07-07 确认过):当时的理由是避免多一个落点、偶发的能力不常驻;今天往受治设计页里画图、出预览稿的活真实发生,而且是别的执行体越出写域在干 —— 单设一位,只在要出图与预览稿时派。另一句是「项目经理是这套体系本身」连着「不单设总指挥 agent」的那一条:前半句推翻 —— 项目经理现在是一位执行体,体系管放行的那一面改叫关口;后半句的理由(放行不交给任何一个执行体自己判、不与开发流成为两个编排者)仍然成立,新建的项目经理不放行、不编排、不派执行体,它不是总指挥,也不是架构详图第十五节否决清单里的协调者执行体。取代 ADR-75 决定 ⑧ 里两处:「项目经理是这套体系本身」这个叫法,与名册里质量那一类的规范裁判官;「不单设总指挥执行体」不动。取代 ADR-98 里「云函数、后台、手机网页版、官网的发布授权仍在部署会话单次说」那一句:授权不并、仍是单次,变的只是在哪说;ADR-98 的连带授权不动。取代 ADR-99 决定 ⑤ 里「线上删除由运维发布专家做」那半句:改成部署会话照发布技能自己动手、量大派人;「一切线上写入都要用户单次授权、只在部署会话做」不动,ADR-99 否决栏「让机器核发布授权」不动。收窄 ADR-99 决定 ③ 里「握手、盯进度、排窗口、定档仍只能靠人」:仍没有机器核,但备与记这几样的不再是主控本人,是它派的项目经理;「不建主控技能」不动。收窄 ADR-101 决定 ④:名册表不再另列拟增的几位,注册表与名册表之间有了闸(它的边界 (b) 里「之间没有闸」那一句随之作废)。接上 ADR-101「这一次不做的」里归下一条的三件 —— 名册扩到拟增的那几位(建三位、不建三位)、发布由谁动手、立项命令打印该派的名单;两份说明文件仍没做。补 ADR-101 决定 ③ —— 主控的定义收窄成三样。补 ADR-94 决定 ⑧ ——「授权是用户亲口说的一句话」仍然成立,这一次写明在哪说:只对主控说。补 ADR-93 —— 先握手、带设计、按节点回报的规矩不变,备与记由项目经理做。补 ADR-90 —— 主控守顶层、不办实施,再收窄一步。补 ADR-82 ——「主人会话已结束」在 24 小时之外多一种认法(决定 ⑧)。补 ADR-11 —— x-agent 规范在原有几颗闸之外多一颗。旧条目不动。边界(守不到):(a) 派发闸只核类型在不在名册、定义文件在不在:派得对不对不核,平台实际装的是不是那份定义也不核;定义文件只认直接住在执行体目录下的;它是写前那一道,开闸期间不在岗,没有写后补判;不经派执行体那个工具起的执行体不过闸(经工作流工具起的也不过,这一条是推断、没核);主控的定义也在名册里,把它当执行体派出去闸照放。(b) 项目经理不在回合里醒不过来:没有人说话、也没有别的会话来消息的时段它不会自己醒;「超时叫人」是主控每次醒来必核一遍,不是到点自动叫;主控派没派它、它记没记账,机器不核;总账是计划目录里的普通文件,不受治。每次开工是不是先开了 X大脑,照旧是纪律。(c) 写域只点名、不拦:只在领队收尾时点,只看得见编辑工具写的,命令行与脚本写的看不见;判不了的不点名也不出声(定义文件读不到、没有写域那一行、带名字的队友对不回定义、没有名字的执行体);写域那一行写得对不对没有闸。(d) 立项命令只打印名单,照不照名单派机器不核。(e) 授权没有机器核:转的是不是用户的原话、是哪个会话在发,都不认;六处那一句以后会不会再走样没有机器对拍,这一次靠用户亲手逐处读。(f) 名册里每一位都有文件,不等于每一位都被派过:业务那几位在这条流水线立起来之后还没真派过,一条业务需求从头走到已发布也还没实跑过。(g) 握手、催问、转话这几句由项目经理写好、从主控的窗口发出去:被派出去的执行体能不能直接给别的会话发消息没有实测。(h) 不改代码的小事仍在主控的会话里办到验收完结(机器按会话认办理会话):主控「只做三样」在这一档上是它的会话里另有执行体在做。(i) 平台依赖、用量上限、临时目录清理、会话寻址四样写进了设计页的诚实边界,机器都帮不上。(j) 守卫的需求零件里有一句注释还写着旧的授权说法,不影响判定,这一次没动。(k) 无主复核的新认法依赖平台的会话名册 —— 那是平台自己记的、本机上开着哪些会话,不是这套体系的文件:名册的位置、文件名与字段是平台此刻的样子,变了就判不了,这一种认法失效,退回只按 24 小时判,不会放松。它只看得见本机、这一份配置目录下起的会话,别处起的会被看成不在线;进程号被别的进程重新用上时,已经关掉的会话看起来还在线(只会更严);被看成不在线的那一位其实还在的话,它自己收尾时这个文件仍算它的、照查照拦。替它复核的只是检测、不含测试,复核出红的照旧挂着;发布之前的只读先查那一侧不带会话号,少核「名册里本会话在线」那一样。此刻的内容从没查过干净的文件不走这条路,仍要等主人最后一笔动静满 24 小时才有人替它复核,出路照旧是恢复那个会话结束一轮。机制在架构详图 §十五(角色表、执行体按层表、「这张表今天靠什么」、「谁来发布、怎么授权」、「项目经理接住运行面」、「主控怎么交接」)、§十七(术语表「项目经理」「关口」、入口表)、§八(环1「派执行体通道」;环3 需求对账里「派发闸」「写域点名」两段与「复盘进关口」里改了叫法的「复盘派出那一道」;环3 分账里「主人已不在线、内容曾查过干净」那一种认法)、§九(「发布之前先只读查部署门」);设计在 agent 架构设计页。
ADR-1012026-10-13agent 架构立层:四类架构升成五类 —— agent 架构是第五类架构(说的是设计写在哪),不是六层之外再加的一层(L6);执行体文件从整个框架的单元移到新单元 agent:overview 做它的内容;主控有了只作主会话用的执行体定义「X大脑」;执行体名册与文件一一对应由 x-agent 规范的闸守。取代 ADR-70 决定 ⑥ 里「框架认领 agents/」那一半与 ADR-99 决定 ③ 里「不建主控执行体」那一半,收窄 ADR-99 决定 ②,补 ADR-99 决定 ①、ADR-94 决定 ⑦、ADR-90 决定 ⑦、ADR-83、ADR-75、ADR-11为了:「agent架构立层」这条需求。病根:执行体自 ADR-11 起是一类受治文件,ADR-70 把它们算进整个框架的设计。于是没有一页讲清有哪些执行体、谁派谁、怎么组队、受谁管 —— 每个执行体的归属、用在什么场景、与别的架构怎么联动,散在十几份执行体文件、名册注册表与架构详图第十五节里;改一份执行体要升整个框架的版,还与框架上别的需求互相排队;主控只是一个约定俗成的窗口,没有一份写明它做什么、读什么的定义。谁定的:用户 10-12 定了四样 —— 四类架构升成五类,新增的叫 agent 架构,每个执行体要有归属、有场景、有联动;主控叫「X大脑」,是整支队伍的顶端,每次开工先开它;设计页照系统架构那一栏的样式与结构做(左边目录树、一级一页、每页先图后文),第四稿定稿;治理站点上这一栏排在「设计理念」后、「业务架构」前,栏目名就叫 agent架构(站点床「主导航每项四个字」的规矩给这一项一个例外)。其余几样是办这条需求的会话替他拿的主意,写进计划由他签字确认:执行体文件归新单元做内容、名册表这一次只列真有文件的那几位、「主控」这个角色词不改名、「每次开工先开 X大脑」只作纪律。五个决定:① agent 架构是第五类架构,不是六层之外再加的一层。宪法第三节的两把尺子照旧:五类架构说设计写在哪,六层说谁管谁。agent 架构的设计写在设计页 .claude/arch/agent/ARCH.html(X大脑与两类会话、一条需求里谁做什么、执行体名册与每一位的分工、队形、场景地图、与另外四类架构的联动、硬控清单、诚实边界);执行体仍是纵贯各层干活的执行者,不占层号 —— ADR-11 否决「L6」的理由原样成立。② 新增一类版本单元 agent:overview,执行体文件是它的内容。锚只认设计页、版本读页头的标记(与项目架构同一种做法);设计是设计页,内容是执行体目录下一层的执行体文件与名册注册表。整个框架这个单元不再包执行体文件:改一份执行体只升 agent 架构的版本,不再带动整个框架,也不再与框架上别的需求互相排队。换的只是归属,锁法没变(逐个文件记指纹、改了没升版当轮红、同一个封版命令);它的测试指纹如实写 none —— 设计页没有代码,执行体文件由 x-agent 规范的闸判。守卫的顶层围栏随之多认这一类:agent 架构的设计页、变更历史、锁清单与全部执行体文件,只有办着列有这个单元的需求的办理会话写得动;执行体目录照旧在写保护名单上,改它仍要开闸。③ X大脑:主控有了执行体定义,只作主会话用。定义住执行体目录(x-brain.md),用官方命令行给主会话指定执行体的方式启动(启动命令写在架构详图第十五节角色表主控一行与第十七节术语表);它写明主控的写域、输出经谁核、结论记在哪与开工必读,是名册里的一行,过 x-agent 规范的闸。三层不嵌套:X大脑 → 会话(工作会话、部署会话)→ 执行体 —— 它是队伍的顶端,不是又一支队伍,工作会话自己带执行体、不再套一层。「主控」仍是角色的叫法,X大脑是这个角色的会话名与执行体名,各处讲主控做什么的句子不改名。④ 名册与文件一一对应,由闸守。执行体名册的真相源是设计页里的名册表;x-agent 规范加一颗闸(NS-COMMON-0007),拿名册表与执行体目录下的文件两边互核,名册多一行、文件多一份都红。名册表这一次只列真有文件的那几位与 X大脑;设计页里拟增的几位只写定义、另列一表、不进闸。⑤ 五类需求一条流水线。入口表多「改 agent 架构」一行:落点单元 agent:overview,走需求流水线、没有专属工作流,设计页归框架架构师、执行体文件归元治理专家,封版用元治理的封版命令;元治理的封版入口从封五类单元变成六类。治理站点多一栏,正文由构建器从设计页切节而来。升哪一位:整个框架升第二位 —— 新增一类版本单元;执行体文件换了归属而锁法没变,不按改写既有契约算。否决过:把 agent 架构做成六层之外再加的一层(L6;六层是控制海拔,执行体纵贯多层,ADR-11 已否决过一次);把 X大脑做成一条工作流(工作流只编排执行体、不和用户谈,X大脑是和用户说话的那个会话);让工作会话再带一层队伍(三层不嵌套,多一层只让身份与归属更难核);把启动命令、闸的算法写进宪法(宪法只写定性与存在性);为了让新单元的首封不必重签,给封版命令与顶层围栏加一条例外(那是改门的判法、要加床,而且需求履历里会少记一个单元 —— 改走现成的规矩:签字时 agent 架构的文件按没有主列,单元出生之后落点表改挂到它名下、用户再签一次确认)。这一次不做的:把执行体名册扩到设计页拟增的那几位、把各执行体的正文写准,归下一条「执行体对表」;仓根与服务端目录下两份与规矩相反的说明文件怎么处置、发布由谁动手,同归那一条、等用户定;立项命令按入口表打印这条需求该派的执行体名单,同归那一条;文档里「主控」这个角色词不全改成 X大脑;让机器在别的会话写受治文件之前核有没有 X大脑 在跑 —— 要改守卫,另立需求。与既有决策的关系:取代 ADR-70 决定 ⑥ 里「框架认领 agents/」那一半(技能的模板资产那一半不动)。取代 ADR-99 决定 ③ 里「不建主控执行体」那一半:当时的理由是主控要和用户说话、要弹签字题,这两样被派出去的执行体都做不了 —— 那条理由仍然成立;这一次建的定义不派出去,它就是主会话自己,所以不与那条理由相撞,也不是架构详图第十五节否决清单里的协调者执行体(没有多出第二个编排者)。ADR-99 决定 ③ 里「不建主控技能」那一半不动。收窄 ADR-99 决定 ②「不拆框架版本单元」:当时不拆的理由是要动单元名册、顶层围栏的路径预筛与对拍床,是改写版本契约 —— 这一次正是动了这几处(各有床守着),但只把执行体文件这一块移出去,框架其余部分仍是一个单元,顶层需求在它上面照旧串行。补 ADR-99 决定 ① —— 四类需求改成五类,入口表多一行。补 ADR-94 决定 ⑦ —— 顶层围栏管的版本单元由三类变成四类。补 ADR-90 决定 ⑦ —— 四类架构改成五类;「执行体叫执行工件类」不变,多的是它有了自己的那一类架构来写设计。补 ADR-83 —— 项目架构不再按序数叫「第四类」。补 ADR-75 —— 执行体按层那张表加 agent 架构设计页一行。补 ADR-11 —— 执行体仍不是层;x-agent 规范在原有几颗闸之外多一颗名册闸。旧条目不动。边界(守不到):(a) 每次开工是不是先开了 X大脑、窗口是不是用那份定义启动的,机器不核,是纪律;机器管到的只有那份定义本身的形与它在不在名册里。(b) 名册闸只核名字两边对不对得上:每一位的分工、写域、提示词写得对不对,判不了;拟增而没建文件的几位不进闸;名册注册表里那张指针表与设计页的名册表是两处,之间没有闸。(c) 执行体的写域仍只是写明:越没越界由需求对账与顶层围栏拦,守卫不按执行体的名字核写域。(d) 设计页讲的队形、派工协议、场景地图是规矩:握没握手、派了谁、按什么队形派,机器不核。(e) 入口表「执行体」一栏、执行体按层那张表与各执行体文件的写域一行一不一致,照旧没有机器对拍 —— 这两张表写了 agent 架构设计页归框架架构师,那份执行体文件的写域一行跟没跟上,闸不看。(f) 落点有 agent 架构的需求,发布登记今天不出「已生效」一格(它认单元名的那一处还没有这一类),只有「治理站点」一格;翻不翻已发布不受影响。(g) 守卫本体与守卫回归套件里几处注释还写着「顶层三类」,不影响判定,这一次没动。(h) 治理站点上这一栏的主导航名不是四个字,站点床为它留了一个例外 —— 例外是用户定的,只认这一个名字。机制在架构详图 §十三(单元表、「执行体文件换了单元」、两个封版入口)、§十四(agent 架构那一条、写权分工)、§十五(定位、受治文件类、名册闸、角色表主控一行、执行体按层表、生命周期)、§十七(术语表「X大脑」、五类需求入口表)、§八(顶层围栏);设计在 agent 架构设计页。
ADR-1002026-10-12部署门认联调:开发期联调上线有机器认得的口径 —— 放行面就是那条需求签过字的落点表、不另设登记,云端工具通道靠一个 30 分钟的短时标记、脚本通道带两个开关;没成立的一律按正式发布判,正式发布由机器核验收完结;发布登记只给已完结的需求记已发布、按完结时那一版比;数据表与微信原生包在体系之外发、移出该发的格;只有业务域落点的需求不带「治理站点」一格;版本比对拦下时报文直接带封版命令。取代 ADR-83 否决栏「发布门要求已完结」那一条与 ADR-99 边界 (c),收窄 ADR-96,补 ADR-99 决定 ④、ADR-83 决定 ⑤、ADR-71 决定 ⑩为了:「联调与发布门」这条需求。病根:此前机器只认一种状态 —— 全部版本单元封着才让云端写入。于是开发到一半要联调,就得先把施工中的单元封版,联调之后每改一行再封一次;ADR-99 给这件事起了名字(开发期联调上线)、加了「联调」一格,但只留痕,机器不认它。反过来,正式发布从不核这条需求验收完结没有 —— ADR-83 当时否决过「发布门要求已完结」,理由是业务需求要先发云函数用户才能验、两头互锁。发布登记这一侧另有三处不准:发布当时的记法会把在办需求的格记成「已发布」,之后内容再改也不与完结时的版本比;数据表与微信原生包没有入库台账,只能记「发布无记录」,带数据表或小程序端的需求永远翻不成「已发布」;只改业务代码的需求也要等治理站点发一次才算发完。谁定的:用户 10-12 在框架复盘里定了两样 —— 部署门认联调、正式发布核验收完结;业务需求不带治理站点格,数据表与微信原生包两格移出该发的格、写明在体系之外发。其余几样是办这条需求的会话替他拿的主意,写进计划由他签字确认:口径用短时标记加脚本开关、放行面就是落点表不另设登记、机器不核授权与会话身份、宪法那半句同批改。八个决定:① 部署门认联调。一次云端写入(或脚本发布)到了发布门,先判它是联调还是正式发布。联调成立要四样同时成立:有口径;那条需求在办(签过字、没完结、签字没作废、账本可信);这次要上线的全部东西都落在它签过字的落点表里;要上线的是云函数或数据表(静态站点没有联调)。缺一样就按正式发布判,并带一句联调为什么没成立;判不了一律拦。联调只放一道:发布前版本比对只放过这条需求落点表里的单元处于施工中,这些单元别的毛病(封后改了没加新的一版、锁清单坏了)照拦,别的单元照旧要封着且一致;待检清单、资损床、内核装配、上传内容核对一样不少。互锁因此解开 —— 验收之前要上线的走联调,正式发布就可以等验收完结。② 放行面就是签过字的落点表,不另设登记。云函数看函数目录下的源码文件有没有落在落点表的格里,数据表看表文档,站点看落点表里有没有目录写法够得着它的原料目录(站点只用在正式发布那一道)。与写前拦截、收尾对账是同一个范围口径:这条需求签过字能改的地方,就是它联调能上线的地方。③ 口径怎么给。云端工具通道没有命令行参数,靠体系守护技能的联调开始命令写一个短时标记(哪条需求、哪个会话开的、起于何时、有效 30 分钟;到期自动失效,也可以手动结束;同一条需求再开是续期,别的需求的标记还有效时开不了);脚本通道在发布命令上带需求名与联调两个开关,等价(带了就只认命令上那条需求、不读标记;没带而联调标记还有效的,同样照标记判)。30 分钟取的是一次联调动作的量:太短要反复重开,太长会把之后的正式发布误当联调。④ 正式发布核验收完结。没开联调、或联调没成立的那一次:要发的云函数目录或站点源码目录被任一在办需求(签过字、没完结;签字作废的也算在办)签过字的落点表盖住就拦,报文点名那条需求,并写明要联调就先跑联调开始。计划不见了也算在办:签过字、没完结的需求,它的机器镜像被写成空值、被删、整个计划目录没了、或只剩仓外镜像里那份账本时,从账本认它,照它签字时留底的目录算「在办需求的落点表」,照旧拦并点名它;一条留底都没有的判不了、按拦 —— 计划目录是写前拦截的免检面,往机器镜像里写一个空值不用开闸,只照计划目录里现有的计划认在办,正式发布就被一次编辑放出去了。守卫的部署门、云函数脚本出口、静态站点发布准备三处接同一个判定。静态站点的发布准备只在准备发布时核:跑床之前一次,打包发布档案之前再硬核一次(一律核);带着只验证或只装配看效果开关的那一次不往线上放东西,跑床之前那一次不拦、只打印一行说明 —— 手机端的需求封了版、还没验收时要先装配出来给用户亲手验,拦了就验不了、也就完结不了。数据表在正式发布这条路上不核这一道,照旧过待检清单与版本比对;回滚与清理不进这一道。⑤ 发布登记对得上完结时的那一版。发布当时只给已完结的需求记「已发布」,记下的是它完结时产的那一版;命中的需求还在办就不记已发布 —— 站点命中的什么都不记、也不进「联调」一格(静态站点没有联调),函数命中的只有落在这条需求签过字的落点表里的函数目录才记进「联调」一格,不在的不记(命中按站点名或业务域单元算,而没开闸时正式发布发得出去的东西必然不在任何在办需求的落点表里,命中就记的话记下的几乎全是别人的东西)。已完结的需求每次重算(守卫在记下完结的那一刻顺手重算一次),精确记下的版本与它完结时那一版不同即作废、记回「未发布」。联调放行的上传成功之后自动记「联调」一格,不再靠部署会话手跑:经云端工具的,守卫当场只往本会话台账记一笔,这一轮收尾时才把每一笔写进履历(一笔算一次,写出的文件在同一次收尾里被复核)—— 当场写的话,那份发布段文件是一处没有干净结论的改动,同一轮紧接着的第二次联调上传会被待检清单拦下,云端工具通道一轮就只能传一个函数;经脚本通道的,一条命令发完一批、上传成功之后当场记一次。⑥ 数据表与微信原生包在体系之外发。这两格记「在体系之外发」并写明在哪发(控制台、微信开发者工具),不算进该发的格;该发的格都发了才算已发布,一格该发的都没有的需求验收完结即已发布。宪法第六节第 8 条的那半句随之由「碰到的每一格」改成「该发的每一格」—— 意思没有变宽:体系内能发的格照旧每一格都要发,移出去的只是体系本来就发不了、也记不了的那两格。⑦ 只有业务域落点的需求不带「治理站点」一格。判法三样都成立才不推这一格:判单元时不算落点表里字面写 none 的行(不归任何版本单元的文件,最常见的是测试);去掉之后至少有一个单元、而且全是业务域;并且落点表没有碰治理站点自己的源码(x-harness/ 之下)。碰了站点源码的照旧带这一格;其余需求(落点表里有整个框架、系统规范域、项目架构、业务总览的,或一个版本单元都没有的)照旧每条都有。⑧ 版本比对的问题行带封版命令。发布前比对给出的每一行(判不了那一行除外)末尾带上那个单元的封版命令,三处报文原样打印同一个来源给的行,被拦的人不用再去查该跑哪一条。否决过:只改文档、写成「先封版再联调」靠纪律 —— 真实的业务需求联调之后每改一行都要再封一版,而且正式发布仍然没有闸;联调之前先登记要上线的函数与表 —— 多一道登记,签过字的落点表就是现成的名单。这一次不做的:让机器核「是不是用户授权的、是哪个会话在发」—— 机器认不出会话身份,授权是用户的一句话,做出来只会是假闸(与 ADR-99 否决栏同一条理由),照旧靠纪律;给数据表与微信原生包另造一套「已发布」的记法 —— 体系发不了、也记不了这两样,写明在哪发即可;边界 (n) 至 (q) 那四处(内核母本不算进云函数的放行面、治理站点不按它取材的受治文档核、建路由不在联调里、守卫取站点原料目录靠发布库)这一次不补,照实写进边界。与既有决策的关系:取代 ADR-83 否决栏里「发布门要求已完结(第二稿)」那一条 —— 当时否决的理由(业务需求要先发云函数用户才能验,两头互锁)由联调这条路解开。ADR-83 否决栏另两条的关系照实写:「发布那一刻读账本判签字作没作废(第三稿)」担心别的会话一改计划就把部署会话锁死 —— 这里发布那一刻确实要读需求的状态,但只为认哪些需求在办、它们的落点表盖住什么:签字作废的需求算在办,它盖住的东西正式发布本来就拦,多出来的后果只有它自己的联调不成立、重签之后恢复,不锁别的发布;「发布面按通道推单元」没有走 —— 判的不是这次发的归哪个单元,而是要发的目录被哪条在办需求签过字的落点表盖住,三条通道接同一个判定。取代 ADR-99 边界 (c)(联调做没做、登没登记机器不拦不催,机器也不拦验收之前的发布):联调成功自动记,验收之前的正式发布被拦。补 ADR-99 决定 ④ —— 「开发期联调上线」这个动作有了机器认得的口径,「碰到的格」改口成「该发的格」;ADR-99 否决栏「让机器核发布授权」不动,机器仍不核授权。收窄 ADR-96 —— 「发布登记给每条需求都推一格治理站点」改成只有业务域落点的需求不带。补 ADR-83 决定 ⑤(终点按格判)—— 数据表与微信原生包由记「发布无记录」改成移出该发的格,发布当时的精确记法收窄到只给已完结的需求、并与完结时那一版比。补 ADR-71 决定 ⑩(施工中开关的执行点:全量检测与发布不带)—— 正式发布照旧不放过施工中;联调时发布前比对只放过那条需求落点表里的单元施工中。旧条目不动。边界(守不到):(a) 机器只认有没有有效的联调口径:这一次是不是用户授权的、是哪个会话在发,不核。标记一份、全仓共用、谁都开得了 —— 别的会话误用标记,能让落点表里的函数绕过正式发布核完结那一道;兜着的只有一样:标记记着是哪个会话开的,凭它上线过的会话收尾时被点名一次(只说、不拦)。脚本通道的口径同理:经统一入口而没给两个开关时,外面带进来的同名环境变量不算数(入口把它清掉);直接跑云函数子入口或 bff 下两个入口时,手设那个环境变量等价于带了两个开关 —— 放不放仍由联调零件判。(b) 放行面是落点表:落点表写得宽(整目录),范围里没改的函数也按联调放过去 —— 那本来就是这条需求签过字的范围。(c) 云函数按「仓里同名函数目录此刻的文件」判:云端工具通道传上去的若是仓外的包,按 x-server 里同名的目录认;同名目录不止一个时两头取严的(联调要每一个都落在落点表里才成立,正式发布任一个被盖住就拦);找不到同名目录、上传目录又不在仓里的,联调成立不了,正式发布核完结这一道也拦不到它,后面还有上传内容核对兜着(没在仓里跑绿过测试的函数传不上去)。(d) 机器认的联调只有云函数上传、建表与改数据模型:静态站点没有联调;网关、云存储、数据读写这些其余的线上写入没有联调这条路、也不核验收完结,照原来的关口判。控制台里用户亲手做的导入与发布不经发布门,机器看不见、不自动记。(e) 正式发布核完结只管云函数与站点源码:数据表在这条路上不核;站点按落点表里的目录写法认,带通配的写法按字面前缀认、宁多拦不漏放 —— 落点写得宽的在办需求会把不相干的站点发布也拦住,要等它验收完结。(f) 标记有效 30 分钟:一次联调拖过了时限,之后的上传按正式发布判、被这条在办需求自己盖住而拦下,重开一次即可;反过来联调做完没结束,时限里落在这条需求落点表里的上传仍按联调判。(g) 联调自动记只是留痕:记不上不重试、只说一次并给出补记的命令(云端工具通道在收尾的附注里,脚本通道在脚本的输出里),不影响别的记账,也没有东西回头催;写前到写后之间标记正好到期的那一次不记;记的是函数目录与表文档的路径。经云端工具上线的要到这一轮收尾才写进履历:「联调」一格里的时刻是写进履历的时刻、不是上传的时刻(次数照上传的次数);会话没走到收尾就断了的,台账里有那一笔、履历里还没写,这个会话下一次收尾时补写,一直不再收尾就一直没写。脚本通道同一轮里紧接着再跑一次发布,会被它自己的先查部署门拦下(刚写出的发布段还没复核),要先结束这一轮 —— 与正式发布之后跑发布登记的现状相同;脚本通道的联调上传守卫认不出里面传了什么,本会话台账没有那一笔、收尾不点名,留痕只有发布脚本当场记的那一格。联调放行的那次云端工具调用,平台报成功而云端实际没成的,也会被记进「联调」一格 —— 机器只看得见工具返回了,不读返回里写的是成是败。(h) 发布登记与完结时那一版的比对只对发布当时精确记下、而且履历里有那个单元完结时版本的格起作用:按时间推的、已生效的格没有可比的版本;完结之前留下的精确记录要到完结后的第一次重算才判。(i) 只有业务域落点的需求不带「治理站点」一格之后,它的履历页与业务域文档在治理站点上要等下一次站点发布才更新,发布段不等它,守卫也不再为它点名「待发布」。(j) 开闸期间守卫写前那一道不在岗:经云端工具的上传写后只补判、记一笔,拦不回来;两条脚本出口的判定在脚本里,照常。(k) 架构详图抄的十态表与零件里的常量表一不一致,照旧没有机器对拍。(l) 计划不见了的在办需求(计划被删、被搬走,机器镜像读不成一个对象)从账本认得出、照留底的范围拦;看不见的只剩一种 —— 账本目录与仓外镜像两处都找不到它的签字记录,那时正式发布核完结这一道拦不到它盖过的函数与站点,收尾也点不了名。计划不在的需求联调开不了(联调开始与联调标记都只认计划目录里现有的计划),把计划恢复回来才办得下去;收尾照旧会点名它一次。计划不在时账本里的「已完结」照读到的算、不核那一笔可不可信:往账本目录里那一份直接添一笔假的已完结、再把机器镜像写坏,这一道看不见(计划还在时,同一种改法会被判成账本被改过、照拦)。(m) 签字作废的需求也算在办,照它最后一次签字时留底的范围算:它盖住的东西正式发布照拦,它自己的联调也不成立,重签之后才恢复(那一次签字没有留底的老签字只能照此刻的落点表算,作废之后把落点表改窄这一道就少拦;现在的签字都带留底);占着落点而不办了的需求,它盖住的函数与站点正式发布一直被拦 —— 今天没有「作废一条需求」这句话;删计划放得开同一块排队那一处,放不开这一道(计划不见了照留底算在办),只有等它验收完结(计划删掉了的先恢复回来)。(n) 内核不算进云函数的放行面:云函数按函数目录下的源码判,不算内核母本(x-core/server/sys)。只改内核的需求在办时,正式发任何函数这一道都不拦,而内核会装配进每个上传包(手机网页版的原料目录带着母本包,改母本包的在办需求拦得住网页版的发布;云函数这一侧拦不住,两边不对称)。(o) 治理站点的正文取材于 .claude 下的受治文档,这一道只按站点自己的源码目录(x-harness)核:只改受治文档的需求封了版、没验收完结时,站点照样发得出去(发上去的是封过版的文档);发布登记却认定这类需求有「治理站点」一格 —— 两处问的不是一回事:这一道问发不发得出去,那一格问它完结之后发过没有。(p) 建路由不在联调里:联调只认云函数上传、建表、改数据模型;经云端工具新建函数之后的建路由算其余变更,照全量版本比对判,本需求的单元施工中时会被拦 —— 所以开发期联调上线时新建函数走脚本通道(上传与配路由在同一条命令里),带需求名与联调两个开关。(q) 守卫这一侧取站点原料目录靠发布库与端名册:装不上时退到站点自己的顶层目录,手机网页版的母本包目录就核不到;发布准备那一侧直接调发布库,装不上就起不来。机制在架构详图 §八(环1「联调还是正式发布」、环3 需求对账里「部署门认联调」与「收尾单与治理站点一格」③)、§十三(第 4 关)、§十四(十态表)、§十五(角色表部署会话一行、「谁来发布、怎么授权」)、§十七(入口表业务需求一行)。
ADR-992026-10-12真相源拉通:四类需求走同一条需求流水线,改框架与改项目架构没有专属工作流;不拆框架版本单元;不建主控技能与主控执行体(能机器化的部分做成体系守护技能的 new 与 ask 两条命令);发布排在验收完结之后,开发期联调上线定成部署会话在用户单次授权下做的一个动作;一切线上写入都要用户单次授权、只在部署会话做,例外只有只发治理站点的需求凭验收完结那句话连带。订正架构详图此前「更新流程走元治理工作流」的写法,补 ADR-98、ADR-94、ADR-90、ADR-75为了:「真相源拉通」这条需求。病根:10-11 六路只读审计查出同一件事在宪法、架构详图、规则书、技能说明、执行体说明、治理站点里说法不一 —— 真相源之间互相矛盾的 22 处,执行体与技能说明过期的 15 处,有 4 块受治文件没有执行体认领;业务开发的工作流与需求闭环是两套平行的说法(编排器的阶段里没有签字、复盘、验收;发布排在验收之前还是之后三处说法不一;开发中途就把数据表与云函数推上线,与「只在部署会话发、验收之后发」直接冲突);宪法自己有几处写进了下层机制,违反它的边界一节。说法不一的后果不是难看:各会话读到哪一份就照哪一份做。五个决定:① 四类需求一条环。改项目架构、改框架、改系统规范、业务需求,在机器上走的本来就是同一条需求闭环(计划、两次签字、三查、独立复盘、封版前对账、履历、清理归档、收场是同一份代码),差别只有落点单元、顶层围栏、封版的测试前置三样;文档却只给业务与规范两类写了入口,改框架一处写「没有单独的流程」、一处写「走元治理工作流」。定成:四类同一条流水线,入口、谁写计划、执行体、封版命令、发布面合成一张表(架构详图 §十七);改框架与改项目架构没有专属工作流,封版用元治理的封版命令;两个封版入口转调同一个核心,元治理入口封全部版本单元、开发流入口只封业务两类,业务两类二选一、结果相同。② 不拆框架版本单元。整个框架只有一个版本单元,任何两条框架需求互相排队,审计把它列为缺口。不拆:拆要动单元名册、顶层围栏的路径预筛与对拍床,是改写版本契约;顶层需求串行的代价今天由「同一处的并成一条、小事连办、准备并行落地排队」吸收。排队真成了瓶颈再单独立需求。③ 不建主控技能与主控执行体。主控是会话的角色、不是执行体:它要和用户说话、要弹签字题,这两样执行体都做不了;协调者执行体此前已否决(与开发流成了两个编排者,架构详图 §十五 否决清单)。主控手上能机器化的两件事 —— 立一条需求时拷模板、填短名与档、给出派工底稿的固定部分,弹签字题之前把「签不签得了、排队、刷签字区」三样核完并给出可以直接贴的题目正文 —— 做成体系守护技能的 new 与 ask 两条命令,只读受治文件、只往计划目录写;握手、盯进度、排窗口、定档仍只能靠人。④ 发布排在验收完结之后;开发期联调上线另算。业务开发流的阶段图在封版之后直接接发布,而需求闭环写的是三查全绿且用户签字才算完结、之后才发。定成以项目架构为准:封版、独立复盘、验收完结,然后交部署会话发布;编排器的阶段提示、宪法的两张图、业务开发规则书照此改。开发中途确实要先把东西放上线才能联调的(建数据表、在控制台发布数据模型、联调时部署云函数),定成一个有名字的动作「开发期联调上线」:由部署会话在用户单次授权下做,记进需求履历发布段的「联调」一格(发布登记的程序加这一种格),不算正式发布,这条需求碰到的格在验收完结之后照旧要正式发一次才翻「已发布」。编排器原有的两处人机确认与全量检测之后的中断审核并进两次签字,不另算一次确认。⑤ 一切线上写入都要用户单次授权、只在部署会话做。角色表写的是全部发布都要授权,部署技能与业务开发规则书却只对前端与站点要求授权、云函数直接发。定成以角色表为准:云函数、数据表与数据模型、网关路由、静态站点的发布与线上资源的删除都算;线上删除由运维发布专家做,模块下线专家只删仓内文件。例外只有 ADR-98 定的那一种连带授权(只发治理站点的需求,用户签的「验收完结」那句话本身就算这一次站点发布的授权)。项目设置的拒绝名单同批加上命令行发布的几种写法,开闸期间多一层。同批的几处订正(都只改成已有的那一个正解,不立新说法):门数是六道、门四叫完结;「为了」一行短名打头;跑床的锁拿不到是排队等、缺省最多等 45 分钟;只有签字一可以打字说固定那句,签字二必须贴回带单子编号的结论;宪法里的「三层」改叫全部版本单元。宪法只留定性:它此前写进去的几处机制(签字区怎么签、内容编号、写前写后收尾各对照什么、封版前先查哪两项、计划的页签、一段带日期的迁移路线、开发流的委托关系、记账规则、别的会话在途告警的处置)收成一句定性加指向,落点列在架构详图 §四。架构详图加一张术语表(主控、主会话与领队、工作会话、办理会话、部署会话、执行体、环、收尾、收场、档、开闸与关闸、落点表与格、机器镜像),四块没人认领的写域各归一个执行体(架构详图 §十五),平台这一层的四条边界写进 §二(钩子超时等于放行、收尾钩子连拦八次后放行、会话之间的消息、队友与领队同一个会话号)。跨会话消息的收信策略不写进项目设置文件:平台只认项目文件里的扣留与拒绝,接受要写在用户设置里、由用户本人选。否决过:给改框架、改项目架构各立一个专属工作流(流水线已经是同一条,再立两个入口只多两份要对齐的说明);拆框架版本单元(见 ②);建主控技能或主控执行体(见 ③);让机器核发布授权(授权是用户的一句话,守卫看得见这句话、认不出它授的是哪一次发布,做出来只会是假闸);把开发期联调上线算成正式发布、让它翻发布格(验收之前内容还会改,翻了格就是假的「已发布」);反过来禁止验收之前的任何上线(数据表与云函数不上线,后台与小程序联调不了)。与既有决策的关系:订正架构详图 §十三 此前「更新流程走元治理工作流」的写法(没有单列过决策记录)。补 ADR-98 —— 连带授权之外,线上写入的范围写全。补 ADR-94 —— 部署会话那一行由「全部发布」写成「一切线上写入」。补 ADR-90 —— 会话身份怎么定写进宪法(主控由用户在窗口里定,工作会话与部署会话由主控握手时指定,机器只认办理会话与非办理会话)。补 ADR-75 —— 执行体按层那张表加项目架构一行与四块写域。旧条目不动。边界(守不到):(a) 入口表与术语表是指路,机器不核一条需求选对了哪一行、用对了哪个词;机器认的仍只有落点表里的单元名、办理会话与文件归哪个单元。(b) 发布授权没有机器核,部署门核的是没复核的改动、版本比对、发布前测试与上传档案;「只在部署会话发」是纪律,项目设置的拒绝名单只挡得住命令行里那几种直接的写法。(c) 开发期联调上线只留痕:「联调」一格不顶替任何一格的正式发布;联调做没做、做了登没登记,机器不拦也不催;机器也不拦验收之前的发布 —— 发布前版本比对不看需求有没有完结。(d) 框架仍是一个版本单元,顶层需求照旧串行。(e) new 与 ask 两条命令只做准备与核对,签字仍是用户亲手、题仍由主控弹。(f) 各处说法这一次改齐了,以后会不会再走样没有机器对拍;能抓的只有这一版加的两样 —— 五个技能的自测各有一条「说明对得上脚本」,体系守护自测里有一条在宪法、架构详图、规则书、技能说明与编排器里搜那几条旧说法。(g) 平台这一层的四条边界里,钩子超时、收尾钩子连拦上限、收信策略平台认哪几种,照平台官方文档写,本机没有实测;用户在自己的设置里选了哪一种收信策略,守卫读不到。表与机制在架构详图 §十七(术语表、四类需求入口表)、§十五(角色表、四块写域)、§十三(两个封版入口、更新流程)、§二(平台这一层的四条边界)、§四(宪法只留定性,机制各在哪)。
ADR-982026-10-11流水线提速:一条需求从签字到归档之间的机器节点由一条命令接力;删掉重复的重建、重跑、重签;收尾单五栏由机器起草;确认题可以一题签几条,只发治理站点的需求「验收完结」那句话连带这一次发布授权;验收单的编号不再随看板正文与范围外的改动变;部署门能先查;写前拦截按办理会话判,办理会话可以用一条命令改派;项目架构环定成十态,启动与收尾各有定义。四道墙不动。收窄 ADR-81,补 ADR-96、ADR-92、ADR-86、ADR-89、ADR-97、ADR-87,取代 ADR-94「不设登记」那一半、ADR-90「主控不起草计划正文」对顶层需求的那一半与 ADR-93 把验收列成全仓共用窗口的那一条为了:「流水线提速」这条需求。病根:用户 10-11 原话「整套项目架构处理一个需求的速度太慢了,就算修改一个小东西,都可能需要整个大流程全部跑完几个小时……是否有重复,重叠,冲突的流程节点,是否可以优化速度的地方!……我不考虑测试的规模和成本,我只要最优秀的项目架构的流程!」实测最小的一条小事从立项到发布要一个多小时,成条的事要四到九个小时。时间不在测试上,在节点之间:主控搬信、会话等人、同一件事重做。合并了哪些节点:① 实施之后到开出验收区的机器节点(增量检测、按改动跑床、规范同步、封版、固定检查、三查、生成复盘说明;复盘入账之后的三查、开验收区、起草收尾单)并成一条接力命令,只在派复盘处停一次。它只把现成的程序按次序叫起来,每一步的过与不过只认那个程序自己的结论,不复刻判法、不新增闸。七步的名字与次序照签过字的标准不动,但封版那一步自己先把固定检查的账备好 —— 封版命令的需求对账要第二查绿,第二查含登记的固定检查,不先备账,登记了固定检查的需求第一次必停在封版那一步。② 几条小事的需求确认并成一道多选题,每条各记一笔、各核各的;弹题之前先预判,选项的落点单元有重叠、或有一条此刻签不了,这道题直接弹不出来并点名;只有确认题合并,验收完结不做多选。③ 只发治理站点的需求,用户签的「验收完结」那句话本身就算这一次站点发布的授权:主控弹验收题时在题目正文里写明「并发布治理站点」,让他点之前看清;不要求他在那句话里另写(一键签的固定句里没有这几个字)。同一次发布捎带的其余已完结需求随发布登记翻格,不另要授权。签完主控把那句话原样转给部署会话,部署会话凭它即可发、不再另问。连带的仍是一次授权,只管这一次发布与它出问题时的回滚;不属于这一种的治理站点发布(那条需求还要发别的格,或不随哪条需求的验收完结而发)照旧要用户说出明确指令。④ 一条需求走到哪,原来散在几处账里,并成十个有名字的态,一条只读命令查得到;启动是守卫记下签字一那一笔并建出履历的那一刻,收尾是已发布与已归档两样都成立的那一刻。删了哪些重复:① 治理站点一条需求被重建多次 —— 规范同步与封版命令末尾不再顺带建,收尾环发现站点过期只提示、不拦也不建,只在发布处必建;构建器加一把仓库级的锁,谁改了源谁可以建,不再靠一条「只让一个会话建」的规矩。这把锁不另写,调测试运行器现成的那一份(拿法、放法、持锁进程在不在的判法只有一份)。② 封版自己写的变更历史与锁清单让固定检查的账过期、封完又跑一遍 —— 固定检查记账不计这两类文件。③ 复盘派出之后勾一步、填一格就要再派一轮 —— 复盘与验收单只绑签字锁住的内容与范围里的受治文件;复盘者对同一份任务说明收尾两次时,后一笔(守卫照旧记成不可信的那一笔)的任务说明编号与结论都与前面一笔可信结论相同,就记成重复、不计,也不算一轮复盘(结论不同的是改口不是重复,照旧按最后一笔判红);认法只住守卫一份,三查、「正在办」那一行、轮数上限、履历四处调它。④ 收尾单前三栏每条手写 —— 五栏全部机器起草,而且不等验收:复盘入账之后起草一次,验收完结、履历封死之后再跑一次;已有收尾单不整份重写,只刷新机器管的几处(开头写状态的那一句、第一栏的用时与「等用户验收」、第二栏新登记的行、第三栏照此刻的来源重排并保留办理会话改过的去向、第四栏与第五栏重填),办理会话写的别的字不动、只改错的那几行。⑤ 部署门到上传那一步才拦、回头重来 —— 发布命令加只读查询,各发布入口第一步先查,云函数脚本通道同样查;量工作树与定待检范围那两段从守卫主文件分成一个零件,守卫的收尾环、部署门与先查调同一份,判法不另抄。⑥ 会话号一换就要重存机器镜像、请用户重签 —— 改成一条改派命令。不动的四道墙:封版前相应测试对当前内容全过;发布不认旧记录、当场真跑,传上去的就是测过的那一份;发布查全站、没有例外名单;两次签字都是用户亲手,独立复盘不省、三查不摆给用户选。用户说了不考虑测试的规模与成本,所以省的全是节点之间的等与重做,没有一处是少查一样。为什么不做机器代签:两次签字是用户的权。机器代签了,就没有人为「这是不是我要的」「做出来的是不是它」负责;签字合并做到的是少点几次,不是不点 —— 多选题里每一条仍是用户自己勾的,连带授权用的是用户自己签的那句话、题目里写明了它连带什么。云函数、后台、手机网页版、官网的发布授权不并,仍在部署会话单次说:那几样一发就改线上业务,治理站点发的是文档。验收单的编号改口(推翻「需求闭环」那条需求定下的一条):那条需求 v4.4.3 定下「结果单编号含看板正文与范围外文件指纹」—— 改了范围外的文件,编号也要变、用户要重看(当时没有单列决策记录,写在架构详图里)。现在不进编号的一共六项:看板正文的指纹、步骤勾了几步、别的会话写的范围外改动、没有写证据的范围外改动、归别的需求范围的改动(别的在办需求的,或已完结需求交付的)、第三查里「不归任何版本单元的改动」那份名单;六项仍印在结果单上给人看,落盘的结果单里单独放一栏(进编号的事实另放一栏,守卫认「已完结的需求交付了哪些文件」时照编号的算法重算那一栏)。重复的那一笔复盘也不进编号。照旧进编号的:签字锁住的内容、范围里的受治文件、办理会话自己的范围外改动、床与固定检查的状态、各版本单元的封版状态、每一笔算数的复盘与「不过」、签字状态。为什么推翻:签过字的标准写的是「只有」改到签字锁住的内容与范围里的受治文件才作废;几条需求并行办时,别的会话在自己范围里正常干活,就把这一条已经开出的验收单作废掉、要用户重看重签,10-10 真仓发生过一次 —— 并行办得越多,互相误作废越多。守住的两道不动:验收那一刻守卫当场重算三查必须全绿;用户看的那张必须是绿的。范围外的改动此后由谁守:办理会话自己写的,收尾对账拦、第一查红;别的会话写的,归它自己的收尾对账与它那条需求的三查;没有写证据的,归收尾环的无主复核与部署门,其中改到某个版本单元里的,第三查照旧把那个单元列进来判(没封或封后动过就红)。验收因此不再是全仓共用的窗口:架构详图里「开闸、跑测试、验收、发布四个窗口由主控排」改成三个全仓共用的窗口(开闸、跑整面床、发布),验收只排同一处 —— 别的会话改别处不再让验收单作废,办理会话自己在那几分钟里别写文件。另四个取舍:① 写前拦截从「全仓有没有在办需求」改成「本会话是不是办理会话」,收尾对账只认本会话办理的范围 —— 此前只要有一条需求在办,任何会话都写得了受治文件,写进别人范围的改动永远不点名(10-11 六路只读审计查出)。本会话写进别的会话在办范围的改动,收尾拦一次、点名落进了谁的范围并记账;三查没有跟着收紧,照旧把这一类列在「归别的需求范围」一栏、不算越界。发布档案目录不受此限(部署会话平时不是办理会话,清作废的档案照放)。② 办理会话可以改派、不经用户重签。这推翻 ADR-94 里的一句:「按「计划是谁写的」认、不设登记……它骑在「确认」那一笔上,换办理会话必须经用户重签一次」。当时否决登记有三条理由:登记只能去被登记的那个会话里说、多一笔换会话要重登的状态、多一个不经签字就能改的口。第一条对改派不成立 —— 它是接手的会话自己跑的一条命令,不用用户过去说话;后两条照实认下,代价写在边界里。换来的是:换谁来办不改需求的内容,不必为一件用户判断不了的事请他再签一次(签的只是一个会话号),会话号一换也不必重存机器镜像。签字与改派谁在后听谁的:重签以新签那一笔认出来的为准,会盖掉此前的改派。改派不改历史、改动跟着需求走:改派那一笔不重写、不转移任何旧记录,此前的写证据归属不变;而范围里的改动,凡是办理过这条需求的会话(历次签字记下的、历次改派接手的)写的,封版与第三查都算这条需求的 —— 没补这一条之前,改派后旧办理会话在范围里没封的改动在新办理会话眼里是「别的会话」的:这条需求变成「没改到任何版本单元」,单元没封第三查照样绿(假绿),新办理会话也封不进去。现在封版挑保留旧指纹的改动、三查判动没动过手与单元归谁与落点格,问的是守卫的同一个判定器;重签换了办理会话、此刻内容是前一个办理会话写的,同样算。范围外的不认:旧会话的越界照旧记在旧会话名下、不让新的办理会话红。③ 每道选项题都核地址(题目正文里写了不带盘符的仓内相对路径就拦),弹题前认签字题的文法与答完之后认打字的合成一套 —— 此前一道没被核过地址的题能收到一笔真签字。④ 登记文件里指向整棵草稿目录或各会话共用那棵临时目录的行一律拒绝 —— 照此前的认法它合规,整棵删掉会连别人的东西一起删。规矩(靠纪律的那一半):顶层的需求由主控出设计与看板草稿,工作会话只补机器镜像与落地;主控派工之前告诉用户清哪几个会话、开哪几个、各叫什么;一个工作会话可以连办同一个版本单元上的小事,至多三条再清空;复盘与收尾单起草并行(起草不等验收);治理站点谁改了源谁可以建。否决过:把复盘做成可选、小事不复盘(复盘是今天唯一不靠办事者自觉的裁判,小事一轮只要十来分钟,省不出多少);机器代签、代授权(见上);机器自动派复盘者(复盘要一个干净的上下文,机器派不出「干净」;提示词仍是程序生成的说明);拆框架版本单元让顶层需求并行落地(动整套版本契约,这条已经够大,后放);在收尾环里就地重建站点(收尾环有总时限,全量重建撞上就把它拖超时,改成提示更稳);让接力命令自己判每一步过没过(判法两份必然漂);给构建器另写一把锁(同一件事两份实现);要用户在验收完结那句话里另写「并发布」才算授权(一键签的固定句里没有这几个字,他得改成打字,比点一下多一步)。与既有决策的关系:收窄 ADR-81 —— 复盘结论不再绑整份看板正文,标准与用例仍在签字锁住的内容里,改了照旧作废。推翻「需求闭环」那条需求 v4.4.3 的结果单编号口径(见上「验收单的编号改口」);那条需求的其余决定(ADR-73、ADR-74)不动。补 ADR-96 —— 收尾单由「前三栏留给办理会话写、只能在完结之后写」改成五栏机器起草、验收之前起草一次、完结之后再刷一次;它「卡在清理归档、机器只核在不在与全不全」照旧。补 ADR-92 —— 「一问只签一份计划的一道、必须单选」对确认题放开多选;「认不出的题不核地址」缩小成只不核看板地址,相对路径每道题都核。补 ADR-86 —— 一键签由一次一条放开到确认题一次几条,多选题里仍只认恰好等于固定写法的选项。补 ADR-89 —— 待检清单的判法没动,多了一个只读的查法,云函数脚本通道也查。补 ADR-97 —— 登记落到草稿目录本身时的提示改口,逐行核多两种着落。补 ADR-87 —— 固定检查的记账口径少算两类文件。取代 ADR-94「不设登记」那一半(见上「另四个取舍」②);它的定档、排队、顶层围栏、账按办理会话算都照旧。取代 ADR-90 的一条做法 ——「主控不起草计划正文」对顶层需求改成主控出看板草稿,业务需求照旧。取代 ADR-93 给 ADR-90 决策 ⑤ 加的那一样 —— 验收不再是全仓共用的窗口,回到 ADR-90 的三样(开闸、发布、跑整面床),验收只排同一处。另两处不是旧决策记录里的话、是架构详图与项目架构设计页此前写下的做法,同批改口:「派正式复盘之前看板不再动」那一个冻结点取消;ADR-96 提到的「会话什么时候清空」,对同一个单元上的小事放宽成可以连办。旧条目不动。边界(守不到):(a) 接力命令串的是机器节点,派复盘者与两次签字仍要人;它不排窗口;中途被掐断不会自己续。(b) 改派不经用户:任何会话跑那一条命令就成为办理会话,顶层围栏与写前拦截对「故意」不设防 —— 它防的是认错人、不是防人,留下的只有账本里那一笔;重签会盖掉此前的改派,认得不对要再跑一次;改派之后前任的范围外改动,新办理会话的三查守不到,只靠前任自己的收尾对账;前任交出去之前用命令行写的(没有写证据)分不出先后;「办理过这条需求的会话写的」封版与三查都只问守卫,守卫里没有那个函数时一个都不认、往不过的方向错。(c) 写前按办理会话判之后,办着一条需求的会话写别的需求范围里的业务文件,写前照放,只在写后提醒一句、收尾拦一次;三查不把这一类算越界。(d) 连带授权没有机器核:题目正文里写没写「并发布治理站点」、部署会话收到的是不是用户的原话,机器都不认。(e) 签字与问答:多选题「其他」里他打的字按最保守的拆法认,只有恰好等于某个选项固定写法的那几段算签;「每一份此刻签得了」只在多选时弹题之前当场现算,单选题照旧只比签字区的记号;相对路径那一样只认从仓库根下面第一层数起、指着真实存在的东西的写法。(f) 复盘之后看板上不在签字锁住内容里的文字改了不再作废,用户验收时看的可以与复盘者看的不同;用户看过验收单之后、点完结之前,有人用脚本(没有写证据)改了一个不归任何版本单元的范围外文件,以后不会再要求他重看;改到某个版本单元里的,第三查照旧把那个单元列进来判,完结照样记不成。(g) 站点过期只提示之后(传感器自己没跑成也只提示),改了源没建,本机产物旧一阵子,没有东西逼着建,发布处兜着线上;构建器的锁调的是测试运行器那一份代码,取不到运行器时站点建不了。这把锁判持锁的还在不在只看进程号;两个构建同一刻接手同一把旧锁有一道窄缝;锁只管一次构建,发布流程里构建、验收、备档案三步之间没有锁;各会话要用同一个系统临时目录才排得上队;被硬结束的构建来不及放锁,靠持锁进程不在即失效兜。(h) 先查部署门只查到跑的那一刻,墙仍是上传那一步守卫的部署门;云函数脚本通道从此照全仓数,仓里有任何没复核的改动就发不出去;「第一步在场」没有规范的闸守、只有床守;一次发两个手机端时先查按两端合起来数,守卫按每次上传各数各的。(i) 连办几条、验收完结之后收尾单刷没刷、派工前说没说清,机器都不数。(j) 十态只读、判错只会误导看的人,不拦任何东西;架构详图抄的那张十态表与零件里的常量表一不一致,没有机器对拍。(k) 登记仓外目录认 PowerShell 的同义动词,只对命令行里包着 powershell 的写法起作用,而且只在开闸期间(写前拦截在岗时那种写法本来就被拦);平台的 PowerShell 工具没接进钩子接线,经它直接建的仓外目录仍不登记,要接进去得改接线文件、归用户定;cmd 包着的建目录、目标带变量或由表达式算出来的同样不认。(l) 八条规矩各靠什么照实写在架构详图那张表里:整条靠机器的只有「几条小事可以一题签」;一半靠机器的三条(工作会话补机器镜像 —— 签字那一刻认办理会话、认错了可以改派;复盘与收尾单起草并行 —— 第一次起草是接力命令调的;治理站点谁改谁建 —— 构建器的锁管不撞车);其余靠纪律 —— 主控出没出看板草稿、派工前说没说清、一个会话连办了几条、验收完结之后收尾单刷没刷、改了源建没建、题目正文里写没写「并发布治理站点」,机器都不数、都不拦。规矩的明文与机器是同一版落的:十态表的下一步、守卫「待发布」那一行、清理归档末尾与收尾单第四栏那一句,与架构详图 §十五 写的是同一套话;宪法第四节「运作方式」只加了一句定性的话,数字与机制都不进宪法;授权的条款在部署规范。机制在架构详图 §八(接力命令、环的十态、写前按办理会话判、办理会话改派、一题签几条与每道题都核地址、复盘之后看板的状态列可以动)、§九(谁建站点与什么时候建、发布之前先只读查部署门)、§十四(十态表)、§十五(提速的八条规矩,各写明今天靠机器还是靠纪律)。
ADR-972026-10-10清理归档硬控:仓库外面建的临时目录由守卫在建的那一刻自动记进在办需求的登记文件(登记到会话草稿目录下的第一层);清理归档搬之前逐行核登记文件,有一行没着落就整条拒绝,要保留的写进收尾单第二栏;仓里有已完结还没清理归档的需求时,新的需求第一次签「确认」签不上(流水线的第六道门「收场」);测试临时目录不登记,由唯一运行器每跑完一轮自己清。补 ADR-95「没做的只提醒、不拦」与「仓外临时目录靠登记、登记全不全靠规矩」两处为了:「清理归档硬控」这条需求。病根:用户 10-10 原话「为什么没有门啊!清理归档竟然没有硬控?…难道现在是可以清理也可以不清理?逻辑上在项目构建的时候构建了多少东西应该是在plan中很清晰记录的,最后收尾的时候也要按照这个清单去吧哪些临时目录和临时文件清理掉来一一核对啊!」ADR-95 把清理归档定成「一个环节、不是一道门,没做的只提醒」,仓外临时目录靠办理会话自己往登记文件里记一行、登记全不全没有机器核,登记文件里不合规的行只是被跳过、计划照搬。于是三处都靠自觉:记不记、清不清、收不收场。五个取舍:① 登记交给守卫,登记到草稿目录下第一层。建目录、抄副本、写文件都经工具调用,守卫在写后那一刻看得见落点,比让人事后回忆可靠;一份仓外副本常常是一棵几十层的目录,逐层登记会把登记文件写成流水账,所以落在会话草稿目录之下的只登记草稿目录下的第一层(草稿目录是这个会话自己的,整份清掉不会碰到别人)。草稿目录之外只登记落点本身、不往上取层:系统临时目录是整台电脑共用的,往上取一层可能记进别的程序的目录,清理归档会把它整个删掉。不是办理会话的会话不登记也不提示:主控、复盘者往草稿目录里写东西很平常,每次都提示会把回话淹掉。挂在写后这一支而不是写前:写前拦截摘下期间它照常在岗。② 测试临时目录不登记,改成运行器自己清。登记文件只管仓库外面的目录,仓里测试根下的沙箱记进去会被清理归档按规矩拒绝;而这一类按名字加进程号认得全,清理归档今天就是这么认的。让唯一运行器每跑完一轮调同一份认法顺手清,比登记更硬,也不必等有人跑清理归档。③ 逐行核放在搬之前,一行没着落就整条拒绝。此前不合规的行只是被跳过、计划照搬 —— 搬走之后登记文件随计划进了归档,那一行再没有人看。放在搬之前、什么都不动地拒绝,办理会话才不得不回头处置那一行。已经搬进归档的重跑不再拦:计划已经搬走,拦也回不去,只逐行拒绝、其余照清。④ 要保留的写进收尾单第二栏,不另开文件、不在登记文件里打标记。保留本来就是「没做什么、为什么」的一种,收尾单会由主控转给用户看,理由因此到得了用户眼前;登记文件保持「只追加、一行一个路径」,机器与人都好读。写法只有一种(单独一行,路径与登记的是同一个,理由不能空),写错了命令会点名那一行没着落。⑤ 收场这一道只拦新的需求第一次签确认。压力要落在该收场的那一刻,又不能让别人没收场把正在办的卡死,所以与同一块排队「重签自己已经占着的不查」同款:已经签过确认的重签不拦;封版、发布、在办需求的写也不拦。它与定档、同一块排队放在同一个函数里出同一段话,签字那一刻的回话、看板签字区、排队一览三处因此不会各说各话。否决过:让运行器把测试造的沙箱登记进在办需求的登记文件(见 ②);给每张测试换一个专用的临时目录、跑完整个删掉(要改五十多张测试的运行环境、动运行器的判定口径区,为清几个跑挂的沙箱不值得);对比跑测试前后系统临时目录里多出了什么、多出来的都登记(系统临时目录是整台电脑共用的,记错一行清理归档就会删掉别人的东西);没清理归档就不许封版、不许发布、不许在办的需求继续写(拦得太宽);草稿目录之外的落点也往上取到系统临时目录下的第一层来登记(见 ①)。边界(守不到):脚本在运行中自己建的目录守卫看不见,测试跑挂留在系统临时目录里的沙箱没有人清;签字之前建的仓外目录不自动登记;命令里带变量、通配或反引号的路径认不出,解压、克隆、重定向新建文件这些别的建法不认;登记文件本身被手改机器不核,保留的理由写得对不对不判;一条已完结的需求一直没人收场会把后面所有新需求卡住,出路是任何会话都可以替它写收尾单、跑清理归档;运行器只清测试根下名字带进程号的那一类。落地时办理会话的落地脚本在闸关着的时候改了受写保护的测试运行器(脚本进程里的写绕过写前拦截,是既有的边界),如实记在这一版的变更历史里,要不要补一道事后的核对归守卫盘点。机制在架构详图 §八「清理归档硬控」。
ADR-962026-10-10收尾单与治理站点一格:验收完结之后、清理归档之前,办理会话写一份固定五栏的收尾单,清理归档的命令认不到它或缺栏就不搬;发布登记给每条需求都推一格「治理站点」,站点在这条需求完结之后发过一次才算已发布,没发的由守卫每次回话点名。补 ADR-95「清理归档只要求三样」与 ADR-83「框架、规范、项目架构落盘即生效」两处为了:「收尾与站点格」这条需求。病根:两处断着。一、一条需求验收完结之后,办它的会话只是停下 —— 做成了什么、没做什么、遗留去了哪、链接在哪,没有固定的地方写,也没有固定的话说给用户;ADR-95 的清理归档只核「已完结、账本没被直接改过、履历已封死」三样就把计划搬走,会话的结尾是空的。二、ADR-83 把框架、规范、项目架构记成「落盘即生效、没有发布这一步」,于是只碰这几类的需求一完结就显示已发布;可它的履历与它改到的受治文档都要治理站点重建、发布之后线上才看得到,站点在它之后发没发没有任何一处记、也没有任何一处提醒,攒不攒、什么时候发全凭主控记着。用户 10-10 上午:「最后你在会话里面也就是主控和分身竟然没有结尾的标志?比如会话1,在结束之后应该有一个正式的收尾……最后可能需要deploy来更新和发布harness,否则正式线上版本就会丢失掉你的这个计划啊,而且貌似这一环是断的,永远没有项目框架的历史记录的更新和部署这个环节啊!」决策:① 收尾单是一份文件 —— 住这条需求的计划目录里、文件名固定、固定五栏(做成了什么 / 没做什么、为什么 / 遗留与去向 / 要发的格与此刻状态 / 链接),各占一行二级标题;随计划一起搬进归档。先后是:验收完结 → 办理会话把遗留清单发主控 → 主控逐条回去向 → 办理会话写收尾单 → 主控把原文转给用户 → 清理归档。② 卡在清理归档这一步 —— 清理归档的命令带需求名时(预览与执行一样)在原有三样之后多核这一样:计划还留在计划目录、里面认不到收尾单,或五栏里有哪一栏的标题没有、标题下面是空的(只有空白或注释也算空),就拒绝并点名,不搬也不清。已经搬进归档的重跑、计划两边都不在的旧需求、存量那一支不查。③ 机器只核在不在、五栏全不全,不判写得对不对。④ 由一条命令起草 —— 同一个动作多一个起草开关:第四栏(要发的格与此刻状态)由机器填,照落点表里的单元现算碰了哪几格、当场重算这条需求的发布段逐格写状态,重算做不成的写「待登记」;第五栏(链接)由机器填,其中这条需求产的各版本从各单元封版时记下的需求那一行反查、不从看板抄;前三栏只留写法提示的注释,所以草稿原样拿去清理归档会被拒绝。已有收尾单时不覆盖。⑤ 五栏的名字与认法只住守卫的需求零件里一份,清理归档的命令从那里取用。⑥ 治理站点是一格 —— 发布登记给每一条需求都推这一格(落点表碰到治理站点源码的也只有这一格)。只有一种判法:入库的发布台账里最后一条治理站点「已上线」的记录,它的发布号所记的时刻(到秒)晚于这条需求的完结时刻才是已发布;发布号读不出时刻的那一行按台账时间(到分)比;没完结、没有上线记录、不晚于完结都是未发布。两边换成同一个绝对时刻再比。发布当时带站点名跑的那种记法对这一格同样只按台账判。⑦ 清理归档执行到末尾重算这条需求的发布段并打印;发布登记在状态与各格都没变时不重写发布段文件。⑧ 三处提醒,都只提醒、不拦 —— 验收完结那句回话在清理归档的命令之前写明先把遗留发主控、起草并写全收尾单;「待清理归档」那一行在认不到收尾单时多半句还没写、缺栏时点名缺哪几栏;新加一行「待发布」:用户每说一句话,守卫读各条需求的发布段,把状态已完结而治理站点那一格还没发的合成一行点名(最多列八条短名),写明站点的发布归部署会话、要用户单次授权。主线顺序不变:需求 → 实现 → 测试 → 部署 → 清理归档;治理站点这一格归清理归档的末尾(更新历史记录并发布),业务的格仍归部署。会话什么时候清空(收尾单发出、清理归档跑完、站点那一格翻成已发布之后)是纪律,写进项目架构设计页。宪法不改 —— 第六节第 8 条已写着每一格都发了才算已发布。为什么这样定:卡在清理归档而不卡验收 —— 收尾单要对着验收的结果写,只能在完结之后;清理归档是完结之后第一道由命令把关的地方,计划搬不走就一直被「待清理归档」点着。只核在不在与全不全 —— 写得对不对是语义,机器判不了;硬判只会逼人为了过检查而写,对不对由主控把关、用户看原文。第四、五栏由机器填 —— 碰了哪几格、各是什么状态、版本在哪,都是算得出来的事实,手抄必错(第一份真样本就碰到发布段还是空的、只能手写);做成了什么、没做什么、遗留去哪只有办它的会话与主控说得清。每条需求都推一格、不按落点表逐类判 —— 每条需求的履历本身就要随站点上线,按类判只会漏。按发布号的时刻、不按台账时间 —— 站点是在发布号那一刻打包的,台账时间是上线那一刻(只到分);卡在打包与上线之间完结的需求,包里没有它,按台账时间会判成发过。发布当时的记法不参与 —— 那种记法取的是跑登记的那一刻,在办的需求会被它翻掉,完结之后就再也翻不回来。点名合成一行 —— 站点可以攒着发,攒到七八条时每条一行会把回话淹掉。守卫读发布段小文件、不另存一份名单 —— 少一份会漂的派生件;代价是需求多了变慢(实测 25 条约 7 毫秒、300 条约 85 毫秒),到那时再改成由发布登记顺手写名单。发布段没变不重写 —— 它是治理站点的源文件,白写一次会让站点显得过期。否决:(1)让机器判收尾单写得对不对(逐条核标准)—— 见上。(2)没写收尾单就不许验收完结 —— 次序反了,收尾单写的就是验收的结果。(3)站点没发就不许清理归档、不许签下一条 —— 站点可以攒着发,硬拦会让每条需求都等一次发布;ADR-95 否决(2)的理由照旧。(4)由守卫在完结那一刻替办理会话写收尾单 —— 钩子只填得了机器算得出的两栏;把写文件塞进签字路径的坏处见 ADR-95 否决(1)。与既有决策的关系:补 ADR-95 —— 它的「机器只要求三样」对带需求名的预览与执行变成四样(多收尾单),存量那一支与已归档的重跑不变;它的三处提醒里两处改口、另加一行;它说清理归档「不动履历」照旧,但执行到末尾会重算发布段(发布段不是封死的履历的一部分)。补 ADR-83 —— 「框架、规范、项目架构一格已生效」照旧,另加每条需求的治理站点一格,所以只碰这几类的需求不再一完结就翻已发布;它「落点表碰到治理站点源码加一格、按完结时刻比」并进这一格,判法由台账时间改成发布号的时刻。ADR-93 的「每次回话列进度」列的是在办的,这一行列的是已完结的,互不挤掉;它立的「零件用到才装」这次照守 —— 说话这条路不装履历零件,读发布段的目录守卫自己记一份、由测试对拍。旧条目不动。守不到(照实写,不许读成「从此每条需求都有一份写对了的收尾、线上站点一定是新的」):(a) 收尾单写得对不对、主控转没转给用户、会话清没清空,机器都不核。(b) 收尾单不进履历(履历在它之前已封死),随计划进归档;治理站点不收计划目录,站点上看不到它。(c) 治理站点这一格只按发布台账判 —— 站点回滚到更早的一版、台账被直接改过,它看不见;发布号读不出时刻时退到台账时间,卡在打包与上线之间完结的那种情形就分不出来。(d) 站点页面上这一格显示的是构建那一刻的状态:站点发出去那一刻它还没翻,登记之后翻了,页面要到下一次发布才显示已发布 —— 比登记慢一拍。(e) 「待发布」读的是发布段文件:一条需求完结之后既没清理归档、也没人跑过发布登记,它的发布段还是旧的,这时它由「待清理归档」那一行点着;计划若被脚本进程内删掉(不是搬进归档),两行都不点它,要等有人跑一次发布登记。点名只在用户说话时出现,是守卫回给当场那个会话的话。(f) 发布脚本发完站点之后还不会自动跑发布登记,要部署会话手跑;忘了跑,点名不会消失。(g) 站点发没发、什么时候发,机器只提醒、不拦。(h) 已经搬进归档、当时没有收尾单的计划不回头查。
ADR-952026-10-09清理归档:已完结的计划不再删 —— 由体系守护的一条命令整份搬进计划目录之下按日期分的归档目录,同一条命令清掉这条需求留下的过程文件、登记过的仓外临时目录与进程已不在的测试临时目录;计划目录下的任何一份,命令行都删不了、挪不走;没清理归档的只提醒、不拦。取代 ADR-73「计划做完固化进架构然后删」与 ADR-83「计划照删」「计划留着当档案不推翻」为了:「清理归档」这条需求。病根:ADR-73 定的是「计划做完固化进架构然后删」,ADR-83 立需求履历时把这一句留着(「计划照删」)。照它跑下来,两头正好反了。该留的没留 —— 此前完结的每一条需求,看板都按流程删了,留下的只有履历里的摘要:设计图、步骤、否决过的备选、要用户亲手验的清单当时是怎么写的,翻不到了。该清的没清 —— 没有任何一步负责收拾一条需求留下的过程文件:账本目录里的复盘任务说明、固定检查的输出、结果单的可读版、签字基线攒了一百多个(签字基线一份就几百 KB),各会话在仓库外面临时区里的副本、测试床留在测试根下的临时目录也没人清。用户 10-09 夜:「为什么会有残留呢?逻辑上应该是归档啊!意思就是项目架构应该部署之后的环节就是清理和归档啊!就是过程文件,测试文件等都要清理,计划文件应该要在……目录里面构建一个类似 plan-bak 的目录存放所有的历史计划,而且都要以日期归类」。决策:① 删改成搬 —— 流水线在部署之后多一个环节,叫清理归档:已完结的计划整份搬进计划目录之下的归档目录,放在「完结那一笔的本机日期(年-月-日)」再下一层「需求名」里。只用一次目录改名,不做复制再删;搬完之后里面的文件逐个与搬之前相同、修改时间不变;改名失败原样报错,源与归档目录都和跑之前一样。它是一个环节,不是一道门,也不是需求的一个状态:不往任何账本记、不动履历。② 由一条命令做,不由钩子做 —— 体系守护命令多一个动作 wrapup:只带动作名是只读盘点(已完结还留在计划目录的计划、账本目录里已完结需求还留着的过程文件、进程已不在的测试临时目录);带需求名是预览(将搬什么、将清什么、哪些会被拒绝,什么都不动);带需求名与执行开关才真做。需求名只认计划的目录名,不认短名。结果不认是哪个会话跑的。可以重跑:判归档里有没有它,是到归档目录下逐个日期里找同名的,不只看算出来的那一天 —— 源已不在而某一天下面有,报已归档、接着清;两边都在,拒绝,不覆盖、不合并、也不清;两边都不在(这条规矩之前就删掉了计划的旧需求),报没有可搬的、照样清。③ 机器只要求三样 —— 账本没被直接改过、这条需求的账本里记了已完结、需求履历已封死;缺一样就拒绝并写明缺哪样,什么都不动。不等发布:没有东西要发、或攒着以后发的,验收后直接清;验收、发布、清理归档的先后由主控排。④ 同一条命令接着清三处,每清一样打印一行 —— 一、账本目录里这条需求的过程文件,按「需求名加固定后缀」逐个认、不按前缀:复盘任务说明两份、复盘说明留档、固定检查的结果与输出、结果单的可读版、签字基线,名字前缀相近的另一条需求的文件一个不少。二、这份计划的登记文件里列的仓外临时目录(一行一个绝对路径):按真实位置算在系统临时目录之下、而且不在仓内的才删,不合的那一行拒绝并点名、其余照办;删的时候遇到目录联接或符号链接只解开这一个链接,不进去删它指向的东西。三、测试根下名字以进程号结尾的测试临时目录:那个进程已不在的才删,还在的不动;这一处不分是哪条需求留下的。⑤ 一律不碰 —— 账本本体、最后那张结果单的机器版、原话账本、没签字账本、仓外镜像、会话台账、任何测试目录下长期守着代码的测试。清完之后这条需求的账本完整性照旧为真,计划名单里不再有它,收尾对账仍认它验收时交付的文件。⑥ 签字基线只清仓内那一份,仓外镜像里的那一份留着。⑦ 仓外的临时目录靠登记 —— 计划目录里一个固定名字的登记文件,每建一处追加一行,随计划一起归档;不放进机器镜像。⑧ 计划目录下的任何一份,命令行都删不了、挪不走 —— 凡已经接到「能不能删计划」这一处判定的命令(rm、rimraf、del、unlink、git rm、mv、git mv、带路径的 git stash push)一律拦。已完结那一支由放改拦,回话写明已完结的计划不删、用清理归档的命令搬进归档,并给出带着这条需求名字的命令;目标落在归档目录里的,回话写明归档的计划不删不挪,不再把归档目录的名字当成一份没签字的计划来回话;其余各支(签过字没完结、没签字、账本被改过、已完结但履历没封死)照旧拦,回话里「之后再删」改成「之后再清理归档」。⑨ 三处提醒,都只提醒、不拦 —— 验收完结那句回话不再说这份计划可以删了,改成给出清理归档的命令(带着这条需求的名字与执行开关);用户每说一句话,守卫对每一份已完结、还留在计划目录的计划各出一行,以「【待清理归档】」打头、带短名与那条命令,排在「正在办」那几句之后,搬走之后这一行消失,点名这件事不往任何账本记(用户原话照旧记);发布登记打印状态时,已完结而计划还留在计划目录的需求,那一行末尾带一句还没清理归档与那条命令,已经搬走的不带,写出的发布段文件不变。⑩ 存量的历史材料(计划目录下没有账本、也没有机器镜像的旧目录或散文件)走命令的另一支 —— 点名并给出日期才搬,只搬不清;点的那一项有机器镜像或有账本就拒绝。这一次只做出这一支,不拿它搬东西。⑪ 叫法 —— 新环节叫「清理归档」;此前各处指「封履历」的「归档」改叫「封存履历」;「存档点」仍指提交,不动。宪法只写定性的一句:计划归档、不删,过程文件清掉,长期守着代码的测试不动;目录叫什么、哪条命令、谁跑,在架构详图 §八「清理归档」与项目架构设计页。项目架构设计页升哪一位的规矩同批补三个字:流水线加减一个状态或环节、加减一道门,升第一位。为什么这样定:搬而不删 —— 看板是这条需求当时怎么想、怎么验的原件,履历只收了摘要;删掉之后要回头看只剩摘要。留下它不等于多一份真相源:归档进去的计划不再维护,真相源照旧不引它(宪法 §六.5 那一条的方向不变,「闭环即删」换成「闭环即归档挪走」,引它照样是死链),长期的结论照旧固化进架构。放在计划目录之下、不另立顶层目录 —— 用户点的就是这里;计划目录本来就是需求对账的免检面,存档点提醒也不把它里面的改动算作还没存档的改动,搬进去不惊动任何一道门。用命令、不用钩子,只要求已完结、不等发布 —— 见否决(1)(2);计划只是换了地方,履历与账本都在,发布不读计划。改名而不是复制再删 —— 改名要么成、要么原样不动。到归档目录下逐个日期里找、不只看算出来的那一天 —— 完结之后换过时区,算出来的日期会变,已经归档的那一份不能因此认不出来、又搬出第二份。按「需求名加固定后缀」逐个认 —— 仓里就有名字前缀相近的两条需求,按前缀会删到别人的。账本本体与结果单的机器版为什么留 —— 账本本体带链、仓外有镜像,少了它守卫判成账本被改过,全仓受治文件的写入被拦;结果单的机器版完结之后守卫还读它,用来认「这正是验收那一刻交付的内容」(ADR-88),删了,封版命令写出的变更历史与锁清单会被重新判成越界。签字基线为什么可以清、为什么只清仓内那一份 —— 读它的只有两处(收尾对账与三查),都只对在办或签字作废的需求算,已完结并搬走的计划没有任何一处再读;万一有没查到的读者,它会照实报签字基线不见了,镜像里有原件,放回去即可。仓外目录靠登记、不按名字猜 —— 仓外目录的名字是各会话自己起的,猜要么漏、要么删到别人的;只删系统临时目录之下、不在仓内的,是因为登记文件是手写的,写错一行不能删到仓里或别处。遇到链接只解开 —— 仓外副本里常放着指回真仓的目录联接,跟进去删就删到真仓。已完结那一支由放改拦 —— 留着「放」,一条 rm 就把刚说要留的东西删了。只提醒、不拦 —— 没清理归档不妨碍任何一道门:计划只是还留在原处,履历已封、账本都在;要有人跑,忘了就留在原处,靠验收回话给命令、每次说话点名兜住。日期取本机日期 —— 按日期分是给人翻的;履历里的时刻按协调世界时写,凌晨完结的两处会差一天,以本机日期为准。否决:(1)钩子在验收完结那一刻自动搬 —— 把目录改名塞进最要紧的签字路径:Windows 上有文件被占用就会失败,连带签字出岔子;而且钩子清不了仓库外的副本。(2)等发布登记翻成「已发布」那一刻再搬 —— 框架、规范、项目架构这几类没有发布这一步;微信包、云函数、数据表今天记的是「发布无记录」,永远翻不了;攒着发的要等很久。同理不让机器卡「发布了才准清理归档」。(3)先复制过去、再删原处 —— 中途失败会留下两份或半份。(4)清账本目录时按名字前缀匹配 —— 会删到名字前缀相近的另一条需求。(5)给此前已经删掉的旧计划在归档目录里补空位 —— 等于造一份没有内容的记录;它们的摘要在需求履历里按日期查得到。与既有决策的关系:取代 ADR-73 标题里「计划做完固化进架构然后删」与验证栏里「完结后删」讲的去向;它决策 ④「签过字没完结的计划目录不准经命令删」照旧,并扩到计划目录下的任何一份。取代 ADR-83 两处:否决栏里「计划留着当档案(09-29 用户亲自否,不推翻)」,与「与 ADR-73 的关系」里「计划照删;『删除是对的』保留」—— 09-29 用户否的是把计划留下来当档案,10-09 夜他亲口改成计划归档、不删,后一次取代前一次。ADR-73 当时的理由「永远只有一份的是业务架构」照旧成立:归档的计划不是第二份真相源,见上「搬而不删」。ADR-83 其余不变 —— 履历仍是钩子一次写成的封存记录,封死的规矩不变;删计划那颗闸的前置「履历已封」保留,变的是封了之后的去向(由放改拦、给命令)。ADR-83 里把封履历叫「归档」的地方,文档同批改叫「封存履历」;账本里回填时补的那一笔照旧叫归档笔,事件名没改,它与清理归档无关。ADR-88 靠的那张结果单的机器版,这一次明写留着,判法不变。ADR-87「固定检查的清单与脚本随计划归档」这一次成了字面上的事:它们跟着计划一起搬进归档,落在账本目录里的结果与输出清掉。ADR-77 顺带补的那一条(已完结需求的范围从账本取、计划目录没了也认)照旧兜着:搬走之后计划目录下同样没有它。ADR-93 的存档点提醒不受影响(归档目录在计划目录之下);它「每次回话列进度」列的是在办的,这一次的点名列的是已完结还留在计划目录的,两样同时在场、互不挤掉。「定档排队主控签」那一条决策(ADR-94)里说的「照现成的删计划那条路放开」,指的是签过字没完结、又不办了的需求,这一条不改它 —— 没完结的计划清理归档不收,那条路照旧。旧条目不动。守不到(照实写,不许读成「从此没有残留、计划丢不了」):(a) 脚本进程内删计划拦不住 —— 那颗闸只挡命令行的直写形态,换目录、变量展开、find -exec 这类写法照旧拦不住,闸开着期间它不在岗(验收回话与每次回话点名照常)。已完结的计划若被脚本进程内删掉(不是搬进归档),没有任何一处点名:收尾点名只管签过字没完结的,三处提醒也跟着消失 —— 它们只看计划还在不在计划目录,分不出是搬走了还是删掉了;唯一还看得见痕迹的是清理归档命令的只读盘点,要人去跑。(b) 归档进去的文件命令行删不了、挪不走,但编辑工具与脚本仍改得了;归档进去的看板不在看板规范那四颗闸的射程里,改坏了没有检测会报。(c) 仓外临时目录靠登记 —— 没登记的清不到,留在系统临时目录里;登记了、但不在系统临时目录之下的那一行被拒绝,也清不到;计划早先就删掉的旧需求没有登记文件可读,同样清不到;登记全不全没有机器核。(d) 搬过去的文件没有写证据 —— 改名不经编辑工具,它们在新位置上算无主的改动,要等一轮收尾查过才有干净结论(文件多的要分几轮);这之前,待检范围含着它们的云端写会被部署门拦。计划目录不在需求对账的范围里,不会被判成越界。(e) 清理归档靠人跑 —— 机器只提醒、不拦,忘了计划就留在原处、过程文件照旧攒着;点名只在用户说话时出现,新开会话那一刻的开场清单不点名已完结待清理的,要等用户说第一句话才点;它是守卫回给当场那个会话的话,用户看不看得到取决于执行者转述,验收完结那句回话同理;先后也不由机器管 —— 机器只要求已完结,发没发、该不该先发由主控排。(f) git mv 与带路径的 git stash push 拦是拦的,但回的只是一句通用的话,不带清理归档的命令。(g) 清理归档的命令本身不在守卫的写保护名单里(同目录的三查核对命令与复盘说明程序在名单里,它不在):把它清的名单改宽,写前没有东西拦,守着它的只有它的测试床;而它删的账本目录是写保护的 —— 它在脚本进程内删,守卫看不见。(h) 这一次没办的 —— 存量没有搬(计划目录里的历史材料、此前完结的需求留在账本目录里的过程文件、各会话留在仓外的副本),命令做好之后由主控另排;治理规范条款书里「闭环即删」的措辞属于另一个版本单元,没改;需求履历里把计划路径替换成的那句占位仍写着完结后删、回填说明里仍写着计划已删,没改(改它要动已经封死的履历的生成口径);此前已经删掉的旧计划不补。
ADR-942026-10-09定档、排队、只在主控签字:签「确认」那一刻按计划定的档(小事、成条的事、难事)核条数上限,超了签不上;同一个版本单元上已有别的需求占着,后来的那一条签不上,谁占着、谁排着一条只读命令看得见;办得超了这一档的用时或复盘轮数只点名、不拦;签字那一笔记下办理会话(按「计划是谁写的」认),三查、封版前的对账、越界都按它算,交给工作会话办的需求两次签字都能在主控签;落点格认办理会话签字后的写证据;写前多一道顶层围栏 —— 整个框架、系统规范域、项目架构三类版本单元的文件,不是办着该单元的会话写不了。机器仍不认谁是主控为了:「定档排队主控签」这条需求(主控守顶层这条线的第四条)。病根:ADR-90 立了三层运作,ADR-93 把提速的办法写成了明文,两条的「今天靠什么」里留着同样四样只是纪律的事,ADR-93 明写「让机器管档与排队,留给这条线后面的需求」。一、机器不量一条需求有多大 —— 签字那一刻唯一在核的数是「要用户亲手验的用例不多于十五条」,已完结的需求里最大的一条写了十八条标准、从签字到完结一百多个小时、复盘三十四轮。二、同一个版本单元上第二条需求照样签得了字 —— 10-07 整个框架这个单元上同时有四条签过字的需求互相卡着封不了版;10-08「发布只查原料」与另一条撞了同一个单元,被迫拿掉一个落点、请用户重签了一次。三、用户 10-08 定了只和主控说话,可签字还得去办那条需求的工作会话签 —— 机器把一条需求的账绑在签字的那个会话上(验收那一刻三查按当场的会话重算、签字作废期间只替签字的会话认范围、越界点名按「本会话签过确认」找账本、封版前的对账取最近一笔确认的会话、核对命令按跑它的会话算),在主控签验收必然记不成。四、业务的会话改得动顶层文件 —— 写前那一道只问仓里有没有在办的需求,有任何一条,任何会话写宪法、架构详图、规则书、判据、架构页都放。决策:① 定档与上限 —— 机器镜像多一栏「档」,只许三个值(小事、成条的事、难事),没写按小事算。签「确认」那一刻(看板贴回、一键签、对话框里带话的签字,三条路同一处判,排在核落点单元与短名之后、核签字基线之前)守卫核四个数:标准条数、用例条数、其中要用户亲手验的条数、落点表里不重复的版本单元个数(none 不算)。每一档这四个数最多各是几,机器用的是守卫里的一张常量表,给人看的数字只写在项目架构设计页(最大的那一档前三样不设上限)。档写成这三个值之外的、或任一项超了,这一笔不记签字,回话点名按哪一档核的、超的是哪一项、最多几条、现在几条,并给两条出路(拆成几条需求,或把档改成这四个数放得下的最小那一档)。验收那一刻不核。签上的那一笔记下当时按哪一档核的。档进内容编号,但只在写了、而且不是小事时才进:没写档或写「小事」的计划,内容编号与此前的算法逐字相同;签过字之后改了档、编号因此变了的,签字作废。看板签字区里档与四个数各是几条、上限几条那一行出在两处(整个签字区最顶上、「需求」那一组最顶上);超了或档不合法时不开确认区,写「确认区还没开:」加原因;重签时档变了,横幅与那一行标「改了」。命令行算内容编号的那条命令在原有的「计划缺哪些部分」之外加报定档这一道(排队、单元名、签字基线它都不报)。② 同一块排队 —— 签「确认」那一刻,这份计划新要占的版本单元上已有别的需求占着,这一笔不记签字。占着:那条需求的状态是在办、签字作废或账本被直接改过(封了版在等用户验收的也是在办),而且它的落点表(此刻的,或它最后一次签字时的)列有这个单元;机器镜像读不了、而账本里有确认没有完结的需求照旧算占着(按它最后一笔确认留底的单元;那一笔没有留底的老签字认不出它占着哪些单元,也就不算占着),回话里照样点名它。新要占:此刻的落点表里列着、而它自己上一次签字时没列的单元;重签自己已经占着的单元不查。落点单元写 none 的不排队;列了几个单元的,任一个被占就签不上。回话逐个单元写明被谁占着、它哪天签的字、步骤还剩几步没勾、独立复盘过没过,没人占的写空着,并给两条路(等它验收完结,或把这一条并进它)。签字区同一个判法。不加新的计划状态,没有插队的口。签完之后提示范围重叠的那一句留着,它只在单元不同或落点写 none、而目录相同时才出得来。③ 排队看得见 —— 体系守护命令多一个只读动作(queue):不写任何文件,出四段 —— 每个版本单元上此刻谁占着、同一个单元上谁排着、等着签字的计划此刻签得了还是签不了(签不了的写原因)、落点单元互不相交可以同时办的几条;「占着」与「签不签得了」全用守卫导出的判法 —— 签不签得了只问守卫的一个函数,它把确认那一支记签字之前核的那一张表(账本被直接改过、计划写没写全、落点单元与短名、定档与排队、签字基线)从头问一遍,确认那一支自己走的也是这张表,两边不会各走各的。④ 办得超了点名 —— 每档另有两个上限:办的时间(从第一次签字算起,不含等用户验收的那一段)与独立复盘的轮数(各档是多少同样只写在设计页)。按最后一次签字那一笔记下的档比;两个数取现成的那一组,不另算一套 —— 复盘轮数就是账本里复盘的笔数(不可信的也算一轮),办的时间在完结那一刻用刚封进履历的那一组数,在办期间「等用户验收的那一段」只在最后一笔可信的复盘是「过」时才扣。超了任一个,用户每次说话时守卫回的「正在办」里这条需求的那一行与完结那一刻的回话里点名超了哪一个上限、上限多少、现在多少;点名单独接到那一行上、不跟进度那一段走(不占它封顶的额度)—— 在办的需求多于六条时排在后面的、签字作废的,超了同样点名,签字作废的按最后一笔确认记下的档比。只点名、不拦。签字那一笔没有记档的只记数、不比、不点名。⑤ 办理会话 —— 签「确认」那一笔记下办理会话:写证据台账里最后一个把这份计划的机器镜像写成此刻这份内容的会话;台账里没有这样一笔就记成签字的那个会话。签字回话里写明认成了谁(会话号前八位)、是按「这份计划是它写的」认的还是认不出退回成签字的会话。没有这一栏的旧签字,办理会话就是签那一笔的会话。此后五处都按办理会话算、不按当场是哪个会话算:三查核对命令(签过字的计划谁跑、带不带会话号,结果单同一个编号,抬头写明办理会话是谁;传进来的会话号只在一次都没签过字时兜底;复盘任务说明生成时同样)、验收那一刻守卫当场重算的三查、封版前的需求对账、签字作废期间认谁的范围、越界点名记到谁的账上(从「本会话签过任一笔确认」改成「本会话是这条需求的办理会话」)。「谁在办」仍只经 ADR-93 留的那一个取值函数拿,这一次改的就是它的取法。⑥ 落点格 —— 第三查判落点表里的每一格时,一格里此刻的改动全归别的会话,但办理会话(各次「确认」记下的都算)在第一次签字之后对这一格里某个变过的文件有过编辑工具的写证据,这一格不判坏格,结果单那一格写明有几个文件是按这一条认的。只放宽、不收紧;用不上这一条的单子,编号与此前逐字相同。⑦ 顶层围栏 —— 写前多一道,编辑工具与命令行直写共用:要写的文件归整个框架、某个系统规范域或项目架构这三类版本单元(归不归、归哪个单元只问版本契约的名册,单元自己的变更历史与锁清单也算归它)时,写的会话必须是某条在办或签字作废、而且落点表列有该单元的需求的办理会话(签字作废的只认它最后一次签字时留底的落点表;机器镜像读不了的计划围栏不认,方向是拦),否则写前拦下;回话写明这个文件归哪个单元、此刻占着这个单元的是哪条需求(短名与办理会话号前八位,没有就写此刻没有),并告诉它找主控立项。执行体按派它的会话算。不归这三类单元的文件原来怎么判还怎么判。版本契约装不上、判不了归属的按拦处理。便宜的判断放前面:守卫先用一张路径预筛表放掉不可能归这三类单元的写,写业务文件不装版本契约;预筛与名册对不对得上由一张床对拍,名册里这三类单元管的任何路径落在预筛之外,床就红。⑧ 三样规矩写成明文(只动文档)—— 交给工作会话办的需求,两次签字的题由主控弹、用户在主控签;换主控照四步做(旧主控把自己的总账页更新到当下、自己办着的小需求封到一步、名下没封的改动自己封掉或请用户存档一次、新主控开工先读开工注入与总账页);往线上放东西只在部署会话做,授权是用户亲口说的一句话、单次有效不跨轮、这一次发布出了问题立刻回滚算同一次授权,主控只排窗口、不替用户授权(架构详图的角色表加「部署会话」一行)。⑨ 关闸后的现场验证 —— 守卫落进真仓、关闸之后在真实会话里做四样:办理会话照常写得了顶层文件;另一个不是办理会话的会话对一份顶层文件发一次编辑、写前被拦;这条需求自己的机器镜像写上「成条的事」之后签字作废,用户在主控重签「确认」签得成、回话认成的办理会话是办它的工作会话;这条需求的验收在主控签成。前三样的时刻与守卫回的原话记进框架变更历史那一版。超上限与排队两道闸不在真仓里造假计划试签,靠经守卫入口的主自测。为什么这样定:按档只核条数 —— 机器数得准的只有条数;「这件事该是哪一档」「一条标准写得宽不宽」是意思上的事,机器判不了,硬判只会逼人改写法凑数。条数挡的是膨胀(ADR-93 记的病历:一件小事审着审着长成八条标准、十条用例),挡不住的宽度靠用时与轮数点名事后露出来。上限取自定这张表时已完结的十六条需求的记录:落在小事那个框里的恰好四条,全部一轮过、每个单元只封一版;格数不进上限 —— 同样的文件有人分三格、有人分六格。没写档按小事 —— 没定档的走最严的一档,十几份测试文件里的夹具也大多不用动。最大的那一档前三样不封顶 —— 框外的几条从七小时到一百多小时、一轮到三十四轮,没有规律,封了顶也只是逼着硬拆。档进内容编号、但只在不是小事时才进 —— 升档降档必须让用户重签一次(不然超了改一个字就过,他不知道);而编号的算法一变,全仓已经在办的需求签字当场作废,所以没写档或写小事的编号必须与此前逐字相同。两道闸只在签「确认」那一刻判、不放进签字前查计划齐不齐的那个函数 —— 那个函数在验收那一刻也会被调,放进去会把此前签下的在办需求挡在验收门外。排队不加新状态 —— 计划的状态每多一种,写前、收尾、三查、封版、开工注入各处都要认它;排着的那一条不签字本来就进不了仓,「没签字」正好就是「排着」。作废的前一条也算占着 —— 封版本来就认它(落点表列有本单元而签字作废的需求让任何会话都封不了这个单元);等用户验收的那一段必须占着 —— 复盘过了之后别人一动共享文件,那次复盘就作废。不留插队的口 —— 留了口就得有人判「谁算红灯」,机器判不了,交给会话判就是每一条都能插;被插的那一条已经过了的复盘作废、用户看过的单子作废,代价全由前一条担。只能并进去或等,而一条需求一次封版收得了口,等有上限。办理会话按「计划是谁写的」认、不设登记 —— 守卫拿到的只有当场会话的编号、没有会话的名字,登记只能去被登记的那个会话里说,与「用户只和主控说话」正好相反,还多一笔换会话要重登的状态、多一个不经签字就能改的口;而谁写了机器镜像,写证据台账里本来就有。它骑在「确认」那一笔上,换办理会话必须经用户重签一次。认不出退回签字的会话,正是此前的行为,老账本与现有的测试夹具都落在这一支。让核对命令自己按办理会话算、而不是每个调用方各传各的 —— 封版前的需求对账那一处代码因此没动:它仍把签那一笔的会话传给核对命令,靠核对命令里办理会话盖过传进来的会话成立(它那一段的两行注释仍写着按签字那一笔的会话算,注释没改,留作欠下的;行为由核对命令保证,封版命令的床有一条守着);技能说明里核对命令的写法带着会话号,主控照抄会传自己的,同一个道理,显式传进来的盖不过办理会话。围栏按办理会话、不认主控 —— 这几样没有一处需要机器知道哪个会话是主控;给主控建机器身份,换主控就多一道迁移手续、多一处可伪造的本机状态,而「哪个会话在办哪条需求」已经有了,围栏只是它的又一个读者。按版本单元拦、不按范围拦 —— 文件在不在落点表的格里仍归写后提醒与收尾对账(ADR-73 否决过写前按范围拦:一条需求跨几个目录时寸步难行);单元比范围粗得多,名册是版本契约现成的。按严的口径(那条需求的落点表要列有该单元)—— 宽的口径是「手上有任何一条顶层需求就放全部顶层」,等于办着项目架构的会话改得动任何一份规范。签字作废的只认签字时留底的落点表 —— 不然往自己那份作废的计划里添一个顶层单元,就给自己开了门。便宜的判断做成预筛加对拍、不做计时用例 —— 写前那一道每次编辑都走,写业务文件不该为它多装版本契约;「够不够快」写成计时的断言,机器忙的时候会随机变红,一红就卡住封版。确定的两样说的是同一件事、不会抖:一张路径预筛表(写业务文件不装版本契约,由「零件用到才装」的对照表守着),加一张与名册对拍的床(名册长出预筛之外的路径就红);落地时量过一次,写业务文件前后几乎不变,写顶层文件多三十来毫秒。用时只点名、不拦 —— 办的时间是墙上时间,过夜与等待都算,拦了只会逼人拆账;点名让主控看得见就够。落点格只放宽 —— 原来不判坏的照旧不判坏,不会让谁的单子由绿变红。现场验证不造假计划 —— 在真仓里试签超上限与排队要造假计划,假计划签上了会真的占住单元;这两道闸靠经守卫入口的主自测,现场只验换了会话才看得出的那几样。否决:(1)让工作会话显式登记自己是办理会话(一条命令,或用户说一句固定的话)—— 见上。(2)给主控建机器身份、硬拦「只许在主控签」「工作会话不许弹签字题」—— 守卫不认谁是主控;主控自己派 agent 办的小事、新规矩落地之前的那一次签字,都要在别处签得成。(3)排队加一种「排队中」的状态、让机器记先来后到 —— 见上;先后由主控排。(4)给红灯留插队的口 —— 见上。(5)每条标准的字数上限 —— 逼人拆句凑数,标准反而更碎。(6)不看落点表、按文件路径推单元来排队 —— 签字那一刻文件还没写。(7)用时或轮数超了就拦 —— 见上;ADR-87 否决过「复盘到了轮数上限就由用户签带遗留完结」,这里的轮数上限不是那一种:只点名,不放行也不拦。(8)围栏做成宽口径、或要求文件必须在那条需求落点表的格里才放 —— 前者见上;后者范围外的文件要先改落点表、重签才写得了,太重,仍归写后与收尾。(9)计时类的用例 —— 见上。(10)把连着三次复盘不过之后那一次发话,改成在签这条需求的会话里说也算 —— 主控里用户随时在说话,这道闸会变松;这一次不改。(11)暂停与恢复、机器核发布授权、签字题的封口扩到整问各段、历任办理会话的交接、给一条需求留一句「作废」—— 这一次不做:被叫停的线写的是自己签过字的范围里的文件,后面的封版、复盘、验收一道没少,等出现一次真实案例再做;机器核授权要认「一次发布」的边界、给回滚留口、改发布脚本出口,而至今没有出过未经授权的发布。(12)让新会话的封版直接收旧会话的在途改动、一条需求有前后两个办理会话 —— 要动封版的归属与三查的归属判定,面比这一条大。(13)把上限数字也抄进架构详图与这份记录 —— 数字仍只写在项目架构设计页(ADR-93 定的),守卫里另有一张常量表,两处没有机器对拍;多抄一处就多一处会漂。与既有决策的关系(既有条目一个字不改;下面逐条写明哪半句不再是现状):在 ADR-90、ADR-93 上接着办。ADR-93 四处 —— 决策 ② 与「为什么这样定」里「『谁在办』……今天等于最后一次签字的会话」:取法改成最后一笔确认记下的办理会话,改的正是它预留的那一个函数;守不到 (b) 里「签字不在办它的会话签时会指错人」换成办理会话会认错的两种情形。决策 ③「只记数,不比上限」、否决(8)「用时超了这一档就点名或拦 —— 档还没有机器的账」、守不到 (c)「只记数、不比上限、不点名」:点名这一半办了(履历里仍只记数,拦仍不做)。守不到 (f) 里「机器不认档、不核每档的上限」「同一处上第二条需求照样签得了字」不再是现状;「照样往仓里写得了」对顶层三类单元里不是办理会话的会话不再是现状,对业务域的单元照旧;「谁和谁能并行机器不算」变了一半(排队那个只读动作会列出落点单元互不相交的,目录重不重叠仍由主控比);「握没握手、带没带设计、报没报节点没有机器核」照旧。「为什么这样定」末尾说要另立的那条需求,就是这一条。它的决策 ⑥「每档的上限数字只写在项目架构设计页第十节」照旧:数字仍只写在设计页(门一另把签字核的那四个数写全了,计划模板指路指到那里),守卫里另有一张常量表,两处没有机器对拍。ADR-90 四处 ——「今天靠什么」里「守卫分不出哪个会话是主控、哪条需求是顶层的」:前半句照旧,后半句变了,一条需求的落点表列没列顶层三类单元、一个文件归不归这三类单元,机器认;「换主控没有手续」:有了四步,是纪律不是机器;决策 ① 里「业务的工作会话不碰顶层」从纪律变成写前有围栏;「没做的」里点名的「用户只在主控签字、顶层按文件拦、换主控的交接与发布归谁」由这一条办了(顶层按版本单元拦,不按文件在不在范围里拦;交接与发布归谁只写成明文),「暂停与恢复」仍没做。ADR-75 两处 —— 决策 ⑥「签字作废的需求,范围……只算本会话签的……越界只记进本会话那份账本」:「本会话签的」换成「本会话办理的」;「要亲手验的用例最多十五条」照旧,另按档更严。ADR-74 两处 ——「没指定会话……一律红」:签过字的计划不再走这一支,核对命令按办理会话算(认不出办理会话时照旧算红);「第三查只按本会话改到的单元判」里的「本会话」对签过字的计划指办理会话。它的「『用户发话』按会话分」照旧。ADR-73 一处 —— 决策 ③「写前没有正在办的需求不让写受治文件」:对顶层三类单元的文件,写前多问一句写的会话是不是办它的会话;它否决「写前按范围拦」的理由不变,这一条问的是版本单元与办理会话,不是范围。ADR-83 —— 门一后面再接两道(定档与上限、同一块排队);架构详图里记着的「签过字没完结又不打算做的需求没有废止路径」照旧,而且从此这样一条需求还挡着队。ADR-85 —— 签字区重签时的逐条比对多比一样(档)。ADR-86、ADR-92 —— 一键签、带话的签字、签字题带地址都照旧;签不了时确认区不开,签字题因此弹不出来,用的是 ADR-92 决策 ⑤ 现成的那一样(签字区在而没有开着的一道就拦)。「签字题只能由领队弹」照旧,机器不分主控与工作会话。ADR-77 ——「队友与领队同一个会话号」:办理会话与围栏据此把执行体按派它的会话算。ADR-69 —— 版本契约的单元名册多一个读者(写前的围栏),契约本身没动。ADR-50 —— 按会话分账没动,办理会话的认法读的就是它的写证据台账。ADR-88 不变(那是「归已完结需求的不算越界」,这一条的落点格是另一处判定)。落地那一刻:两件事要做 —— 还没签字的旧计划没写档、而条数超过小事那一档上限的,落地之后签不上(按小事核超了),要先在机器镜像里写上档;在办与等验收的需求都重跑一次核对命令再弹题,正在复盘的重新生成一次任务说明再派(只有两种单子会变号:上一张不是办理会话跑出来的;有一格原来只因「此刻全归别的会话」判坏、而办理会话签字后用编辑工具写过其中的文件 —— 这两种的旧编号与守卫当场重算的对不上,用户点了会白点一次)。守不到(照实写,不许读成「从此小需求不会长大、同一处不会相撞、顶层没人改得动」):(a) 条数挡不住单条标准写得宽 —— 五件事写进一条标准就绕过去了;档由写计划的人填,机器不判该是哪一档,超了把档改大就签得上,最大的那一档前三样不封顶;机器保证的只是档与条数对得上、签过字之后升档必重签。上限的数字有两处 —— 守卫里的常量表与项目架构设计页,两处没有机器对拍。(b) 排队只挡签字,不挡排着的会话提前往仓里写 —— 顶层三类单元有围栏挡着不是办理会话的会话,业务域的单元没有,仍靠「在仓库外面写和测」的纪律。占着某个版本单元的那条需求不办了,队放不开:今天没有「作废一条需求」这句话,只能照现成的删计划那条路放开,排队被挡时的回话里带着这一句。卡住的那一条没有插队的口,修它的只能并进去或等;单元不同而目录重叠的不排队;机器不记先来后到。两条排着的需求在同一刻各自去签同一个空着的单元,两条都会记上 —— 判定(读各份计划的状态)与记账(追加确认那一笔)之间没有东西挡着,中间还隔着记基线与认办理会话,没有加锁;记上之后两条都算占着,各自重签得了、第三条签不上。现实里用户一次只点一道题,所以它是守不到、不是要修的毛病。签字作废的需求改了落点表,判「占着」时认的是「此刻的或签字时留底的」,所以它不经签字就能多占一个单元(围栏只认签字时留底的那一份,那一半方向是对的)。排队那个只读动作说的「签得了」不含看板签字区是不是最新的那一道、也不含用户这一次贴回的结论本身对不对;它的「可以同时办」只列落点单元一个都不重的;落点表里写了版本契约不认得的名字时,它前两段照原样把它当一个单元列出来;它出的是此刻的样子,看完之后别人签了字结论就变。(c) 办理会话会认错,两种情形 —— 用脚本写机器镜像的没有写证据,退回成签字的会话;别的会话后来改过机器镜像就认成它(主控审计划时顺手改一处,就认成主控,工作会话的改动全算别的会话)。兜着的只有签字回话里认成了谁的那半句与「主控不动机器镜像」的纪律;认错了要重存机器镜像、用户重签一次。一条需求做到一半换会话接着做,哪边当办理会话第三查都会红。主控记签字的同一刻办理会话的钩子也往同一本账追加,会把账本的链撞断(账本追加没有跨进程排队,ADR-93 记过),靠「报完请签字就停手」的规矩。(d) 围栏守不到脚本进程内的写与开闸期间的写。不归任何单元的受治文件围栏不管 —— 最重的两样是钩子接线文件、守卫与技能目录下的测试(版本契约不把测试算进单元;钩子接线文件与守卫自己的测试另有脊柱写保护,技能目录下的测试没有),另有部署门登记表、治理站点的源码与构建器、官网。还没出生的单元名册不认(全新的技能目录、新规范的第一个文件),围栏不拦;删除不过围栏;写前那个判定不带会话号直接调时不判围栏(守卫里的三处调用都带)。命令行只挡直写落点的常见形态 —— 直写的目标带变量、通配或反引号时写前那个判定不判,围栏的命令行那一半跟着看不见(这一句是读代码读出来的,没有实测);Windows 上的路径别名会不会绕过预筛,没有核实;平台另有的 PowerShell 工具与笔记本编辑工具守卫不处理。办理会话认错时围栏跟着错。(e) 连着三次复盘不过之后那一次发话仍只认派复盘的那个会话 —— 那一句还得去派复盘的工作会话说。(f) 机器不认谁是主控 —— 做到的是「在主控签得成」,工作会话里照旧签得成,「签字题由主控弹」是规矩;业务的会话自己起草一条列着顶层单元的计划、用户在它那里签了确认,它就写得动顶层,「顶层的需求由主控立项」仍是纪律。(g) 用时只点名 —— 超了没有任何东西被挡住;办的时间是墙上时间,过夜、等开闸、等别的需求让路都算,只有等用户验收的那一段不算,而在办期间这一段只在最后一笔可信的复盘是「过」时才扣;复盘轮数连不可信的那几轮一起数;上限是拿顶层需求的记录定的,对业务需求没有数据;这一版落地之前签下的需求只记数、不比。(h) 落点格治不了的三样 —— 只含锁清单这类没有写证据的文件的格照旧会红(只认编辑工具的写证据);别的会话在同一个单元上还没封版时第三查照红;共享文件一变已过的复盘作废。另:认的是「写过」不是「此刻的内容是它的」。(i) 发布授权机器不核 —— 守卫不核用户有没有授权、也不核是哪个会话在发;「只在部署会话发」「没有用户那一句不发」是纪律,别的会话跑发布脚本,拦它的只有发布前的检测、测试与版本比对。换主控的四步同样是纪律,主控的总账页不受治、没有机器核它新不新。
ADR-932026-10-09看得见、记得住:守卫每拦一次在会话台账留一笔;用户每说一句话,「正在办」那一行给每条在办的需求列出走到哪;完结那一刻把用时与返工、欠下的事与复盘者的遗留写进需求履历;到了存档点由守卫在收尾时直接对用户说一句。同批把提速的办法写成明文:派工先分级、同一处的并成一条、准备并行而落地排队、主控先出设计、先握手并按节点回报。五样功能都只是多记一笔、多说一句,不加任何会拦人的闸;提速的办法今天全靠纪律为了:「看得见记得住」这条需求(主控守顶层这条线的第三条)。病根:ADR-90 立了三层运作,它的「今天靠什么」大半是纪律;照它跑了一天真实需求,露出两类毛病。一类是看不见、记不住 —— 主控要知道各条线走到哪,只能等工作会话来报,或请用户去那个会话看一眼(用户 10-09:「所有的分身会话都应该先让他通知你,然后再派发任务……分身也需要实时把关键节点的进度同步给主控」);守卫拦了什么只是当时屏幕上的一行字,事后问「这条需求被拦过几次、最近一次为什么」答不出;做到一半记下的发现写在计划里,计划完结就删,复盘者写的遗留只在他的报告里(用户 10-08:「等需求实现完之后回头处理主控的时候都忘记了」);一条需求办了多久、返工几次没有数;到了可以存档的点,要靠主控记着说。另一类是慢 —— 这条线被切成八条,每条走一遍全套手续,改守卫的各开一次闸,而它们几乎都改同一批文件、只能一条一条排队;第二条本是一件小事,派了三路人审计划、落地前又审一轮、封版后再复盘,需求从一件事长成八条标准、十条用例;派工没带设计,工作会话自己把代码从头读了一遍;第一次派工没握手、没约回报,被叫停重来(用户 10-09:「如果需要几天,那太恐怖了」「速度太慢太慢了……禁止简单问题复杂化」)。决策:① 拦截留痕 —— 守卫里所有的拦都从主文件里同一个出口走,在这个出口退出之前往本会话的台账追加一笔:时刻、在哪一刻被拦(写前、执行体停下、复盘者收尾、收尾)、工具、拦在哪个文件或哪条命令上、原因的第一行,执行体发出的带上它的编号与名字;守卫自己出错而拦的尽力记一笔并标明。记不下不改变原来的报文与退出码;放行的调用不多读不多写。② 每次回话列进度 —— 用户说话那一刻,守卫回给当场会话的「正在办」那一行,每条在办的需求后面多接一段:谁在办(不是本会话的话,那个会话最后一次动静多久之前)、签字至今多久与签了几次、三查与封版(只读落盘的最新一张结果单并带上它是几点算的,绝不重算)、复盘几次与最新结论、验收签没签成、办它的会话在签字之后被拦了几次、欠下几条。对每个会话都注入,内容没变也照发。「谁在办」全仓只经一个取值函数拿,今天等于最后一次签字的会话。③ 用时与返工进履历 —— 验收完结那一刻,钩子从账本现成的事件算出第一次签字的时刻、签字次数、用户说不过的次数、复盘轮数(过、不过、不可信分开)、总用时与其中等用户验收多久,写进履历(机器读的一栏、给人读的一节),在算产出指纹之前写、照样封死。只记数,不比上限。旧履历一个字不动。④ 发现留得住 —— 同一刻把计划看板「决策与遗留」页签「欠下的」一栏、与每一笔可信复盘带的遗留逐条写进履历的「遗留」一栏;复盘者的遗留由守卫在他收尾时从最后那段话里取出、随复盘结论那一笔记进账本(多一栏,不多写一笔),任务说明把遗留的写法写死,认不出不拦、只在回话里说;完结那句回话逐条列一次,交主控定去向。⑤ 存档点提醒 —— 工作区里有计划目录与账本目录之外还没存档的改动、没有在办的需求(签字作废的、账本被改过的也算没办完)、发布前版本比对为空,三样都成立时(先便宜后贵,最后才起版本比对),守卫在那一轮收尾最后那个放行出口,用它本来就在用的那种直接给用户看的输出说一句固定的话:「【存档点】现在可以存档:没有在办的需求,全部版本单元都已封版。」同一个状态每个会话只说一次 —— 状态是当前存档点的编号加上这两个目录之外还没存档的文件清单,用户存了档之后又有新的改动才算新状态;别的会话记下的版本比对结论,文件清单的路径与修改时间都没变才沿用。版本比对判不了或超时就完全不说、不拦、不记,下一轮再试;零件装不上或出错照旧放行、不说那句话,只在收尾的附注里说一句。⑥ 提速的办法写成明文(宪法只加一句定性的话;各档走哪几步、今天靠什么写在架构详图 §十五;每档的上限数字只写在项目架构设计页第十节):先分级 —— 小事、成条的事、难事三档,手续的轻重跟着档走,机器规定必须走的五样(用户确认、封版、一轮独立复盘、三查全绿、用户验收)哪一档都不省,审查只留两层(主控审计划、封版后的独立复盘);同一处的并成一条 —— 落在同一批文件上的几件事在签字之前并成一条,一次开闸、一次封版;准备并行、落地排队 —— 同一个版本单元上从签字到验收完结是一条车道,车道外的事(起草计划、出设计、在仓库外面写与测)可以提前;等的是验收、不是封版;能不能多开会话只看两条需求的版本单元有没有相同的、目录有没有重叠;开闸、跑测试、验收、发布四个全仓共用的窗口由主控排;主控先出设计、派工带设计;先握手、按节点回报,要用户动手的事先报主控。为什么这样定:五样功能都只往账上多记一笔、在现成的时刻多说一句 —— 不新增会拦人的闸、不新增计划状态、不新增执行体、不改钩子接线,出错只提示不拦;要的只是看得见,每加一道闸就要多一轮对抗复盘。拦截记进会话台账、不进需求账本 —— 需求账本带链,追加是读末行再追加两步、没有跨进程排队,一笔撞坏整本账就判成被改过、全仓写前都拦,而拦截恰恰是高频事件,并行的工具调用与几个会话会同时落笔;会话台账一个会话一份、只追加、没有链。归到哪条需求不在写的时候算(写的时候不多读任何东西),读的时候按「谁在办、第一次签字之后」数。进度只读落盘的结果单、不重算 —— 用户说话那一刻不能做重的计算(发布前版本比对约三秒、量工作区约一秒,重算三查要读几千个文件);代价是那张单子可能是旧的,所以行里必须带它是几点算的。对每个会话都注入 —— 守卫分不出哪个会话是主控。「谁在办」只经一个函数取 —— 今天它等于最后一次签字的会话,以后签字与办理分开时只改这一个函数,读它的地方(进度那一行、被拦次数)不用跟着改。用时全部从现成事件算、不加新的账本事件 —— 同一个理由,账本追加没有排队。只记数不比上限 —— 机器还不认档,没有档就没有「这一档的上限」可比,先把数记下来。遗留不另建台账 —— 履历那一栏就够:它在仓里、进治理站点、封死后不能改;写履历的函数本来就认「遗留」这个参数,给人读的那一份本来就有这一节,只是唯一的生产调用从没传过。存档点挂收尾、不挂验收完结那一刻 —— 收尾时守卫手里已经有工作区的测量,收尾的输出本来就能直接给用户看;完结那一刻的输出是给执行者的,时限里已经在当场重算三查,计划还没删、履历刚写出还没复核;发布之后、别的会话收尾之后才到的干净点,挂收尾一处都接得住。存档点的第三样用发布前版本比对(与部署门同一个文件)、不另判测试面新不新鲜 —— 各单元封版时已经核过,再核一遍最贵,也最容易因为上游牵动迟迟不成立。存档点零件不走守卫顶部的装载口、只在收尾放行出口现装 —— 那个口的约定是装不上就拦,是给闸用的;一句提醒坏了,不该把收尾拦住。账本目录里的改动不算「还没存档的改动」—— 原话账本进了版本库,用户每说一句话它就变,不排除的话他刚存完档、说一句话,守卫又会说一遍。提速的办法先写成明文、不做成闸 —— 机器能管的那一半(签字之前核档与上限、同一处上一条没验收下一条签不了字)要动签字那一刻的判定,另立需求;这一条先把话写准、把今天靠什么写明。否决:(1)发现的「去向」台账(哪一条立成了哪条需求、哪一条搁置了,每次回话常驻一行「没有去向几条」)—— 先做到留得住、完结时逐条报一次,真攒出烂账再加。(2)进度那一行「内容没变就折叠成一句」—— 主控的上下文被压缩之后恰恰需要完整的一行,先照发。(3)把拦截汇总写进需求履历 —— 归到需求是读的时候算的,汇总进履历要在完结那一刻读别的会话的台账并封死,先不做。(4)单独的查询命令(查拦截、查进度)—— 进度那一行已经带着数。(5)「离存档点还差什么」的提示 —— 不成立时什么都不说:差的东西每轮都在变,说了就成了每轮收尾的噪声。(6)进度只给主控注入 —— 机器不认谁是主控,要先让机器认得它。(7)存档点另判「测试面全新鲜」—— 见上。(8)用时超了这一档就点名或拦 —— 档还没有机器的账。(9)这条需求自己落地前另派一轮对抗审查、审计划时派多路核对 —— 五样全是只记只说,照「成条的事」走:主控自己审计划,领队对着标准逐条过、点名的测试在仓库外面的副本上全过,封版后一轮独立复盘。与既有决策的关系:在 ADR-90 上接着办。ADR-90「没做的」里点名的「发现的留存」由 ④ 办了一半(留得住,去向没有账);它「今天靠什么」里「记下的发现不随需求履历留下来」不再是现状。取代 ADR-90 的三处,并给它加一样:决策 ① 里「同一时刻只办一条」—— 改成同一个版本单元上同一时刻只落一条(从签字到验收完结),下一条的计划与仓外准备可以提前,落点互不相干的可以同时办,顶层的工作会话因此可以不止一个;决策 ④ 里「大战线是一串小需求」的切法 —— 一条需求仍要一次封版收得了口,但落在同一批文件上的几件事并成一条,不再一件小事一条;否决(4)的理由「一口气上等于长时间开闸」—— 在仓库外面写好测好再落的做法下,开闸只在落地那几分钟,并成一条反而让开闸的次数变少(硬控仍然分条办,只是按同一处合并来分,不是一口气全上);决策 ⑤「开闸、发布、全量测试三样由主控排窗口」加一样验收 —— 从出结果单到用户签字的那一小段,别的会话写一个受治文件,用户看过的单子就作废。旧条目不动。ADR-87(复盘提速)的判法不变,它「守不到」里「遗留只在复盘者的报告里、由执行者抄进看板」不再是现状。ADR-83(项目架构与归档)的履历多两栏,封死的规矩不变。ADR-50(按会话分账)的会话台账多两种记录(拦截、存档点结论),归属的判法不变;这两种记录算会话的动静 —— ADR-82「主人会话已结束」的判定认任何带时刻的台账事件,被拦一次、记一笔存档点结论都算这个会话还活着,它的改动晚些才轮到别的会话按无主复核(只会更晚放行,不会放松)。ADR-75「领队只派活、不替关口放行」不变。ADR-92 新挂的写前那一支落地之后,它的拦截自动进 ① 的账,不用另改。守不到(照实写,不许读成「从此都看得见、都记得住、不会再慢」):(a) 不经守卫出口的拦不记 —— 守卫启动失败、钩子输入读不了连会话号都没取到的那一次、平台自己的禁止名单拦的、钩子超时被平台掐掉的;封版命令拒封、签字没记成不是守卫的拦,也不在这本账里;开闸期间写前那一道不在岗,那时没有拦也就没有记录;写证据台账第一次建立时那一次提示性的拦也被数成被拦;台账写不进去时照拦、少一笔、没有提示;被拦命令的开头原样留在本机的会话台账里,命令里带着密钥的话也留在那里(台账不进版本库、保留三十天);台账在本机、脚本能改。(b) 进度那一行可能是旧的 —— 三查与封版读的是落盘的结果单,是办它的会话上一次跑核对命令时算的,行里带着几点算的;会话只有编号、没有名字;只在用户说话时才出现,工作会话卡住了机器不提醒;「谁在办」今天等于最后一次签字的会话,签字不在办它的会话签时会指错人;被拦只数这个会话自己的台账,别的会话替它干活被拦的不算、重签换了会话之后前一个会话的不算;「最后一次动静」只看台账文件的修改时间,只说话只读文件的会话看上去像没动静;它是塞给执行者的话,用户看不看得到取决于执行者转述。(c) 用时是墙上时间,过夜与等待都算在内;等开闸、等别的需求让路分不出来;只记数、不比上限、不点名;时长舍去不满一分钟的零头;此前封死的履历没有这一栏,也不回填。(d) 遗留的去向没有账;遗留一进履历就随治理站点公开、封死后改不了,进履历之前不先给用户看;复盘者的遗留是自由文本,没按写法写时认不出、记成没有,只在他收尾那一刻提示一次,一轮超过二十条的后面几条静默丢掉;不可信的复盘带的遗留不进;只取「欠下的」一栏、只认列表与段落,写在这一栏之外的进不了,写成表格的老看板一条都取不到;完结时合计最多四十条,超出的只在回话里说另有几条;完结那一刻取遗留出错按没有处理,履历已封死、之后补不进去;完结回话里的清单是塞给执行者的话;没有在办需求的会话发现的问题没有登记口。(e) 存档点那句话在几条线并行、从不同时空闲时可能很久不出现,不成立时不说差什么;谁收尾碰上就在谁那里说,不一定是主控;没有会话收尾就没人说;只在收尾最后那个放行出口判,收尾用时超过九十秒的那一轮不判;一次存档都没有过的仓库永远不说,被忽略的文件与草稿区的改动不算;「全部版本单元都已封版」比不到不归任何单元的文件;测试面此刻新不新鲜不判;能不能沿用别的会话的比对结论只认文件的修改时间、不读内容;状态只看是哪些文件,说过之后内容再变不会再说,台账记上了而平台丢了那一次输出也不会再说;说了之后用户存没存档机器不知道。(f) 提速的办法全靠纪律 —— 机器不认档、不核每档的上限(唯一在核的仍是要用户亲手验的用例那一条上限);同一处上第二条需求照样签得了字、照样往仓里写得了;谁和谁能并行机器不算;握没握手、带没带设计、报没报节点没有机器核。让机器管档与排队,留给这条线后面的需求。
ADR-922026-10-09签字题带地址:钩子接线的写前名单重新挂上选项题 —— 带着预先填好答案的选项题一律不让弹;被认成签字题的(只认两种写法,另加一条封口)弹出之前核谁弹的、只签一道、认计划、题目正文带看板完整路径与「签字」页签、签字区是最新的那一道,缺一样这道题弹不出来。用户在单选题「其他」里自己打固定那句、后面跟着话,照认签字,后面的话记成他的意见。签字的形态不变:在 ADR-78 / ADR-79 / ADR-86 上加一道写前的闸、多认一种签法为了:「签字题带地址」这条需求。病根:10-08 验收「主控立规」时,弹到用户面前的验收题题目里没有看板地址,他在对话框里打:「不对啊!在哪里验收啊……怎么丢失了?」随后在验收题的「其他」里打了固定那句、后面顺带说事 ——「全选执行:验收完结 主控立规,同时,为什么丢失地址这个事情我记得以前是硬控的……要顺带闭环这个事情啊!」—— 机器没认,他又点了一遍;10-07 同样白点过一次(那次打的是「全部执行,同时……」)。两件事各有病根。地址从来不是硬控:v4.4.6–v4.7.12 那几版守卫确实在选项题弹出之前拦过(本机 10-03 的会话记录里有四次真实的拦截),但核的是选项对不对、三查绿不绿、有没有预先填好答案,不核地址;v4.8.0(ADR-78)签字搬进看板签字区,写前这一道整个摘掉,「题目里写明看板路径」只剩守卫提醒执行者的一句话,验收那一道连这句提醒都没有 —— 用户记得的「以前是硬控的」只对了一半。带话的不认:ADR-86 的一键签只认答案整段恰好等于固定写法的那个选项,他照着第一项的字自己打、后面多说一句,整段就不等于任何一种认得的形态,只记成话。决策:① 写前重新挂上选项题 —— 钩子接线文件的写前名单加上选项题这个工具(AskUserQuestion),除这一处之外接线文件一个字不动。任何选项题带着预先填好的答案弹出,写前一律拦,不分是不是签字题(答案只能由平台在用户点了之后填);整道题里「确认」「验收完结」「全选执行」三个词一个都没有的选项题,不装需求零件、直接放。② 哪些题算签字题只认两种写法,认不出的不拦、普通选项题照旧;一次弹题有几问,每一问各自判。第一种:某个选项的标签整条恰好是固定写法「全选执行:确认 〈名〉」或「全选执行:验收完结 〈名〉」。第二种:这一问里执行者写的任何一段字(题目、标题栏、每个选项的标签、说明、预览)写着「确认 〈名〉」或「验收完结 〈名〉」—— 动词与名字之间隔着空白,〈名〉是一条没完结的计划的目录名或短名,而且名字到此为止:名字里的字只有文字、数字、英文连字符、英文下划线,名字后面是结尾或不是这几样的字(空白、标点、破折号、各种符号都算)就到头;同一处对上几个名字取最长的那个,最长的那个恰好对上一份计划才算(名字是已完结计划的认不出、直接放)。另加一条封口:选项标签以「全选执行」四个字打头的,只许恰好是固定写法,不是就不让弹 —— 这四个字留给签字用;封口排在最前,这一问认没认成签字题都生效。③ 被认成签字题的每一问,弹出之前按固定的先后过几样,先碰到哪一样不过就拦在哪一样、写明是哪一样(一次弹了两问以上的写明是第几问):谁弹的(带执行体身份的不让弹,签字题只能由领队弹);只签一道(这一问必须是单选题;认出的动词与计划合起来只能是一份计划的一道,认出两个动词或两份计划不让弹);认计划(固定写法里的名字要对上恰好一份计划,对不上或对上不止一份不让弹;那份计划已经完结、账本被直接改过、机器镜像读不了,不让弹);题目正文两样(④);签字区(⑤)。④ 只核题目正文两样(不看标题栏与选项),先路径后页签,缺一样不让弹:看板的完整路径 —— 盘符开头的那一整串,正斜杠反斜杠都认、大小写怎么写都认,但必须正好指到本仓里这份计划的看板文件(这一串后面紧跟着英文字母、数字、下划线、连字符、斜杠,或一个点再加英文字母数字的,是另一个文件,不算;前面紧挨着英文字母或数字的也不算,那是别的字凑出来的盘符);「签字」与「页签」两个词挨着出现 —— 谁先谁后都认,中间只许隔引号、空白、星号这类不是文字也不是数字的字符,最多四个。「那里列着什么」不核。⑤ 签字区只比现成的三个记号、不重算三查:看板里读不到签字区(没有,或开头与结尾标记不成对)不让弹并写明怎么修;读得到再比 —— 签字区里记着的内容编号等于这份计划此刻的内容编号;签字区现在开着的那一道(确认,或验收完结)就是这一问要签的那一道,签字区在而没有开着的一道(比如三查还红)也按这一样拦,并写出签字区此刻的状态;验收题另比,签字区里记着的结果单编号等于账本目录里落盘的最新一张结果单的编号。用户点下去那一刻的重算照旧。⑥ 被拦时守卫回给执行者的话固定带三样:把这一问认成签字题的那一处原文;一句「这不是签字题的话,把这一处改个写法」;不过的是哪一样和怎么改 —— 缺路径就给出该写的那一串,缺页签就给一句可以照抄的话。认成签字题之后被拦的每一种都带这三样(不只题目正文那两样);封口那一支有自己的话,点名那个标签、说这四个字留给签字用。⑦ 带话的签字照认:用户在单选题的「其他」里自己打的一句话,以「全选执行:确认」或「全选执行:验收完结」开头(冒号全角半角都认;这几样之间有没有空白都认)、接着是一条计划的目录名或短名、而且名字到此为止的,照认签字 —— 与点固定选项的一键签同一份判法(看板签字区必须是最新的那一道,验收照旧当场重算三查)。名字到哪为止与 ② 同一个判法;名字从现有计划的名字里对,对上的取最长的那一个、恰好对上一份才算。名字后面的话去掉打头的标点与空白之后记成他的意见;后面的话不管说的是什么(哪怕是不同意)都照认,真不同意就别打固定那句。整句进原话账本,签字那一笔记的原话就是这整句、另记一栏意见,账本那一笔标明是他在对话框里打的(来路记 ask-typed,与一键签的 ask-all 分开);守卫回给执行者的话里把意见带上并写明要当场回应。⑧ 防执行者替他签的那一半不松,五条:一、答案整段等于某个选项标签的,照旧只认恰好是固定写法的那一种 —— 执行者把「固定句加一段话」写成标签、用户点了它,不认签字;二、怎样才算他自己打的 —— 答案属于一问单选题(多选那一栏缺省或等于否;答案的键逐字对上恰好一问的题目),不等于这次弹的任何一个选项标签,也不以任何一个不是恰好固定写法的标签打头,三样有一样不成立,带话的签字不认;其中以这样一个标签打头、后面多出一截的,整句只记成话,哪一种签字都不认(这一处的「恰好固定写法」指匹配固定写法、而且名字对上恰好一份计划);三、多选题的答案、或认不出属于哪一问的答案,只留「整段恰好等于固定写法那个选项」一种认法,其余(以固定句开头的、贴回的整段看板结论、「确认 〈名〉」)一律只记成话;四、带执行体身份而被认成签字题的,写前不让弹,带执行体身份的答案,写后照旧不记、不认;五、任何选项题带着预先填好的答案弹出,写前一律拦,平台回了答案时,写后只认平台回的那一份,工具输入里多出来的键不看。⑨ 平台拦不拦得住,当场验:关闸之后在真实会话里弹一道不带看板路径的测试题,被守卫拦下、用户看不到才算过,同时弹一道普通的选项题、照常弹到用户面前才算过;测试题的形态写死成点哪个都签不成(只在题目正文里写固定句,不摆固定写法的选项,选项只放不构成签字的话);这一次的时刻与守卫回的原话记进框架变更历史那一版,验收那一刻当着用户再弹一次。为什么这样定:只认两种写法加一条封口 —— 点一下就能签成的只有固定写法那一项,所以摆出它的题必须带地址;题里写着固定句而且机器认得出的也核,认不出的不核;认得再宽就会把普通的选项题也拦住。被拦时回的话点出是哪几个字让它被当成了签字题,普通题改一个写法就过。只核题目正文两样 —— 用户丢的是「去哪看」,路径与页签机器判得了;一段话写得清不清楚机器判不了。只比现成的记号 —— 重算三查要读几千个文件、好几秒,而用户点下去那一刻本来就重算;弹题之前要挡的只是「点了也签不成」的题。带话的照认、反对的话也照认 —— 固定那句是他自己打的,就是他的意思;机器分不出一句话是不是反对,按词去猜只会猜错;他两次带话说的都是「顺带再办一件事」;真有哪一条不对,照旧在看板签字区里不勾那一条、写一句、贴回,那才是「不过」。这一条在计划里单独摆出来请用户定,签过字的标准就是照「认」写的。名字拿现有计划的名字去对开头 —— 10-08 那句名字后面直接是逗号、没有空格,靠放宽写法后面的话会被吞进名字。否决:(1)弹题之前把三查重算一遍 —— 见上。(2)把一键签的那条写法放宽成「后面可以跟任何字」—— 后面的话会被吞进名字,对不上任何计划;改成拿现有计划的名字去对开头。(3)把「全部执行」「全部通过」这类说法逐个列进去当签字 —— 没写是哪条需求、哪一道签字,认它等于机器替用户猜,说法也列不完;只认以固定那句开头的。(4)多选题的答案按逗号拆开、逐段认 —— 他打的话里自己也会有逗号,拆不准,拆错了就是执行者替他签的口子;改成多选的签字题弹出之前就拦。(5)核「题目里有没有写清那里列着什么」—— 机器判不了一段话写得清不清楚,硬核只会逼执行者堆关键词。(6)在仓库外开一个空目录跑一次性探针来验平台 —— 不开对话框的运行方式里平台不提供选项题这个工具,探针弹不出题;改用本机 10-03 的真实拦截记录作历史证据,加关闸后当场验。与既有决策的关系:签字的形态不变 —— ADR-78(两次签字在看板签字区、贴回)、ADR-79(贴回经对话框)、ADR-86(一键签)都照旧,这一条是在它们上面加一道写前的闸、多认一种签法。有三处半句不再是现状,照实写明:ADR-78 决策④「写前不再挂选项题」—— 写前重新挂上,但核的不是当时摘掉的那一套(弹题前的三查前置、选项核对、分组合并、「有一项不对」都没有回来),回来的只有「带着答案弹题的拦」,并从签字题放宽到任何选项题;ADR-79 决策②「答案按与说话同一份判法认」—— 收窄:单选题里他自己打的照旧,以一个不是恰好固定写法的标签打头、后面多出一截的整句只记成话,多选题的、认不出属于哪一问的答案只留一键签那一种认法;ADR-77 决策③ 里「执行体弹签字题拦」—— v4.8.0 写前摘掉选项题之后落了空,这一条起重新成立。ADR-86「其余标签照旧不认」不变,另加封口。守不到(六样,照实写):(a)「那里列着什么」机器不核 —— 题目里有路径、有「签字」页签这几个字就放,写得清不清楚靠执行者。(b) 写前拦截摘下(开闸)期间这道闸不在岗 —— 不带地址的、多选的、带答案的签字题都弹得出来;用户答完之后的认定照常;开闸时预先填的答案,只有平台没回答案的时候才可能被当成答案。(c) 签字区新鲜度只比现成的编号、点下去那一刻重算仍可能对不上 —— 弹题之前不重算三查,也不核看板正文与机器镜像一不一致,只比那三个记号;刷新之后别的会话又改了东西,那时照旧告诉执行者刷新重弹。(d)「全部执行」这类不以固定句开头的话照旧不认。(e) 认不出的题不核地址 —— 两类:不提固定句的(执行者弹一道既不摆固定写法、也不提固定句的题,请用户把看板结论贴进「其他」);提了固定句、但写成机器认不出的样子的(动词与名字连着写、名字后面紧跟别的字、名字加了引号)。两类都不被核;其中连着写的那一种,用户照着打「全选执行:确认名字」还签得成。靠工作流说明里「签字题第一项固定放固定写法」的规矩。(f) 路径只核指到这份计划的看板文件、打不打得开不核。另两样:(g) 钩子接线文件不归任何版本单元,写前名单哪天被改回去,只有守卫主自测里核名单的那一条会红,没有别的东西逼着重跑它;(h) 直接在对话里(不经对话框)打「全选执行:……」不认。现场验证只验了当时那一个平台版本;平台一换版本,照架构详图 §八「挂载」的规矩在真实会话里重核一遍。
ADR-912026-10-08「发布后把整站查一遍」做进发布库现成的两步:发布准备在本机把每张网页、每份样式表里写死的站内引用逐条核一遍,有一条不过就不准备档案;新文件传完、换首页之前把每个文件在每个访问入口各比一遍。不放松守卫、不新增检查点、不新增命令、不设例外名单为了:「发布查全站」这条需求。病根:部署技能的说明里一直有一步「换首页核对通过后,按页面里写的引用把整站抓一遍」(2026-09-21 治理站点 141 页样式 404 之后加的)—— 它只是说明里的一句话,没有任何程序承担,每次靠当时的会话临时写一个仓库外的脚本去做。10-08 第二次关着闸发完治理站点,照这一步去查,没查成:没有在办的需求时,守卫不让跑仓库外的脚本。守卫没有错 —— 它只看得见命令,看不见脚本里写了什么。而发布库现成的两步各缺一半:发布准备只核首页引用的文件在不在、首页有没有以 / 开头的引用,子页与样式表里的引用没人看;新文件传完之后的核对(assets 检查点)只在默认域名上比,访问域名要等换完首页(live 检查点)才第一次被比到,而且那时只比首页那一组与首页直接引用的脚本样式。用户要求:最佳最合适的方案,禁止复杂化。决策:① 发布准备多一道全站引用核对(发布库 release/stage.js 的发布准备调新零件 release/site-refs.js):首页按内容改名、改写之后,联网读线上清单与建档案目录之前,把本版每张网页(.html)、每份样式表(.css)里写死的站内引用逐条解析 —— 网页只认真标签上的 href 与 src(属性名不分大小写,值带不带引号都认,同名属性只认第一个;注释与脚本块、样式块这些浏览器只当字读的地方不算),样式表认 url() 与 @import(注释里的不算);空的、只有锚点的、带协议的、以两个斜杠开头的不核;其余每一条按它所在文件的位置照浏览器的规矩解析(不认基准地址标签),去掉问号与井号后面的部分、解掉引用里写的百分号转义,必须逐字(区分大小写)等于本版发布清单里的一个文件,或正好是站点根目录。核的是这一版上线后的样子(文件名用改名之后的、首页用改写之后的),所以「首页的脚本样式发布时改了名、别的页面还指着旧名字」判得出。② 不过的分五类:以 / 开头的站内引用(恰好拼得出一个存在的文件也不放过)、爬出站点根、指向目录而不是文件、只差大小写、发布清单里没有这个文件。有一条不过就抛错:不留下发布档案、线上零改动、连线上都没去读;报文点名文件、引用与类别,不过的很多时只列前三十条并写总数。③ 通过时把核了几张网页、几份样式表、几条引用记进发布记录的准备那一步,发布档案摘要多一行;发布记录里记「准备发布之前过了哪些检查」的那一栏不加字段。零件交回的结果里一张网页都没有(首页一定是一张)就拒绝准备 —— 核对没真跑起来不当通过。④ 四类站点(后台、手机网页版、官网、治理站点)经同一个发布准备、同一套判法,没有例外名单、没有按站点分支。⑤ 新文件核对(assets 检查点)改成每个入口都核:入口取发布档案里记下的那一组(准备发布时定下并记进档案的:默认域名 + 网站注册表登记的每个访问域名)。先默认域名 —— 首页那一组(首页、构建名片、发布清单)之外的每个文件都取得到、逐字节一致;它不过,这一次就不再去核访问域名(它们读的是同一个桶)。再每个访问域名 —— 先取一个文件探路,最多 3 次请求,取不到回答(连不上、超时,或 3 次都是服务器出错)就判这个入口不通、其余文件不再逐个试;拿到了回答(哪怕是 404)才把全部文件逐个比。任何一个入口有一个文件不过,这一次不记通过;通过时这一步记下每个入口各核了多少个文件。⑥ 不过的提示分两种:默认域名上有文件不过 → 重新上传再跑;默认域名全过、只有访问域名不过 → 不要换首页,桶里是对的、再传一遍没有用,先原样重跑一次,两次都不过再查该域名的网关路由。⑦ 没动的:检查点的名字与先后、live 检查点的判法、守卫目录下的任何文件、四个部署脚本、发布前测试;没有新增步骤、没有新增命令。说明里手工抓一遍的那一步同批删掉。为什么拆成这两半:引用指向哪个文件,在本机算得出来 —— 引用写死在文件里,文件清单是发布库自己定的 —— 不用联网、不用爬;文件取不取得到、内容对不对才要联网。两半合起来,加上原有的 live 检查点,等于「按页面里写的引用,在每个入口都取得到,而且内容对」。所以不需要一个爬虫。引用核对单独放一个纯计算的文件(不读盘、不联网、不引发布库别的文件),好测、好做反证。为什么联网那一半放在换首页之前:首页之外的页面在「传新文件」那一步就已经原地换成新版了;等换完首页才发现访问域名上取不到,访客已经拿着新首页去要取不到的文件。代价:新站点第一次发布时访问域名要先接通,否则停在 assets 这一步(从前是停在 live)。相对旧行为收紧了什么、放开了什么:收紧一处 —— 指向目录只放行正好落在站点根目录的那一种(回首页),别的目录哪怕下面有 index.html 也不过;从前首页指向带 index.html 的子目录是放行的。理由:静态托管没有可靠的目录首页(2026-10-04 线上六页 404 就是指向目录),宁可收紧。放开两类(都只涉及首页)—— 首页从前按文本扫:注释、脚本块、样式块里出现「指向不存在文件」的字样也拦,真标签上带前缀或别名的属性(data-src、xlink:href 这类)里指向不存在文件的也拦;现在只认真标签上的 href 与 src,这两类都不拦了(其中 xlink:href 是真会去取文件的);原来只管首页的两处核对(首页含以 / 开头的引用、首页引用了产物里不存在的文件)并进了全站核对,「没带指纹的按需脚本」那条拒绝还在、排到了它之后。否决:(1)放松守卫,让没有在办的需求时也能跑仓库外的脚本 —— 等于往「没签字也能跑」的名单里加一项「任意程序」,而守卫只看得见命令;改完之后这两样核对住在仓里现成的两条命令里,没有在办的需求时照样跑得了。(2)把那个临时脚本原样搬进仓里 —— 它只看取不取得到、不比内容;入口写死一个站;以 / 开头和爬过头的引用它在默认域名上看不见;解析不了的引用只打印不算错。(3)新增一个检查点 —— 守卫按检查点的名字放行上传,多一个名字,守卫和几处前置都要跟着改。(4)并进换完首页之后那一步(live 检查点)—— 见上「放在换首页之前」:那时再发现已经晚了。(5)设例外名单(比如放过受治文档里的断链)—— 受治文档里写断一条链接,治理站点就备不出发布档案,这正是要的:断链不该上线。与既有决策的关系:不取代任何一条。ADR-51 的上传档案闸一个字没动 —— 换首页的上传仍以 assets 检查点通过过为前提,只是这个检查点现在对每个入口都核;ADR-84「以核对命令为准、少了的单独补那一个」照旧,只多一种情形:默认域名全过、只有访问域名不过时,补传没有用。治理站点构建器的产物验收(--verify-dist)照旧:发布准备这一道比它严,最要紧的一处 —— 复制进产物的受治文档里的断链,构建器只提示不拦(源里本来就断,不归构建器修),发布准备一律拦,而且要到发布准备那一步才被拦、不是构建时(另外样式表里的引用、只差大小写、不带引号的属性值,构建器那一臂不核或核得松,发布准备都核);反过来构建器另核生成页的锚点存不存在,发布准备不核。两道都留着。落地时的只读实测(2026-10-08):五个站点各自最近一份发布档案按新规则空跑核引用,都是零条不过 —— 治理站点(发布号 20261008-182849)343 张网页、15 份样式表、2042 条引用;官网(20260915-164317)2 张网页、0 份样式表、8 条;后台(20260916-232231)1 张网页、24 份样式表、8 条;客户端网页版(20260916-234422)与师傅端网页版(20260916-234423)各 1 张网页、1 份样式表、3 条。拿治理站点线上现行那一版的发布记录副本(仓外)只读跑了一遍新的 assets 核对:默认域名与 harness.wowoway.cn 两个入口各 458 个文件,全部逐字节一致,没有被限流。仍查不到的(照实留着,不许读成「不会漏」):(a) 写法不在认的范围里的引用 —— 页面脚本运行时才拼出来的地址(治理站点从入口页点进各文档页的地址;后台与网页版按需加载的脚本名字对不对);href 与 src 之外的写法:图片的多尺寸写法、行内 style 与 <style> 块里的 url()、表单地址、自动跳转、<object data>、poster;带前缀或别名的属性(xlink:href、data-href、data-src、ng-src 这类,其中 xlink:href 是真会去取文件的);<noscript> 里的引用(照开着脚本的浏览器读,那里面只是字);只读 .html 与 .css 两种文件,.htm、.svg、.js、.json 里写的地址不读;样式表里用反斜杠转义拼出来的关键字认不出;锚点存不存在不核(井号后面的部分直接去掉);基准地址标签 <base> 不当解析的基准,哪个站真用了它,别的引用的判定会与浏览器不一样。(b) 读法到哪为止 —— 只照浏览器分词的规矩认哪些是标签、哪些只是字,不模拟它把标签搭成页面的那一层。那几种只当字读的标签写成自闭合(以 /> 收尾)时照空标签往下读:内嵌 SVG 里这是合法写法;普通网页里浏览器不认这个斜杠,这里照常往下读多数是多核,只有被浏览器当成字的那一段里又夹着没收尾的注释或引号时,更后面的真标签会被吞掉(漏)。内嵌 <svg> / <math> 里的 CDATA 段、不是自闭合的 title / style / script,以及 <select> 里面,判定可能与浏览器不一致(多报、漏报都可能)。五个站点现成档案里这些写法是零处;没有为那个漏报钉用例。(c) 会多报的 —— 属性值里的字符引用只还原 &amp; &lt; &gt; &quot; &apos; 与数字写法,别的命名写法(&eacute; 这类)原样留着,路径里用了它会被报成「清单里没有」;页面若直接引用发布清单 release.json 自己,也会被报成「清单里没有」(清单的文件表不含它自己)。(d) 「注释里的不算」只在发布准备这一道里成立 —— 四个部署脚本的产物闸里各自原有的、按文本扫「以 / 开头」的检查没动(不在这次的落点里),排在发布准备之前:后台与手机网页版只扫首页(连两个斜杠开头的也拦),官网扫顶层页面,治理站点扫全部页面;注释或脚本块里双引号写的以 / 开头的字样,仍会被前面那道旧检查拦下。(e) 一次发多个手机端时逐端准备档案 —— 后面的端引用不过,前面的端已经备好的那份档案留在盘上(它自己是干净的),整条命令退出码 1。(f) assets 检查点通过过一次之后再跑不过 —— 只记一笔失败、不撤掉先前那次通过;live 检查点的前提与守卫都还认先前那次通过,提示写着不要换首页,但这时没有机器挡。准确的说法只到这里:从没通过过这一步的档案,换首页那次上传(守卫写前在岗时)与 live 检查点被挡住。(g) 首页那一组之外一个文件都没有的站点 —— 访问域名一次都不请求,照样记「核了 0 个」并通过。(h) 访问域名上 4xx 是线上的真实回答、不重试 —— 网关若对连续请求限流回 429,这一步会判成访问域名不过(提示里叫做的第一件事就是先原样重跑一次);探路「超时」那一种床上没有走(要干等三分钟),它与「连不上」「三次都是服务器出错」走的是同一个分支。(i) 入口只认档案里记下的那一组 —— 网站注册表没登记的域名不核;档案准备之后注册表再改也不追。(j) 本来就不在这两步射程里的 —— 站外链接活不活;入口地址不带末尾斜杠的访问;上传那一两分钟里新旧页面混杂;各缓存节点此刻的副本(核对带防缓存参数直接回源,看的是桶里此刻的内容);页面画得对不对、脚本跑不跑得起来;核对通过之后线上再被改动。(k) 后台、两个手机网页版、官网「每个文件在访问域名上取得到」第一次真跑,是落地后它们各自的下一次发布;这条需求落地后只安排治理站点真发一次。
ADR-902026-10-08三层运作:一个主控会话守顶层、不办实施,每条需求线交给一个工作会话,具体的活交给 agent;做到一半遇到顶层问题按「继续做会不会做错或做不下去」分红灯停线与黄灯记下来;需求切小到一次封版收得了口;开闸、发布、全量测试由主控排窗口;四类架构与六层是两把尺子。这一条只立规矩、不改守卫为了:「主控立规」这条需求(这条线的第一条)。病根:这套体系的硬控都挂在「文件改了」上,「发现了问题往哪去」「这件事该哪个会话做」没有机器在管。ADR-75 定了领队只派活、执行体按层配齐,但没有分守顶层的会话与办需求的会话 —— 所有需求挤在一个会话里办,上下文一压缩,顶层的事与手上的活一起丢;做到一半撞上顶层问题,是停下来修还是先做完,没有规矩;宪法只讲六层,四类架构只在一句话里带过,执行体被叫作「第四类受治工件」,而项目架构又是「第四类架构」。用户 10-08 定:他平时只和一个主控会话说话,主控守「宪法 + 四类架构 + 六层」,专项的事交给别的会话与 agent,并且要拆成多个上下文。决策:① 三层 —— 主控只有一个,和用户谈、审计划、派工、排窗口、看账本,不起草计划正文、不写代码、不跑测试;一条需求线交给一个工作会话,从计划办到验收完结,自己带 agent;不改代码的小事主控直接派一个 agent。顶层(整个框架、各系统规范域、项目架构)的需求由主控立项,同一时刻只办一条;业务的工作会话不碰顶层。② 遇到顶层问题不是「停」与「不停」二选一,只看继续做会不会做错或做不下去:会,红灯,发现的会话当场自己停,顶层先修;不会,黄灯,记一笔、做完再修。③ 叫停与恢复不由主控说了算:发现的会话自己停,暂停与恢复由用户发话 —— 放行权归体系,不归任何一个会话,让主控一个会话决定谁停谁走会与它冲突。④ 需求切小到一次封版收得了口,大战线是一串小需求,停也是停在封好的那一步之后。⑤ 开闸、发布、全量测试三样全仓共用,由主控排窗口。⑥ 主控要记住的东西落在受治文件与账本里,不靠上下文;换主控选在两条需求之间,手上在办的顶层需求先办到验收完结,新的主控照项目架构设计页接手。⑦ 四类架构说设计写在哪,六层说谁管谁、属于框架架构;执行体改叫执行工件类,不再叫第四类。今天靠什么:大半靠纪律 —— 守卫分不出哪个会话是主控、哪条需求是顶层的,没有暂停这个状态,记下的发现不随需求履历留下来,换主控没有手续;机器已经管到哪,逐条写在架构详图 §十五 各段末尾与项目架构设计页「诚实边界」,这里不抄。与既有决策的关系:在 ADR-75 的角色上加一层区分,不取代它 ——「领队 = 一个会话里派执行体的那条主线、只派活、不替关口放行」照旧,主控与工作会话在各自的会话里都是领队;ADR-77 的组队照旧,工作会话可以组队。否决:(1)所有需求都在主控里办、不设工作会话 —— 主控的上下文会被占满,压缩之后忘事;顶层出了问题,守顶层的会话自己正陷在别的活里。(2)新增一个专管触发的 agent —— agent 自己不会醒,要有人派,没人派就等于不存在;触发要挂在钩子上,agent 只负责触发之后的活。(3)把记账方式整个从「按会话」换成「按需求」—— 那是在守卫最核心的地方动刀(ADR-50),本身就是一条最大的顶层需求。(4)硬控一口气全上 —— 它们全落在守卫上、同一个版本单元,只能一条一条排队,一口气上等于长时间开闸。(5)把「领队不许亲手改」「agent 不许越出写域」现在就做成硬拦 —— 只挡得住编辑工具,跑一个脚本就绕过,代价还大;先看结果单「谁写的」一栏的数据。没做的:这一条不预支任何硬控;用户只在主控签字、顶层按文件拦、暂停与恢复、发现的留存、换主控的交接与发布归谁,各自另立需求;一条顶层需求自己做到一半又撞上顶层红灯怎么办,这一条不定,留给暂停与恢复那一条。
ADR-892026-10-08部署门的待检清单按「这次发的是什么」数:治理站点、官网、手机网页版往线上放新内容时只数这个站点的原料目录;回滚与清理旧文件不看仓库状态;治理站点发布准备当场扫一遍要公开的内容。在这几种调用上取代 ADR-50 决策⑤(数全仓)为了:「发布只查原料」这条需求。病根:部署门拦云端写操作时有两臂 —— 先数待检清单(工作区里既不是存量、又没有收尾环干净结论的改动),再做发布前版本比对。ADR-50 决策⑤ 把待检清单定成数全仓、不问是谁的,理由是「推上生产的是仓库状态」。这句话对静态站点不成立:经 MCP 传上线的只是发布档案里那一份产物,它由站点自己的原料目录构建出来,仓里别处改了什么传不上去。于是这一臂数的是「工作区里此刻有多少在途改动」,不是「这次传上线的东西查过没有」。实测关着闸发治理站点五次、五次被它拦下:10-04 一个已结束会话留下的 21 个守卫文件,10-06 别的会话的 215 个文件,10-07 下午 300 个(含在办的计划看板与需求履历),10-07 晚上 694 个旧计划复制品,10-08 这些复制品删掉之后留下的 624 个「删除」—— 点名的文件没有一个在站点自己的目录里。此前只能请用户开闸才发得出去,而开闸期间写前的闸全不在岗;10-08 这一次用户要求不绕、暂时不发、先把这条判断处理好。守卫逼人绕过自己,就是设计错了(与 ADR-82 同一个教训)。连发布流程自己也会被它拦:首页核对通过时发布库往入库的发布台账追加一行,收尾环给这一行记下干净结论之前,紧接着的清理删除与回滚删除都过不去。而发布路上的另一个裁判早就换了口径 —— 发布前测试自 ADR-67 起由被发布物推导(发什么,就跑守着它的测试),检测这一半还停在数全仓,两个裁判不同构。决策:① 往线上放新内容的上传(发布档案的 assets、cutover),这一次调用恰好落在一个站点、而且站点认得出是治理站点、官网或手机网页版时,待检清单只数这个站点原料目录里的改动:治理站点数 x-harness/,官网数 x-website/,手机网页版数端目录、x-core/mobile/、x-core/tools/。② 原料目录不另写一份,取发布前测试已经在用的那一份定义(发布库 release/publish-tests.js 的 inputDirsOf),两边永远一致;路径从仓根开头逐段比,中段带同名字样的、只是前缀相同的别的目录都不算。③ 站点是哪一个,从这次调用要传到的托管目录认,不信发布档案自己写的种类 —— 只拿档案记的种类对一遍,为空或对不上就不收窄。④ 认不出发布物的一律照旧数全仓(只会更严):站点是后台、站点不在手机端名册里、一次调用跨站点(涉及的站点不是恰好一个,两个手机端同传也算)、档案记的种类为空或与站点对不上、发布库装不上或抛错、原料目录为空、含空串或不含站点目录。⑤ 不往线上放新内容的静态托管调用 —— 回滚上传、回滚删除(首页换回已核对之后)、清理清单里的删除 —— 不看仓库状态:云端策略放行它们时不带「进部署门」的标记,于是部署门里「看仓库状态」那一整段都不进 —— 不只待检清单与发布前版本比对两臂,这一段开头的量仓(先用版本库命令把工作区量一遍;版本库命令出故障、真仓里仓根却不是版本库、会话台账首次建立,这三种情形本来都按拦处理)与这一段的部署门总时限检查(时限用完按没过算的那一道)也都不发生。它们只由上传档案闸把关(必须来自在用的发布档案、检查点顺序对、删的在清单里;这些判据一条没动)。⑥ 治理站点的发布准备在产物验收之后、打发布档案之前,当场对受治文档树与站点目录各跑一遍治理规范的扫描(含查真实手机号、证件号、密钥、邮箱的那一条),有一处不过就不准备发布,线上零改动。⑦ 被待检清单拦下时,报文写明这次只数了哪些目录、范围外另有几个没数;开着闸时的写后补判与写前拦截走同一份代码,判法自动一致。收尾时提示「有无主改动复核未过」的那一句附注跟着改说法:不再一概说部署门会挡,只说发布时落在部署门待检范围里的会被挡。⑧ 待检清单之后的发布前版本比对不动:往线上放新内容时,仓里任一版本单元没封版、封版后改过,照样拦。⑨ 算范围的判法住守卫新增的一个小零件(范围零件 .claude/hooks/guard/hosting-scope.js):它不碰磁盘、不装别的零件,手机端名册与发布库的原料目录取法由守卫主文件装好交给它,装不上就交空的 —— 名册空了,手机端一律认不出;取法空了,哪个站点都认不出;认不出就照全仓(④)。范围零件自己用到才装;它自己装不上,走守卫启动失败那条路 —— 退出码 2,这一次调用被拦并点名坏的零件 —— 不悄悄照全仓。两种「装不上」走两条路:发布库是守卫之外的东西,它坏了守卫退回更严的判法;范围零件是守卫的一部分,它坏了就是守卫坏了,守卫坏了一律不放行。按范围数的是会话台账的待检清单,它多一个可选的范围参数,不传就是全仓;范围的写法它认不出时照全仓数,并如实告诉守卫「这一次没按范围数」,报文也就不说「只数了」。为什么回滚与清理不看仓库状态:回滚传的是发布前从线上取回的原样,清理删的是检查点按宽限期算好的旧文件,两样都不把仓里的任何新东西放到线上 —— 仓里此刻改了什么、哪个单元没封版、版本库此刻量不量得出来,都与它们无关。所以跳过的是「看仓库状态」那一整段,不只其中两臂:量仓时的三种拦与这一段的总时限检查问的同样是仓库状态,留下任何一样,回滚就会被一件与它无关的事挡住(版本库正好出故障的时候,往往也正是要回滚的时候)。拦住它们保护不了任何东西,只会让发布出了问题时回不去。它们的风险是传错、删错,那归上传档案闸管 —— 这道闸照旧每次都判,回滚并不是什么都不查:不来自在用发布档案的、检查点顺序不对的、清单外的,照样拦。为什么不把治理站点要公开的五百多份受治文档放进待检范围:治理站点发出去的不只是 x-harness/ 里的文件,还有它渲染的受治文档(宪法、规则书、架构页、需求履历)。这些文档绝大多数归某个版本单元 —— 封版要求检测零红,发布前版本比对守着「没封、封后改过」。把它们全放进待检范围,别的会话每封一版,干净结论所带的判据组指纹就变、它们的结论全部作废,发布又回到「等别人收尾」,正是这次要治的病。剩下的缺口是不归任何单元的那一小部分(在办的需求履历),所以改成发布准备当场扫一遍:扫描每次都对受治文档树与站点目录里治理规范管得到的 md 与 html 重新判一遍(存没存档都判 —— 待检清单只看还没存档的改动),不读台账里的旧结论;10-08 实测受治文档树三百多个文件、站点目录不到十个文件,零违规,各两三秒。它跑的是整份治理规范、不只查敏感数据那一条,所以别的会话在受治文档里任何一处在途的红,都会挡住治理站点发布 —— 卡的是要公开的内容,但它仍是「等别人改好」的缩小版,没有根除。需求履历里人读的那一份是 md、扫得到;原样印进页面的 json 附件扫不到(见「仍看不见的」(b))。没收窄的:后台 —— 后台构建会把各端与云函数的权限声明一起编进包,原料不止 x-admin/,而发布测试那份定义对后台只列了 x-admin/,照它收窄会少查;云函数(另有测试床门、内核装配闸、上传内容闸);云存储、数据库、权限、网关路由与域名这些其余的变更类调用。这些调用上 ADR-50 决策⑤ 原样有效,关着闸时仍可能被无关的改动拦,另立需求再治。仍看不见的:(a) 待检清单这一臂只看得见还没存档的改动,存档之后一个都不数 —— 它本来就不是墙,守卫自己的报文里写的也是「粗粒度」;墙是发布前版本比对与发布前当场跑的测试,这两样没动。(b) 公开内容扫描只管 md 与 html 两种文件。治理站点取材面里的 json 它够不着:需求履历的 record.json(原样印进页面)与 releases.json、项目架构目录下其余 json、架构设计模板名册,各单元的锁清单与系统架构页的链路图数据同属这一类;.claude 之外只把版本号印上页面的文件也够不着:x-core/server/package.json、x-admin/package.json、移动端母本包各包的 package.json、各端的工程配置。这些文件两次扫描都不看,也都不在治理站点的待检范围里(待检范围只有 x-harness/);原来数全仓时同样查不到它们里面的敏感数据(那一条判据只对 md 与 html 生效)。记给治理规范的维护者。(c) 原料目录信的是发布库那一份定义:它写窄了,待检范围跟着窄。守着这一份定义的有两样:发布库受写保护、归整个框架这个版本单元,改它要升版封版、跑技能面的床;守卫面有两张床(包着主自测的那张薄壳床、会话台账床)在床头点名了发布库这一个文件(写明「我测的东西里有它」),它一变这两张床的旧记录作废、守卫面要重跑。范围零件自己的床不读发布库,不在此列。(d) 以后新增站点类顶层物默认不收窄(照全仓):认得出的站点写在范围零件里的一张小表上,要收窄得在那里登记。(e) 别的会话封了一版之后,站点原料目录里它名下改动的旧结论要等它再收尾一轮才算数;范围只剩站点自己的目录,很少碰到。与既有决策的关系:取代 ADR-50 决策⑤ 在下面这些调用上的适用 —— 治理站点、官网、手机网页版往线上放新内容的上传(改成只数原料目录),任何站点的回滚上传、回滚删除与清理清单里的删除(改成不看仓库状态);其余调用上决策⑤ 不变。取代 ADR-51 决策①「通过的仍进部署门」对回滚与清理的适用(上传档案闸自己的判据一条没动)。给 ADR-51 否决栏「守卫依赖发布库代码」开一个口:部署门取原料目录时加载发布库的那一个函数。理由:发布出口这份脚本此后已进守卫的写保护、并归整个框架这个版本单元(改它就是改框架),不再是当时说的「材料」;装不上、抛错、返回的目录不可用,一律退回数全仓,发布库坏了守卫只会更严(范围零件自己装不上不走这条路,见决策⑨);不这样就得在守卫里另抄一份原料目录,两份定义迟早对不上;先例是运行时配置闸早就加载同一技能下的配置登记表。上传档案闸照旧只把网站注册表与发布档案当数据读。否决:(1) 继续数全仓、只让复核更快、结论更不容易作废(去掉无主改动每轮查 40 个的上限、让封版不再作废结论)—— 拿历史五次对了一遍:两次照样拦,另三次上传能过、换完首页之后的删除仍被发布台账那一行拦住;它还要改「什么算检查过」这条最核心的规则,面更大。(2) 让部署门被拦时自己当场跑检测 —— ADR-82 否决过(每次发布拖慢几分钟,而且与收尾成了两套判法);这次再核一条:守卫写前的总时限只有二十几秒,检测跑不完就只能放或拦,两头都不对。(3) 给某些目录开一张「不用查」的排除名单 —— 名单会越加越长,而拦住发布的可以是任何目录;按「这次发的是什么」定范围才是根。(4) 治理站点的待检范围直接用它那五百多份受治文档的清单 —— 见上。(5) 在守卫里另写一份原料目录 —— 见上。这一条没动的:无主改动每轮查 40 个的上限、干净结论随判据组指纹作废、无主批次怎么记账、干净结论与红结论并存时认哪个 —— 上一轮方案碰过这四处,这次一处没改,留给守卫盘点。
ADR-882026-10-07一条需求验收完结之后,它交付的文件只要内容没再变,就不算任何会话的范围外改动:判据是「此刻的内容 = 它验收那一刻结果单上记着的内容」,不看写证据、不看是谁写的病根:「归已完结需求、不算越界」原来只有一种认法 —— 落在它的范围里、本会话最后一次写它在它完结之前,而且只认编辑工具的写证据。封版命令写出的变更历史与锁清单没有写证据;它们写入的时刻又可能落在别的会话一条命令的运行期间,被命令时间窗记到那个会话名下。10-07 真仓:「托管限流」验收完结之后,它封版写出的两份文件(部署规范的变更历史与锁清单)在另一个会话四条在办需求的三查单上都成了「本会话 2 个范围外改动」,第一查红、验收签不上,而那两份文件的内容与「托管限流」验收那张单子上记的一字不差。决定:判定器多认一种情形 —— 文件此刻的内容指纹等于某条已完结需求验收那一刻结果单「范围里的改动」上同一路径记着的指纹,就归那条需求;内容再变就不再豁免。结果单取账本目录里落盘的那张,并且只认完结那一笔记下编号的那张(编号对不上、内容照编号的算法重算对不上、单子不在,都不认、不报错、照旧按写证据判)。收尾对账的两支与三查结果单仍共用一个判定器,结果单用到才读。否决的做法:① 让封版命令给自己记写证据 —— 只治得了封版命令这一个写入者,别的命令写出的派生件照旧误报,而且写证据记在谁名下仍取决于谁跑的命令,治不了「记到别的会话名下」;② 把已完结需求范围里的文件整片豁免 —— 完结之后再改它们就没人管了;③ 改命令时间窗的归属算法 —— 那是会话分账的脊柱(ADR-50),动它的面比这一处大得多,归守卫盘点那条需求一起看;④ 让受影响的会话重记基线 —— 基线是签字那一刻的事实,重记等于把签字之后的改动一起洗掉。边界:结果单编号只有四位,是「对不对得上」的核对、不是防伪造的强度;临时目录清理之后这类文件会再被点名一次,方向是多拦不是放行;完结之后用同样的内容重写一遍不算改动(仓里没有任何东西变)。
ADR-872026-10-07复盘只对着签过字的标准逐条判、标准之外的发现记遗留;任务说明给出上一次复盘之后的改动与机器检查的结果、预算十分钟;每条需求可以登记固定检查,一条命令跑完、按内容记账病根:复盘任务说明只写「你的立场是这活儿有问题、要证明它错」,找到任何一条就判不过,题目没有边 ——「入口页模板」入账复盘十五轮都不过:前七轮挑出的是页面上的真毛病,第八到十三轮以守卫够不够严为主,最后两轮页面全对、只剩守卫,而且连着三轮是同一件事换一批更怪的写法。机器检查的结果又没有一个固定的地方给复盘者用,他每一轮从头重做、工具每轮重写:实测最近两轮复盘本身 54 分与 75 分,其中在真浏览器里重点老页面 17–30 分、重截图 4–13 分、读材料与现写工具 20–28 分,而第十五轮之前页面一个字没改。用户 10-07 原话「十五轮了依然无法闭环……一轮下来一个多小时……如果十分钟一轮……只要不复杂化,多几轮也不是不行」。试跑(10-07):同一个执行体、同一个模型,只换任务说明的写法并把机器检查并成一条命令 —— 一轮 12 分钟、工具调用 30 次,五条标准逐条达标、结论过,标准之外六条记遗留。边界:判法写进程序生成的那一份任务说明,只有一种复盘;结论行的固定格式、派发闸(只派对抗审查者、提示词逐字等于程序生成、连续三次不过要用户发话)、「最新一次入账复盘过了才能完结」都不变。增量清单由生成程序留底在需求账本目录的普通文件里,必须与账本里那一笔复盘的范围指纹对得上才用,对不上按全部看。固定检查的清单与脚本住各条需求自己的计划目录、随计划归档,值得长期留的在固化时转成测试床;结果按「范围里的改动清单 + 清单与脚本的内容」记账;同一时刻最多两项;每项结束把它起的进程连同子孙一起关掉;登记了而没全过,三查第二查红,没登记的计划单子与编号不变。否决:给复盘设轮数上限、到上限由用户签「带遗留完结」(用户 10-07 驳回:那是绕开问题,闭不了环的原因是题目没有边、每轮从头全查,不是轮数);另写一份「快复盘」的任务说明与原来那份并存(两套口径);复盘改在施工中做、过了再封一次(要动「复盘绑定封版后的内容」的算法,收益只是少几个版本号,判法改了之后复盘通常一两轮就过,先不做);由机器解析遗留(保持简单,机器只认结论行)。守不到:遗留只在复盘者的报告里;预算靠复盘者自觉;固定检查读了范围之外会变的东西,指纹不知道;无头浏览器的页面在本机会列进任务切换,限两项只是减轻。
ADR-862026-10-06签字题对话框里一项固定写法的「全选执行:确认 〈名〉」选项认成签字(一键签);给 ADR-78 / ADR-79「选项标签一律不认」那半句开一个口,其余标签照旧不认病根:10-03 把签字搬进看板签字区、10-04 又要求贴回经对话框,为防执行者把结论写成选项替用户签,守卫对选项标签一律只记成话 —— 一刀切的代价是每次签字都要复制粘贴,用户 10-06 原话「会话选择里面也要新增一个全选执行……不需要复制」。边界:只认「全选执行:确认 〈名〉」/「全选执行:验收完结 〈名〉」一种写法、一个意思(每组都对、没有意见);看板签字区必须是最新的(核对命令写进签字区的内容编号 = 当前编号、那一道的头对得上,验收还核结果单编号),不是就不认并写明;认成签字后走与贴回同一份判法,账本那一笔记 via:'ask-all'(履历分得出逐条勾的与一键签的);有意见那条路不变(看板里不勾、写意见、贴回)。否决:放开所有标签(回到被防的那件事);只在顶部说一句、不标条目(治不了要在 23 条里找)。守不到:一键签省的是复制粘贴不是「看过看板」,用户没打开看板也能选,机器只核签字区是最新的。
ADR-852026-10-06签字一那一笔把编号盖住的内容原样留底;签字作废重签时签字区逐条对底、只标改动(竖条 + 底色 + 标签三通道、改动段标黄、折叠旧句、横幅写数字、「只看改动的」按钮)病根:签字那一笔只记编号不留内容,刷新签字区时拿不到「上次签的是什么」,只能全列、只能说一句「内容改过了」;同一需求因措辞订正连签四次,用户 10-06 原话「每次签字都是签同样的东西……否则我每次都要 23 条全部看一遍,非常痛苦」。边界:条目身份 = 组 + 标签(需求 / 标准 N / 用例 N / 落点目录),范围组只比目录在不在;改动段按句读切(改一个字整句黄,宁多标不漏标);没变的原样不变灰(用户定过禁灰色次要文字);留底与编号同一笔、账本带链改不了;老账本(那一笔没留底)从签字那一刻钩子建的在办履历取底,履历重算出的编号等于那一笔的编号才用(履历剥过计划路径,剥过字的对不上),两样都没有横幅写明分不出、一条都不标;第一次签字零标记;验收区(签字二)本次不标。否决:靠版本库比对上一次镜像(签字不在版本库里,提交是用户的事);只在顶部写一句(还要在 23 条里找);默认藏起没改的(签的是全部,藏了等于没看就签 —— 做成按钮、默认全显示)。
ADR-842026-10-06静态站点的备份由发布检查点直接从公开默认域名取回并定格,不经 MCP;仍经 MCP 的上传、换首页、逐文件删除写明调用做法(一条一条调、报限流等两秒再试、以核对命令为准、不对整个站点目录列清单)为了:「托管限流」这条需求。病根(官方文档 + MCP 源码 @cloudbase/cloudbase-mcp 2.34.8 + 10-06 治理站点发布实测):① 官方只写了一句 —— 静态托管管控接口 DescribeStaticStore 每秒 20 次,批量删除每秒不超过 10 次,报 frequency limit 等 1–2 秒再试;下载静默少文件、列清单断线官方都没写。② 据 2.34.8 版源码:MCP 下载目录开头打 1 次管控接口、之后每个文件 1 次、最多 20 个并行,单个文件「任务被拒绝」那一类失败被结果数组吞掉、整个调用仍返回成功 —— 大目录大概率超限且静默少文件(例外只有第 ⑥ 条那处写反的缓存判断;实测整站 439 个只到 62 个;六个小目录同时下,一条报限流、另一条返回成功却少 3 个;小目录逐个下 60 多次全到齐 —— 只是大概率不超限,不超限也不等于内容对,见 ③;这一步占了发布的大半时间)。本地写文件出错不在那一类里,它是未捕获异常,而 MCP 入口对任何未捕获异常或未处理的拒绝都直接退出进程,表现为断线。③ 据源码,MCP 下载单个文件就是从公开默认域名 GET,不带防缓存参数、不看状态码(线上没有的文件会把 404 页存成文件,错误页或旧缓存照样被存成文件)。④ 据源码与实测,上传按一次工具调用算 2 次管控接口(工具先查一次、上传时再一次),之后不逐文件打(447 个文件一次到齐,个别文件没传上调用仍返回成功);删除按一次调用算 2 次(删之前一次、删完工具自己再列一次做核对),失败不是静默 —— 底层把异常收成错误项,工具层读出来并返回失败。⑤ 对整个站点目录调 queryHosting findFiles(大 maxKeys)让 MCP 整个断线,三个会话都断在这一步。⑥ 上游另有一处写反的缓存判断(站点信息本该缓存两分钟,实际是两分钟内每个文件都问、同一个 MCP 进程里停够两分钟没下载之后就不再打管控接口,直到进程重启),解释了整目录下载偶尔能一次下全 —— 靠不住。决策:发布库的 backup 检查点(create-deploy.js --target=release --step=backup --dir=<档案>)本来就从公开默认域名逐个取线上文件(带防缓存参数)做比对,改成把取到的内容写进 <档案>/backup、逐字节核对;有任何一处不放行就一个字节都不写,写完重新取指纹再比;通过后定格,重跑只核对备份目录与当时记下的指纹、不读线上、不写备份;备份目录已有文件时补齐缺的、已有的只比指纹不覆盖,已有但与线上不一致的、本次要写的路径线上没有备份里却有的照旧报错不放行;线上已有却不在上一版清单里的要写路径只打印一行提示、不拦(备份照线上此刻的内容取,回滚回到的就是那个样子)。备份一步零次 MCP 调用。备份只取回本次要写的路径之后,清理旧文件原来靠「备份里有整个站点」找候选会恒为空(旧文件只增不减且不报错),补法是清单接力:发布清单 release.json 加一栏 lingering(不属于本版、但线上还在的文件),准备档案时读线上那份上一版的清单、逐个探测它那一栏里的文件还在不在(release/relay.js,只读线上一次、线上零改动;线上没有清单按没有可接力的算,读不出来就拒绝准备、不留半个档案),本版这一栏 = 上一版清单里有而本版没有的 ∪ 上一版那一栏里线上还在的(plan.js 的 relayList),备份时一并取回、清理候选照旧从备份目录算;已经删掉的在下一次准备时剔掉,这一栏不会越记越长。准备档案因此不再是纯本地,但线上仍零改动。第 2、3、4 步仍经 MCP,调用做法统一四句:一条一条调、不并发;报限流等两秒再试;以核对命令为准(上传时个别文件没传上调用仍返回成功,删除失败工具会返回失败 —— 两样都以核对命令的结论为准,每步之后跑一次、少了的单独补那一个);不对整个站点目录列文件清单(上传成功后 MCP 返回里建议的 findFiles 不照做)。部署规范域同批:条款书加「经 MCP 的托管调用不撞限流」一条,判据加「四个部署脚本里出现 MCP 下载指令即红」一臂,架构页加「托管调用与限流」一节把来源分三类(官方文档、源码、实测)记清并写明对应的 MCP 版本。否决:只写说明、不改脚本 —— 每次发布仍要 60 多次 MCP 调用,「按小目录一个一个下」本身是在绕 MCP 的缺陷,不是办法;利用上游那个写反的缓存判断(先下一个文件、等两分钟、再整目录下)—— 靠的是别人的缺陷,MCP 配的是自动用最新版,哪天修了就失效;让脚本拿腾讯云密钥直接读存储桶 —— 要把密钥交给脚本,而站点本来就是公开的,从公开域名取回的就是它对外提供的内容,用不着密钥;给守卫加新拦截(拦整目录列清单之类)—— 要动守卫,会出事的调用已经不在流程里,且守卫盘点那条需求别的会话正在办、不在这里叠加改动。判据也只管「部署脚本不许打印下载指令」这一臂,不去管有人在对话里手动调 MCP —— 那一刻判据看不见,靠条款书写明,和流程里已经不需要它来兜。后果:备份目录的格式没变,回滚底本仍是发布前线上的原样;想退回去只需把第 1 步的打印改回原样。守卫里给 manageHosting 下载留的落点口子(发布档案 backup/)未改,流程不再用它。备份取的是公开默认域名此刻对外提供的内容,与此前经 MCP 下载同源(据源码,MCP 下载单文件就是从这个域名 GET),没有引入新的信任面。诚实边界:findFiles 为什么会让 MCP 断线没有证实 —— 源码里那一段只是普通的查询;三条线索(未证实):返回体里每条记录被完整输出两遍并带缩进(一千条估算在 1MB 量级),maxKeys 没有上限校验,MCP 入口遇到任何未捕获异常就退出进程;新流程不调它,这一处记在架构页「没查清」里。清单接力三处边界照实不处理:改造后的第一次发布认不出此刻已留在线上的更早版本文件(上一版清单还没有这一栏,按空算);回滚之后被撤下那一版的带指纹新文件不在任何清单里;旧式发布留下、不带指纹也不在任何清单里的文件,接力永远认不出 —— 三类只占存储、不影响访问,留一个手工入口:发布前把要清的线上旧文件放进档案的 backup/,清理会把它算进候选(这类文件不与线上比对,只按名字进候选)。探测 2026-10-06 对治理站点真实线上只读验过:默认域名上,在的文件回 206(只取回 1 个字节)、不在的回 404;自定义域名的网关不认区间请求,在的文件回 200 全文、不在的回 404 —— 两种探测都判对;relay.js 读真实线上的发布清单成功(发布号 20261005-235014,449 个文件;这份清单还没有 lingering 字段,按空算)。接力清单里真有旧文件、要探测并剔除的那条路,真实线上要到改造后的第二次发布才会走到。第 ②–⑥ 条是对 2.34.8 版源码的读法,MCP 升级后行为可能变,架构页写明结论对应的版本;MCP 的三处缺陷要不要反馈给官方,等用户定。
ADR-832026-10-05项目架构是第四类架构:「需求 → 实现 → 部署」这条流水线自己的设计页(版本单元)、五道硬门各写射程边界、每条需求一份钩子一次写成的封存记录;三道门补硬控(签字门核落点单元、封版把「为了」解析到签过字的需求并写进锁清单、发布前比对核基线之后的版本都绑着需求);取代 ADR-73 否决栏里「另建长期需求档案」那一句病根:10-05 发布修补完结、计划删掉之后,用户在治理站点上找不到任何一条需求的闭环证据(原话「我如何确定你 plan 是已经闭环的啊」「至少要加入一个项目架构才对啊」),第四次发话定义:项目架构就是需求到实现到部署这条流水线本身,要硬控、要与业务架构、系统架构、框架架构串联。照代码核实:五道门都在、各有写明的守不到之处,但没有一页说它是什么;证据只在本机账本、各单元变更历史、本机发布档案三处;三类架构里没有「需求」这个单位;封版只要求「为了」后面有字,发布门不问发的是不是签过字的需求的版本 —— 「需求 → 部署」在最后一步是断的。决策:① 立 arch/project/ 为第四类架构:设计页是版本单元 project:overview(锚只认设计页、版本在页头标记、履历不进锁);每条需求一份履历 requirements/<需求名>/(签字一建、验收完结先写履历与指纹进账本再记完结、发布段只由重算命令追加),它是封存记录不是派生件(来源产出后不可重算),跨机器只剩自核与脊柱写保护、如实写进诚实边界。② 门一加「落点单元必须是契约认得的单元 id 或 none、短名不撞履历」。③ 「为了」定机器形态「为了:<短名>」,封版解析到恰好一条签过字的需求(在办查账本、已完结查履历)且其落点表列有本单元,需求名与签字编号写进锁清单与记录行互核。④ 门五装在两条发布通道共用的发布前比对里,核「基线之后封的每一版锁清单带着需求」,不读账本、不推发布面;基线 frozenBefore 第一次封项目架构时按各单元锁清单版本写、没写之前不判。⑤ 需求的终点是「已发布」,按格判:有入库台账的站点类按锁清单(发布当时)或台账时间(事后)记;微信原生包、云函数、数据表记「发布无记录」;框架、规范、项目架构记「已生效」。⑥ 治理站点加第四栏,站点根白名单加第六页。否决:发布门在发布那一刻读账本判签字作没作废(第三稿)—— 别的会话一改计划就把部署会话锁死,且没有安全收益(封过的版本不会再变);发布门要求「已完结」(第二稿)—— 业务需求要先发云函数用户才能验,两头互锁;发布面按通道推单元 —— 只守得住一条通道、官网推出零单元;计划留着当档案(09-29 用户亲自否,不推翻);把账本搬上站点(本机、不入库、能被脚本改)。与 ADR-73 的关系:取代它否决栏里「另建长期需求档案(永远只有一份的是业务架构,用户 09-29 亲自否)」那一句 —— 09-29 撤回的是「把计划留下来当档案」,今天加的是钩子写的封存记录,计划照删;「删除是对的」保留。代价:改框架期间(框架施工中到封版)既有的版本比对会拦住部署会话的一切发布;封版多一条格式要求;起新需求时短名不能重用旧名。
ADR-822026-10-04归属多一类情形:主人会话已结束(最后一笔台账事件在 24 小时之前)的改动按无主处理,由任一会话收尾顺带复核;给 ADR-50「他会话的留给它自己收尾」补上终止条件病根:按会话分账(ADR-50)把干净结论按(文件、内容、判据指纹)记,判据或引擎一变旧结论作废;收尾环只复核本会话与无主的改动,别的会话的留给它自己。两条合在一起有一个没人写出来的前提:那个会话还会回来。守卫提速会话 10-03 结束后,别的会话改了检测引擎,它留下的 21 个守卫文件改动的结论全部作废、再没人复核,部署门把 10-04 的治理站点发布拦住,只能开闸绕过 —— 守卫逼人绕过自己,就是设计错了。决策:归属分类时,一个改动的全部主人会话都已结束就按无主处理(保留原主人供报文点名),接进无主那条路:不拦人、只出结论、每轮最多 40 个、结论按内容记回;「已结束」= 它最后一笔台账事件在 24 小时之前,本会话永远算活着。为什么是 24 小时、为什么不是别的办法:守卫看不见会话活没活着,台账是唯一可观察的事实,一个会话一天没记过任何事件就不会来收尾了;刷新基线或手改台账能把这批清掉,但那是洗白(绕过「结论按内容记、判据一变旧结论作废」);让部署门自己跑检测会把每次发布拖慢几分钟,且与收尾两套判法。边界:判成已结束的只是多被别人复核一次,不拦人;归属的其它用途(越界点名、三查「谁写的」)照旧按写证据;活着但闲了一天的会话的文件会被别人复核,无害。
ADR-812026-10-04复盘结论绑住复盘者看的那份看板正文(剥掉签字区);推翻 v4.4.5「复盘结论不绑看板正文」的设计取舍病根:第十七次独立复盘指出复盘结论只绑范围内文件的指纹与内容编号,复盘「过」之后执行者改设计页、洞清单,复盘照旧算数,而用例 10(洞清单)、用例 11(最新方案)让用户亲手验的正是看板正文;v4.4.5 不绑的理由是「绑了连打勾都要再复盘;看板由用户验收、复盘者验代码」。决策:绑。任务说明生成时记下看板正文的指纹(剥掉核对命令自己写的签字区,与结果单编号用的同一份),守卫在复盘者收尾时记进复盘那一笔,第一查多一支「复盘之后看板正文变了(要再复盘)」。为什么现在成立:签字区是派生块、算指纹时剥掉,刷新签字区不作废复盘;步骤的勾在派复盘之前就该全勾(第一查红着派不出可信的「过」);复盘之后执行者本来就不该再动看板 —— 要改就再复盘一次,这正是用户要的「看板与机器说的一字不差」。边界:旧的复盘记录没记这一项,不判;复盘者看的是生成任务说明那一刻的看板,派发到收尾之间执行者改看板同样作废(账本里那一笔记的是生成时的指纹)。
ADR-802026-10-04签字在看板里单独一个「签字」页签:逐条明细各一个勾、每组一个总勾、底部悬浮的「复制结论」;范围的目录一个不省病根:ADR-78 的签字区把范围写成「六个目录 等」、三样各一个勾,用户 10-04 推翻:「必须是明细啊!太粗了,你看你说了个『等』字,我怎么知道我需要签字的有哪些啊!而且你需要在模板里面单独有一个 tab,就是用来专门用于签字的,而且里面就是一个一个明细的签字条目和内容,然后底部是一个悬浮的确认按钮,意思就是不用滚动到底部即可看得到」。决策:① 计划模板加第七个页签「签字」,签字区标记搬进去;② 需求确认区按组列明细:需求组 = 这条需求 + 每条「怎样算做完」+ 每条自动用例(预期 / 作证 / 测试),范围组 = 落点表每一个目录(按单元 / 格),清单组 = 每条要亲手验的用例(在哪看、怎么验);每条一个勾一个意见框,每组一个总勾(勾它 = 全勾);③ 底部悬浮条:进度、总意见、「复制结论」;④ 复制出来的结论仍按三组写(守卫认的三样与判法不变),组里没勾的条目与意见并进那一组的意见。边界:明细只是展示与勾选的粒度,锁住的内容与编号不变;验收区每条要亲手验的用例本来就是一条一勾。
ADR-792026-10-04签字区的结论经执行者弹出的对话框粘回:对话框只接粘贴、不设勾选项;守卫认输入位里的整段、不认选项标签;复制按钮连成一行;补 ADR-78 的「贴回」落点病根:ADR-78 把贴回写成「贴回对话」,流程就停在「等用户贴」—— 10-04 用户看到停下的对话问「你怎么停下来了?你不是应该是一个对话框让我签字吗」,并说清:「通过一个对话来强制我把复制的内容粘贴回来……指定某个文件,审阅里面的东西,点击复制审核内容,然后粘贴到你给我的交互行中,然后提交」。「去掉勾选题」与「必须有交互」不矛盾:去掉的是在对话里替代审阅的勾选,要的是审阅完的结论有一个接它的入口。决策:① 刷新签字区之后执行者弹一道对话框(AskUserQuestion):题目写明看板路径与三步,选项只放不构成签字的话(打不开 / 稍后再弹),用户在「其他」输入位里粘签字区复制出来的那段提交。② 写后守卫对答案按与说话同一份判法认(parseBoardSign / 固定句),但答案整段等于某个选项标签的只记成他说过的话 —— 标签是执行者写的,否则把签字结论写成标签、用户一点就替他签了。③ 复制按钮把结论用「|」连成一行(粘进单行输入位不被换行截断),守卫换行与「|」都认;直接贴到对话里照旧认。边界:对话框只是接口,签字的真伪仍靠编号与看板一致的核;平台「其他」输入位接不接多行粘贴没实测,所以连成一行。
ADR-782026-10-03两次签字从对话里的选项题搬进看板签字区:核对命令生成「需求确认区 / 验收区」,用户勾选、点「复制结论」、把整段贴回,守卫只认这段与固定的那一句;取代 ADR-74 决策①与 ADR-75 里选项题的形态病根:ADR-74 / ADR-75 把签字做成对话里的多选题 —— 一道题最多四个选项、放不下就连弹几道、用户在题里打字还要「先回答再重弹」;10-03 用户看到两道「验收完结」题当场推翻:「我在哪里看啊!你的 plan 地址呢!……不再需要在这里给我一大堆的打勾勾确认,而是给我访问地址,让我在需求的 html 中全部处理完之后点击一个类似复制结论的按钮,然后把结论复制到这里给你即可」,并拍板「对话里的勾选题全部去掉」。决策:① 签字区由核对命令写进看板 <body> 开头的一对标记里:没签字 / 签字作废是需求确认区(需求 / 范围 / 要你亲手验的清单[/ 动不动钱]各一个勾、总意见框、「复制结论」),在办且落盘的单子全绿是验收区(验收单 + 每条要亲手验的用例各一个勾一个意见框,带在哪看、怎么验),有一查红写明哪一查红、不开,完结写「已完结」。② 复制出来的结论有固定形态(首行那一句、每样一行「对 / 不对」可带意见、可一行总意见、末行带内容编号与结果单编号),守卫在用户说话那一刻认它:编号对不上就说签字区旧了,全「对」才签,有「不对」记「不过」且意见就是原因,少一样不算,夹着别的行只记成他的话。③ 结果单编号剥掉签字区再算,刷新签字区不改编号。④ 写前不再挂选项题;选项题的答案只记成说过的话,选项题仍只用于普通决策。⑤ 打字说「确认 <名>」仍算签字一;「验收完结 <名>」不带单子编号不算。边界:签字区是派生块、看板是免检面,勾与贴都是用户的意志,机器只核「对着的是不是当前内容与当前单子」;浏览器里的勾不保存。版本:用户 10-03 拍板主版本暂留 4(「暂时不改 V5,知道最后确认没问题了,我会告诉你切换为 V5」),这一版改写了签字契约仍只升第二位记 v4.8.0。
ADR-772026-10-03团队模式进强制层:领队是主会话,队友过同一套写前拦截;关口挂在「执行体停下」;带执行体身份的事件不认签字;两个执行体同时改同一个文件写前拦;执行体之间的写域只列不拦依据:两次探针(仓库外一次性小项目,平台 2.1.287,单窗口方式)实测 —— 队友与领队同一个会话号;队友的工具事件照常触发项目钩子并带编号与名字(名字是组队时起的,不是执行体定义名);钩子退出码 2 对队友的写前、「执行体停下」都管用,被拦后再停时输入带「已拦过」标记;领队发给队友的话不触发「用户说话」;队友拿不到选项题工具;这个版本没有建任务的工具,「任务完成」那个钩子不触发;队友没被停掉就一直列在收尾输入的后台任务里(闲着也算),每闲一次触发一次「执行体停下」;被领队直接停掉的队友不触发「执行体停下」;带预填答案的选项题照常弹、不认预填。决策:① 归属不改:同会话号,会话台账、三查、封版天然把队友的改动算本会话;写证据与命令记录多带执行体标记,结果单列各执行体各写了几个、两个执行体(按编号分)都写过的文件点名;「谁写的」那一栏出现才进结果单编号。② 停下来那道关挂在「执行体停下」:它用编辑工具写过、此刻内容还是它写的那些文件增量检测有红项就拦,同一个状态只拦一次、一次停不下来最多连着拦五次(真停下过之后重新数),查过干净的不重查,判不了或拦够了放行都记一笔;只查检测,测试留在领队收尾。③ 带执行体身份的「说话」与选项题不认签字、不记成用户原话,执行体弹签字题拦;包着队友标签的话同样不记。④ 另一个执行体十分钟内写过、之后还没放手的文件,这个执行体再写,写前拦。「放手」= 它写完之后自己停下过,或被领队按名字停掉(领队停队友那一下由写后钩子补记)。⑤ 还有队友活着时,领队的收尾检查只推迟「此刻内容是执行体写的、写它的那一位还没放手」的文件(附注点名是谁的);推迟的是哪几个文件只在变化时记一笔,上一笔里有、这一轮进了检查的文件 ⇒ 这一轮按新的一轮全拦并点名是谁写的(不照「被拦之后接着的那一次」只比红数:两轮查的不是同一批文件,红数比不出东西);这一轮有文件新被推迟时,红数变少不算「红项在减少」。⑥ 复盘者不许带名字派(带名字的是队友,类型变成名字,结论会记成不可信)。⑦ 团队开关写在项目设置的环境变量里,在前六条落地之后才开。⑧ 顺带补的空档:已完结需求的范围此前只从还在的计划目录取,完结后按流程删了目录、下一次收尾会把它范围里完结前的合法改动当越界拦一次;现在计划目录没了、账本还在的也认,范围取最后一次签字记下的目录。否决:按执行体定义里的写域硬拦(写域是一句话不是清单;写代码的执行体要同批改测试;同一种执行体分块干活时按定义拦不住互相踩);把关口挂在「任务完成」(这个版本不触发);另挂「队友闲下来」(有「执行体停下」就够);为队友另记一套会话台账(同会话号,不需要);队友活着就整类不查它写的文件(10-03 复审实测:名单里只要还列着一个闲队友,谁写的红文件都一直不查);推迟按个数记(10-03 第三轮复审实测:一位停下、另一位又写了一个文件,个数不变、文件换了,放出来的红文件照旧被放走)。诚实边界:这套判法只对单窗口方式成立,换显示方式要重做探针;队友干到一半自己崩了、或领队用平台的任务编号(不是名字)停的它,没有「放手」那一笔 —— 别的执行体十分钟内改不了它的文件,还有别的队友活着时它的文件一直推迟(队友全部停掉后的那一轮、封版、发布、三查照查);执行体用命令行写的文件这几关都看不见,由领队收尾按时间窗兜;停下来那道关二十二秒内检测没答就不拦;钩子超过三十秒被平台掐掉的那一次一笔都留不下;用户在面板里直接对队友打字算不算「用户说话」没测。
ADR-762026-10-03守卫提速与补洞:守卫只在该起时起,同一件事只留一份判法,判不了一律拦,部署门的预算从进程启动算起为了:「守卫提速」这条需求(照守卫盘点定下的方案改守卫与检测引擎,每一处改前改后用测试对拍)。病根:守卫盘点逐条量出四类问题 —— ① 白起进程:写前写后对每一次工具调用都起守卫,读文件、搜索这类守卫什么都不做的调用占了绝大多数,每次还先起两层 shell;守卫启动就把全部零件装齐,一个不相干的零件坏了,说话与配置变更也一起被拦(拦说话吞掉用户原话,拦配置变更挡住的正是恢复办法)。② 同一件事多份判法:cp / mv 的落点、包管理器跑哪个脚本、包着的命令、云端工具的现场信息与写前那一串闸、看板有几步、「写没写范围外」,都各有两三份实现,改了一份另一份就漂。③ 咬不住的用例:一批用例只核退出码,把被测那道检查换成空壳,后一道闸接着拦,用例照绿。④ 没堵的洞:部署门的总时限只管推代码那几臂,前面的 git 测量与版本比对能把写前钩子拖过平台时限(被掐等于放行);开闸时写前另有的四类云端检查一笔不记;登录到别的环境、销毁数据库实例、读机密值、藏在参数里的超时都放行;失败的命令不记时间窗。决定:① 挂载名单跟着守卫的分支走:写前写后只挂守卫按工具名处理的工具,名单带锚点;回归套件从守卫源码里取出分支的名字核名单,漏改当场红。写前写后改成直接起程序,另挂失败后时刻(只认 Bash)。② 零件用到才装,判不了一律拦:装不上直接结束进程、退出码 2;凡是「装零件或调零件出错」的地方不许当没事 —— 需求零件坏了写前 Bash 照拦,收尾对账算不出来拦一次,三查脚本自己装的量仓零件装不上按判不了红(弹验收题拦、答验收题不记完结);回归套件按「事件 × 零件」逐格注入故障守着,v4.5.0 重写的签字题两段也在表里。③ 一件事一份判法:上面各项各抽成一个函数,两处共用(云端那一串闸写前写后调同一份,写后只判不跑测试床;收尾与三查同一口径 —— 范围用 v4.5.0 定的那一份取法,「刚完结不算越界」三查也认)。④ 部署门预算从守卫进程启动算:git 测量、版本比对、推代码各臂共用,版本比对挪进子进程以便到点掐断;预算与写前钩子的时限由回归套件绑住,并在守卫副本里把预算与慢桩同比例缩小实跑「到点就拦」。⑤ 检测引擎复用射程:全仓射程是「引擎代码、全部规范、文件与目录清单、母本包说明」四样的纯函数,四样指纹没变就复用,拿不准一律现算;缓存目录进脊柱写保护,守卫起检测引擎时不带改缓存位置的环境变量。⑥ 金丝雀跟着被测对象住:业务树覆盖金丝雀查的是检测引擎的覆盖名单,从守卫回归套件挪到检测引擎面的床,由床头的上游登记让规范改动也触发它重跑。⑦ 回归用例先咬得住再提速:只核退出码的补报文断言;写前 Bash 与结论只由云端策略决定的用例改在套件进程里判,端到端名单两路都跑、逐字比报文,每类命令判定至少留一条。否决的做法:给预算、挂载名单加环境变量开关(开关本身就是洞);为堵管理共享逐级比文件身份(新机制,按路径形态拦 UNC 就够);往平台的禁止名单里补命令(它按前缀比,插参数就过,条条都在写前拦截射程里);收尾钩子也换成直接起程序(实测基本打平,不换);为笔记本编辑工具、PowerShell 工具另起一套判定(记进守不到之处,留给下一条需求由用户定)。有意少拦(计划里定的):往早已退役的 .githooks 下载不再拦;继续拦按结果条数比,同一批只修好一部分文件时少拦一轮;查询、安装类子命令里碰巧出现 start、dev 字样不再误拦;写前拦截确定在岗时写后不重复判那四类;收尾一轮里别的进程中途追加的记录下一轮才看见。诚实边界:直接起程序的写法与「写前在岗就不补判」叠在一起有共同失效点 —— 平台不认这种写法时写前起不来、写后也不补判,两头都没声音,所以换上后与每次换平台版本都要在真实会话里逐个时刻核一遍;node 脚本直接写盘(含射程缓存、台账)照旧拦不住;云端工具调用失败不走写后;预算的正式值只由静态关系守着,「到点就拦」是在缩小预算的守卫副本里跑的。
ADR-752026-10-02两次签字改成需求方的话:签字一签需求确认、签字二签实施交付(选项就是要用户亲手验的清单);三查从题目里退到弹题的前置;执行体每层有主、每份写明闭环三行;取代 ADR-74 决策①里的选项内容与「输入框打的字 = 不过」病根:ADR-74 的验收题把「三查全绿」「复盘通过」当成选项摆给用户,用户 2026-10-01 原话「验收就应该是一个验收清单,而不是选择啊,难道我选了或者不选就会影响验收吗」—— 三查是体系要保证的事,不是需求方该判断的事;他在题里问了一句话,被记成一次「不过」,需求退回实施。执行体那一侧,六层里框架设计、框架实现、测试三样没有专人,谁写代码谁顺手写测试,每份执行体能写哪里、产出谁核、结论记在哪全靠派活时临时说。决策:① 签字一(需求确认)的选项是「需求」「范围」「要你亲手验的清单」(动钱的需求多一项「动不动钱」);签字二(实施交付)的选项就是机器镜像里没有自动测试的那几条用例,一条一项,每条写明在哪看、怎么验 —— 交付物清单不另起一样东西;一道题放不下就分几道同一句开头的题一起弹,守卫合起来核。② 三查、复盘、封版不进题:验收题弹出之前守卫先查,有一样不绿、选项不是那张清单、落盘的结果单不是最新的,题弹不出来;签字题带着答案弹出同样拦。③ 题里另设「有一项不对」,勾它才记「不过」;输入框打的字只记成用户的话,不算签字也不算不过。④ 签字那一刻核看板与机器镜像一致:每条「怎样算做完」、每条用例的「拿什么作证」、落点表每个目录要在看板看得见的地方逐字出现,用例一条不多一条不少。⑤ 结果单末尾加验收单:逐条需求列出对着哪几条标准、自动用例过没过、要亲手验的是清单第几项。⑥ 签字作废的需求,范围在收尾时照样算数,但只算本会话签的、只按签字那一刻记下的目录;越界只记进本会话那份账本(此前记进最早签字那份,活体一次:六笔记进了别的会话的账本)。⑦ 签字那一笔带上基线的指纹;基线没了拒绝重记;只在仓外镜像里有的账本只点名、不拷回。⑧ 执行体名册按六层配齐(框架设计、框架实现、四端建造、质量三样、治理两样、运维两样、能力两样),每份写明写域、输出经谁核、结论记在哪,缺了检测报红;模型清单收成精确值。项目经理是这套体系本身(计划、关口、三查、封版管放行),主会话是领队(写计划、派活、把结果讲给用户),不单设总指挥执行体。否决:把交付物清单做成机器镜像里的新字段(要重签,而且与用例是两本账);让守卫从机器镜像生成看板(看板是给人读的原件,生成会抹掉分析与图;只核不生成);靠认字区分「提问」与「不过」(不稳,改成勾选项);解析闭环三行里的路径去判重叠(写域里有不是路径的写法,硬解析必误报)。诚实边界:看板与机器镜像的核对按子串找、只核机器镜像到看板一个方向,靠样式表里的类名藏起来的判不了;闸开着时带答案弹的签字题拦不住,平台遇到预填答案还弹不弹题没查过,留给团队模式的探针;要亲手验的用例最多十五条;装上链式指纹之前的老账本按原样认;闭环三行只判在不在。团队模式(队友的改动归谁、任务完成那道关、冒充签字)不在这一版,另记一条。
ADR-742026-09-30需求闭环的签字改成官方选项里的一道多选题,编号不进用户看的话;取代 ADR-73 决策②「固定的一句话带编号」病根:ADR-73 让用户手打「确认 <名> <编号>」,一晚上被用户纠正四次 —— 他不知道要回什么、单选里点了「不过」就打不了字、编号「根本看不懂」、勾了签的内容再问「签不签」自相矛盾 —— 每一层都是把机器的需要摊到不懂技术的用户身上。决策:① 签字只有一种形态:AskUserQuestion 的一道多选题,题目以「确认 <名>」或「验收完结 <名>」开头并带计划看板的完整路径(界面只给用户看题目与选项,正文会折成一句摘要),选项就是签的内容(需求与怎样算做完 / 用例 / 落点表,业务需求多一样「动不动钱」),全勾 = 签字、没勾全不算、输入框打的字 = 意见记成「不过 <名> <他打的字>」;不设「先不签」,不另问「签不签」;② 三句话去掉编号:内容编号由守卫在他勾全那一刻记,结果单编号只进 .sheet.json,「验收完结」时守卫拿账本目录里最新生成的一张(执行者给他看的那张)与当场重算的比,验收与封版的重算都不落盘;③ 写后钩子只认答案、不把选项标签当用户说的,平台返回的答案优先于调用方传的;④ 独立复盘者第一次就抓出 15 条,其中真缺陷同批修:没签字时收尾按归属拦本会话改过的受治文件(用例 2);没通过的「验收完结」不再改状态(此前一笔红的验收把需求冻住、作废那道闸失效);复盘要可信(提示词正文指纹对得上程序生成的那一份)且绑定范围内文件指纹、代码一变作废;三查核对命令与复盘说明程序进脊柱写保护;第三查只按本会话改到的单元判、别的会话在途改到的单列、一个单元都没改到也能完结;没有基线 / 台账读不了 / 没指定会话 / 空壳对照判不了一律红;挪走计划目录同删;开工注入改读计划根目录的 scope.json;「用户发话」按会话分;签字作废期间之外没有「本会话写过就放」的豁免;随代码附带的补签命令删除。否决:把编号留在话里让用户核对(他不看代码,编号对他没有任何意义);两道题(先勾内容再问签不签);「不过」做成选项(单选里点了就打不了字)。诚实边界:用户读没读那张单子机器仍不知道,「看过」= 执行者生成过、之后内容没再变;勾全四样不等于读懂了;ADR-73 诚实边界里「命令时间窗归属会把别的会话的脚本改动算到本会话头上(活体一次)」那条诊断错了 —— 复盘者核出那个文件内容与仓库一致、根本没变过,被点名是当时基线漏记了非 ASCII 路径(已补进基线),归属机制本身没冤枉人。
ADR-732026-09-30需求闭环进强制层:每条需求先有计划、先有用户的确认,钩子在写前 / 写后 / 收尾对照计划,封版前与完结前查同一件事;计划做完固化进架构然后删;守卫先补洞(D-04)再装钩子病根(顶层复盘第一站,2026-09-29):这套体系把「用户逐次审查改动」定为最终硬闸,而用户不读代码;需求只活在对话里,没有任何机器看得见「他要什么、怎样算做完」,于是执行者可以忘、可以偷懒、可以说做了其实没做,两个裁判都判不出「做的是不是他要的」。同日实测守卫命令行通道与云端工具通道一批洞(复制落点写目录判放、挪走接线文件判放、git apply / stash pop / update-index --assume-unchanged 判放、python 与命令行设 NODE_OPTIONS 判放、数据库写只看仓库不看语句、守卫启动失败退出码 1 等于全放、收尾只拦一次),洞不补钩子再多也是墙纸。决策:① 一条需求 = 计划目录一份人读的看板(六个页签:需求 / 设计 / 步骤 / 用例 / 固化与验收 / 决策与遗留)加一份机器读的镜像(签字锁住的四样:需求、动不动钱、怎样算做完、用例,加落点表里的目录;内容编号 = 四样的指纹前四位);② 用户只在三处说话,用固定的一句话带编号(「确认」「验收完结」「不过」),整句相同才算,内容一改编号就变、签字作废;③ 钩子在四个时刻对照:说话时逐字进需求账本并认签字、签字一记全部受治文件的指纹,写前没有正在办的需求不让写受治文件,写后一句「在哪一格 / 不在范围里」,收尾对基线算改动面、本会话的范围外改动拦一次;④ 三查(实施复盘 / 用例闭环 / 固化核对)由体检工具的核对命令算出带编号的结果单,封版前查其中与固化有关的两项,签字二当场跑三查、全绿且编号对上才记「已完结」,签过字没完结的计划目录不准经命令删;⑤ 复盘者的任务说明由程序生成、结论行固定格式、结论进账本、连续三次不过要用户发话才能再派;⑥ 变更历史每一版多一行「为了」,三层同一种写法,封版命令拒没写的;⑦ 守卫先补洞(保护面扩到判决依据、命令暗道、数据库写分级、启动 fail-closed、收尾继续拦、开工注入与接线留痕),再装钩子,每批先在副本上改好跑完回归再换进。否决:整套引入外部框架(会在开发入口旁再叠一套);改掉「计划做完就删」另建长期需求档案(永远只有一份的是业务架构,用户 09-29 亲自否);把「为了」进检测引擎逐文件判据(封版是墙漏不掉,少改一处脊柱);写前按范围拦(范围归提醒与收尾,写前只判有没有正在办的需求,否则一条需求跨几个目录时寸步难行);锁整棵体检 / 治理 / 发布脚本目录(既有床 SP2 明写分发脚本不是判决依据,锁了只逼日常改动天天开闸)。诚实边界:需求账本在本机、脚本能改(改了目前发现不了);用户读没读就回了那句话机器不知道;步骤的勾仍是执行者打的,机器只数勾;命令时间窗归属会把别的会话在长命令期间用脚本改的文件算到本会话头上(第 2 批换进当晚活体一次);几份需求同时在办按范围并集判,甲的范围外改动落在乙的范围里收尾不点名(守卫盘点会话抓出并集口径前的互相拦);关闸后的活体实测只做了第 1、2 批,第 3、4 批因用户决定开闸到完结不再关,靠回归套件与只读探针;发布出口那一遍三查归部署会话,本轮未做。验证:守卫回归 484 条、守卫目录 9 张床、需求对账单元床 17 条、核对命令床 5 条、复盘说明床 3 条、封版命令床 11 条全过;需求闭环计划 harness-closure 自己是第一份按模板走全程的计划,完结后删。
ADR-402026-09-12母本包容器与层严格一一对应;容器名必须是单一常量派生的闭集,闭集外藏包一律 fail-loud(N4c 射程根治 + N4b 目录重组)病根:容器名 core / domains 在五处各自硬编码——检测引擎 constants/terminals.js 的两个射程形态(静态 glob MOBILE_SRC_ROOT_GLOBS 与 fs 自发现 discoverMobilePkgs)各写一次、装配器 x-core/tools/mobile.js 一次、admin 包读取器一次、x-structure NS-MOBILE-0016 一次、x-backend NS-COMMON-0001 一次。后果不是漏判而是两种反向失效同时存在:(a) 新增容器 kits/ 后,包整体掉出 {mobile} / {mobile-src} 射程,对 x-api / x-i18n / x-exception 等一大批规则集体失明,而「不适用」与「通过」在报文里同形;(b) x-backend NS-COMMON-0001 的形态闭集只认 core|domains,会把 kits/、biz/ 判为非法形态整体误伤。★原有的 fail-loud 为什么救不了★:discoverMobilePkgs 注释白纸黑字写着「某包把源目录改名 ⇒ 立即 fail-loud(两形态失同步)」——它防的是两形态失同步,而新增容器是两形态同时失明,那条保护结构性不触发。这是 ADR-39「判据射程 ≠ 事实边界」的第四种形态:保护在,但它设想的失效方式不是真正会发生的那一种。决策:① 容器名在每处收敛成单一常量表({core:'single', kits:'multi', biz:'multi'},single = 该目录自身即一包),两个射程形态都从它派生,禁再各写一次;② 新增「已知非母本目录」登记表(backends 确有 package.json,登记在册 = 有意排除,不是漏登);③ 闭集外藏包一律 fail-loud——原实现对未知容器静默跳过,等于谁在 x-core/mobile/ 下随手新建目录放包,射程就对它完全失效;④ 三套账(引擎 / 装配器 / admin 读取器)物理上不能共享常量(跨进程 + vm 沙盒),靠金丝雀对拍防漂(mobile-endclass-canary ⑪⑫ + terminal-registry-canary D13);⑤ 先做 N4c 再搬目录——实测 N4c 落地后四个包在新容器下被自发现零改动自动识别,若顺序颠倒,此刻已有三个包静默掉出射程。验真:物化 写 0 · 清 0 · 全同(端侧产物逐字节未变 —— 这是「纯源码树重组」的最硬证明,落点由 x-materialize.dest 决定、与包源住哪个容器无关);closure 859/868/0 · 311/298/0 与重组前逐字一致;四闸床 46 例(A7 判据翻转:domains/ 由「合规过渡容器」→「已退役 ⇒ 未登记容器必咬」,保留而非删除是为了钉住「过渡容器已退役」这件事本身);移动端床 34 张 791 例全绿;meta validate --all 33/33(19 本 rule 的 paths 全部机械派生,零手改)。★过程教训(比结论更该记)★:批量替换两次把自己的反向注入床改废。第一次是 N2(包名),已加拼接构造;这次是容器名,而上次的保护只覆盖了包名这一个维度 —— 写着「防复发」的注释正下方又发生一次。故把结论推广为:凡是反向注入用的违规值,不论它是包名、容器名、路径段还是后缀,一律拼接构造,并让哨兵断言覆盖每一个维度。否决:(a) 给自发现加「未知容器就跳过」的兜底——那正是本次失明的成因;(b) 保留 domains 在闭集里当「兼容」——过渡容器永久化等于规范永远差一口气,且与「容器即层」自相矛盾;(c) 把容器名做成跨进程共享模块——admin 插件、装配器、vm 沙盒三者物理隔离,强做只会多一层假抽象,对拍金丝雀才是正解。诚实边界:x-core/pnpm-workspace.yaml 是容器闭集的第五处账,它是 YAML、没有任何金丝雀读得到它,漏改不报红、只在 pnpm install 时静默少装一个包(本次即漏了一轮才被零残留扫描抓到,已在文件内写明告警);pnpm-lock.yaml 仍引用旧容器,需一次 pnpm install 重生。
ADR-412026-09-12规则的「适用文件」必须与所在 spec 的 scanMode 同构:目录模式 spec 里的文件级 glob 恒为空集(NS-MOBILE-0021 建闸当场实证)病根:x-spec-checker 的 spec 有两种扫描模式(scanConfig.*.mode: file | directory)。目录模式下,引擎 scanners/file.js 的 filterFilesByDirModeRoots 会把目录模式根路径下的全部文件目标剔除(设计意图正确:目录模式 detector 拿到的是目录,喂文件会 ENOTDIR 崩)。后果是——在目录模式 spec 里写一条 适用文件: {mobile-src}/**/*.js 的规则,语法完全合法、-t 绿、-v 绿、白盒判据床可以 32 例全过,而它在真仓的目标集是空集:规则从不执行。唯一可见的痕迹是 -m 报表里那行「不适用」,它与「通过」只差两个字,且同一张报表里本来就有十几条合法的「不适用」(他端规则)作掩护。这是「判据射程 ≠ 事实边界」的第五种形态:判据本身是对的,闸也真的在,只是引擎从来没把任何输入喂给它。决策:(a) 在目录模式 spec 内建新闸,适用面只能锚到该模式扫得到的目标(目录,或目录模式根之外的文件如包根 package.json),需要逐文件判据时由 detector 自己 walk —— 覆盖因此不依赖 scanner 的目录选择逻辑,可当场自证;(b) 每条新闸的床必须包含「射程断言」:直接调用引擎的 extractRulesFromSpec + buildSpecScanContext + scanTargetsForRule,断言真仓目标集非空且含预期锚点;再用 fs 读取计数断言 detector 的实际覆盖等于应覆盖全集。判据床证明「判据对」,射程断言证明「引擎真的把东西喂给它了」——两者缺一,绿都是无信息的。诚实边界:本 ADR 不改引擎行为(filterFilesByDirModeRoots 是对的),改的是建闸纪律;混合模式(同 spec 内 file + directory 块)未验证,且目录模式根下的文件目标无论如何都会被剔除,故不作为出路。
ADR-422026-09-12面向「产物」的判据一律落到它的源上;「预置声明」不得判死(N6 六闸同批立)两条建闸纪律,都是本批实测逼出来的。(a) 产物侧判据 = 假红制造机:拆包后大量声明指向物化产物(packOptions.ignore 的 type:"file" 指向 miniprogram_npm/**、resolveAlias 的目标指向落点、.gitignore 覆盖落点)。直觉判法是「这个被指向的东西必须存在」—— 它在 fresh clone / 从未装配过的机器 / CI 上必然不存在,闸会在最该可信的场合集体报红,然后被当成噪声关掉。正确做法是把判据反查到源:落点内的路径按 x-materialize 反查 <包 srcRoot>/<包内路径>,端内路径查端内源码 —— 两侧都是源码,任何 clone 里都在。建闸即验证:NS-COMMON-0006 用这个判据当场抓出 x-technician 一条 N3 拆包后的死条目(…/@wowoway/core/xTools/geo/services/geo.types.js,geo 早已拆成独立包),而产物侧判法在那台机器上会同时报出 20 多条假红把它淹掉。(b) 零引用 ≠ 死声明:x-technician 有 8 条零引用 resolveAlias、x-mirror NS-COMMON-0004 早有「隐身名已写但目录暂无 = 预置排除,放行」——它们都是孵化中的端先写好声明。把「零引用」判成「死声明」会让整个孵化端集体假红,假阳性直接废牙;故 NS-MOBILE-0011 只建「目标悬空」一臂,原计划的「死别名」臂否决,并在判据床里用两条断言(A4 / G4)把这个决定钉死,防以后有人「顺手补上另一臂」。边界:(a) 不适用于「产物与源必须逐字节等值」这类本来就以产物为对象的闸(x-mirror NS-COMMON-0001),那条闸的「端未装配」是独立错误码而不是违规;(b) 不意味着「预置的东西永远不能判」—— 预置声明若目标本身不存在(悬空),照样红。
ADR-432026-09-12「当下只有一个消费者」是事实、不是设计意图:内聚判据必须锚在【声明的结构关系】上,不能锚在【当下的引用统计】上(NS-MOBILE-0023 建闸时被实测推翻一次才定形)病根:拆包后自然会想问「这个单元是不是住错了包」。最直觉的判据是统计:「它的消费者只有一个下游包 ⇒ 搬过去」。真仓实测该判据命中 5 处,其中 3 处是误伤:@wowoway/core 的 xTools/unit(单位换算)与 xComponents/file/smart-image-flow(图片原语)——它们当下恰好各只有一个业务包在用,但那是当下事实;它们的设计意图是「谁都能用的内核公共能力」,把它们搬进业务包是架构倒退,而下一个包要用时还得反向依赖回来。关键教训:x-layer 层序(core < kit < biz)这个看似相关的判据挡不住它 —— core → biz 在层序上是「向上搬」、判定合法,实测放行。决策:判据改锚在声明上 —— 只在同域包对内适用(B 名 = A 名 + -lazy,这个关系由命名法 NS-MOBILE-0017/0018 强制、是写下来的意图,不是统计出来的现象)。同批还补了第二条收窄:消费者集合必须含 A 包内自引用,否则会把「A 自己还在用」的单元判成应搬,搬走即 A → B 反向依赖(NS-MOBILE-0019 当场破)。收窄后精确命中 2 处、零误伤,两条收窄各有一条床断言(C1/C2)钉死,防以后有人「顺手放宽」。推广:凡是「某某只被谁谁用 ⇒ 应该怎样」形态的判据,先问一句 —— 这个「只被」是写在声明里的,还是这一刻数出来的? 数出来的那种,只能进只读报告供人裁定(本次即产出 x-test/mobile-package-affinity-report.js),不能进 detector。边界:本 ADR 不否定统计本身的价值 —— 报告正是统计;否定的是拿统计当强制判据。
ADR-442026-09-12端根一级目录是闭集;外来包的分包落点归骨骼目录 xPackages/,禁直挂端根病根是两层自我论证,不是平台约束:装配器 DEST_RE(x-core/tools/mobile.js:225)只收「单段 ∧ 全小写 kebab」的分包 root,而它自己上一行的注释写的是 <分包root>/miniprogram_npm —— 实现比意图窄了一整档;x-structure NS-MOBILE-0018 又反过来把这条正则写进规则正文当立论根基(「为什么 root 必须等于包短名:装配器 DEST_RE 只收单段」),循环论证就此闭合,此后「落点只能在端根」被当成物理约束写进了 arch(arch/system/mobile/ARCH.md N3 ② 原文「实测约束,非偏好」)与包的 description。微信侧从无此限制:官方分包字段表对 root 只写「分包根目录」,官方预下载文档自己的示例就用两段 "path/to",npm 寻址是 node 式逐层上溯(「从依赖 npm 包的文件所在目录开始逐层往外找」);本仓 x-client/app.json 现役 9 个分包 root 里 7 个是多段(xModules/mall/goods 三段)—— 反证一直摆在自家 app.json 里,四个月没人对上。后果:-lazy 包落点只能是端根单段目录,于是 goods-lazy(S16 · 09-07)与 geo-lazy(N3 · 09-11)四天内在端根堆出两个目录,而端根一级当时没有任何闸在管(NS-MOBILE-0014 只覆盖 xCore/* xModules/* xComponents/* xTools/* pages/* 五根的子目录,够不着端根本身);外推几十个 -lazy 包就是端根几十个目录。由非技术用户一眼指出(「根目录应该是骨骼目录啊,就是各种 x 开头的目录,除非那些原生的目录和文件」)。决策:① 端根一级 = 四类闭集——x[A-Z]* 骨骼白名单(xCore/xModules/xComponents/xTools/xStatic/xPackages)∪ 微信原生必需(pages/custom-tab-bar/miniprogram_npm)∪ 生成物(dist/.cache/node_modules)∪ 文件(不判),立新闸 NS-MOBILE-0024;② 六个骨骼目录的分界判据只有一条:真相源在端内还是端外——前五个装端自己写的(git 跟踪、可手改),xPackages/ 装外来包的物化产物(gitignore、L4 只读,改它没用、要改去改 x-core/mobile/** 包源);③ 白名单是闭集不是模式——写成「凡 x[A-Z]* 皆可」等于随手 mkdir xFoo 就合法,端根形态又没人管了;新增骨骼目录必须同批改白名单(有意识的决定,不是维护负担);④ 落点法则统一,不按消费者数量分类:主包包 → 端根 miniprogram_npm/(微信钉死)· 分包包 → xPackages/<包短名>/miniprogram_npm。否决了「geo 落进唯一消费者 xModules/address 分包内」 —— 那是按「当下只有一个消费者」决定落点,正是 ADR-43 禁止的把事实当设计意图(地址能力将来师傅端上门服务同样要用,塞进去明天就得再搬一次);⑤ DEST_RE 直接编码新法则(只收这两种形态),packageDest 的 root 解析 indexOf→lastIndexOf(两段 root 会被首个斜杠算成 xPackages 而报出不存在的 subpackage root)。否决:(a) 放进 xComponents/ 或 xModules/——两者都在 NS-MOBILE-0014 的 ROOTS 里,只装 miniprogram_npm 的目录 isModule/isGroupDir 皆 false,实测当场判「孤儿目录」;且 xComponents 语义是端自有组件,与「外来包产物」是两回事;(b) 一个 root 承载多个包(xPackages/miniprogram_npm)——会把 20KB 的 geo 与 638KB 的 goods 并进同一个下载单元,分包粒度倒退;(c) 维持现状、靠「只有 -lazy 包才建 root」自我安慰——趋势正相反,四天内新增两个。★方法论教训(比结论更该记)★:这是 ADR-39「判据射程 ≠ 事实边界」的第五种形态——「把自家实现当外部约束」:一行自写的正则 → 被规范正文引为立论根基 → 被 arch 写成「实测约束」→ 被包的 description 复述 → 成为四处一致的「事实」,而原始证据(官方文档 + 自家 app.json 的 7 个多段 root)从未被查过。判据是:一条被称作「平台约束」的限制,必须能指出平台侧的原文或实测;指不出而只能指向本仓某个文件的,它就是我们自己的选择,可以改。验证:--verify 五落点逐字节一致 · --closure 868 引用 / 悬空 0(21 处路径改动零遗漏)· 0016-0019 床 47/47(新增 C7 钉死「旧的端根直挂形态现在必须被咬」)· 新床 ns-mobile-0024-end-root-closure 30/30(含射程断言与「白名单是闭集不是模式」的 A4)· bed-ownership-canary 8/8 · verify-mobile-canary 15/15(镜像面排除项由 goods-lazy 归位为容器名 xPackages,顺带修掉「geo-lazy 从未登记、两个同性质落点待遇不对称」)。★诚实边界已转实测(2026-09-12 当日)★:立条时「多段 + 带大写的 root 下手工放置的 miniprogram_npm,微信认不认」仓内零实测、官方文档亦无原文(推断依据只有官方寻址逐层上溯 + 本仓 7 个多段 root 在跑,而两者的组合没人验过;失败模式是真机 MODULE_NOT_FOUND,--closure 在无分包概念的虚拟树上解析、结构性看不见它)。用户当日在微信开发者工具实测通过:控制台 [xPackages] {结果: "✅ 通过", 含义: "xPackages 落点下的 miniprogram_npm 被微信正确解析,多段分包 root 的 npm 寻址成立"}。同批把这条不可见路径做成常驻运行时自检(用户提「把所有架构设计的地方都加日志,刚好把测试都做了」):两端 app.js 各一条 [xPackages] 日志,验三项——① goods-lazy 落点 + 包内 bare 上溯(入口选纯模块且真 require 了别的包;原入口 product-detail.props.js 实测内部零 require,只验得到「文件找得到」,验不到 bare 寻址那一半,我原以为间接覆盖了,实测推翻)· ② geo-lazy 同上(第二个包,且是另一层 kit,排除偶然)· ③ IoC 七键注入实况(读 core.registry ⇄ KNOWN_KEYS,零改包)。加什么有判据:只给「静态闸结构性看不见、且失败时不会明显崩溃」的契约加;物化指纹 / 端根闭集 / 端壳指纹 / 落点 gitignore 已有闸在管,一律不加(两套账)。师傅端同装但只验 ③,落点两项如实标「不适用」而非省略(省略会让人分不清「没验」和「验过没问题」)。残余边界:本次只证明「微信开发者工具 + 基础库 3.17.2 认」,未在真机复验;日志本身只证明「能加载」,不证明「加载的是对的那一份」(那归 --verify 逐字节)。
ADR-452026-09-12一条闸的「正向」不蕴含「反向」:凡是「声明 ⇒ 产物」的强制,必须同批问一句「产物里有没有不再被任何声明认领的东西」病根:拆包治理到 N8 为止建了一整族闸(物化指纹 NS-COMMON-0001 / 落点 gitignore NS-COMMON-0005 / packOptions 条目有源 NS-COMMON-0006 / 命名法与落点一致 NS-MOBILE-0018 / 端根闭集 NS-MOBILE-0024),它们全部是「按当前声明枚举、逐条验证」的形态。这种形态有一个共同的结构性盲区:它只看得见声明里有的东西。删一个包、改一次 dest、改一次包短名、收窄一次 ends —— 四种动作都会在产物侧留下「不再被任何声明认领」的残留,而装配器、--verify、指纹闸三方都只按当前声明枚举,谁也不会去问「多出来的是什么」。N8 归位时端根那两个旧落点目录是我手 rm 清的,不是机制清的 —— 当时没人察觉这是个缺口,因为「清完了、闸绿了」。本轮复查一次性捞出同构的五处:① app.json 的死 subpackage root(正向由装配器 packageDest fail-loud 守着,反向零覆盖)② 孤儿落点目录 ③ packOptions.ignore 只有「条目 → 源」没有「源 → 条目」(建反向臂即咬到 4 处真实泄漏:两端各漏 exception.types.js 与 xType/api.js,每次微信构建随主包上线)④ 端根空骨骼目录(存在但空 ⇒ git 不跟踪 ⇒ 只活在某人本地工作树)⑤ 孵化器原样继承种子端别名表 ⇒ 新端出生即带悬空别名。决策:① 立 x-mirror NS-COMMON-0007(端侧落点残留,臂A 死 root + 臂B 孤儿落点)② NS-COMMON-0006 补反向臂(源 → 条目)③ NS-MOBILE-0024 补空骨骼臂 ④ deriveAppJson 剔除指向端内的别名。判据落点的一条子结论:反向臂的判据方向与正向相反,不能照抄 —— NS-COMMON-0006 的教训是「判产物存在性必然假红」(fresh clone 上产物本就不存在),而 NS-COMMON-0007 臂B 判的是「存在的里面有没有不该存在的」,未装配时零违规、天然不假红。两者一个问「该有的有没有」、一个问「有的该不该有」,看起来都在看产物,可判据方向正相反,混了就会造出一条在每台 fresh clone 上满屏红的闸。推广:凡新立一条「声明 ⇒ 产物」的闸,同批必须回答两个问题 —— (a) 声明里有而产物里没有的,谁报?(b) 产物里有而声明里没有的,谁报?只回答 (a) 就收工,等于默认「没有人会删东西、没有人会改名」。边界:反向臂只适用于产物面可枚举的场景(落点目录、配置条目);对「散落在代码里的引用」这类不可枚举面,反向不成立,那里靠的是闭包解析(--closure)而不是集合差。★同批补记:一条「强制」的落点必须先量它的预算(2026-09-12 当日实测否掉自己的方案)★ —— 本轮为「改了装配面就必须跑床」找落点时,我先写下的方案是「Stop 环里直接跑 --group=assembly」,并把它当结论写进了看板。用户开闸后读 settings.json 才看见 Stop hook 的 timeout 是 120 秒,而那一组床实测 90~206s —— 这个方案从一开始就落不了地,而我在提出它的时候没有去量过那个预算。改法是把「跑」与「验」拆开:跑(90s+)留在 verify-mobile 与部署链,Stop 环只对拍一枚新鲜度戳(内容指纹 + 通过与否,毫秒级)。强制力等价,却装得进预算,而且 L4 改动面从两个脊柱文件缩到一个新模块。推广:凡是要把一条强制挂进别人的执行窗口(hook、CI step、pre-commit)的,先问「那个窗口的时间/资源预算是多少,我这一步要花多少」—— 量不出来就先别写进方案。这与本 ADR 主结论是同一个毛病的两面:主结论说「别只答一半的问题」,这条说「别在没量过约束的情况下宣布方案」。 ★第三条补记(2026-09-12 收尾当日 · 一批 10 条里有 3 条的补法照抄会恒红)★ —— N9 复查报告给每条缺口都写了「可照做的补法」,收尾实施时逐条重新核实,三条的方向或前提根本不成立:R16「固件每个包的 dest 必须通过真 DEST_RE」—— 固件里有 4 个 dest 是故意的违规样本(反向注入用),要它们「全部通过」等于把反向注入样本一并改成合规样本,正是 N2 / N4b 两度踩过的坑;真判据要拆成「合规样本必须通过」+「DEST_RE 不通过 ⇒ 0018 必咬」两条。R24「IGNORED_DIRS 每个名字都必须在 0024 白名单里」—— 方向反了:build / coverage / .umi / worktrees 不该出现在端根,出现了正是 0024 要咬的;成立的只有 GENERATED ⊆ IGNORED_DIRS 一向。(原报告说「两闸给相反指令」也不成立:0024 自己 readdirSync 端根、看得见目录名,不经引擎索引。)R17「三处对同一组样本给同一判定」—— 三处语义本就不同(terminals 只判非空 ⊇ DEST_RE 判形态 ⊇ 0018 判名字⇔落点),真不变量是偏序不是等价,要等价等于把三道闸压成一道。另有 R13 / R18 / R19 / R22 四条经核实后收窄或改向(前提只成立一半 / 缺口比报告说的小 / 已被别的闸全覆盖 / 二选一里选「说实话」而不是「多加一道同义闸」)。推广:一条「补法」的合理外观不蕴含它成立。写补法的人(包括当时的自己)是在没有实施、没有读固件、没有量射程的情况下写的,它是一条假设不是结论。实施前必须重新量三件事:判据方向(正向还是反向、谁包含谁)· 样本前提(固件里那些值是合规样本还是故意的违规样本)· 射程(这条闸真的能看见目标吗)。这与主结论「正向不蕴含反向」、第二条补记「没量过预算就别宣布方案」是同一族:凡是「看起来该这么做」的判断,都要先问它依据的那个事实有没有被量过。
ADR-462026-09-13改了包源忘跑 --materialize 是「动作缺失」,只能由 L4 环感知,不能再造 spec 闸;arch 面第二实例把「零床」从拒生成改为棘轮病根一:拆包把系统层搬进包之后,「改包源 → 物化 → 端消费」多了一步人工动作,而 x-mirror NS-COMMON-0001 锚在包 package.json,--changed <包源文件> 结构性带不出它;Stop 环此前唯一的装配判据(床新鲜度戳)自陈刻意不收包源代码树。后果:忘物化时开发者工具跑的是旧代码,增量闸全绿,第一道会红的是 6 分钟全量。裁定一:这类「改了 A 忘了跑 B」是动作缺失,单文件 detector 结构上看不见,补法必须落在 L4 Stop 环——判据不复刻,直接 spawn 装配器自己的 --verify --end all(1.2s,只读);谓词由引擎 MOBILE_SRC_ROOT_GLOBS 派生不写死容器;装配器缺失 fail-loud。否决:PostToolUse 自动物化(L4 是传感器不是执行器,静默写盘会掩盖错误)、把 x-mirror 0001 的适用面扩到 src/**(引擎射程改动,且 0001 判的是产物 ⇔ 源,锚在 src 文件上会对每个文件各报一遍)。同批教训:两条装配判据无条件 require 引擎名册,让没有引擎的工作区(L4 自测沙盒)每一轮都 infra-failure ——「装配面才响」退化成「永远响」而无人发现,因为自测在挂闸后没再跑过;改懒加载(只在候选命中时读名册),并把「改 L4 判据必跑 verify-harness」记为纪律。病根二:x-styles-arch.html 的六条硬断言里 A4「每条 spec 至少一张已登记床」对 x-structure 这类以模块骨架规则为主的域结构性不成立(45 条里 33 条只有 spec 自测样例),照搬 = 第二个实例永远生不出来。裁定二:A4 拆成两半——「有床必登记」仍拒生成(床存在但没人跑 = 假覆盖),「零床」改为棘轮(数目只准变短,逐条在 §8.4 点名);这与 x-plan-doc「叙述不是状态」同精神:把做不到的写成红的,不把红的删成绿的。推广边界:arch 面仍是「每域一份生成器」的第二实例,元规范 x-sysarch 与通用引擎未立,.claude/rules/*.html 不在任何 spec 射程内——推广第三个域之前先立元治理
ADR-472026-09-14系统四件套:设计 · 条款 · 判据 · 执法四件锁步;架构层拆 system / business 两目录;条款是原件、派生件只准引擎产出病根:一份系统规范的知识散在四处——判据(spec)、条款(rule)、设计(旧 rules/*-arch.html 生成式页面)、执法(guard)——彼此只有「spec ↔ rule 指纹」一根锁:新增闸没人写条款、条款引用的闸早已删除、规则书手抄的数字停在过去(x-standard-rule 写「业务规范 × 18 个」而当时实有 33 份,元验证全绿),都没有闸。定型:① 每个有自己规范文件的系统规范域一套四件套,设计件住 arch/system/<规范>/(ARCH.html + CHANGELOG.md),业务架构整体迁 arch/business/,分界可由仓库推导(有自己规范文件 ⇒ 系统;以代码为锚 ⇒ 业务),元规范的设计留 harness;② 条款写在规则书里、是原件、固定格式(clauses-v1:头三行 · 条款 → 速查 → 标准写法 → 验证 · 每条 必须或禁止 / 为什么 / 怎么做 / 守护),「守护」一律写「规范名:规则号」(规则号跨规范大量重名);标准写法与速查是派生区,从判据与同前缀注册表逐字生成;③ 锁加在现成的规范指纹闸 NS-COMMON-0027(条款格式分支),不另立与元规范平级的规范——引擎只认一个元规范,且收尾环对规范与规则书本来就跑元验证,当轮咬;④ 架构页派生区用元素属性标记(引擎给检测器的 .html 视图会剥 HTML 注释),检测端只核戳记(data-v / data-out / data-src),写入端逐字重新生成比对,引擎带显式输出版本号(用引擎文件指纹判新鲜会让任何重构把全部页面同时判过期);⑤ 版本号只写在规范简介一处,变更历史最新条目必须等于它并封版,封版后判据再变而版本没升,sync 拒绝且零写入;「待同步」= 施工中,由全量检测逼封版(锚在系统组注册表而不锚变更历史——每轮收尾都逼封版会逼出一轮一个版本号);⑥ 解析只有一份引擎原子(parsers/tetrad-doc),检测端与写入端各写一份 = 锁失效而两边各自全绿;⑦ 普查只执行声明式查询(检测沙箱给完整文件系统权限,「只读的可执行代码」做不到),快照标明日期、不锁新鲜。否决:条款做成表格(一格装不下命名文法与代码块);条款挪去架构页(不自动加载,AI 写错会变多);给规范加「为什么 / 做法」字段(规范的固定模板不允许多出行,元验证必红);规则书整份生成(条款需判断,不是派生件)。附记:本表 ADR-16 有两条不同决策共用编号(2026-07-25 迁移窗口物理闸、2026-07-11 arch 收尾执行器终裁);ADR 不可改写,引用时以日期区分;自本条起编号唯一性由 x-governance NS-COMMON-0005 锁(在案重号冻结,新增重号即红)。诚实边界:机器判得了认领、引用、派生区、版本锁步与成套;判不了条款写得对不对、条款与闸的语义是否一致、AI 读了规则书是否照做——归人审提交。
ADR-482026-09-14收尾环对规范与规则书补派增量检测;规则书分类的唯一判据收进检测引擎,孤儿规则书每轮报违规;收尾环检测一律带原因病根:收尾环按文件后缀把规范与规则书分流到 -v、整个排除在 --changed 之外 ⇒ 以它们为靶的文件级闸(规则书上的禁引施工计划、规范上的业务码孤儿标记)在收尾环结构性不跑,x-marker 规则书却写着「改 spec 时 --changed 触发」;「规则书有没有规范、没规范算不算设计使然」收尾环 / validate --all / 体检 L3 三处各判各的 —— 收尾环不看名册,规范被删或改名后留下的孤儿规则书被说成「设计使然」报备一次就静默,validate --all 直接跳过,只有很少跑的体检认名册;收尾环检测命令不带 -d,拦下报文只有规则号与位置。决策:① 规范与规则书补派不改派(-v 照跑,同时进 --changed;元规范 x-standard 不在 --changed 射程,不会重复);② 名册与分类函数住检测引擎 check/constants/rule-books.js —— 引擎受写保护,三处消费方(guard、x-meta-dev、x-harness-dev)本来就依赖引擎,放任何一个消费方里都会让另两处反向依赖它;孤儿每轮报违规,名册内的按内容指纹报备一次;③ 收尾环检测命令一律带 -d,摘要按报告逐块摘违规详情。边界:改前实测最坏情形(全部规范与规则书同轮改动)--changed 5.9 秒,在 120 秒钩子预算内;名册只登记 x-*-rule.md 形态的规则书,rules 目录里的其他文档不参与配对。
ADR-492026-09-15官网 x-website 登记为第三类顶层物(站点):不是端、不进开发流 fan-out;主域名归官网、后台退回子域名;发布复用静态托管无空窗发布库背景:公司官网此前是仓库外一个临时目录里的两张页面,文件名带版本号(deck-v3),联系方式写旧域名,页脚没有 ICP 备案号;主域名 wowoway.cn 的网关 / 路由仍指向后台目录,员工与访客共用一个入口。决策:① 官网住顶层目录 x-website/,与 x-core 同属「顶层物而非端」—— 它没有数据表、云函数、权限与业务模块,四阶段开发流无一适用;引擎侧新增站点类常量,与端、框架内核三者并集才是顶层物全集,覆盖闸与 L5 体检读并集(体检原先手写四项,早已漏掉两项);② 目录只许两层形态:根下 kebab-case 页面,xStatic/{images,icons,fonts} 资源,与各端 xStatic 同名同义;页面按内容命名(property-partnership.html),禁版本号进文件名;③ 四颗机器闸住 x-website 系统四件套(目录闭集 / 站内引用完整 / 零外部资源 / 首页备案号),发布脚本的托管目录单源与无空窗顺序住 x-deploy(官网非端,端码取 COMMON),两处分工是「站点内容」与「发布动作」;④ 发布复用共用发布库(发布档案 / 逐步检查点 / 回滚),不为官网另起机制;共用发布库仅补一处:首页指向目录的引用(logo 回首页 ./)落到该目录首页判存在;⑤ 访问映射改为四个域名对四个站点:主域名 → 官网,admin. / client. / technician. 子域名 → 各端,员工一律用后台子域名。否决:(a) 把官网做成端 —— 会进 fan-out 与端名前缀匹配点,静默改变业务目录判定语义;(b) 把官网塞进后台的公共目录 —— 发布与后台构建耦合,主域名与后台登录态同源;(c) 引入构建工具 —— 两张静态页零构建即可,构建名片与指纹改名在官网无对象;(d) 把「标题宋体子集覆盖页面汉字」做成机器闸 —— 检测沙箱只给 fs/path,解不开 woff2(brotli),改为只读报告脚本加条款(维护类无机器闸),用户审提交。诚实边界:页面文案是否与公司实际一致、字体子集是否覆盖新增标题字,机器判不了;网关路由切换属云端配置盲区(x-deploy-rule 检测边界),代码库只能记录映射表、不能证明云端真的这样配;公安联网备案号尚未取得,取得后补首页页脚并扩首页备案号闸。
ADR-502026-09-15收尾环按会话分账:测量仍是仓库级,判定按写证据归属到会话;无主改动不拦人只出结论、由部署门挡病根(看板 e11–e13,09-15 实测):收尾环的待检队列与差集快照都是全仓一份 —— ① 一个会话的违规每轮拦住所有会话(09-14 本会话收尾被合包的 11 处红拦下),被拦的会话按宪法 §六.6 又不能代修;② 任一会话放行就推进全仓快照,别人没检查的命令类写入被当成已检吞掉,从此只有部署门看得见;③ 队列谁先抢到谁整体拿走,抢空的会话拿到空队列也放行。宪法说各会话只处理自己引入的改动,L4 传感器却没有会话的概念 —— 法与传感器互相矛盾。ADR-14 撤回「方案甲」的理由是「git 零会话归属,想减他会话必重引队列」,ADR-28 却又采纳了 git 差集入队而没有回应它;ADR-16(07-11)F2 早已指出「队列无会话标记先到先得整体窃取」。决策:① 测量与判定分离 —— git status 仍是仓库级(唯一能看见命令类写入的事实来源),归属按会话台账里的写证据判;② 台账每会话一份、只追加(.claude/tmp/ledger/<会话id>.jsonl,Windows 多进程追加写实测 24000 行无损,禁「写临时文件再改名覆盖」——并发实测失败 42%):环2 对 Write / Edit / MultiEdit / MCP 下载记文件键与写后内容指纹,对 Bash 记结束时刻与时长(PostToolUse 输入自带 duration_ms,开闸期 PreToolUse 关掉也不丢起点);③ 归属顺序:内容指纹 → 命令时间窗(两端 1.5 秒余量)→ 无主;只检查、只拦本会话的,分不清的两边都拦并注明,无主的做不拦人的检查(每轮至多 40 个)、结论按内容指纹记回台账、由部署门挡;④ 「查过没有」按(文件键,内容指纹)记,不再有全仓快照 —— 别人的改动不会因为我放行而被吞;存量在台账首建时记为基线(与旧快照首轮契约相同,只拦一次提示);⑤ 部署门:全仓任一脏文件既非存量又无干净结论即拦(更严不更松);⑥ 台账目录升入脊柱写保护(原快照那条退役);⑦ 规范与规则书派生加住址判据(只认 references 与 rules),x-temp 排除保留。否决:按修改时间归属(复制保留修改时间的文件按时间会瞎,09-15 回放 35 个副本全中;指纹不会);无仓库形态改用 git(沙箱只能按会话自证,与旧队列语义相同);无主检查不设上限(防撞 120 秒钩子预算)。诚实边界:后台 Bash 的写后事件在启动时触发,之后的写入无主;删除按父目录时间归属,同目录多次删除只留最后一次时刻;两会话命令时间窗重叠归「分不清」两边都拦(回放 43 份记录重叠合计 0.3 分钟);无仓库形态没有 git 事实。验证:多会话模拟床 tetrad-session-ledger 11 例(两会话身份真跑 guard.js)、verify-harness 186、tetrad-stop-ring 8、guard-worktree-probe 7、guard-assembly-face 15。
ADR-512026-09-16静态托管发布面物理闸叠在部署门上:只准动注册表里的网站目录、只准传本次发布档案里的文件、按检查点判顺序、改路由目标必须是登记站点病根:发布面架构审视(2026-09-15)发现 L4 对静态托管几乎不设防 —— 部署门只判「脏文件有没有干净结论」,判不了「上传到哪、传的是什么、按什么顺序、路由改指哪」;一次整目录删除或一次改错路由目标就能让线上网站消失,而全部检测面照样绿。决策:① 闸叠加不替换:manageHosting 的 upload / delete(含扁平形态)、callCloudApi 的 tcb Create / ModifyHTTPServiceRoute、manageGateway 与托管域名写动作先过 mcp-policy 纯函数判定,通过的仍进部署门;② 注册表 x-deploy-sites.json 与 .deploy-releases 发布档案只当数据读,guard.js 按需注入,读不到、记录坏、缺字段一律 fail-closed 并写明原因;守卫不 require 任何 part2 代码(工具独立于材料),框架自测用夹具注册表;③ 判定要点:上传的 cloudPath 首段必须是登记网站且非根非保留,localPath 来自该站在用发布档案的 assets / cutover / rollback 子目录且位置与大小写一致、前提检查点已通过;删除只认清理清单或回滚删除清单内的文件、isDir 只认缺省或 false;静态托管路由的域名只准 STATIC_STORE 且启用、Prefix 与域名登记在同一站;manageGateway 对 STATIC_STORE 建改硬拦(该工具没有路径重写参数);发布档案整树进写保护,备份口只给 manageHosting 下载;④ 同批修掉 dev server 判定按参数路径字面匹配的误拦(只看被执行脚本位置);⑤ 落地流程:副本先改、GUARD_HOOKS_DIR 指副本跑全部床、全绿后请用户开闸,落地脚本核对三文件基线指纹未变才覆盖。否决:把闸做成读 x-deploy 判据的检测器(判据判的是文件内容,判不了「这次调用要传什么」);守卫依赖发布库代码(材料反噬工具)。边界(对抗审查登记,未修):win32 位置参数形态(powershell Remove-Item、Git Bash 下 cmd //c)不命中显式开关判定,可执行任意命令;node --run dev 不命中 dev server 判定;ln / install / rsync / cd 后相对写与 node 脚本写盘仍可改 .deploy-releases(该目录 gitignore,环2.5 看不见)。验证:verify-harness 302/302(新增 116),同一套用例跑落地前守卫 77 例转红;四件套床、session-ledger 11/11、guard-worktree-probe 7/7。
ADR-522026-09-16发布档案根从隐藏目录 .deploy-releases 改为根目录 x-release;本地留存 10 份降为 3 份;新增进版本库的发布台账 x-release/RELEASES.md病根:档案本体是线上文件的副本(实测 9 份 60MB,留满 10 份约 310MB),既进不了版本库(git 只进不出,一次四站点全发约 32MB 且删不掉——工作区删了历史里仍在,留存份数控制不了仓库体积),又因藏在隐藏目录里而「没人看得见发过什么」;用户要的「随时能回退到某个发布版本」此前只靠本机档案,换台机器即失效。决策:① 档案根改名并移到根目录、与 x-admin / x-client 平级(根目录已有 x-demo / x-mock / x-temp / x-vpn 等不进库的 x- 目录,非首例;引擎 SCAN_ROOTS = ALL_TOP_DIRS 显式名册,不登记即完全不被任何 spec 扫到——产物本就不该受判据治理);否决沿用治理域名 x-deploy:那是条款书 / 判据 / 架构页 / 技能四处已占用的名字,而 x-deploy 判据治的是全项目发布行为、不是这堆档案(x-website 可同名是因为判据治的就是那个目录);否决放进技能目录:技能是治理件,五块结构里不留运行时数据位。② 留存 10→3(稳态约 94MB)。③ 新增发布台账 x-release/RELEASES.md:上线与回滚各追加一行(时间 / 站点 / 发布号 / 提交号 / 结果),由 release.js 在 live 与 rollback-live 检查点写入,只追加不改写(同一次发布同一结果只记一次——重算回滚计划会让 rollback-live 再核一遍,那是复核不是新事件);.gitignore 用 x-release/* + !x-release/RELEASES.md 使其成为这棵树里唯一进版本库的文件,它同样落在发布档案写保护内(发布脚本进程内 fs 写不经本闸,手改被拦)。回退能力的真相:要回到更早某一版,用台账那一行的提交号把源码倒回去重新构建发布,而不是从版本库里翻产物。闸门集合不变:本轮只改闸读的数据位置,并新增台账这一条只读面。验证:verify-harness 304/304(新增 RR2b/RR2c 台账手改必拦;2 条 H1 瞬态红属 arch 会话在途改判据,已复核不在本改动面),同一套新用例指向未打补丁的守卫副本时发布档案族整片转红;发布库床 19/19(新增 B6 台账单元 + D1 端到端断言台账两行)、技能自测 92/92、x-deploy validate 10/10、装配面床 521/521;.gitignore 真文件探针确认 git 只看得见台账。决策见 CHANGELOG v3.2.1。
ADR-532026-09-21业务架构保鲜的强制点落在收尾环,不落部署门;describes 加值域约束;保鲜报文不印实算指纹病根:业务架构文档靠 srcHash 四端指纹保鲜,但它是跨文件不变量 —— 改的是业务代码、锚在 ARCH.md 的 frontmatter,--changed <业务码> 结构性带不出它(增量门只见变更文件本侧),第一道会红的是 6 分钟全量。于是「改了代码没回看设计」可以一路走到提交,而 ADR-16(2026-07-11)预注册的 backlog「deploy VALIDATE 门2 arch 反查注入」三个月未落地。四路对抗审查(绕过 / 日常坏法 / 历史先例 / 更简方案,各自独立取证)否决了部署门方案:① 实测它只够得着 server 一端 —— admin / website / mobile 三条发布脚本没有文件级目标、data 端走控制台手工导入完全在系统外;② 最高频的「存量云函数改码」官方通道明文跳过预部署验证(x-deploy-dev SKILL「这条通道不做也不需要做:预部署 VALIDATE」),而那正是 100% 的发生场景;③ MCP 上传按官方姿势从仓库外 bundle 传,functionRootPath 里没有任何 x-server 路径,按路径反查恒空 ——照正确姿势发布就自动免疫;④ 拦的是部署会话,而宪法 §六.6 禁它代修他会话引入的改动 = 错向执法(这正是 ADR-16 F2 当年否决旧方案的理由,被原样搬了回来)。决策:① 强制点落 guard/stop-handler.js 收尾环第三段 —— 它拿到的是本会话改过的全部文件,不分端、不分发布通道,拦的是改动者本人;形态照抄同文件里已跑两个月的两段(包源物化 R25、站点新鲜度),判据不复刻:只做「本会话改过的文件 × describes base 前缀」求交,真判定交 check.js -m x-arch;② 只在输出的「违规详情」区里认域,且只报本会话碰过的那些 —— 拿整篇输出 indexOf 会把「被扫到」误当成「报红」,那是一颗恒红的闸;③ 业务架构层不存在就整段跳过(框架操作材料、绝不依赖材料),传感器自身异常 fail-loud 不静默;④ x-arch NS-COMMON-0002 加值域臂:describes 每条路径的 base 目录必须真实存在 —— 审查实测 detector 的声明值与实算值取自同一行 frontmatter,指向死路径时实算文件集为空、签名算出 null、与声明的 null 恰好相等而整条静默通过,于是被拦的人只要把路径改死(一行 Edit)就永久免疫;⑤ NS-COMMON-0003 报文不再印实算指纹值(旧报文把正确答案递到手上,最小合规动作是复制粘贴、30 秒不用读一个字,是 ADR-16 F3 橡皮图章的原形),实算值改走结构化字段 archComputed —— message 给人、字段给机器,判据床读字段、仍不复刻算法。为什么不再援引 ADR-16 排除收尾环:F1「Stop 是最不可行动时刻」已被本文件自己的两段实践推翻(两者都在 ADR-16 之后建成并稳定运行,且解决的是逐字同型的困难);F2「咬错会话」由 ADR-50 会话台账解决;F4 不适用(收尾环是真拦不是可忽略提示)。F3 仍然成立且不可消除,只被抬高成本 —— 任何能被单一机械动作解除的拦截都会被那个动作解除。否决:部署门 arch 反查(射程与执法方向双错,见上);认领闸 + 未认领棘轮名册(「哪些未认领」可从 describes 实时派生,建名册即第二本账;且会激励「一把全认领」摧毁指纹分辨率;未建档域零牙是 ADR-16 的既有设计选择);给数据表 .md 加第二套版本号(人敲的号蒙混不了内容,项目一贯用指纹不用版本号);收尾自动重算指纹(指纹永远新鲜 = 把传感器拆了)。诚实边界:只证「被迫打开设计文档看一眼」,证不了「看完写得对」;node 脚本直接刷指纹连痕迹都查不到(win32 无 LSM,Bash(node:*) 全量 allow 是既定权衡);「架构改了代码没改」反方向机器结构性失明;未建档域零牙(实测 215 个云函数里 63 个不属于任何域,全是尚未建档的业务域)。验证:脊柱改动先在副本上打补丁、GUARD_HOOKS_DIR 指副本跑三张床(tetrad-stop-ring 10/10 含新增 S7「只点名本会话碰过的域、副本里其余同样陈旧的域一个都不点」与 S8「未建档路径放行」、tetrad-session-ledger 11/11、guard-worktree-probe 全 PASS),全绿后请用户开闸落盘;落盘后真 hooks 复跑 10/10,并在真实仓另做一次红→绿闭环(临时新增一份 customer 域数据表文件 ⇒ 拦下并报 data 端陈旧;删掉 ⇒ 放行)。x-arch 走到 V1.10.1,判据床 23/23(新增 R2f 三段:死路径必红、同一份文档把指纹也改成 null 后 0003 确实静默(证明值域臂堵的是真洞)、整端 null 仍合法)。
ADR-542026-09-22业务结构放置立闸(x-arch NS-COMMON-0013):每张表恰好归一个域、子表与关系表在表文档里写明上级、按放置规则放对一层;取代 ADR-53「否决」段中「认领闸 + 未认领棘轮名册」一条在数据表上的适用病根:业务架构标准的放置规则(主 / 子 / 关按上级个数分;关系挂在两端的最近共同上级下面)经用户认可,却零机器强制 —— 61 张表 23 张无主、子业务与上级可以分在两个域、跨域关系被某个端域收留,检测全绿。用户原话「一切都是以硬控为先的」。为什么推翻 ADR-53 的那条否决:它的三个理由在数据表上各有交代 —— ①「未认领可从 describes 实时派生,建名册即第二本账」:本闸的无主判定永远从 describes 实时算,名册不是真相源,只是立闸当日存量的豁免清单,且机器强制只减不增(登记项已改好却没划掉即红),新表永不入册、一出生就受管;②「会激励一把全认领、摧毁指纹分辨率」:全认领会与其它域重叠而报红,把子表或关系认领到错的域会被放置臂报红,剩下能被随手认领的只有主业务 —— 那是业务判断,写进条款的诚实边界,不装作机器能判;③「未建档域零牙是 ADR-16 的既有设计」:那说的是保鲜(没有文档就没有可保鲜的陈述),放置是另一件事 —— 一张表不属于任何域,本身就是缺陷。ADR-53 的其余部分(保鲜落收尾环、describes 值域约束、报文不印实算值)不受影响。关键设计:①上级靠表文档声明而不靠外键推(四路对抗检查实测:用户券两个「父表 FK」、SKU 维护与 SOP 零引用供货表,推出来的上级是猜的),声明必须能在字段里找到对应关联,只是在已有事实里选一个;②锚在每张表文档上(锚 _index.md 会被收尾环按域过滤整段丢掉),改表当场由增量检测看见、自动按会话归属,收尾环零改动、无需开闸;③跨域关系归显式的关系域(kind: relation + relates),不许任何没有主表的域收留它。边界:describes 改窄致无主只有全量检测看得见;主业务编进哪个域不判对错;名册只减不增靠「已改好必须划掉」这一臂,往里新增登记仍只受升版流程约束(与 ADR 重号冻结名单同一 idiom)。同批 NS-COMMON-0002 增写法臂(describes 只接受「目录/**」),开发流程同批加「新表先定归属与上级」一步。
ADR-552026-09-22测试跟着被测对象放:治理体系的测试进 .claude 里各自被测部件旁的 tests/(规范判据床住 x-spec-checker/tests/<规范名>/),业务代码的测试留在 x-test/;唯一运行器 x-harness-dev --action=beds 按位置收床,取代样式 / 判据 / 四件套三本手写名单与床归属对拍金丝雀;取代 §九「所有测试代码只允许存在于 x-test/」一句病根:x-test/ 被定义成「临时测试落点」,却装着 280 多件长期资产,其中八成是规范判据床;床与被测对象分居两地,生命周期是断开的 —— 新建规范要另去 x-test 建床再手工登记名单,删规范时床不跟着删;「谁来跑」靠名单写死路径,漏登即永远没人跑(实测 10 张从未被跑过,其中两张被业务架构文档写成防线),床一挪名单就断,于是调用方看起来像主人。决策:① 测试根分三处(§十六);② 唯一运行器按位置收床,测试根以外的 *.test.js 报红;③ x-arch NS-COMMON-0010 的床位置判据放宽到测试根(V1.14.0);④ 部署门与移动端床入口留在 x-test/(它们跑的是业务代码测试),所以 guard 与发布技能一行不改;⑤ 删规范时判据床目录同删。边界:各规范变更记录与本表里的旧路径不改 —— 带日期的陈述记的是当时的事实;业务代码注释里的旧路径不为此单改(改业务码会触发业务架构保鲜),随该文件下次业务改动顺改。否决:① 全部留在 x-test/ 只整理子目录 —— 生命周期仍然断开,与「测试跟着被测对象走」不符;② 保留名单只改路径 —— 名单写死路径正是断裂的根源。
ADR-562026-09-22业务架构的组织单位从「业务模块」改成「业务域」:一个域六个视图(架构设计 / 流程设计 / 前端设计 / 服务设计 / 数据设计 / 修改历史),《业务架构标准》改名《架构设计模板》;x-arch NS-COMMON-0012 换判据,旧的「模块页十节」名册退役;取代 2026-09-21 立的业务模块页十节标准病根:十节写法按模块切页,一个域的内容散在几页里、每页又从头讲一遍契约与语境;而读者(不懂代码的决策者与要动手的开发者)要的是点开一个域就看到「它是什么、怎么一步步用、界面长什么样、后端有哪些服务、数据怎么连、改过什么」。用户看完菜单域的样板原话:「这个菜单就是我要的效果」,并要求统一成模板。决策:① 一个业务域 = 六个视图,五页住 parts/(文件名即视图 id),修改历史就是 CHANGELOG.md,站点按 parts/ 实际有哪几页出页签;② 流程设计的形态进判据 —— 每个场景先流程图、后分步操作(用户原话「先画出流程图,然后再展示这个流程是如何操作的」),这是模板里唯一一条关于内容组织的机器判据;③ 两种写法不并存:旧名册与旧床同批退役,已迁完的域旧形态(modules/、ARCH.html、CHANGELOG.html)必须删;④ 其余 14 个域用只减不增的棘轮等迁移,棘轮只豁免「缺视图 / 旧形态」,视图页一出生就受判。否决:保留十节模块页、在其上叠一层六视图(两套账,读者分不清哪份算数);按模块而不是按域出六个页签(客户域三个模块就是十八个页签,失去「一个域一眼看完」的意义);把画图做成生成器(图的内容是业务判断,生成器只能省坐标,先把画法固定成共用样式)。代价:客户域、企业信息是旧模板下闭环的,模板换了之后如实登记为待迁移,看板上的「已闭环」要按新模板重新算。
ADR-572026-09-22测试放置加固:测试根的唯一真相源收进检测引擎、引擎扫描面排除测试根;唯一运行器补五条取舍与卫生检查;删规范 / 删云函数 / 新建规范的生命周期都带上测试;移动端床名册定为退役(按套件取床)病根:ADR-55 立了「测试跟着被测对象放」,但测试根在运行器、x-arch 判据、guard 各写一份;判据床搬进 .claude 后,guard 按「路径任一段与顶层物同名」判业务源码,tests/x-data/ 这类判据目录被当成业务代码;原来 x-test 不进扫描根所以夹具永不被判,搬进 .claude 后只剩各判据自己的射程在挡;运行器把床自报的「跳过」画成通过;改管道收集输出后,收尾环床里的处理程序读一根永不关闭的标准输入,挂了两个多小时;第一批迁移后旧床名与旧路径还散在 40 个现行文件里,没有任何闸会报;删规范、删云函数、新建规范的工具都不知道测试住哪。决策:① 引擎常量 check/constants/test-roots.js 为测试根唯一真相源(只收自研技能),运行器、引擎索引器、x-arch 判据、guard 四处同源消费;② 索引器跳过测试根;③ 运行器:自报跳过记 ⏭、输出走临时文件且标准输入给空、仓库级锁、@suite 只认独占一行、选中整个 assembly 套件时写装配面戳;④ 卫生检查五项(游离测试按 git 视角、墓碑、运行头、文件名规则编号、死床路径),只在全量运行计失败;⑤ x-meta-dev 骨架带跑床命令与床位置、delete 同删判据床目录、自检核对验证命令的目标存在;x-module-del 扫描与执行带上函数的床、部署门键与点名;⑥ x-test/run-mobile-beds.js 退役,发布床阶段与装配面命令改按套件取床(--suite=mobile / --suite=assembly,guard-assembly-face 测收尾环不测装配面、且会改名真实脊柱文件,不入任何套件)。执行边界:⑥ 与 guard 的业务目录判定改动分别需要部署会话(发布技能与部署域的床)与用户开放脊柱,按清单分步落地;业务架构会话在途的床由它按清单自行搬迁。否决:① 给「会动真仓的床」打人工标签再加锁 —— 静态扫描抓不全(用变量拼路径),漏标就是假保护;② 在各判据里逐份加「排除测试根」—— 射程分散在几十份判据,新判据一漏就回到夹具被判;③ 保留移动端名册、只把路径改成仓根相对 —— 两个执行循环、两套跳过与戳的语义并存,正是 ADR-55 要消除的。
ADR-582026-09-23x-test 按被测对象分桶;床放置由部署门注册表结构推出;删除工具跟上 x-server 三层归类病根:测试放置迁移(ADR-55/57)把治理体系的测试搬进 .claude 后,x-test 剩下的业务代码测试仍是扁平一层 —— 云函数床用场景名作目录(dispatch-close/)、与注册表键(dispatch-close-update)对不上,移动端床、内核床、一致性金丝雀、报告脚本混在根下;删一个云函数时,没有办法从位置判断哪些床属于它。同时查出 x-module-del 早就静默失效:服务端扫描只认「中心 / 模块」两层,x-server 重组成「侧 / 中心 / 模块」后一个函数都扫不到,「删函数同批删床」从未在真仓生效;跨模块引用检查经 cmd.exe 执行的 shell 命令从不运行,恒报「没人引用」。决策:① x-test 按被测对象分桶 functions/<函数名>/ · consistency/ · kernel/ · tools/ · mobile/{core, biz/<域>, backends/<后端>}/,床文件名不改;② 部署门床的放置由注册表结构推出(单键 → functions/<键>/ 或函数自己的目录,多键 → consistency/,__kernel__ → kernel/),部署门入口 --verify 核对;③ 判断依据用到治理件(判据原文、引擎常量)的测试归判据床目录,只看业务代码的留 x-test;④ 报告脚本归所属技能 scripts/;⑤ x-module-del 服务端按「侧 / 中心 / 模块」扫(侧名从目录读),跨模块引用检查改纯 Node,床点名覆盖正文、条款书与判据,x-test 下只准整目录删 functions/<函数名>。执行边界:部署门登记的床由合包执行、部署会话在执行期间不碰注册表;部署门入口的放置核对、C9 部署闸组拆分、官网字体报告搬家由部署会话做;业务架构文档里的点名由业务架构会话改;业务代码注释里的旧床路径只报告,随该文件下次业务改动顺改。否决:① 按场景名保留目录(dispatch-close/)—— 目录名与注册表键不一致,放置规则就只能写例外名单;② 给床改名去掉 mobile- 等前缀 —— 裸床名散在几十处文档里,改名换来的整洁抵不上满仓死链;③ 把治理对账臂留在行为床里 —— 行为床是业务代码测试,混进拿引擎常量的断言,治理改动就要去 x-test 里找床。
ADR-592026-09-23业务架构按后台菜单四大中心分「中心/域」两层;中心名册住注册表;磁盘上的域目录必须登记;代码目录不跟着搬病根:业务架构原先按 x-data 的归类层摆放(customer/、ecommerce/…、system/…),而 x-data 的归类是建表时顺手放的,不是业务分类 —— 订单、优惠券、工单混在一起,system/ 还和系统架构 arch/system/ 撞名;读的人按菜单找业务,在文档树里找不到。决策:① 分类照后台菜单的四大中心,按业务流分:营销跟客户走、电商管从选购到下单、服务管从派单到上门、研发管系统且不对外;代号就是菜单国际化键的第一段,名册只在注册表「四大中心」一节登记一次。② 门牌恰好两段 中心/域,中心目录只分组;门牌即目录路径,注册表第 2 列必须恰好是「门牌/ARCH.md」—— 不再有第二套命名。③ 注册表从 opt-in 改成双向闭合:磁盘上有 ARCH.md 的目录必须登记(opt-in 当年是为了不在立闸当日挖出一堆考古债,业务域长齐之后它只剩「建了不登记」一种用处)。④ 代码目录不搬:x-data / x-server / x-admin / x-client 的归类层原样不动,域经 describes 认领 —— 搬代码目录要牵动线上云函数名、数据模型与发布通道,而分类问题只出在文档这一层。⑤ 历史不改写:变更历史正文、版本日志里的旧门牌原样留着,只改当前的指针。取舍:四臂里「磁盘目录必须登记」一臂的遍历跳过引擎忽略目录与点目录、不钻进域目录内部(域内 parts/、assets/ 不是域)。取代:harness §十四「归类层可任意深度嵌套、与 x-data 归类层 1:1」与「registry opt-in」两句。
ADR-602026-09-23一条结论能不能按内容指纹缓存,取决于它是不是这个文件自己内容的函数 —— 「干净」是,「红」不是病根:收尾环对无主改动的结论按 (文件键, 内容指纹) 存档、同一内容只查一次。这句设计对干净结论完全成立(省掉重复检查),对红结论不成立:本仓大量判据是跨文件的(注册表 ↔ 目录、上级声明 ↔ 表文档、条款 ↔ 判据),一个文件内容一字没动,因为别处补上了登记就该从红转干净。而 guard.js 选无主待查文件时写的是 !x.clean && !x.red —— 红了就永不复查,翻案只剩「改自己的内容」这一条路,正是为骗过机制去改代码。同一处还有两条同源缺陷:stop-handler.js 的 redFilesOf 在报文认不出文件名时整批算红(宁多不漏),而连坐来的红同样永久存档,干净的邻居被连坐一次就洗不掉;recordOwnerless 的入参是全量 side 而非真跑过的 result.side.ran,于是批次基础设施异常(代码里注释明写「没跑成 → 不记结论」)的文件被记成干净 —— 假绿。活体:2026-09-21 业务架构搬家中途,三份 ARCH.md(marketing/coupon · service/dispatch · service/supplier)在一次未点名的批次里被连坐记红;搬完后逐文件与全树扫描皆零违规,而部署门是仓库级的、挡住全部静态托管发布,人工核实干净也没有合法的清除路径。两个会话分别独立核实后都拒绝手改台账(「台账是执法记录,去改它就是为了让红变绿而动记录」),由部署会话读码定位到这两行。决策(三处根治):① 无主的红每轮再查(!x.clean),与同一函数里 mine 的「逼修:未过关的每轮再查」对齐 —— 两类文件本就该同一条规矩,此前的不对称没有任何理由,只是写的时候把「省重复检查」推过了头;② 批次报红而报文一个文件名都认不出来时先定位再记账:逐个复跑,只把真报红的记红,预算 8 次跑用尽或逐个跑仍全绿(跨文件不变量)才退回整批算红,并经新增的 side.blind 在报文里说清是「定位不到」而不是「就是这几个文件坏了」—— 宁多不漏保留,但不许把「说不清」伪装成「就是它」;③ 只对真跑过的文件记结论。为什么以前没抓到:sideFiles 这条路在三张 hooks 床里零覆盖 —— 每一处调用都写着 sideFiles: []。一条从未被任何用例走过的分支,读起来和写对了没有区别。验证:桩引擎加两种注入(报红但不点名 / 不打印完成标志就退 1)与一个仓内 registry.txt(模拟「合规与否取决于别处」),补 4 个端到端用例;反向验证未打补丁时四例全红,且被连坐的邻居赫然出现在部署门待检列表里;打补丁后 14/14,另两张 hooks 床(stop-ring 12/12 · assembly-face 15/15)无回归。诚实边界三条:① 定位预算 8 次跑是防撞 120s 钩子预算的工程取舍,超出后仍退回整批算红(blind 会说明),不是「一定能定位到」;② 红每轮再查意味着一个长期红的无主文件每轮都会被跑一次,这是与 mine 相同的代价,不是免费的;③ 本 ADR 只改无主(ownerless)这一支的结论语义,「按内容指纹缓存干净结论」对本会话与部署门待检判定照旧。
ADR-612026-09-24测试闭环在 L4 的落点:「跑」与「验」分离、按张记录、测试面按位置推;发布绑定上传内容;开闸期间以写后复判兜云端写操作病根(2026-09-23 实查,测试闭环计划的诊断):310 张测试里 238 张没有任何自动触发点;改了检测规则不会逼着重跑证明它有效的那张测试;测试没有版本、不在任何指纹里;唯一真跑测试的发布门挂在写前拦截上,开闸即下岗;门测的是仓库里的函数,传上去的可以是别处改过的副本;CloudBase 新出的 deployApply / deployBuild 不在任何检查里;体检对「写前拦截被摘」照样报健康。决策:① 跑与验分离(照搬装配面新鲜度戳的成功形态):测试在平时由唯一运行器与部署门入口跑,每张记一笔「对哪份内容跑过、过没过」;收尾、封版、升版只核记录,不在 120 秒的收尾预算里跑重活;发布时不认记录,当场真跑。② 按张记录、不按面:一个面可以分批跑,一个会话没测完不会冻住别人;记录单独记账,不复用「规范查过没有」的干净结论(两件事)。③ 测试面按位置推、不建名单:目录约定 + 部署门注册表 + @suite assembly;床读了别处的代码写 @covers,推不出就报错 —— 与「测试跟着被测对象放、放在哪就由谁跑」(ADR-55)同一取向。④ 指纹带上游(红队:引擎、内核、运行器变了,下游旧记录仍算新鲜),sha256(32 位能凑出同值)。⑤ 分级:快面每轮拦,重面(按上次实测整面超过 5 分钟自动判)与只经上游牵动的面只提示、封版前清 —— 检测引擎最近 12 次提交里 9 次有改动,每轮等十几到三十分钟,人就会把收尾检查整个关掉。⑥ 他会话的红只报归属不拦本会话(宪法 §六.6),发布那个函数时照样当场真跑。⑦ 发布绑定上传内容:上传指纹只有一份定义,出包、脚本发布出口、写前拦截、写后复判四处都对实际上传的目录算同一个值比。⑧ 开闸期间的兜底放在写后:PostToolUse 不受开闸影响,对 cloudbase 工具用写前的同一套判据复判,判为本该拦的记账、收尾报红一次 —— 事后拦不回来,但不再静默。⑨ 先试运行:收尾环的执法模式先 advise 一周,拿到每轮多等多久、有没有误牵动的实测数据再切 block;模式是脊柱里的常量,不设环境变量开关。否决:(a) 在收尾环里直接跑测试 —— 装配面那次已实测否掉(90 秒套件 + 本来的检测必撞 120 秒超时,撞了就不再是可靠的强制);(b) 测试名单 / 测试类规范 / 业务架构 describes 加「测试端」—— 域与测试的对应关系能从注册表与目录推出,名单必然漂;(c) 按面记一个戳 —— 一面只能整面跑,一个会话没跑完会把整面卡住;(d) 把写后复判做成硬拦 —— 事后拦不回已经上线的东西,逐轮反复拦只会让人学会忽略它,报红一次、要求补测或回滚才是可行动的。诚实边界:本机记录可被故意伪造(防忘记不防故意,唯一与发布通道无关的兜底是计划里的线上对账);按位置推会漏跨读(@covers + 全量跑兜底);真仓床结论依赖全仓内容;写后复判只看 cloudbase 工具,Bash 通道的 tcb 发布命令要靠写前拦截的拒绝名单,挂回写前拦截之后才生效。取代:体检 L4 旧判据「settings 里有 hooks 对象即 ✅」。
ADR-622026-09-24测试跟着规范与业务域定版:钉死一版(封版 / 重算指纹)之前核「证明它的测试对当前内容全过」,钉死时写测试指纹;封版记录先记后写,收尾复核手写与手改病根:版本锁步(ADR-47)管的是判据、条款、设计三者对齐,管不到「证明这一版有效的测试跑过没有」—— 改了判据可以当轮封版而那颗闸的床从没跑过;业务域重算指纹(ADR-53)只核「升过版、今天写的、没认过账」,同样不看本域测试。测试没有版本,也不在任何指纹里(测试闭环计划的诊断)。决策:① 测试不单独发版本号,跟着它守护的规范或业务域定版:封版 / 重算指纹时把「这一版在哪套测试结果上认的账」写成变更历史里的一行测试指纹(床路径 + 记录指纹 + 状态,排序后 sha256 取 16 位),重新认证就刷新这一行。② 前置只核记录、不在钉版时跑测试(与 ADR-61「跑与验分离」同一取向):规范封版核规范面全过 + 逐闸有床 + 零待补床(同批补,经部署会话审查与自查:覆盖某颗闸的面外床算作覆盖就必须一并过;逐闸覆盖只有一份匹配,运行器 --coverage 同源;登记豁免的跳过不算钉版通过);业务域核按 describes 目录推出的测试面全过。③ 没有测试覆盖的业务域不拦,如实写 none —— 强求就会逼出凑数的床;缺口留在变更历史里一眼可见。④ 先记账再写盘:记录多一条无害,「行在记录不在」会被收尾误当手写;记不下就不写。⑤ 收尾复核不分试运行:它查的是确定事实(这一行是不是脚本核过测试之后写的),与测试新鲜度的试运行(那里有重面与误牵动要实测)不同。⑥ 真仓按脚本所在仓认,不按形状认;固件照旧封版,测试床显式注入前置。否决:(a) 给测试单独发版本号 —— 测试的意义只在它证明的那一版规范或业务域上,两套版本号必然漂;(b) 封版时当场跑规范面 —— 判据床快,但业务域的测试面含整函数装配,钉版这一步不该承担重活,平时由唯一运行器跑、这里只核;(c) 封版记录存在变更历史自身(不另记账)—— 那样手写一行就自证了,收尾分不出来;(d) 上岗日前的条目一并追溯 —— 当日盘点零缺口,追溯只会逼出为旧条目补写的动作。诚实边界:封版记录是本机状态,账本被清后,还没被新条目盖过的测试指纹会被当成手写(处置:加一版新条目重走脚本);防的是忘记与手写,防不了故意改账本;测试全过证明「对当前内容跑过」,证明不了「测得对」。
ADR-632026-09-24开发流 VERIFY 由「检测」扩为「检测 + 按改动跑测试床」,一条中转命令跑两样;改到没有测试覆盖的代码如实告知、不判失败;命令行直接发布纳入同一份识别,写前拦、写后复判;框架面收尾不因重降级病根:宪法第一最高律让一切开发穿过工作流,而工作流的 VERIFY 只跑检测 —— 行为对不对只在发布时(部署门)和收尾(试运行只提示)才被问到;开发流说明还写着「全量 -m + 编译(npx build)」,与检测铁律和生产构建属用户主权都相悖。命令行直接发布(tcb fn deploy 等)绕开部署门与全部发布测试,写后复判原先只看 MCP 工具;检测引擎面按面族一律算重,引擎的改动永远只提示。决策:① VERIFY 的本次改动面用一条中转命令跑检测与测试两样(技能说明只能调自己的脚本),两步都跑完再合并结论;② 中转先用测试面判定模块算命中哪些面 —— 命中才交唯一运行器,一个都没命中是正常情况(覆盖缺口归设计与业务开发补),不判失败;运行器自己「按改动选床一张都没选中按失败处理」的 fail-closed 不动;③ x-dev-rule「检测只有两条命令」铁律不变,测试写成「另走一条」,不是第三条检测命令;④ 命令行直接发布只有一份识别(command-policy),写前与写后都用它;只认改线上的子命令,只读与网关路由不在射程;⑤ 重面只按实测判;守卫、检测引擎、自研技能三类框架面直接碰过不因重降级 —— 规范面靠封版清账、业务面靠升版前置与发布门,框架面没有定版点,收尾就是唯一闭环点;⑥ 体检把测试闭环作为横切一行派生出来(不是第七层),闭环验证加「收尾 → 封版」链,宪法对照表的状态列以后由它派生。否决:(a) VERIFY 直接调运行器 --changed —— 改到没有测试覆盖的代码(后台页面、表文档)会被判失败,逼出凑数的床;(b) 把拒绝名单当主闸 —— 它按前缀匹配,npx、node <CLI 路径>、cmd //c、全局参数前置都能绕开;(c) 体检把「面没闭环」算硬错 —— 改了代码还没重跑是日常状态,恒红的体检等于没有体检。诚实边界:写后复判事后拦不回来,只保证不静默;中转判「没有覆盖」依赖测试面划分,面族表里没有后台、端业务模块、官网与治理站点构建器(覆盖缺口如实可见,不在本条补);命令行识别认得的是已知 CLI 名与子命令,自造的别名脚本认不出(写前拦截的 shell 包裹与求值闸兜一部分)。
ADR-642026-09-24运行器这组上游只算「决定一张床过没过」的判定口径区段(由运行器维护者用标记框定),判定模块与分发入口退出这组病根(部署会话试运行数据):运行器组按 bed-runner.js、harness.js、test-faces.js 三个整文件的指纹算,运行器或判定模块随便改一行(打印、筛选、封版前置),全部 71 个面的记录一起作废 —— 一个下午刚记账的 59 张床两次整批作废;收尾报文被这批作废淹没,看不出谁的改动真的要重跑;切硬拦后每改一次运行器,所有人都要全量重跑 20–35 分钟。决策:① 运行器组只算 bed-runner.js 里 VERDICT-CORE-BEGIN / VERDICT-CORE-END 两行之间的内容(可多段):判定口径(跳过名单、自报跳过的识别、状态转账本)、跑床外壳(起进程的参数、空输入加临时文件、环境、超时、直跑与部署门外壳两条路)、记账映射;框由运行器的维护者定,运行器自己的床守着「决定结果的关键符号都在框内、标记成对非空」;② 没有标记或标记不成对 ⇒ 退回整文件(宁严勿漏:认不出哪段是判定口径,就当整个文件都是);③ harness.js(只分发)与 test-faces.js 退出这组:判定模块改指纹算法时床的指纹自然跟着变,「哪些状态算通过」是读记录时的解释、改了立即生效,都不靠作废记录。否决:(a) 按运行器声明的版本号作废 —— 改了判定口径而忘了升号,旧记录就冒充新的,人记不住的事交给版本号等于没交;区段指纹是内容本身,不依赖人记得;(b) 维持整文件 —— 宁严勿漏的代价是闸被淹没、人开始忽略收尾报文,严到没人看等于不严。诚实边界:框划错了(把决定结果的代码留在框外)改它就不会作废记录 —— 由运行器床的「关键符号在框内」断言兜,框不住新加的关键符号时靠维护者把它登记进那张名单;判定模块自身的逻辑(面怎么推、指纹怎么合成)改了只会让床的指纹变化或不变,改错了由判定模块自己的床与突变对拍兜。
ADR-652026-09-24测试闭环进宪法:宪法只写定性、执行点分层与义务,执行强度与缺口住架构详图 §十六 的对照表;宪法里的「存在」句只写此刻为真的 —— 为此同批把与宪法相悖的机制对齐,或把宪法措辞收窄到属实病根:落字包里的宪法句经一轮独立核实(对照表 30 行逐行回代码、三个视角对抗审查),挑出几处「宪法说的」与「机制做的」对不上:① 「跳过不算通过」—— 收尾新鲜度却把登记豁免(SKIP-EXEMPT)算作通过,开发流 VERIFY 还会打印「全过」;② 「VERIFY → ARCH-SYNC → DEPLOY」—— 编排器只出四段,计划里没有 ARCH-SYNC;③ 「只按一份口径记账」—— 装配面还有一本旧新鲜度戳;④ 相关文档指向 §十六 的对照表,而对照表还不存在;⑤ x-test 标签「L5 代码测试」比它实际装的宽(治理站点构建器的床住在 .claude)。另有一处实现缺口:命令行发布识别认不出包管理器的两词运行前缀(pnpm dlx / npm exec / yarn dlx / bun x)与带包名值的选项(npx -p @cloudbase/cli tcb …)。决策:① 宪法只写定性、执行点分层与义务,执行强度与缺口一律住对照表(宪法句 → 层 → 机制所在 → 执行强度 → 缺口),执行强度只写结构,会变的值由体检当场派生,不抄进表;② 义务句是规则,允许执行强度暂时跟不上,但必须在对照表与诚实边界里写明;③ 「存在」句此刻必须为真 —— 机制能对齐的对齐(登记豁免改为第三态「豁免」:不算通过、收尾只提示不追讨、定版与发布拒、VERIFY 单列;编排器补 ARCH-SYNC 成五阶段;命令行识别补两词前缀与 -p / --package 值),对齐不了的收窄措辞(「只按一份口径」改为「按内容记账」;x-test 标签改「代码测试(业务端与内核母本)」;执行点那句改用 L4 行已有的词,不写具体机制名);④ §五、§六.7 里属于记账规则与收尾执法强度的写法收回下层(宪法 §七 禁区)。否决:(a) 宪法写执法模式与试运行 —— 那是时点状态,x-governance ARCH-A02 的精神;(b) 对照表状态列手写「在岗 / 待落」—— 手写就是快照,改由体检派生,表里只写结构;(c) 把登记豁免直接算没过并在收尾硬拦 —— 原因是本机缺外部环境、不是谁改坏的,拦下来谁也修不了,只会让人学会忽略收尾报文。补记取代关系(ADR-63、ADR-64 写成时漏写,按只追加的纪律在此补记):ADR-63 的命令行发布写后复判与「框架面不因重降级」取代 ADR-61 诚实边界里「Bash 通道靠拒绝名单」与 ADR-61 ⑤ 分级中框架面的部分;ADR-64 取代 ADR-61 ④ 里「运行器按整文件算上游」。诚实边界:对照表是手写的执行点清单,新增或退役执行点时要同批改表(宪法 §六.4),没有机器核「表与代码一致」;第七处「控制哲学:绕过工作流 ≠ 绕过检测与测试」仍暂缓,等收尾切硬拦之后再改。
ADR-662026-09-24业务架构加第七个视图「测试设计」;每个视图自己的问题登在自己那一页的底部,不另建全局问题清单;视图清单只在名册里写一次,判据报文与站点页签都从名册派生病根:宪法 §六.7 要求测试守不到的地方必须在设计里写明,业务域这一侧没有地方写 —— 测试事实散在服务设计的备注与修改历史的测试指纹里,读者回答不了「这个域谁在测、哪里测不到」(x-arch-P-01)。另有两处手抄的视图清单:判据报文写死「五个视图页」「六个视图」,站点构建器手抄五个页签,判据床 G8 手抄五个视图 id —— 名册加一个视图,前者报文说错数目,后两者静默少查一页、少出一个页签而照样报绿。决策:① 用户拍板「架构设计只要加入测试设计,每个设计自己的问题只需要在底部呈现异常」:名册加视图 test(测试全景、逐个服务的测试、测不到的地方、异常四节必填;资金与状态不变量、人工验收可选),排在数据设计之后、修改历史之前;② 测试设计只写结构性事实(谁测什么、哪里测不到),事实从文档头 describes × 测试面判定 × 部署门注册表派生,不写「此刻过没过」—— 那由按内容记账当场判,写进页面就会过期;③ 问题跟着它所在的设计走:讲测试的异常从服务设计底部挪到测试设计底部(同一条只住一处),不建全局清单、不做跨域统一编号;④ 视图清单只在名册写一次:判据报文的数目、站点页签、判据床一律从名册读(x-arch V1.20.0)。否决:(a) 全局问题清单与统一编号迁入 —— 用户明确不要,复盘按域走;(b) 在测试设计页写「全绿」—— 会过期,且与按内容记账两套账;(c) 顺手立「资金写函数要么有测试、要么写明不测」的闸 —— 用户要求本轮只加视图、不修,登记为 x-arch-P-01 后半。诚实边界:判据只判测试设计的形态(节齐不齐、顺序对不对),判不了页面上的事实是否仍与代码一致 —— 页面是生成那一刻的派生,代码或测试变了要重新派生;21 个域同日补齐,各域升补丁版并重算指纹(代码未变)。
ADR-672026-09-26四件套 + 两个裁判成为统一模型:执法在开发中、收尾、定版、发布四处把检测与测试一起叫来;两个裁判同构(按内容记结论、上游一变作废、说不清不算过);裁判也被裁判(空壳对照成机制);收尾测试新鲜度切硬拦病根:体系本来已有四件套与两个裁判,但链路没拉通,两个裁判一强一弱、各守各的:① 检测的「干净」结论不随判据与引擎变化作废,测试的「跑过」却会 —— 判据收紧后旧的干净结论照样让部署门放行;② 检测的语言层(编译检查)只在恒返回 0 的全量里跑,oxlint 1.x 的对象形报告又一直读不懂,框架自己的代码(守卫、引擎、运行器、技能)事实上没有检测裁判;编译检查器工具没装时返回「通过」;③ 定版只核测试不核检测;④ 收尾一个会话的测试没跑新,会连带它的检测结论记不下,全仓部署门跟着冻住;⑤ 「改过的测试必须证明仍咬得住」只有部署门入口的手动 --bite,只覆盖五文件函数床,床头一句 @bite off 就能自我豁免;⑥ 收尾测试新鲜度停在试运行(ADR-61 定的「先试运行一周」所需的数据采集器从没建起来),账本不存在时整段跳过 —— 删掉账本等于关掉测试这道闸;⑦ 封版起算按条目自己写的日期,日期可以倒填。决策:① 统一模型写进 §一:设计 · 条款 · 判据 · 执法 + 检测(读代码)· 测试(跑代码);执法不是第三个裁判,只负责在四个时刻把两个裁判叫来;② 两个裁判同构:检测干净结论带判据组指纹、判据或引擎一变作废;编译检查器跳过不算通过、报告读不懂按错报;--changed 带上语言层;封版加检测前置(-t/-v 零红,与测试前置合成一个结论);收尾两栏分报、分开记账(只被测试拦下时检测结论照记)、有 100 秒总时限且到点没跑的按没过;③ 空壳对照成机制:唯一运行器对新建或改过的床在记账前自动做,函数床经部署门入口 --bite;空壳怎么造只在判定模块 bitePlan 一处定义(fn / spec / guard / module);结论入账,没咬住的床收尾、定版、发布都不认;不做对照只认运行器判定口径区里的登记名册,床头自述不再算数;老床按起算基线不追溯;④ 收尾切硬拦的证据换成可复现的干跑:用硬拦模式对当时全部会话的台账跑一遍判定,零误拦;同批补齐归属(无主改动与已离开工作区的改动只报不拦、别的会话新建的床不拦本会话)、规范面不因「重」降级、经上游牵动的框架面照拦;账本不存在等于一张床都没跑过;⑤ 封版起算改按冻结版本号(起算基线 seal-baseline.json);⑥ 写账本的判决依据(唯一运行器、空壳桩与对照、部署门入口)进脊柱写保护;⑦ 发布侧(部署会话第五轮落地、本条收口守卫一侧):发布测试由被发布物推导,上传档案闸对四种档案同一要求(推导出的每张床 PASS、测试面、输入源码指纹),云函数记账另锁内核母本指纹。取代:ADR-61 中「收尾先 advise 试运行一周、拿实测数据再切 block」一句,与此前「换空壳检查只能手动、只覆盖函数床」的做法。否决:(a) 收尾自己跑空壳对照 —— 每轮多跑一遍床,收尾被拖死;收尾只读账本里的结论,没结论就是没通过;(b) 空壳对照逐个目标分开做(判据一次、@covers 的代码一次)—— 住在判据目录里却只测构建器的床会被误判没牙;一起掏,证明的是「床咬得住它的被测对象」;(c) 守卫在上传时重算发布输入指纹 —— 档案本身受写保护、上传的是准备时测过的那份产物,源码在准备之后再变由发布库两个检查点当场比,守卫只要求检查点已过;(d) 给执法模式留环境变量开关 —— 一个变量就能关掉的闸等于没有闸。诚实边界:咬得住不等于测得全;两套账本都能被故意改写;开闸时写入那一刻两个裁判都不在岗;小程序包由用户手工上传,在本体系之外;没有测试的部分只有检测一个裁判(见 §十六 诚实边界⑮⑳㉑㉒㉓)。范围:只动顶层机制;业务、老测试与各域的底层瑕疵不在本轮,列入回归清单逐域复审。
ADR-682026-09-28整个 HARNESS 的版本由机器锁住:改了框架就必须升版(用户定:必须硬控)。整个 HARNESS 的版本 = 框架设计的版本,只写在架构详图文首;框架变更历史每版一节、新的在最上面;封版命令给第一节钉设计指纹(架构详图、宪法、决策记录)与代码指纹(守卫、检测引擎、测试运行器、元治理与开发流脚本),写逐文件封版清单,并记进守卫台账;治理规范 x-governance 新闸 NS-COMMON-0007 此后逐文件重算,封版之后改过、新增、删掉即报「还没升版」。各业务域、各系统规范域的版本不带动总版本。治理站点新增顶部页签「版本」,和理念同一级。此前只靠「更新触发清单」这条纪律,没有任何闸核对,于是悄悄走样(变更历史一段旧的在上、开头说法与做法相反,没人发现);「做完记得去改」的规则是一次性的。照系统规范域的封版做法接进来,不另造机制:闸与封版命令共用一份算法(命令从判据取检测器)。违规记在改过的文件上而不是统一记在变更历史上,是为了收尾复核按改动归属算到改的人头上。测试不算框架代码,否则每补一张床都要升一版。边界:升哪一位机器判不了;封版封的是当时整个工作区;故意写脚本同时改清单、指纹与台账拦不住,只看得见;收尾复核认框架封版记录这一臂要改守卫,待开闸。
ADR-692026-09-28版本契约:三层(整个 HARNESS、系统规范域、业务域)同一种写法、同一份判定代码、同一个封版命令;取代 ADR-68 的框架专用封版与 x-governance 框架版本锁步闸(用户同日定:「我需要最佳最合适的统一,标准化方案」)。病历:用户在站点上看到系统架构的「变更史」与业务架构的「修改历史」写法与页面都不一样 —— 同一件事三种标题写法(## V… · 日期 / ## v… — 日期 / ## v… · 日期)、五套解析、三种页面;整个 HARNESS 的版本锁借用一份系统规范的闸(框架依赖系统四件套,违反宪法);系统规范域能 sync --seal 重封已封的一版、改写测试指纹;业务域只要手改 srcHash 就能过保鲜闸。决定:① 唯一实现住检测引擎 check/version-contract.js(单元名册、写法、比对视图、逐文件与整单元判定、封版核心计算),别处禁另写;x-arch 四颗闸(0003 代码锁步 · 0009 · 0014 · 新增 0015 业务总览与无主业务代码)改成调用它的薄壳,x-governance NS-COMMON-0007 退役(框架判自己不借系统规范的闸)。② 写法统一 ## v主.次.补 · YYYY-MM-DD · 一句标题,记录行设计指纹 · 内容指纹 · 测试指纹 · 改动,只由封版命令写;锁清单 version-lock.json 逐文件记指纹(派生区与自动生成的文件不算,业务代码去注释去空白)。③ 四道关口:写入(锁清单受写保护)、收尾(逐文件判,施工中 = 已加新的一版还没封,带 --wip 只提示)、封版(meta.js --action=seal 与 arch/seal.js 转调同一份 core/seal.js:检测零红 + 测试全过 + 有标题有说明 + 按会话归属)、发布(部署门整体比对全部单元)。④ 锁自己:守卫另留不经契约代码的框架锁极简比对。⑤ 不归任何业务域的业务代码冻结在业务总览锁清单里、只减不增(否决「一次全部归位」:那是一次全仓重新分域)。⑥ 迁入:各单元加一版「迁入统一版本契约」(设计内容没变、只改写法,升第三位),整个 HARNESS 升 v4.0.0(改写既有契约)。否决:保留三套写法、只统一页面(两套账照旧、闸仍各判各的);让 x-arch 持有契约、框架借用(框架依赖系统四件套);施工中降成警告(违反原则 6,改成只有收尾带开关放过);封版吞掉工作区全部改动(会把别的会话的在途改动一起洗白)。诚实边界:锁步证「改了、升了版、封了」,不证设计与说明属实;无主存量改动不让任何设计升版;旧版本各节不在复核面;本机台账可被故意伪造;node 进程内写文件不经写前拦截。取代 ADR-68 的封版命令与版本锁机制(ADR-68 条目原样保留)
ADR-702026-09-28版本契约堵漏:比对口径按语法、封过的一版全锁、一次只升一步、两条发布通道同一套比对(用户问「牙都确认真实的硬控了吗」,独立对抗审查确认 v4.0.0 有漏)。决定:① 业务代码按语法去注释(字符串、模板、正则字面量里的不算),数据表比完整结构;② 相邻两版一次只升一步;③ 锁清单另记已封那一版的日期、标题与说明、测试行与改动清单,封过契约的单元必须有锁清单、不许当成首次封版,x-arch 锁清单记系统规范域名册;④ 发布前比对抽成 guard/release-versions.js,MCP 部署门与脚本出口共用,另把全部单元契约生效之后的每一版逐版对台账;⑤ 封版不收 --date;⑥ 框架认领 agents/ 与技能 assets/;⑦ 改了变更历史、锁清单或版本号就整单元核,三层同一口径。否决:封版只放过被封单元的施工中(82 个业务文件同时归两个域,两边施工中时互等、谁都封不了 —— 实施当轮发现、当场收回);把样式与页面配置收进业务代码(要重立一份无主基线,归逐域回归)。诚实边界:见架构详图 §十三(十条)。
ADR-712026-09-28版本契约第二轮堵漏:锁清单钉整段历史、业务总览记业务域名册、业务代码原文比、每条发布通道同一套比对;施工中开关的执行点定为收尾、开发流 VERIFY 与封版的检测前置(ADR-70 实施后再过一轮独立对抗审查,在沙箱里逐条复现)。决定:① 锁清单记下封过的那一版到文件末尾的整段历史指纹,已封的那一版与它下面的全部旧版一个字都不能改(此前只钉第一节:删掉旧版记录行就能改它、没闭合的代码块能吞掉已封版、最旧的契约期版本删了没人报);锁清单缺这些字段 = 按旧契约封的,第一节已封就报、要升版重封;② 「这个单元封过没有」另看本机台账(只看变更历史的「改动」行,删掉它、再删锁清单就能重新首封、重冻无主基线);③ 业务总览锁清单记业务域名册(此前删掉整个业务域不用升任何版本);④ 业务代码原文比,取消 v4.1.0 的按语法去注释(JSX 文本里的 // 与 /*、挪 require、改字符串里的空白都骗得过它);⑤ 静态站点四个出口的发布准备调同一个发布前比对(此前只靠 MCP 那一道,开闸时整条不比);⑥ 框架认领部署门入口与空壳对照;⑦ 业务代码不再按 build、coverage 这类目录名放过;⑧ 只改文件名大小写算改动;⑨ 命令里出现会话身份变量名(除读取外)一律拦;⑩ 施工中开关的执行点是收尾、开发流 VERIFY 与封版的检测前置,全量检测与发布不带 —— 取代 ADR-69「只有收尾带开关放过」的说法(VERIFY 与封版前置在 v4.1.0 已这样实现)。否决:给锁清单另加一条写入路径去「补齐旧锁」(那是第二个写者;统一走升版重封,与 v4.0.0 迁入同一个做法);把部署门注册表与钩子接线收进框架(前者业务开发天天改、后者开闸关闸由用户定,锁进框架等于每次都要升总版本)。诚实边界:见架构详图 §十三(十条)。
ADR-722026-09-29锚单元不许消失;业务目录里的测试按登记认;静态站点打包前再比一次版本(ADR-71 实施后第三轮独立对抗审查:此前 12 条绕过全部确认已堵,另复现出一条严重的新漏洞)。病历:版本契约每次按磁盘现算单元名册,没有地方记「这个单元本应存在」—— 删掉关系图文件、把 .claude/harness 改名、删掉 x-arch 的文件,那个单元连同它管的名册一起从所有检查里消失,守卫的框架锁极简比对在框架目录没了时也自己关掉;收尾与发布都报没问题。决定:① 锚单元(整个 HARNESS、业务总览、x-arch)在本机台账封过就不许从磁盘上消失,收尾每轮都核(不再「本会话没改变更历史就不管」)、发布前核;其余单元不设锚,由两本名册管(x-arch 记系统规范域、业务总览记业务域)—— 锚在,名册就在;② 框架锁极简比对:框架目录没了而台账封过 ⇒ 报,不再当成不适用;③ 业务目录里的测试只认测试根名册与部署门登记过的床,别处叫 tests 的目录、*.test.js 算业务代码(它们会随包上传);④ 删掉判据文件也让 x-arch 当轮整单元核;⑤ 静态站点准备档案前(测试与构建之后)再比一次版本;⑥ 收尾封版复核也收锁清单的改动。否决:给每个单元都设「不许消失」(退役一份规范就永远发不了版,除非另造一张退役登记);把治理站点构建器收进某个单元(它归属不清,收进框架会让改站点样式也升总版本),写进诚实边界。
ADR-392026-09-09闸的射程必须由引擎原语派生,不得硬编码根集;排除论证的前提失效时必须连同排除一起复审病根:本项目两次「搬家」各自留下了一批射程没跟着搬的闸,而它们全都安静地绿着。搬家一:拆包(S1–S17b)把移动端系统层从端树迁进 x-core/mobile 母本包;搬家二:零副本终态(2026-08-20)把 server 内核从 202 份分发副本变成 x-core/server/sys 唯一母本。两次搬家后,三条闸的判据仍指着旧地址:NS-SERVER-0143 臂2 与 x-marker NS-COMMON-0001 硬编码 [x-client, x-technician],x-marker NS-COMMON-0002 适用面不含 x-core/server/**。最坏的部分不是失明本身,而是失明期间全链路零告警 —— -m 报绿、--changed 报绿、meta validate 报绿,唯一能发现 0143 死掉的那张床自己也在 UNRUN 台账里没人跑(闸死了、验闸的床也没人跑,双重致盲)。决策:① 射程一律由引擎原语派生(tools.mobileEnds / tools.mobileSrcRoots / tools.mobilePackages),detector 内禁硬编码端名 / 目录 / 包名——第三个移动端出生即自动覆盖;② 原语缺席一律 fail-loud,禁静默退回旧口径(静默退化正是「看起来在判、实际早已不判」的成因);③ 排除论证随前提失效而失效:x-marker 排除 sys/ 的理由原文是「那 202 份 sys 副本…无人会读它信它改它,虚假安全感的成立条件三条全不成立」——零副本终态后 sys 是唯一母本、会被读会被改(本次即 0.3.0→0.3.2),三条条件反而全部成立,故拿掉排除并加 co-owner;④ 加 co-owner 是扩射程进领域独占目录的必要条件(非 owner 时 glob 在聚合阶段被整体剔除 = 死规则),x-marker 持【标记可归属性轴】,与 sys 既有三 owner 正交;⑤ 判据必须锚到语义单元,禁用字节窗口(NS-MOBILE-0002 立闸当天实证:slice(idx, +600) / +400 判「附近有没有 exit(1) / console」,被邻近构造喂饱,三条里两条不咬——那是「看起来在判、实际谁都能糊弄过去」的假牙);⑥ 一次性探针必须升成常驻床(探针跑完即弃 = 闸没有回归保护),且床内必须有「变异真的改到东西」断言(否则「闸没咬」其实是「探针没打中」,那是最坏的假绿)。否决:(a) 给 detector 加「原语缺席就退回端树口径」的兜底——那正是本次三条闸失明期间的行为,兜底会让下一次搬家继续静默;(b) 把畸形标记 x-api-call 改名指向 x-api——它包住的是内核 controllerSystem 工厂,四个 sys owner 里无任何「系统层模板」STD 覆盖它,改名等于制造一条指向不适用规则的新虚标;(c) 为两行注释的内核变更单独重发 210 个函数——kernel-manifest.json 是每个上传包自带的运行时锚、各自自洽,线上不会失效,登记后搭下次内核变更的车。验真:三条闸各做真引擎反向注入(file-upload:23 命中臂2 / 包源塞假规则 ID 命中孤儿臂 / 内核畸形标记首咬即中)并逐字节还原;0143 床 12→14(可达域拆两侧各证一次——只证一侧则另一侧塌了也绿);NS-MOBILE-0002 反向注入 6/6;内核工具床 49/49、mobile-web-backend 43/43(含 DOMAIN_SCOPED_DIRS 键金丝雀);四本 -v 各 36/36。★同族第三种形态(2026-09-09 由 style 会话实测交办,明确不另立 ADR:病理属 harness 层通用,分两处记就是第二本账)★:前两种是「射程不跟着搬家走」(判据指着旧地址);第三种是闸的触发时机与开发流不重合 —— 真正拦 :host(.on) / min() 的是 H5 装配期的两个 webpack loader(wxss-host-guard-loader.js / wxss-less-guard-loader.js),而装配是用户主权动作,于是纯小程序开发流里改母本 wxss 写了这些构造,增量与全量 check.js 都不会红。实测:五条构造 check.js 全盲 5/5。三种形态同一句话概括:闸在,但在这个人这个时刻够不着。收口做法是把判据搬进 -m 射程内的 spec(x-surface 第七维语言面 wxss + NS-MOBILE-0008),且判据不复制 —— detector 去 loader 文件里抠 const RE = /…/,收紧 loader 即同步收紧;代价是那两个 loader 的代码形态成了契约(改名 / 拆多行 / 换 const PATTERN = 会 fail-closed 报红),这是刻意的:判据寄在别人文件里,那文件没了必须立刻失守报警,而不是安静地变成零判据。
★取证方法论:白盒探针必须设对照组★(比上面的结论更值钱,同批交办):style 首版探针没设对照组,结果每条病灶咬中的集合完全相同 —— 输出不随输入变化,说明那些 detector 根本没在读喂进去的内容(绕过了引擎射程过滤,等于又搭了个假判据环境,与「手搭 tools 缺 cssParser」同族)。正确形态 = 真实库内路径喂合成内容 + 干净内容作对照、只取增量。没有对照组的白盒探针,产出的是废数据而且看起来很像真的。
★该方法论的第三个活体(同日 style 会话实测,比前两个更省事故)★:本轮从 x-mirror NS-COMMON-0001 找出「Array.isArray(x) ? x : [] ⇒ 空名册使循环一次都不跑 ⇒ 静默零判」这一族后,style 用静态分类器按写法扫全域,标出 4 处「驱动循环 ⇒ 空了静默」的候选;逐条造「本该报违规的输入」跑两遍(名册在场 vs 名册缺席)实测后,4 个候选 3 个是假阳性 —— x-backend NS-COMMON-0005 在 : [] 之前已有显式守卫(那行只是残留写法)、x-surface NS-COMMON-0001 与 x-backend NS-COMMON-0007 各由另一条臂 / 上游元闸兜住。所以判据不是「写法是不是 ? … : []」,而是「名册缺席时到底有没有人报」 —— 后者必须造反例实测,前者会让人去修三个本来就好的地方,并为它们各加一张无谓的床。真洞(NS-COMMON-0009 臂G,且其形态更坏:空名册下臂G 哑掉的同时臂D 把 59 条正常条目误报成「真幻影」,用噪声把哑掉的那条盖住)是靠读刚写的代码发现的,分类器的作用只是「让人去读」。推广同族排查时用「造必违规输入 → 抽掉依赖 → 看是否归零」,禁用写法匹配。
本轮我自己也踩过同型:NS-MOBILE-0002 首版反向注入两条不咬,若不先断言「变异真的改到东西」,会误判成「闸没咬」而去改本来正确的代码。
诚实边界:本次只根治了「已知的三条」,没有做全库同类排查 —— 全库 spec 里硬编码端根的 detector 经 grep 恰为这两处(x-api:7864 与 x-marker:73),但「排除论证的前提是否仍成立」这类问题机器不可判,只能靠每次搬家时回头复审排除表(本条即为此立)。x-marker NS-COMMON-0001 现已能看见内核,但 templates/ 仍非本规范 owner、保持排除(云函数骨架模板,非业务代码)。
ADR-382026-09-07镜像体系退役:「一份母本 + 端壳模板 + 物化 / 渲染」使端↔端字节镜像牙失去对象——删 x-mirror 旧 NS-COMMON-0001、退役 CANONICAL_CLIENT_END 指针与 sync-mobile 入口(拆包 S17b)病根:2026-07 立的镜像体系(ADR-17)前提是「基包只有一份活文件真相源住 x-client,其余端是同步副本」——分发器 sync-mobile 前向复制、x-mirror NS-COMMON-0001 双根锚定逐字节比对、引擎目录模式按 CANONICAL_CLIENT_END 做端根 swap、detector 用 [canonical-baseline] 豁免端名字面量。拆包 S1–S16 把系统层母本迁进 x-core/mobile 包(物化产物 ⇔ 包源由内容指纹牙锁,ADR-37),S17a 把端根最后 27 件两端同字节的壳固化为 x-mobile-dev assets/end-shell 模板的渲染产物(模板↔端指纹牙),端内非业务面的每一个文件自此都有唯一真相源在端外——端↔端字节镜像没有对象:x-client 不再是任何框架文件的真相源,它和 x-technician 一样只是消费者。删前判据(实测):-m x-mirror x-client(404 目标)/ x-technician(77 目标)旧 0001 「不适用」= 适用面 0 文件;verify-mobile ② listFramework(端) = 0,五类 tally {template 54, generated 20, business 362, auto-gen 8, end-divergent 34},未登记 0。决策:① 删旧 NS-COMMON-0001,renumber 0002→0001(母本包物化内容指纹)、0003→0002(端壳模板指纹),x-mirror V3.0.0(specHash c1e28324),/x-meta-dev 场景 D 走完(orphan-marker-cleaner dry-run 0 处、-m x-marker .claude/skills 0 红);② 退役 CANONICAL_CLIENT_END(terminals.js 删常量与导出)——前置:x-structure / x-i18n 的 CLIENT scanConfig root 改 {mobile-end} 令牌,引擎 extractScanConfigByTerminal 把含令牌的模板块按名册逐端展开为同构块(x-client → CLIENT、x-technician → TECHNICIAN;模板块键不对应任何端时展开后删除,不留含令牌的死块),引擎侧零端名字面量、零 swap;[canonical-baseline] 豁免随之取消,端类金丝雀④ 改为「出现即违规」;③ sync-mobile 退役桩(exit 1 指路,同 sys-sync),模板重渲染改 render-mobile.js(manifest renderEnds)——名字承载的是端→端分发语义,留名即留复活通道;④ 孵化新端的派生源改 create-mobile --from=<种子端> 显式参数(名册内任一既有端,只提供 GENERATED 派生源 / AUTO-GEN 真产物 / 图片打底,不是真相源);⑤ x-feature-dev roadmap 增「母本包检查组」MOBILE_PKG_RULES = [x-mirror] × MOBILE_PKG_ROOT(client 阶段按端根跑 -m 永远扫不到包 package.json 锚,规则书必须 ⊆ END_RULES.client 防第二本规则书);⑥ 宪法 §一 三处措辞、harness §三/§九/§十、arch/system/mobile v0.9.0(§二「canonical 单真相源模型」换代为「母本包 + 端壳模板双真相源」,Stage-P/Q 指针废止)。保留(实测否决撤销):x-mirror 在 defaults.js DOMAIN_SCOPED_DIRS 的 co-owner 登记——撤销后 -m x-mirror x-technician 对 xStyles/ 与 locales/ 下的未登记探针从 3/3 咬中退为 1/3(检测目标 77 → 65),黑名单极性的「未登记臂」必须看见端根全文件域;理由由「端↔端字节等值(横向端轴)」改为「端锚射程完整性(端契约面轴)」,仍与领域 owner 的内容轴正交。否决:(a) 保留旧 0001 作「零适用的安全网」——零适用的规则是死规则(gapless 铁律 + 幻影 ID,ADR-17 反例);(b) 保留 sync-mobile 作模板重渲染入口——留名即留「端 → 端」复活通道;(c) 用「名册首端」隐式充当 canonical 做 GENERATED 派生源——指针换个名字还是指针;(d) 删 co-owner(上文实测否决)。验真:canary 10/10 · mobile-dev 44/44 · verify-mobile 含 x-arch 全绿 · -m x-mirror 端根 / 模板目录 / 母本包根 0 红 · -v x-mirror / x-structure / x-i18n 36/36 · 反向注入(端内塞未登记文件 → 0002 臂③ 必咬;撤 co-owner → 探针 3/3 退 1/3)。诚实边界:client 阶段 VERIFY 对母本包源只加了 x-mirror 一组,其余 {mobile} 令牌规则书对包源仍只在全量检测兑现(登记,归 x-feature-dev 治理);端内点文件私加且无模板的形态仍在端锚视野外(引擎 dot 过滤,verify-mobile ② 走盘兜);各业务域 ARCH 散文里的旧号 x-mirror NS-COMMON-0002 归各域下次升版。
ADR-362026-09-06移动端系统层母本取得包身份(@wowoway/core),消费边界按 backend 分档,装配权在自有装配器(拆包 S0.1 · 裁定①②③⑥⑦ + 四项否决)病根:两端 xCore / xTools / xComponents / xType / xStyles / custom-tab-bar 逻辑共 248 文件靠 sync-mobile 字节复制维持等值——「复制」这个动作本身就是镜像债的来源(改一处必分发、副本超前即幽灵违规);09-03 原方案又有 14 处硬伤(lazyCodeLoading 与 x-route NS-MOBILE-0005 硬冲突、H5 装配器 COPY_EXCLUDE 剔除 miniprogram_npm 致 require / json / @import 三面在 web 侧同时死、x-backend 闭集不认 domains/、scanner 与 0010 不 lockstep、指纹牙未定锚、20 本规则书 paths 字面 x-client、workspace 单层 glob 等),69-agent 工作流审计后逐条改写。裁定:① 装配方式=自装配——x-core/tools/mobile.js 是唯一咽喉:weapp 腿把包源物化到各端 miniprogram_npm/@wowoway/*(复用 manifest.js sha256 / atomicWrite / prune 原语,同内容跳过、多余清掉、--verify 三态 + --closure 引用闭包两颗自检牙),web 腿把同一包源直拷进 staging 同一落点(webpack resolve.modules 加 staging 里的 miniprogram_npm、alias 键长降序、resolve.roots=端根);devtools「构建 npm」与 pnpm 软链 / packNpmRelationList / hoisted 三项 PoC 作废,miniprogram-ci 只作兜底。② 包切法=三包——@wowoway/core(core 与 ui 合一,落主包)+ @wowoway/goods(落主包)+ @wowoway/goods-lazy(落各端 goods 分包),域包住 x-core/mobile/domains/;第七条铁律:包→包引用一律 bare specifier require('@wowoway/<pkg>/<保形路径>'),包内才用相对,禁靠宿主别名;goods-sub 显式声明依赖 goods-domain(无环)。③ 牙=内容指纹牙(x-mirror NS-COMMON-0002:逐字节 equals、锚 package.json、缺失 / 不同步 / 多余三臂按 (pkg, end) 聚合、未装配独立错误码),版本号只作留痕。⑥ tabbar 壳化:壳 4 件 + config 留端、逻辑入包,tools/tabbar-updater.js 提前到 S10。⑦ MVP 顺序:S1 unit → S2 rate → S3 xType → … → S14 custom-tab-bar(不当首刀),S0.0 删除。消费映射由包声明:x-materialize { dest: "miniprogram_npm" | "<分包root>/miniprogram_npm", ends: "all" | [端…] } 是装配器 / auth-scanner / 0002 / 0010 四方共读的唯一一张表,端 package.json 保持零依赖;dest 指分包而端 app.json 无该 root 即 fail-loud。消费边界按 backend 分档:server 与 mobile-weapp = 物化消费;admin 与 mobile-web = 本机构建器解析;三档源码侧都写裸包名,差别只在「谁把包放到运行时读得到的位置」。四项否决:(a) devtools 构建 npm / pnpm 软链系(装配权不在我们手里、GUI 手点、无 CI、无牙);(b) 版本 lockstep 牙(server 实证改 1 字节 size 不变,移动端无上传咽喉、盘上陈旧照样上生产);(c) 目录改名(路径保形:业务别名 111 处零改、auth.js 两处相对 require 零改、arch/spec 路径重指最小);(d) lazyCodeLoading 按需注入进主线(与 x-route NS-MOBILE-0005 error 级硬冲突,07-19 两次真机 tabbar 消失,降为 S14 壳化后经 throwaway 端真机复测的独立候选)。实证:S0.1 行为床 30/30(探针包 alias require / 根绝对 usingComponents / app.wxss @import 三面全部打进 bundle;verify 改 1 字节 / 缺 1 文件 / 多 1 文件全咬;closure 注入坏 require / 坏 usingComponents / 消费集外包三种必报,注释里的 @import 首跑被当引用 → 补剥注释器);真端 --closure --end all 零悬空(x-client 781 引用 / x-technician 231 引用);两端物化 + --verify 全 ok;-m x-backend x-core 8 闸绿。诚实边界:六面 PoC(面①③④⑤⑥ 均无官方原文,含分包落点端到端)归 S0.3 用户真机,S0.1 只验了分包 dest 的声明校验;治理面前置(引擎根 / x-backend 闭集认 core·domains / 0002 指纹牙 / rule paths 工具)归 S0.2 尚未落地,当下 x-backend 对 core/** 仍是裸早退、包源内容零主战牙;H5 身份认证排 S10 之后;师傅端要不要 goods(⑩)与 S14 后是否复测按需注入(⑪)等用户拍板。
ADR-372026-09-06拆包裁定④「治理先行」:母本迁进包之前,治理面必须先能看见并咬住包源与物化产物(S0.2a 引擎半边 + S0.2b 规范半边),禁「先迁后补牙」病根:09-03 原方案把「迁 248 文件进包」排在「改 20 本规则书 paths / 扩 x-backend 闭集 / 定指纹牙锚」之前——迁入当天所有 {mobile} 规范对包源零射程、x-backend 0001 把 domains/ 判违规、镜像牙对 miniprogram_npm 结构性失明;三者叠加 = 迁入即假绿窗口,与「禁先放行后补」铁律正面冲突。裁定:S0.2 拆两半、都在 S1 首刀之前闭环。引擎半边(S0.2a):{mobile} 令牌射程 = 端根 ∪ 母本源根(MOBILE_SRC_ROOT_GLOBS),新增 {mobile-end} 端根限定令牌供端级规则(xStatic 顶层等)、tools.mobileSrcRoots 实存注入、rule paths 改由 spec 机械派生(meta sync --paths + validate 1b 集合相等,26 本当日归一)、L4 三通道生成物只读(isGeneratedArtifact)、闭包解析唯一实现收口装配器。规范半边(S0.2b):x-backend 0001 闭合形态收进母本包骨架 (core | domains/<kebab>)/{package.json, src/**}(src 内容归 {mobile} 各规范,本规范只认领骨架保 COVERAGE-GATE);0002 锚扩到母本包 package.json 但用独立 HIDDEN_PKG 表(IGNORED_DIRS ∪ {sys,templates},显式不含 locales/xType/xStyles——母本正当子树)+ miniprogram 字段实存校验;x-mirror NS-COMMON-0002 内容指纹牙立(锚 package.json、按 x-materialize 自探各消费端 <dest>/<包名>、逐字节 equals、缺失/不同步/多余三臂按 (包,端) 聚合、端未装配独立错误、名册外端 fail-loud)——「IGNORED_DIRS ≠ 免疫」自此有活体:miniprogram_npm 不被任何 spec 扫,却被本牙自探盘咬住;x-surface 0002 端根派生改「先匹配源根 → 全部消费端 app.json」;x-marker 0002 射程改令牌形态;x-standard 有效键快照 += mobileSrcRoots;宪法 rule paths 收 x-core/**;agent 写域切分(core/src 与 domains 归 client-engineer,backends 与装配器不归)。否决:(a) 版本 lockstep 牙(ADR-36 (b) 同理);(b) 把母本包 src 内容也交 x-backend 判(双重射程与 {mobile} 各规范打架,且 x-backend 不懂业务语义);(c) HIDDEN 单表通吃(把 locales/xType/xStyles 列禁名 = 把母本自己判违规,canary ⑤ 反向断言锁死)。诚实边界:指纹牙只证「盘上产物 ≡ 包源」不证「包源设计对」;空源目录零比对(装配器拒物化空包);x-materialize.dest 指向的分包 root 是否在 app.json 登记归装配器 packageDest fail-loud。
ADR-352026-09-06母本闭集扩五维(+值形态 schemes / +组件实例 API),backend 各设唯一兑现点;H5 云函数调用走 admin 同一条 HTTP 网关(D13 / D14 / D15)病根:真 x-client H5 登录页 11 个图标全碎——母本把 cloud:// 交给 <image>,微信 / Donut 原生解析、浏览器 404,且没有任何一环报错。归因不是身份(协议加载失败才是身份),是闭集少两维:注册表只锁指令 / 标签 / wx 令牌,值形态与组件实例 API(同日 NS-MOBILE-0005 立闸即抓出母本 self.animate( / clearAnimation 两个 backend 既没实现也没交代的成员)都在射程外 ⇒ backend 无义务实现、测试床不红。裁定:① x-surface 注册表加 schemes(协议 → kind / resolver / 接收入口)与 componentApis(methods / lifecycle / options)两表,母本侧 NS-MOBILE-0004 / 0005 两闸 + 元闸 ⑫⑬;② backend 侧 x-backend NS-COMMON-0007(标 resolver:true 的协议必须有唯一换算点 runtime/resolver.js,注册表登记的每个接收入口必经它)/ NS-COMMON-0008(runtime/capabilities.js 逐项声明 adapter / runtime / degraded,键集 ≡ 注册表,degraded 须在 _notes 写明);③ 今天 resolver 走确定性换算 cloud://<env>.<bucket>/<path> → https://<bucket>.tcb.qcloud.la/<path>(桶公网可读实测 200),桶收紧(D15,归阶段 S)时只换 resolver 的签名分支(setResolver 接管点),入口零改;④ D14:服务端只从 Authorization 头取 JWT ⇒ H5 云函数调用走 admin 同一条 HTTP 网关(runtime/transport.js),来源 web-{端} 由 env.config.end 派生、服务端策略表从渠道名册派生 web-{端} → ['token'](web 来源不入名册、不是端),handler 对已认证 web 来源不做 xfile 令牌化,file-url-read 开明文分支。实证:0004 反向注入 zzz:// 精确行号;0007/0008 三处同批注入报 2+3 处后还原全绿;行为床 22/22;真 x-client 重装配后浏览器 11 图 loaded 11 / broken 0 / cloud:// 残留 0;内核 0.2.0 + manifest --stamp,全量重发交 x-ops-deployer。否决:改 cloudAsset 吐 https(把换算点搬进母本,微信侧退化)、服务端吐 https(SDK 通道无来源可判且 admin 三层安全链失守)、Service Worker 拦截(第二处换算点,离线不可控)、另造请求层(真仓 IoC 接缝本在全局 wx)。诚实边界:两颗 backend 闸判「接入 / 声明」不判结果;web 来源 → 端身份表(customer_base)映射与短信登录归阶段 S1/S2;内核母本受 guard 保护区只读,改动经 node 脚本通道(锚不命中 exit 1),内容由 --changed / 部署 VALIDATE 兜底、用户审 commit 是天花板。
ADR-342026-09-05移动端 H5 = 四件套的第三个 backend(glass-easel 自建,住 x-core/mobile),不是第三份代码;wx 就是平台面(D12)病根:海外无微信 ⇒ 需要 H5,直觉方案是「把四件套改写成 H5 两件套」或「在 xCore 另开 adapter 层改写 40 文件」——前者是第三份代码(镜像债翻倍),后者是重复抽象(真仓 IoC 接缝本在全局 wx:source-injector 运行时劫持 callFunction,x-api STD 强制字面 wx.cloud.callFunction,五本规范把 wx.* 钉在收口文件)。裁定:四件套(js/json/wxml/wxss)是唯一母本,被微信基础库 / Donut / H5 三个 backend 消费;H5 backend 基于微信官方 MIT 组件框架 glass-easel(Rust WXML/WXSS 编译器 + 组件适配器 + webpack 插件)自建缺的四块(App / 页面栈 / wx shim / 内置组件),住 x-core/mobile/backends/web;编译单位是端,装配器 x-core/tools/mobile.js 住 x-core,名册从各端 env.config.js + app.json 自发现(与引擎 CLIENT_CLASS_ENDS 同判据,金丝雀锁等值),新增端零 H5 专属文件。可移植性的真正保证=「母本用到的语言面是闭集」+「每个 backend 实现该闭集」:x-surface 锁母本侧(WXML 指令 / 标签 / open-type / wx.* 令牌 43,伴生注册表棘轮只收不放),x-backend 锁 backend 侧(目录形态 / 引擎隐身名禁入 / 内置组件禁自嵌套 / shim 键集 ⊇ 注册表 / 装配器零端硬编码),两本各 5+4 条纯 NS 全部反向注入实证。实证:MVP 沙盒微信开发者工具 + 浏览器双通;真 x-client 副本一次装配通过(2159 KB),浏览器真实渲染 404 / 登录页、路由守卫生效。否决:副本式 H5 代码(镜像债)、adapter 改写层(重复抽象 + 五本规范连动)、先拆包再做 H5(拆包是包形态问题,与 backend 正交)。诚实边界:静态闸判形不判行为,运行时由 x-test 行为床 + 真机承接;身份 / 支付 / 地域 / 内容四条地基降级为框架层适配器(阶段 S),不是 backend 层问题;生成物目录 dist / .cache 对治理面隐身是设计(IGNORED_DIRS 同名),.gitignore 补 .cache 待并行会话释放该文件。
ADR-332026-09-03视觉原语治理归属定案:留在 x-styles(Style 治理版图第二半张图),数据独立成伴生注册表 x-styles-primitives.json;否决迁 x-tools 域与新建 x-primitive spec病根:原语(chevron / loading / select-dot / submit-bar 配方 + half-sheet / x-tab / x-dialog 组件 + admin phone-mockup)此前是 x-styles 轴注册表的一段附录,三颗闸靠它驱动,登记完备性零金丝雀(x-tab 曾漏登而无人知);看板曾主张「原语不是 style 的治理对象,归 x-tools」。裁断依据(三路独立方案 + 六份对抗反驳综合):① 逼用闸用轴 def 文件解析 var() 真值再判几何,是档位表的消费者 —— 搬出即「改档位表不触发原语规范同步」的半把锁,且引擎禁依赖业务注册表,故不可搬;② INV-06 纯净 / 规则引用 / schema↔闸三条元闸对原语闸的看守随迁移丢失,只能克隆,克隆正是本体系立法反对的逐字复制体;③ gapless 重编 25 号让床按 ID 静默换靶、镜像面注释集体失真,效力增量为零;④ 治理版图自身把原语定为 Style 第二半张图。边界:伴生文件靠同目录同前缀入 specHash 与 Stop 环扇出(version.js / stop-handler.js 前缀机制),detector 内 preg 与 reg 分名以隔离 0019 根键比对;0007 ⑧ 留墓碑编号不复用;补牙四条(0039 自洽含「声明或弃权」+ requireAttrs 对拍 / M0012 一原语一前缀 / M0013 组件目录归类 / 0017 端锚定 + 镜像域豁免解 0017×0034 catch-22);消费 STD 模板经论证为形式主义(属性值是任意 {{}} 表达式,pattern 只能退化为 .* 违原则 13),登记为带触发条件的待办。
ADR-322026-09-02detector 的解析能力必须是引擎原子,禁在 detector 内自写「声明 / 定义位 / 值文法」正则;白盒测试床必须复用引擎 buildDetectorTools病根:spec 内嵌 detector 的护城河有一个代价——每颗闸都倾向自写同一类正则,x-styles 一本 spec 实测 12+ 份副本各自演化,描边轴 105 用例台账判出 57 个口子,最大一族根因只有「副本数量」一个。处置:引擎新增 L4 原子 parsers/css-decl.js,经 tools.cssParser 注入,七颗闸改用;buildDetectorTools 抽为引擎导出、元规范 NS-COMMON-0024 有效键改 Object.keys(tools)。边界:原子只做 CSS 家族(less/wxss/wxml 行内)与 border 几何,JS 面表达式抓取暂留在 0010/0026 各一份(两闸同抓法,下一批可再下沉);detector 对缺原子注入 fail-loud,不兼容手抄 tools 的旧床(激进架构原则 14,不留兼容层)。活体:三端全扫除两处被新臂曝出的真裸值外 Δ=0;判据床 84 / 射程床 21 / 台账 OPEN 0。
ADR-312026-08-21生产表探针纪律:形态先空跑(WHERE 1=0)再放行,禁止用真实写路径试探能力边界病根:在真实业务载体表上验证平台行为(字段自动维护、类型转换、并发语义等)时,若直接执行真实写入,会产生不可逆副作用 —— 最典型的是消耗掉自动编号主键序列(无法回退,留下永久空洞),其次是污染业务数据、触发下游联动(台账/通知/对账)。决策:任何在生产载体表上的探针,第一次执行必须是形态空跑 —— 保持 SQL 与真实语句逐字同形,仅把谓词替换为 WHERE 1=0,确认语法、列名、类型、返回结构全部正确后,再放行真实执行。与 ADR-23 的分工(勿混为一谈):ADR-23 讲的是「平台写路径的能力边界必须实证而非文档推定」——回答「平台会不会做某件事」;本条讲的是「实证时的副作用纪律」——回答「怎么问才不会把生产库弄脏」。前者是认识论,后者是操作规程,二者互补且都不可省。为什么必须落 ADR 而不是留在施工文档里:施工计划按宪法「闭环即删」,这条纪律若只写在计划里,下一个做生产实证的人会重新踩一次不可逆坑。诚实边界:本条无 detector(机器无法判定一条 SQL 是"探针"还是"业务写入",建牙必然大面积误伤正常写路径),靠本纪律 + 既有的部署门与用户审 commit 兜底。
ADR-302026-08-20x-core 内核母本立项:从「复制 + 检测漂移」转向「构造即正确」;x-core 定性为 L5 被治材料而非新工件类病根:各端共享的系统层此前以副本形态存在(实测 208 个云函数 × 38 文件 = 7904 份副本在 git 跟踪面内)。副本形态的代价不是磁盘,而是它必须被持续检测:字节等值牙(臂A)、多余文件牙(臂B)、清单完整牙(臂C)三臂合围才勉强守住,而臂C 直到 2026-08-19 才补上——在此之前「删一个文件报 0 违规、只剩一个文件(缺 37)也报 0 违规」是数学性质(逐文件回调签名 (filePath, content, …) 必须先有 content 才被调用),不是覆盖率不足。决策:把母本收进 x-core,发布物由母本装配而来;没装配就没有那个目录,故「缺 sys」在物理上不可能发生——「验证产物正确」降级为「产物由构造即正确」。否决保守路径 A(保留 7904 副本、只加牙)的理由:副本满足用户定义的残留三判据(可独立编辑而不被立即发现 / 在版本控制内 / 在检测面上),而项目铁律是「禁止残留、禁止兜底、禁止兼容」;继续加牙是拿检测强度去补形态缺陷,牙越密越说明形态本身有病。x-core 的治理定性(D3 拍板 MINOR 的依据):它是 L5 被治材料,不是第五类受治工件、不是端、不改治理拓扑。判据 = 「若 x-core 整个消失,part1 框架能否独立自洽自测」——答案是能(guard / 元规范 / verify-harness 均不 require 它任何文件),故它是材料不是工具。若误定性为工具层,会出现「框架依赖材料」的倒置:删改 x-core 将连带瘫痪检测能力,而检测能力本该独立于被检测物。为什么不是端(D2 依据):端是业务承载单元(进 fan-out、有业务模块与页面),x-core 零业务;把它并进端名册会让按端名前缀匹配的消费点(索引扫描根 / 业务目录判定 / 覆盖闸)静默变语义,故引擎侧必须独立常量登记。同批修正的既有缺漏:宪法 §一 长期只列四端、漏登 x-technician(真实存在的师傅端小程序,217 文件受治),本次补录并把表头由「端」改为「顶层物」。master 目录名保持 sys(D4):改名会一声不响掉出 5 处按名匹配的保护(DOMAIN_SCOPED_DIRS.sys、结构 spec 白名单、guard 目录保护等),白拿的保护不丢。诚实边界:本 ADR 只记决策与定性;装配算法、目录级细节、牙的换装时序等实现层内容归 L3 规范与 harness 正文,按宪法 §七 不入宪法。不可逆点在去物化提交(git 移除副本),此前每步可回滚。
ADR-012026-06-22路线C:原地迁移(否决副本式双区)双区必然产生两套规范分歧;变更前必跑安全闸
ADR-022026-06-23L4 guard hook 上线生产(三环)block=反馈逼修,非自动改;检测锚在写入动作
ADR-03—specHash 用内容指纹(djb2)而非版本号版本号可撒谎,内容指纹不能;同步闸必须物理化
ADR-042026-07-02MCP 墙(mcp-policy)补最大盲区:MCP 本地写通道曾旁路全部写保护;供应链 fail-closed
ADR-052026-07-03乙案:彻底 hook-only,git 层整套退役(manifest 指纹清单、pre-commit、refresh、core.hooksPath 全部拆除)威胁模型下(solo owner+用户亲控并逐一审查 commit)提交时自动兜底冗余且添堵(CRLF 假拦实证);保护改为"hook 可见性 + 用户审 commit 硬闸";若未来重建 git 层,用 git blob OID 根治 CRLF
ADR-06—检测引擎单一真相源任何入口(工作流/hook/skill)一律委托 check.js,禁止重实现检测逻辑(重实现=漂移温床)
ADR-07—测试隔离于 x-test/引擎不扫 x-test;反向测试(制造违规)用 Edit 注入+还原,验真牙必须活体触发而非读代码自证
ADR-082026-07-06真相源禁引 plan 方向闸(GOV-LINK)+ 死链根治真相源(宪法/rules/harness-eng)引易逝 plan 必死链(实证:宪法引已删 l4-fusion、x-jwt-rule 引已删 jwt-plan);新增 x-governance NS-COMMON-0004 方向性负空间闸(扫真相源集 CLAUDE.md∪rules∪harness-eng、含 glob 元字符的元描述豁免),清零全部真相源 plan 引用;plan 长期结论固化进 harness-eng/arch,backlog 转 MEMORY。为 arch 业务架构治理层(Stage 1)先立"真相源禁引 plan"物理闸
ADR-092026-07-06建业务架构层 arch/ + x-arch 三件套(T2 结构真牙)业务领域端到端设计此前无保鲜载体、随代码静默过时→立 .claude/arch/ 常青真相源(DDD bounded context,与 x-data 归类层 1:1,registry opt-in 防考古洪水);x-arch 纯 NS 三件套装 存在性闸(注册表登记域必有文档)+ 文档头完整性闸(frontmatter 七字段/describes 四端键/layer=business/status 枚举/specRefs 非空则正文须引用=I2 句法代理防第二真相源);detector 域无关(读注册表/frontmatter 零硬编码域)落实"框架操作业务但绝不依赖业务"铁律;NS-COMMON-0004 扩域覆盖 arch/。srcHash 四端保鲜牙 + 框架禁依赖业务闸属 Stage 2(须先 benchmark 假阳率 + .js 作用域核实)。诚实边界:机械强制文档"被改/被重看"非"设计对"
ADR-102026-07-06并行会话隔离铁律(多会话非干涉)威胁模型从「单 AI」扩为「多 AI 会话并行,working-tree 改动交织」:全量检测/保鲜牙(srcHash/specHash)会报出他会话在途的规范类漂移,若本会话"代修复/代归档"则相互覆盖冲突。立铁律:各会话只归档自己引入的改动,判据=本会话是否引入,非本会话域告警静默跳过。实证:本会话做 §2 customer/技师 lastLogin 修复时,全量 x-arch 报 order/dispatch srcHash 漂移(他会话在途、describes 窄域不重叠 customer),按本律不碰。落地=宪法 §六.6 + §二威胁模型「并发会话」行
ADR-142026-07-10乙++:node-fs 写洞根治层(分治+每洞有 owner,非扩 guard)三轮 ultracode 复盘(全实证 file:line + 活体)裁决"node 脚本.js 内 fs 写结构性绕过 guard 全部三环+部署门 isPending+settings allow(Bash(node:*) 全放)=零自动强制,且能重写 guard/check.js 本身"。撤回方案甲(Stop 环3 changed-set 从会话队列换 git --porcelain):live 证 git 工作树 131 脏含 ~124 他会话在途→本会话 Stop 会卡他会话违规=破 §6.6;git 零会话归属,想减他会话必重引队列=自我否定(队列=flow 会话级/porcelain=stock 跨会话,不可换)+ 不碰部署门=伪全称。否决方案丙(命令层解析 node 命令):对脚本内部 fs 写透明,不健全。选乙++=①有界脚本 fail-closed 自检(execute-delete.js 删除循环 try-catch 报"已删/失败于/未删"部分态;写类未来 stage-validate-commit 原子 rename)+②部署门错层重设计:真部署路径 node create-deploy.js(tcb 是孙进程 guard 不可见),真 owner=deploy-script validate/index.js 内 VALIDATE,从 -m x-deploy(结构/打包/sys)扩为 --changed 内容门(对部署目标业务源[排除 sys/]跑全部适用 spec,file-state 读盘抓任何通道坏内容)+③删退役层谎言(guard.js×3 含用户可见 BLOCK 文案 / command-policy.js×2 / verify-harness.js:286 / check.js:413 共 7 处,把已退役 .githooks/git pre-commit/manifest 谎称"活闸";保留 stop-handler.js:55 · verify-harness.js:245/317 等诚实"已退役"声明)+④诚实声明唯一权威=用户审 commit(措辞改避撞死命令原则6:内容侧 file-state -m 自动兜底,人审是天花板非唯一执行)。否决 watcher(自保护可被 taskkill/破 §6.6/win32 丢事件,五维被支配);blob-OID 进程外完整性闸=DEFERRED(治控制面完整性,当前 Write/Edit/Bash 已由 isSpineTarget/isEngineTarget 拦,node 洞由人审兜)。三不可消解残余(只声明,任何机制关不掉):win32 无 LSM(node 写实时封闭平台级不可达)/ 删除原子性(rmSync 非事务)/ 自检脚本 AI 可改(终极权威回 ④)。verify-harness 121/121 + ①②各活体测试闭环。诚实边界:哲学一致=harness 从非零信任("可见的绕过是设计接受的残余",§二),乙++ 不引新妥协只是该定型残余的具名实例;x-auth-spec.md:977 残留 git pre-commit 提及(低爆炸半径,改 spec 破 specHash 归 /x-meta-dev)+ mcp-policy.js 6 处 .githooks 防御写路径(死防御模式非谎言,blob-OID DEFERRED 前保留)未清=诚实不吹"退役引用清零"
ADR-152026-07-10ADR-14 两 FUTURE 项终裁:route-surgery.js 现在建(闭删除动词物理断裂)+ blob-OID 结构性否决(WONT-DO 三段式,取代 ADR-14 的 DEFERRED)两轮对抗(11 agent·变异体矩阵+活体探针)裁决。①route-surgery.js 已建(.claude/skills/x-module-del/scripts/ 含 verify-route.js 原则11 中转):routes.ts 是删模块唯一被 X-RULE 标记闸挡的足迹(Edit 删路由块被环1 markerDropBad 拦 exit2 活体重证),此前无 node 执行器=第一最高律的删除动词在 admin 物理不能闭环(SKILL.md「routes 走 Edit」系死文档)。否决扩 guard 例外(guard 无 skill_name 感知无法 scope=永久全局放行;组删括号崩恰落 Stop 无 -c 编译臂 + -m x-route 不解析 JS 的唯一盲区)。设计=componentDir 定位(全路径/唯一尾段;隐含前缀契约对 9/24 leaf 失效已修)+三态 fail-closed(NOT_FOUND 幂等/UNMARKED 列行号/RESIDUAL 禁落盘)+组塌缩镜像 NS-ADMIN-0011(warning 态=假通行证同计 violations exit1,--collapse 强制二选一)+四牙链自检(TS parseDiagnostics→X-RULE per-signature 配对栈→剥离括号平衡→★vm 装载+路由树递归校验:抓数组 elision/name-shorthand 等连 tsc --noEmit 都假绿的形态,tsc 方案否决★)+temp+rename 原子写+path-scoped git 闸。即时自检剔除 -m x-auth(活体证:路由已删、模块 tsx 未删的编排中间态 NS-ADMIN-0006 必误报——0006(tsx→routes) 与 0013(routes→tsx) 构成引用环,数学上无任何步序使全部跨文件不变量连续成立),即时只跑 -m x-route 单目标(中间态 11 规则 0 误报实测);宽域归编排末步全量。SKILL.md 步序判死反转:原「先 rmSync 目录后编辑 routes」踩 0013 红窗 + rmSync 后手术 abort 无退路(违原则12 禁 git 恢复)→ 新序=路由手术最先(abort 零污染)→Edit 足迹→app.json→rmSync 最后→末步全量。38/38 测试(沙箱 --project-root 重定向 + 真 NS-ADMIN-0011 detector 抽取验证塌缩产物归零 + 牙2 预损坏禁落盘 + CRLF 保持)。as-built 两轮对抗(v3 揪 3🔴6🟠 + v4 修法验证)后 v-final 硬化(v1.8.1):R1 定位 fail-closed(前缀命中 ABORT_PREFIX_HIT + 逐行 component 精确提取替子串)/R2 嵌套子组名并入 deletedGroups(防孤儿键)/R3 scan deleteScope 映射诚实化(值域无 leaf,仅 advisory 权威=surgery 三态闸)/F15 空占位子组拒删(§6.6)/S1-S4(三元去重·紧凑 JSON·realpath 归一·planned-reason 拒换行∪X-RULE 注入)/F11 verify timeout/F13 TOCTOU 拒覆盖他会话 + S5 --delete-empty-group 空占位组唯一出口;32/32 测试。顺带订正两处 header 半谎言(routes.ts:2「由 menu-sync 自动生成」+ xCore menu-sync.ts:2「自动同步 routes.ts」——plugins/menu-sync.ts:79 明证只碰 i18n)。②blob-OID 本地自证闸:WONT-DO(结构性否决,取代 DEFERRED)。理由 A(永久,与威胁等级无关):钉值与被守护对象同信任域——一趟 node 洞可同改 guard 与钉值=自证循环,本地 blob-OID 在任何威胁模型下都是错答案;理由 B(现状实证):控制面文件(guard.js/check.js)合法 M 态是常态工作流,钉 HEAD 即持续误报=ADR-05 退役的 manifest-refresh 摩擦重生(CRLF 假拦真根因=旧 manifest 裸字节哈希选错方法,非 blob-OID 固有优势);失效/升级条款(预注册防错误锚):威胁模型升级(多人写权限/远端 agent 持写权限)时本决定不重开——预注册正解=服务端 branch protection + CODEOWNERS + required checks(Git Pro Book/SLSA 一致:提交强制在服务端不在本地);诚实残余:控制面 node 写两 commit 间无自动闸,唯一权威=用户审 commit diff(ADR-14 已声明,不变)。mcp-policy.js 6 处 .githooks 防御写路径随 WONT-DO 定性为永久死模式,因属脊柱留待下次开闸维护时清理
ADR-162026-07-25迁移窗口物理闸(mcp-policy V2-9):框架级迁移铺开期禁 MCP 推代码绕 SERVER VALIDATE框架级迁移(如把访问控制位从中心清单下沉进每函数 package.json)存在铺开窗口:近 200 个云函数分批上线期间,任一函数绕过 x-deploy-dev SERVER VALIDATE 直发,即把未写/错写控制位的函数推上生产(列越权泄露 或 读停摆,且全链路零告警)。而 x-deploy-dev 明文允许 MCP manageFunctions 更新已有函数(每批 10),该通道不经 check.js → 迁移期唯一无闸旁路。否决"口头纪律"方案(用户 2026-07-25 拍板):纪律无判据区分「迁移中 vs 常规改码」、与既有 skill 铁律正面冲突、不可执行。落地=哨兵文件 .claude/tmp/migration-lock 在场 ⇒ manageFunctions 三个代码上传类 action(createFunction/updateFunctionCode/incrementalDeployFunction,经 ToolSearch 一手 schema 核实 @2026-07-25)硬拦;非上传 action(invoke/config/trigger/layer)语义不变。架构对称=guard.js 侧读盘注入 ctx.migrationActive → mcp-policy 纯函数判定(镜像 declaredEnvId→expectedEnvId 先例,保模块可离线穷举自测);manageFunctions 由 GATE_TOOLS 迁入 SPECIAL_TOOLS(19 读 / 13 门 / 8 特判,总数仍 40,顺带订正头部注释既存计数漂移 18/15/7)。verify-harness 128/128(新增 MG1–MG7 三向合围:三个上传 action 全拦 + 两个非上传不误拦 + lock 不在场时 V2-8 语义零回归)。诚实边界:①闸只封 MCP 单通道,node 脚本 直发部署仍走 ADR-14 的 node 洞(由 deploy-script 内 VALIDATE + 用户审 commit 兜);②lock 是协作式哨兵(同 actor 可 rm),非防恶意,语义=让"绕闸"变刻意可见,与 §二 软保护哲学一致;③解闸靠人删 lock,忘删=后续常规 MCP 更新被持续拦(fail-closed 方向,噪声可见而非静默失效)
ADR-132026-07-10L4 guard X-RULE 标记防篡改精化(marker 正则细化 + x-logging 整块删窄口例外)清 x-client 调试日志时揪出 guard 环1 marker 计数防篡改两缺陷:①粗正则盲区——/X-RULE-[A-Z0-9-]+/g 在小写/CJK 处截断,所有 X-RULE-BEGIN-STANDARD-x-* 收缩成同一粗 token,产生「删 x-api 块 + 加 x-preload 块」计数不变的 swap 盲区 + P 段/CJK 名改名不可见→改 /X-RULE-\S+/g 捕获完整标记(防篡改只增不减);②过度拦截——guard 禁业务码删任何 X-RULE 标记,但 x-logging STD 要求日志必 X-RULE 包裹→删日志必连包裹删→误拦合法删除→加窄口例外:仅当【所有】下降标记都是 x-logging 且 BEGIN/END 计数平衡才放行(日志纯诊断、删除不藏任何规则违规、Stop-cycle x-logging 兜底空块/不配对;删 x-api/单边/改名/诱饵/混合一律仍拦)。12/12 活体测试(spawn 真实 guard.js 喂 tool_input 验 exit code:合法删日志 exit0 放行 / 篡改 exit2 拦 / spine·保护区其他防护未破)。诚实边界:例外按计数平衡放行,极端畸形 x-logging 编辑由 Stop-cycle -m 兜底(与 guard「粗写前 + 全量 Stop」设计一致);guard.js 属脊柱 AI 只读,变更由用户开闸(settings.json PreToolUse→_PreToolUse)→ AI 改 + 活体验证 → 用户改回,符合「正当维护走人工/进程外」原则
ADR-122026-07-10跨域 REFERENCE 探针合法性澄清 + 否决 ServerSystemError 新类(api↔exception 耦合拓扑)两轮深度分析(ultracode·全实证 file:line)裁决用户命题「api 该否内嵌 exception」:①真相=ApiResult 信封是 x-type(形状)/x-api(载荷 api·data)/x-exception(异常语义 code·message)三 spec 按字段分治的共享契约工件,不是谁整包内嵌谁;②一个 spec 的 detector 伸进另一 spec 契约域(NS-SERVER-0005 探 data.failedList 项形状、NS-SERVER-0006 探 server 裸抛→类型化)是合法跨域 REFERENCE 探针(与既有 x-i18n 探 curd columns / x-address NS-SERVER-0002 探 repo json / NS-COMMON-0032 探 server zod 同质),非越界;③物理 EMBED(marker 内嵌复制)只在单文件共址点成立(controller.js 的 x-exception STD-SERVER-0001-P3 物理嵌在 x-api STD-SERVER-0001-P1 内,原则9 跨域嵌套已许可),跨文件链走 REFERENCE。否决 server 新建 ServerSystemError 类(红队四路证伪:前提假=run-read-sql.js 早用 ServerBusinessError+SYS_500 表达不变量、tier 由码前缀非类承载;新类冗余=controllerSystem catch 鸭子类型零 instanceof;没杀 controller.js:145 运行时三方 catch-all 兜底;升级 :175 dev 消息泄露)。否决 curated 内容排除表(=兜底残留清单,违原则5/14)。落地=NS-SERVER-0006(server 业务禁裸 throw new Error,区域感知豁免 STANDARD 模板域,全结构零内容清单,不变量→ErrorCode.SYS_500/业务→Tier-2)+ Seam E(admin requestErrorConfig.ts tier-gate 治 system 码 dev 技术串泄露给客户)。诚实边界:消灭内容级白名单(真零兜底),但目录/标记域豁免=scope 非 fallback、运行时三方 catch-all=不可约(行业标准 gRPC INTERNAL/AWS server-fault),禁吹"字面零兜底"。护城河「spec 内嵌 detector」由此获跨域探针合法性判据:探他 spec 契约域的语义(非形状)是合法 REFERENCE,形状归 owner spec
ADR-112026-07-07建 agent 执行工件类 + x-agent 三件套(第四类受治工件,非 L6 横层)agent(.claude/agents/*.md subagent 身份文件)是继 spec/rule/arch 之后第四类受治文件:纵贯 L2(被编排)–L5(产码)的执行者,非新控制层(六层是控制海拔,L5 代码在最底,"L6 在其下"语义倒置=代码控制 agent)。照 ADR-09 x-arch 先例立 part2 横切三件套 x-agent(纯 NS,detector 读 frontmatter/注册表零硬编码域,恪守 part1 操作业务但绝不依赖业务)。反漂移承重墙="薄 agent"(正文禁复述规范只指针→漂移构造性根治,同 x-arch I2 specRefs 防第二真相源);辅以三闸:死指针存在性闸(引用即指纹)/第三方登记闸(绑定 skill ∈ 登记表且非默认禁用)/新能力覆盖认领闸(每 SKILL.md 必被某 agent 认领或显式豁免 reason+date)+ model 白名单。否决:逐依赖 specHash 指纹(agent→skill 是引用非派生,派生才需锁步指纹;逐字节钉=橡皮图章疲劳真阳率≈0)、coordinator agent(官方 depth>1 静默忽略 + 与 x-feature-dev 双编排器冗余,编排留主会话/L2)、x-meta-dev --domain=agent 签发(part1 长出 part2 专属代码)。诚实边界:第三方 skill 经 npx/plugin/cp 走 Bash 落盘,不在 L4 写保护谓词与脏队列覆盖面→"skill 变→绑定 agent 复检"只在下次全量/部署门保证非当轮实时(要实时须 Phase2 加 .claude/skills 面 + Task 派发新鲜度闸,属脊柱变更须单次授权)。诚实上限:机械强制文件结构与"被认领",强制不了提示词语义正确,归人审 commit
ADR-162026-07-11arch 收尾执行器终裁:ARCH-SYNC 升 L2 硬步 + Stop per-turn 锚注入否决(闸位/归因/语义三重错)活体案发:个人资料改 customer server/admin 后无任何机制逼回看 customer.md(13→17 字段/「无自助编辑」陈述静默成假话),全量 srcHash 牙报了却被 §6.6 误归因他会话——暴露「架构收尾无执行器」治理空洞。六路取证 + 三探针(P1a --changed customer业务码 exit0 洞活体复现 / P1b +customer.md 锚注入 exit1 端到端咬合、八道引擎门全过 / P2 反查映射 6/6 含 order-create→order+coupon 双域重叠与 technician/settings 空洞直通)+ 独立对抗审查 10 findings 后终裁。否决 Stop per-turn 锚注入(机制可行已实证,但:F1 闸位错=真定稿闸 deploy VALIDATE 门2 只收 .js/.ts 仍 arch 盲,Stop 是最不可行动时刻;F2 咬错会话=队列无会话标记先到先得整体窃取,当时稳态 3/8 域他会话陈旧→任何会话触碰即被 block 且队列清空致责任会话永收不到反馈=错向执法,方案甲 flow/stock 判决换皮复活;F3 橡皮图章均衡=per-turn 逼 sync 的最小合规动作是只刷 hash,x-arch 自身即现行犯——rule specHash 已同步却缺 0003 行、spec 简介谎称"暂不含"而正文含 detector;F4 stop_hook_active 弹一次即零成本忽略+block 消息内嵌 §6.6 忽略指引=教 AI 学会"可正当忽略类"向全 spec 泛化,慢性投毒 L4 权威)。落地两层强制点:①全量检测唯一物理咬合(x-feature-dev VERIFY 阶段)②ARCH-SYNC 升收尾硬步(x-feature-dev v1.1.0 四→五阶段:PLAN 读 arch 域文档 + 收尾 spawn x-architect 回看+升版+重算 srcHash,跳过=禁入 DEPLOY;x-architect 职责早已声明只差接线,recon 证工作流对 arch 约束强度原为 0)。同步修复三件套三处真相源矛盾(spec 简介谎言行/NS-0003 强制点描述/rule 缺 0003 行,specHash 566565e5→e205b972)+ customer.md v0.2.0 ARCH-SYNC 示范闭环。backlog(预注册防遗忘):deploy VALIDATE 门2 arch 反查注入(部署目标源→describes 反查 arch 文档并入 --changed;validate/index.js 他会话在途,落地后单独 ADR)。诚实边界:arch-first(写时先读设计)物理不可强制仍靠 L2 向导;未建档域零牙(registry opt-in,Stage-3 考古);ARCH-SYNC 硬步对绕过工作流的裸开发无效(绕过工作流≠绕过检测,全量牙仍咬)+ 多会话归因靠 §6.6 判据非机器
ADR-172026-07-13检测器/分发器极性错配是一类系统性假绿:立"极性同构 + 分区完备性金丝雀"为通用范式(L1.5 co-owner 语义扩展)活体案发:x-mobile-dev manifest 于 2026-07-12 反转为黑名单极性(基包 = canonical 全量复制 − 业务封闭集),但 x-mirror-spec 的 includes 仍是白名单枚举(10 条前缀)。镜像牙适用面 211/端、旧白名单只覆盖 89 → 122 个框架文件(单端·索引后缀口径)零牙;实测同期 5 个真漂移(他会话改 canonical 未 sync)只咬到 1 个,牙报「✅ 完美 0 violations」= 结构性假绿(不是漏报某 case,是那片区域根本不在扫描域里)。根因抽象(可泛化):凡「修复器/分发器」与「检测器」各自持有一份适用面定义,极性或内容不一致时,检测器的绿灯只证明"它看的那部分是对的",不证明"东西是对的"——两个真相源必须机器强制等价,否则必然重新分家。三处根治:①L4/L3 引擎 co-owner 语义扩展(check/constants/defaults.js DOMAIN_SCOPED_DIRS:locales/xType/xStyles owner 由单值扩数组各 +x-mirror-spec)——L1.5 领域独占是物理墙(非 owner spec 在聚合阶段被剔除,写了 includes 也扫不到);co-owner 判据 = 轴正交性:x-mirror 持横向端轴(跨端字节等值)、领域 owner 持纵向内容轴(键完整性/契约形态/样式规范),两轴互不干涉(先例:sys 已由 x-deploy/x-exception/x-jwt 三 owner 共管)②x-mirror-spec V2.0.0 极性反转(includes = 端根全包,excludes = 54 条封闭集:业务 26 + per-end 生成物 20 + AUTO-GEN 8 × 双根;端差异面 xStatic 图片引擎不索引、不入表(⚠️ 此句已被 ADR-24 证伪:引擎索引无后缀白名单,排除表已于 2026-08-07 补回 2 条后缀集 glob);rule specHash → b31a2f07)③分区完备性金丝雀(verify-mobile ②:A 包含面=端根全包名册派生[窄化即盲区复发,原始病根] + B 排除面=manifest 五分区 ⟺ spec 排除表,模式集 + 逐文件双向等价,任一向漂移即 fail-loud)——这是「盲区不可再生」的物理保证,也是本 ADR 要立的通用范式:凡出现"工具侧适用面 + 牙侧适用面"的双真相源结构(sys-sync ↔ NS-SERVER-0002 字节牙、未来任何 generator↔checker 对),都应配一颗等价金丝雀。新增第五类分区 END_DIVERGENT(端自留地:xStatic 静态资源——目录架构两端一致、图片内容各端自换;sync 永不覆写,防分发把师傅端图标覆写回 client 的图;与 GENERATED 的区别 = 后者由 create 现算重写、前者只复制打底)。反向实测(全咬):xType/xStyles/locales 三片 co-owner 各注入漂移 → 3/3 咬中(证引擎三行非纸面);xStatic 注入 → 正确放行;幽灵文件 → 抓获;撤 END_DIVERGENT → 金丝雀双重炸响(模式集缺 2 条 + 逐文件 38 处失配)。镜像牙适用面 89→422 文件(双端),x-mobile-dev tests 28→33,mobile.md v0.4.0。同日对抗审计后 V2.0.0 收尾修正(逼出自己一整类"改一处不看引用它的另一处"坏习惯,18 findings,3 真缺陷):①金丝雀原只校验「排除面」漏「包含面」——补 A 包含面断言(端根全包名册派生,窄化即 fail-loud),堵住"窄化 includes 令 122 盲区原样复发而金丝雀照绿"的同型向量;②END_DIVERGENT 原整树 xStatic 把受治 .js(icons/index.js 图标池锚点)一并摘出镜像牙=净丢牙,收窄为二进制图片后缀判定(图片各端自换、.js/.json 清单归镜像牙字节等值),排除表移除 xStatic(⚠️ 此判断已于 2026-08-07 被 ADR-24 证伪:引擎索引零后缀白名单,图片照进索引照比对,移除即制造 5 处常态假阳);③引擎常量改了 co-owner 但 x-standard-rule L1.5 名册表未同步=会误导他人删 co-owner→盲区复活,补表 + co-owner 语义 + 删除后果警告。诚实边界:①~~引擎索引后缀白名单 = .js/.json/.wxml/.wxss,图片等二进制物理不进索引~~ ⚠️ 本条已被 ADR-24(2026-08-07)证伪并作废——引擎索引零后缀白名单,图片照进索引照被字节比对;该假边界致端差异面排除长期缺位,5 个 tabbar 灰度图标常态假阳挂红,且把真报警包装成「已知噪音」使人不再复查;②icons/index.js 图标池锚点已归镜像牙受治(键集跨端字节等值),原登记的「图标键契约金丝雀」后续步已由 index.js 归还提前闭合——图片内容自由、键清单强制统一;③金丝雀是 skill 侧脚本(非 L4 hook),绕过 verify-mobile 直接改 manifest 不会当轮被拦——全量检测与 x-mobile-dev 流程是其咬合点
ADR-182026-07-14云端配置盲区 = 检测引擎射程外的第三类真相源(部署四件套的固有天花板,立"云端真相不受治"边界声明)活体案发:admin 从静态托管根目录迁子目录 x-admin/ 并删根目录旧文件后,生产域名 wowoway.cn 立刻 404。根因:wowoway.cn 非绑静态托管,而是 HTTP 网关一条路由(Path=/ → UpstreamResourceType=STATIC_STORE + PathRewrite.StaticStorePrefix="/")反向代理到托管根目录;这条网关配置只存在于腾讯云端,代码库零记录(grep StaticStorePrefix/wowoway/gateway 全库零命中),检测引擎只扫代码文件物理看不见。改部署目录未同步网关前缀 → 反代落空。用户控制台改 StaticStorePrefix: /→/x-admin 修复(反向代理,地址栏仍 wowoway.cn)。根因抽象(可泛化第三类真相源):除①代码文件(引擎可扫)②云端数据(MCP 可查、已用于业务),存在第三类 云端配置真相——网关路由/托管 websiteConfig(IndexDocument/ErrorDocument/routingRules)/自定义域名+证书/云函数环境变量密钥/登录认证提供商开关/CORS 安全域名/云存储权限。它们决定生产可用性或安全,却只在云端、代码库无声明、spec 内嵌 detector 射程外——改错即生产事故或数据泄露,且当前无任何牙能发现漂移。opus4.8 五路审计 + 对抗官逼假绿裁决(不能宣布 deploy 四件套闭环):①对抗官亲手注入实测证实 NS-ADMIN-0004/0005 改名旁路(stageDeploy→shipIt 定义+调用点双改 → 0004 continue 静默跳过 + 0005 顺序检查 deployCall=-1 逃逸 → 根路径部署 0 违规)= 我方本会话真假牙,已修(缺函数即违规,反向验真 2 处精确咬合);②spec 自称「精确断言/禁弱代理」与 no-op 恒真闸(existsSync 结果丢弃 return true)实测矛盾 = 原则1 三位一体谎言,已诚实降级(spec/rule 检测边界章声明:detector 保证 canonical 结构在场,无法验控制流语义,更无法验运行时 MCP 调用真用了 cloudPath——deploy.js 只 console.log 指令、真实 delete/upload 操作者手动跑);③SKILL.md 四处附属表漂移(流程3 改六阶段但架构速查/数据流/禁止表/文档表滞后)已同步。L4 运行时零牙实证(源码逐行):mcp-policy.js:129 对 manageHosting upload/delete 只粗粒度 gate、从不读 cloudPath;部署门 guard.js:62 只在脏队列非空时触发且理由是"本轮有未复核写"、与 cloudPath/CLEAN 无关;command-policy 无 tcb 词条 → 直接调 MCP 传根路径/跳过 CLEAN/用 tcb hosting deploy,guard 一条都拦不住。真正运行时防线 = 操作者遵循 skill 流程(向导层),非 hook 强制(传感器层)——与 ADR-14「win32 无 LSM,可见的绕过是设计接受的残余」同源。治理方案(backlog,非本次实施,需用户授权):立云端配置金丝雀——用 MCP 只读拉线上网关路由/托管 websiteConfig/自定义域名,与代码库声明的期望值(如 arch 文档或专用 cloud-config.expected.json)机器比对,漂移 fail-loud;契合宪法「spec 内嵌 detector 护城河 + 原则6 自动化检测」,把第三类真相源从"人肉记忆"变可检测。诚实裁决:deploy 四件套结构骨架诚实(specHash 一致/9NS↔9禁令/三阶段全绿/改名旁路已堵),但「运行时防错误部署」+「云端配置漂移」两类实质保护靠当前架构(脚本只打印+guard 不读 cloudPath+云端配置引擎不可见)永远达不到——此为架构固有天花板,写死边界声明,不得粉饰为已闭环。
ADR-192026-07-14L4 端类写保护单一真相源根治:guard 派生 terminals 名册,消灭"新端出生即裸奔"(D3 两根真相源金丝雀桥接)活体案发:移动端基包全链断层审计发现,L4 guard 两处写时保护正则(guard.js:90 isBiz X-RULE 删除计数闸 + command-policy.js:130 isBizSource Bash/MCP 裸写闸)硬编码 (x-server|x-admin|x-client|x-data) 漏 x-technician——师傅端是43 文件带 X-RULE 标记的活生产端,其治理标记可被写时删除/篡改而 guard 不拦(x-mirror 全量牙只事后兜底、非写时)。且这两处正则未接 arch mobile.md §一 早已声明的单一真相源(「client 类实例名册...禁止消费点私自硬编码端清单」)——guard 正是违反已声明架构的消费点。根因抽象:端类身份散 7 处,4 处派生(roadmap/manifest/strategy-config/auth-scanner)、2 处沙盒硬编码有金丝雀(x-mirror detector/role.constants)、2 处 guard 硬编码无金丝雀(裸奔);另 terminals.js(引擎目录轴)与 channel-config.js(服务端身份轴)两根真相源执行上下文隔离、无相互金丝雀(D3 缺口)。opus 对抗自审 + 真探针实证(非推断):①../../ 从 command-policy 真 require terminals.js 成功(2.8ms/fork,terminals 零依赖+受 isEngineTarget 保护不可移=死指针自曝)②派生正则从 TERMINAL_DIRS 现算,x-technician 命中、x-data 命中(证派生源须 TERMINAL_DIRS 非 BUSINESS_DIRS——后者不含 data)、模拟 x-merchant 登记一处即自动保护③自审揪出并修复瑕疵B:原设计 isBizDir 假设输入已归一,但 guard 传 fpl(不折叠 ../)与 command-policy 的 normPath 不一致→改 isBizDir 内部 normPath,foo/../x-technician 逃逸被堵。落地(激进单源,零残留):command-policy 成唯一派生点(require terminals + escRe 转义 + BIZ_DIR_RE + isBizDir 内部 normPath),isBizSource 收敛用 isBizDir,export isBizDir;guard.js:90 删硬编码正则改 isBizDir(fp)(删死变量 fpl);hooks 端类硬编码归零。D3 金丝雀(x-test/terminal-registry-canary.test.js,非脊柱):terminals.CLIENT_CLASS_ENDS ⟺ channel-config 端集 + isBizDir 覆盖全 TERMINAL_DIRS + client 类 ⊆ 终端目录。测试闭环:spawn 真实 guard.js 10 活体用例全过(x-technician 从裸奔→拦、x-client/data/admin/server 回归、references/非业务/不删标记边界、大写/../折叠归一化);反向验真 3 处(旧硬编码→x-technician 退裸奔 exit0 / isBizDir 硬编码→金丝雀第2项炸 / CLIENT_CLASS_ENDS 加幽灵→D3 等值+子集项炸);测完清临时探针零残留,另两金丝雀未波及。框架特性:guard 目录级保护对小程序 ///<!-- --> 与 umi-tsx {/* */} 透明,一套派生统一覆盖两框架端=强度非妥协。脊柱程序:guard/command-policy 是 isSpineTarget AI 只读,本次经用户手工开闸(settings.json PreToolUse→_PreToolUse)实施,完成后用户须关闸;改动不撞他会话 ADR-14 文档注释在途(只碰函数代码)。诚实边界:①node_modules 过度匹配=原正则存量行为派生忠实继承(无害,没人 Edit node_modules)②x-mirror detector/role.constants 沙盒/umi 边界物理不能派生,保留硬编码+既有金丝雀是天花板③两根真相源无法合一(引擎 vs 服务端模板上下文隔离),D3 金丝雀桥接是现实最优。
ADR-202026-07-15移动端类检测统一:opt-in 令牌 + scanConfig 端类展开 + tools.mobileEnds 三引擎机制(census 转述分类不可靠经 opus 亲读重审修正)活体案发:18 spec 中 12 只扫 x-client,师傅端 258 真实文件裸奔(5 假绿 + x-structure 假阳 173)。census(转述审计)不可靠——把有 /^x-client\/pages\// 正则的 x-structure 误判端无关,故 opus 逐 spec 亲读 detector 重审得真分类(Class A 11 / Class B 7)。否决 blanket 隐式展开(裸 x-client 自动覆盖两端):对 detector 硬编码 x-client 的 Class B 产假阳(x-structure directory readdirSync 文件 ENOTDIR 173)+ 假绿(Class B else return 静默放行,比假阳更毒),且违显性/禁兜底。三引擎机制(CLIENT_CLASS_ENDS 单源,加端一行自动覆盖全类):①spec.js expandMobileClassCoverage opt-in 显式 {mobile}/ 令牌(裸 x-client 保持单端=安全,真 client-only 规则天然豁免;元规范 NS-COMMON-0018 加 {mobile} 花括号豁免 + NS-COMMON-0024 tools 白名单 +mobileEnds)②extractScanConfigByTerminal 目录模式 CLIENT config 派生 TECHNICIAN(root 端根 swap;x-i18n directory applicableFiles 是目录路径故无 ENOTDIR,x-structure file glob 靠 scanConfig 提供目录目标 + opt-in 过滤配合)③non-standard-checker 注入 tools.mobileEnds(detector 端分治去硬编码经此,禁 vm 沙盒 require 名册)。6 Class B 去硬编码:端根派生 relativePath.split('/')[0] / tools.mobileEnds / 名册派生 map(x-exception 跨端键集比对循环重构·technician 作第4被比对端 · x-i18n 16 处异构 LOCALES map · x-api 修 tools-not-defined 签名坑)。canonical 基准端(x-mirror BASELINE/MIRRORS · x-exception REGISTRY_CJS 单位真相源)显式 // [canonical-baseline] 标记豁免(禁隐式兜底)。抓 3 真架构 bug(tools 签名 undefined/跨端参照误当端根/scanConfig 目录模式枚举)。防复发金丝雀 x-test/mobile-endclass-canary.test.js 5/5(扫全 spec detector 体零 load-bearing 端硬编码 + 三引擎机制 + 名册覆盖)。全量 85/86(唯他会话 x-arch §6.6),6 Class A + 6 Class B 师傅端 100%(tools20/api106/styles160/exception112/i18n174目录/structure52目录)。诚实边界:①防复发是 on-demand 金丝雀,auto-enforce 元规范 NS(每次 -v)是未来增强(load-bearing vs message-only vs canonical 的 FP-free 静态判别较复杂,故用金丝雀+显式 canonical 标记)②规则 ID 后缀 -MOBILE-(轴2 正名已于同日完成,见 ADR-21;此边界②「未启」已过时,系被 ADR-21 迁移脚本连带改写)③x-mirror 镜像语义排除令牌改造。经用户开闸实施(引擎脊柱),完成须关闸。
ADR-212026-07-15端 token 正名 -CLIENT-→-MOBILE-(原子改名·端类治理 ADR-19/20 收官)承端类治理:规则 ID 端 token -CLIENT- 是端类误名(client/technician/未来运营端同属移动端类),原子改名 -MOBILE-。机制真相(推翻记忆简化):terminals.js getTerminalRuleSuffix 早已把 x-client+x-technician 双映射 -CLIENT-(反向已是移动端类),getTerminalFromRuleId 仅正向单端——故改名 90% 改标签非改行为。否决三相 dual-accept(违禁止兼容)→ 原子一次性切换。真实爆炸面 3519 处 -CLIENT-(非记忆的 1588),四类分治:①功能面(1588 代码标记 + 934 spec 规则 ID/16 spec + 198 rule + 引擎脊椎 x-rule.js 7 正则/standard-format/formatter/terminals/meta-dev DUAN + 元规范 + L0 宪法原则8)原子改;②活文档引用同步(auth-scanner/arch/harness);③AUTO-GEN(route-helpers/registries/grantable)靠 admin rebuild 再生(源 auth-scanner 已改);④x-test 冻结夹具 + 历史 plan 不碰(不扫描/不篡改历史)。可逆迁移脚本(--to=mobile/client 无 git 兜底):Rule A(-CLIENT-→-MOBILE- 2895)+ B(枚举 |CLIENT| 37)+ C(闭环兜底 NS 无连字符名 STDCLIENT→STDMOBILE 77——子代理揪出的系统性遗漏:Rule A 只匹配 dash-flanked,漏了 STD+CLIENT 无连字符夹缝)+ EXTRA(斜杠枚举/尾随 bullet 8)。物理目录 x-client/x-technician 不动(两独立小程序,合并=部署崩);x-mobile 仅端类概念/伪端。specHash 因 Rule C/EXTRA 二次改 spec 重同步两轮。全量 86/86 绿,反向注入证旧 -CLIENT- 被引擎拒(注入 NS-CLIENT-0001 → NS-COMMON-0025 孤儿 + 0027 specHash 双咬,还原归绿)。诚实边界/遗留:①x-mobile 报表伪端未做(getTerminalFromRuleId(-MOBILE-)→x-client canonical,-MOBILE- 规则仍挂 x-client 表头=纯 cosmetic;引入 x-mobile 有目录分组空组纠缠,delib 延后)②AUTO-GEN 待用户 npx max build 再生③CLIENT_CLASS_ENDS 常量名保留(值是目录,rename 纯 cosmetic)。经用户开闸实施(引擎脊柱 + L0 宪法),完成须关闸。
ADR-222026-07-25L2 client 端补齐:四端编排闭合(orchestrator VERBS.order + roadmap END_RULES.client)病灶:orchestrator.js 三动词 order 均缺 client,plan() 显式抛错「client 流程蓝图待补」——宪法第一最高律(一切开发穿工作流)在 client 端物理不可满足,小程序开发只能绕流程直做(记忆实证:购物车五 pane/tab 原语/半屏基座等数十次 client 改动全部无编排壳)。fail-loud 设计本身正确(不静默),但缺口长期未闭。本次补齐三处:① VERBS.order 加 client(add=Data→Admin→Server→Client / modify=Data→Server→Admin→Client / delete=Client→Admin→Server→Data 逆序 prune 消费端先拆);② roadmap.js END_RULES.client 由 4 本(x-route/x-i18n/x-icon/x-fallback)补至 18 本——原清单致 IMPLEMENT 规则书指针与检测项半盲(x-api/x-structure/x-styles/x-preload/x-exception/x-file/x-auth/x-type/x-feedback/x-mirror/x-address/x-map/x-tools/x-logging 全漏),口径 =「spec 含 STD/NS-MOBILE 规则」∪「rule 自声明 -m xxx x-client 验证」双向并集,排除元规范 x-standard(治理 spec 自身非端开发规则书);③ x-dev-rule.md 新增 Client 端工作流章节(场景A新建/场景B修改 + 步骤×规则映射表 + NS-DEV-0032~0038 七条禁令 gapless 续号)。无新机制:worker 层(shell scaffold --end=client)、END_DIR、dirsOf 端类多实例展开此前均已就绪,本次为纯编排+清单补齐。双真相源同步纪律:端次序以 orchestrator VERBS.order 为准(机器可执行),x-dev-rule 载语义与禁令(人可读),两者改一必改二
ADR-232026-07-30平台写路径的"能力边界"必须实证而非文档推定;L1 全局排除禁用于含业务写入的目录活体案发:退款链 scanTimeoutRefunding(refunding 且 updatedAt<now-10min)的 10 分钟宽限窗物理塌成 0——生产实证 dispatch_base 全部 6 行 updatedAt==createdAt 而 3 行 supersededAt 非空(裸 UPDATE 确实改过业务列、系统字段纹丝不动),brand_base 237 行有 236 行 updatedAt<>createdAt(纯 ORM 写)。根因:平台 7 系统字段只在 ORM 写路径自动维护,裸 $runSQL 路径平台完全不介入,而 x-server 状态机域 63 条裸 UPDATE 无一自补。决策一:不迁 ORM(实证否决)——ORM update/updateMany 是 read-then-write 两跳非原子:25 轮并发 CAS 对照实验中 ORM 11/25(44%) 两条互斥守卫同时判"抢到",裸 $runSQL 0/25;旁证=updateMany 返回 {legalIdList,count,illegalIdList}(能报出被改行 id,单句 UPDATE…WHERE 在 MySQL 下拿不到)。63 条中 46 条依赖 affectedRows 守卫,且其涉及的 6 张表全部被 cron 0 */5 * * * * * 的 reconcile 定时器写、3 张还被会重推的微信支付回调写(无自动进程并发对手的裸写 = 0 条),迁移=按 44% 概率拆闸(重复退款/一券多单/已付款单被关)。按动词拆才看得清真相:增 ORM 94:1(98.9%)、删 ORM 40:0(100%)、改 ORM 53:63 —— 主数据域增删改早已 100% 在 ORM 上,问题只在状态机域的条件 CAS UPDATE;真实边界不是"read vs write",而是"主数据 CRUD vs 状态机跃迁"。决策二:补系统字段的写法必须实证——updatedAt = {{参数}} 实测在 order_item_node/brand_base 报 Parameter error、在 order_transaction_log 却通过(物理列类型全为 bigint 一致,差异在模型元数据层),表间行为不一致故统一禁用,canonical 形态 = ROUND(UNIX_TIMESTAMP(NOW(3))*1000)(零参数绑定、时间由数据库生成、7 表实证通过、写入 13 位毫秒与应用层偏差 76ms)。决策三(治理拓扑变更):L1 全局排除禁用于含业务写入的目录——wechatpay 原在 L1 IGNORED_DIRS,致其 7 条钱域裸 UPDATE(改 order_base/order_item_node/coupon_customer_node,微信支付回调主力路径)对全量扫描物理隐身(实测全量 1188 文件不含它),且 NS-SERVER-0139 包含面显式声明其完整路径却因索引期过滤而成为死规则。迁入 L1.5 独占 x-api-spec(与 sys/templates 同类先例),代价已量化=17 个 Express 应用文件登记进真空清单 + x-api STD/NS-SERVER-0002 与 x-structure NS-SERVER-0001/0002/0003/0004 六处结构类规范加显式排除;收益=业务不变量覆盖那 7 条 + 0139 三胞胎族复活。若不迁,本轮修复本身会制造镜像族分歧(改了 reconcile/refund-update 两方而 pay-common 无牙保护)。新增守护牙 x-api NS-SERVER-0142 三臂(臂1 UPDATE 的 SET 必含 updatedAt = / 臂2 系统时间字段禁 {{参数}} / 臂3 INSERT 列清单必含 createdAt+updatedAt),三臂各经反向注入验真 FIRE;-m 首扫 56/63 揪出 glob 死角(pay-common 写语句在 services/orderService.js 驼峰名、非 service.js,与 ADR-19 臂3 同类教训)。诚实边界:①引擎 L1.5 owner 过滤在 -m 与全量两模式表现不一致(-m x-structure x-server/tools 检测目标不含 wechatpay、全量却计入 199 目录判 1 处未通过)→ 非 owner spec 的排除必须写进 spec **排除** 字段,不可依赖 L1.5 自动过滤;②臂2 只抓 字段 = {{参数}} 紧邻形态,INSERT (…createdAt,updatedAt…) SELECT …,{{p}},{{p}} 列值分离写法不可见(该形态实测在台账表可执行,归臂3+运行时兜底,不做脆弱的列-值对位解析);③「updatedAt 被当业务时钟」这条 backlog 已于同日闭合,且结论是「不需要改」 —— 追加核实推翻了两个候选方案:全库 order_item_node 共 12 处写入(裸 SQL 12 / ORM 0),逐条核 WHERE 后确认没有任何一处会在行处于 refunding 时改它而保持该状态(命中 refunding 的 5 处全是转出 →refunded/→refundRequested;order-settle-update 改四费的 WHERE 是 IN('normal','refundRequested') 不含 refunding)。即「无关操作重置计时」在 refunding 态物理不存在,updatedAt 与状态变更同一条 UPDATE 内原子写入 = 就是「进入 refunding 的时刻」,语义本就正确。候选方案 A(加专用列 refundingAt)= 重复造轮子(order_status_log 已 append-only 记录每次迁移);候选方案 B(改查台账 MAX(createdAt))= 引入更坏失败模式:CAS 翻态与写台账分属两语句且 CloudBase 无跨表事务,中间崩溃 → 行 refunding 而台账缺失 → 子查询 NULL → 谓词恒假 → 永久漏扫(活体探针 P2-C 实证无台账行确实不命中;而 updatedAt 永不缺失)。正解 = 保留 updatedAt + 立牙锁死其前提:新增 x-order NS-SERVER-0007「refunding 态原子性锁」——UPDATE order_item_node 若 WHERE 能匹配 itemStatus='refunding'(= 或 IN 两形态),SET 必须含 itemStatus =(只许转出,禁「保持 refunding 的旁路写入」),把当前的「巧合正确」焊成物理闸。该牙正向扫描恒 0(现状已合规),有效性只能靠反向注入证明 —— 四发全部符合预期:IN 混入 refunding → FIRE、='refunding' → FIRE、命中 refunding 但确实转出 → 放行、子查询内含 WHERE itemStatus='refunding' 而顶层 WHERE 不含 → 放行(括号深度感知防误判)。方法论沉淀:凡「正向扫不出违规」的不变量守卫牙,反向注入是其唯一有效性证据,且必须同时注入「应 FIRE」与「应放行」两类,否则无法区分「牙真的在看」与「牙恒绿」
ADR-252026-08-10三位一体有方向性:「新增/修改」闭合不等于「删除」闭合——删除方向的缺口会静默产生零检测覆盖的孤儿工件活体案发:x-styles 重构第一步删 59 条规则,只改了 spec、没清业务代码里的 X-RULE 标记 → 遗留 116 处孤儿标记 / 29 文件 / 2 个 spec(x-styles 3 组 + x-file 1 组,后者与本次重构无关=独立发生的同类事故,证明这是系统性缺口而非个案)。孤儿标记的危害是双向的:既不受任何检测覆盖(规则没了、闸也没了),又误导开发者以为该段代码仍受规范保护——比没有标记更坏。为什么没人发现:既有机制无一读业务码比对 spec(x-standard NS-COMMON-0025 只做 spec 内部「汇总行↔正文章节」双向、reverse-coverage 只查 rule 文件引用的 ID),-m 与 -v 双绿。根因抽象(可泛化):凡「声明侧 ↔ 消费侧」的双向契约,治理流程若只覆盖增/改而无删,消费侧就会沉淀指向不存在声明的幽灵引用;且因为"声明没了 ⇒ 检查它的闸也没了",这类债天然不可见——它不是漏报某个 case,是那条检查本身随规则一起被删了。三处根治:①新建 x-marker 三件套——扫描面 = spec 文档、业务码为数据源(与 x-arch srcHash 同构:责任落在声明方,报错直接指向"哪个 spec 欠了债");索引经 context 全局 var 跨调用复用(实测同一 detector 应用到 29 个目标只建 1 次);排除 sys/+templates/(199 份 sys 副本占 x-server 87%,排除后提速 7.9x,且 sys 由 sys-sync 单源分发不会孤立);诚实边界三条:只认六种可靠形态(BEGINEND × STANDARDSLOT 共 4 + MULTILINE-BEGINEND 共 2;2026-08-12 ADR-29 订正原"四种"表述——MULTILINE 在判,原表述方向相反)、规则 ID 跨 spec 重号 137/271(STD-ADMIN-0001 在 12 个 spec)故宁可漏报不可误报(误报会逼人删活标记=灾难)、元规范自身走 -v 自检 ②orphan-marker-cleaner(x-meta-dev core;五条安全设计:每次运行实时校验规则确已不存在而不信任传入清单/只删标记独占整行者/BEGIN-END 必须成对/默认 dry-run/--skip 跳并行会话在途;覆盖宪法原则9 全部四种注释格式,含 TSX 的 {/* */}——JSX 子节点区用 // 会被 React 渲染成文本,故该格式必须支持) ③x-meta-rule 补场景D「删除规则」(七步流水线,「清理业务码标记」是核心步)。两个被实测否决的方案(留档防重蹈):❶「挂 x-standard NS-COMMON-0031」——-v 用的就是 x-standard 全部规则,而 Stop 每次改 rule 都跑 -v {该spec}(stop-handler.js:57-59),实测挂上后 560ms→1.5-2.8s 慢 2.6-5 倍;独立 spec 只在 -m 全量与改 spec 时触发 = 恰好孤儿产生的时机。❷「给 L4 guard 加孤立标记例外」——违反宪法 §二「part1 绝不依赖 part2」铁律(guard 的放行判决将首次依赖业务 spec 内容);且规则 ID 跨 spec 重号使判据对目标场景 100% 失效;且攻击面从 x-logging 的封闭集变成攻击者可用一次 spec 编辑扩张的开放集。真正的出口是 Bash/node 通道:Edit/Write/MultiEdit 三条通道被 markerDropBad 的 allLogging 前置条件物理封死,而 node-fs 写是 guard 自陈的已登记平台边界(win32 无 LSM 不可封闭)且内容侧由 Stop/部署 VALIDATE 读盘兜底——用它做「内容侧正确」的事,与环1 的立法意图(防删标记逃避检测)不冲突。验证闭环:清理 100 处/26 文件(16 处他会话在途按 §6.6 保留);tsc 全量 exit=0;x-mirror 双端 tag-colors 字节等值未破;x-styles/x-file 回归 0 违规;深度测试 18/18(含 7 项「不适用」路径:非 spec 文件名/多段连字符 spec 名/MULTILINE/SINGLE 诚实边界/sys//templates/ 排除/视图剥空不崩);反向注入验拦(注入假孤儿 1→2 条、还原归 1)。诚实边界:①213 种不可靠解析形态不纳入判定,孤儿数是下限 ②本闸只治 X-RULE 标记这一类"声明↔消费"契约,同类缺口(如 i18n 键、AUTH_META)各有其闸,未做统一抽象
ADR-262026-08-10L3 引入第二种规范形态:注册表驱动的矩阵框架 + 元闸族(维度从代码变数据)病根:三位一体的默认形态是「一条规则 = 一个内嵌 detector」,判据写死在代码里。当同一判据要在 N 个维度上重复表达时产生同构缺陷——维度与判据的对应被二次硬编码进 detector。实测 x-styles 同一缺陷连犯 5 次(spec 注释白纸黑字自述前三次),五次修法完全相同(放宽正则前缀)、五次都没碰病根;第 5 次至立案时仍潜伏。决策:把「维度」抽出为 sidecar 注册表(x-{domain}-axes.json),detector 经 require('fs') 直读(引擎 sandbox 白名单已放行 path/fs);闸不认识任何具体维度,只认识 schema ⇒ 加一个维度 = 追加一行声明,闸代码零改动。配套元闸族三条:①注册表自洽 ②闸实现纯净(闸体内禁出现任何维度前缀/端名字面量,使「维度真相存在于闸代码内」这个缺陷必要条件不可满足)③schema↔闸双向一致(下划线前缀=文档字段闸不读、无下划线=行为字段必须被读;双向堵隐形契约与孤儿字段两个实发事故形态)。为什么是架构性变更:①引入 spec 之外的第四类真相源,三位一体变四方一致 ②引入元闸新层级(判据对象不再是业务代码,而是闸自身与注册表)③检测能力增删从「改 detector」变为「改数据」,变更成本与风险模型都变了。本轮同批根治两处结构缺口:①某轴无关闸建成时漏登记进名册 ⇒ 长期逃出闸实现纯净闸射程,且该逃逸方向零检测(反向臂以名册为迭代源,未登记者根本不进循环)——已补登 ②两条定义面闸把定义位锚在行首,单行规则块内的声明完全不可见(实测全库 18 个定义位处于此状态),改为声明起始位置锚定(行首|左花括号后|分号后)+ 字符串字面量等长抹除防值内文本伪造;反向探针 8/8(单行块必红·多行块对照必红·一行两个必报 2 处·根外/消费位/字符串内/注释内四类必绿)。被实测否决的方案(留档防重蹈):❶「为受治根外的 token 单独建一条纳管闸」——实测在增量模式下机检收益为 0(把根外 token 改名迁入受治根后,全部相关闸仍判 0,因为族未被任何维度认领),该动作只制造返工不产生不变量;正解是随各维度回填时逐个收编,收益要等全部维度回填 + 切严格模式才兑现 ❷「按字面为闸间共享副本建对拍闸」——同语料复刻实跑 84.3% 假红(绝大多数是纯重名局部变量)且对三起真实漂移全部漏报,已立案为技术债待判据改写。诚实边界三条:①该形态目前只有 x-styles 采用,不是全局机制 ②元闸射程只覆盖名册内的闸 ③增量模式是重构期机制不是永久豁免,必须随全部维度回填完毕切严格模式,否则它就是永久放行
ADR-292026-08-12「按声明方驱动」的闸有一个结构性前提:被检对象必须能归属到某个真实存在的声明——归属不了的对象连检测目标都没有,是比漏报更深一层的盲区病根(四条,同一天同一域暴露):①归属盲区——x-marker NS-COMMON-0001 的架构是「遍历每个 *-spec.md,反查业务码里指向它的标记」(责任落声明方,与 x-arch srcHash 同构)。这个设计隐含前提:标记能被归属。而归属不了的标记有两类——形态不可解析(取不出 spec 名)、形态合法但所指 spec 文件不存在——它们永远没有检测目标,永久逃逸。活体:x-admin/src/{global.tsx,requestErrorConfig.ts} 4 行 X-RULE-BEGIN-x-api-call-STD-ADMIN-0002-X(x-api-call 是 2026-07-23 改名迁移前的历史命名法),既缺 TYPE 段又指向不存在的 spec,两条都逃;注入 x-ghostspec(形态合法 + spec 不存在)实证两条规则同时放行,总违规数 0 的双绿假象。②prose 与实现方向相反——rule 写"只认四种可靠形态,X-RULE-MULTILINE-* 一律不判",实现是六种且 MULTILINE 在判(全库 50 组);照 rule 去删 MULTILINE 标记会解除豁免致块内代码集体爆红。同源漂移 6 处(rule×2、spec 正文/detector 注释×2、本文×2),另有假声明"本规范自身不入扫描面"(实测 -m x-marker 目标列表实含 x-marker-spec.md)。③把视图当豁免机制的错误因果——x-api NS-ADMIN-0002 三处 prose 称"引擎 codeOnly 抹 MULTILINE ⇒ Detail/x-file 回调天然豁免",实测51/51 零处依赖它(豁免全部来自外层五 spec STANDARD 块的 depth>=1,换视图判定一模一样);而 codeOnly 反而制造真盲区:外层是五 spec 之外的 STANDARD(如 x-exception STD-ADMIN-0003,depth 恒 0)+ 内层 MULTILINE 时,调用既不可见也不判=双重不可见(活体 xComponents/geo/map-view)。④修复器静默假绿——orphan-marker-cleaner.js 全文 0 处 process.exit,skipped/unknownSpec 非空时只打印警告仍退 0;实测同一批 3028 文件,它报"待删 0 处 / EXIT=0",而独立探针在其中找到 4 处它看不见的畸形标记。决策:①新增 NS-COMMON-0002 双臂归属闸(臂1 形态可解析 / 臂2 所指 spec 真实存在),扫描面从 spec 文档翻转到业务代码——归属不了就找不到声明方,责任只能落代码侧,报错直接指向那一行;与 0001 按「可归属/不可归属」正交分工,无重叠无缝隙。②x-api NS-ADMIN-0002 视图 codeOnly→codeKeepMultiline,并订正三处错误因果——视图管"看不看得见调用",depth 管"红不红",两者正交、互不代偿;那 51 处的诚实表述是「enclosure 契约已满足,块内按宪法原则15 属白名单自由区」,不是"已被逐行校验"。③cleaner 未尽事项非零退出。被实测否决的方案(留档防重蹈):❶清理 sys/ 下 404 行同形态标记(202 份 sys/base/controller.js × 2 行)——三条否决理由:危害不成立(装饰标记的危害是"虚假安全感",成立条件是"有人读它、信它、改它";而 sys/ 是 x-dev-rule NS-DEV-0007 禁改 + L4 isProtectedArea 物理拦截区,三条全不成立)、代价(改模板→sys-sync 分发 201 副本→202 云函数全部重部署)、路径违规(改它必须绕过 L4 保护区,为 404 行装饰注释削安全轨)。且 sys/templates 是 L1.5 领域独占(owner=x-deploy/x-exception/x-jwt),本规范非 owner ⇒ 聚合阶段自动跳过,那 404 行天然在射程外,属「被框架正确隔离的不可修改区」而非遗漏。❷放宽 cleaner 的 MARKER_RE 让它能删畸形标记——ruleAlive() 在 spec 不存在时 return null 是保守安全轨,拆它等于降安全;正解是让 0002 从另一个方向发现,cleaner 只管删可归属的孤儿,两者分工不重叠。验证:深度测试 28/28(A/B 臂1 四形态+臂2 两形态全咬且行号精确;C 组 8 项不适用路径零误伤——散文提及/SLOT-VALIDATION 元行/纯文字谈论/六种合法形态/多段连字符 spec 名/非白名单后缀/sys/templates L1.5 跳过;E 组视图正交性四态;G 组 .wxml/.wxss/.js 三注释符);建牙即红(臂1 咬真实存量 4 处、臂2 咬注入 x-ghostspec);视图订正硬实证(同一份代码 codeOnly 判 0 处、codeKeepMultiline 判 1 处);L4 guard 环1 活体拦截(Edit 删标记被 BLOCK 并点名具体标记);cleaner 退出码 1/0 双向。诚实边界:①形态白名单在三处同源(0001 索引正则 / 0002 臂1 白名单 / cleaner MARKER_RE),改一处必须同步另两处——这是人工纪律,无机检;②臂2 只判 spec 文件存在性,不判其中规则存在性(后者是 0001 职责,两条互不越界);③判据要求标记同时携带规则 ID 段与 -X 收尾——不加此约束会误伤散文提及(实测假阳性率 20%,受 X-RULE-P4 物理保护 一处);④本闸只治 X-RULE 标记这一类「声明↔消费」契约,同类缺口(i18n 键、AUTH_META)各有其闸,未做统一抽象
ADR-282026-08-11环2.5 事后测量记账:把完备性从「拦截层」挪到「记账层」,环1 诚实降级为防手滑病根:Bash 通道写业务源【三环全盲】——①环1 写目标判据取命令串里的字面路径词,而真实路径由 shell 在 hook 看完之后才展开(变量/$()/glob/cd 改 cwd),静态分析 shell 是不可判定问题;实测 38 条改业务源命令拦 11 逃 27,其中变量装载 5/5 全逃、cd 换目录逃、ex/ed/patch/git apply/truncate/install/rsync/ln -sf/shred/unlink/touch/sponge/csplit 13 个写工具一条未拦(枚举"会写文件的程序"永不可穷尽) ②环2 只对 Write/Edit/MultiEdit 入队,Bash 事件无 file_path 结构上进不来 ③环3 claimAndDrain 队列空直接 pass(增量非全量) ④部署门 isPending 恒 false ⇒ Bash 改完代码可直接 MCP 上生产(覆盖云函数/静态托管/云存储/云托管/callCloudApi 全部)。活体证据:同日用 sed -i ... "$F"(路径装变量)改 6 处业务源,事后查队列——不在;而该 bug(引用已删 CSS 类致圆点全灰)最终由用户追问发现,非检测体系抓到。决策:不再往环1 补命令名(打地鼠 + 制造"已堵住"的错觉),改为新增环2.5 事后测量——guard/worktree-probe.js 跑 git status --porcelain -uall 与上轮快照取 mtime 差集入队。不预测命令会写什么,只测量实际写了什么 ⇒ 变量/xargs/find -exec/node fs 写/未知工具一律覆盖(连 node 洞的内容侧也一并兜住)。参数选型实证:-uall 必需(默认参数对新建只报目录名 ?? dir/,喂 --changed 直接失效;-uno 完全漏新建),实测 1.12s 反而最快(--porcelain 1.7s / node 递归 stat 11172 文件 5.0s)。双消费点:Stop(refresh:true 推进快照,下轮差集从此刻起算)+ MCP 部署门(refresh:false 不刷新,避免部署门吃掉 Stop 的差集致互相致盲)。自指防护:.claude/tmp|worktrees 排除——队列与快照文件自身未被 gitignore,不排除则「入队→队列 mtime 变→下轮测到→再入队」成环(探针 T2 实证)。守恒律:每层只做自己能做完备的事——环1 = 防手滑 + 抬高绕过成本(保留,注释同步诚实化),环2.5 = 完备记账,环3 = 复核。诚实边界:①并发会话不可区分(git 是仓库级视角,他会话在途改动会一并入队,归宪法第 6 条由 AI 判断,本模块不做也做不了归属推断)②记账完备 ≠ 检测完备(--changed 对目录级规则结构性不可达,那是引擎侧独立课题)③.gitignore 的文件测不到(实测三端业务源样本无一被 ignore)、非 git 仓库降级为空 ④环1 逃逸面本身不消失,只是危害从"永不被发现"降为"本轮末必被记账复核"。验证:worktree-probe 探针 8/8(含首轮建基线不误报存量、refresh 双语义、新建/删除均可测、自指防护)+ guard 端到端 12/12(三环行为 + X-RULE 换轴判据 + fail-closed 全回归)
ADR-272026-08-11L4 部署门增设「资损域回归床」臂:runner 原子 + sidecar 注册表 + 双消费点(D-aa/D-ac 收口)病根:资损域(退款/对账/支付回执)的行为不变量此前只有一次性验证——先是「测试跑完即删」(D-aa 原始形态),阶段 7 建常驻床后又变成「建完不跑」:实测三个既有床(reconcile 74 / preview 12 / pay-common 54 用例)全部没有自动执行点(verify-harness 只借 x-test 当沙盒目录,guard 与部署脚本零引用),代码漂移床变红无人知晓,「常驻」名存实亡。决策:执行点收敛为一个 runner 原子 + 一份 sidecar 注册表 + 两个消费点——x-test/run-deploy-gate.js(给定函数名→查 x-test/deploy-gate.json→逐床 spawnSync→全绿放行/任一红或床异常 fail-closed 拦,未登记函数零开销放行)。消费点①=x-deploy-dev VALIDATE 门3(脚本部署通道,已接线);消费点②=guard.js MCP 部署门(MCP 直发通道,L4 脊柱只读、经用户开闸后 2026-08-11 同日落地,精准触发条件=CODE_UPLOAD_ACTION ∩ functionName 命中注册表,消费点在 guard.js 主干而非 mcp-policy——后者是纯函数零副作用契约,跑床触盘会毁其可离线穷举自测的设计;活体三形态验证=登记函数跑床放行/未登记零开销放行/坏床 fail-closed 拦,且实测与 dirty 队列门顺序正确共存)。守恒律:机制归框架(runner 与消费点零业务知识,注册表缺失时 runner fail-closed、消费点按注册表存在性零行为)、数据归业务(哪个函数挂哪个床由 part2 侧维护注册表)——不违「框架操作业务但不依赖业务」铁律。同批配套:新床 x-test/refund-order-update(32 用例穷举 admin 批准链 30 出口路径:锁配对 1/1+fencing 令牌等值 / 业务终态 / 设计钉[reject-cancel 零锁·裸抛 TTL 兜底面]) + reconcile 床 T6.19-23 补齐 16 处锁出口全覆盖 + x-api NS-SERVER-0146 静态臂(acquire 后 throw 上文 3 非空行须含 release,抢锁失败 === null 豁免,锚恰-1 fail-loud;双层验拦实证:同一注入[删一处 release]被牙[行级精确 FIRE]与床[C2 转红]同时抓住)。性能实测:三床合计 <1s,部署门可承受。诚实边界:①runner 超时 120s/床,超长床需拆分 ②注册表登记靠人(新资损域函数漏登记=床不跑,无自动发现——函数↔床映射的完备性归 code review 与 MASTER 债务面)③~~guard 消费点落地前,MCP 直发通道仍无床门~~(用户开闸后同日落地,双通道齐)
ADR-242026-08-07「诚实边界」本身必须被实证:假的诚实边界比没有诚实边界更危险(它把真报警包装成已知噪音)活体案发:ADR-17 立下诚实边界「引擎索引后缀白名单 = .js/.json/.wxml/.wxss,图片等二进制物理不进索引,故排除表列 xStatic 是 no-op」,并据此把 xStatic 移出 x-mirror 排除表。该断言从未成立——check/scanners/indexer.js _scanRecursive 的文件分支是裸 fileIndex.add(entryRelative),零后缀白名单,任何文件都进索引。后果:端差异面排除物理缺位,-m x-mirror x-technician 长期挂 5 处 png 假阳;而那句假边界又让每个读者相信这 5 处是「已知噪音」,无人复查,直至本次逐字读引擎源码才证伪。根因抽象(可泛化):诚实边界是「牙看不到什么」的自述,读者据它决定不去查某一片——故它一旦为假,危害不是漏一个 case,而是把一整片真实报警合法化为噪音,比留白更坏(留白至少让人保持怀疑)。三处根治:①x-mirror-spec 排除表按 END_DIVERGENT 后缀集 glob 补 2 条({端}/xStatic/**/*.{png,jpg,jpeg,gif,webp,ico,bmp,svg} × 双根),排除面收窄到图片后缀而非整个 xStatic 目录(其下 icons/index.js 图标池锚点是受治框架文件必须镜像);排除表语义由三类升四类,specHash → dc877e87 ②verify-mobile 金丝雀比对域从后缀白名单放开为端根全文件(与引擎 indexer 行为对齐,否则金丝雀对图片面永久失明),specCovers 改委托引擎 matchFilePattern 唯一真相源(排除表含花括号后缀集 glob 后,原手写「/** 前缀 + 精确 ===」判定对通配恒 false),期望排除集补 END_DIVERGENT 现算派生 ③四处同源假话副本(spec 简介 + spec 规则正文 + rule 诚实边界 + manifest 分类注释 + verify-mobile 注释 + 两颗自测)全部订正,INDEXED_EXTS 死代码删除。反向实测(六发全中):同一目录下 technician 独有 .png 放行 / 独有 .js 报红(证按后缀收窄) · 同为 .png 在 xStatic 内放行 / 在 xCore 内报红(证按路径限定未过宽) · 删 spec 一条 glob → 金丝雀模式集 + 逐文件双闸齐咬(报 18 处失配,该失配只有在比对域放开后才可见) · manifest 加 .avif → 金丝雀 fail-loud 逼 spec 同步(证未来防复发)。-m x-mirror 10 → 5(png 假阳清零),x-mobile-dev 自测 34/34。沉淀为通用纪律:凡在 spec/rule/ADR 写「诚实边界」声称某片不可见/不适用,必须附实证(源码行号或反向注入),否则该边界本身即待验假设;定期对存量诚实边界做「边界证伪扫描」——一条假边界能让一整片牙的红色永久失效