设置
Settings 对话框用于为本项目连接 AI，并选择 Raaghu Spec Kit 命令标签的显示方式。从 Raaghu Spec Kit 汉堡菜单（右上角）→ Settings 打开。
普通团队成员不会看到 Settings。若看不到，请请项目或组织管理员为本项目连接 AI。产品中 AI 连接可能标注为 LLM — 指 AI 模型或提供商。
谁可以打开 Settings
汉堡菜单中的 Settings 仅对以下角色显示：
| 角色 | Azure DevOps 组 | 在 Settings 中可做的事 |
|---|---|---|
| 组织管理员 | Project Collection Administrators（组织管理员） | 完整的 LLM Settings 与 Commands Mapping；可管理本项目的 Project LLM 与 Raaghu AI |
| 项目管理员 | [Project]\Project Administrators | 对本项目拥有相同的扩展内 Settings 访问 — Project LLM 与 Raaghu AI（在 Organization Settings 允许相应来源时） |
普通中心用户不会在汉堡菜单中看到 Settings。请请项目或组织管理员为本项目配置 AI。
组织级计费、席位、许可证密钥与 AI Settings 位于 Azure DevOps → Organization settings → Extensions → Raaghu Spec Kit，仍仅限组织管理员。参见 Organization Settings。
两种不同的 “Organization Settings”
| 产品中的名称 | 位置 | 用途 |
|---|---|---|
| Settings（汉堡菜单） | Raaghu Spec Kit 中心内 | 当前项目的 Project LLM、Raaghu AI 与 Commands Mapping |
| Organization settings → Extensions → Raaghu Spec Kit | Azure DevOps 组织设置 | 订阅、席位、AI Settings、许可证密钥与额度 |
本页仅介绍扩展内的 Settings 对话框。
选项卡
| 选项卡 | 用途 | 谁可以使用 |
|---|---|---|
| LLM Settings | 本项目的 Project LLM 密钥与 Raaghu AI | 组织管理员与 Project Administrators（部分开关取决于组织 AI Settings 权限） |
| Commands Mapping | Raaghu Spec Kit 命令在聊天下拉菜单中的显示方式 | 组织管理员与 Project Administrators |
自带 LLM 密钥与 Raaghu AI
- 自带 LLM 密钥 — 你为本项目提供自己的 Azure OpenAI、OpenAI 或 Claude API 凭据，或使用管理员在 AI Settings 中分配的连接。你直接向提供商付费。
- Raaghu AI — 在 LLM Settings 选项卡启用 Raaghu AI 以使用组织的 Raaghu 额度。当 Organization Settings 允许相应来源时，Project LLM 与 Raaghu AI 可同时为 On；在聊天页脚选择当前模型。
最快打通聊天的方式
- 若管理员已为本项目分配组织 LLM 连接或启用了 Raaghu AI → 将 Project LLM 保持为 Off，使用组织 / 托管路径。
- 否则打开 Project LLM，添加一个提供商，保存并设为 Default。
- 若聊天仍提示尚未配置 AI，请组织管理员在 AI Settings 中配置连接、为本项目启用 Use organization AI、Use project AI 或 Use Raaghu AI，或充值 Raaghu AI credits。
LLM Settings
LLM Settings 选项卡包含两个部分：Project LLM setting 与 Raaghu AI。
Project LLM setting
开关控制本项目是否使用自己的 LLM 密钥凭据：
- Off — 项目使用管理员分配的组织 LLM 连接（在允许 Use organization AI 时）。
- On — 可在此添加项目级凭据。
显示组织连接时，Organization LLM 仅在以下情况停用：Project LLM 为 On（Disabled while Project LLM is on.），或本项目允许并已打开 Raaghu AI（Disabled while Raaghu AI is on.）。若项目不允许使用 Raaghu AI，Organization LLM 仍可用（不会仅因 Raaghu 被禁用而变灰）。
Project LLM 可能被禁用，并显示类似 "Custom project LLM settings are not enabled for this project. Contact your organization admin." 组织管理员可在 Organization settings → Extensions → Raaghu Spec Kit → AI Settings → Project（Use project AI）中启用。
开关为 On 时，点击 + 添加配置：
| 字段 | 说明 |
|---|---|
| Title | 此配置的名称 |
| AI Provider | Azure OpenAI、OpenAI 或 Claude（Anthropic） |
| Model | 目录或自定义名称。Azure OpenAI / OpenAI 包含 GPT-5.6 Sol（推荐）、GPT-5.5、GPT-5.4、GPT-4.1 与 GPT-4o。Claude 包含 Sonnet 5（推荐）、Opus 5、Fable 5 与 Haiku 4.5。支持多选与自定义模型名称 |
| Endpoint | Azure OpenAI 必填（及其他提供商按需） |
| API Version | 仅 Azure OpenAI（例如 2024-10-21） |
| API Key | 提供商的 API 密钥 |
| Expiration | 7、30、60 或 90 天、自定义日期，或不过期 |
可添加多个配置并将其中一个标为 Default。凭据会加密存储。空状态："No Project LLM configurations found. Click '+' to add one."
Raaghu AI
当组织可使用 Raaghu AI 额度时，会显示 Raaghu AI 部分。
- On / Off 开关 — 为本项目开启或关闭 Raaghu AI（在允许 Use Raaghu AI 时，组织管理员与项目管理员可用）
- Credit balance — 组织当前 Raaghu AI 余额
- Model — 使用的托管模型
- Add credits — 打开计费中心增加余额（组织管理员路径）
若组织管理员未为本项目允许 Raaghu AI，开关会禁用并显示 "Raaghu AI is not enabled for this project. Contact your organization admin."
仅组织管理员可更改组织级权限并充值 Raaghu AI credits。充值见 Organization Settings。
组织级连接（分配给项目的共享密钥）在 Organization Settings → AI Settings 中管理，不在此对话框。
Commands Mapping
Commands Mapping 选项卡控制 Raaghu Spec Kit 命令在聊天 Command 下拉菜单中的显示。Spec Kit / Default 开关切换显示模式：
- Default — 友好名称（例如 "Create Specification"）
- Spec Kit — 技术 ID（例如
speckit.constitution）
若下拉菜单显示 "Create Specification"，这等同于 /speckit.specify。标签为只读。切换开关会立即保存。
映射的命令包括：constitution、specify、clarify、plan、tasks、analyze、checklist 和 converge。
