10 · 文字转图片功能详解
适用版本:ZL-综合插件 2.1.0 覆盖内容:工作原理、开启方法、详细指令、触发条件、控制台参数详解、渲染引擎与回退机制、常见问题
🖼️ 一、功能是什么
文字转图片:开启后,机器人发出的纯文字回复会自动在本地渲染成一张精美的彩色卡片图再发送。
效果一览:
为什么需要它:部分客户端把整段文字显示得密密麻麻,图片化后排版精致、手机上显示更大更清晰,同时还能降低风控(大段文字容易被判定为刷屏消息)。
⚙️ 二、工作原理
渲染流程
渲染引擎
| 引擎 | 说明 |
|---|---|
| GDI+ 高速引擎 | 普通纯文字默认使用,启动快、资源占用低,支持字体、字号、换行、背景与随机行彩色 |
| WebView2 Emoji 引擎 | 仅在内容含彩色 Emoji 时启用 Chromium 离屏渲染,保留表情颜色与组合字形;失败时自动回退 GDI+ |
三个重要机制
全程本地渲染:图片在本机生成,不经过任何第三方服务器
自动回退:渲染失败或图片发送失败,自动改为普通文字发送,聊天永不中断
临时文件自动清理:图片保存在系统临时目录(
%TEMP%\ZLTextToImage),超过 2 小时自动过期清理,不会占用磁盘
🚀 三、使用方法
开启功能(三选一)
方式一:群内指令(最快)
方式二:控制台开关
控制台 →「文字转图片」→ 右上角「启用功能」→ 打开 → 保存配置
方式三:控制台页内实时预览
控制台 →「文字转图片」→ 底部测试预览输入文字 → 点「生成预览」,所见即所得,调好后保存即可
关闭功能
或在控制台把「启用功能」关掉。
查看当前参数
回复示例:
📋 四、详细指令
| 指令 | 权限 | 说明 |
|---|---|---|
开启文字转图片 | 主人 | 打开转图开关,立即生效 |
关闭文字转图片 | 主人 | 关闭转图开关 |
文字转图状态 | 主人 | 查看字体/配色/宽度/字数范围等当前参数 |
发送模式 | 管理 | 子菜单(内含上面三个指令的入口提示) |
💡 这三个指令也已收录进「发送模式」子菜单:群内发「发送模式」即可看到。 ⚠️ 指令本身属于开关回复,不会转图,永远以纯文字回复。
🎯 五、触发条件(哪些消息会转图)
一条回复要被渲染成图片,必须同时满足:
| 条件 | 默认值 | 控制台可调 |
|---|---|---|
| 全局开关已开启 | 关闭 | ✅ |
| 内容为纯文字(不含任何 CQ 码) | — | — |
| 字数在范围内 | 6 ~ 600 字 | ✅(转图最小/最大字数) |
| 不含链接、邮箱或 @ 提及 | — | — |
不会转图的情况
含
[CQ:码的消息:图片、@人、语音、音乐卡片、骰子等 → 保持原样含网址、裸域名或邮箱的消息 → 保持文字,链接仍可点击和复制
含普通
@昵称、@QQ号、[AT]或官方机器人 @ 标签 → 保持文字并保留真实提醒能力字数不足 6 字(如"好的")或超过 600 字 → 原样文字发送
功能性回复(转图开关回复等)→ 强制纯文字
WebView2 渲染失败 → 自动回退纯文字(连续失败会熔断,重启宿主恢复)
会转图的消息
菜单、签到结果、便民查询、AI 聊天回复、发言统计等非交互纯文字回复,只要字数达标都会转图;普通文字走 GDI+,含彩色 Emoji 时自动切换 WebView2。
🎛️ 六、控制台参数详解
控制台 →「文字转图片」页,所有参数修改后点「保存配置」立即生效(预览无需先保存)。
排版与尺寸
| 参数 | 默认值 | 范围 | 说明 |
|---|---|---|---|
| 字体 | 微软雅黑 | 系统已装字体 | 建议用系统自带中文字体 |
| 字号 | 24px | 10~72 | 正文字号 |
| 加粗 | 关 | — | 整体加粗 |
| 清晰度缩放 | 2x 超清 | 1x~3x | 倍率越高图越大越清晰,手机上显示更大;2x 为推荐值 |
| 宽度模式 | 自适应文字 | — | 见下方详解 |
| 最大宽度 | 760px | 320~1600 | 自适应模式下的换行上限 |
| 固定宽度 | 720px | 320~1600 | 固定模式下的图片宽度 |
| 内边距 | 36px | 0~120 | 文字与图片边缘的距离 |
| 行间距 | 10px | 0~40 | 行与行之间的额外距离 |
宽度模式详解
| 模式 | 效果 | 适合场景 |
|---|---|---|
| 自适应文字(推荐) | 图片宽度刚好贴合最长一行文字,短回复生成窄图,绝不留大片空白 | 菜单、短句、大部分场景 |
| 固定宽度 | 图片宽度固定,文字自动换行 | 长文章、需要统一卡片宽度的场景 |
彩色配色
每行随机彩色(默认开):从色池中给每一行随机上色,色池支持自定义增删(取色器 + 色值)
关闭后:全部文字使用固定基色(默认
#333333)背景色:卡片背景,默认白色
#FFFFFF
测试预览
底部输入任意文字(支持 emoji),点「生成预览」即时看到真实渲染效果——预览与实际发送使用同一渲染引擎和模板,所见即所得。
❓ 七、常见问题
Q1:emoji 显示成方块/黑白轮廓?
说明渲染回退到了 GDI+ 引擎(WebView2 未就绪)。排查顺序:
Windows 设置 → 应用 → 搜「WebView2」确认已安装 Evergreen Runtime(Win10/11 一般自带)
看控制台日志中
[T2I]开头的诊断行,会写明具体失败原因重启 UniQQ 宿主后重试(连续失败熔断后重启可恢复)
Q2:为什么有的回复没转图?
对照第五章触发条件:最常见原因是消息里带了 CQ 码(如 @人、图片)或字数不足 6 字。
Q3:图片在手机上显示太小?
把「清晰度缩放」调到 2x(默认)或 3x;同时确认「宽度模式」是自适应——自适应模式短文本会生成窄图,实际显示比例更大。
Q4:渲染会卡机器人吗?
正常不会。渲染在独立后台线程排队执行,每张图几百毫秒;失败自动回退文字,不会阻塞消息处理。
Q5:临时图片会占磁盘吗?
不会。图片在系统临时目录,2 小时后过期,插件每次渲染都会顺手清理过期文件。
🔗 八、相关页面
控制台「文字转图片」页:全部参数 + 实时预览
控制台「使用帮助」页:CQ 码写法
05-指令大全.md:全部群内指令速查
07-常见问题FAQ.md:其他问题排查