关于影子模式

[U202310108]

影子模式启用后为什么在对应群聊内没有任何效果，请问一下这个模式还可以使用吗，没有找到相关的说明

[EterUltimate]

影子模式目前可以使用，感谢反馈——这个问题暴露了文档的缺失，我们已经在补充（见 PR #251）。

为什么启用了却"没有任何效果"

最常见的原因是：影子模式的注入受 LLM Hook 总开关控制，而该开关默认是关闭的。

影子档案本身保存在 Dashboard「影子模式」页学习并启用（这一步总是能成功），但它在回复前注入走的是 LLM Hook，需要先开启：

设置页 → 「运行与内部」分组 → 「启用 LLM Hook 上下文注入」（enable_llm_hooks，默认关闭）

社交上下文、记忆、黑话、few-shot 和影子模式档案都经由这个开关注入，开关关闭时每次回复前会直接跳过全部注入。在 WebUI 设置页打开后立即生效，无需重启。

另外两点需要了解

1. 影子模式是"风格模仿"，效果偏克制：它只影响机器人本来就发出的回复的句长、语气词、标点和表达习惯，不会让机器人主动发言、不会产生额外回复，也不会在群里提示影子模式的存在（提示词明确要求不透露）。所以开启后应通过对比回复风格来观察，而不是期待明显的"新模式"。
2. 档案与群组一一对应：档案的「生效群组」必须和实际对话的群号完全一致；同一生效群组同时只有一份启用中的档案。

排查清单

1. 设置页「运行与内部」→「启用 LLM Hook 上下文注入」已开启（最常见原因）。
2. 「影子模式」页的影子档案列表中，目标群组的档案处于启用状态。
3. 档案生效群组与实际对话群号一致。
4. 日志等级设为 debug 后，回复前应出现 [LLM Hook] 已准备影子模式档案；若出现 总开关未启用，跳过上下文注入 即为原因 1。

详细使用说明已补充到文档（使用指南「影子模式」章节、配置说明「运行与内部」、WebUI API 影子模式接口），合并后可在 docs/ 目录查看：PR #251。