故障排除
遇到阻塞时请使用本页。若仍无法解决,请发送邮件至 support@raaghu.ai。
访问与授权
访问请求待处理 — "Request submitted. Retry authorization after admin approval"
请组织管理员在 Access Requests 中审批你,然后再次点击 Authorize Now。参见 访问请求。
访问被拒绝,或已批准仍无法使用 — 请联系组织管理员。若你已被批准,请让他们接着分配席位(Azure DevOps → Organization settings → Raaghu Spec Kit → Users)。
授权失败 / 弹窗被拦截 — 允许 Azure DevOps 的弹窗,尝试其他浏览器,然后重试。
本地部署出现 "Setup Required" — 完成 Server Deployment Setup,然后授权。云用户不应看到此提示。
本地部署邮箱 OTP — 输入工作邮箱和 6 位验证码。参见 安装与启动。
席位与订阅
"You need a seat" / 未订阅 / 试用已结束 — 组织管理员打开 Organization Settings,启动免费试用、完成结账或激活许可证密钥,然后在 Users 上分配席位。
Start Free Trial / Choose Your Plan 不可用 — 免费试用方案选择器仅当组织符合试用资格时才会向租户管理员显示(通常是尚未使用过试用或曾有许可证的新组织)。否则请使用 Subscribe for $…/month 或 License Keys。
许可证密钥激活失败 — 检查拼写(RAAGHU-XXXX-XXXX-XXXX),确认密钥尚未在其他账户激活,且未过期或被吊销。参见 License Keys。
若中心显示 "Your organization is not subscribed to Raaghu Spec Kit",请点击 Open org settings(管理员),或请管理员启动试用、订阅或激活密钥:


取消 / 撤销 — 在 Subscription 上,若变更仍处于待 处理状态,可使用 Undo cancellation 或 Undo seat change。
AI 与聊天
LLM 未配置 — 汉堡菜单 → Settings。添加 BYOK 凭据,或请管理员启用 Raaghu-hosted AI 并充值额度。参见 Settings。
托管余额为空 — 管理员在 Organization Settings → Subscription → Top up Credits 中充值。
命令名称不符合预期 — 检查 Settings → Commands Mapping(Default 与 Spec Kit)。友好名称如 "Create Specification" 等同于 /speckit.specify。参见 Raaghu Spec Kit 命令。
提供商 / 速率限制错误 — 等待后重试;检查提供商配额或额度余额。
初始化与 Wiki
初始化失败 — 确认项目 Wiki 访问权限、Wiki 写入权限,以及对 GitHub.com 的网络访问。参见 初始化 Raaghu Spec Kit。
找不到 Speckit 文件 — 在 Wiki 中查找 Speckit 根节点。若缺失,请重新初始化。
Dashboard(仪表盘)与 Visual
Dashboard 为空 — 选择正确的迭代。完成 你的第一个功能,以便存在相关工件。
Visual Sync 不可用 — 确认 constitution/spec/tasks 已存在、AI 已配置,且你有创建工作项的权限。一次同步一个层级。参见 Visual。