From 02861f5d64a7576b14d2fa32b52bba7c8f053c4d Mon Sep 17 00:00:00 2001 From: JianFeeeee Date: Sun, 13 Sep 2026 14:31:13 +0800 Subject: [PATCH] =?UTF-8?q?fix(prompt):=20=E7=B3=BB=E7=BB=9F=E6=8F=90?= =?UTF-8?q?=E7=A4=BA=E8=AF=8D=E6=94=AF=E6=8C=81=E7=89=88=E6=9C=AC=E5=8D=A0?= =?UTF-8?q?=E4=BD=8D=E7=AC=A6=20=E2=80=94=E2=80=94=20=E4=BA=BA=E6=A0=BC?= =?UTF-8?q?=E5=8D=A1=E4=B8=8D=E5=86=8D=E5=86=99=E6=AD=BB=E7=89=88=E6=9C=AC?= =?UTF-8?q?=E5=8F=B7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 现象（用户发现）：agent 向用户自报版本是 **1.0.3**，而内核早已 1.3.x。 根因：**人格卡是配置项**，线上 `core.agent.system_prompt` 里写死了 「HΔ-Kernel v1.0.3 型号的家政型 AI 管家助手」——那是当年装机的文本， 之后每次发版都不会去改它，模型于是照抄给用户。默认模板用 `meta.Version` 拼接（`registry.go` 的 `fmt.Sprintf`）所以一直是对的，**只要被自定义过就会漂**。 修法：在 `buildSystemPrompt` 组装处展开占位符，让这类文本跟随真实构建： {{kernel_version}} → meta.Version（如 1.3.5） {{kernel_commit}} → 构建 commit {{sdk_version}} → 所兼容 SDK 版本（如 1.3.0） - 未知占位符**原样保留**：写错了要看得见，而不是被静默换成空串； - 不含 `{{` 时原样返回（提示词在热路径上）； - 覆盖所有路径：主 agent 与驻留子都经 `buildSystemPrompt`， `persona_set` 写入的文本同样在读取时展开（存的是模板，不是渲染结果）； - 配置项描述里写明可用占位符，引导用户别再写死版本。 回归判据 `TestExpandPromptVars`：展开正确 / 内置占位符不残留 / 线上真实人格卡文本能被纠正 / 未知占位符不被吞 / 无占位符不改写。 --- internal/agent/core/promptvars_test.go | 32 ++++++++++++++++++++++++++ internal/agent/core/tooldefs.go | 26 ++++++++++++++++++++- internal/config/registry.go | 2 +- 3 files changed, 58 insertions(+), 2 deletions(-) create mode 100644 internal/agent/core/promptvars_test.go diff --git a/internal/agent/core/promptvars_test.go b/internal/agent/core/promptvars_test.go new file mode 100644 index 0000000..f418279 --- /dev/null +++ b/internal/agent/core/promptvars_test.go @@ -0,0 +1,32 @@ +package core + +import ( + "strings" + "testing" + + "gitcode.com/JianFeeeee/HomeAgent/internal/meta" + sdkmeta "gitcode.com/JianFeeeee/homeagent-sdk/meta" +) + +func TestExpandPromptVars(t *testing.T) { + got := expandPromptVars("型号 {{kernel_version}}（{{kernel_commit}}），SDK {{sdk_version}}") + if !strings.Contains(got, meta.Version) || !strings.Contains(got, sdkmeta.Version) { + t.Fatalf("占位符未展开: %q", got) + } + if strings.Contains(got, "{{") { + t.Fatalf("仍有未展开的内置占位符: %q", got) + } + // 人格卡实测原文：写死了 v1.0.3，应能被占位符取代 + live := expandPromptVars("你是 HomeAgent 的看板娘「小宅」(Xiao Zhai)，HΔ-Kernel v{{kernel_version}} 型号的家政型 AI 管家助手。") + if strings.Contains(live, "1.0.3") || !strings.Contains(live, "v"+meta.Version) { + t.Fatalf("人格卡版本未跟随内核: %q", live) + } + // 未知占位符必须原样保留（写错要看得见，不能被静默吞掉） + if unk := expandPromptVars("版本 {{kernel_verison}}"); !strings.Contains(unk, "{{kernel_verison}}") { + t.Fatalf("未知占位符被吞: %q", unk) + } + // 无占位符时原样返回（人格卡热路径，不做无谓拷贝） + if plain := "无占位符"; expandPromptVars(plain) != plain { + t.Fatal("无占位符时不应改写") + } +} diff --git a/internal/agent/core/tooldefs.go b/internal/agent/core/tooldefs.go index a6f2609..23a87af 100644 --- a/internal/agent/core/tooldefs.go +++ b/internal/agent/core/tooldefs.go @@ -5,6 +5,8 @@ import ( "strings" agentIO "gitcode.com/JianFeeeee/HomeAgent/internal/agent/io" + "gitcode.com/JianFeeeee/HomeAgent/internal/meta" + sdkmeta "gitcode.com/JianFeeeee/homeagent-sdk/meta" ) func (a *Agent) buildMemoryContext(input string, maxTokens int) string { @@ -37,8 +39,30 @@ func (a *Agent) buildMemoryContext(input string, maxTokens int) string { return s } +// expandPromptVars 展开自定义提示词（人格卡）里的版本占位符。 +// +// 为什么需要：人格卡是**配置项**，一旦写死版本号就会随内核发版而说谎 —— +// 实测线上人格卡写着 "HΔ-Kernel v1.0.3 型号"，内核早已 1.3.x，agent 向用户 +// 自报版本时就照抄 1.0.3。占位符让这类文本永远跟随真实构建： +// +// {{kernel_version}} → 内核版本（如 1.3.5） +// {{kernel_commit}} → 构建 commit +// {{sdk_version}} → 所兼容的 SDK 版本（如 1.3.0） +// +// 未知占位符**原样保留**：写错了要看得见，而不是被静默换成空串。 +func expandPromptVars(s string) string { + if !strings.Contains(s, "{{") { + return s + } + return strings.NewReplacer( + "{{kernel_version}}", meta.Version, + "{{kernel_commit}}", meta.Commit, + "{{sdk_version}}", sdkmeta.Version, + ).Replace(s) +} + func (a *Agent) buildSystemPrompt(memContext string, userInput string) string { - prompt := a.systemPrompt + prompt := expandPromptVars(a.systemPrompt) if prompt == "" { prompt = "你是小宅，HomeAgent 的看板娘，一个家政型 AI 管家助手。绝不用 Unicode emoji，只用颜文字表达情感，句尾带语气词。WebUI 概览页展示你的立绘。" } diff --git a/internal/config/registry.go b/internal/config/registry.go index 5cc5b97..2c32687 100644 --- a/internal/config/registry.go +++ b/internal/config/registry.go @@ -742,7 +742,7 @@ func (r *ConfigRegistry) seedCoreDefs(dataDir string) { reg(ConfigDef{Key: "core.agent.workdir", Default: "", Type: "string", DisplayName: "工作目录", Description: "Agent 命令执行的默认工作目录（如 cmd_run 工具的 fallback），留空使用内核所在目录", Category: "agent"}) reg(ConfigDef{Key: "core.agent.embedding_model_path", Default: "", Type: "string", DisplayName: "预训练词嵌入模型路径", Description: "预训练词嵌入模型路径（word2vec 文本格式），支持逗号分隔多个模型。路径后可加 #topN 规格只加载前 N 个词向量（如 /data/cc.zh.300.vec#top50000）以控制常驻内存，词频降序命中覆盖绝大部分文本。空则使用 TF-IDF 回退。修改后需重启生效。", Category: "agent"}) reg(ConfigDef{Key: "core.agent.onnx_model_path", Default: "", Type: "string", DisplayName: "ONNX 模型路径", Description: "依存句法分析 ONNX 模型文件路径。留空使用二进制内嵌模型/规则引擎。修改后需重启生效。", Category: "agent"}) - reg(ConfigDef{Key: "core.agent.system_prompt", Default: "", Type: "text", DisplayName: "系统身份提示词", Description: "Agent 的系统提示词，定义身份和行为规则。留空则使用编译时内置默认值。修改后需重启生效。", Category: "agent"}) + reg(ConfigDef{Key: "core.agent.system_prompt", Default: "", Type: "text", DisplayName: "系统身份提示词", Description: "Agent 的系统提示词，定义身份和行为规则。留空则使用编译时内置默认值。支持版本占位符（随构建实时展开，避免写死版本号随发版说谎）：{{kernel_version}}、{{kernel_commit}}、{{sdk_version}}。修改后需重启生效。", Category: "agent"}) reg(ConfigDef{Key: "core.input_processing.image.fallback_provider", Default: "", Type: "string", DisplayName: "图片回退提供商", Description: "当主 LLM 不支持图片处理时使用的提供商（留空则自动降级为文字描述）", Category: "input"}) reg(ConfigDef{Key: "core.input_processing.image.fallback_model", Default: "", Type: "string", DisplayName: "图片回退模型", Description: "图片回退提供商使用的模型名", Category: "input"})