zai-org / zai-org/feedback

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

Open
#444 1 comment 4 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

priority: P2
Dominant language
No language data
Stars
22
Forks
1
PR merge metrics
No merged PRs in 30d

Description

请求(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 路径未打磨:#51(CLI missing @zcode/tui)、#337(zcode login 的 oauth/cli/init 端点 404)。
  4. #32 中提到的本地子进程钩子问题,也挡着第三方调度器的官方对接。

为什么需要(Why it matters)

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

期望形态(Ask)

  • 官方 npm(去掉占位)/winget 分发,zcode 命令开箱即用;
  • 与桌面同步(或至少有节奏)的版本发布 + 钩子机制文档化(含 Windows shell hooks,见 #441/#335);
  • headless / prompt-only 模式(供 CI 与编排 worker 使用);
  • 修复 #337 的 CLI OAuth 登录链路。

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

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading the linked context in #51, #337, #32, #441, and #335, then map the requested CLI, distribution, hooks, headless mode, and OAuth work to existing project entry points. Done would require an agreed implementation scope and roadmap covering the official Windows CLI, release channel, documented hooks, headless usage, and login flow.

Written by the indexing model from the issue text.

Assessment

Domain
cli, developer-experience, operating-systems
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.