2 Commits

Author	SHA1	Message	Date
JianFeeeee	d027c964e2	proc: Windows 共享内存 + 事件通知适配（Part 6.2 内核侧） ... 补齐内核侧的 Windows 创建端，与 6.1 的插件侧打开端配对。三平台 （linux/darwin/windows）现在都能构建 internal/plugin/proc。 ## Windows 走命名内核对象（无 fd 继承语义） os/exec 的 ExtraFiles 在 Windows 实现里不被支持，故： - shmalloc_windows.go：CreateFileMappingW（INVALID_HANDLE_VALUE + 命名 → 系统页文件支撑的匿名段，不落盘）+ MapViewOfFile - evtfd_windows.go：CreateEventW 命名 Event 对象 + SetEvent 通知 - shmpass_windows.go：把段名/对象名经环境变量注入子进程 （HOMEAGENT_SHM_STAGE / HOMEAGENT_SHM_EVTRING / HOMEAGENT_EVT_EVENT） 名字带 PID + 递增序号：多个 homed 实例并存时不能撞名。 Event 与 eventfd 的语义差异：Event 是二元信号，多次 SetEvent 只对应一次 唤醒，不累积。不影响正确性——消费者被唤醒后按 readSeq 追 writeSeq 批量 drain，丢的是"唤醒次数"不是"事件"；事件环本身就允许溢出丢弃并让消费者 知道丢了（dropped 计数），通知面从来不是可靠投递语义。 ## 传递机制抽象为 shmpass_*.go Plugin.Start 不再直接构造 ExtraFiles 列表，改为问 Host 要： Env: p.host.procEnvForShm() // Windows 返回段名，Unix 返回 nil ExtraFiles: p.host.procExtraFilesForShm() // Unix 返回 fd 列表，Windows 返回 nil 平台差异被收敛到这一对函数，Plugin/coreHandler/stage 全部平台无关。 ## macOS pipe 生命周期修正 原实现只返回读端 fd，写端 *os.File 无人持有 → 可能被 GC 回收 → 读端收到 EOF 而非阻塞 → 消费循环变忙转。改为 pipePair 表同时持有两端， evtfdClose 一并关闭。 ## E2E 测试跟进模板拆分 模板从单文件拆成三个（主体 + unix/windows 挂载），测试需要一并落盘， 否则编译报 attachStageShm undefined。procRuntimeTemplates 表必须与 SDK 仓 proc_runtime.go 的 procRuntimeFiles 一致。 验证：三平台 go build ./internal/plugin/... 通过（gojieba 的 cgo 依赖 导致 internal/memory 在非 linux 失败，与本次无关）； go test -race ./internal/plugin/... 全绿，含 2 项真实模板 E2E。 Ref: docs/zh/架构迁移评估.md §9.2、docs/zh/plugin-migration-plan.md Part 6	2026-09-02 19:07:14 +08:00
JianFeeeee	11c1bbcebb	plugin: 子进程通道接通 registry（proc 通道端到端可运行） ... Part 3 收尾。tryLoadProc 从桩位变成真实加载路径，plugin.bin 插件现在 经 registry 完整跑起来：spawn → 握手（共享段 fd 3）→ init/start → 反向注册 → 工具调用 → stage 共享内存读改写。 registry 侧： - Registry 持有 procHost（惰性创建，**全部 .bin 插件共用一块段**）。 每插件一段会让「内核 ctx → 段 → 插件改 → 回读 ctx」在多插件下退化成 副本模型，lost update 原样复现（§8.4 实测 35.8~36.8%）。 - tryDynamic 分派到 Registry.loadProc；tryLoadProc 退为纯静态校验 （构造需要 Host，只有 Registry 有）。 - StopAll 在锁外释放共享段：插件还持有映射时拆段，它们下一次访问就是 SIGBUS；且持锁调用会与 onProcCrash 回调产生锁序风险。 - onProcCrash 把子进程退出转成 EventSystem 事件，不在回调里直接重载 （重载需 registry 锁，而回调可能来自持锁路径的 goroutine）。 proc_core.go —— 权限梯度的类型系统落点（§3.8）： - procCore 用**命名字段**持有 *isdk.PluginSDK，不是嵌入。嵌入会提升全部 方法，外部插件就能经类型断言拿到 Supervisor/Tracker/Adapter/Indexer/ Status/Selftest。命名字段下只有显式写出的方法存在——权限梯度从 「C ABI 表达能力的意外产物」变成显式声明并强制的策略。 - 能力访问器把内部超集接口收窄到公开面（isdk.KnowledgeAPI 内嵌 pubsdk.KnowledgeAPI 再加 Stats/Remove，isdk.MemoryAPI 加 GraphData， isdk.LLMAPI 加 Chat/ReloadFromConfig）；nil 保护避免类型化 nil 让 corehandler 的判空失效。 - procPluginAdapter 转接 Start(*isdk.PluginSDK) → Start(proc.CoreSDK)， Close 对 closeDynamic 可见故重载能真 kill 子进程（对比 dlclose 对 Go c-shared 是 no-op，§1.1）。 共享段分配按平台拆分（原先 host.go 直接调 unix.MemfdCreate，darwin/windows 交叉编译失败）：Linux memfd；macOS 立即 unlink 的临时文件（无 memfd_create， 但语义一致：无残留、fd 可经 ExtraFiles 传递、子进程 mmap 同一 inode）； 其余平台明确报错而非静默降级成「无共享段」——那会让 stage 静默失去数据面。 测试 +13 项： - e2e_template_test.go 用**真实 plugindev 模板**（而非 testdata 手写假插件） 编译插件跑全链路，验证「模板 ↔ 内核」协议/布局真的对齐，不只是内核自己 跟自己对齐。含 lifecycle.autoRestart 上报、工具调用、stage 读改写、 FinalText 回传（C ABI 下 after_toolcall 看不到此字段，§8.3 10→16）、 只读插件不覆盖改写插件。 - proc_load_test.go 验证 Host 唯一性/惰性、chmod +x 错误提示、 Close 可见性，以及 procCore 不暴露内核内部机制的断言。 验证：go build ./... 通过；go test -race ./internal/plugin/... 全绿； 全仓 go test 无新增失败；git diff third_party/homeagent-sdk/sdk/ 为空。 既有告警 cabi/loader.go:156 unsafe.Pointer 非本次引入。 Ref: docs/zh/架构迁移评估.md §3.3/§3.4/§3.8、docs/zh/plugin-migration-plan.md Part 3	2026-09-02 13:03:57 +08:00