本页内容
微信里的「人物卡」到底是什么
微信本身没有人物卡功能。微信开放的是 ClawBot 插件通道,人物卡由通道背后的服务来解释 —— 在微伴里,它就是「角色扮演」插件的一份配置。
所以链路是这样的:
- 你手里有一张角色卡(V2 JSON,或带
chara元数据的 PNG)。 - 微伴把卡里的文字设定读成一份角色配置,保存到你的账户下。
- 你在微信里用快捷名进入这个角色,之后的对话由你为它绑定的模型回答。
这里有两个容易误解的地方:人物卡不等于图片,PNG 只是把 JSON 藏进图片的容器;角色回答用什么模型,与卡本身无关,取决于你在微伴里为这个角色绑定哪个模型。
导入:两种文件,几个硬限制
支持两种来源:
- V2 JSON 角色卡:文件不超过 64 KB。
- PNG 角色卡:图片不超过 5 MB,必须带有
chara文本块(V2 角色卡通常导出成这种格式),解码后的文字信息不超过 64 KB。
| 项目 | 限制 | 超限时的表现 |
|---|---|---|
| PNG 文件大小 | ≤ 5 MB | 提示「角色卡文件不能超过 5 MB」 |
| PNG 文字信息 | ≤ 64 KB | 提示文字信息不能超过 64 KB |
| JSON 文件大小 | ≤ 64 KB | 提示「JSON 角色卡不能超过 64 KB」 |
| 格式 | Character Card V2 | 提示只支持 chara_card_v2 / 2.0 |
| 世界书条目 | ≤ 50 条 | 提示世界书最多支持 50 条 |
| 一份角色配置 | 整体 ≤ 120 KB | 提示减少设定或世界书内容 |
文件在你的浏览器里解析,只有若干段有长度上限的文字设置会提交到接口,PNG 封面本身不会上传保存。遇到「未找到 V2 角色信息」时,先确认 PNG 里是否真的有 chara 元数据,或改用 JSON 导入。
字段对照:卡里有什么,微伴读什么
| 角色卡字段 | 对应到微伴里的设置 |
|---|---|
data.name | 姓名 |
data.description | 描述;为空时用 personality 兜底 |
data.personality | 性格 |
data.scenario | 场景 |
data.first_mes | 开场白 |
data.mes_example | 对话示例 |
data.system_prompt | 指令 |
data.post_history_instructions | 后置指令 |
data.character_book.entries | 世界书条目 |
data.character_book.token_budget | 世界书 token 预算(默认 1000) |
extensions.wechatai | 用户人设、称呼与头像标识 |
有两项不属于角色卡:快捷名和绑定模型。它们是平台侧设置,导入时用你当前选择的模型和快捷名,导出的 V2 JSON 也不会写这两个字段。换设备或换微信重新导入时,需要重新选择。
卡里的扩展内容不会执行。备用开场白、标签、作者等字段只保留在原始 JSON 中,不参与对话;宏只替换 {{char}} 和 {{user}},其他写法会当作普通文字。
世界书:靠关键词注入,不是全文塞进去
世界书是人物卡的记忆库。微伴不是把整本世界书塞进每次请求,而是按关键词挑出相关条目,在 token 预算内注入:
- 最多 50 条,token 预算默认 1000(可调整)。
- 每条可以设关键词、次关键词、常驻、大小写敏感与优先级。
- 常驻条目每次都带;其余条目在对话命中关键词时才注入。
- 预算按优先级分配,超出预算的条目不会进入这一次请求。
从角色卡导入时,部分写法会降级:正则触发的条目、没有关键词的非常驻条目会被停用,需要你手动补关键词再启用;递归触发、概率、脚本和自定义插入位置都不支持。导入后界面会列出这些提示,建议先看一遍再开始聊。
在微信里用快捷名切换角色
配好角色并保存后,在微信里:
- 发送
/use 快捷名(例如/use 林)进入这个角色,之后的每句话都由它回答。 - 发送
/exit回到普通模型会话。 - 发送
@林 内容只临时调用一次,不改变当前模式。
每个角色单独绑定模型,所以「写作用一个便宜模型、角色对话用一个更强的模型」是可以并存的。/wx new 会为当前角色开一段独立剧情,旧剧情保留;长对话会自动整理剧情摘要,角色设定本身始终保留。
插件名额有限:免费版只能配 1 个插件,Plus 插件不限。一个角色就占一份插件配置,多个角色前先确认套餐。
导出与原始卡再下载
编辑之后可以「导出 V2 JSON」,把当前设置写回角色卡:姓名、头像标识、用户人设、描述、性格、场景、开场白、对话示例、指令、后置指令和世界书都会写进去,已有的扩展字段(如备用开场白、标签、作者)也保留。
如果这个角色来自导入,还可以再下载一次原始角色卡,适合在别处继续使用或做备份;手写的角色没有来源卡,导出的是新生成的 V2 JSON。
注意导出的是文字设定,不含 PNG 封面,也没有快捷名与绑定模型。
常见问题
微信聊天人物卡是什么格式?
目前支持 Character Card V2(chara_card_v2 / 2.0):带 chara 元数据的 PNG,或 V2 JSON 文件。旧的 V1 卡片和其他格式需要先转换为 V2 再导入。
PNG 角色卡导入失败怎么办?
按提示逐项检查:PNG 里是否有 chara 文本块、是否重复写入、解码后文字是否超过 64 KB、图片是否超过 5 MB、格式声明是否为 V2。仍失败时改用 JSON 角色卡导入。
世界书最多支持多少条?
最多 50 条,token 预算默认 1000,可以调整。世界书按关键词和常驻开关注入,正则触发、递归触发和脚本类写法不被支持,导入时会被停用。
一个角色可以换模型吗?
可以,每个角色单独绑定模型,改绑后新回复由新模型生成,旧记录保留但不自动共享上下文。换模型后建议用 /wx new 开始新一段剧情。
导入时会保存 PNG 封面吗?
不会。微伴只读取卡里的文字设定,PNG 图片本身不上传保存,头像使用微伴预设的头像标识。想保留封面请自己保存原文件。
用自己的 API Key,今晚就能在微信里用上
注册后添加模型渠道,扫码连接微信。模型调用费用由你的 API 服务商另行收取。
免费开始本页更新于