设置
Settings 对话框用于为本项目连接 AI，并选择 Raaghu Spec Kit 命令标签的显示方式。从 Raaghu Spec Kit 汉堡菜单（右上角）→ Settings 打开。
谁可以打开 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。
组织级计费、席位、许可证密钥与 Configurations 位于 Azure DevOps → Organization settings → Raaghu Spec Kit，仍仅限组织管理员。参见 Organization Settings。
两种不同的 “Organization Settings”
| 产品中的名称 | 位置 | 用途 |
|---|---|---|
| Settings（汉堡菜单） | Raaghu Spec Kit 中心内 | 当前项目的 Project LLM、Raaghu AI 与 Commands Mapping |
| Organization settings → Raaghu Spec Kit | Azure DevOps 组织设置 | 订阅、席位、Configurations、许可证密钥与额度 |
本页仅介绍扩展内的 Settings 对话框。
选项卡
| 选项卡 | 用途 | 谁可以使用 |
|---|---|---|
| LLM Settings | 本项目的 Project LLM 密钥与 Raaghu-hosted AI | 组织管理员与 Project Administrators（部分开关取决于组织 Configurations 权限） |
| Commands Mapping | Raaghu Spec Kit 命令在聊天下拉菜单中的显示方式 | 组织管理员与 Project Administrators |
自带密钥与 Raaghu-hosted AI
- Bring your own key (BYOK) — 为本项目提供 Azure OpenAI、OpenAI 或 Claude 凭据，或使用管理员在 Configurations 中分配的连接。你直接向提供商付费。
- Raaghu-hosted AI — 在 LLM Settings 选项卡启用 Raaghu AI 以使用组织的 Raaghu 额度。当 Organization Settings 允许相应来源时，Project LLM 与 Raaghu AI 可同时为 On；在聊天页脚选择当前模型。
最快打通聊天的方式
- 若管理员已为本项目分配组织 LLM 连接或启用了 Raaghu AI → 将 Project LLM 保持为 Off，使用组织 / 托管路径。
- 否则打开 Project LLM，添加一个提供商，保存并设为 Default。
- 若聊天仍显示 "LLM is not configured"，请组织管理员在 Configurations 中配置连接、为本项目启用 Use Project Key 或 Use Raaghu AI，或充值 Raaghu AI credits。
LLM Settings
LLM Settings 选项卡包含两个部分：Project LLM setting 与 Raaghu AI。
Project LLM setting
开关控制本项目是否使用自己的 BYOK 凭据：
- Off — 项目使用管理员分配的组织 LLM 连接（在允许 Use Organization Key 时）。
- On — 可在此添加项目级凭据。
Project LLM 可能被禁用，并显示类似 "Custom project LLM settings are not enabled for this project. Contact your organization admin." 组织管理员可在 Organization settings → Raaghu Spec Kit → Configurations → Project（Use Project Key）中启用。
开关为 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
当组织可使用托管 AI 额度时，会显示 Raaghu AI 部分。
- On / Off 开关 — 为本项目开启或关闭托管 AI（在允许 Use Raaghu AI 时，组织管理员与项目管理员可用）
- Credit balance — 组织当前托管 AI 余额
- Model — 使用的托管模型
- Top up Raaghu AI credits — 打开计费中心增加余额（组织管理员路径）
若组织管理员未为本项目允许 Raaghu AI，开关会禁用并显示 "Raaghu AI is not enabled for this project. Contact your organization admin."
仅组织管理员可更改组织级权限并充值 Raaghu AI credits。充值见 Organization Settings。
组织级连接（分配给项目的共享密钥）在 Organization Settings → Configurations 中管理，不在此对话框。
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。
