故障排查
NPC 异常处理
重试当前工位
在 Issue 下追加评论重新触发：
@codebuddy(glm-5.1) 代码构建失败，请修复以下问题：1. xxx 2. xxx如果 NPC 完全无响应（>20 分钟无评论）：
@codebuddy(glm-5.1) 请确认收到任务并立即开始执行。当前进度已停滞超过20分钟，请今日内完成。回滚到上一个安全状态
bash
# 查看提交历史，找到 NPC 提交之前的状态
git log --oneline
# 回滚到指定 commit
git reset --hard <safe_commit_hash>
git push --force-with-lease
# 重新触发 Issue跳过当前工位
如果 NPC 彻底无法完成，可以手动完成并跳过：
- 手动编写/修复代码
git add && git commit -m "chore: manual fix for <工位>" && git push- 继续下一步 transfer
踩坑清单
仓库 Transfer 相关
| # | 坑 | 解法 |
|---|---|---|
| 1 | "group protection" 阻止 Transfer | 先关闭双方组织保护：curl -X PUT $API/org/-/settings -H "Accept: application/vnd.cnb.api+json" -d '{"group_protection":0}' |
| 2 | "target slug already exists" | 目标组织有同名仓库残留，先 DELETE；如果 DELETE 也被保护阻止，在目标组织创建新仓库名 |
| 3 | "parameter source is invalid" | source 要完整路径 org/repo，target 只要 org slug |
| 4 | 仓库转移后两边都找不到 | 确认 DELETE 的是目标组织的同名仓库，不是源 |
| 5 | Token 报 bill authorization scope | 环境变量未 export，检查 echo $CNB_TOKEN |
NPC 相关
| # | 坑 | 解法 |
|---|---|---|
| 6 | NPC 说"没有 repo-code:rw 权限" | Issue/评论请求体加 "work_mode": true |
| 7 | NPC 不触发/无反应 | @格式不完整：必须 @仓库路径(角色名) |
| 8 | .cnb.yml 写了 npc.work_mode: true 无效 | work_mode 不是 yml 配置，是 API 参数 |
| 9 | NPC 第一次说做完但没推代码 | 可能没传 work_mode，重新评论触发 |
| 10 | .cnb.yml 格式报错 | 严格参照 CodeBuddy 仓库格式：$: 通配 + 各模型独立段 |
| 11 | UI NPC 只输出整体风格不输出独立页面 | Issue 中明确要求"每个页面一张独立SVG（375×812px）+ 真实数据" |
CloudBase 相关
| # | 坑 | 解法 |
|---|---|---|
| 12 | tcb login 失败 | 用 tcb login --apiKeyId $ID --apiKey $KEY |
| 13 | cloudbaserc.json envId 为 "your-env-id" | 手动替换为真实环境 ID |
| 14 | tcb fn deploy 找不到 functions/ | 用 --dir 指定函数目录：tcb fn deploy {fn} --env-id {id} --dir server/{fn} |
| 15 | 创建集合权限不足 | 用 @cloudbase/node-sdk + tccli 凭证（从 ~/.tccli/default.credential 读取） |
| 16 | node-sdk 报 missing secretId | 代码里显式传 secretId/secretKey，不要依赖环境变量自动注入 |
EdgeOne Pages 相关
| # | 坑 | 解法 |
|---|---|---|
| 17 | 直接访问 /profile 路径 404/401 | SPA 需要 public/_routes.json 做路由 fallback 到 index.html |
| 18 | eo_token 过期（401 UNAUTHORIZED） | 重新 edgeone pages deploy 获取新 token |
| 19 | 管理后台 /admin 白屏 | admin 的 vite.config.ts 必须设 base: '/admin/'，构建产物放到 client/public/admin/ |
| 20 | EdgeOne Pages CLI 版本低 | npm install -g edgeone@latest，要求 ≥1.2.30 |