mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-28 13:23:03 +00:00
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:
@ -278,8 +278,22 @@ const (
|
||||
// 永远返回成功(§9.4,现网 2 次消息发不出而模型以为成功)。
|
||||
// 进程模型下 RPC 天然可等应答,该缺陷从根上消失。
|
||||
type OutputInvokeParams struct {
|
||||
Channel string `json:"channel"`
|
||||
Args map[string]interface{} `json:"args,omitempty"`
|
||||
Channel string `json:"channel"`
|
||||
// Frame 是调用帧:[0, ArgsLen) 是参数 JSON;[ArgsLen, Frame.Length) 是结果区。
|
||||
// 与 ToolInvokeParams 同一 funccall 帧模型(§13.3)。没有帧时(直连 RPC
|
||||
// 测试)回退到 Args。大 payload 不再爆 stdin/stdout 管道——这正是同步
|
||||
// output_send 卡住的根因之一。
|
||||
Frame SharedRef `json:"frame,omitempty"`
|
||||
ArgsLen uint32 `json:"args_len,omitempty"`
|
||||
Args map[string]interface{} `json:"args,omitempty"` // 仅直连 RPC 调用方使用
|
||||
}
|
||||
|
||||
// OutputInvokeResult 与 ToolInvokeResult 同形:结果优先写进帧结果区,
|
||||
// 放不下才申扩容块并打 sharedRefFlagExpand。标量响应(如 "ok")直接在
|
||||
// Result 字段返回,不走共享内存。
|
||||
type OutputInvokeResult struct {
|
||||
ResultRef SharedRef `json:"result_ref,omitempty"`
|
||||
Result interface{} `json:"result,omitempty"` // 仅直连 RPC 调用方使用
|
||||
}
|
||||
|
||||
// ArenaAllocParams / ArenaAllocResult:插件向内核申请共享内存。
|
||||
|
||||
Reference in New Issue
Block a user