跳至主要內容

管理助理角色

想調整助理的表達方式或長期職責，進入 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 引用，而不是直接移除檔案。更多用法見角色與個性。