kangshifu-board/docs/workshop-skill-release-20261109-r4/zip-verification

工作坊Skill r4：模型分析与自主补证

本包替代20261109-r3，不要先安装旧包。适用原R730实例agent-node-u17879018108、hermes uid10000、加载源/opt/data/skills/ksf-workshop-runtime；原资料库入口保持归档。

新工作方式

模型先拆题、构建比较框架和待证假设→结合研究库/业务成果/用户材料取证→自主检查关键缺口与反证→读取并调用目标实例现有VOC Skill取得外部资料→回核、修订、必要时再补→按原课表交报告并保存回读看板。模型知识不是已核市场事实；库内覆盖不是研究边界。正常研究在本题及已有权限/预算内自主执行，不逐项问员工是否补采。实际企业选择、正式发布、未知费用或范围扩展分别处理。

这是工作坊调度文档更新，不安装或改造VOC采集器。VOC采集的实际入口/能力须从目标实例当前Skill读取，不能拿本机版本或特定MCP名称作前提。不要把ksf-voc-library查询组件当外部采集器，也不要恢复旧SKILL入口。

两种已知版本均可直接更新

当前版本	SKILL.md SHA前缀	计划
已验收r2	31875ed7…	14项：更新12、新增2
前次交付r3	d8f3c5bd…	12项：更新11、新增1

安装器核全部已知公开文件，不只看SKILL.md。未知/混装状态立即停止，不重写清单强行通过。目标全量40个公开文件（清单39条＋清单本身），references31个（29md+2json）。7项运行组件/锁不变。

执行一次

1. 核转发文字中的外层ZIP SHA。解包到新独立目录，不能覆盖Skill目录；在包目录执行sha256sum -c FILES.sha256，须全部通过。

2. 核原实例、原hermes身份及加载路径。在包目录运行：

   python3 -B run-update.py --out /opt/data/ksf-workshop-skill-update-20261109-r4-results
   

执行器保存dry/apply/verify的stdout、stderr、exit。dry自动识别r2或r3，计划一致就apply一次并verify，无需再次确认；已经完整安装目标版则不再写入。结果目录必须不存在。隧道中断先看已有日志、exit及journal，不盲目换目录重跑。

apply备份原文件至/opt/data/ksf-workshop-research-backup-*，核绑定、原研究文件及运行组件保留。verify检查40个目标公开文件及本轮实际变更数。权限、清单、未知版本、链接路径或任何检查失败应停止回传，不能手动改文件让它通过。发生中断/失败先核journal；恢复只处理本安装器仍拥有的已知内容，不覆盖后续未知修改。

加载与检查

使用现有skill_view/刷新机制实际读取新SKILL.md、references/workshop-research-loop.md和workshop-course-flow.md，留存工具读取证据，确认原加载源的新内容。磁盘哈希不代替Agent实际加载，无需重启服务。

只读查询沿原ssh-channel配置运行：

python3 -B probe-agent-library-read.py --skill-root /opt/data/skills/ksf-voc-library --instructions-root /opt/data/skills/ksf-workshop-runtime --accept-current --expected-installed-state expected-agent-read.json --out /opt/data/ksf-workshop-skill-update-20261109-r4-read-probe

原私有通道配置仅引用；如环境变量未引用，可增加--channel <既有私有配置路径>，不要复制/打印配置。本探针核当前contract代际下CLI、通道及看板的一致性，不要求仍是历史代际。历史固定记录不再可见应保留具体失败阶段，不直接当安装损坏。

另外只读定位目标实例现有VOC Skill，报告实际名称/版本/入口、是否能读到相关能力说明和既有预算配置状态（不得回传敏感内容）。本次更新不为了探测能力发收费/采集请求，不续跑已停止案例、不新建测试成果。本地构造情景已检查新调度的使用方式；远端真实VOC调用能力和新流程的业务效果仍在后续获准真实任务中验证，不能把静态定位报成采集成功。

回传控制

正文简短分列文件安装、实际加载、只读查询/同代际、现有VOC定位状态，给目标指纹、识别的基线、变更数及备份目录。真实外部补采/业务写入/正式发布标本轮未执行。不改长期授权、凭据、身份/会话、运行脚本/锁、数据库、服务，不收费。

原始日志和回执合成一个脱敏ZIP即可，不拆发多份。可含dry/apply/verify输出和exit、install-receipt.json、加载/只读探针/VOC能力定位证据，不含绑定、信封、密钥、连接配置、环境变量或整个备份。

必要恢复：仅完整APPLIED且无后续编辑时，可用node update-skill.mjs --rollback --backup /opt/data/ksf-workshop-research-backup-实际目录；先核原日志/备份，不因网络抖动自动回滚。恢复到此次实际基线r2或r3，旧资料库入口仍归档。