文字转图片功能详解
开启后,机器人发出的纯文字回复会自动在本地渲染成一张精美的彩色卡片图再发送。本篇讲解工作原理、开启方法、触发条件、控制台参数与常见问题。
🖼️ 功能是什么
文字转图片:机器人发出的纯文字回复自动渲染为彩色卡片图再发送。
- 每行随机彩色(内置 7 色池),支持彩色 emoji;
- 宽度自适应文字,不留大片空白;
- 部分客户端把整段文字显示得密密麻麻,图片化后排版精致、手机上显示更大更清晰,同时能降低风控(大段文字容易被判定为刷屏消息)。
⚙️ 工作原理
渲染流程:纯文字回复 → 保护链接、邮箱、@ 与 CQ 消息 → 普通文字用 GDI+ 高速渲染成 PNG,含彩色 Emoji 时切换 WebView2 渲染 → 自动上传并发送 → 渲染或发送失败自动回退为普通文字。
| 引擎 | 说明 |
|---|---|
| GDI+ 高速引擎 | 普通纯文字默认使用,启动快、资源占用低,支持字体、字号、换行、背景与随机行彩色 |
| WebView2 Emoji 引擎 | 内容含彩色 Emoji 时启用 Chromium 离屏渲染,保留表情颜色与组合字形,失败自动回退 GDI+ |
三个重要机制:
- 全程本地渲染:图片在本机生成,不经过任何第三方服务器;
- 自动回退:渲染失败或图片发送失败自动改为普通文字,聊天永不中断(连续失败会熔断,重启宿主恢复);
- 临时文件自动清理:图片保存在系统临时目录,超过 2 小时自动过期清理,不占磁盘。
🚀 使用方法
| 方式 | 操作 |
|---|---|
| 群内指令 | 发 开启文字转图片,最快 |
| 控制台开关 | 控制台「文字转图片」页 → 打开「启用功能」→ 保存配置 |
| 实时预览 | 页面底部输入文字点「生成预览」,所见即所得,调好后保存 |
关闭发 关闭文字转图片 或在控制台关闭开关;发 文字转图状态 可查看当前参数(字体、配色、宽度、字数范围等)。
TIP
转图指令已收录进「发送模式」子菜单;指令本身的开关回复永远以纯文字发送,不会转图。
📋 指令一览
| 指令 | 权限 | 说明 |
|---|---|---|
开启文字转图片 | 主人 | 打开转图开关,立即生效 |
关闭文字转图片 | 主人 | 关闭转图开关 |
文字转图状态 | 主人 | 查看字体 / 配色 / 宽度 / 字数范围等当前参数 |
🎯 触发条件
一条回复要被渲染成图片,必须同时满足:
| 条件 | 默认值 | 控制台可调 |
|---|---|---|
| 全局开关已开启 | 关闭 | ✅ |
| 内容为纯文字(不含任何 CQ 码) | — | — |
| 字数在范围内 | 6~600 字 | ✅ |
| 不含链接、邮箱或 @ 提及 | — | — |
不会转图的情况:
- 含 CQ 码的消息(图片、@人、语音、音乐卡片、骰子等)→ 保持原样;
- 含网址、裸域名或邮箱 → 保持文字,链接仍可点击和复制;
- 含 @ 提及 → 保持文字并保留真实提醒能力;
- 字数不足 6 字(如「好的」)或超过 600 字 → 原样文字发送;
- 功能性回复(如转图开关确认)→ 强制纯文字;
- 渲染失败 → 自动回退纯文字。
会转图的消息:菜单、签到结果、便民查询、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 显示成方块 / 黑白轮廓 | 说明回退到了 GDI+ 引擎(WebView2 未就绪):确认系统已安装 WebView2 Evergreen Runtime(Win10 / 11 一般自带);查看控制台日志中 [T2I] 开头的诊断行;重启 UniQQ 后重试 |
| 为什么有的回复没转图 | 对照触发条件,最常见原因是消息里带了 CQ 码(如 @人、图片)或字数不足 6 字 |
| 图片在手机上显示太小 | 把「清晰度缩放」调到 2x(默认)或 3x,并确认「宽度模式」为自适应 |
| 渲染会卡机器人吗 | 正常不会,渲染在独立后台线程排队执行,每张图几百毫秒,失败自动回退,不阻塞消息处理 |
| 临时图片会占磁盘吗 | 不会,图片在系统临时目录 2 小时后过期,每次渲染都会顺手清理过期文件 |
📚 下一节:AI 审核 Token 消耗与成本优化
