[Bug] macOS 桌面端 Start Plan 验证码校验失败,出现 captcha verify failed / guard.actionUnavailable
Nobody has claimed this yet.
- Dominant language
- No language data
- Stars
- 22
- Forks
- 1
- PR merge metrics
- No merged PRs in 30d
Description
提交前确认 · Pre-submission checklist
- 我已搜索过现有 issue,确认这不是重复 / I searched existing issues and confirmed this isn't a duplicate.
- 我已阅读 CONTRIBUTING.md / I've read CONTRIBUTING.md.
问题类别 · Category
账号 / 登录 · Account / Login
涉及的 Agent 框架 · Agent framework
ZCode Agent(自研)
严重程度 · Severity
阻塞使用 · Blocking (无法使用核心功能 / core function unusable)
复现频率 · Reproducibility
必现 · Always
问题描述 · Description
在 macOS ZCode Desktop 3.11.2 中,内置 Start Plan Provider builtin:zai-start-plan 无法正常调用模型。
GLM-5.3 和 GLM-5.3-Flash 均可稳定复现。
ZCode 有时直接提示:
验证码校验失败,请重试。
captcha_edit_not_accepted:rejected:guard.actionUnavailable
有时则只显示:
Model request failed.
Turn execution failed
provider=builtin:zai-start-plan
model=GLM-5.3-Flash
reason=unknown
retryable=false
[object Object]
进一步检查 ~/.zcode/cli/log/ 和 model I/O 日志后,可以看到实际的 Provider 错误为:
HTTP 400
providerCode=3007
providerMessage="captcha verify failed"
reason=auth_failed
retryable=false
目前已经尝试退出账号重新登录、完全重启 ZCode、创建全新对话,并在新对话中仅发送 hello,问题仍然稳定复现。
与已有 Issue 的关系
提交前已检查以下相关 Issue:
- #349:Windows Desktop 下 Aliyun CAPTCHA
getInstance超时,并伴随3007 captcha verify failed。 - #548:Remote DevContainer attached 模式下出现
3007 captcha verify failed,重新登录后 CAPTCHA 交互出现captcha_edit_not_accepted:rejected:guard.actionUnavailable。
本问题与 #548 的错误表现高度相似,但复现环境不同:
本问题发生在原生 macOS ZCode Desktop 的本地工作区,不涉及 Remote / SSH / WSL / Docker / DevContainer。
因此这可能与 #548 共享部分 CAPTCHA / guard 处理逻辑,但目前的复现结果表明,该问题并非仅存在于 Remote Attached / Headless 环境。
复现步骤 · Steps to reproduce
-
在 macOS 上启动 ZCode Desktop。
-
登录拥有有效 Start Plan 的 Z.ai 账号。
-
使用内置 Provider
builtin:zai-start-plan。 -
选择
GLM-5.3-Flash。 -
创建一个全新的对话。
-
仅发送:
hello -
模型请求失败,出现
Model request failed或验证码校验错误。 -
切换至
GLM-5.3后再次发送消息,同样失败。
另外已经尝试:
- 退出 Z.ai 账号并重新登录
- 完全退出并重新启动 ZCode
- 重新登录后创建全新对话
- 在全新对话中仅发送
hello - 在
GLM-5.3与GLM-5.3-Flash之间切换
以上操作均无法恢复 Start Plan。
期望表现 · Expected behavior
当 Start Plan 后端要求 CAPTCHA 验证时,ZCode Desktop 应能够正常执行或展示 CAPTCHA challenge,获得有效的验证结果并继续模型请求。
如果 CAPTCHA 无法完成,也应该在 UI 中展示真实的 Provider 错误,而不是:
reason=unknown
[object Object]
实际表现 · Actual behavior
Start Plan 请求会很快失败。
其中一种 UI 错误为:
验证码校验失败,请重试。
captcha_edit_not_accepted:rejected:guard.actionUnavailable
另一种表现为:
Model request failed.
Turn execution failed
provider=builtin:zai-start-plan
model=GLM-5.3-Flash
request=33b9775f-6b79-4a11-b6e2-e7e408cdc4f3
reason=unknown
retryable=false
[object Object]
CLI 日志中可以看到实际请求失败原因为:
providerId=builtin:zai-start-plan
baseURL=https://zcode.z.ai/api/v1/zcode-plan/anthropic
statusCode=400
statusMessage="captcha verify failed"
reason=auth_failed
retryable=false
嵌套 Provider 错误为:
providerCode=3007
code=PROVIDER_BUSINESS_ERROR
providerMessage="captcha verify failed"
responseStatus=400
reason=auth_failed
GLM-5.3 和 GLM-5.3-Flash 均可复现。
ZCode 版本 · ZCode version
3.11.2
设备 / 系统 / 浏览器 · Device / OS / Browser
- 设备:MacBook Air
- 系统:macOS 26.6
- 架构:Apple Silicon / arm64
- 客户端:ZCode Desktop
- 本地 Workspace
- 非 Remote / SSH / WSL / Docker / DevContainer 环境
截图 / 录屏 / 日志 · Screenshots / Recordings / Logs
核心 CAPTCHA 错误:
captcha_edit_not_accepted:rejected:guard.actionUnavailable
Start Plan 后端返回:
HTTP 400
providerCode=3007
providerMessage="captcha verify failed"
reason=auth_failed
retryable=false
相关 TraceID:
ceb35206-309a-4afd-85dd-756df5347a37
aaf53155-3f53-4dbe-9bc0-0cf32f92ebd3
重新登录、完全重启 ZCode 并创建全新对话后产生的 Request ID:
33b9775f-6b79-4a11-b6e2-e7e408cdc4f3
另外,日志中还观察到一些可能相关的客户端状态异常:
provider "builtin:zai-start-plan" is not in the workspace model registry
以及:
session.model_selection.persist_failed
FOREIGN KEY constraint failed
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Reproduce the failure in ZCode Desktop 3.11.2 with builtin:zai-start-plan and inspect ~/.zcode/cli/log/ plus the model I/O logs, using the reported providerCode=3007 and guard.actionUnavailable errors as entry points. Done means the CAPTCHA challenge can be completed and the model request proceeds, or the UI exposes the actual provider error instead of reason=unknown and [object Object].
Written by the indexing model from the issue text.
Assessment
- Tech stack
- macos
- Domain
- authentication, desktop
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100