上一篇不会还有人修完解析失败就散会吧两周后变种又复发 | 从失败提炼 Skill不会还有人三处拷贝 Rule 还手改吧漂移事故都是这么来的 | Pack 与 SSOT系列《从 Rule 到落地AI 工程化实践》第 10 篇标签SSOT · Pack · 版本管理 · 工程化专栏从小白到AI落地大师序言Skill 和 Rule 写得再好若散落各仓库、手工拷贝、随手改过三个月一定漂。童鞋们可能已经历过A 仓改了禁止项B 仓还是旧的出事时两边都说「我们有规则」。本篇解决 Pack 怎么进业务仓拷贝、子模块、链接、包版本怎么选以及 SSOT 原则。说句自嘲的我亲手制造过三份 acme-rules 拷贝每一份都有「小小的本地修正」。后来修一个安全条款要改三处漏了一处就漏出一个洞。那不是勤奋是给未来挖井。记住一句话复印越多真相越少——SSOT 的敌人不是 overlay是那份「偷偷可写的 vendor」。概念Pack是可安装的规则或技能包单元。SSOTSingle Source of Truth权威只在一处编辑。锁文件固定 Pack 版本与校验哈希便于回滚。Overlay仓库专属覆盖层不改权威包正文。可以理解为权威包是出版社的书业务仓是书架。你可以夹便签overlay不该在书页上直接涂改再复印三份——复印越多真相越少。问题在哪漂移长这样三角拷贝三份 Rule改了一处漏两处出事故时无法回答「到底哪份生效」。更糟的是每个人都觉得自己那份是对的。安装方式若只图快会把未来升级路堵死。纯拷贝最简单也最易手改。符号链接省事但 Windows 权限与开发者模式会坑人。子模块与包版本有学习成本却换来可锁版本、可回滚。没有银弹但有原则必须能说出权威在哪必须能回滚。举例常见方式对比务实选复制适合原型git submodule 或 subtree 适合多仓共享包版本适合正式分发符号链接适合本机并联开发。无论哪种请写 PACKS.md 声明 SSOT# PACKS.md 权威来源packages/acme-rules1.4.2 本仓库通过锁文件引用禁止直接修改 vendor 拷贝 例外仅可在 overlays/ 放置仓库专属覆盖锁文件示意{packs:{acme-rules:{version:1.4.2,hash:sha256:…},fix-parse-failure:{version:0.3.1,hash:sha256:…}}}仓库落位建议例如.acme/packs/只读引用根目录放说明。升级看 changelog破坏性变更写迁移笔记。Windows 符号链接注意权限与开发者模式无法链接时降级为只读拷贝加校验而不是「随便拷一份可写的」。覆盖层容纳仓库个性——命名特例、额外门禁——不要回头去改权威包正文「只此一次」。「防漂移演练」不用等人自觉一个哈希对比脚本就够四步步骤总览从锁文件取权威哈希对权威正文算 sha256逐个落位拷贝重算哈希与权威比对声明为 overlay 的文件豁免——本仓个性天然不等于权威只要有一个非 overlay 拷贝对不上拒绝启动。# ssot_guard.py —— SSOT 漂移检测铅封哈希对不上就别想蒙混启动# 纯标准库复制即跑。用法python ssot_guard.pyimporthashlibdefsha(text):returnsha256:hashlib.sha256(text.encode(utf-8)).hexdigest()[:12]# 权威源packages/acme-rules1.4.2 的 hard-constraints.md 正文AUTHORITATIVE禁止把密钥明文提交进仓库\n未经确认禁止改 adaptor/public 入口\nLOCKsha(AUTHORITATIVE)# 锁文件里登记的权威哈希# 各落位拷贝路径 - (正文, 是否声明为 overlay)COPIES[(.acme/packs/acme-rules/hard-constraints.md,AUTHORITATIVE,False),(vendor/acme-rules/hard-constraints.md,禁止把密钥明文提交进仓库\n未经确认禁止改 adaptor/public 入口 ←本地加了例外\n,False),# 偷偷可写的 vendor漂移动事故源(overlay/acme-rules.local.md,本产品线额外禁止改 billing/\n,# overlay仓库个性本就不该等于权威True),]defguard(lock,copies):print(f权威哈希锁文件登记{lock}\n)drift0forpath,content,is_overlayincopies:hsha(content)ifis_overlay:print(f [overlay 合法]{path})print(f 个性内容不参与权威校验随产品仓走不回流上游)continueifhlock:print(f [OK ]{path})print(f{h} 权威铅封完好)else:drift1print(f [漂移]{path})print(f 实算{h}! 权威{lock})print(f - 有人手改 vendor 拷贝要改规则请回权威仓提 PR 再升版本)returndriftdefmain():driftguard(LOCK,COPIES)print(f\n 结论 )ifdrift:print(f 检出{drift}处漂移 - 拒绝启动比『先用着明天再说』少一场事故)print( 回滚 把 version 改回上一版重装而不是在 vendor 里手工改字。)else:print( 全部铅封完好可以启动。)print(\n一句话复印越多真相越少SSOT 的敌人不是 overlay是偷偷可写的 vendor。)if__name____main__:main()跑起来长这样权威哈希锁文件登记sha256:e96fa0212b34 [OK ] .acme/packs/acme-rules/hard-constraints.md sha256:e96fa0212b34 权威铅封完好 [漂移] vendor/acme-rules/hard-constraints.md 实算 sha256:0538250e4e47 ! 权威 sha256:e96fa0212b34 - 有人手改 vendor 拷贝要改规则请回权威仓提 PR 再升版本 [overlay 合法] overlay/acme-rules.local.md 个性内容不参与权威校验随产品仓走不回流上游 结论 检出 1 处漂移 - 拒绝启动比『先用着明天再说』少一场事故 回滚 把 version 改回上一版重装而不是在 vendor 里手工改字。 一句话复印越多真相越少SSOT 的敌人不是 overlay是偷偷可写的 vendor。输出你看什么三个落位三种判法symlink 拷贝哈希相同 → OKvendor 拷贝被「加了个本地例外」→ 实算对不上当场爆overlay 内容完全不同却不算漂移——它声明过是仓库个性豁免校验这正是「允许 overlay、禁止偷改 vendor」那条边界跑成了代码权威哈希sha256:e96fa0212b34是 hashlib 真算出来的任何人把权威正文原样跑一遍都会得到同一串——这就是上文说的「带铅封的复印件」复印件一旦被人涂改铅封号立刻变结论只有一句人话检出 1 处漂移 - 拒绝启动。上文讲过「让它爆是特性不是麻烦」——这个脚本存在的意义就是把「明天再说」提前堵死在启动那一刻顺带回扣第 8 篇那条refactor2.0 根本没装版本对不上就拒绝和哈希对不上就拒绝是同一套「锁 校验」的心法下篇编排、第 23 篇夹具哈希都还会再见到它。自检# Pack / SSOT 自检 - [ ] 能否一句话指出每个 Pack 的权威来源 - [ ] 是否有锁版本与哈希可回滚 - [ ] 是否禁止直接修改 vendor 拷贝 - [ ] 仓库个性是否只存在 overlays - [ ] Windows 链接失败时是否有降级策略两问。第一今天改一条安全禁止项要改几个仓库里的文件大于一就有漂移债。第二回滚到上周 Pack 版本步骤写下来超过五分钟能完成吗不能锁文件可能只是摆设。SSOT 不是教条清教徒允许 overlay允许紧急热修但热修必须回流权威源并打版本。只热修不回流就是漂移的精英写法。把 PACKS.md 放进新人 onboarding。新人第一周若不知道权威在哪三个月后你就会多出一份「本地优化版规则」。Windows符号链接失败时的降级三步开发者模式没开、或公司策略禁 symlink 时别卡死在「必须链过去」。按这三步降级SSOT 仍成立探测New-Item -ItemType SymbolicLink ...失败就记一条install_mode: copy到本地pack.lock.json不要默默改权威包。只读拷贝把 Pack 版本目录整份拷到vendor/acme-rules/version/拷完立刻算校验例如Get-FileHash -Algorithm SHA256对hard-constraints.md哈希写入 lock。防漂移演练CI 或本地脚本对比 lock 与权威源不一致就失败禁止「随手改 vendor」。要改规则回权威仓提 PR再升版本重装。可以理解为链得上用链省空间、必同步链不上就用「带铅封的复印件」。复印件没有铅封三周后一定漂。Pack 的覆盖层overlay只放本仓个性路径别名、额外禁止项、团队联系人。权威包保持干净个性不回流污染上游。可以理解为出版社出书书店可以贴自己的荐购条但不能用马克笔改正文。锁版本的最小文件可以长这样示意{pack:acme-rules,version:1.4.2,install_mode:symlink,hashes:{hard-constraints.md:sha256:…}}install_mode为copy时哈希必填为symlink时CI 仍建议抽查权威源是否可解析。回滚就是把 version 改回上一版并重装而不是在 vendor 里手工改字。读到这里不妨立刻做一个五分钟动作打开你们仓库找到与本篇对应的那个目录没有就新建把文中最小示意落成真实文件名。文件在讨论才有坐标文件不在下周还会从「我们觉得」开始。第 10 篇的验收不是「读完」是「仓库里多了一份可指出的东西」。举例加长覆盖层与权威包怎么分工权威包packs/acme-rules硬约束、加载顺序、通用禁止项。本仓 overlayoverlay/acme-rules.local.md只写「本产品线额外禁止改billing/」。安装后助手两者都读但 PR 只允许改权威包的上游仓库overlay 随产品仓走。有人图省事直接改 vendor 拷贝——铅封哈希一校验就爆。让它爆是特性不是麻烦。PACKS.md 再补两行给 Windows 同事链接策略优先 SymbolicLink失败则 copyhash见安装脚本 禁止在 .acme/packs/** 内直接改规则正文锁文件的 hash 对不上就拒绝启动——比「先用着明天再说」少一场事故。SSOT 的敌人不是 overlay是偷偷可写的 vendor。思考小结三句。Pack 进仓第一原则是 SSOT避免手工漂移。安装方式可以务实选择但必须锁版本可回滚。覆盖层容纳仓库个性不改权威包。可以理解为书架可以多出版社只有一个。下篇看编排骨架意图如何进入流水线并交给 Worker——把门禁与确认做成一等节点。下篇预告《不会还有人拿单次工具调用撑多步骤业务吧没有编排就没有纪律 | 意图流水线 Worker》——单次工具调用撑不起多步骤业务。觉得有用的话欢迎点赞、留言说说你们 Pack 用的哪种安装方式有「三处拷贝漏改一处」的事故也欢迎对照 SSOT 拆。专栏从小白到AI落地大师《从 Rule 到落地AI 工程化实践》
企业数字化 ERP 产品动态
相关推荐
【珍藏整理】Passware Kit 中文版密码恢复:3步找回加密Excel密码 【珍藏整理】Passware Kit 中文版密码恢复:3步找回加密Excel密码 【免费下载链接】PasswareKit中文版资源下载 本仓库提供了一个名为“Passware Kit 中文版”的资源文件下载。该软件是一款功能强大的密码恢复工具,专门用于解密各种加密文件,包括Excel文档… · 2026/11/15 22:10:21
风光储PEM电解制氢+虚拟同步发电机VSG控制并网发电系统仿真【附参考文献】 💥💥💞💞欢迎来到本博客❤️❤️💥💥 🏆博主优势:🌞🌞🌞博客内容尽量做到思维缜密,逻辑清晰,为了方便读者。 🎁… · 2026/11/16 5:41:54
C语言格式化缓冲区池被单次printf调用耗尽的原因与改法 问题现象
C 语言里没有类,想给自定义类型做统一的字符串化,常见做法是给每个类型写一个 fmt_<type>() 函数,内部用一块共享缓冲区格式化后返回指针。为了让多个返回值能同时出现在一次 printf 里,往往会做一个缓冲区池:
#include <stdio.h>#define COUNT_OF… · 2026/11/11 13:23:26
入网电工证考试多少钱在哪考别再被中介忽悠了 入网电工证考试多少钱在哪考别再被中介忽悠了 不知道去哪报名怕被中介坑?现在网上一搜“入网电工证考试多少钱在哪考”,信息五花八门,真假难辨。作为在特种作业证领域摸爬滚打多年的从业者,我深知很多人为了拿证,被各种“包过”“包报名”“代考”忽悠,… · 2026/11/16 9:04:58
哪些部门能办电工证?良心建议帮你避开培训机构套路 哪些部门能办电工证?良心建议帮你避开培训机构套路 怕考不过白交培训费?别慌,先搞清哪些部门能办电工证,再选对机构,别让钱打水漂。现在市面上的培训机构鱼龙混杂,一不小心就踩坑。今天从 开封房建工程… · 2026/11/16 9:04:58
廊坊电工证去哪考取啊?良心建议别走弯路 廊坊电工证去哪考取啊?良心建议别走弯路 怕考不过白交培训费?廊坊电工证去哪考取啊?这个问题困扰了太多准备考证的小伙伴,尤其是像你这样在安阳房建工程干了几年的工人,想提升技能、拓宽发展路子,但又担心被培训机构套路,浪费时间和钱。今天就给你来点… · 2026/11/16 9:04:57
南宁高压电工证复审怎么搞?学历不高也能全国通用! 南宁高压电工证复审怎么搞?学历不高也能全国通用! 你是不是也担心自己学历不高,南宁高压电工证复审根本报不上?别慌,今天就给你讲清楚, 全国通用 的高压电工证复审到底怎么操作,还有那些你可能不知道的“潜规则”。… · 2026/11/16 9:04:57
禅城低压电工证考试报名怎么准备?2026河南最新政策别错过 禅城低压电工证考试报名怎么准备?2026河南最新政策别错过 怕考不过白交培训费?禅城低压电工证考试报名的小伙伴们看过来,2026年河南最新的政策已经出来了,很多细节和往年不一样,不提前准备真的容易翻车。现在报名的人越来越多,竞争也越来越大,… · 2026/11/16 9:03:57
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/16 3:21:55
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/16 3:01:18
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/16 8:30:17
电工证培训的通知在哪考?别再被中介骗了 电工证培训的通知在哪考?别再被中介骗了 你是不是还在为 电工证培训的通知在哪考 发愁?网上搜了一堆信息,结果要么是挂羊头卖狗肉的培训机构,要么就是打着“包过”旗号的骗子?别急,今天我来给你讲讲, 电工证培训的通知… · 2026/11/16 0:00:34
电工证去哪个部门考核值不值得考 信阳转岗人真实经历分享 电工证去哪个部门考核值不值得考 信阳转岗人真实经历分享 怕考不过白交培训费?你不是一个人,信阳的李师傅去年刚转岗做电工,就因为没搞清楚电工证去哪个部门考核,差点交了8000块的培训费。别急,下面这份实操考试全攻略,告诉你电工证到底值不值得考… · 2026/11/16 0:00:34
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/15 1:51:20
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/15 4:02:19
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/15 3:02:05