2 Commits

Author	SHA1	Message	Date
JianFeeeee	1b6cd57dca	fix(skillmgr): 内核旧版 skill 永不更新 —— 无 stamp 不等于"用户改过" ... ## 缺陷（实测，非推测） 给 kernel-plugins 补上 `skill_info(name, section=...)` 的用法说明后， 改了嵌入内容，但**生产上永远不会更新**： /home/hologramagent/skills/kernel-plugins/ mtime 2026-10-26，无 .builtin-sha256 嵌入版本 1.1.0 vs 磁盘版本 1.0.0 `materializeBuiltinSkills` 的判断链是： builtinSkillUnmodified(dir) → 读 .builtin-sha256 没有 stamp ⇒ false ⇒ continue（"用户改过或无法确认，保留人的版本"） 而 stamp 机制是 387ae94（今天早些时候）引入的。生产机上这份 skill 是**更早的内核**写的 —— 它没有 stamp，于是被永久判为"来历不明"。 后果不只是这一份文档：任何在 stamp 机制之前部署的机器，其内核自带 skill 都停在旧版。而 kernel-* 系列正是教模型怎么用工具/记忆/终端的 文档 —— 内核改进了文档，模型永远看不到。 ## 修法：用 frontmatter version 区分两种"没有 stamp" 原判据把两件事混成一件： 用户改过措辞 ⇒ 必须保留 内核在 stamp 之前写的 ⇒ 应该升级 新增 builtinSkillOutdated(dir, embedded)：只在**没有 stamp** 时被调用， 判据是磁盘 frontmatter 的 `version` 严格低于内嵌版本。 安全性分析（写在代码注释里）： 人改措辞 通常不动 version ⇒ 不低于 ⇒ 保留 ✓ 人把 version 改高 ⇒ 保留 ✓ 内核旧版（无 stamp） ⇒ 升级 ✓（这正是要修的） 解析不出版本号 ⇒ 返回 false ⇒ 保留（保守） 误升级的唯一条件是"人把 version 改低"，而那本身就意味着放弃内核版本。 原有的四条保守判据（含 NoStampIsConservative）全部保持绿。 ## 判据抓到了我自己写的 bug TestCompareVersion 立刻红了： compareVersion("1.0","1.0.0")=-1，期望 0 原因：缺失段留成空串 ⇒ Atoi("") 失败 ⇒ 落到字符串比较 ⇒ `"" < "0"` ⇒ 版本号少写一段的 skill 会被无谓地重复升级。改为缺失段视为 "0"。 ## 变异验证 builtinSkillOutdated 恒 return false（= 修复前行为） ⇒ TestMaterializeBuiltinSkills_UpgradesStaleKernelVersion 红： "★ 没有 stamp 的内核旧版（version 0.0.1）没被升级" compareVersion 缺失段改回空串 ⇒ TestCompareVersion 红："compareVersion(\"1.0\",\"1.0.0\")=-1，期望 0" ## 顺带：kernel-plugins v1.1.0 补一节「Reading a skill without burning context」，说明： - 长文档返回目录 + 开头 30 行，目录每行带 (N 行) - `section` 可按编号或标题子串取，大小写不敏感，容忍 `##` 前缀 - 顶层章节返回整棵子树 - 未命中会列出全部可用章节 - 章节边界尊重围栏代码块 ## 验证 go build ./... PASS go vet ./... PASS gofmt -l 干净 go test ./... -count=1 62 包全过，0 FAIL 干净检出（worktree） build + skillmgr 全绿 （包数 63 → 62 是因 clawhubadapter 已在 a0077a2 迁出为外部插件，与本改动无关）	2026-11-04 15:50:39 +08:00
JianFeeeee	387ae945df	fix(agent): 子 agent 继承技能索引 —— 修 agent 把终端当命令执行器用 ... ## 缺陷（生产实测） `SetSkillIndexProvider` 只在 cmd/homed/bootstrap.go 里对**根 agent** 调了一次。 rtchild / 驻留子各自 `New(AgentConfig{...})` 构造载体，都没传这个字段 ⇒ 子的 system prompt 里**完全没有 skill 索引**。 症状（日志实录）：A2A 会话由「临时分诊助手」（驻留子）接手，它手上没有 `cmd_run`（cmd 插件 `auto_start=false`），而 `cmd-tools` skill 正文里写着 「先 plugin_start cmd」。它看不到这条 skill，于是把 `terminal_create` 当成 命令执行器：每条 `cd … && echo … && grep …` 开一个新终端，终端随命令结束退出， `terminal_read` 立刻撞 `read /dev/ptmx: input/output error`，然后为下一条命令 再开一个 —— 终端列表被填满，每一条都死在半路。 与本仓 Security 那次同型：父有的能力，子没继承。 ## 修法 rtchild 与驻留子的 AgentConfig 各补一行 `SkillIndexProvider: a.skillIndex`， 与 `SystemPrompt` / `StageHost` / `Security` 同一组「必须继承父」的字段。 ## 顺带两件事 ### 1. 内置 skill 的更新永远到不了已部署机器 原落盘规则是「目标目录已存在就跳过」，本意是保住用户改动。但它把两件事混成一件： 用户改过的版本 ⇒ 应该保留 内核自己写过的旧版 ⇒ 应该随内核更新 两者都表现为「目录已存在」，于是 b850fea 把 `memory_recall` 改成 `stablemem_recall` 后，生产机的 kernel-memory 一直停在旧名，模型照着 旧名调工具必然失败，而日志里一个字都没有。 改为用 `.builtin-sha256` 摘要区分： 当前内容 == stamp ⇒ 没人动过 ⇒ 可安全覆盖成新版 当前内容 != stamp ⇒ 用户改过 ⇒ 保留 没有 stamp（老目录）⇒ 保守视为用户版本，不覆盖 ### 2. 新增 kernel-terminal skill 工具描述只说「适用于交互式程序」，没说何时**不该**用；`command` 参数又鼓励 传整条命令。补一条内置 skill 讲清 cmd_run 与 terminal_create 的边界、 以及终端的 input/key/notify 用法。描述控制在 80 字符内（进索引不截断）。 ## 判据（均经变异验证） TestRTChild_InheritsSkillIndex 删掉接线 ⇒ 红（实测确认） TestResident_InheritsSkillIndex 同上（生产实际中招的那一类） TestRootAgent_SkillIndexStillInjected 确认没改坏根 agent 路径 TestChildWithoutSkillIndexIsNotBroken 父无索引时子不 panic TestMaterializeBuiltinSkills_* 5 条：覆盖语义四条成组断言 （改回旧行为 ⇒ OverwritesUnmodified 红，实测确认） 判据测的是**生成的 prompt**，不是 `skillIndex != nil`： 后者接上了但注入那段被删照样绿。 ## 验证 go build ./... PASS go vet ./... PASS gofmt -l 干净 go test ./... -count=1 62 包全过，0 FAIL 干净检出（git worktree）单独验证 PASS	2026-11-04 10:17:45 +08:00