若角色卡片无法加载,可依次尝试四种导入方式:一、本地文件导入,需utf-8编码json文件;二、二维码扫描,核对角色id末四位;三、角色市场一键加载,认准官方认证;四、剪贴板粘贴代码,须补全avatar_url等核心字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜

如果您在猫箱中希望快速启用已有设定的角色,但角色卡片无法正常加载,则可能是由于卡片格式不兼容、路径错误或未完成授权验证。以下是导入角色卡的具体操作步骤:
一、从本地文件导入角色卡
该方法适用于已拥有符合猫箱规范的JSON格式角色卡文件(如从社区下载或他人分享),需通过系统文件管理器定位并加载。
1、确保角色卡文件为标准UTF-8编码的.json后缀文件,且文件名不含特殊符号或空格。
2、打开猫箱App,进入「我的」页面,点击右下角「我的」图标。
3、在「我的」页面中滑动查找并点击「导入角色卡」选项(若未显示,请先更新至v1.59.0及以上版本)。
4、系统将跳转至手机文件管理界面,请手动导航至存储该.json文件的文件夹,长按文件并选择“用猫箱打开”。
5、确认弹窗中的角色名称与描述无误后,点击「立即导入」,导入成功后该角色将出现在「我的角色」列表中。
二、通过二维码扫描导入角色卡
该方式适用于创作者公开分享的可扫码角色卡,无需手动查找文件,支持跨设备快速同步。
1、在猫箱首页右上角点击「+」号,选择「扫描导入」功能。
2、对准角色卡发布者提供的动态二维码(有效期为24小时),保持镜头稳定直至识别完成。
3、识别成功后,页面自动展示角色预览图与基础参数,注意核对「角色ID」末四位是否与发布页标注一致,防止中间人替换。
4、点击「确认导入」,系统将自动校验签名并写入本地角色库。
三、从猫箱角色市场一键加载
该方式调用官方审核过的角色卡片资源,免格式校验,适合新手及追求稳定性的用户。
1、在猫箱首页点击底部导航栏「发现」,进入角色市场主页。
2、使用顶部搜索框输入关键词(如“古风剑客”“赛博猫娘”),或点击分类标签筛选目标类型。
3、找到目标角色卡片后,点击进入详情页,确认右上角显示「官方认证」徽章及「支持一键加载」提示。
4、点击「加载到我的角色」按钮,等待进度条完成,角色即刻可用。
四、通过剪贴板粘贴角色卡代码导入
适用于开发者或高级用户直接编辑角色参数,支持实时调试与微调,需手动补全必要字段。
1、复制完整角色卡JSON代码(须包含"version"、"name"、"personality"、"avatar_url"等核心键)。
2、返回猫箱「我的」页面,点击「导入角色卡」→「粘贴代码导入」。
3、在文本框内长按并选择「粘贴」,系统自动高亮标出缺失字段或语法错误行。
4、必须补全"avatar_url"字段(可填占位图链接如https://via.placeholder.com/200)才能通过校验。
5、点击「解析并导入」,成功后角色将带「自定义代码」标签存入本地库。










