[Bug] LLM context compression inserts empty summary without logs or warning

[yuuuuuouo]

What happened / 发生了什么

预期行为：

1. 如果 LLM 压缩成功，应写入实际摘要内容；
2. 如果压缩模型返回空内容、调用失败或解析失败，应在日志中输出明确 warning/error；
3. 最好能记录 context compression 的触发、请求、返回、写入结果，方便排查。

实际行为：

• summary 占位被插入；
• summary 内容为空；
• 日志中没有任何与 LLM context compression / summary 相关的信息；
• 用户无法判断是压缩模型未调用、返回为空、解析失败，还是保存字段失败。

Reproduce / 如何复现？

启用“由 LLM 压缩上下文”后，当上下文压缩逻辑触发时，历史消息中会插入一段空摘要
Our previous history conversation summary: 后没有任何摘要正文，但系统仍然继续对话，且没有在日志中打印压缩失败、空返回或保存失败等信息。

AstrBot version, deployment method (e.g., Windows Docker Desktop deployment), provider used, and messaging platform used. / AstrBot 版本、部署方式（如 Windows Docker Desktop 部署）、使用的提供商、使用的消息平台适配器

AstrBot version: v4.24.2
Deployment: Windows
Provider: Gemini 3.1 Pro（用于上下文压缩）
Messaging platform: QQ / aiocqhttp / NapCat

OS

Windows

Logs / 报错日志

目前没有相关报错日志。问题的一部分正是：触发 LLM context compression 后，即使 summary 为空，也没有任何 warning/error/debug 日志输出，导致无法进一步定位。

附件：

1. 上下文管理策略配置截图；

3. 后台实际消息 json 数据，显示 summary 占位存在但内容为空。```json { "role": "user", "content": "Our previous history conversation summary: " }, { "role": "assistant", "content": "Acknowledged the summary of our previous conversation history." } ```

建议增加日志：

• context compression 触发时打印 debug；
• 压缩模型请求开始/结束打印 debug；
• 压缩模型返回空内容时打印 warning；
• 压缩结果写入失败时打印 error；
• 最终写入 summary 的长度/状态打印 debug。

Are you willing to submit a PR? / 你愿意提交 PR 吗？

• Yes!

Code of Conduct

• I have read and agree to abide by the project's Code of Conduct。

[dosubot]

确认了这个问题。查看 LLMSummaryCompressor.compress() 的代码逻辑 [1]，可以看到：

try:
    response = await self.provider.text_chat(contexts=llm_payload)
    summary_content = response.completion_text
except Exception as e:
    logger.error(f"Failed to generate summary: {e}")
    return messages

问题根因：代码只对 LLM 调用异常做了 try-except 处理，但没有对 summary_content 为空的情况做验证。当 response.completion_text 返回空字符串（非异常）时，代码会直接拼接到消息中 [2]：

Message(
    role="user",
    content=f"Our previous history conversation summary: {summary_content}",
)

这就导致了你看到的 "Our previous history conversation summary: " 后面没有任何内容的情况。

修复建议（与你的建议一致）：

1. 在 summary_content = response.completion_text 之后增加空值检查：

   if not summary_content or not summary_content.strip():
       logger.warning("LLM context compression returned empty summary content.")
       return messages  # 回退到不压缩

2. 在压缩触发、请求开始/结束、写入结果处增加 logger.debug() 日志。

另外，此前有过一个相关 bug：provider 参数未正确传递给 LLMSummaryCompressor，导致压缩功能完全失效 [3]。如果你使用的是 v4.24.2，该 bug 应已修复，但你可以确认配置中的压缩 provider 是否正确绑定了 Gemini 模型。

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.

[yuuuuuouo]

Thanks. Just to confirm: the provider-passing issue fixed in v4.24.2 is separate from this empty-summary handling issue, right?

From what I understand, this issue still requires adding validation for empty summary_content and logging a warning/debug message when compression returns blank content.

[dosubot]

对，你的理解是正确的。这是两个独立的问题：

1. Provider 传递问题（已修复）：之前 LLMSummaryCompressor 没有正确接收 provider 实例，导致压缩功能完全无法调用 LLM [1]。
2. 空 summary 未验证（当前 issue）：即使 provider 正确传递、LLM 调用成功但返回空内容时，代码没有做空值检查，也没有任何日志输出 [2]。

当前代码仍需添加对 summary_content 的空值验证和相关日志，这属于尚未修复的缺陷。

To reply, just mention @dosu.

---

Share context across your team and agents. Try Dosu.

[yuuuuuouo]

I checked the current code in `astrbot/core/agent/context/compressor.py`.

In `LLMSummaryCompressor.__call__`, the code only catches exceptions from `provider.text_chat`, but does not validate whether `response.completion_text` is empty:

```python
response = await self.provider.text_chat(contexts=llm_payload)
summary_content = response.completion_text

Then it directly inserts the result into history:

content=f"Our previous history conversation summary: {summary_content}",

So if completion_text is an empty string, the empty summary placeholder will be inserted without any warning.