Mochi 麻薯 · 使用指南
从注册登录到扫码接入，从人设、表情包到微信指令速查——这本手册按真实操作顺序， 把每一步都讲明白。面向普通使用者，全程无需写代码。
1初见 Mochi
Mochi 麻薯是一套微信角色扮演平台： 用微信扫一扫接入一台机器人，为它安排 AI 人设，之后朋友在微信里直接和这个角色聊天。
整个平台分两条线，各司其职：
- 网页端（用户中心 /app）——你的操作台。登录注册、管理机器人、 逛人设广场与收藏、管理表情包、连接模型，全都在这里完成。
- 微信端——朋友的入口。给机器人发文字即可和角色对话。
2登录与注册
登录与注册都在用户中心的登录页完成，电脑或手机浏览器都可以。
登录
- 邮箱 + 密码是主要登录方式，输入注册邮箱与密码即可进入。
- 忘记密码时，点登录框下方的「忘记密码」，输入邮箱收取验证码， 即可直接重设新密码。
- 若站点开放了第三方账号登录，登录卡片下方会出现对应入口， 点击即可跳转授权并登录。
登录页提供「邮箱验证码登录」入口：输入邮箱、收取验证码、直接进站， 全程不需要密码。
注册
- 填写注册邮箱，获取并输入邮箱验证码；
- 为自己起一个用户名（以字母开头，3–32 位字母/数字/下划线）；
- 设置密码，完成注册。
注册邮箱是找回账号的唯一凭证，请务必记牢： 重设密码、验证码登录都要靠它。
3四步上手
从注册到朋友开始聊天，只需要四步。
扫码接入
在「机器人」分区点扫码添加，用微信扫一扫，几秒钟完成接入。
挑人设并分配
在人设广场选一个喜欢的角色加入自己的库，再到机器人卡片的「好友与设置」里分给好友。
开聊
好友在微信里给机器人发消息，AI 立刻以角色身份回应，有时会分成几条气泡。
只有你批准过的微信用户才能和 AI 对话； 尚未批准时，机器人会礼貌地请对方先联系你开通。
4管理机器人
所有机器人都在「机器人」分区管理，每台机器人对应一张卡片，卡片上提供以下操作：
- 扫码添加：随时新增一台微信机器人，多台互不干扰。
- 改名：给机器人起一个容易认出的名字。
- 重新扫码：微信凭证过期或失效时，点「重新扫码」刷新即可； 已批准的好友、人设分配和聊天记忆都会原样保留。
- 删除：删除后，这台机器人及其好友关系一并解除；想再用需重新扫码接入。
- 主动联系参数：设置机器人闲置多久后主动问候、两次问候的最小间隔、 每日最多条数与安静时段（配合第 9 章使用）。
好友与设置面板
每张卡片内置「好友与设置」展开面板，列出这台机器人的微信好友—— 谁给这台机器人发过消息，谁就会出现在这里。好友行提供四项操作：
- 批准：好友状态为「待批准」时点击放行，对方即可与 AI 对话；
- 人设分配：下拉选择角色，选完即保存，立刻对该好友生效；
- 允许主动：开关该好友是否接受机器人的主动问候；
- 记忆：查看该好友的聊天记忆，也可一键清空。
请遵守腾讯微信与 ClawBot 的相关使用条款。机器人可能面临限流甚至处置， 建议审慎开放、合理使用，避免打扰与过度使用。
5人设与收藏
角色提示词（人设）在「人设广场」与「我的收藏」两个分区之间流转：
- 人设广场：按热度或最新浏览公开角色，支持搜索。看中的角色可以先 试聊（在网页里直接体验，有每日与单会话上限），满意后 加入我的库；也可以改编成自己的私有草稿， 草稿会标注「改编自」来源。
- 我的收藏：创建与编辑自己的角色提示词，可设为公开或私有， 并发布到广场供大家使用。
- 分配：角色按好友粒度分配——在机器人卡片的「好友与设置」面板里， 为每位好友挑选人设，选择即生效；给谁分配、分配什么，都由你说了算。
发送 /角色 并不会切换角色—— 角色只能由主人在网页端的机器人面板里分配，这是刻意设计。
网页试聊会消耗 AI 用量，并受每日与单会话条数限制。
6表情包
- 在表情包广场浏览广场上已通过审核的表情， 喜欢的加入我的库；也可以上传投稿。
- 公开发布需要经过审核：投稿后状态为「待审核」，通过后才会出现在广场上； 被拒的投稿会标注「已拒绝」。待审核与被拒的投稿只在「我的投稿」里可见。
- 上传时也可以选择私有：私有表情仅自己可见， 不会出现在广场，但自己可以正常收藏与使用。
- 收藏进库的表情随时可以移出表情库，移出后 AI 便不再引用。
- 每个表情都有唯一的英文 slug（如 cat-roll）， AI 回复时就是用 slug 来引用你库里的表情。
- 聊天时，AI 可能会引用你库里的表情，用图片表情回应你。
7模型连接
在「模型连接」分区（用户中心 → 模型连接），可以添加OpenAI 兼容的 API， 让自己的人设用上你自备的模型。
添加一个连接
- 填写名称，方便自己辨认（例如「本地 DeepSeek」）；
- 填写 API 的 Base URL（形如 https://api.example.com/v1）；
- 填写 API Key（形如 sk-…）；
- 填写默认模型（例如 deepseek-chat），保存即可。
管理连接
- 已添加的连接会列在下方，随时可以启用 / 停用，也可以删除；
- 停用后，使用该连接的人设会回退到平台默认模型；
- 在人设编辑器里，每个人设都可以按需选择模型连接， 留空则使用平台默认模型。
若站点未开启模型连接能力，进入该页面会看到原因提示（例如「服务暂未就绪」）， 此时无法添加或使用自定义连接。
API Key 会加密保存在服务端，列表里只显示掩码 （如 ****），服务端不会明文展示。
8微信指令速查
以下指令都在微信里直接发给机器人使用。
| 指令 | 作用 |
|---|---|
| /角色 | 不支持自助切换，只能由主人在机器人面板里分配人设 |
发送的内容不匹配任何指令时，会被交给 AI 以角色身份回复（前提是该微信用户已获批准且已被分配人设）。
9主动问候
站点开启「主动问候」后，机器人闲置一段时间，可能会主动给好友发来问候。 要触发主动消息，三个条件缺一不可：
- 机器人卡片里打开了主动联系并保存参数（闲置时长、最小间隔、每日上限、安静时段）；
- 该好友在「好友与设置」面板里勾选了允许主动；
- 对方曾与这台机器人聊过（持有会话凭证）。
站点层面是否开启主动问候，由平台统一配置；你能控制的是自己机器人的参数与每位好友的开关。
10常见问题
AI 为什么不回复？
- 是否已在机器人卡片的「好友与设置」里批准该微信用户？
- 消息发得太快会触发限流提示，稍等片刻再试。
能发图片或语音吗？
- 语音：微信自带的语音转文字会一并发送，带转写的语音可以当文字来聊。
- 图片：站点开启「图片理解」时机器人可以看图并描述内容；未开启时会直接说明看不了。
- 视频 / 文件：暂时无法查看，机器人会请你改用文字描述。
好友在哪里批准？
在「机器人」分区打开那台机器人的卡片，展开「好友与设置」面板， 找到状态为「待批准」的好友行，点「批准」即可。
机器人突然不回消息了？
多半是微信会话过期。在机器人卡片上点「重新扫码」刷新凭证即可， 已批准的好友、人设分配与聊天记忆都会保留。
忘记密码了怎么办？
登录页点「忘记密码」，输入注册邮箱获取验证码，即可设置新密码。 注册邮箱是找回账号的唯一凭证，请务必记好。
可以用邮箱验证码登录吗？
可以。登录页使用「邮箱验证码登录」入口，输入邮箱获取验证码即可直接进站，无需密码。
人设为什么显示英文？
每个人设都有一个英文 slug（如 gentle-girl）， 它是系统用来区分角色的标识；展示给大家看的仍是中文显示名，两者互不影响。