zen-cli

面向 AI 和人的 Zen Cloud 命令行工具。

使用

前置条件

• Python 3.14+
• uv 或 pipx

安装

uv tool install zen-cli --upgrade --python 3.14

或：

pipx install --upgrade zen-cli --python 3.14 --fetch-python missing

装完后若找不到 zen，跑 uv tool update-shell 或 pipx ensurepath，然后开一个新终端。Windows 同样适用。

使用 CLI

# 登录
zen auth login

# 跑一条命令，例如列出桌面池：
zen daas pool list

# 以可读方式输出
zen daas pool list -otable

# 更新
zen upgrade

文档

• 用户指南 — 鉴权、旗标、请求体和命令约定
• 资源与意图 — 名词、身份、从属、允许的意图
• 配置 — 优先级、profile、features、环境变量
• 速查 — 命令示例
• 开发指南 — 环境、./dev / dev.cmd、如何加命令
• [CLI UX原则](docs/CLI UX原则.md) — 退出码、输出格式、通用参数和特例
• 架构原则 — 意图与资源、包划分和导入方向
• Changelog — 版本记录

许可证

采用 MIT License。见 LICENSE。