跳到主要内容

管理助手角色

想换助理的表达方式或长期职责，进入 Roles；想把账号、记忆、会话和配置隔开，应改用 Profile。同一 Profile 内的 Role 共用数据库、Workspace、USER.md、MEMORY.md、模型、Tools、Skills、MCP、Channels 和 Cron。

从创建到首次使用​

  1. 点击 新建角色，填写永久 ID，例如 writer_zh，再填写可选显示名。
  2. ID 以小写字母或数字开头，其余只用小写字母、数字、-、_；以后不能改 ID。
  3. 创建后进入 Soul 编辑器，保存非空内容。
  4. 在详情页点击使用，把它设为之后新会话的默认角色。

已有会话仍保留原 Role。修改显示名或 Soul 不会建立另一套数据空间，Role 也不负责工具选择或 Codemode 模式；这些由 Profile／Session 设置管理。

Soul 与引导状态​

Soul 是长期身份说明，例如：

# 写作搭档

把零散资料整理成清楚的中文。
保留作者原意，事实不明时说明缺口。
一次性格式要求以当前请求为准。

不要把一次性任务或密钥写进去。指令越短、越稳定，后续越容易遵循。

引导为待开始或进行中时，在 Dashboard 保存非空 Soul 会完成引导，default 角色也适用。首次引导对话中，Anyy 也可通过普通工具保存当前角色的 SOUL.md；该工具不能修改其他 Role 或显示名，完成或跳过后不再提供。

引导状态会持久保存。CLI／直接文件编辑不会重新判断状态，清空 Soul 不会重新开启已完成／跳过的引导；完成与跳过之间也不能再切换。过时的引导完成请求会被拒绝，普通 Soul 编辑仍然可用。

归档前先处理引用​

default 的 Soul 可编辑，但不能改其显示名或删除角色。其他 Role 必须先取消默认选择，并清理仍引用它的会话和 Cron，才能删除。

删除实际是归档记录：Role 退出活动选择，Soul 文件仍保留，共享数据不会被删除。CLI 可查看归档项：

anyy role list --include-archived

终端里完成相同操作​

anyy role create writer_zh --display-name "中文写作"
anyy role update writer_zh --soul-file ./WRITER.md
anyy role get writer_zh
anyy role use writer_zh
anyy role delete writer_zh

可用 --home PATH 指向目标 Home，脚本加 --json。若删除被拒绝，先检查默认角色与会话／Cron 引用，而不是直接移走文件。更多用法见角色与个性。