| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
chore(agent/core): 清理 interrupt.go 迁移残留的孤儿注释 中断队列函数迁回 scheduler.go 后，interrupt.go 里留下了 8 处只有注释头、 没有函数体的孤儿（highestInterruptLocked / popInterruptLocked / interruptCountLocked / enqueueInterruptLocked / installImmediateLocked / registerInterrupt / requestPreempt / requestKernelPreempt / rearmPending）。 它们不影响编译，但会让人误以为这些函数还在中断管理器里—— 正是本次重构要消灭的'同一件事记两处'。 同时修正 interruptState 上方的过时说明（原写'访问写法仍是 s.interruptQueues'， 而队列已归还调度器）。 判据 TestInvariant_InterruptManagerHoldsOnlyStackState 仍绿（反射白名单未变）。 | 51 分钟前 | |
refactor: 全面改名为 HologramAgent + 提示词技术内容下沉到 skill/工具描述 + 修 21 处乱码 ## ① 全面改名 HomeAgent → HologramAgent 仓库已改名，但代码与文档里仍有大量旧名。本次按"用户能看到的优先"全量替换： - 用户可见：登录页标题/页脚、默认人格第一句、CLI 状态输出、启动日志、 plugin_install 的工具描述、AI 图片插件的 User-Agent - 文档与脚本：README、assets/docs、docs/zh、deploy/*.sh、.github/workflows - 鸿蒙工程：cmd/ohos/HomeAgent → cmd/ohos/HologramAgent（git mv） 目录内的 module/app 描述同步；**证书路径原样保留** （default_HomeAgent_xxx.cer/p7b/p12 是签名材料的实际文件名，改了会找不到证书） - 插件元数据：plugin.json 的 author ★ 必须保持原样的两处（改了会坏）： · legacySeededPromptSignature = "你是 HomeAgent 的看板娘「小宅」…" —— 那是识别历史播种人格卡的**原文锚点**，改了就识别不出旧数据 · 公开 SDK 的 ProxyAuthHomeAgent = "homeagent" —— 那是 SDK 契约里的值，属独立仓库，本仓不改 ## ② 修 21 处乱码（U+FFFD） 这些是历史编辑留下的编码破坏，全在注释里，例如： 「赌注重下���遍」→「赌注重下一遍」 「「不��滤」」 →「「不过滤」」 「**待��退场**」→「**待退场**」 ★ 保留 providers/chineseclip/tokenizer.go 里的 2 处：那是**故意**用 U+FFFD 演示"非法 UTF-8 字节被归一成 U+FFFD"，不是乱码。 ## ③ 提示词技术内容下沉（用户：技术性内容应该收敛到 skill 与 -help 中） 实测系统提示词 2309 字，其中两段几乎全是**模型无法据以行动的实现细节**： 【工具执行顺序】1272 字（ParallelSafe 声明、批内降级、batchRunnable 判据…） 【三层记忆】 1069 字（L1/L2/L3 编号、消费式删除、向量空间、指纹…） 收敛后 **2309 → 1723 字（-25%）**，保留的全是"模型据此做什么不同的事"： 工具顺序：默认并行 / 不要依赖先后 / 同通道保序 / 写类工具可能串行 三层记忆：时序里能看最近 / doc_query 把历史事件按原始时间戳插回时序 / 关系用 memory_recall / 成文知识用 knowledge_search 判断口径写进判据：新加一段提示词前先问"模型会据此做什么不同的事"， 答不上来就该进 skill 或工具描述。 ## 判据 prompt_memory_test.go 新增 2 条： - TestSystemPromptHasNoImplementationJargon 黑名单：ParallelSafe / batchRunnable / 消费式 / DenseCosine / fingerprint / 向量空间 / 批内降级 / 自激 - TestSystemPromptStaysCompact：上限 2000 字（当前 1723） 变异：把 "ParallelSafe 声明、批内降级" 加回工具顺序段 ⇒ 第一条立刻红。 ## 验证 - go build ./... / go vet ./... 干净 - go test ./... -count=1：58 包 0 失败 - make check-client-versions：客户端与内核版本一致 | 2 天前 | |
refactor(module): 核心仓 Go module 路径改为 github.com/JianFeeeee/HologramAgent 批 1，不含 SDK 仓与目录改名。 - go.mod 第 1 行 module 路径 - 366 个 .go 文件的完整前缀 github.com/JianFeeeee/HomeAgent 机械替换 （857 处，仅完整前缀；展示名/注释里的 HomeAgent 字样留给批 5） - 未改：third_party 目录名、SDK 自身 go.mod module、go.mod replace 目标、 homed/waiter 可执行名、.hmap 后缀 | 4 天前 | |
feat(memory): 图数据库自报真实读写事件，取代「按工具名猜节点」 ## 问题（生产实证） 星图的「跟随 agent 活动」此前靠**工具名词元猜节点**：把 memory_recall 拆成 [memory, recall] 去匹配实体名。而图谱里的实体名是**中文概念** （小宅/对话/待命），工具名是英文 —— 两套命名空间永不交集。 实测（生产库）每个工具名命中 **0** 个节点： hint=memory_recall → memory/recall → 0 hint=files_read → files/read → 0 hint=knowledge_search → knowledge/search → 0 匹配失败后走「补齐」分支，按 mention_count 取前 8 个 ⇒ **无论 agent 在干什么， 点亮的都是同一批无关节点**（小宅/对话/待命/投递/图片/文档/插件/老大）。 这就是「星图没有读写反馈」的真身。 ## 改法：让图数据库在真正读写处上报 新增 events.EventMemoryAccess + GraphDB.AccessHook，在读写入口埋点上报 **真实块 ID**（不再猜）： | 操作 | 埋点 | 上报 | |---|---|---| | 读 | RecallSorted | blocks | | 写 | commit | blocks + **created**（真正新建的） | | 删 | DeleteEntity | removed | | 合 | MergeBlocks | merged(from→to) + removed | 三处关键设计： 1. **钩子用独立锁** hookMu。用 g.mu 会**自死锁** —— 埋点方法已持该锁， 而 Go 的 RWMutex 不可重入。 2. **上报在锁外**。拆 commit→commitLocked 两层解决 defer Unlock 的时序： 钩子内部可能要回调内存系统（如 SSE 订阅者补数据），持锁调用必死锁。 3. **区分「新建」与「更新」**（putBlockTx 返回 isNew）。用 SELECT 判存在性 而非 RETURNING (xmax = 0) —— 后者在**事务 + ON CONFLICT** 下报 no such column: xmax（实测：autocommit 可用、包进 tx 就不可用）， 而本函数只在事务里被调用。重复提交同一事实不会重复播「生长」动画。 接线：bootstrap.newMainAgent 里 memDB.SetAccessHook(...) → events.Bus。 只在 evBus != nil 时接，把「内核进程」与「独立 CLI 工具」 （homed-graph-migrate / memgc 也用 NewGraphDB）区分开 —— 后者不该为一次 批量迁移向不存在的订阅者发几万条事件。 ## 验证 - access_hook_test.go：钉住 commit/recall/delete 三类埋点真的触发、 且重复提交不误报新建 - access_hook_race_test.go：4 写 + 4 读 + 钩子热替换并发，-race 下无竞态、 无死锁；**断言事件数 > 0**（否则「钩子从未触发」也会假通过） - 该测试起初是 flaky 的（读者可能在写者落库前查询 ⇒ 空结果不报事件 ⇒ 断言随机失败）。修法是先播种确定数据再并发读，已连跑 3 次稳定 - 生产实例端到端：CLI 注入一句话 → SSE 收到 6 条 memory_access， 带真实块 ID 与 op/created | 17 天前 | |
refactor(module): 核心仓 Go module 路径改为 github.com/JianFeeeee/HologramAgent 批 1，不含 SDK 仓与目录改名。 - go.mod 第 1 行 module 路径 - 366 个 .go 文件的完整前缀 github.com/JianFeeeee/HomeAgent 机械替换 （857 处，仅完整前缀；展示名/注释里的 HomeAgent 字样留给批 5） - 未改：third_party 目录名、SDK 自身 go.mod module、go.mod replace 目标、 homed/waiter 可执行名、.hmap 后缀 | 4 天前 | |
refactor(kernelboot,kernelmod): ID:13 删死包 kernelboot/modules，整机启动图判据迁到 kernelmod/all ## 决策 删除 internal/kernelboot/modules（registry.go + registry_test.go）， 把整机启动图判据迁到 internal/kernelmod/all（真实聚合入口）。 文件头那条 TODO(死包清理) 随包一起消失。 ## 为什么这个包该删 实测零生产调用： · 生产代码里 import 它的包数 = 0 · Register() / BuildModules() / Names() 的外部调用点 = 0 · 它的 Register/BuildModules 是 internal/kernelmod 那套注册表的**第二份实现** （留着只会让人下次接错口子） · kernelmod/all/facilities_sync_test.go 的注释里早已写明 「kernelmod 才是真实注册表（模块编译期工厂加载）」 ## 判据迁移（能力未削弱，逐条实测） - 判据 1–4（整机装配/层拓扑/严格逆序关闭/无残留）: 只换宿主， 用 kernelmod.Registered() 作为装配输入不变，实测 5 层 / 17 模块 / 关闭顺序 [4 3 2 1 0] / 3 轮 goroutine 差值 0 / 订阅者 2→2 - 判据 5（TestEveryRegisteredModuleIsCompiledIn）: 真相源是扫 .. 源码树的 「目录+类型名 复合键 + 四方法齐全」，与宿主包无关。scanModuleTypes 的 modRoot 从 "../../kernelmod" 改为 ".."（本文件现在在 kernelmod/all/ 下） - 删掉 _ ".../kernelmod/all" 自引用（判据现在与聚合入口同包， 本包被编译即聚合 import 生效 —— 反而更贴近生产同一条 import 链） ## 「新模块登记了但漏 import」仍咬得住（3 个变异亲测） A 从 all.go 删 multimodal 聚合 import（叶子模块，无人依赖） → TestEveryRegisteredModuleIsCompiledIn 红（指名 multimodal） → TestEveryModuleDirIsImported 红 B 删 multimodal 的 init()（Register 调用点消失，真相源不能是被测入口） → TestEveryRegisteredModuleIsCompiledIn 仍红（源码侧多数一个类型） C supervisor 的 Name() 改成非字面量 → 判据显式失败（不静默跳过 ⇒ 不会变空转） ## 悬空引用清零 全仓 grep kernelboot/modules：代码/文档/CI 只剩 ci.yml 里一条 「那个包零生产调用，已删除」的历史说明。同步修正： · ci.yml「整机启动图判据」步骤 → go test ./internal/kernelmod/all/ · ci.yml -race 排除表 pkg 行目标包 → internal/kernelmod/all （该包现在装整机 ⇒ 同样会撞 KERNEL-REGISTRY-SETLOCK； 实测不带 -race 6/6 绿，排除仍必要，单号不变） · ci.yml 三条说明文本（含证据步骤的提示语） · kernelboot/kernelstate.go 指向旧判据路径的注释 · docs/zh/kernel-modularization-design.md §2.7 的 declarations.go 路径 · check-ci-gates.py §4 断言目标包 → ./internal/kernelmod/all/ （否则它盯的是一个已不存在的包） ## 验证 go build ./... = 0 error，go vet ./... = 0 error go test ./internal/kernelboot/... ./internal/kernelmod/... = ok go test -race ./internal/kernelmod/all/ = ok（连跑 6 次无 DATA RACE） check-ci-gates.py EXIT=0；ID:15 的 verify_v4 矩阵复跑仍 5 变异全抓 + 误报项 EXIT=0 + 基线 EXIT=0 | 1 天前 | |
Merge commit 'bf44654' into ci/boot-graph-tests | 6 小时前 | |
refactor: 全面改名为 HologramAgent + 提示词技术内容下沉到 skill/工具描述 + 修 21 处乱码 ## ① 全面改名 HomeAgent → HologramAgent 仓库已改名，但代码与文档里仍有大量旧名。本次按"用户能看到的优先"全量替换： - 用户可见：登录页标题/页脚、默认人格第一句、CLI 状态输出、启动日志、 plugin_install 的工具描述、AI 图片插件的 User-Agent - 文档与脚本：README、assets/docs、docs/zh、deploy/*.sh、.github/workflows - 鸿蒙工程：cmd/ohos/HomeAgent → cmd/ohos/HologramAgent（git mv） 目录内的 module/app 描述同步；**证书路径原样保留** （default_HomeAgent_xxx.cer/p7b/p12 是签名材料的实际文件名，改了会找不到证书） - 插件元数据：plugin.json 的 author ★ 必须保持原样的两处（改了会坏）： · legacySeededPromptSignature = "你是 HomeAgent 的看板娘「小宅」…" —— 那是识别历史播种人格卡的**原文锚点**，改了就识别不出旧数据 · 公开 SDK 的 ProxyAuthHomeAgent = "homeagent" —— 那是 SDK 契约里的值，属独立仓库，本仓不改 ## ② 修 21 处乱码（U+FFFD） 这些是历史编辑留下的编码破坏，全在注释里，例如： 「赌注重下���遍」→「赌注重下一遍」 「「不��滤」」 →「「不过滤」」 「**待��退场**」→「**待退场**」 ★ 保留 providers/chineseclip/tokenizer.go 里的 2 处：那是**故意**用 U+FFFD 演示"非法 UTF-8 字节被归一成 U+FFFD"，不是乱码。 ## ③ 提示词技术内容下沉（用户：技术性内容应该收敛到 skill 与 -help 中） 实测系统提示词 2309 字，其中两段几乎全是**模型无法据以行动的实现细节**： 【工具执行顺序】1272 字（ParallelSafe 声明、批内降级、batchRunnable 判据…） 【三层记忆】 1069 字（L1/L2/L3 编号、消费式删除、向量空间、指纹…） 收敛后 **2309 → 1723 字（-25%）**，保留的全是"模型据此做什么不同的事"： 工具顺序：默认并行 / 不要依赖先后 / 同通道保序 / 写类工具可能串行 三层记忆：时序里能看最近 / doc_query 把历史事件按原始时间戳插回时序 / 关系用 memory_recall / 成文知识用 knowledge_search 判断口径写进判据：新加一段提示词前先问"模型会据此做什么不同的事"， 答不上来就该进 skill 或工具描述。 ## 判据 prompt_memory_test.go 新增 2 条： - TestSystemPromptHasNoImplementationJargon 黑名单：ParallelSafe / batchRunnable / 消费式 / DenseCosine / fingerprint / 向量空间 / 批内降级 / 自激 - TestSystemPromptStaysCompact：上限 2000 字（当前 1723） 变异：把 "ParallelSafe 声明、批内降级" 加回工具顺序段 ⇒ 第一条立刻红。 ## 验证 - go build ./... / go vet ./... 干净 - go test ./... -count=1：58 包 0 失败 - make check-client-versions：客户端与内核版本一致 | 2 天前 | |
refactor(module): 核心仓 Go module 路径改为 github.com/JianFeeeee/HologramAgent 批 1，不含 SDK 仓与目录改名。 - go.mod 第 1 行 module 路径 - 366 个 .go 文件的完整前缀 github.com/JianFeeeee/HomeAgent 机械替换 （857 处，仅完整前缀；展示名/注释里的 HomeAgent 字样留给批 5） - 未改：third_party 目录名、SDK 自身 go.mod module、go.mod replace 目标、 homed/waiter 可执行名、.hmap 后缀 | 4 天前 | |
refactor: SDK module 路径统一改为 hologramagentsdk（59 文件 + go.mod） ## 为什么必须做 SDK 仓（独立仓库）已把 module 从 github.com/JianFeeeee/homeagentsdk 改名为 hologramagentsdk。主仓通过 replace 直接引用它的**物理目录**： replace github.com/JianFeeeee/homeagentsdk => ./third_party/homeagent-sdk 一旦 SDK 侧改成新 module 名，主仓立刻炸： go: ./third_party/homeagent-sdk@ used for two different module paths (github.com/JianFeeeee/hologramagentsdk and github.com/JianFeeeee/homeagentsdk) Go **不允许**同一目录被两个 module 路径 replace。所以不能"新旧并存"， 只能把主仓 59 个文件的 import 全部改到新名，并删掉旧 replace。 ## 一个被证伪的前提 我最初按"third_party/homeagent-sdk 是独立仓库，不能在此仓修改其源码" 来处理，并因此判断两个仓的改动可以隔离。实际上主仓是靠 replace 指向 该目录的物理副本 —— **两个仓的改动不可能真正隔离**：SDK 侧改 module 名， 主仓必然跟着改 import。 这个前提应该在做任何改动之前用 go list -m 验证，而不是假设。 ## 连带修掉两处 | 缺陷 | 性质 | |---|---| | TestLuaSDKMockSingleSource 失败 | SDK 的 sdk/lua/sdk.lua 变了，主仓内嵌副本未同步（跑 scripts/sync-lua-sdk.sh 修复） | | sdkModuleNames 分散两处 | 已在 SDK 仓合并为单一数据源（见 SDK 仓 725732b） | 第一条是**副本一致性判据抓到的**，不是我自己发现的 —— 这类判据的价值在此： 两个仓必然有副本，靠人记住"改了 A 要同步 B"是做不到的。 ## 验证 - go build ./... / go vet ./... 干净 - go test ./... -count=1：**58 包 0 失败** - internal/plugin（Lua SDK 副本一致性）+ internal/sdk 全绿 - 主仓 third_party/homeagent-sdk/ 与 SDK 仓 main 无差异 | 1 天前 | |
refactor: 全面改名为 HologramAgent + 提示词技术内容下沉到 skill/工具描述 + 修 21 处乱码 ## ① 全面改名 HomeAgent → HologramAgent 仓库已改名，但代码与文档里仍有大量旧名。本次按"用户能看到的优先"全量替换： - 用户可见：登录页标题/页脚、默认人格第一句、CLI 状态输出、启动日志、 plugin_install 的工具描述、AI 图片插件的 User-Agent - 文档与脚本：README、assets/docs、docs/zh、deploy/*.sh、.github/workflows - 鸿蒙工程：cmd/ohos/HomeAgent → cmd/ohos/HologramAgent（git mv） 目录内的 module/app 描述同步；**证书路径原样保留** （default_HomeAgent_xxx.cer/p7b/p12 是签名材料的实际文件名，改了会找不到证书） - 插件元数据：plugin.json 的 author ★ 必须保持原样的两处（改了会坏）： · legacySeededPromptSignature = "你是 HomeAgent 的看板娘「小宅」…" —— 那是识别历史播种人格卡的**原文锚点**，改了就识别不出旧数据 · 公开 SDK 的 ProxyAuthHomeAgent = "homeagent" —— 那是 SDK 契约里的值，属独立仓库，本仓不改 ## ② 修 21 处乱码（U+FFFD） 这些是历史编辑留下的编码破坏，全在注释里，例如： 「赌注重下���遍」→「赌注重下一遍」 「「不��滤」」 →「「不过滤」」 「**待��退场**」→「**待退场**」 ★ 保留 providers/chineseclip/tokenizer.go 里的 2 处：那是**故意**用 U+FFFD 演示"非法 UTF-8 字节被归一成 U+FFFD"，不是乱码。 ## ③ 提示词技术内容下沉（用户：技术性内容应该收敛到 skill 与 -help 中） 实测系统提示词 2309 字，其中两段几乎全是**模型无法据以行动的实现细节**： 【工具执行顺序】1272 字（ParallelSafe 声明、批内降级、batchRunnable 判据…） 【三层记忆】 1069 字（L1/L2/L3 编号、消费式删除、向量空间、指纹…） 收敛后 **2309 → 1723 字（-25%）**，保留的全是"模型据此做什么不同的事"： 工具顺序：默认并行 / 不要依赖先后 / 同通道保序 / 写类工具可能串行 三层记忆：时序里能看最近 / doc_query 把历史事件按原始时间戳插回时序 / 关系用 memory_recall / 成文知识用 knowledge_search 判断口径写进判据：新加一段提示词前先问"模型会据此做什么不同的事"， 答不上来就该进 skill 或工具描述。 ## 判据 prompt_memory_test.go 新增 2 条： - TestSystemPromptHasNoImplementationJargon 黑名单：ParallelSafe / batchRunnable / 消费式 / DenseCosine / fingerprint / 向量空间 / 批内降级 / 自激 - TestSystemPromptStaysCompact：上限 2000 字（当前 1723） 变异：把 "ParallelSafe 声明、批内降级" 加回工具顺序段 ⇒ 第一条立刻红。 ## 验证 - go build ./... / go vet ./... 干净 - go test ./... -count=1：58 包 0 失败 - make check-client-versions：客户端与内核版本一致 | 2 天前 | |
refactor: 全面改名为 HologramAgent + 提示词技术内容下沉到 skill/工具描述 + 修 21 处乱码 ## ① 全面改名 HomeAgent → HologramAgent 仓库已改名，但代码与文档里仍有大量旧名。本次按"用户能看到的优先"全量替换： - 用户可见：登录页标题/页脚、默认人格第一句、CLI 状态输出、启动日志、 plugin_install 的工具描述、AI 图片插件的 User-Agent - 文档与脚本：README、assets/docs、docs/zh、deploy/*.sh、.github/workflows - 鸿蒙工程：cmd/ohos/HomeAgent → cmd/ohos/HologramAgent（git mv） 目录内的 module/app 描述同步；**证书路径原样保留** （default_HomeAgent_xxx.cer/p7b/p12 是签名材料的实际文件名，改了会找不到证书） - 插件元数据：plugin.json 的 author ★ 必须保持原样的两处（改了会坏）： · legacySeededPromptSignature = "你是 HomeAgent 的看板娘「小宅」…" —— 那是识别历史播种人格卡的**原文锚点**，改了就识别不出旧数据 · 公开 SDK 的 ProxyAuthHomeAgent = "homeagent" —— 那是 SDK 契约里的值，属独立仓库，本仓不改 ## ② 修 21 处乱码（U+FFFD） 这些是历史编辑留下的编码破坏，全在注释里，例如： 「赌注重下���遍」→「赌注重下一遍」 「「不��滤」」 →「「不过滤」」 「**待��退场**」→「**待退场**」 ★ 保留 providers/chineseclip/tokenizer.go 里的 2 处：那是**故意**用 U+FFFD 演示"非法 UTF-8 字节被归一成 U+FFFD"，不是乱码。 ## ③ 提示词技术内容下沉（用户：技术性内容应该收敛到 skill 与 -help 中） 实测系统提示词 2309 字，其中两段几乎全是**模型无法据以行动的实现细节**： 【工具执行顺序】1272 字（ParallelSafe 声明、批内降级、batchRunnable 判据…） 【三层记忆】 1069 字（L1/L2/L3 编号、消费式删除、向量空间、指纹…） 收敛后 **2309 → 1723 字（-25%）**，保留的全是"模型据此做什么不同的事"： 工具顺序：默认并行 / 不要依赖先后 / 同通道保序 / 写类工具可能串行 三层记忆：时序里能看最近 / doc_query 把历史事件按原始时间戳插回时序 / 关系用 memory_recall / 成文知识用 knowledge_search 判断口径写进判据：新加一段提示词前先问"模型会据此做什么不同的事"， 答不上来就该进 skill 或工具描述。 ## 判据 prompt_memory_test.go 新增 2 条： - TestSystemPromptHasNoImplementationJargon 黑名单：ParallelSafe / batchRunnable / 消费式 / DenseCosine / fingerprint / 向量空间 / 批内降级 / 自激 - TestSystemPromptStaysCompact：上限 2000 字（当前 1723） 变异：把 "ParallelSafe 声明、批内降级" 加回工具顺序段 ⇒ 第一条立刻红。 ## 验证 - go build ./... / go vet ./... 干净 - go test ./... -count=1：58 包 0 失败 - make check-client-versions：客户端与内核版本一致 | 2 天前 | |
refactor(module): 核心仓 Go module 路径改为 github.com/JianFeeeee/HologramAgent 批 1，不含 SDK 仓与目录改名。 - go.mod 第 1 行 module 路径 - 366 个 .go 文件的完整前缀 github.com/JianFeeeee/HomeAgent 机械替换 （857 处，仅完整前缀；展示名/注释里的 HomeAgent 字样留给批 5） - 未改：third_party 目录名、SDK 自身 go.mod module、go.mod replace 目标、 homed/waiter 可执行名、.hmap 后缀 | 4 天前 | |
refactor(module): 核心仓 Go module 路径改为 github.com/JianFeeeee/HologramAgent 批 1，不含 SDK 仓与目录改名。 - go.mod 第 1 行 module 路径 - 366 个 .go 文件的完整前缀 github.com/JianFeeeee/HomeAgent 机械替换 （857 处，仅完整前缀；展示名/注释里的 HomeAgent 字样留给批 5） - 未改：third_party 目录名、SDK 自身 go.mod module、go.mod replace 目标、 homed/waiter 可执行名、.hmap 后缀 | 4 天前 | |
merge(ci): 合入 ci/boot-graph-tests —— Registry 加锁 + race 门扩到全仓 + 排除表收尾 合入 ci/boot-graph-tests 的 8 笔（ed61a8d..2b32934）： - 19c78ca fix(plugin): Registry 的 Set* 全部取写锁，读侧改一致性快照 - 3864f36 refactor: 删死包 kernelboot/modules，整机启动图判据迁到 kernelmod/all - e70c2b5 feat(kernelboot): Run 增加执行期依赖校验，顺序被改坏时报可读错而非 SIGSEGV - 653c87f fix(ci): 排除表守卫改为注入合成行真跑，杜绝形似而无效的假绿 - 599252f / 8cfb3e0 / c20e7c6 / c963d84 / 2b32934: race job 排除表收尾、撤两条 KERNEL-REGISTRY-SETLOCK / WEBUI-GZIP-RACE 排除项、空表改显式 # none 标记、 并修掉收尾过程中引入的 && false 死条件 - caf1b71 / ed61a8d / 6d04bd2 / bf44654: 注释清理、stress 用例改「等状态」、 webui 排除项撤除、摘掉两份已作废的收尾补丁 合并预演实测（三方合并，无冲突）： - go build ./... → EXIT=0 - go test -race internal/plugin → ok 1.618s - go test -race internal/kernelmod/all → ok 1.665s - go test -race internal/plugins/webui → ok 60.108s - python3 .github/scripts/check-ci-gates.py → EXIT=0 - registry.go 写锁 43 处在位 | 3 小时前 | |
fix(agentcli): 关闭终端后反复注入过期状态 ## 现象 关闭终端后 agent 持续收到「[终端 term_6 读取结束: read /dev/ptmx: input/output error]」「[终端 term_6 中的进程已退出]」，而 terminal_list 显示 0 个会话——它拿不到任何证据说明这些是历史遗留，只能反复解释 "这是旧回声，不用管"，每条都唤醒一轮推理。 ## 根因（不是一次回声，是每 30 秒一次） close 工具 → session.Close() → readLoop 从 <-t.stopCh 静默 return → 但 **sessions 条目没删** → cleanupLoop 每 30s 扫到它，发现 !terminalRunning → 又注入一条「进程已退出」 三条退出路径（主动关闭 / 进程自己结束 / 超时）里，主动关闭那条漏了删表。 ## 修法 1. readLoop 的 t.stopCh 分支补 removeSession，三条路径统一走它。 2. 新增 isClosing：所有"终端结束"通知都必须区分两种成因—— 进程自己结束（是新闻，要告诉 agent）vs 我们主动关掉（是回声，不能注入）。 旧实现只看 r.err / terminalRunning，而主动关闭恰好让两者都成立。 ## 测试基础设施修正 mockTerm.Kill() 原先是空操作，于是"主动关闭"在测试里从不产生 EIO， 判据永远绿（假绿）。改为模拟真实 PTY：Kill 后 Read 立刻返 read /dev/ptmx: input/output error。 判据：关闭后 session 必须立刻从表里消失、关闭后不得新增注入 （连开 20 次防 select 随机性）、进程自己结束仍必须通知（不过度修复）。 变异：关闭时不删表 / isClosing 恒 false，均被抓。 Co-Authored-By: Claude <noreply@anthropic.com> | 4 小时前 | |
refactor(module): 核心仓 Go module 路径改为 github.com/JianFeeeee/HologramAgent 批 1，不含 SDK 仓与目录改名。 - go.mod 第 1 行 module 路径 - 366 个 .go 文件的完整前缀 github.com/JianFeeeee/HomeAgent 机械替换 （857 处，仅完整前缀；展示名/注释里的 HomeAgent 字样留给批 5） - 未改：third_party 目录名、SDK 自身 go.mod module、go.mod replace 目标、 homed/waiter 可执行名、.hmap 后缀 | 4 天前 | |
fix: LLM 工具循环 400、中断消息注入、ConPTY 终端支持 - agent: 工具轮请求尾部补 user 占位(zen 网关强制),tool 消息正确配对 - agent: 工具提醒/中断以 system 角色注入并带 [中断消息] 前缀,不进用户履历;系统提示词说明中断消息格式 - agentcli: 基于 ConPTY 的交互式终端(ptywin fork),terminal_create/read/write/resize/close/watch - webui: server 输出通道适配器(保留 reasoning_content/disable_thinking) - GUI: 沉浸式标题栏、icon 圆角重制、mascot 等打磨 | 2 个月前 | |
feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10) * feat(kernel): 模块化内核 + 编译期依赖图定序 把单体 init 序列拆成「模块自声明依赖 + 编译期生成依赖图 + 运行期只读图」。 ## 为什么 原 cmd/homed/main.go 里 17 步 init 是**手写顺序**，依赖关系只存在于 注释和人脑里。实测踩到的坑（见 docs/zh/kernel-modularization-design.md）： · nlp.defaultParser 被 initONNXParser 写、被 distiller 读，两者相距 60 行， 只靠 ticker 10min 才没炸（隐式依赖，无声明） · 加一个模块要人肉找"该插在哪"，插错的表现是运行期 nil 解引用 · 关停是 defer ks.CloseAll()，而热更新路径 os.Exit(42) **跳过 defer** ⇒ docStore/distiller/textMem 的 flush 全部丢失（每次热更新都发生） ## 怎么改 - internal/kernelboot/：KernelState（一个结构体收全部包级共享变量，字段 nil 安全）、Module 接口、graphfile（依赖图编解码 + 与二进制 hash 对账）、 scheduler（按 BFS 层并行 Init）、syncbus（层边界写通知）、 lifecycle（Quiesce/Resume 可逆伪关机，区别于一次性 CloseAll） - internal/kernelmod/<name>/：每个模块一个文件夹，Requires/Provides 自声明； all/all.go 是唯一的 import 清单（Go 循环导入约束） - cmd/homed-depgraph：编译期生成依赖图，Makefile 注入 digest - 运行期只**读**图，不计算顺序（顺序是编译期决定的，源码里没有中央清单） ## 判据 kernelboot 8 条 + 图失败模式 7 条（全部拒绝并给准确错误）+ 模块目录数 与注册表一致性。变异测试 15/15 咬住，含： · 删掉 AddCloser 的锁 → -race 报数据竞争 · Scheduler 同批跑去重 → 203 vs 200 · 图 hash 不匹配 → 拒绝启动 ## 顺带修的缺陷 热更新路径漏调模块关闭 ⇒ 显式 stopKernelModules()，并用 AST 判据钉住 "必须在 os.Exit 之前"（字符串检查在本仓已骗过我三次）。 实测：冷启动 1630ms（5 层/17 模块，原 17 步串行）；生产 22 插件全部建链。 * feat(security): 密钥防火墙 + 配置加密 + close 纪律 ## 密钥防火墙 模型只见别名、不见明文；插件工具调用入口（StageHost.ExecuteTool）做入向 回填。三维能力： · 出向：工具输出里的密钥被替换成 [[secret:name]] 别名后才进上下文 · 入向：模型传别名，入口处填回真值（插件完全无感知） · 存储：config.db 里不存明文（0644 的库可读），敏感值独立 0600 文件 模式库「宁漏勿误伤」：宁可漏掉一次替换，也不把正常文本误当密钥。 ## 配置加密 - internal/security/{codec,key,keyring,store,global}.go：AES-256-GCM， enc:v1: 前缀，密钥轮换（OldKeys 解码 + 新钥加密） - harden.go：数据目录权限收紧 - embedded.go：支持内嵌主密钥（可选，仍保留外部 key 文件路径） - EncryptExistingSecrets / AuditSecrets：启动时幂等迁移 + 审计 ## close 纪律（用户明确要求：只要调 close 就要有前置检查） internal/safeclose：Safe / SafeFunc。全仓 37 处裸 close(chan) → 0。 关键教训（都写进注释和判据）： · select { case <-ch: default: close(ch) } **不是**并发安全的 （两个 goroutine 可同时命中 default）—— healthcheck 原先是这种写法 · sync.Once **不可重入**：X.Do(func(){ Safe(&X, ...) }) 会自锁， 症状是 go test 直接挂住（3 个包 600s 超时），栈里只有嵌套的 Once.Do · map 里按请求持有的 channel（mcp/stdio.go、clawhubadapter/sidecar.go） 改成 *pendingRPC 包装，每通道一个 once ## 判据 security 全量 + TestNoBareCloseOutsideSafeclose（AST 级扫描，含注释剥离） + TestNoNestedSelfOnceDeadlock（正则修正：\w+ 不匹配点号，捕获组要含 '.'）。 变异 2/2 咬住。全量 52 包 ok。 * feat(plugin+deploy): 插件三态生命周期、数据目录迁移、发行包修复 ## 插件三态生命周期（用户要求：自动启动 / 启用但不自动启动 / 禁用） - Manifest 新增 requires_facilities / auto_start（*bool，用于区分 "未声明"与"显式 false"） - plugin-host 模块（internal/kernelmod/pluginhost）：用 kernelboot.Scheduler 按依赖时机拉起，**不再手写两阶段** - 运行态停启 StopPlugin/StartPlugin **可逆**：不写 disabled_plugins （不改用户决定）、不置 shuttingDown（之后还能加载）、会摘掉注册面 - 与 StopAll 的区别写进注释 —— StopAll 置 shuttingDown 后**永久无法加载**， 那是进程退出用的，误用于"暂停"就是关了就死 ## 数据目录迁移（伪关机 → 迁移 → 唤醒） - kernelboot/lifecycle.go：Quiesce/Resume（可逆，区别于一次性 CloseAll）， 逆序暂停、逆序恢复、Pause 失败回滚 - kernelboot/migrate.go：BeginMigration/End 编排（先停插件 → 再停内核写者 → 等在途归零） - distiller/textmem 增 Pause/Resume 门（不是 cancel —— cancel 不可逆， 恢复要重建整个对象） - 模块 migration：体检 + 生成可执行迁移脚本 ★ 迁移脚本的三个实测教训（都写成了判据）： 1. 无条件改 /etc/systemd/system ⇒ 演练把**生产** -data 改成了演练目录。 加 --dry-run（零改动）+ 强制校验 systemd 当前 -data == OLD 2. 本机没装 rsync，脚本在"服务已停、数据未搬"处硬失败 ⇒ cp -a 回退， 并明确警告不保硬链接/ACL（生产 plugindev 有大量 git 硬链接） ## 发行包修复（全部经实测确认） 1. package-linux.sh **完全漏打 depgraph.bin** ⇒ 内核 exit 1 （"生产构建（内嵌 hash 非空）但读不到依赖图"） 2. build_homed 不走 Makefile ⇒ 单独修 Makefile 无效，必须同时生成图+注入 3. build.sh 的 LDFLAGS 用**历史模块路径 gitcode.com** ⇒ -X 静默 no-op ⇒ --version 显示 unknown 4. Makefile -ldflags 用**单引号** ⇒ 注入了字面 $GRAPH_HASH ## ★ build.sh 的版本号必须校验（真实事故） 原 VERSION="$(git describe --tags --dirty)"。无 tag 分支上它返回**分支名** backup/pre-identity-rewrite-20261005-51-g03d87a4e-dirty，被注入 meta.Version ⇒ 插件握手判据 MajorVersion() 把整串当主版本 ⇒ **22 个子进程插件全部 握手失败**（"主版本不匹配"）。内核活着、systemd active、日志每条都像 插件的问题 —— 实际是发行包带着非法版本号。 修法：git describe 只在形如 vX.Y.Z 时采用，否则回退 meta.Version（权威源）， 并对最终值做形态守卫。deploy/packaging/version_guard_test.go 3 条判据， 变异 2/2 咬住。 ## deb 的 systemd unit 改为 guard 模式 ExecStart=/usr/bin/homed --role=guard --data /var/lib/homeagent （worker exit 42 → guard 重拉，不经过 systemd、不计失败） 含 RestartSteps/RestartMaxDelaySec/TimeoutStopSec + 硬化 （NoNewPrivileges/ProtectSystem/ProtectHome/DevicePolicy/ReadWritePaths）。 ## 其他 - internal/plugin/proc：非法 JSON 帧的报错**可定位**（内容摘要 + 可能原因 + 修法）。生产实测 1038 条非法帧（插件往 stdout 打日志 = 污染协议通道） - 示例插件 4 个 14 处 fmt.Printf → log.Printf - hmapdev 模板同步修复；scaffold 判据剥离注释（模板注释里就含 fmt.Printf） * chore: 收尾（主密钥轮换命令、IPC/知识库加固、SDK 对齐） - cmd/homed-key-rotate：把 security 里的 RotateKey/RotateKeyFile/RekeySecrets 串成一条**可执行**的运维路径。没有它，E-1 就只是库里的能力而不是 "出事时能做的事"，而轮换的价值恰恰在于能执行。 - cmd/homed：kmod_runtime（模块装配入口）、plugins_scheduled（failback 白名单）、memcandidate、bootstrap_order_test / shutdown_flush_test - internal/ipc、internal/devicebridge、internal/knowledge：配套加固 - third_party/homeagent-sdk/sdk：PluginMgrAPI 增三态能力（mgrStop/mgrStart/ mgrIsRuntimeStopped）+ settings 对齐 判据：bootstrap_order_test（启动顺序不依赖手写序列）、 shutdown_flush_test（停机的两条路径必须对称 —— exit 42 会跳过 defer， 热更新路径下模块关闭/flush 曾全部丢失）。 * test(security): 测试夹具改用不可误认的占位值（修 push protection 拦截） GitHub secret scanning 拦住了推送：三处测试夹具用了"看起来像真密钥"的 字面量： internal/security/prefilter_test.go:39 internal/security/store_test.go:177 internal/security/survey_test.go:20 它们全是**假密钥**（AKIAIOSFODNN7EXAMPLE 是 AWS 官方文档的标准示例， 其余是 abcdefghij... 这类可读占位符），但扫描器无法区分 —— 它只看形态。 ★ 不绕过（不用 unblock URL、不加 allowlist）：直接改夹具。 原因：一旦允许"假密钥可以通过"，真密钥混进来时就没有最后一道门了。 改法：保留**模式库匹配所需的结构**，把可识别内容换成 FAKE： glpat-abcdefghijklmnopqrst → glpat-FAKE-TEST-TOKEN-NOT-REAL sk-abcdefghij...012345 → sk-FAKE-TEST-KEY-NOT-REAL-0000000 AKIAIOSFODNN7EXAMPLE → AKIA0000FAKE0000TEST (保持 20 字符) ASIAIOSFODNN7EXAMPLE → ASIA0000FAKE0000TEST xoxb-123456789012-abcdefghijklmnop → xoxb-FAKE-TEST-TOKEN-NOT-REAL ★ 中途踩到一次：AWS 键的模式是 \b(AKIA|ASIA)[0-9A-Z]{16}\b（共 20 字符）， 我第一次替换成 19 字符的 AKIAFAKETESTKEY0000 ⇒ 模式匹配不上 ⇒ TestSurvey_WhatIsCaught / TestRecognizesCommonShapes / TestPrefilterNeverBlocksRealMatches 三条当场变红。 判据正确地拒绝了"为了过扫描器而削弱覆盖"。 顺带核实：全仓 grep 无任何真实密钥泄漏。 * fix(packaging): package-linux.sh 的版本解析与 build.sh 统一 上一版只修了 build.sh，漏了 package-linux.sh —— 它仍只看 git describe： VERSION="${VERSION:-$(git describe --tags --dirty)}" 无 tag 分支上 git describe 返回**分支名** （backup/pre-identity-rewrite-20261005-56-g98850e1），守卫会正确拒绝， 但要求人**手动传 VERSION** 才能打包。而 build.sh 早已能自动回退 meta.Version ⇒ 同一个版本，走 build.sh 打得出来、走 package-linux.sh 打不出来。 危害不只是"要手动传参"：运维为了跑通会去掉守卫，而分支名一旦进 meta.Version 就是**插件协议主版本**的来源 ⇒ 22 个子进程插件全部握手失败 （这是真实发生过的事故，见 3efa4e5）。 修法：两个脚本用同一套规则（git describe 仅在 vX.Y.Z 形态时采用， 否则回退 meta.Version），并对最终值做形态守卫。 判据：TestBothPackagingScriptsShareVersionRules —— 逐个读两个脚本， 要求都能从 meta/meta.go 取权威版本、都校验 git describe 形态。 变异（把 package-linux.sh 改回旧规则）咬住并准确指出是哪个脚本。 实测：不传 VERSION 跑 package-linux.sh，输出 [PKG] warn: git describe 给出非版本串（...），改用 meta.Version=1.4.0 Version: 1.4.0 * fix(test): 跨仓判据在 CI 上应 skip 而非 fail（修 PR 双红） CI 上 "Go build / vet / test" 与 "Build linux/amd64" 双红： --- FAIL: TestHmapdevTemplateImplementsAllPluginMgrMethods bridge_sync_test.go:170: 读模板: open ../../../third_party/homeagent-sdk/tools/hmapdev/templates/proc_main.go.tmpl: no such file or directory ## 根因：判据依赖了一个**被 gitignore 的路径** .gitignore:33 有 third_party/homeagent-sdk/tools/（SDK 仓自治，本仓不跟踪）。 于是： · 本机（完整 SDK 检出）有该文件 ⇒ 判据通过 · CI（只 checkout 本仓）没有该文件 ⇒ Fatalf ⇒ **必红** 我提交时只在本机跑测试、没看 CI，所以这个问题拖到 PR 才暴露。 ## 修法 文件缺失时 t.Skipf 而不是 t.Fatalf。 ★ 这不是"放弃检查"： · 跨仓一致性由 **SDK 仓自己的判据**守着 （tools/hmapdev/scaffold_stdout_test.go 等），那里才是模板的真实归属地 · 本判据在本机开发时**仍然生效**（已验证：有文件时 PASS，缺文件时 SKIP） ## 验证 · 本机（有文件） → PASS（判据真跑） · 模拟 CI（移走 tools/）→ SKIP（不再 fail） · 全量 53 包 ok / 0 fail ## 顺带 同目录还有 e2e_template_test.go 也读 tools/，但它是 //go:build 门控的 e2e 判据，CI 默认不跑，无需处理。 --------- Co-authored-by: JianFeeeee <JianFeeeee@users.noreply.gitcode.com> | 7 天前 | |
refactor(module): 核心仓 Go module 路径改为 github.com/JianFeeeee/HologramAgent 批 1，不含 SDK 仓与目录改名。 - go.mod 第 1 行 module 路径 - 366 个 .go 文件的完整前缀 github.com/JianFeeeee/HomeAgent 机械替换 （857 处，仅完整前缀；展示名/注释里的 HomeAgent 字样留给批 5） - 未改：third_party 目录名、SDK 自身 go.mod module、go.mod replace 目标、 homed/waiter 可执行名、.hmap 后缀 | 4 天前 | |
refactor: SDK module 路径统一改为 hologramagentsdk（59 文件 + go.mod） ## 为什么必须做 SDK 仓（独立仓库）已把 module 从 github.com/JianFeeeee/homeagentsdk 改名为 hologramagentsdk。主仓通过 replace 直接引用它的**物理目录**： replace github.com/JianFeeeee/homeagentsdk => ./third_party/homeagent-sdk 一旦 SDK 侧改成新 module 名，主仓立刻炸： go: ./third_party/homeagent-sdk@ used for two different module paths (github.com/JianFeeeee/hologramagentsdk and github.com/JianFeeeee/homeagentsdk) Go **不允许**同一目录被两个 module 路径 replace。所以不能"新旧并存"， 只能把主仓 59 个文件的 import 全部改到新名，并删掉旧 replace。 ## 一个被证伪的前提 我最初按"third_party/homeagent-sdk 是独立仓库，不能在此仓修改其源码" 来处理，并因此判断两个仓的改动可以隔离。实际上主仓是靠 replace 指向 该目录的物理副本 —— **两个仓的改动不可能真正隔离**：SDK 侧改 module 名， 主仓必然跟着改 import。 这个前提应该在做任何改动之前用 go list -m 验证，而不是假设。 ## 连带修掉两处 | 缺陷 | 性质 | |---|---| | TestLuaSDKMockSingleSource 失败 | SDK 的 sdk/lua/sdk.lua 变了，主仓内嵌副本未同步（跑 scripts/sync-lua-sdk.sh 修复） | | sdkModuleNames 分散两处 | 已在 SDK 仓合并为单一数据源（见 SDK 仓 725732b） | 第一条是**副本一致性判据抓到的**，不是我自己发现的 —— 这类判据的价值在此： 两个仓必然有副本，靠人记住"改了 A 要同步 B"是做不到的。 ## 验证 - go build ./... / go vet ./... 干净 - go test ./... -count=1：**58 包 0 失败** - internal/plugin（Lua SDK 副本一致性）+ internal/sdk 全绿 - 主仓 third_party/homeagent-sdk/ 与 SDK 仓 main 无差异 | 1 天前 | |
refactor(module): 核心仓 Go module 路径改为 github.com/JianFeeeee/HologramAgent 批 1，不含 SDK 仓与目录改名。 - go.mod 第 1 行 module 路径 - 366 个 .go 文件的完整前缀 github.com/JianFeeeee/HomeAgent 机械替换 （857 处，仅完整前缀；展示名/注释里的 HomeAgent 字样留给批 5） - 未改：third_party 目录名、SDK 自身 go.mod module、go.mod replace 目标、 homed/waiter 可执行名、.hmap 后缀 | 4 天前 | |
refactor: 全面改名为 HologramAgent + 提示词技术内容下沉到 skill/工具描述 + 修 21 处乱码 ## ① 全面改名 HomeAgent → HologramAgent 仓库已改名，但代码与文档里仍有大量旧名。本次按"用户能看到的优先"全量替换： - 用户可见：登录页标题/页脚、默认人格第一句、CLI 状态输出、启动日志、 plugin_install 的工具描述、AI 图片插件的 User-Agent - 文档与脚本：README、assets/docs、docs/zh、deploy/*.sh、.github/workflows - 鸿蒙工程：cmd/ohos/HomeAgent → cmd/ohos/HologramAgent（git mv） 目录内的 module/app 描述同步；**证书路径原样保留** （default_HomeAgent_xxx.cer/p7b/p12 是签名材料的实际文件名，改了会找不到证书） - 插件元数据：plugin.json 的 author ★ 必须保持原样的两处（改了会坏）： · legacySeededPromptSignature = "你是 HomeAgent 的看板娘「小宅」…" —— 那是识别历史播种人格卡的**原文锚点**，改了就识别不出旧数据 · 公开 SDK 的 ProxyAuthHomeAgent = "homeagent" —— 那是 SDK 契约里的值，属独立仓库，本仓不改 ## ② 修 21 处乱码（U+FFFD） 这些是历史编辑留下的编码破坏，全在注释里，例如： 「赌注重下���遍」→「赌注重下一遍」 「「不��滤」」 →「「不过滤」」 「**待��退场**」→「**待退场**」 ★ 保留 providers/chineseclip/tokenizer.go 里的 2 处：那是**故意**用 U+FFFD 演示"非法 UTF-8 字节被归一成 U+FFFD"，不是乱码。 ## ③ 提示词技术内容下沉（用户：技术性内容应该收敛到 skill 与 -help 中） 实测系统提示词 2309 字，其中两段几乎全是**模型无法据以行动的实现细节**： 【工具执行顺序】1272 字（ParallelSafe 声明、批内降级、batchRunnable 判据…） 【三层记忆】 1069 字（L1/L2/L3 编号、消费式删除、向量空间、指纹…） 收敛后 **2309 → 1723 字（-25%）**，保留的全是"模型据此做什么不同的事"： 工具顺序：默认并行 / 不要依赖先后 / 同通道保序 / 写类工具可能串行 三层记忆：时序里能看最近 / doc_query 把历史事件按原始时间戳插回时序 / 关系用 memory_recall / 成文知识用 knowledge_search 判断口径写进判据：新加一段提示词前先问"模型会据此做什么不同的事"， 答不上来就该进 skill 或工具描述。 ## 判据 prompt_memory_test.go 新增 2 条： - TestSystemPromptHasNoImplementationJargon 黑名单：ParallelSafe / batchRunnable / 消费式 / DenseCosine / fingerprint / 向量空间 / 批内降级 / 自激 - TestSystemPromptStaysCompact：上限 2000 字（当前 1723） 变异：把 "ParallelSafe 声明、批内降级" 加回工具顺序段 ⇒ 第一条立刻红。 ## 验证 - go build ./... / go vet ./... 干净 - go test ./... -count=1：58 包 0 失败 - make check-client-versions：客户端与内核版本一致 | 2 天前 | |
feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10) * feat(kernel): 模块化内核 + 编译期依赖图定序 把单体 init 序列拆成「模块自声明依赖 + 编译期生成依赖图 + 运行期只读图」。 ## 为什么 原 cmd/homed/main.go 里 17 步 init 是**手写顺序**，依赖关系只存在于 注释和人脑里。实测踩到的坑（见 docs/zh/kernel-modularization-design.md）： · nlp.defaultParser 被 initONNXParser 写、被 distiller 读，两者相距 60 行， 只靠 ticker 10min 才没炸（隐式依赖，无声明） · 加一个模块要人肉找"该插在哪"，插错的表现是运行期 nil 解引用 · 关停是 defer ks.CloseAll()，而热更新路径 os.Exit(42) **跳过 defer** ⇒ docStore/distiller/textMem 的 flush 全部丢失（每次热更新都发生） ## 怎么改 - internal/kernelboot/：KernelState（一个结构体收全部包级共享变量，字段 nil 安全）、Module 接口、graphfile（依赖图编解码 + 与二进制 hash 对账）、 scheduler（按 BFS 层并行 Init）、syncbus（层边界写通知）、 lifecycle（Quiesce/Resume 可逆伪关机，区别于一次性 CloseAll） - internal/kernelmod/<name>/：每个模块一个文件夹，Requires/Provides 自声明； all/all.go 是唯一的 import 清单（Go 循环导入约束） - cmd/homed-depgraph：编译期生成依赖图，Makefile 注入 digest - 运行期只**读**图，不计算顺序（顺序是编译期决定的，源码里没有中央清单） ## 判据 kernelboot 8 条 + 图失败模式 7 条（全部拒绝并给准确错误）+ 模块目录数 与注册表一致性。变异测试 15/15 咬住，含： · 删掉 AddCloser 的锁 → -race 报数据竞争 · Scheduler 同批跑去重 → 203 vs 200 · 图 hash 不匹配 → 拒绝启动 ## 顺带修的缺陷 热更新路径漏调模块关闭 ⇒ 显式 stopKernelModules()，并用 AST 判据钉住 "必须在 os.Exit 之前"（字符串检查在本仓已骗过我三次）。 实测：冷启动 1630ms（5 层/17 模块，原 17 步串行）；生产 22 插件全部建链。 * feat(security): 密钥防火墙 + 配置加密 + close 纪律 ## 密钥防火墙 模型只见别名、不见明文；插件工具调用入口（StageHost.ExecuteTool）做入向 回填。三维能力： · 出向：工具输出里的密钥被替换成 [[secret:name]] 别名后才进上下文 · 入向：模型传别名，入口处填回真值（插件完全无感知） · 存储：config.db 里不存明文（0644 的库可读），敏感值独立 0600 文件 模式库「宁漏勿误伤」：宁可漏掉一次替换，也不把正常文本误当密钥。 ## 配置加密 - internal/security/{codec,key,keyring,store,global}.go：AES-256-GCM， enc:v1: 前缀，密钥轮换（OldKeys 解码 + 新钥加密） - harden.go：数据目录权限收紧 - embedded.go：支持内嵌主密钥（可选，仍保留外部 key 文件路径） - EncryptExistingSecrets / AuditSecrets：启动时幂等迁移 + 审计 ## close 纪律（用户明确要求：只要调 close 就要有前置检查） internal/safeclose：Safe / SafeFunc。全仓 37 处裸 close(chan) → 0。 关键教训（都写进注释和判据）： · select { case <-ch: default: close(ch) } **不是**并发安全的 （两个 goroutine 可同时命中 default）—— healthcheck 原先是这种写法 · sync.Once **不可重入**：X.Do(func(){ Safe(&X, ...) }) 会自锁， 症状是 go test 直接挂住（3 个包 600s 超时），栈里只有嵌套的 Once.Do · map 里按请求持有的 channel（mcp/stdio.go、clawhubadapter/sidecar.go） 改成 *pendingRPC 包装，每通道一个 once ## 判据 security 全量 + TestNoBareCloseOutsideSafeclose（AST 级扫描，含注释剥离） + TestNoNestedSelfOnceDeadlock（正则修正：\w+ 不匹配点号，捕获组要含 '.'）。 变异 2/2 咬住。全量 52 包 ok。 * feat(plugin+deploy): 插件三态生命周期、数据目录迁移、发行包修复 ## 插件三态生命周期（用户要求：自动启动 / 启用但不自动启动 / 禁用） - Manifest 新增 requires_facilities / auto_start（*bool，用于区分 "未声明"与"显式 false"） - plugin-host 模块（internal/kernelmod/pluginhost）：用 kernelboot.Scheduler 按依赖时机拉起，**不再手写两阶段** - 运行态停启 StopPlugin/StartPlugin **可逆**：不写 disabled_plugins （不改用户决定）、不置 shuttingDown（之后还能加载）、会摘掉注册面 - 与 StopAll 的区别写进注释 —— StopAll 置 shuttingDown 后**永久无法加载**， 那是进程退出用的，误用于"暂停"就是关了就死 ## 数据目录迁移（伪关机 → 迁移 → 唤醒） - kernelboot/lifecycle.go：Quiesce/Resume（可逆，区别于一次性 CloseAll）， 逆序暂停、逆序恢复、Pause 失败回滚 - kernelboot/migrate.go：BeginMigration/End 编排（先停插件 → 再停内核写者 → 等在途归零） - distiller/textmem 增 Pause/Resume 门（不是 cancel —— cancel 不可逆， 恢复要重建整个对象） - 模块 migration：体检 + 生成可执行迁移脚本 ★ 迁移脚本的三个实测教训（都写成了判据）： 1. 无条件改 /etc/systemd/system ⇒ 演练把**生产** -data 改成了演练目录。 加 --dry-run（零改动）+ 强制校验 systemd 当前 -data == OLD 2. 本机没装 rsync，脚本在"服务已停、数据未搬"处硬失败 ⇒ cp -a 回退， 并明确警告不保硬链接/ACL（生产 plugindev 有大量 git 硬链接） ## 发行包修复（全部经实测确认） 1. package-linux.sh **完全漏打 depgraph.bin** ⇒ 内核 exit 1 （"生产构建（内嵌 hash 非空）但读不到依赖图"） 2. build_homed 不走 Makefile ⇒ 单独修 Makefile 无效，必须同时生成图+注入 3. build.sh 的 LDFLAGS 用**历史模块路径 gitcode.com** ⇒ -X 静默 no-op ⇒ --version 显示 unknown 4. Makefile -ldflags 用**单引号** ⇒ 注入了字面 $GRAPH_HASH ## ★ build.sh 的版本号必须校验（真实事故） 原 VERSION="$(git describe --tags --dirty)"。无 tag 分支上它返回**分支名** backup/pre-identity-rewrite-20261005-51-g03d87a4e-dirty，被注入 meta.Version ⇒ 插件握手判据 MajorVersion() 把整串当主版本 ⇒ **22 个子进程插件全部 握手失败**（"主版本不匹配"）。内核活着、systemd active、日志每条都像 插件的问题 —— 实际是发行包带着非法版本号。 修法：git describe 只在形如 vX.Y.Z 时采用，否则回退 meta.Version（权威源）， 并对最终值做形态守卫。deploy/packaging/version_guard_test.go 3 条判据， 变异 2/2 咬住。 ## deb 的 systemd unit 改为 guard 模式 ExecStart=/usr/bin/homed --role=guard --data /var/lib/homeagent （worker exit 42 → guard 重拉，不经过 systemd、不计失败） 含 RestartSteps/RestartMaxDelaySec/TimeoutStopSec + 硬化 （NoNewPrivileges/ProtectSystem/ProtectHome/DevicePolicy/ReadWritePaths）。 ## 其他 - internal/plugin/proc：非法 JSON 帧的报错**可定位**（内容摘要 + 可能原因 + 修法）。生产实测 1038 条非法帧（插件往 stdout 打日志 = 污染协议通道） - 示例插件 4 个 14 处 fmt.Printf → log.Printf - hmapdev 模板同步修复；scaffold 判据剥离注释（模板注释里就含 fmt.Printf） * chore: 收尾（主密钥轮换命令、IPC/知识库加固、SDK 对齐） - cmd/homed-key-rotate：把 security 里的 RotateKey/RotateKeyFile/RekeySecrets 串成一条**可执行**的运维路径。没有它，E-1 就只是库里的能力而不是 "出事时能做的事"，而轮换的价值恰恰在于能执行。 - cmd/homed：kmod_runtime（模块装配入口）、plugins_scheduled（failback 白名单）、memcandidate、bootstrap_order_test / shutdown_flush_test - internal/ipc、internal/devicebridge、internal/knowledge：配套加固 - third_party/homeagent-sdk/sdk：PluginMgrAPI 增三态能力（mgrStop/mgrStart/ mgrIsRuntimeStopped）+ settings 对齐 判据：bootstrap_order_test（启动顺序不依赖手写序列）、 shutdown_flush_test（停机的两条路径必须对称 —— exit 42 会跳过 defer， 热更新路径下模块关闭/flush 曾全部丢失）。 * test(security): 测试夹具改用不可误认的占位值（修 push protection 拦截） GitHub secret scanning 拦住了推送：三处测试夹具用了"看起来像真密钥"的 字面量： internal/security/prefilter_test.go:39 internal/security/store_test.go:177 internal/security/survey_test.go:20 它们全是**假密钥**（AKIAIOSFODNN7EXAMPLE 是 AWS 官方文档的标准示例， 其余是 abcdefghij... 这类可读占位符），但扫描器无法区分 —— 它只看形态。 ★ 不绕过（不用 unblock URL、不加 allowlist）：直接改夹具。 原因：一旦允许"假密钥可以通过"，真密钥混进来时就没有最后一道门了。 改法：保留**模式库匹配所需的结构**，把可识别内容换成 FAKE： glpat-abcdefghijklmnopqrst → glpat-FAKE-TEST-TOKEN-NOT-REAL sk-abcdefghij...012345 → sk-FAKE-TEST-KEY-NOT-REAL-0000000 AKIAIOSFODNN7EXAMPLE → AKIA0000FAKE0000TEST (保持 20 字符) ASIAIOSFODNN7EXAMPLE → ASIA0000FAKE0000TEST xoxb-123456789012-abcdefghijklmnop → xoxb-FAKE-TEST-TOKEN-NOT-REAL ★ 中途踩到一次：AWS 键的模式是 \b(AKIA|ASIA)[0-9A-Z]{16}\b（共 20 字符）， 我第一次替换成 19 字符的 AKIAFAKETESTKEY0000 ⇒ 模式匹配不上 ⇒ TestSurvey_WhatIsCaught / TestRecognizesCommonShapes / TestPrefilterNeverBlocksRealMatches 三条当场变红。 判据正确地拒绝了"为了过扫描器而削弱覆盖"。 顺带核实：全仓 grep 无任何真实密钥泄漏。 * fix(packaging): package-linux.sh 的版本解析与 build.sh 统一 上一版只修了 build.sh，漏了 package-linux.sh —— 它仍只看 git describe： VERSION="${VERSION:-$(git describe --tags --dirty)}" 无 tag 分支上 git describe 返回**分支名** （backup/pre-identity-rewrite-20261005-56-g98850e1），守卫会正确拒绝， 但要求人**手动传 VERSION** 才能打包。而 build.sh 早已能自动回退 meta.Version ⇒ 同一个版本，走 build.sh 打得出来、走 package-linux.sh 打不出来。 危害不只是"要手动传参"：运维为了跑通会去掉守卫，而分支名一旦进 meta.Version 就是**插件协议主版本**的来源 ⇒ 22 个子进程插件全部握手失败 （这是真实发生过的事故，见 3efa4e5）。 修法：两个脚本用同一套规则（git describe 仅在 vX.Y.Z 形态时采用， 否则回退 meta.Version），并对最终值做形态守卫。 判据：TestBothPackagingScriptsShareVersionRules —— 逐个读两个脚本， 要求都能从 meta/meta.go 取权威版本、都校验 git describe 形态。 变异（把 package-linux.sh 改回旧规则）咬住并准确指出是哪个脚本。 实测：不传 VERSION 跑 package-linux.sh，输出 [PKG] warn: git describe 给出非版本串（...），改用 meta.Version=1.4.0 Version: 1.4.0 * fix(test): 跨仓判据在 CI 上应 skip 而非 fail（修 PR 双红） CI 上 "Go build / vet / test" 与 "Build linux/amd64" 双红： --- FAIL: TestHmapdevTemplateImplementsAllPluginMgrMethods bridge_sync_test.go:170: 读模板: open ../../../third_party/homeagent-sdk/tools/hmapdev/templates/proc_main.go.tmpl: no such file or directory ## 根因：判据依赖了一个**被 gitignore 的路径** .gitignore:33 有 third_party/homeagent-sdk/tools/（SDK 仓自治，本仓不跟踪）。 于是： · 本机（完整 SDK 检出）有该文件 ⇒ 判据通过 · CI（只 checkout 本仓）没有该文件 ⇒ Fatalf ⇒ **必红** 我提交时只在本机跑测试、没看 CI，所以这个问题拖到 PR 才暴露。 ## 修法 文件缺失时 t.Skipf 而不是 t.Fatalf。 ★ 这不是"放弃检查"： · 跨仓一致性由 **SDK 仓自己的判据**守着 （tools/hmapdev/scaffold_stdout_test.go 等），那里才是模板的真实归属地 · 本判据在本机开发时**仍然生效**（已验证：有文件时 PASS，缺文件时 SKIP） ## 验证 · 本机（有文件） → PASS（判据真跑） · 模拟 CI（移走 tools/）→ SKIP（不再 fail） · 全量 53 包 ok / 0 fail ## 顺带 同目录还有 e2e_template_test.go 也读 tools/，但它是 //go:build 门控的 e2e 判据，CI 默认不跑，无需处理。 --------- Co-authored-by: JianFeeeee <JianFeeeee@users.noreply.gitcode.com> | 7 天前 | |
refactor: 全面改名为 HologramAgent + 提示词技术内容下沉到 skill/工具描述 + 修 21 处乱码 ## ① 全面改名 HomeAgent → HologramAgent 仓库已改名，但代码与文档里仍有大量旧名。本次按"用户能看到的优先"全量替换： - 用户可见：登录页标题/页脚、默认人格第一句、CLI 状态输出、启动日志、 plugin_install 的工具描述、AI 图片插件的 User-Agent - 文档与脚本：README、assets/docs、docs/zh、deploy/*.sh、.github/workflows - 鸿蒙工程：cmd/ohos/HomeAgent → cmd/ohos/HologramAgent（git mv） 目录内的 module/app 描述同步；**证书路径原样保留** （default_HomeAgent_xxx.cer/p7b/p12 是签名材料的实际文件名，改了会找不到证书） - 插件元数据：plugin.json 的 author ★ 必须保持原样的两处（改了会坏）： · legacySeededPromptSignature = "你是 HomeAgent 的看板娘「小宅」…" —— 那是识别历史播种人格卡的**原文锚点**，改了就识别不出旧数据 · 公开 SDK 的 ProxyAuthHomeAgent = "homeagent" —— 那是 SDK 契约里的值，属独立仓库，本仓不改 ## ② 修 21 处乱码（U+FFFD） 这些是历史编辑留下的编码破坏，全在注释里，例如： 「赌注重下���遍」→「赌注重下一遍」 「「不��滤」」 →「「不过滤」」 「**待��退场**」→「**待退场**」 ★ 保留 providers/chineseclip/tokenizer.go 里的 2 处：那是**故意**用 U+FFFD 演示"非法 UTF-8 字节被归一成 U+FFFD"，不是乱码。 ## ③ 提示词技术内容下沉（用户：技术性内容应该收敛到 skill 与 -help 中） 实测系统提示词 2309 字，其中两段几乎全是**模型无法据以行动的实现细节**： 【工具执行顺序】1272 字（ParallelSafe 声明、批内降级、batchRunnable 判据…） 【三层记忆】 1069 字（L1/L2/L3 编号、消费式删除、向量空间、指纹…） 收敛后 **2309 → 1723 字（-25%）**，保留的全是"模型据此做什么不同的事"： 工具顺序：默认并行 / 不要依赖先后 / 同通道保序 / 写类工具可能串行 三层记忆：时序里能看最近 / doc_query 把历史事件按原始时间戳插回时序 / 关系用 memory_recall / 成文知识用 knowledge_search 判断口径写进判据：新加一段提示词前先问"模型会据此做什么不同的事"， 答不上来就该进 skill 或工具描述。 ## 判据 prompt_memory_test.go 新增 2 条： - TestSystemPromptHasNoImplementationJargon 黑名单：ParallelSafe / batchRunnable / 消费式 / DenseCosine / fingerprint / 向量空间 / 批内降级 / 自激 - TestSystemPromptStaysCompact：上限 2000 字（当前 1723） 变异：把 "ParallelSafe 声明、批内降级" 加回工具顺序段 ⇒ 第一条立刻红。 ## 验证 - go build ./... / go vet ./... 干净 - go test ./... -count=1：58 包 0 失败 - make check-client-versions：客户端与内核版本一致 | 2 天前 | |
style: gofmt 两处对齐（graphmedia_test.go 注释、tfidf.go 结构体字段） 这两处是本次特性分支带入的格式回归（origin/main 上不脏）。 纯空白/对齐调整，无语义变化；不整体重排文件。 | 1 个月前 | |
refactor(module): 核心仓 Go module 路径改为 github.com/JianFeeeee/HologramAgent 批 1，不含 SDK 仓与目录改名。 - go.mod 第 1 行 module 路径 - 366 个 .go 文件的完整前缀 github.com/JianFeeeee/HomeAgent 机械替换 （857 处，仅完整前缀；展示名/注释里的 HomeAgent 字样留给批 5） - 未改：third_party 目录名、SDK 自身 go.mod module、go.mod replace 目标、 homed/waiter 可执行名、.hmap 后缀 | 4 天前 |
| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
| 51 分钟前 | ||
| 2 天前 | ||
| 4 天前 | ||
| 17 天前 | ||
| 4 天前 | ||
| 1 天前 | ||
| 6 小时前 | ||
| 2 天前 | ||
| 4 天前 | ||
| 1 天前 | ||
| 2 天前 | ||
| 2 天前 | ||
| 4 天前 | ||
| 4 天前 | ||
| 3 小时前 | ||
| 4 小时前 | ||
| 4 天前 | ||
| 2 个月前 | ||
| 7 天前 | ||
| 4 天前 | ||
| 1 天前 | ||
| 4 天前 | ||
| 2 天前 | ||
| 7 天前 | ||
| 2 天前 | ||
| 1 个月前 | ||
| 4 天前 |