AI 角色自定义
使用 Caret 的角色系统自定义 AI 的名称和头像。您可以创建属于自己的个性化编程伙伴。
什么是角色？
角色定义了 AI 的以下元素：
- 名称：AI 的显示名称
- 头像图片：默认状态图片
- 思考中图片：AI 工作时显示的图片
- 性格定义：通过 persona.md 文件定义 AI 的语气和行为
内置角色
Caret 提供 5 个模板角色：
🤖 Caret
- 友好的机器人伙伴
- 默认角色
💖 吴爱玲 (Oh Sarang)
- K-POP 偶像开发者
- 明朗积极的语气
🪟 窗边市佳 (Madobe Ichika)
- Windows 11 OS-tan
- 专业高效
🍎 青苹果 (Cyan Macin)
- macOS 助手
- 精致优雅的风格
🐧 谭杜·乌班图 (Tando Ubuntu)
- 开源合作者
- 社区导向
如何使用角色
选择角色
- 打开设置 (⚙️)
- 找到 Persona Management 部分
- 点击 Select Persona Template 按钮
- 选择您想要的角色
切换模板
您可以随时在设置界面切换到其他模板。
创建自定义角色
上传图片
Caret 使用 2 种图片：
1. 普通图片
- 在默认状态下显示
- 在设置中点击 "Upload Normal Image"
- 选择图片文件（支持所有图片格式）
2. 思考中图片
- 在 AI 工作时显示
- 在设置中点击 "Upload Thinking Image"
- 选择图片文件
保存：图片会自动保存到 VS Code 内部存储。
性格定义 (persona.md)
您可以通过 persona.md 文件定义 AI 的性格和语气。
保存位置：
~/Documents/Caret/Rules/persona.md
示例：
您是一位友好且专业的开发伙伴。
始终用中文回答，并在代码说明时包含注释。
分步骤解释变更内容，并说明每个步骤的理由。
保存文件后会立即生效。
角色 vs 规则
| 项目 | 角色 | 规则 (.caretrules) |
|---|---|---|
| 范围 | AI 名称、图片、性格 | 编程指南 |
| 保存位置 | 全局（VS Code 内部 + persona.md） | 项目文件夹 |
| 组合 | 与规则一起使用 | 与角色一起使用 |
最佳效果：将角色 + 项目规则一起使用。
常见问题
问：角色会影响 AI 性能吗？ 答：如果在角色的性格定义（persona.md）中赋予负面性格，可能会影响 AI 的工作质量。请避免使用"经常出错"、"消极被动"等表述。
问：可以为不同项目使用不同的角色吗？
答：不可以。角色仅以全局方式管理。如果需要针对项目进行自定义，请在 .caretrules 文件中编写项目特定的指令。（但是，图片是全局的，因此无法按项目更改）
问：角色保存在哪里？
答：图片保存在 VS Code 内部存储（globalStorage）中，persona.md 保存在 ~/Documents/Caret/Rules/ 中。
问：对图片大小或格式有限制吗？ 答：支持所有图片格式，没有大小限制。上传时会自动转换为 base64 格式。
下一步
角色系统是 Caret 独有的功能。 Cline 不提供此功能。