专家载体存活守护 技术标准
C:/Users/xub/.workbuddy/skills/V1.1.0_lihengbian_DIY_专家载体存活守护/SKILL.md)重新组织,
不新增任何规范要求;每一层、每个节点均可回溯到源章节。原归档件(09-18 版)见文末对照。
前言
本文件为「专家载体存活守护」在现役版本 V1.1.0 下的技术标准载体,按《全域任务脑手架构宪法》第 17–23 条规定的六层主干组织, 效力层级为行政法规(skill 载体)。
本文件的上位法为《全域任务脑手架构宪法》与《全域文件体系基本法》;凡本文件出现的义务性表述,其唯一效力来源均为所标注的宪法条号与源章节,本文件不写宪法未规定者。
本文件替代 2026-09-18 归档版(V1.0.6),差异根源是载体已由 V1.0.6 迭代至 V1.1.0。
1 范围
本文件规定了「专家载体存活守护」(V1.1.0)的术语和定义、工作流架构、技术要求、校验方法与交付要件。
诊断并根治 WorkBuddy「专家/插件从专家入口消失」类故障。当用户反映专家不见了、插件消失、专家列表为空、self-built expert missing、或需要巡检本地目录型市场的专家载体完整性时使用。覆盖入口不可见的三类真根因(市场清单缺条目 / 账号白名单认领遮蔽 / 实体与版本缺失)判定顺序、三端一致性巡检、幂等自动恢复、可见性推演(按框架 scanCustomExperts 算法,免登录 UI 先验判断)、修复后自动触发框架重扫(免重启生效)、SessionStart 钩子接入、**预防机制三层防线(结构层 shared 态常驻 / 闸门层认领态自动清除 / 认知层先推演后定位)**,并含故障注入验证法。**明确排除 .in_use(其为缓存 GC 保留标记,非可见性闸门)与远端市场 experts:get 报错(预期噪声)。**【V1.1.0 并入 my-experts-publish V1.1.0】本 sk
本文件适用于该载体的加载、执行、返工、验收与升级迭代全过程。
2 规范性引用文件
- 《全域任务脑手架构宪法》—— 管任务链路(上位法)
- 《全域文件体系基本法》—— 管文件(上位法)
- 《全域工作流行政法规》—— 管工作流(同级上位)
- GB/T 1.1-2020 标准化工作导则 第 1 部分:标准化文件的结构和起草规则
3 术语和定义
下列术语和定义适用于本文件。六层主干的定义由宪法第 17 条规定,本文件直接引用。
3.1 脑(K3)
负责定标、裁决、诊断与留痕,不施工。
3.2 手(DeepSeek)
按脑下发的标准施工、返工与落盘,不定标。
3.3 本地机械闸
零 Token 校验实体,退出码非零禁止交付,不自备标准。
3.4 人
负责确认、放行与宣布;闭环宣布权留人。
3.5 六层主干
宪法第 17 条规定的架构主干,由 A 入口层至 F 终结层六级构成。
3.6 一进一出
每个任务一次进入、一次交付,不并发多形态产出。
4 工作流架构
本章按宪法第 18–23 条逐层给出本载体的承载节点。共 12 个节点,层序与条号严格对齐;每层节点均标注源章节,可逐条回查。
- 九、入口不可见:三类真根因与判定顺序(V1.0.5 校正)(源 §九、入口不可见:三类真根因与判定顺序)
- 防线 3 — 认知层:先推演、后定位(杜绝再次误修)(源 §防线 3 — 认知层:先推演、后定位)
- 验收判据(可复现)(源 §验收判据(可复现))
- 十二、预防机制:三层防线(V1.0.6 新增 · 回答「如何确保不再发生」)**核心命题**:事后修复不构成保障。保障来自**结构上让故障不可能发生**,(源 §十二、预防机制:三层防线(V1.0.)
- 防线 1 — 结构层:令专家常驻 `shared` 态(唯一根治手段)(源 §防线 1 — 结构层:令专家常驻 `)
- 防线 2 — 闸门层:认领态自动清除(常态守护)(源 §防线 2 — 闸门层:认领态自动清除)
- 14.3 启动三闸(上架后与修复后均必跑,缺一不可)(源 §14.3 启动三闸(上架后与修复后均)
- 十五、2026-09-19 第五例实证(四专家整批不可见 · 并核出防线2 离线)(源 §十五、2026-09-19 第五例实)
- 步骤 1 — 排除实体丢失(源 §步骤 1 — 排除实体丢失)
- 步骤 2 — 排除编码损坏(高杀伤力)(源 §步骤 2 — 排除编码损坏(高杀伤力)
- 步骤 3 — 对比标记态(**仅用于缓存保留面;不用于可见性判定**,见 §一勘误)(源 §步骤 3 — 对比标记态(**仅用于)
- 步骤 4 — 确认"为何未被启用"(源 §步骤 4 — 确认"为何未被启用")
- 本载体在本层无独立声明,随上下层执行。
- 本载体在本层无独立声明,随上下层执行。
5 技术要求
本章汇集载体的定标性要求(脑层节点),全部来自源章节,未作增补。
本载体未在源章节中声明独立的定标性要求,技术要求随脑层节点执行。
6 校验方法
本章给出载体自带的机械校验点(安全与权限层)。退出码非零即禁止交付。
防线 2 — 闸门层:认领态自动清除(常态守护)
- 巡检三真根因(清单条目 / 认领遮蔽 / 实体版本);
- 新增 whitelist_claimed 判定 —— 「被任一账号认领」即报故障,
- 默认模式把认领移出全部账号白名单,回归 shared;
- 同内容刷新 marketplace.json mtime,触发框架 watcher 重扫,免重启生效。
十五、2026-09-19 第五例实证(四专家整批不可见 · 并核出防线2 离线)
- 用户级 ~/.workbuddy/settings.json 顶层键仅
- 项目级 …\★利衡辨_脑手分离★\.workbuddy\settings.json、settings.local.json、~/.workbuddy/hooks.json
- matcher 取 startup|resume(照宿主官方样例 codebuddy-plugins-official 内 SessionStart 写法);
- 解释器必须写绝对路径:本机 PATH 无裸 python(bash 侧 ls/head 亦不可用),
- 接入前须先手动跑通同一条命令(本轮实测 --check EXIT=0 才写入),否则等于把哑钩子挂上链条;
7 交付要件
本章规定交付物形态、命名与落盘要求,逐条对应源章节。
本载体的交付形态随调用方约定,不设固定要件。
附录 A(规范性)六层主干与宪法条号对照
| 层 | 层名 | 宪法条号 | 承担角色 | 本载体节点数 |
|---|---|---|---|---|
| A | 入口层 | 第18条 | 人(确认放行) | 2 |
| B | 编排层_脑_K3 | 第19条 | 脑(K3) | 1 |
| C | 安全与权限层 | 第20条 | 本地机械闸 | 5 |
| D | 执行层_手 | 第21条 | 手(DeepSeek) | 4 |
| E | 交付与验收层 | 第22条 | 人 · 闸 · 混合 | 0 |
| F | 终结层 | 第23条 | 混合(跨角色) | 0 |
| 合计 | 12 | |||
附录 B(资料性)载体源清单
| 项目 | 内容 |
|---|---|
| 现役载体目录 | C:/Users/xub/.workbuddy/skills/V1.1.0_lihengbian_DIY_专家载体存活守护 |
| 现役版本 | V1.1.0 |
| 源说明文件 | C:/Users/xub/.workbuddy/skills/V1.1.0_lihengbian_DIY_专家载体存活守护/SKILL.md |
| 载体文件总数 | 3 |
| 标准数库归档批 | 2026-09-18 批(技能族 35 份 / 专家族 4 份,全域同批同日) |
| 归档案与现役的关系 | 归档件按现役版本之前的载体编制;本件为按现役载体重生版,二者不互相替代 |
| 原名对照 | 利衡辨_专家载体存活守护_技术标准_V1.0.6_2026-09-18_2320.docx |
附录 C(资料性)未纳入六层的源章节
下列章节不对应宪法第 18–23 条的任何一层,原文保留于载体,此处仅登记不归类。
- 一、先建机制模型(V1.0.5 勘误:`.in_use` 与可见性**无关**)
- 二、诊断四步(顺序不可跳)
- 三、巡检 + 自愈(工具化)
- 四、故障注入验证(强制,不可省)
- 五、血泪教训(写死,勿重犯)
- 六、配套动作
- 七、2026-09-11 实证记录(本轮根因链)
- 八、V1.0.3 实证记录(2026-09-11 第二例:三专家同时不可见)
- 十一、V1.0.5 实证与勘误(2026-09-11 第四例:三专家重启后仍不见)
- 十、V1.0.4 实证(2026-09-11 第三例:换账号致三专家整批不可见)
- 十三、新建专家后必须补的三处登记(V1.0.7 新增 · 2026-09-14 实证)
- 十四、专家上架 / 重建 / 图标统一(V1.1.0 并入 · 原 skill `my-experts-publish V1.1.0`)
- 14.1 上架(四步,不可跳步)
- 14.2 重建(载体丢失时,非原样恢复)
- 14.4 换头像 / 统一图标(2026-09-17 实测 · 四专家统一为鲸鱼)
- 14.5 并入的已知坑
- 15.1 图标不显示的真因:`avatar` 字段错指(2026-09-19 实证,新增)
宪法 > 基本法 > 行政法规 > 地方法规 > 地方规章