HomeAgent

jianf/HomeAgent

Fork 0

mirror of https://gitcode.com/JianFeeeee/HomeAgent.git synced 2026-09-22 18:08:04 +00:00

Commit Graph

Author	SHA1	Message	Date
JianFeeeee	b096e8ba2c	refactor(shm): 变长块分配器 + 工具调用 funccall 调用帧(§13.2/§13.3) 按架构约束推进两步： 1) 分配器收回内核后，定长槽失去了唯一存在理由（定长槽只是为了绕开"跨进程无法安全变长分配"），于是 arena 换成变长块分配器：first-fit + 邻块合并，块头 16B（size/state/owner/prevSize）。内核可以按需标定每块大小， payload 不再受固定槽容量限制（旧上限 16KB）。 - Alloc/Put/Read/Free/ReclaimOwner 全在内核进程内，一把 sync.Mutex - Free 走块链校验 offset 是已分配块的数据起点 + owner 匹配，伪造引用不能改动分配器状态 - Read 允许块内偏移（调用帧的结果区就在帧块中间），但不许跨块边界 - arena 4MB，底层 memfd 惰性分配：未触碰的页不占物理内存 2) 工具调用 payload 始终走共享内存，取消按大小切内联的分支。按 funccall 模型，内核（caller）标定调用帧交给插件（callee）： [0, ArgsLen) 参数 JSON [ArgsLen, Frame.Length) 结果区（内核预留的预算）结果超出预算时插件才 `arena.alloc` 扩容块，引用上打 sharedRefFlagExpand 让内核单独归还。Cleaner 复用同一帧模型。 ToolInvokeParams.Args / ToolInvokeResult.Result 仅剩给直连 RPC 的测试（process/bench 不建 Host）；生产路径永远走帧。测试： - TestArena_（分配/归属/回收/并发唯一/耗尽/超限/伪造 offset/ 相邻合并/对齐/布局校验） - TestPlugin_ToolInvokeArgsResultViaArena：大小* payload 都经帧往返，结果一致且 arena 归零（"小 payload 同样走调用帧"是本轮行为变更） - TestPlugin_ArenaAllocFreeAcrossProcess、TestE2E_* 保持通过 - 顺手修 process_test.go 一处预存 doc-comment 分段	2026-09-10 18:54:36 +08:00
JianFeeeee	ca584bda3f	refactor(shm): 内核独占共享槽池，插件经 RPC 申请/归还(§13.2/§13.3) 推翻前两版跨进程分配器设计，根因是"共享内存里放了只被单一进程更新的可变游标"： - v1 在 SuperBlock 放 arenaUsed 游标，内核 CAS bump。但插件模板里 arenaUsed 是进程本地变量，两进程各自 bump 必写同一段内存； arenaReset 还会重置共享游标覆盖对方数据。 - v2 把位图 CAS 下沉到插件模板，正确但把分配器实现泄漏进插件运行时，且插件必须与内核保持位图布局同步。新设计（用户明确的架构约束）：内核全权管理共享内存，插件通过 syscall 风格 RPC 申请/归还，内核返回偏移与大小。分配器只存在于内核进程内，一把 sync.Mutex 即可。共享内存是内部实现，不对插件开发者暴露——SDK 公开 API 仍是普通字符串/Map。主要改动： - arena.go: 定长槽 + 位图，Alloc/Put/Read/Free/ReclaimOwner，内核独占；槽头记录 owner，Free 校验归属；payload 超槽容量退回内联 RPC - protocol.go: 新增 arena.alloc / arena.free（CapCore） - capability.go: 登记两个新 method（checkAllMethodsClassified 要求） - corehandler.go: 实现 arena.alloc/free；Cleaner 改为内核预分配请求槽 + 响应槽（插件完全不分配） - plugin.go: Start 领 ownerID；handleExit 调 ReclaimOwner 回收残留槽 - unified.go: 移除坏的 bump 分配器；arena 基址 8 字节对齐 - 删除 toollane.go: ring 状态机是死代码（从未接线），且把 RPC 已有的请求 ID 关联/错误传递/ctx 取消重新实现了一遍。控制面保留 RPC，只把 payload 搬进共享槽。 - 测试: TestArena_*（归属/回收/并发唯一/耗尽/超限/非法引用/布局）+ TestPlugin_ArenaAllocFreeAcrossProcess（真进程申请→写入→随业务 RPC 回传→归还→内核读回一致且池归零）	2026-09-10 17:56:50 +08:00

Author

SHA1

Message

Date

JianFeeeee

b096e8ba2c

refactor(shm): 变长块分配器 + 工具调用 funccall 调用帧(§13.2/§13.3)

按架构约束推进两步：

1) 分配器收回内核后，定长槽失去了唯一存在理由
   （定长槽只是为了绕开"跨进程无法安全变长分配"），
   于是 arena 换成**变长块分配器**：first-fit + 邻块合并，
   块头 16B（size/state/owner/prevSize）。内核可以按需标定每块大小，
   payload 不再受固定槽容量限制（旧上限 16KB）。

   - Alloc/Put/Read/Free/ReclaimOwner 全在内核进程内，一把 sync.Mutex
   - Free 走块链校验 offset 是已分配块的数据起点 + owner 匹配，
     伪造引用不能改动分配器状态
   - Read 允许块内偏移（调用帧的结果区就在帧块中间），但不许跨块边界
   - arena 4MB，底层 memfd 惰性分配：未触碰的页不占物理内存

2) 工具调用 payload **始终**走共享内存，取消按大小切内联的分支。
   按 funccall 模型，内核（caller）标定调用帧交给插件（callee）：

       [0, ArgsLen)              参数 JSON
       [ArgsLen, Frame.Length)   结果区（内核预留的预算）

   结果超出预算时插件才 `arena.alloc` 扩容块，引用上打
   sharedRefFlagExpand 让内核单独归还。Cleaner 复用同一帧模型。
   ToolInvokeParams.Args / ToolInvokeResult.Result 仅剩给直连 RPC 的
   测试（process/bench 不建 Host）；生产路径永远走帧。

测试：
- TestArena_*（分配/归属/回收/并发唯一/耗尽/超限/伪造 offset/
  相邻合并/对齐/布局校验）
- TestPlugin_ToolInvokeArgsResultViaArena：大**小** payload 都经帧往返，
  结果一致且 arena 归零（"小 payload 同样走调用帧"是本轮行为变更）
- TestPlugin_ArenaAllocFreeAcrossProcess、TestE2E_* 保持通过
- 顺手修 process_test.go 一处预存 doc-comment 分段

2026-09-10 18:54:36 +08:00

JianFeeeee

ca584bda3f

refactor(shm): 内核独占共享槽池，插件经 RPC 申请/归还(§13.2/§13.3)

推翻前两版跨进程分配器设计，根因是"共享内存里放了只被单一进程
更新的可变游标"：

- v1 在 SuperBlock 放 arenaUsed 游标，内核 CAS bump。但插件模板里
  arenaUsed 是**进程本地变量**，两进程各自 bump 必写同一段内存；
  arenaReset 还会重置共享游标覆盖对方数据。
- v2 把位图 CAS 下沉到插件模板，正确但把分配器实现泄漏进插件运行时，
  且插件必须与内核保持位图布局同步。

新设计（用户明确的架构约束）：内核全权管理共享内存，插件通过
syscall 风格 RPC 申请/归还，内核返回偏移与大小。分配器只存在于内核
进程内，一把 sync.Mutex 即可。共享内存是内部实现，不对插件开发者
暴露——SDK 公开 API 仍是普通字符串/Map。

主要改动：
- arena.go: 定长槽 + 位图，Alloc/Put/Read/Free/ReclaimOwner，内核独占；
  槽头记录 owner，Free 校验归属；payload 超槽容量退回内联 RPC
- protocol.go: 新增 arena.alloc / arena.free（CapCore）
- capability.go: 登记两个新 method（checkAllMethodsClassified 要求）
- corehandler.go: 实现 arena.alloc/free；Cleaner 改为内核预分配
  请求槽 + 响应槽（插件完全不分配）
- plugin.go: Start 领 ownerID；handleExit 调 ReclaimOwner 回收残留槽
- unified.go: 移除坏的 bump 分配器；arena 基址 8 字节对齐
- 删除 toollane.go: ring 状态机是死代码（从未接线），且把 RPC 已有的
  请求 ID 关联/错误传递/ctx 取消重新实现了一遍。控制面保留 RPC，
  只把 payload 搬进共享槽。
- 测试: TestArena_*（归属/回收/并发唯一/耗尽/超限/非法引用/布局）+
  TestPlugin_ArenaAllocFreeAcrossProcess（真进程申请→写入→随业务
  RPC 回传→归还→内核读回一致且池归零）

2026-09-10 17:56:50 +08:00

2 Commits