[建议 / Feature] 官方 zcode 命令行版发行包稳定发布：`zcode --web` 浏览器工作台开箱即用，Coding Plan 权益对齐桌面版

[weiminghaoo]

问题类别 · Category

其他 / CLI 发行渠道 · Other (CLI distribution)（现有选项未覆盖，如归类有误请管理员调整）

涉及的 Agent 框架 · Agent framework

ZCode Agent（自研）

背景 · Background

官方仓库（zai-org/ZCode）README 的「ZCode 命令行版」章节已经定义了 zcode --web 浏览器工作台：发行包统一 zcode 启动，--web 默认监听 127.0.0.1、自动选空闲端口并打开浏览器，--host 0.0.0.0 支持局域网并自动生成访问令牌。能力在源码里已实现，但命令行发行包没有稳定发布渠道，用户实际拿不到：

1. 桌面版（实测 3.14.3，内置 CLI 0.16.9）的 runtime 不支持 --web（报 Unknown option '--web'），Web 前端不在桌面 bundle 内；
2. README 中的 CLI 安装脚本依赖 ZCODE_DIST_BASE_URL（发行包托管地址），公开渠道无成品可下载；
3. 社区方案在补位但不官方：zcode-app-cli（第三方重打包，架构仅 TUI，无 Web）、zcode-acp + zcode-acp-remote（ACP 桥 + 非官方中继的网页访问）。

用户价值 · Why it matters

1. 终端 / SSH / 无头场景覆盖：桌面版依赖 Electron + GUI；大量开发发生在 SSH 服务器、容器、CI 环境，这些场景只能用 CLI，桌面版无法安装；
2. 浏览器访问已是刚需：Remote Control（web/phone）的活跃 issue（[建议 / Feature] Remote Control (web/phone): show terminal session panel — not just chat #598、[BUG] Mobile Web Remote (zcode.z.ai): Context Window / Quota Button Unclickable on Touch Devices (CSS onHover event lock) #454、[Bug] 手机远程控制打不开大会话：报 fault.subscription.recoveryFailed，实际是中继帧超限 remote.rpcFrame.messageTooLarge #228、[Bug] 长文本粘贴在 web-remote 模式下失败：Failed to read attachment: [object Object] #351 等）证明官方 Web 访问有真实需求，但该链路绑定桌面会话；CLI 会话的浏览器访问（--web）目前没有任何官方途径；
3. 权益对齐：社区重打包 runtime 的 Coding Plan 权益不明确（[Q] 自行编译的开源版 ZCode CLI/TUI 是否享受 Coding Plan 1.5 倍使用额度（67% 扣减）？ #749 提出开源构建是否享受 1.5 倍额度尚无结论）。官方发行包能让 CLI/Web 会话与桌面版享受一致的客户端权益，避免用户被迫选择非官方路径。

与现有 issue 的关系 · Relation to existing issues

• 【建议】官方 zcode CLI（Windows/终端版）：稳定发布渠道 + 钩子面 + 无头模式，打通终端与编排生态 #444（官方 CLI 稳定发布渠道 + 钩子面 + 无头模式）：本条是其补充，聚焦 Web 工作台（--web） 维度，该维度在 【建议】官方 zcode CLI（Windows/终端版）：稳定发布渠道 + 钩子面 + 无头模式，打通终端与编排生态 #444 中未覆盖；
• [建议 / Feature] Remote Control (web/phone): show terminal session panel — not just chat #598 / [建议 / Feature] Remote Control 支持端口转发/网页代理,让手机直接访问开发机内网或虚拟机里的 Web 服务 #289（Remote Control 终端面板 / 端口转发）：针对桌面会话的远程增强，本条针对 CLI 会话的 Web 访问，互补关系；
• [Feature Request] Official ACP (Agent Client Protocol) Support & Native Client Bridge in ZCode #585（官方 ACP 支持）：不同接入协议维度；
• [Feature] CLI 无头执行（-p / --resume）无法使用 bigmodel.cn Coding Plan：login 仅支持 z.ai，且无 --model / API Key 直连入口 #837 / [Bug] zcode login 写入的 defaultModelSelection 未按实际权益选择品牌：bigmodel 权益账号 headless 全部报 [1113] 余额不足 #857（headless 下 bigmodel Coding Plan 可用性）：CLI 发行包落地后同样受益；
• [Bug] CLI 非 SEA 运行时无法定位 zcode-builtin.json：login 在 OAuth 授权完成后才报「无法定位 CLI ZCode Built-in Provider Config」 #855（CLI 非 SEA 运行时无法定位 zcode-builtin.json）：CLI 发行包统一打包假设后可一并消除。

期望形态 · Ask

1. 通过官方渠道（npm 或安装脚本）定期发布 CLI 发行包（TUI + Web + Agent，与桌面版同版本节奏）；
2. zcode --web 开箱即用：默认本机令牌认证，可选 --host 局域网访问；
3. CLI/Web 会话与桌面版共享同一套 Coding Plan 权益与凭据（~/.zcode/v2/provider_config.json 本就与桌面版共享，缺的只是官方发行物本身）。

环境 · Environment

• ZCode Desktop 3.14.3（内置 CLI 0.16.9），macOS arm64
• Node.js v22.23.2

[github-actions]

👋 感谢你的反馈，我们已经收到。

• 维护者看到后会尽快回复你。
• 状态保持为 status: 待评估，你可以随时补充信息。
• 信息不全时我们会打上 needs: 更多信息 标签并 @ 你。

---

👋 Thanks — we've received your issue.

• A maintainer will get back to you as soon as we can.
• Status stays at status: 待评估 (Triage); feel free to add context.
• If we need more details, we'll add needs: 更多信息 and ping you.