mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-29 22:12:52 +00:00
docs: 删除迁移期临时文档,现行内容搬进正式文档
用户指出迁移评估那批是**过程性临时文档**,迁移已完成就该退场。
## 删除(38 个文件)
- docs/zh/架构迁移评估.md(1621 行)—— 评估稿。开头的「❗现网正在发生的问题」
(output_send 永远成功 / cgo 超时泄漏 26 次 / stage 污染)**全部已修复**,
留着是误导性告警。其 §三「目标架构」已被 ARCHITECTURE.md 完整覆盖
(且后者更细,含子进程生命周期管理)。
- docs/zh/plugin-interface-matrix.md(428 行)—— 迁移基线矩阵。
- docs/zh/experiments/(36 文件)—— 18 项可行性实验,验证的是"该不该迁移",
迁移早已完成;实测无任何构建/测试依赖它。
## 现行内容先搬走(不能随临时文档一起丢)
- plugin-interface-matrix §九「接口扩展规则」→ 搬进 docs/git-branching.md 新增 §八
(只增不减/签名不改、新增必须"插件调用内核实现"方向、hmapdev 模板必须同步接线
否则全体插件编译失败、"接口纯追加"≠"无需重编"、合回 main 的同步清单)。
- git-branching §六 原写「接口冻结是合回门禁」—— 冻结是**迁移期**约束,v1.1.x 起
已到期,改为标注失效并指向 §八。
## 引用清理
8 处引用全部改指现行文档:plan.md ×3、两篇设计文档各 ×1、
4 处源码注释(proc/shm.go、proc/process.go、dynamic_proc.go、entry_dispatch_test.go、
proc/bench_test.go)。仅 third_party(SDK 独立仓)保留 1 处,不动。
## 验证
- `go build ./...` 通过;`go test ./internal/plugin/...` 两个包全绿
- 本项目文档**断链 0**(另 2 处断链在 oh_modules 第三方依赖内)
This commit is contained in:
@ -40,8 +40,8 @@ func tryLoadProc(dir, name string, config map[string]interface{}) (sdk.Plugin, e
|
||||
|
||||
// 子进程插件加载(plugin.bin)——外部插件多进程化的加载入口。
|
||||
//
|
||||
// 设计依据:docs/zh/架构迁移评估.md §3(stdio JSON-RPC 控制面 + shm 数据面 + eventfd 通知面)
|
||||
// 实施记录见 docs/zh/架构迁移评估.md(子进程化论证与实验数据)
|
||||
// 三个通信面:stdio JSON-RPC(控制)+ 共享内存段(数据)+ eventfd 通知环。
|
||||
// 设计取舍见 assets/docs/zh/ARCHITECTURE.md「子进程插件的三个通信面」。
|
||||
|
||||
// validateProcBinary 校验 plugin.bin 是否存在且可执行。
|
||||
// 返回 ("", nil) 表示该目录不是 proc 插件。
|
||||
|
||||
@ -7,7 +7,7 @@ import (
|
||||
"testing"
|
||||
)
|
||||
|
||||
// entry 分派(见 docs/zh/架构迁移评估.md 的入口双通道章节)。
|
||||
// entry 分派:按 manifest 的 entry 把插件分派到 proc / lua / skill 三条通道。
|
||||
//
|
||||
// C ABI 通道(.so/.dll/.dylib)已整体退场:外部插件统一走子进程 + stdio RPC。
|
||||
// 这些测试守住的是「旧产物给明确错误」而非「静默跳过」——后者会让
|
||||
|
||||
@ -12,7 +12,7 @@ import (
|
||||
|
||||
// 子进程架构的性能基准(Part 6.6 验收项)。
|
||||
//
|
||||
// 对照基线来自 docs/zh/experiments/plugin-arch:
|
||||
// 对照基线(迁移期可行性实验实测,那些实验脚本已随迁移完成删除):
|
||||
//
|
||||
// 实验 3 锁仲裁 RPC 往返 19.40 µs/次
|
||||
// 实验 4 post-and-forget 5.07s → 2.29ms(5000 token + 20µs 慢消费者)
|
||||
|
||||
@ -19,7 +19,7 @@ import (
|
||||
|
||||
// Process 管理一个外部插件子进程:spawn / 双向 JSON-RPC / 优雅停止 / 崩溃检测。
|
||||
//
|
||||
// 设计依据:docs/zh/架构迁移评估.md §4.1 阶段 2、§2.3(保留现有生命周期机制)
|
||||
// 生命周期:沿用内核既有的注册面摘除 + 退避重启机制(见 stats/registry)。
|
||||
//
|
||||
// 与 C ABI 路径的关键差异:
|
||||
// - **崩溃隔离**:插件 panic 只让子进程退出,homed 存活(今日 panic 跨 C 栈可带崩内核)
|
||||
|
||||
@ -1,6 +1,7 @@
|
||||
// Package proc 实现外部插件的子进程加载通道(plugin.bin)。
|
||||
//
|
||||
// 设计依据:docs/zh/架构迁移评估.md 第三章
|
||||
// 数据面设计:定长头 + arena,变长数据用相对基址的 {off,len} 描述符
|
||||
//(相对偏移是关键:各进程 mmap 到不同虚拟地址也能正确解引用)。
|
||||
//
|
||||
// homed ──spawn──> plugin(纯 Go 二进制,无 cgo)
|
||||
// ├── stdio JSON-RPC 控制面:51 个 method id 平移为 method 名(§3.2)
|
||||
|
||||
Reference in New Issue
Block a user