Skip to content

技能库 - 生图打印 ​

「生图打印」是一项系统技能:用户用自然语言描述想要的画面(「画一只戴帽子的小猫」「打印一张我的姓名贴」),由大模型实时生成一张黑白线稿图,先上屏展示,经用户确认后再下发到热敏打印机打印出来。

本技能是平台首个参数化系统技能 —— 与「只读型」(如 健康问答)、「提示词开放型」(如 视觉问答)不同,它向品牌方开放一组结构化参数(图片格式、是否打印、是否闭麦、预览 / 打印尺寸),但不开放提示词编辑、不开放模型选型、不开放流程编排。

启用方式详见 技能配置。

⚠ 打印能力依赖设备侧热敏打印机与打印协议对接,需设备开发;不带打印机的设备也可只用「生图上屏」部分。

📘 端侧协议与硬件接入请参见技术说明书 §6.3 魔法打印接入 —— 按键 A/B 三态机、contentType = PRINT 的下行事件(IMAGE_DISPLAY 图片上屏 / PRINT_START 开始打印 / PRINT_STOP / PRINT_CONFIG)即本技能的落地通道。

1. 线上交互逻辑 ​

1.1 一次完整任务 ​

用户描述想画的东西 → (必要时追问一次细节)→ 生图(约 8 秒)→ 上屏并问「要打印吗」→ 用户确认 → 打印
环节现状逻辑
触发方式仅用户主动发起。用户话术中含明确的绘画 / 打印诉求时命中本技能
典型轮次三次开口:描述画面 → 回答追问 → 回答「是否打印」。描述足够完整时可少一轮;姓名贴未给出文字时多一轮
追问时机在生图之前,且全程只启发一次 —— 抛一个封闭式细节问题,用户任何回应后立即锁定画面内容,不再反复澄清
生图耗时约 8 秒。等待期内由陪聊话术兜底,且不开启新一轮对话(用户此时说话不会打断生图)。陪聊不感知生图进度,故建议开启「生图期间禁用 ASR」并由端侧做等待期交互引导,详见 §3
上屏确认出图后先上屏 + 一句报喜话术,结尾必定反问「是否打印」;只有明确同意才打印,「真好看」「好漂亮」这类评价不视为同意,会再问一次
打印完成通知「画好啦」类通知优先级高于进行中的其他对话

1.2 任务内支持的其他说法 ​

用户说法处理
「再打一张」「重新打印」重打上一张图,不重新生图
「换一个,画只小狗」切换画面主体,旧的属性 / 动作 / 场景一并清空重画
「别画了」「不打印了」「退出打印」取消任务并清空状态
「我要打印」(没说画什么)结合此前画过的主体,给 2–3 个同类具体选项做灵感引导
「画好了吗」「没纸了」留在本技能内自然回复,不跳出
「讲个故事」「查天气」「唱首歌」判定为非绘画诉求,自动移交主链路的其他技能

1.3 能力边界(硬约束) ​

约束说明
纯黑白、无灰阶出图前统一二值化,只保留纯黑 / 纯白。原因是热敏打印头的物理限制(大面积深色会加速打印头损耗并触发过温保护),任何配置都不可放开。用户描述里的颜色词在生成环节被剥离
画面类型内容按纯图 / 图文混排 / 姓名牌三类判别,各套专属排版规则;该判别与扩写规则当前走定制交付,不开放自助配置
文字能力文字由生图模型直接画入画面(非后期叠加),适用短字词、名字、气泡短语、物体表面少量嵌字;不适用长文本与固定版面(日程表、打卡表、算术题、识字卡)
画幅横向宽度即纸张宽度(固定),纵向随内容延展,上下留白由模型决定
暂不支持设备在用户未开口时主动插入生图;预制模板 + 文字替换;缺纸预判与打印结果回执

2. 配置项 ​

入口:应用配置 → 技能 → 点击「生图打印」卡片右上角 ✏️ 编辑。配置为应用级,同一技能在不同应用内独立配置、互不影响。

配置项类型取值默认值说明
生图格式单选jpg / pngjpg预览图与打印图使用同一格式
是否支持打印开关开 / 关关开启后,生图完成自动追加打印流程;关闭则链路止于上屏
生图期间禁用 ASR开关开 / 关关(建议开启)开启后仅在生图期间端侧不接收语音输入,详见 §3
预览宽度数字整数,(0, 1024] px512上屏展示用尺寸
预览高度数字整数,(0, 1024] px384上屏展示用尺寸
打印高度数字整数,(0, 1024] px384仅「是否支持打印」开启时显示
打印宽度只读系统自动计算512不可输入,计算规则见 §2.1

默认预览 / 打印尺寸均为 宽 512 × 高 384(4:3)。生图模型对分辨率无整数倍约束,区间内任意整数均可填,不需要凑 8 / 64 的倍数。

2.1 打印宽度计算规则 ​

打印尺寸沿用预览图的宽高比,由打印高度反算打印宽度:

打印宽度 = round(打印高度 × 预览宽度 ÷ 预览高度)
规则说明
取整四舍五入到整数像素
刷新时机预览宽度 / 预览高度 / 打印高度任一项修改并通过校验后,只读值实时重算
前置依赖预览宽高未填写完整时,打印宽度展示为「—」
越界处理反算结果 > 1024 时,打印高度输入框标红报错「当前预览比例下,打印高度最大为 N」(N = floor(1024 × 预览高度 ÷ 预览宽度)),保存按钮置灰;平台不自动截断、不自动等比缩放,需自行调整打印高度

举例:预览 512 × 384 时,打印高度填 300 → 打印宽度 = round(300 × 512 ÷ 384) = 400;打印高度填 1024 → 反算 1365 已越界,报错提示最大可填 768。

2.2 校验与生效 ​

场景处理
尺寸为空 / 非整数 / 越界字段级报错,保存按钮置灰
「是否支持打印」由开改关并保存保留已填的打印尺寸值(仅隐藏),再次开启时回显
生效时机保存并发布后生效;运行中的会话按下一轮生效
配置缺失读取到的尺寸为空时,按平台默认 宽 512 × 高 384 出图

2.3 本期不开放 ​

  • ❌ 生图提示词编辑(提示词由平台内部固化构造)
  • ❌ 文生图模型选型(平台代选)
  • ❌ 流程节点的查看与编辑
  • ❌ 打印份数、灰度 / 抖动算法、打印浓度、纸型、打印方向等打印固件参数(属设备侧配置,不在技能面板)
  • ❌ 关联知识库

3. 「生图期间禁用 ASR」怎么选 ​

生图约 8 秒,这段时间端侧是否收音,对应两套完全不同的体验:

取值端侧行为用户此时说话代价
开(推荐)进入生图前闭麦,出图即恢复(打印阶段不闭麦)这 8 秒内不被拾音,无任何回复生图期间的催促 / 取消 / 反馈收不到,需端侧用视觉或声音反馈补齐「正在画」的感知
关(平台默认值,线上现状)保持收音由等待期陪聊话术兜底回复陪聊不感知画作进度,容易出现答非所问,整体体验不佳

闭麦仅覆盖生图阶段,打印阶段始终正常收音 —— 这样用户在打印时仍可反馈「没纸了 / 卡纸了 / 再打一张」。

3.1 选型建议:建议开启,并由端侧做交互引导 ​

建议开启「生图期间禁用 ASR」。 虽然平台默认值为「关」(保持线上现状兼容),但等待期的陪聊兜底并不感知生图进度,用户在这 8 秒里催促「画好了没」时,陪聊可能给出与画作无关甚至矛盾的回复,体验明显劣于「安静等待 + 明确的等待反馈」。

开启后,端侧必须把「正在画」这件事表达清楚,否则用户会以为设备卡死。建议至少做到:

端侧动作说明
等待态视觉反馈屏幕上展示「正在画…」的加载动画 / 进度态画面,持续到图片上屏(约 8 秒)
指示灯 / 状态区分用灯效或图标把「闭麦等待中」与「可以说话」区分开,避免用户对着设备反复说话
恢复收音的提示图片上屏(收到图片上屏事件)即恢复收音,建议同时给出可交互的提示,引导用户回答「要不要打印」
超时自恢复若长时间未收到图片上屏,端侧按自身超时机制自动恢复监听,不要停留在闭麦态

若硬件没有屏幕或灯效等任何等待期反馈手段,且已接入等待期陪聊,可暂时保持「关」;但需知悉陪聊话术与画作进度相互独立,存在答非所问的概率。

4. 异常与边界 ​

情况平台处理
生图模型超时 / 失败返回兜底话术,不进入打印流程
打印环节服务端失败(图片转换 / 指令封装 / 下发通道异常)返回兜底话术
打印指令已下发但端侧没印出来平台不可感知。打印是单向下发,下发成功即判定成功,不等回执、不重试
端侧无打印机却开启了「是否支持打印」打印指令照常下发、端侧忽略;平台不做硬件能力校验,需配置者自行对齐硬件
缺纸 / 卡纸 / 过热 / 低电量平台无法预判,打印指令照常下发;仅当用户自己口述「没纸了」时,由话术层如实告知并引导找家长装纸
闭麦恢复指令丢失端侧按自身超时机制自动恢复监听,平台不做重试

5. 端侧协议对接要点 ​

本技能复用技术说明书 §6.3 魔法打印接入 的打印协议(contentType = PRINT)。下表说明本技能当前链路实际用到哪些事件:

方向事件本技能是否使用说明
下行IMAGE_DISPLAY✅ 使用生图完成后图片上屏展示,端侧必须实现
下行PRINT_START✅ 使用用户确认打印后下发,端侧完成打印
下行PRINT_STOP◻ 暂不使用本技能按单张图片任务下发,不做任务中断
下行PRINT_CONFIG◻ 暂不使用打印浓度 / 纸型 / 方向等固件参数不在技能面板开放(见 §2.3),由设备侧自行设定
下行PRINT_STATUS_QUERY◻ 暂不使用平台不做打印机状态查询与硬件能力校验
上行PRINT_STATUS⚠ 预留通道,暂未使用端侧可按协议上报,但平台当前不消费:缺纸 / 过热 / 低电量不会影响对话链路与打印下发
上行PRINT_SUCCESS⚠ 预留通道,暂未使用打印为单向下发、不等回执,平台当前不消费该回执
上行PRINT_IMAGE⚠ 预留通道,暂未使用本技能的打印由语音确认触发;物理按键触发打印属端侧自有逻辑,平台当前不依赖此上行事件

对上行事件的建议:三个上行事件均为协议预留,端侧可暂不实现,不影响「生图打印」技能完整跑通;若已实现也无需下线 —— 平台只是当前不消费,后续能力开放时可直接复用。

相应地,缺纸 / 卡纸 / 打印机离线 / 打印失败等情况需由设备侧自行提示用户(屏幕、灯效或本地语音提示),平台侧无法感知、不会主动播报(见 §4)。

6. 常见问题 ​

  • Q:能打印彩色图吗? 不能。出图前统一二值化为纯黑白,这是热敏打印头的物理限制,不随配置放开,也不随设备型号放开。
  • Q:能打印日程表、算术题、识字卡这类版面吗? 不建议。文字由生图模型直接画进画面,只适合短字词、名字、气泡短语;长文本与需要精确字形 / 固定版面的内容效果不可控,这类需求需走「预制模板 + 文字替换」路线,当前未开放。
  • Q:预览和打印必须用同一个尺寸吗? 不必须,这正是本技能开放两组尺寸的原因:屏幕展示与纸张打印可用两套不同尺寸。但打印宽高比沿用预览,只能调打印高度、宽度由系统反算。
  • Q:打印宽度为什么不能手填? 为保证上屏所见与打印所得构图一致,打印尺寸强制沿用预览比例,宽度由公式反算,避免出现拉伸变形。
  • Q:关闭「是否支持打印」后技能还能用吗? 能。链路止于生图上屏,适合只有屏幕、没有打印机的设备。
  • Q:设备侧需要做什么? 上屏展示(IMAGE_DISPLAY)与打印下发(PRINT_START)需端侧对接打印协议并实现热敏打印驱动,协议详见技术说明书 §6.3 魔法打印接入;若只用生图上屏,则只需支持图片展示。三个上行事件(PRINT_STATUS / PRINT_SUCCESS / PRINT_IMAGE)为预留通道、平台当前不消费,可暂不实现,详见 §5。
  • Q:生图那 8 秒一定要闭麦吗? 不是强制,但建议开启。等待期陪聊不感知画作进度,用户催促时容易答非所问;开启闭麦后请由端侧补齐「正在画」的加载动画 / 灯效等交互引导,并在图片上屏时恢复收音,详见 §3.1。
  • Q:能改生图提示词或换模型吗? 不能。本技能只开放 §2 的结构化参数,提示词与模型由平台固化。