用途：zai-cli 是在终端中访问 Z.AI 能力的命令行工具，通过 npx zai-cli 运行，自带帮助信息，可在任意层级使用 --help 查看说明。
主要能力：vision 用于分析图像、截图和视频，含 OCR、UI 转代码、错误诊断（GLM-4.6V），含 8 个子命令；search 提供实时网页搜索，支持域名与时效过滤；read 将网页抓取为 Markdown；repo 支持 GitHub 代码搜索与读取（tree/search/read）；另有 tools、tool、call 用于列出 MCP 工具、查看工具 schema 与原始调用，code 用于 TypeScript 工具链，doctor 用于检查安装与连通性。
用法：先设置 export Z_AI_API_KEY="your-api-key"，密钥可在 https://z.ai/manage-apikey/apikey-list 获取。示例：npx zai-cli vision analyze ./screenshot.png "What errors do you see?"；npx zai-cli search "React 19 new features" --count 5；npx zai-cli read https://docs.example.com/api；npx zai-cli repo tree openai/codex --path codex-rs --depth 2；npx zai-cli doctor。输出默认为仅数据（便于节省 token），可用 --output-format json 获得 { success, data, timestamp } 包装。
适用场景：需要命令行内完成图像/视频理解、实时检索、网页正文提取与 GitHub 代码查阅的开发与调研流程。
限制：必须自备 API 密钥；视觉依赖 GLM-4.6V；高级原始 MCP 调用、Code Mode 与缓存/重试等性能调优见 references/advanced.md；其余收费与配额信息资料暂未提供。