跳到正文
角色卡 × 微信

微信聊天人物卡:从角色卡到微信对话

「人物卡」不是一个微信功能,而是角色扮演里对角色设定的叫法。真正要解决的问题是:卡里的那些字段,怎么变成微信里一段稳定的对话。

  • 支持 PNG 与 V2 JSON
  • 每个角色可绑不同模型
  • 原始角色卡可再下载

在微信里使用人物卡,需要先启用微伴的「角色扮演」插件,再导入 Character Card V2 格式的 PNG(读取 PNG 文本块中的 chara 元数据)或 V2 JSON 文件。导入后姓名、描述、性格、场景、开场白、对话示例、指令与用户人设会进入角色设置,世界书按关键词注入;每个角色可以绑定不同模型,在微信里用快捷名切换。

本页内容

微信里的「人物卡」到底是什么

微信本身没有人物卡功能。微信开放的是 ClawBot 插件通道,人物卡由通道背后的服务来解释 —— 在微伴里,它就是「角色扮演」插件的一份配置。

所以链路是这样的:

  1. 你手里有一张角色卡(V2 JSON,或带 chara 元数据的 PNG)。
  2. 微伴把卡里的文字设定读成一份角色配置,保存到你的账户下。
  3. 你在微信里用快捷名进入这个角色,之后的对话由你为它绑定的模型回答。

这里有两个容易误解的地方:人物卡不等于图片,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(可调整)。
  • 每条可以设关键词、次关键词、常驻、大小写敏感与优先级。
  • 常驻条目每次都带;其余条目在对话命中关键词时才注入。
  • 预算按优先级分配,超出预算的条目不会进入这一次请求。

从角色卡导入时,部分写法会降级:正则触发的条目、没有关键词的非常驻条目会被停用,需要你手动补关键词再启用;递归触发、概率、脚本和自定义插入位置都不支持。导入后界面会列出这些提示,建议先看一遍再开始聊。

在微信里用快捷名切换角色

配好角色并保存后,在微信里:

  1. 发送 /use 快捷名(例如 /use 林)进入这个角色,之后的每句话都由它回答。
  2. 发送 /exit 回到普通模型会话。
  3. 发送 @林 内容 只临时调用一次,不改变当前模式。

每个角色单独绑定模型,所以「写作用一个便宜模型、角色对话用一个更强的模型」是可以并存的。/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 服务商另行收取。

免费开始

本页更新于