3 Commits

Author	SHA1	Message	Date
JianFeeeee	b15d0bd114	refactor(plugin)!: 重编提示与模板路径改用 hmapdev；文档全面对齐 1.2.0 ... 工具链在 SDK 1.2.0 更名为 hmapdev（原 plugindev）。核心侧三处功能耦合同步： 1. 用户可见报错：旧 C ABI 产物 / 协议版本不匹配 / 共享段版本不匹配 三处「请用配套 plugindev 重编」→ hmapdev（对应两条测试断言同步） 2. e2e_template_test 的模板路径改为 tools/hmapdev/templates， 并保留旧路径回退（旧 SDK 检出仍能跑测试） 3. 注释与文档同步 文档更新（用户可见面）： - assets/docs/{zh,en}/PLUGIN_DEV.md：工具链章节整体改为 hmapdev， 补改名说明与 SDK 存储目录迁移；命令示例全部更新 - assets/docs/{zh,en}/ARCHITECTURE.md：**流程图与章节对齐 v1.2.0** —— · 向量化章节改为三层降级：统一多模态空间（主）→ 词嵌入 → TF-IDF（回退）， 写明「同指纹且同维度才参与融合」 · 媒体记忆章节重写：媒体是一等记忆块（无独立 GC / 无引用计数 / 无描述式索引 / 正文不再写 media marker），并写明 reembedStaleMedia 的跨空间迁移与写回 - README{,_EN}.md、docs/zh/plugin-interface-matrix.md：工具名与模板路径同步 （历史条目标注「当时名为 plugindev」） 验证：go test ./internal/plugin/ ./internal/plugin/proc/ ok， 含 4 条真实模板 E2E（模板路径切换后仍通过）。	2026-09-12 12:42:43 +08:00
JianFeeeee	b20121f703	plugin: 删除 C ABI 通道（Part 6.2 完成，-3198 行） ... 外部插件统一走子进程 + stdio RPC，三套独立 ABI 实现收敛为单一 RPC 实现。 用户决策：彻底舍弃 .so 能力，不保留双通道回退。 ## 删除清单 internal/plugin/cabi/ 1156 行（loader.go/loader.c/types.go/output_test.go） internal/plugin/dynamic_dll_windows.go 272 行（§9.2 记录的能力退化实现） internal/plugin/dynamic_loader_unix.go 79 行（唯一 cabi 引用点） internal/plugin/dynamic_dll_test.go 32 行 internal/plugin/dynamic_dll_stub.go 11 行 internal/plugin/dynamic_loader_windows.go 11 行 internal/plugin/bridge_e2e_test.go （测的是 cabi 路径） third_party/.../plugindev/templates.go 1296 行（取消跟踪，SDK 仓才是权威副本） dynamic.go：entryCABI 通道删除，soEntry/dllEntry 常量删除。 registry.go：tryDynamic 探测顺序从 .so → .dll → .lua 变成 proc → lua。 ## 旧 .so 给明确错误，不静默跳过 静默跳过会让「插件目录在但没加载」看起来像配置问题，而实际原因是需要 用新版 plugindev 重编。故保留 legacyCABIEntries 表专门用于识别残留： plugin legacy: 检测到旧 C ABI 产物（plugin.so/.dll/.dylib）。 外部插件已改为子进程模式，请用新版 plugindev 重编产出 plugin.bin （业务代码无需修改） 错误消息里「业务代码无需修改」这句是有测试守着的——迁移的核心承诺就是它。 ## pluginmgr 安装逻辑跟进 bundle 命名 子进程模式下各平台产物统一叫 plugin.bin（进程边界即 ABI 边界），故 zip 内 按平台加后缀 plugin.bin.<goos>.<goarch>，解包时挑当前平台那一份重命名。 platformBinary 改为按 runtime.GOOS+GOARCH 生成条目名；platformBinaries 固定表 换成 isPlatformBinary 前缀判断（平台组合会增长：linux/arm64、darwin/arm64…， 按前缀判断无需维护清单）。 新增 chmod 0755：zip 保留了原权限位，但经某些工具链/传输后可能丢失， 内核加载时会因缺执行位报错。提前补上比事后让用户 chmod 更好。 ## 测试 entry_dispatch_test.go 重写（12 项）： - classifyEntry 对 .so/.dll/.dylib 现在返回 unknown - LegacyManifestFallsBackToProbe：存量插件 manifest 仍写 "plugin.so" （17 个插件没人去改），须靠目录探测找到 plugin.bin —— 这是 「外部插件零改动」的直接后果 - LegacyCABIGivesActionableError：错误消息须含 plugindev / plugin.bin / 业务代码 - PluginEntryHash_IgnoresLegacyCABI：.so 不参与 hash（内核已不认它） upgrade_test.go 的 .hmap 构造改用 plugin.bin。 验证：go build ./... 通过；go test ./... 全仓无失败； go test -race ./internal/plugin/... 全绿；三平台构建通过。 Ref: docs/zh/架构迁移评估.md §3.1/§9.2、docs/zh/plugin-migration-plan.md Part 6	2026-09-02 19:26:40 +08:00
dev	610e9d0bbb	feat(plugin): entry 双通道分派 + 共享内存 stage 数据面（Part 1 + Part 4 核心） ... Part 1 加载分派骨架（迁移可逐插件推进、随时回退的前提）: - dynamic.go: 新增 binEntry/skillEntry 常量 + entryKind 枚举 + classifyEntry/detectEntryKind manifest entry 优先级最高（改回 plugin.so 即回退 cabi）；无 manifest 时按目录探测，.bin 优先 - registry.go: tryDynamic 按 entry 分派 proc/cabi 双通道； entry 声明 .bin 但二进制缺失时报明确错误，不静默回退（否则'已迁移插件跑回旧通道'极难排查） - registry.go: pluginEntryHash 候选顺序与 detectEntryKind 对齐（.bin 优先）， 否则增量重载会用错文件算 hash - dynamic_proc_{unix,windows}.go: tryLoadProc 桩位（权限/类型校验已实现，进程管理属 Part 2） Part 4 共享内存数据面（迁移评估 §3.3/§3.4/§3.7，最关键一环）: - proc/shm.go: 段布局（Header + ShmStageCtx 描述符数组 + append-only arena） 相对偏移设计——各进程 mmap 到不同虚拟地址仍能正确解引用 arena 用尽显式报错而非静默截断（§4.4 风险登记）；Compact() 回收 append-only 垃圾 - proc/shmcodec.go: StageContext 16 字段跨进程编解码 字段级描述符消除 lost update：只改 FinalText 的插件不触碰 ToolResults 描述符 WriteDirty 只写脏字段——只读插件零写入，不可能覆盖他人改写 Snapshot 存序列化字符串（切片共享底层数组的坑，C ABI 侧修 11.3 时已踩过） Extra 4 键提升为具名字段；Response 用标志位表达 nil vs 空串 - proc/lock.go: 锁仲裁回归内核（§3.7 已裁定，零 cgo） ForceRelease 实现实验 9 的崩溃自愈——排除 robust pthread_mutex 必要性 重复加锁显式拒绝（否则死锁 30s）；等待超时有补偿 goroutine 防锁泄漏 验证: - proc 包 16 项测试全绿（含 -race）：全字段往返/只读零写回/原地改切片识别/ 现网 sanitizer+weather 场景/5插件×40轮并发零丢失/arena 耗尽报错/压实不破坏字段/ 锁互斥·串扰拒绝·崩溃自愈·临界区串行化 - entry 分派 9 项测试全绿；go build ./... exit 0；接口冻结 git diff sdk/ 为空	2026-09-02 10:41:18 +08:00