安装与升级
环境要求
- 操作系统：macOS / Linux / Windows
- Node.js：推荐 20 或 22 LTS；最低兼容 16（16 已停止安全维护，建议升级）
- npm：随 Node 安装即可
平台兼容矩阵
| 操作系统 | amd64 | arm64 | 备注 |
|---|---|---|---|
| macOS | 支持 | 支持 | Intel 与 Apple Silicon |
| Linux | 支持 | 支持 | 常见发行版；依赖常规 glibc 环境 |
| Windows | 支持 | 不支持 | 当前仅提供 amd64；可用 WSL |
另支持：非交互 CI（跳过安装向导）、容器（需能下载二进制）、Windows 下 PowerShell / CMD。
安装
方式一：一键安装
npx @kuaimai-cli/cli@latest install
交互环境可能弹出授权向导（可稍后登录）。CI / 非 TTY 会跳过向导。
方式二：Agent 安装
帮我安装快麦 CLI：https://gitee.com/kuaimai-cli/kuaimai-cli/blob/main/docs/KUAIMAI_CLI_INSTALL_GUIDE_AGENT.md
固定版本
npm install -g @kuaimai-cli/cli@0.2.27
升级
kuaimai-cli upgrade
# 仅检查是否有新版本
kuaimai-cli upgrade --check-only --output json
# 或
npx @kuaimai-cli/cli@latest install
查看版本：kuaimai-cli --version
卸载
npm uninstall -g @kuaimai-cli/cli
可选手动删除（先备份）：
~/.kuaimai-cli/ # 配置与 registry 缓存
~/.agents/skills/ # 若曾安装到该目录
~/.cursor/skills/ # 若曾安装到 Cursor
默认不会自动清理上述目录。
网络依赖
安装时大致顺序：
- 从 Gitee Releases 下载 Go 二进制
- Gitee 不可用时回退 npmmirror
- 校验 checksum
可能访问的主机：
registry.npmjs.org（或你配置的 npm registry）
gitee.com
registry.npmmirror.com
快麦 ERP / SCM 业务域名（运行时）
open-cli.kuaimai.com（系统网关 / registry）
gw.superboss.cc（开放平台）
企业网络需放行上述域名；可用代理时配置系统/ npm 代理。Gitee 失败时可试：
KUAIMAI_CLI_PREFER_MIRROR=1 npx @kuaimai-cli/cli@latest install
Shell 补全
kuaimai-cli completion bash
kuaimai-cli completion zsh
kuaimai-cli completion powershell
将输出写入 shell 补全目录并重新加载（以本机 bash-completion / zsh fpath 习惯为准）。例如 zsh：
mkdir -p ~/.zfunc
kuaimai-cli completion zsh > ~/.zfunc/_kuaimai-cli
# 在 ~/.zshrc 中确保：fpath=($HOME/.zfunc $fpath) 且已 compinit