角色卡提取工具 v5.11.0
导入小说 · 扫描角色 · 按模板抽取角色卡
01 接口设置
支持两种格式：OpenAI 兼容中转，或 Gemini 原生代理。纯浏览器直连，需接口支持跨域（CORS）。设置本机保存。
高级参数
自定义提示词（进阶）
02 导入小说
支持 TXT 纯文本及 EPUB 电子书。工具只在本机处理，小说内容仅发送给你所填的接口做分析。
03 选择角色
已经知道要给谁做卡，直接手动输入名字即可（跳过扫描、最省 token）；不确定有谁再用「扫描」浏览全书。同一角色因昵称没合并时，选中它们点「合并所选」。
04 生成角色卡
选好角色后生成角色卡。
user 设置（把「你」写进角色的世界）
在上方角色列表里可点选多个角色，会一次批量抽取、合并到同一份输出里。
提示：模型抽取难免有偏差，建议生成后对照原文核对一遍再用。
05 生成 user 人设
生成一份「你」在这本小说里的人设（酒馆的用户角色 / persona）。填下面的设定，AI 会把你自然地写进这个世界，并交代好你和角色的关系。
用法：复制后粘贴到酒馆的「用户角色（Persona）」里即可。填的设定是你的，AI 只负责把它写得贴合这个世界——不会瞎改你定的名字、性别这些硬设定。
06 生成世界书
从全书提取世界观 / 势力 / 地点 / 设定 / 历史等条目，附推荐的酒馆条目设置。可下载成能直接导入酒馆的世界书 JSON，或照预览手动建条目。
user 设置（世界书里也把「你」写进去）
导入方式：酒馆 → 世界信息 → 导入，选下载的 .json 即可。核心世界观默认设为常驻（蓝灯），具体条目设为关键词触发（绿灯）。
07 文风蒸馏
抽样分析全书写作风格（视角 / 句式 / 用词 / 节奏 / 情感表达等），产出一份可直接粘贴给 AI 的「文风提示词」，让它照着写出原作风味。只做风格抽象，不摘抄原文。
自定义要求（可选，留空用默认）
08 生成开场白
生成角色卡的开场白（first_mes）——每次开聊时角色发的第一条消息。打包导出时会自动写进角色卡。
开场白会在「打包导出」时自动写进角色卡。也可以复制后自己粘到酒馆角色的「第一条消息」里。用 {{user}} 指代使用者、{{char}} 指代角色。
09 打包导出
流程最后一步：把上面生成好的角色卡、世界书、文风打包成一张酒馆可直接导入的完整角色卡（世界书内嵌绑定，文风自动写入条目）。缺哪部分就只打包已有的。
导入酒馆：角色管理 → 导入角色，选这个 .json，角色卡 + 绑定的世界书 + 文风一并到位。世界书名称可在上面「生成世界书」那栏填。
10 自检
对照原文检查已生成的角色卡 / 世界书条目有没有 OOC、经历互串、与原文冲突的错误，给出问题日志和修正后的成品。先「扫描当前内容」，勾选要查的项，再「开始自检」（只查勾选的，省 token）。不含历史记录。
11 历史记录
每次生成的角色卡会自动存到这里（本机浏览器，最多 30 条）。点「查看」读回上方输出框。
12 报错自查
遇到报错先对照下面几条，多数能自己解决。
Load failed / 网络错误 / 请求发不出去
请求没到服务器，通常是浏览器拦截：① 若用的是 http 接口，别在 https 页面里调（混合内容会被拦）；② 接口需支持跨域（CORS），不支持的换一个；③ 本地接口请确认它确实在运行。与模型、参数无关，别在那上面找原因。
429 / rate limit / 限流
请求太频繁或配额用尽。等一两分钟再试；换限流更宽的模型（如 flash 系）；或检查你所用接口的配额。工具已内置自动重试。
HTTP 500 / do_request_failed / upstream error
服务端错误，通常是你所用中转的上游出了问题（渠道挂了、没该模型、欠费等）。重试几次；点「拉取模型」从它实际支持的列表里选一个；仍不行就换模型或换服务商。
只输出思考、没正文 / content 为 null
思考型模型把 token 花在思考上了。把 max_tokens 调大（思考型建议上万），或改用非思考型 / flash 模型。
解析失败 / 返回为空
模型没按要求只输出 JSON，或内容被安全过滤挡了（成人/暴力题材常见）。看日志里显示的模型实际返回：若是空，多半是被过滤，换限制更宽的模型或渠道；若是乱七八糟的文字，重试或换模型。
导入小说是乱码
编码不匹配。工具会自动尝试 UTF-8 与 GB18030；若仍乱码，用文本编辑器把文件另存为 UTF-8 再导入。
拉取模型失败
该接口可能没开模型列表端点（报 404），或跨域限制。手动填模型名即可。
提示版权 / copyright 相关拒绝
部分模型对处理长篇作品有版权限制，会拒绝。换一个在这方面较宽松的模型来跑小说提取即可；也可把分段调小。