feat: 优化 T2I 渲染与自定义配置

1. 支持配置两轮 T2I 渲染策略,允许用户自定义图片格式(PNG/JPEG)、质量、分辨率及超时时间。
2. 实现 T2I 返回 HTML 错误页的自动识别与摘要提取(如 502 Bad Gateway),提升故障排查效率。

- 参考 #174 关于 T2I 动态超时与配置的建议
- 参考 #171 关于处理 T2I 返回 HTML 错误信息的建议
- 解决了 [Feature Request] 支持配置 PNG/JPEG 渲染优先级,避免大报告场景下因本地大图保护而回退为文件发送 #164
This commit is contained in:
SXP-Simon
2026-04-23 08:43:51 +08:00
parent e1c5b854c7
commit fc843fac03
4 changed files with 186 additions and 51 deletions
+13 -4
View File
@@ -102,10 +102,19 @@ _✨ 一个基于 AstrBot 的智能群聊分析插件,支持 **QQ (OneBot)**
> [!TIP]
> 如果生成图片失败,日志显示 `[Core] [WARN] [v4.xx.0] [utils.logger:xx]: [xxxxx_xxx群_xxxx] [群分析插件] 渲染策略 {'full_page': True, 'type': 'xxx', 'quality': xxx, 'scale': 'device', 'device_scale_factor_level': 'xxx'} 返回了无效或空数据`、`Endpoint https://t2i.soulter.top/text2img failed`、`Endpoint https://t2i.rcfortress.site/text2img failed` 这种情况并回退到文本总结,可考虑自部署 T2I 服务。
>
> **图片生成失败/渲染超时的解决办法**
>
> 如果生成图片失败,日志显示 `渲染策略 ... 返回了无效或空数据`、`Endpoint ... failed` 等并回退到文本总结,通常是因为日报内容过大导致 T2I 渲染超时(默认 30s 左右)。
>
> ### 1. 调整插件渲染参数
> 插件现支持 **两轮渲染策略**,可在配置面板的 **图片渲染策略 (`t2i_rendering`)** 分组中按需调整:
>
> - **增加超时时间**:若日报极其复杂(包含大量内联 CSS/JS/图表),请将 `渲染超时 (ms)` 调大。建议范围:30,000ms - 180,000ms (3 分钟)。
> - **优化回退策略**:建议第一轮使用 `png` + `ultra` 追求极致清晰;第二轮作为回退,建议使用 `jpeg` + `high/normal` 分辨率并配合更长的超时时间,以确保即使在资源受限的情况下也能产出报告。
>
> ### 2. 使用备用 T2I 服务或自部署
> <details>
> <summary><b>若不便自部署,可尝试使用以下 T2I 服务(点击展开):</b></summary>
> <summary><b>若配置调整后渲染仍频繁失败,可尝试更换 T2I 服务(点击展开):</b></summary>
>
> - **Hugging Face 服务**: `https://huggingface.co/spaces/clown145/astrbot-t2i-service`
> - **API 接口地址**: `https://clown145-astrbot-t2i-service.hf.space`
@@ -119,7 +128,7 @@ _✨ 一个基于 AstrBot 的智能群聊分析插件,支持 **QQ (OneBot)**
> - **说明**: 在国内直接访问原始域名下载图片可能较慢,可选择使用此代理域名。在一段时间内大概率稳定。
> </details>
>
> **自部署 T2I 文档**docs.astrbot.app/others/self-host-t2i.html
> **自部署 T2I 文档**[docs.astrbot.app/others/self-host-t2i.html](https://docs.astrbot.app/others/self-host-t2i.html)
> [!IMPORTANT]
>