mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-21 09:28:14 +00:00
50ba4a64cb
## 数据面补齐 - 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 标注未做，不冒充完成。
77 lines
1.8 KiB
Go
77 lines
1.8 KiB
Go
//go:build ignore
|
|
|
|
// echoplugin 是测试用的最简子进程插件：实现握手 + 回显工具。
|
|
// 不 import 公开 SDK——只验证 proc 包的 RPC 机制本身。
|
|
package main
|
|
|
|
import (
|
|
"bufio"
|
|
"encoding/json"
|
|
"fmt"
|
|
"os"
|
|
)
|
|
|
|
type request struct {
|
|
ID uint64 `json:"id,omitempty"`
|
|
Method string `json:"method"`
|
|
Params json.RawMessage `json:"params,omitempty"`
|
|
}
|
|
|
|
type response struct {
|
|
ID uint64 `json:"id"`
|
|
Result interface{} `json:"result,omitempty"`
|
|
Error string `json:"error,omitempty"`
|
|
}
|
|
|
|
func main() {
|
|
in := bufio.NewScanner(bufio.NewReader(os.Stdin))
|
|
in.Buffer(make([]byte, 0, 64*1024), 1024*1024)
|
|
out := bufio.NewWriter(os.Stdout)
|
|
|
|
send := func(v interface{}) {
|
|
b, _ := json.Marshal(v)
|
|
out.Write(b)
|
|
out.WriteByte('\n')
|
|
out.Flush()
|
|
}
|
|
|
|
for in.Scan() {
|
|
var req request
|
|
if err := json.Unmarshal(in.Bytes(), &req); err != nil {
|
|
continue
|
|
}
|
|
switch req.Method {
|
|
case "handshake":
|
|
send(response{ID: req.ID, Result: map[string]interface{}{
|
|
"protocol": 2,
|
|
"sdk_version": "test",
|
|
"plugin_name": "echo",
|
|
"pid": os.Getpid(),
|
|
}})
|
|
case "plugin.stop":
|
|
send(response{ID: req.ID})
|
|
out.Flush()
|
|
os.Exit(0)
|
|
case "tool.invoke":
|
|
var p struct {
|
|
Name string `json:"name"`
|
|
Args map[string]interface{} `json:"args"`
|
|
}
|
|
json.Unmarshal(req.Params, &p)
|
|
switch p.Name {
|
|
case "fail_tool":
|
|
send(response{ID: req.ID, Error: "故意失败：用于验证错误上报"})
|
|
default:
|
|
text, _ := p.Args["text"].(string)
|
|
send(response{ID: req.ID, Result: map[string]interface{}{"result": text}})
|
|
}
|
|
case "event.deliver":
|
|
// 通知：不回应答
|
|
default:
|
|
if req.ID != 0 {
|
|
send(response{ID: req.ID, Error: fmt.Sprintf("未实现 %s", req.Method)})
|
|
}
|
|
}
|
|
}
|
|
}
|