用途：让当前代理通过 shell 调用 ZCode（z.ai，GLM 引擎）桌面应用作为编码子代理，把任务派发进去、检测完成并读取结构化摘要，从而以固定的极小 token 成本获知结果。适合无需独立 z.ai API 密钥（应用内已登录的 coding plan 即可）的自动化，或需要在同一会话中追加提示。
主要能力：一是派发提示并等待回合结束（阻塞式，不轮询屏幕）；二是读取本地会话数据库中的紧凑 JSON 摘要，包含模型、结束原因、token 数、每次工具调用一行记录和最终文本；三是通过命令处理错误、权限弹窗与工作区。
使用方式（命令保持原样）： python3 scripts/zcode_agent.py run "Refactor the parser and run the tests" 其中 run 为一次性（派发+等待+摘要），--follow 用于同一会话追问，另有 send / wait / digest / workspace / mode / approve / errors 等子命令。
限制与注意：仅实现 macOS 自动启动，其他平台需手动以 --remote-debugging-port=<port> 启动并传 --port；需已登录 ZCode.app、agent-browser、node、python3、curl；不要预先安装或预检依赖，仅在运行确实失败时诊断；不要截图或抓取完整记录；同一时间只运行一个顶层任务；接口可能因验证码或计划限制返回不可重试错误，此时应停止并告知用户。