2 Commits

Author	SHA1	Message	Date
root	b9097986c8	fix(prompt): 拼装时空行翻倍 + 人格支持版本占位符 + 配置项说明对齐分层原则 ... ## 1. 提示词里的空行翻倍（用户实测发现） 抓包看实际 payload，system 里出现 3 处连续 3~4 个换行： …别包装成"稍等我看一下"。\n\n\n【人格设定】 …/mascot.webp 直接能看。\n\n\n\n【场景记忆】 …能否同轮发出。\n\n\n【输出规则】 根因：拼装统一用 `prompt += "\n\n" + block`，而块自己常以换行结尾 （人格块是 "【人格设定】\n%s\n"，自定义 system_prompt 也常带尾部换行）。 空行不致命但推高 token，也让「提示词到底长什么样」难以肉眼核对。 修法：新增 appendPromptBlock（trim 块两端 + 只拼一个 "\n\n"），所有拼装点改用它。 重新抓包：连续 3+ 换行 0 处。 ## 2. 人格块支持版本占位符 buildSystemPrompt 只对 systemPrompt 调 expandPromptVars，人格块没展开 —— 人格里写死版本号仍会随发版说谎（实测线上人格卡写 v1.0.3）。现在人格同样展开 {{kernel_version}}/{{kernel_commit}}/{{sdk_version}}。 ## 3. 人格/系统提示词两个配置项的说明重写 - core.agent.personal_prompt：DisplayName 改为「人格设定（称呼/语气/说话方式/形象）」， 说明只写人设；工具用法写工具描述、多步流程写技能；支持占位符；文件优先。 - core.agent.system_prompt：DisplayName 改为「系统提示词（身份与行为规则）」， 说明只写跨工具/跨通道成立的内容；运行时通道投递/并行/时序语义由内核注入无需重复； 留在提示词里的工具用法会随插件外置而失真。 ## 4. 【记忆清理指令】→【记忆维护】 具体选哪个 memory_* 工具、各自副作用早已写在工具描述里（【记忆清理】前缀）， 提示词里那份逐条列举属于重复。只保留「必须真做、不能只描述计划」这条 不看工具描述也会犯的错，并要求用一句人话说结果。 ## 5. 新增 opt-in 提示词抓包（排查用） HOMED_PROMPT_DUMP=<path> 时把每轮实际发给 LLM 的 messages 落 jsonl（0600）。 环境变量而非常规配置项：内容是用户隐私，只该在诊断时临时开。 本次排查即由它拿到证据；诊断后已移除临时 drop-in。 验证：go test（agent core / config / sdk / healthcheck）全绿； 实例重启后抓包复核空行归零；对话口吻仍为「短、口语、不列清单」。	2026-10-20 09:16:07 +08:00
JianFeeeee	a5e6656079	feat(prompt): 提示词声明「同轮默认并行」及其例外（阶段 2.5） ... ⚠️ 本阶段有硬性顺序约束：必须在并行执行（阶段 2d）落地**之后**。 反序（先说"并发"、内核仍串行）会让提示词**对模型说谎** —— 模型据 "并发执行"推断安全性，写出真正依赖顺序的调用。宁可晚改，不可错改。 改动（tooldefs.go，buildSystemPrompt）： · 新增【工具执行顺序】段，讲清四件事： 1. 同一条回复里的多个工具调用**默认并行**（同时跑），不是依次执行 2. **不要依赖执行顺序** —— 参数依赖前一个结果就分两轮 3. **例外一：同通道 output_send__ 保序**（用户可见消息顺序敏感） 4. **例外二：不并发安全的工具整批退回串行**（写类工具 / 未声明者） · 顺带说明并发安全由**工具自己声明**（ParallelSafe），不由模型判断 · 改掉 spawn_child 的落空表述：原文「应并行 spawn，不要自己串行逐个执行」 在并行化之前是**落空**的（模型照做，内核仍串行）。改为机制性表述， 并补一句「一次 spawn 只是启动动作，要拿结果仍需另一次 child_result」。 ⚠️ 措辞刻意与 batchRunnable 的**真实**判据一致（全批 ParallelSafe 才并发 + 同通道保序），而不是理想化表述 —— 提示词与实现不符，比不说更坏。 判据（prompt_parallel_test.go，5 条）： · 四要点齐全（并行 / 顺序 / 保序 / 并发安全声明） · ★ 必须同时讲**例外** —— 只讲并行就是"说谎"的那一种 · 同通道保序须显式说明（保序是内核兜底，模型不知情就会浪费它） · spawn_child 不再含旧的落空措辞 · 回归防护：既有要点（输出规则 / output_list_channels / 工具能力 / 记忆清理）不丢 ★ 判据里的一次自伤：先写了 spawnChildDescription(a) 这个**不存在**的 helper（"工具名反查描述"），编译失败后改为 toolDefDescription —— 内部 遍历 buildToolDefs 的**真实产物**。判据必须对着代码真实输出，不能另建一套 注册表。 变异验证：把两条例外改写成"以上适用于所有工具"⇒ 3 条判据 FAIL （缺"保序"、缺"例外"、同通道未说明）。即"提示词说谎"这一失败模式 现已被判据覆盖。 回归：internal/agent/... internal/sdk/... internal/plugins/... 全绿（15 包）。	2026-09-27 11:55:33 +08:00