已关闭
enhancement: 401 APIError missing actionable guidance (gc auth login) #432
aflyingto创建于  7月9日关闭于  7月9日
aflyingto成员
7月9日 创建

来源

PR !367(#423)第二轮 UX 评审发现。

问题

api.APIError.Error()(api/client.go:472-488)仅对 403 追加可操作指引("You don't have permission..."),但 401 只输出 "HTTP 401: unauthorized",未提示用户执行 gc auth login 或检查 GC_TOKEN。

人类与代理看到 "PR data incomplete: HTTP 401: unauthorized" 知道失败原因,却不知下一步动作。

影响

agent 在 pr view 等命令遇到 401 时(退出码 4),可能误触发不必要的重新登录流程,而非提示用户检查 token 有效性。

修复方向

在 APIError.Error() 中为 401 追加类似 403 的指引:

HTTP 401: unauthorized

Your token may be invalid or expired. Try:
- Run `gc auth login` to re-authenticate
- Check that GC_TOKEN or GITCODE_TOKEN is set correctly
likedislike
Aaflyingto成员
7月9日 关联了里程碑:M2 Review Follow-ups
Aaflyingto成员
7月9日 添加了label:risk/mediumscope/auth, status/triage,type/enhancement
Aaflyingto成员
7月9日 添加了label:status/in-progress, status/verified
Aaflyingto成员
7月9日 关联了pull request:fix: error message quality (ErrSecretDetected wrapping + 401 guidance) (#428, #432)
Aaflyingto成员
7月9日 关闭了 issue
Aaflyingto成员
7月9日 添加了label:status/merged