Profiles

Profile 是 Anyy 的用户与运行时硬边界。不同的人、环境或信任域不能共享数据和凭据时，应分别使用不同 Profile。

一个 Profile 独立拥有的内容

• Home 与 Workspace；
• 数据库和会话历史；
• USER.md、MEMORY.md、Roles 与 Soul；
• Provider、Models、Tools、Skills 和 MCP 配置；
• Channels 与 Cron；
• Secrets 和 Approvals。

这些内容不会自动跨 Profile 共用。同一 Profile 里的 Roles 会共享它们，因此 Role 不是隔离边界。

看懂 Profile 列表

进入 Dashboard → Profile。每张卡片会显示名称、ID、Home、更新时间与 Runtime 状态：

状态	含义
Current runtime	当前 Dashboard 正连接这套 Profile
Running	另一套常驻 Runtime 正在使用它
Stopped	没有检测到存活 Runtime
Default	基础 Profile，不能删除

打开卡片可以查看完整 Home，并看到当前允许执行的操作。

创建 Profile

1. 点击 New Profile；
2. 填写 ID，例如 work；
3. 可选填写显示名称，例如“工作”；
4. 点击 Create。

ID 必须以小写字母或数字开头，可包含小写字母、数字、-、_，最长 64 个字符；保留命令名不能使用。

新 Profile 会得到自己的目录结构、Workspace、空白用户/记忆文件、默认 Role 选择和配置。状态数据库在 Runtime 第一次真正使用该 Profile 时创建。

CLI 创建方式：

anyy profile create work --display-name "工作"

在 Dashboard 切换

打开非当前 Profile，点击 Start and switch 或 Switch to。Dashboard 会依次：

1. 选中目标 Profile；
2. 启动或找到对应 Gateway Runtime；
3. 绑定目标 Profile 的数据；
4. 把浏览器跳转到目标 Dashboard。

完成后，Sessions、Memory、Models、Channels、Skills、MCP、Cron 和 Approvals 都来自新 Profile。

切换不是迁移

这个过程不会复制任何数据。需要查看原来的会话或设置时，切回原 Profile 即可。

切换后，修改模型、凭据、Channel 或 Memory 之前，建议先到 Dashboard → About → Profile 核对 ID 与 Home。

从 CLI 选择 Profile

anyy profile list
anyy profile get work
anyy profile use work

profile use 只改变之后没有显式指定 Profile/Home 的命令默认选择，不会迁移已经运行的 Dashboard。

只对一条命令指定目标：

anyy --profile work status
anyy --profile work dashboard

支持的命令也可以传 --home PATH。同一次 Home 解析不要同时提供 Profile 与 Home。

停止 Profile Runtime

Dashboard 可以停止一个正在运行、但不是当前 Profile 的 Runtime。停止后磁盘数据保持不变，之后切换到它时可以重新启动。

删除 Profile 前必须先停止。当前 Dashboard 所依赖的 Runtime 不能从 Profile 页面停止自身。

删除 Profile

删除会永久移除整个 Profile Home，包括 Workspace、状态数据库、Memory、Skills、Secrets、Cron、Channels、Sessions 和 Runtime 状态。

Dashboard 只允许删除同时满足以下条件的 Profile：

• 不是当前 Dashboard Profile；
• 不是 default；
• 不是 Sticky Default；
• Runtime 已停止。

Dashboard 删除时会一并清除 Profile Secrets。CLI 必须显式确认：

anyy profile delete work --force --purge-secrets

存在 Secrets 而没有 --purge-secrets 时，CLI 会拒绝删除。

删除前先做可验证的备份

删除 Profile 不是归档。只要以后可能需要其中任何内容，就应先创建备份，并确认备份可以读取。

Profile 与 Role 怎么选

需求	选择
同一个人、同一份数据，只换助手身份或表达方式	Role
记忆、凭据、会话或信任域必须隔离	Profile
共享数据，只想让某个 Session 改用另一模型	Session 模型选择
工作账号和个人账号绝不能混用	不同 Profile

常见问题

现象	处理方法
Profile ID 不合法	使用未保留的小写 ID，可含数字、-、_
切换停在某个 Handoff 阶段	检查目标 Home，并运行 anyy --profile NAME status
无法删除	先切走，必要时更改默认选择，再停止 Runtime
切换后数据看似消失	在 About → Profile 核对目标，或切回原 Profile
CLI 与 Dashboard 数据不同	比较 Profile、--profile、--home 和当前 Runtime
其实只想换助手风格	新建 Role，不必复制整个 Profile

Profile 内的助手身份见角色与个性。