文档
使用指南
按步骤查找作品、创作人设、导入文件
第一次使用可从头阅读,也可以通过目录直接查看需要的章节
使用作品
先确认你使用的是 MaiBot 还是 AstrBot,两种平台的人设正文结构不同,下载和填写时应选择对应平台
- 在「探索」中按平台、分类或标签筛选,打开作品详情并核对作者、版本和来源许可
- 阅读作品介绍及作者使用说明,在「人设内容」中查看完整正文,历史版本保留当时的内容
- 需要配置机器人时复制对应正文,或在「导出」面板预览目标格式后下载;分享时使用该版本的链接
公开可读不等于可以任意转载,使用和分享前应先查看作品的转载规则
MaiBot 使用方式
MaiBot 人设由三段独立正文组成,分别描述角色的性格、表达和行为,使用时不要将三段内容混成一个字段
- 在作品详情的「人设内容」中,分别查看人格设定、表达风格和行为风格
- 将三段正文填入目标机器人的对应配置;使用 TOML 片段时,核对
[personality]下的personality、reply_style和behavior_style - 保留机器人原有的账号、模型和运行配置,按目标平台的配置方式合并,再检查实际回复是否符合预期
本站 MaiBot 原生片段按 1.3.15 核验,只携带三段人设正文;名称、图片、README 和来源资料可通过通用格式保存
AstrBot 使用方式
AstrBot 人设包含人格设定和可选的预设对话,对话按一条用户消息和一条 AI 回复成对保存,顺序也是人设的一部分
- 下载前在「导出」面板核对人格设定和预设对话,选择 AstrBot 原生 JSON
- 在 AstrBot WebUI 的「人格」文件导入入口导入,随后检查人格内容及对话顺序
- 在目标平台核对工具和 Skills 的启用范围,再将人格用于实际会话
原生文件按 AstrBot 4.29.3 核验,该平台导入时会移除系统提示词首尾空白,并采用目标平台的工具和 Skills 默认设置;本站保留作者正文,不能代替目标端的能力配置检查
创作人设
- 从导航中的「发布」或「我的人设」打开创建表单,填写名称、简介、分类和目标平台
- 填写对应平台的正文、作品介绍和来源许可,选择「创建私有草稿」保存到账号中
- 进入已有草稿的编辑器后,修改会自动保存,也可以手动保存;关闭页面前确认保存状态
未登录时可以先填写,使用表单中的「去登录」会在本标签页登录并返回,已填资料和两个平台正文在内存中保留 30 分钟,刷新或关闭标签页会清除这份临时内容
每个人设只对应一个平台,首次保存后平台保持固定;新建表单切换平台时会保留两边正文,最终只保存当前选择的平台
图文介绍
作品介绍使用 Markdown,可切换预览查看标题、段落和图片的实际效果,正文不会执行 HTML 或脚本
- 封面、头像和作品介绍图片从当前账号的私有素材库选择,支持静态 JPEG、PNG、WebP,单张最多 5 MiB
- 在线图片须先明确确认导入并完成托管,不能直接使用其他账号的私有素材
- 授权证据属于私有资料,不会随公开作品和导出文件一起提供
电脑端可在右侧查看预览和内容检查,手机端通过顶部「预览」查看;预览只展示当前输入,保存草稿不会直接公开
作品授权
原创作品和转载作品需要分别声明,文件中写着“原创”不会自动使导入账号成为原作者
- 原创作品选择适合的转载规则,并补充需要使用者了解的说明
- 转载作品填写原作者、来源链接或可核查的来源说明,以及本次转载的授权依据
- 提交前核对正文、图片及许可范围,确认有权发布,并按作者要求保留署名和来源
提交审核
- 完善内容检查中的必填项,创建版本并核对本次准备公开的快照
- 填写稳定版本号(如
1.0.0)和更新日志,确认后提交审核 - 在「发布记录」中查看处理结果,被退回后修改草稿,再使用同一未发布版本号重提
每个人设同时只能有一个待审提交,继续编辑草稿不会改写待审或已发布版本;新的发布版本号必须高于历史最高已发布版本
作者可隐藏作品、恢复展示、选择仍有效的历史公开版本或撤销版本,当前版本失效时不会自动切换到旧版,管理员下架的作品仍受下架状态限制
导入文件
从「我的人设 → 导入人设」进入,先选择文件类型,预览核对后再保存为私有草稿
选择合适的格式
- 通用 JSON / ZIP:
.persona.json保存作品资料和图片引用,最多 4 MiB;.persona.zip同时携带包内图片,最多 128 MiB,适合离线迁移 - 平台原生文件:选择 MaiBot TOML 或 AstrBot JSON,最多 4 MiB,只提取平台人设和对话,不带入账号、密钥或运行能力配置
- TXT / Markdown:最多 4 MiB,先选择平台,再将选中的段落或全文填入对应字段,核对后生成预览
核对内容并保存
- 读取文件后检查正文、对话、图片及实际编码;文本支持 UTF-8、GBK / GB18030、UTF-16 LE / BE,乱码时手动选择编码后重试
- 通用 JSON 的在线图片须逐张确认导入,ZIP 包内图片也须通过校验,全部处理完成后继续
- 填写原作者、来源和转载依据,明确选择新建草稿或替换自己同平台的草稿,再确认保存
导入后仍是私有草稿,需要主动创建版本并提交审核;替换前会检查草稿修订号,其他页面的更新不会被静默覆盖
ZIP 内文本按通用格式使用 UTF-8,独立文本文件可选择编码;自动识别无法判断所有旧编码,应以预览中的实际文字为准
常见问题
保存失败或出现版本冲突
先保留当前输入,网络恢复后手动重试;版本冲突时先比较或备份本地内容,再明确重新读取服务器草稿,不要反复刷新覆盖其他页面的修改
导入后出现乱码
根据原文件选择 UTF-8、GBK / GB18030 或 UTF-16 后重新预览,无 BOM 的 UTF-16 文件需手动选择字节序,确认文字正常后再保存
作品暂时无法公开访问
在「发布记录」核对是否仍在待审、被退回或已撤销,再检查作者隐藏和管理员下架状态,草稿和待审内容不会作为公开版本展示
开源许可
清蒸云鸭·人设市场的软件使用 AGPL-3.0 许可
用户发布的人设、图片和作品介绍由各自作者维护来源和转载声明,使用作品时以该作品的许可信息为准,软件许可不会自动改变用户作品的授权范围
开源致谢
感谢开源社区的维护者和贡献者,清蒸云鸭·人设市场使用了以下项目,也受益于它们所依赖的众多开源组件
- shadcn/ui
- 界面组件和设计基础
- Base UI
- 弹窗、菜单等组件的交互和可访问性
- Lucide
- 界面图标
- Next.js
- 网页路由和服务端渲染
- React
- 交互界面
- Tailwind CSS
- 页面样式和主题
- TanStack Query
- 请求状态和缓存管理
- React Hook Form
- 表单交互
- Zod
- 数据校验
- CodeMirror
- 文本编辑器
- NestJS
- 后端服务
- Drizzle ORM
- 数据库查询和结构管理
- PostgreSQL
- 业务数据存储
- Redis
- 缓存和任务队列基础设施
- BullMQ
- 异步任务处理
第三方项目保留各自的版权和许可证,完整依赖清单及许可说明随项目源码和运行镜像提供