mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-21 09:28:14 +00:00
2a03a83ce0
## plugin-migration-plan.md Part 6 标记完成，并**记录实际执行与计划的偏离**而非假装一致： 原计划「逐插件迁移，随时回退」。用户决策改为彻底舍弃 .so、无回退通道， 本轮直接删 internal/plugin/cabi/。因此【V】的「.so ↔ .bin 混跑集群冒烟」 不再适用——新内核根本不认 .so。改为验证「新内核面对旧 .so 给可操作错误 且不崩溃」，已在真实二进制上确认。 最终验收清单加「结果」列，13 项逐项对账。**两项未完全达标，如实标注**： - #9 SetToolBlocks：method 已定义并划入 CapCore，但内核侧仍返回未实现。 C ABI 时代它也是空实现（§1.4），故不是回归，但也没兑现 §3.8 的承诺。 - #13 内存：15 进程 RSS=88.0MB，远超「基线 +29MB」。根因是每插件静态链接 整个 Go runtime，15 个不同二进制无共同物理页（PSS/RSS 99.9% vs 基线 44%）。 实验 5 基线用的是 2.68MB 最小插件，绝对数字不可比；结构性指标 （均摊线程 5.5 vs 4.9）同量级。 新增两节实录：Part 6.5 生产切换（执行顺序为何不能反过来、hmap 正规通道 vs 手工拷贝的对照表、真实 QQ 消息的端到端证据链）与 Part 6.6 压测数据。 ## plugin-interface-matrix.md 状态从「基线 v1」升为「完成 v2」。三个合同面逐一标注达成情况： - 合同面 B：51 个整数 method id 已平移为 Method* 字符串常量。保留原表作 历史对照，但注明 case 25（CoreFreeString）无对应 method（内存管理是 C 层 特有问题），以及 io.setToolBlocks 已定义但内核侧未实现。 - 合同面 C：C1 标题从「今天」改为「迁移前」（迁移已完成，「今天」会误导）； C2 补上「全部插件共享同一块 memfd」这个关键决定及其理由——第一版设计 是每插件一段，那会退化成副本模型复现 lost update。 - 第六节「新获得的能力」加「实际结果」列。事件订阅标注机制已完成但 零用户使用，故未经真实负载检验——这比只写 ✅ 诚实。 「刻意不给」清单同步为带 API 后缀的新命名（SelftestAPI 等），与 capability.go 的 withheldCapabilities 对齐，并说明为何加后缀： 不加时子串匹配会把 tool.register / io.setToolBlocks 误判为泄漏 ToolAPI。 ## PLUGIN_DEV.md（中英双份） C ABI 时代的描述全部改掉： - 「动态 .so/.dll 插件」→「子进程插件」 - 「生成 C ABI bridge（z_bridge_gen.go + z_entry.c）」→ 子进程运行时三文件 - 「go build -buildmode=c-shared」→「go build（CGO_ENABLED=0）」 - 平台二进制表：三平台统一 plugin.bin（bundle 包内按 goos.goarch 区分） - 「不能跨 C ABI 边界序列化」→「不能跨进程序列化」 - 「ABI v2 写回」→「Stage 写回」 新增 v1.0.0 破坏性变更提示框，五条要点：.so 不再加载、业务代码不需改、 entry 字段对 Go 插件已无意义、不再需要 cgo、Windows 从 3 字段升到全字段。 保留 .so 字样的只有变更说明本身（3 处），其余全部清理。