让小说角色活起来:ColorTxt AI角色卡生成与文生图立绘完全教程

原创2026-10-10 13:02:182,206 阅读
文章标签:桌面应用AI 应用语音本地部署

让小说角色活起来:ColorTxt AI角色卡生成与文生图立绘完全教程

ColorTxt(彩读 3.0)是一款支持 AI 角色卡与文生图立绘的本地 TXT 小说阅读器。今天这篇教程带你从零上手:用 AI 检索一键生成角色卡,再用文生图为每个角色生成专属立绘,让笔下的主角真正"活"起来,带给你不一样的阅读体验。

ColorTxt 角色卡侧栏:AI 检索与文生图立绘展示

角色卡能做什么?

打开任意一本 TXT 小说,点击侧栏活动栏的 「角色」 标签,你就能看到角色卡网格:每张卡片正面是角色立绘与姓名角标,翻到背面是年龄、身份、简介等信息。

它的核心玩法有三个:

  • 🧠 AI 检索:输入角色名,AI 自动通读全书,检索外貌描写、年龄推断、身份关系,生成结构化角色卡
  • 🎨 文生图立绘:AI 将「画风 + 角色形象」整理成提示词,调用文生图接口绘制角色立绘
  • ✨ 闪卡效果:卡片支持 3D 倾斜、全息光泽等 11 种纹理特效,还有专属音色朗读

接下来按「准备 → 检索 → 出图 → 玩法」四步走。

准备工作:开启 AI 阅读助手

角色卡依赖两个配置,都在 设置 里完成:

  1. 对话模型(设置 → AI 阅读助手):打开 AI 总开关,在服务商下拉中选择预设(本地 LM Studio / Ollama / DeepSeek / 通义 / 智谱 / Kimi 等),填入 API 密钥,点 测试连接 验证可用。
  2. 向量模型(设置 → 向量模型):AI 检索需要全文检索(RAG)能力。新手推荐 内置本地模型(如 BGE Small ZH v1.5,约 47 MB,点「下载」即可),首次使用需对当前书 建索引;也可配置远程嵌入 API。

💡 向量模型会在本地建立「小说内容搜索引擎」,检索过程不消耗 Token,只把最相关的片段发给对话模型,省钱又快速。

配置面板详见 SettingsTxt2ImgPanel,AI 总览可参考 docs/AI功能.md。

AI 检索:一键生成角色卡

准备好后,侧栏 「角色」→ 添加角色,输入角色名(如「小龙女」),点 「AI 检索」:

ColorTxt 角色卡 AI 检索界面:自动汇总角色外貌与身份

AI 会自动完成这些事:

  • 🔍 按「角色名 + 外貌/身穿/绰号」等组合查询全文,检索结果实时展示
  • 📋 汇总 年龄推断、外貌汇总、身份、简介、关系,自动填入卡片背面字段
  • 🎭 顺带抽取 经典台词,作为角色专属音色的试听句
  • 📊 底部展示本次消耗的 Token 与花费估算

检索完成后,你可以手动补充 别名(支持多别名,检索时一并识别)、性别、关系 等字段,点 保存修改 即可。角色数据结构定义在 characterTypes.ts,AI 检索管线实现见 useCharacterPortraitRetrieve.ts。

文生图:为角色生成专属立绘

角色卡生成后,在编辑抽屉中点 「立绘生成」,弹出 角色立绘生成 窗口:

ColorTxt 文生图立绘生成弹窗:画风、角色形象与生成预览

  • 画风(本书通用):AI 会根据全书文笔自动推断画风(如「水墨淡彩,烟水蒙蒙,古风典雅」),全书角色共用,保证立绘风格统一
  • 角色形象:即 AI 检索得到的外貌描述,可直接编辑微调
  • 负面描述:SD 系后端可用,用于排除不想要的元素

点 生成 → 等待预览图出现 → 点 应用,立绘就贴到卡片上了。不满意可以随时重新生成。生成的提示词会自动持久化,立绘文件保存在立绘缓存目录(默认 userData/CharacterPortrait,按书名分子目录),主进程由 characterPortrait.ts 与 characterPortraitFs.ts 负责出图与落盘。

支持哪些文生图服务商?

在 设置 → 角色卡 中选择预设,接口地址会自动填好:

服务商 适合人群
本地 WebUI(A1111) 本地 Stable Diffusion 玩家,免费无限出图
本地 ComfyUI 工作流玩家,需粘贴 API 格式工作流
OpenAI Images 有 OpenAI 密钥的用户
阿里云通义万相 国内云端首选,按量计费
MiniMax / Stability AI / Agnes AI 各家云端图像模型
自定义 OpenAI 兼容服务 对接任意兼容网关

云端方案记得填 API 密钥(加密存于本地保险库,不落明文),并点 测试连接——测试只校验密钥,不出图、不消耗额度。

进阶玩法:闪卡效果与角色卡分享

  • ✨ 卡片效果:侧栏「角色」→ 卡片 更多 → 卡片效果,可在细腻光泽、梦幻竖纹、星云幻彩等 11 种闪卡纹理间切换,鼠标悬停时卡片会 3D 倾斜反光
  • 🔍 原位放大:点卡片角上的放大镜,立绘原地放大查看细节,支持正反面翻转
  • 📦 导入导出:角色卡支持一键导出为角色卡包、从其他书导入,搭配「书包」(.ctz)可连同立绘一起跨设备同步
  • 🎙️ 专属音色:在角色编辑抽屉中为角色指定朗读音色,配合语音朗读的多音色功能,实现"角色开口说话"

角色卡网格、导入导出逻辑见 CharacterSidebarPanel.vue,立绘生成弹窗见 CharacterPortraitGenerateModal.vue。

常见问题快速排查

Q1:点「AI 检索」提示无法检索? 检查向量模型是否启用、是否已对本书建索引。内置模型未下载时会被拦截,先到「设置 → 向量模型」点下载。

Q2:立绘风格与小说不符? 优先修改「画风(本书通用)」,SD 系后端可在「负面描述」中排除元素;也可更换文生图服务商对比效果。

Q3:文生图生成失败? 点「测试连接」确认地址与密钥无误;本地 WebUI 请确认已启动且地址为 http://127.0.0.1:7860;云端注意余额是否充足。

Q4:换模型后角色卡会丢吗? 不会。角色数据按书持久化在本地,与模型解耦;立绘图片独立存储在缓存目录,换后端只是换"画师"。


现在,打开你的小说,让 AI 把那些只存在于文字里的角色,一张张变成有脸、有声音的「角色卡」吧!

登录后查看全文
ColorTxt