mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-11-01 23:07:30 +00:00
b850feaef2
记忆层： - MemoryBlock 承载 FrameTS/PageSeq/PageKind/BlockRole/CallID - coldcontext 归档与回填按完整页传递，工具调用参数和配对键不丢失 - 召回先估算总 token，超预算时按全局页相似度标记 inactive - inactive 仅是 context 渲染期状态，不落盘、不进入 coldcontext，Prune 后重置 - Peek/确认/Remove 两阶段召回，失败保留冷上下文副本 - stablemem 记录 last_recalled_at，删块连带清理边 命名： - internal/memory/document → internal/memory/coldcontext - Doc/DocEvent/DocHit → ColdDoc/ColdEvent/ColdHit - ContextToColdContext/RecentColdContexts/FindColdContexts - 保留既有 JSON 标签、doc_ 文件前缀与 doc_count 状态键，兼容存量数据 安全治理： - 工具策略门禁、安全配置、事件总线发布者身份与入站脱敏 - 声明式 SecurityAPI 与 QQ owner/guest profile - 日志保留策略与相关 e2e/回归判据 验证：go build ./...、go vet ./...、go test ./...（62 包）； 生产副本 e2e：7013 块迁移后 ID/向量/指纹 0 变化、0 缺失。
85 lines
3.5 KiB
Go
85 lines
3.5 KiB
Go
package toolroute
|
||
|
||
// 内置工具的**分发**（路由）归属 device。
|
||
//
|
||
// ## 这一步搬的是什么
|
||
//
|
||
// 原先 `agent/core/toolcall.go` 的 `executeToolCallInner` 自己写了一张
|
||
// "工具名前缀 → 族处理器"的 switch。那张表是本模块的第一份事实来源，
|
||
// 现在搬到这里：
|
||
//
|
||
// device.Dispatch(handlers, tc) → 选族 → handlers.ExecuteXxx(tc)
|
||
//
|
||
// 第二阶段再把**族实现**（memory_* / knowledge_* / coldcontext_* …）
|
||
// 从 core 搬进 device（依赖改为显式 Deps），路由这一段不用再动。
|
||
//
|
||
// ## 为什么保留族粒度
|
||
//
|
||
// 族内工具共享同一批依赖，按族传接口让 device 在不认识 Agent 内部字段的
|
||
// 前提下完整接管路由；逐工具传接口会让 30+ 个方法散成一张大表。
|
||
|
||
import (
|
||
"strings"
|
||
|
||
"github.com/JianFeeeee/HologramAgent/internal/agent/api"
|
||
)
|
||
|
||
// Dispatch 按工具名选出族处理器并执行。
|
||
//
|
||
// 返回 (结果文本, 是否属于内置工具)：
|
||
// - handled=false 表示"不是内置工具"，调用方应继续走插件/设备路径。
|
||
// 这是关键语义：**device 不吞掉未知工具**，否则插件工具会消失。
|
||
func Dispatch(h api.BuiltinToolHandlers, tc api.ToolCall, turnScenes []string) (string, bool) {
|
||
if h == nil {
|
||
return "", false
|
||
}
|
||
switch {
|
||
case tc.Name == "persona_set":
|
||
return h.ExecutePersonaTool(tc), true
|
||
case strings.HasPrefix(tc.Name, "stablemem_"):
|
||
return h.ExecuteMemoryTool(tc, turnScenes), true
|
||
case strings.HasPrefix(tc.Name, "social_"):
|
||
return h.ExecuteSocialTool(tc), true
|
||
case strings.HasPrefix(tc.Name, "knowledge_"):
|
||
return h.ExecuteKnowledgeTool(tc), true
|
||
case strings.HasPrefix(tc.Name, "coldcontext_"):
|
||
// doc_* 是旧前缀（工具已改名），保留兼容：插件/测试仍有旧调用。
|
||
return h.ExecuteColdContextTool(tc), true
|
||
case strings.HasPrefix(tc.Name, "doc_"):
|
||
return h.ExecuteColdContextTool(tc), true
|
||
case strings.HasPrefix(tc.Name, "secret_"):
|
||
return h.ExecuteSecretTool(tc), true
|
||
case strings.HasPrefix(tc.Name, "output_send__") && strings.HasSuffix(tc.Name, "_help"):
|
||
return h.ExecuteOutputSendHelp(tc), true
|
||
case strings.HasPrefix(tc.Name, "output_send__"):
|
||
return h.ExecuteOutputSend(tc), true
|
||
case tc.Name == "output_list_channels":
|
||
return h.ExecuteOutputListChannels(), true
|
||
case tc.Name == "input_channels":
|
||
return h.ExecuteInputChannels(tc), true
|
||
case tc.Name == "resident_agents":
|
||
return h.ExecuteResidentAgents(tc), true
|
||
case tc.Name == "notify_parent":
|
||
return h.ExecuteNotifyParent(tc), true
|
||
case tc.Name == "inputch_note":
|
||
return h.ExecuteInputchNote(tc), true
|
||
case tc.Name == "plgreload":
|
||
return h.ExecutePluginReload(), true
|
||
case tc.Name == "get_plugin_tools":
|
||
name, _ := tc.Arguments["plugin_name"].(string)
|
||
return h.ExecuteGetPluginTools(name), true
|
||
}
|
||
return "", false
|
||
}
|
||
|
||
// ★ 已删除 IsBuiltinTool（2026-10-29）。
|
||
//
|
||
// 它曾是 Dispatch 之外**第二份**前缀表，注释还写着"与 Dispatch 共用同一套
|
||
// 前缀常量" —— 但实际上是手抄的平行清单，两处都要人肉同步。
|
||
// 实测：全仓零调用方（唯一的 device.IsBuiltinTool 包装器同样零调用），
|
||
// 却在改名时制造了真实故障：改了 Dispatch 的 stablemem_，漏了这份表，
|
||
// 于是"看起来在维护事实来源"的代码变成了误导。
|
||
//
|
||
// 需要判"某名字会不会被处理"时，**直接调 Dispatch** —— 它的
|
||
// (string, bool) 第二个返回值就是权威答案。别再引入平行表。
|