mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-22 01:48:11 +00:00
feat(shm): 文档/知识正文入共享内存 + 协议版本 bump 到 2(§13.13)
## 数据面补齐 - doc.insert / doc.insertWithMedia:新增 doc_ref / attachments_ref, 模板序列化后 putValueInArena - knowledge.add:新增 content_ref(内容是 JSON 字符串,读出后再解一层) - 抽出通用 resolveJSONRef(resolveBlocks 也改用它),三处共用一套 “共享优先、内联回退”逻辑 ## 协议版本 bump:让错配显式失败,而不是静默坏 这是本轮更重要的部分。§13.6/§13.13 改了内核→插件 payload 的承载方式, 两种错配都不会报错、只会静默失效: - v1 插件只读内联 args(tool/cleaner/output)→ 遇到 v2 内核拿到空参数 - v2 插件发 blocks_ref → v1 内核反序列化时静默忽略(旧内核 io.setToolBlocks 还是桩实现) 现场表现为“输出变空 / 图注入没反应”,极难定位。所以把 ProtocolVersion 与模板 procProtocolVersion 一起 bump 到 2:双方都是等值校验,v1 插件遇上 v2 内核会在建链时明确报“协议版本不匹配…请用配套 plugindev 重编”。 测试里把“错误必须带出重编指令”也断言上了——生产上碰到它的现场就是 “只更新了内核没重编插件”,光报“不匹配”定位不到行动。 testdata 8 个插件的 protocol 同步更新(badprotoplugin 仍用 999 验证拒绝)。 工具链已重建并安装(协议 2,内嵌 blocks_ref/doc_ref/content_ref), 回滚副本 plugindev.bak-20260910-232544。 验证:-race 全绿。新增 KnowledgeAddViaArena(12000B 正文)、 KnowledgeAddInline、DocInsertViaArena、SetToolBlocks 三例 + 真实模板 e2e + 协议不匹配断言强化。 §13.13 第 5 条(反向大结果)范围更大——需把内核→插件的应答路径整体改成 “大结果写段 + 返回 ref”,涉及 callCore 的返回处理与 doc.query/llm.chat 等 所有读大结果的 method。已在 plan.md 标注未做,不冒充完成。
This commit is contained in:
@ -14,7 +14,15 @@ import "encoding/json"
|
||||
|
||||
// 协议版本:与共享段版本独立演进。
|
||||
// 插件握手时上报,内核校验——不匹配显式拒绝,避免半兼容导致的诡异行为。
|
||||
const ProtocolVersion = 1
|
||||
//
|
||||
// v2(§13.6 / §13.13):内核→插件的 payload 改为调用帧承载。
|
||||
// v1 插件只读内联 args,遇上 v2 内核会拿到空参数;v2 插件发 blocks_ref,
|
||||
// v1 内核反序列化时静默忽略(旧内核 io.setToolBlocks 还是桩)。两种错配
|
||||
// 都不会报错,只会静默失效——所以必须 bump 版本,让它在握手上就**显式**失败。
|
||||
//
|
||||
// 部署纪律:内核与全部插件必须同批重建、同批安装;改协议就要改这个常量,
|
||||
// 不得依赖“两边大致兼容”。
|
||||
const ProtocolVersion = 2
|
||||
|
||||
// Direction 无需显式字段:靠 Method 是否为空区分请求与响应
|
||||
// (与 clawhubadapter/sidecar 的成熟做法一致)。
|
||||
|
||||
Reference in New Issue
Block a user