什么是 Soul？
Soul 是 Alius 的 Agent 身份系统。它定义了 AI Agent 的角色、专业知识和行为方式。你可以把它看作一个结构化的 Agent 人设配置，在 Alius 中以 Agent Card 兼容格式表示。
Soul 的影响范围：
- 决定 Agent 如何理解和回应你的请求
- 影响计划生成的风格和重点
- 确定代码审查、调试等任务的行为偏好
两个层级的 Soul 管理
Alius 区分官方仓库缓存和本地已安装缓存：
| 命令 | 管理层级 | 说明 |
|---|---|---|
alius core update | 官方仓库缓存 | 更新或克隆官方 Soul 仓库缓存 |
alius soul update | 本地已安装缓存 | 将官方 Soul 同步到本地缓存 |
alius soul list | 本地已安装缓存 | 列出已安装的 Soul 缓存条目 |
alius core和alius soul是两个不同的操作：core管理官方仓库，soul管理本地安装。
在工作空间中配置 Soul
通过 /init 初始化向导
初始化向导的最后一步是选择 Soul 角色。选择后立即生效。
通过 /config 配置中心
输入 /config，切换到 Soul 标签页，选择或更换 Agent 角色。
通过命令行
alius config soul --role senior-engineer直接编辑配置文件
编辑 .alius/config/soul.toml：
[soul]
role = "senior-engineer"
description = "一位注重测试、整洁代码和文档的高级软件工程师"
language = "zh"可用角色
常见的 Soul 角色包括：
| 角色 | 特点 |
|---|---|
| senior-engineer | 专注架构、代码质量和最佳实践 |
| code-reviewer | 专门审查代码中的 Bug 和改进点 |
| docs-writer | 生成文档和注释 |
| debugger | 专注诊断和修复问题 |
Soul 与模型分配
Soul 角色与 Plan/Execute/Review 模型分配是独立的配置维度：
- Soul 定义 Agent 的身份和行为风格
- 模型分配 定义哪个模型负责哪个阶段
两者在 /config 配置中心的不同标签中管理。
Soul 选择的前提条件
在 /config 或 /init 中选择 Soul 角色之前，需要满足以下条件：
- 至少一个已启用的模型在本地模型库中
- Plan Model、Execute Model 和 Review Model 各已分配到已启用模型
- 已选择的模型引用的提供商具有 Base URL
- 已选择的提供商具有直接 API Key 或 API Key 环境变量源
Agent Card
项目的 Soul 配置以 Agent Card 兼容格式存储在 .alius/config/soul.toml 中。Agent Card 描述了 Agent 的身份、能力、技能和协议暴露方式。