G11 专家载体双端同步与登记技术标准
C:/Users/xub/.workbuddy/spec/3.行政法规/范式/G11_专家载体双端同步与登记技术标准_V1.0.0_2026-09-18.md历史条款出处:本文上位依据原属已废止的宪法体系(正文条款出处锚点原样保留、未改写);二次引用前须核对
产出\旧新条款映射表.json。
版本:V1.0.0
发布:2026-09-18
效力层级:行政法规(分项技术标准) —— 依《全域任务脑手架构宪法》V1.2.0 第48条第3款归入 spec\3.行政法规\范式/。
上位依据: 《全域任务脑手架构宪法》V1.2.0(第48条双盘定位与同步方式;第39条验收四维;第41条遗留项登记)>《全域文件体系基本法》V2.3.0_2026-09-25_1605(M7 配置管理与基线规则、M8 变更管理规则、M5 交付与留存规则)。
来源与归位说明(2026-09-18 条款治理轮): 本标准由 4 个专家载体(liheng-bian-expert/lihengbian-dual-verify/liheng-bian-battery-expert/lihengbian-wealth-advisor)正文中「双端同步铁律」「多副本版本一致」「缓存与登记」三项条款归并而成。该三项宪法与基本法均未直接规定,但资源库 spec/3.行政法规/SOP/S06_skill专家迭代SOP.md(双端同步)与 spec/1.宪法/全域任务脑手架构宪法_V1.1.2(installed 登记)有对应内容;依人·炳哥 2026-09-18 第 4条命令,结合宪法与基本法重新优化后分类存入权威盘 spec 分层,载体正文不再重复承载规范本体。
1 适用范围
本标准适用于权威盘 C:\Users\xub\.workbuddy 内专家包载体(plugins\marketplaces\my-experts\plugins\<name>\)与其同对象用户级 skill 载体(skills\)之间的同步与登记,覆盖训练注入、知识更新、升版、发布全流程。
2 双端同步(同对象双体系铁律)
2.1 同一对象可能并存两套载体:
| 端 | 位置 | 依据 |
|---|---|---|
| 专家包端 | plugins\marketplaces\my-experts\plugins\<name>\ |
官方专家管理规范(行政法规层) |
| 用户级 skill 端 | skills\<版本前缀>_<名称>\ |
基本法 M7 |
2.2 强制同步:训练注入/知识更新/升版必须双端同步执行——知识文件、知识段落、示例提问、README 登记两处都要有;只注入一端=另一端用户实际调用时新知识缺失。
2.3 收尾回执:须附「双端比对」,列出两端各自新增/覆盖的文件清单并确认一致。
2.4 工作端↔线上端(同一专家包内部):工作端 <工作区>\_expert_work\<name> ↔ 线上端 plugins\marketplaces\my-experts\plugins\<name>,剥离 frontmatter version: 行后 diff 实盘比对须为空。
盘位边界(宪法第48条第1款):权威盘为唯一可写盘;来源盘/资源包不得反向写入。工作端若位于权威盘之外,其反向同步属跨盘写入,须先经人确认并登记遗留项,不得自动执行。
3 多副本版本一致(plugin.json)
专家包 plugin.json 存在四副本,version 与 description 必须同步:
| # | 副本位置 |
|---|---|
| 1 | 工作端根 plugin.json |
| 2 | 工作端发现位 .codebuddy-plugin\plugin.json |
| 3 | 线上端根 plugin.json |
| 4 | 线上端发现位 .codebuddy-plugin\plugin.json |
判据:四副本 version 与 description 字段值全等(逐字节比对 JSON 解析结果,非文本比对)。
4 缓存与登记三查(fail-closed)
| 查 | 对象 | 判据 |
|---|---|---|
| 查一 | plugins\cache\my-experts\<name>\<版本>\ |
存在且与市场侧 plugins\marketplaces\my-experts\plugins\<name>\ 内容一致(排除宿主标记 .orphaned_at/.in_use/.created-by-session,sha256 逐对相等) |
| 查二 | plugins\installed_plugins.json |
含键 <name>@my-experts,其 installPath 指向查一的版本目录,version 与 plugin.json 一致 |
| 查三 | plugins\marketplaces\my-experts\.codebuddy-plugin\marketplace.json |
已收录该 name;该清单由框架覆写、会剥离 version 字段,只判「是否收录」,不按 version 校验 |
登记失败处置:三查任一不通过即视为未上架,禁止对外表述为「已安装」。
5 载体资产归档
专家训练态资产(Training materials/知识库/素材)归档须非破坏复制 + MD5/sha256 校验,禁止移动原文件、禁止破坏既有引用链路;归档位与工具入口按当轮任务夹规程声明。
6 闸门与退出码
| 闸 | 判据 | 退出码 |
|---|---|---|
官方 validate_expert.py |
四专家全 PASS | 0 |
官方 register_expert.py |
登记成功,marketplace.json 收录 | 0 |
| 双侧 sha256 对账 | cache↔市场 差异项 = 0(排除宿主标记) | 0 |
plugin.json 四副本一致 |
version/description 全等 | 0 |
| 登记三查 | 三项全过 | 0 |
任一闸退出码非零禁止交付(宪法第28条 default-deny、第39条形式验收)。
7 遗留项登记(宪法第41条)
本轮实测登记项:权威盘 spec 内 76 文件含 292 处 spec/3.行政法规/ 失效引用、44 文件含 107 处旧宪法 V2/V3 锚点——属规范库自身残留,待专项轮次处置,本轮不动。
本标准 V1.0.0 · 2026-09-18 · 依宪法第48条第3款归入 spec\3.行政法规\范式/ · 条款来源见「来源与归位说明」
宪法 > 基本法 > 行政法规 > 地方法规 > 地方规章