组织设置

Organization Settings 是 Raaghu Spec Kit 的 Azure DevOps 中心，用于管理订阅、席位、访问请求、用户、AI Settings 和许可证密钥。

适用对象： 仅组织管理员。非管理员会看到锁定提示。普通成员无需在此配置任何内容——请向管理员申请席位和 AI。

跳转到：订阅 · 用户 · AI Settings · License Keys

如何打开

1. 在 Azure DevOps 中打开 Organization settings（组织级设置，非项目设置）。
2. 在左侧菜单的 Extensions 下选择 Raaghu Spec Kit。

在 Azure DevOps Server（本地）上，请通过 Collection settings → Extensions → Raaghu Spec Kit 打开同一中心。

仅组织管理员可打开此中心。非管理员会看到锁定提示。

选项卡：Subscription、Users、AI Settings 和 License Keys。

此页面位于 Azure DevOps Organization settings。它与 Raaghu Spec Kit 内菜单 → Settings 不同（项目 AI 密钥在 LLM Settings、当前项目的 Raaghu AI 以及命令标签）。组织级 AI 连接、按项目权限与 Raaghu AI 积分在此中心的 AI Settings 中管理。

订阅

Subscription 选项卡管理方案与账单。价格为 每席位每月 $9（美元）。您向 Raaghu 购买许可证，而不是向 Microsoft 付费。

开始使用（尚未订阅）

符合资格的新组织会看到 Choose Your Plan 界面（仅组织管理员，且组织符合试用资格时）：

1. 选择 Free Trial 或 Paid。
2. Free Trial — 查看订单摘要（Up to 5 个席位、7-day trial、$0.00），然后点击 Start Free Trial。无需信用卡。
3. Paid — 用 − / + 设置席位数，然后点击 Subscribe Now 并用卡支付。如果您有促销码，请在用卡支付时输入。
4. 在 Users 选项卡为团队成员分配席位。

若组织不符合试用资格（例如已使用过试用或曾有许可证），该选项卡仅显示付费路径：选择席位数，然后点击 Subscribe for $…/month。也可在 License Keys 中激活密钥，而无需用卡支付。

试用结束后，可通过在此完成付费结账，或在 License Keys 中激活密钥以继续使用。

促销码

用卡支付时，如果已向您发放促销码，可以输入该代码。折扣会在付款前显示在订单摘要中（如需可移除该代码）。

订阅后（付费、试用或许可证密钥），该选项卡会显示方案状态（Active、Past due、Canceled、Canceling 等）以及以下操作：

操作	说明
Adjust seats	在付费银行卡计费下增加或减少席位。增加立即生效；减少安排在下一个计费周期（必要时使用 Undo seat change）。免费试用期间席位数固定为 5，无法在此更改（如需其他数量请联系 support@raaghu.ai）。使用 license key 时，席位数由密钥固定，无法在此更改。
Add credits	增加 Raaghu AI credits 余额（$10、$25、$50、$100 或 $5 至 $10,000 之间的自定义金额）。积分不会过期。
Manage billing	当您用卡支付时，打开账单门户以查看发票与付款方式。免费试用或使用许可证密钥期间，此操作会变为 Users（分配席位）。
Cancel subscription / Undo cancellation	取消会安排在周期结束时终止。状态为 Canceling 时，可点击 Undo cancellation 保留方案。组织处于免费试用期间时，Cancel 会隐藏。

你还会看到已购买 / 已分配 / 可用席位，以及 AI 额度余额与支出。

• Paid（用卡支付）： Billing summary 显示计费周期、下次付款日期和月度合计。方案徽章：Paid plan。
• Free trial： 方案徽章显示 Free Trial。Subscription details 显示方案、Trial ends on 和席位（而非下次付款 / 月度合计）。
• License key： 方案徽章显示许可证密钥。Subscription details 显示到期日与授权席位。

调整席位

使用 − / + 更改席位数量，查看价格明细，然后确认。不能低于已分配席位数——请先在 Users 选项卡取消分配用户。

Add credits

选择预设金额（$10、$25、$50、$100）或输入自定义金额，然后继续付款。

Manage billing

当您用卡支付时，打开账单门户，用于付款方式、发票与订阅详情。

用户

Users 选项卡（Manage users）用于批准首次访问请求并分配席位。

统计项包括 Seats purchased、Seats assigned、Seats available 和 Pending Requests。可在各列表中使用 Search by name or email。若组织已订阅，还可在此页打开 Buy seats（免费试用期间禁用）。

子选项卡：

子选项卡	你可以做什么
Users	Raaghu Spec Kit 中的组织成员。列包括 User、Email、Role 与 Last Used。每行：Assign 或 Unassign。多选后可 Assign selected / Unassign selected。空状态："No users yet." 若组织还有更多成员，可使用 Load more users。
Pending requests	等待审批的首次用户。每行：Approve 或 Reject。选择两行或更多后可 Approve selected。空状态："No pending access requests."

批准请求会在同一步分配席位。确认 Approve and assign seat?（批量时为 Approve and assign seats?），然后点击 Approve。若席位不足，对话框会说明如何处理——在可用时 Buy seats，或先在 Users 子选项卡释放席位。

重要： 成员需要已分配的席位才能使用 Raaghu Spec Kit——即使组织已订阅、处于试用期或使用许可证密钥。

详情：访问请求。

AI Settings

AI Settings 选项卡用于管理组织范围的 AI 提供商连接、将其分配给项目，以及管理 Raaghu AI credits。

产品中的副标题："Manage AI connections for your organization and assign them to projects."（在积分子选项卡上："Add credits, manage spending limits, and track AI usage."）

三个子选项卡：Organization、Project 和 Raaghu AI Credits。

Organization

在 Organization 子选项卡上，创建并管理供各项目共用的组织级连接。

1. 点击 Add AI connection 添加共享连接（Title、AI Provider、Model、Endpoint、API Version、API Key、Expiration — 包括 custom 过期日期）。填写时 Raaghu Spec Kit 会检查字段（例如标题长度、有效的 HTTPS 终结点，以及看起来完整的 API key）。
2. 查看表格：Name、Endpoint（已遮蔽）、Models（例如 1 enabled）以及 Assigned projects。
3. 需要时使用行内删除控件移除连接（用 Delete AI connection? 确认）。

空状态："No organization AI connections yet. Click Add AI connection to create one." 新连接可设为组织默认。

Project

在 Project 子选项卡上，为每个 Azure DevOps 项目选择可用的 AI 来源：

列	说明
Project	Azure DevOps 项目名称
AI providers	该项目的组织 AI 连接（例如 Azure）
Organization AI	是否允许组织 AI
Project AI	是否允许项目自定义 AI 密钥
Raaghu AI	是否允许 Raaghu AI（积分）

打开项目的 ⋯ 菜单（或选择该项目），在侧面板中编辑设置：

• Assign AI Services — 选择项目可使用的组织连接（开启 Use organization AI 时）。留空则使用组织默认。
• Permissions — 打开或关闭 Use organization AI、Use project AI 和 Use Raaghu AI，然后 Save。

关闭 Use organization AI 时，AI providers 可能显示 "Project LLM"、"Raaghu AI" 或 "No AI configured" 等状态。

Raaghu AI Credits

在 Raaghu AI Credits 子选项卡上（不再是组织级顶级选项卡），添加托管积分，并仅为 Raaghu AI 设置 spending limits。

• 查看 Credit balance、Spent this period 和 Active spending limits
• 点击 Add credits（也可从 Subscription → Add credits 充值）
• 在 Set a spending limit 下选择 Scope、Spending limit (USD) 和 Period（Monthly 或 Lifetime），然后 Add limit
• 查看 Active spending limits，并编辑或删除现有限额
• Raaghu AI usage 显示组织范围 Raaghu AI 在某个日期范围内的支出，包括 By project 明细。成员可在 My AI usage 中查看自己的支出

License Keys

为组织激活并管理许可证密钥——无需用卡支付。

Activate a key

1. 打开 License Keys。
2. 输入密钥（格式 RAAGHU-XXXX-XXXX-XXXX）。
3. 点击 Activation Key — Raaghu Spec Kit 会先验证并显示预览（方案、类型、有效期）。
4. 点击 Confirm & activate 兑换，或点击 Cancel 返回且不激活。

Keys on this account 列出当前有效权益：

列	说明
Plan	方案等级与席位数（例如 SpecKit · 1 seats）
Status	Active、Expiring（剩余 ≤30 天）或 Expired
Expires	相对到期时间（例如 in 30 days）或结束日期

空状态："No license keys have been activated for this account."

激活后，计费方式变为 License key。在 Subscription 上，方案徽章显示 License key，且 Billing summary 仅显示 Expires on。

下一步

• 管理员设置
• 访问请求
• 设置