Skip to content

【建议】官方 zcode CLI(Windows/终端版):稳定发布渠道 + 钩子面 + 无头模式,打通终端与编排生态 #444

Description

@justforyoudear

请求(Request)

希望 Z.ai 官方发布正式的 zcode CLI(终端命令行版):稳定二进制、官方发布渠道、与桌面版同版本的钩子(hooks)面、无头/prompt 模式。

现状(Current state)

  1. npm 上的 zcode-cli 至今仍是 0.0.1 占位包("full CLI under active development"),官方没有可用的命令行版;Windows 上尤其缺位。
  2. 社区包 zcode-app-cli(第三方重打包桌面引擎 + TUI)在补位,但不官方:版本滞后桌面、无官方支持通道。
  3. 已有相关 bug 链证实 CLI 路径未打磨:[Bug] ZCode 3.1.6 (macOS, Apple Silicon) unusable via every entry point: desktop EPIPE + blank renderer; CLI missing @zcode/tui; CLI login "OAuth response is not valid JSON" (model & plan are fine) #51(CLI missing @zcode/tui)、[Bug] zcode login 失败:oauth/cli/init 端点在生产后端 404(空响应体)导致 OAuth response is not valid JSON #337(zcode login 的 oauth/cli/init 端点 404)。
  4. Native ZCode Agent does not trigger hooks configured in ~/.zcode/cli/config.json #32 中提到的本地子进程钩子问题,也挡着第三方调度器的官方对接。

为什么需要(Why it matters)

  1. 终端原生工作流:很多重度用户(包括我)主用终端 TUI + 快捷键,SSH/无头服务器上也无法跑桌面版。
  2. 智能体编排生态:Orca 等 ADE 调度器要支持 zcode 做并行 worker / 状态钩子上报,前提是官方稳定 CLI + 稳定的 SessionStart/PreToolUse/Stop 等钩子事件面——社区已把需求单推到 feat(agents): add ZCode as a first-class supported agent stablyai/orca#13965(ZCode first-class agent PR),现在缺的正是官方这一侧的地基。
  3. 身份与信任:官方 CLI 才能被正式收录进 models.dev/代理目录、被 CI/脚本稳定引用,社区包装无法承担这个角色。

期望形态(Ask)

(若已有内部路线图,哪怕一个「计划中」的回复也能大幅降低社区自行造轮子的成本。)

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions