feat(shm): 输出通道 payload 走共享内存调用帧(§13.6)

§13.3 给 ToolInvokeParams 加了调用帧,但 OutputInvokeParams 没跟上——
payload 仍内联在 RPC JSON 里。核实后确认这个 lane 只做了半边:注入侧
(injectParams.TextRef + resolveText)可用,输出侧从内核到插件仍是内联。

改法照搬工具调用的 funccall 帧模型:

- OutputInvokeParams 加 Frame/ArgsLen(Args 仅留给直连 RPC 的测试)
- invokeOutput 序列化参数 → Alloc 帧 → 写帧 → 只传偏移描述符 → defer Free
- 帧尾不预留结果区:output 应答很小("ok"/status map),走 RPC 应答字段即可。
  但 OutputInvokeResult 支持插件把大结果写回帧(ResultRef),并识别
  sharedRefFlagExpand 单独归还扩容块——与 invokeTool 一致。
- 模板 output.invoke 用 frameInput 从帧读参数,无帧才回退内联 Args

为什么要做:output payload 在真机上可能含图片/文件描述等大字段,内联会
撑爆 stdin/stdout 管道。

验证:
- TestPlugin_OutputPayloadViaArena:9000 字节 payload 经帧完整送达(插件回报
  实收长度,不是只看返回值)+ 调用后 arena 归零
- TestE2E_RealTemplateOutputPayloadViaFrame:同上,但用真实 SDK 模板编译的
  插件——生产插件走的就是模板,模板不读帧则此改动等于没做
- TestPlugin_OutputChannelReportsRealFailure 仍绿:同步等真实结果、失败必须
  上报(§9.4)的语义未被破坏
- go test -race ./internal/plugin/... 全绿

plan.md §13.5 也如实标注:注入 side 内核→插件方向仍未接线(procCore.InjectText
直接传字符串,从不 Alloc/Put 构造 TextRef),不是仅打勾的项。
This commit is contained in:
JianFeeeee
2026-09-10 21:28:56 +08:00
parent b71a88a471
commit e2672c56d6
6 changed files with 244 additions and 22 deletions

32
plan.md
View File

@ -1239,26 +1239,50 @@ SDK 仓 `v1.0.0` / `v1.1.0`。main 的版本路牌现为 `1.2.0`(尚无 tag
**目标**输入通道消息走共享内存
**现状(核实)**基础设施就位但内核侧未接线——
- `injectParams.TextRef SharedRef` `resolveText`corehandler.go:585
在插件内核方向可用但内核插件方向的 `procCore.InjectText` 仍直接传
字符串给 `sdk.InjectText`从不 `Alloc/Put` 构造 `TextRef`
- 即只做了半边插件回传文本内核注入还没走共享内存
**实施**
1. InputChannel Slotsource/channel/text/blocks 写入 arena
2. 插件消费后设 DONE
3. 同步注入仍走 RPC + SharedRef
3. 同步注入仍走 RPC + SharedRef 需要接线内核侧
4. 异步注入改写 arena + eventfd
**验证**
- [ ] 真实 QQ 消息注入测试
- [ ] git commit -m "feat(shm): input channel lane"
- [ ] git commit -m "feat(shm): input channel lane" 未提交内核侧待接线
### 13.6 OutputChannel lane
**目标**输出通道消息走共享内存
**实施**已完成
1. `OutputInvokeParams` `Frame SharedRef` + `ArgsLen``Args` 仅留给直连
RPC 的测试 `ToolInvokeParams` 同一 funccall 帧模型
2. `invokeOutput` Alloc payload JSON只传偏移描述符插件退出/调用完
后内核归还整帧`defer arena.Free`
3. 帧尾不预留结果区output 应答很小`"ok"` / status map直接走 RPC
应答字段若插件把大结果写回帧`OutputInvokeResult.ResultRef`也能读回
并识别 `sharedRefFlagExpand` 单独归还扩容块
4. 模板 `output.invoke` 从帧读参数`frameInput`无帧才回退内联 `Args`
**验证**
- [ ] QQ 输出正常
- [ ] git commit -m "feat(shm): output channel lane"
- [x] `TestPlugin_OutputPayloadViaArena`9000 字节 payload 经帧完整送达插件
回报实收长度+ 调用后 arena 归零
- [x] `TestE2E_RealTemplateOutputPayloadViaFrame`同上但用**真实 SDK 模板**
编译的插件生产插件走的就是模板模板不读帧该改动就等于没做
- [x] `TestPlugin_OutputChannelReportsRealFailure` 仍绿同步等真实结果
失败必须上报(§9.4不被破坏
- [ ] QQ 输出正常需生产部署后验证
- [x] git commit -m "feat(shm): output channel lane"
### 13.7 RuntimeManager + 分组 worker