角色卡是什么？
角色卡是保存 AI 角色设定的文件，通常包含角色名称、人设、场景和开场白，有些卡还会携带世界书、脚本或其他扩展数据。酒馆用户常说的「导入角色卡」，就是把这些设定带进自己的聊天客户端。
Tellev 支持导入酒馆格式的角色卡，之后由你配置的模型服务生成回复。角色卡本身不是模型，也不附带 API 密钥或免费聊天额度。
支持哪些角色卡格式？
| 格式 | 导入时要注意什么 |
|---|---|
| PNG / WebP | 需要包含角色元数据的原始图片文件；截图、压缩或重新保存的图片可能已丢失元数据。 |
| JSON | 应为兼容的角色卡数据文件，普通 JSON 或世界书 JSON 不能当作角色卡使用。 |
| CHARX | 保留完整的角色卡文件，再通过导入功能选择；不要仅改其他文件的后缀。 |
格式支持不代表所有复杂脚本与扩展行为都能完整运行。先备份，再验证。
把电脑上的角色卡带到安卓手机
- 从原来的工具导出角色卡，或取得你有权使用的原始角色文件。
- 将文件传到手机。图片角色卡尽量作为文件传输，避免图片压缩丢失元数据。
- 打开 Tellev 的「角色」页，使用导入功能并选择该文件。
- 检查角色名、人设、开场白和相关设定是否正确。
- 确认已配置模型服务，再回到「聊天」页选择角色并发送消息。
如果尚未连接模型，先阅读模型 API 配置步骤。
没有角色卡，也可以自己创建
在「角色」页新建角色，先写清姓名、人设和开场白。建议从简短设定开始，确认基本聊天正常，再逐渐补充背景与规则。
Tellev 也提供「AI 创建」协助起草角色。AI 创作同样依赖你配置的模型服务，生成结果可以继续检查和编辑。世界背景较多时，可用世界书单独管理。
复杂角色卡的兼容范围
Tellev 实现了部分酒馆脚本与数据兼容能力，但不是桌面 SillyTavern 的完整复刻。依赖特定插件、服务器能力或特定前端运行环境的角色卡可能无法直接使用。
不要把「支持 PNG 角色卡」理解为「支持这张卡的所有依赖」。先用简短角色测试模型连接，再导入复杂卡；若只有某张卡异常，应检查其附带的脚本、世界书、预设和扩展要求。
具体范围以项目兼容性说明与实际使用结果为准。
导入与聊天问题怎么排查？
图片能打开，却导入不了角色
先确认它是含角色数据的原始文件，而非截图或封面图。重新获取原文件，避免经压缩或编辑工具保存后再导入。
导入成功，却没有回复
检查服务地址、API 密钥、模型名、网络与服务额度。先试用一个简单角色，区分模型连接问题和卡片兼容问题。
能聊天，但内容、排版或脚本不对
检查角色依赖的世界书和预设是否导入、字段是否受支持。复杂消息前端与脚本存在兼容差异。反馈时说明版本、操作步骤和现象，移除私人内容与密钥。