@umengfe/umeng-cli

友盟命令行工具 - 让人类和 AI Agent 都能在终端中操作友盟平台。

安装

# 全局安装
npm install -g @umengfe/umeng-cli

# 或无需安装，直接用 npx 运行
npx @umengfe/umeng-cli --version

要求：Node.js >= 18

安装时会自动：

1. 根据当前系统平台和架构下载对应的原生二进制文件（见下方平台表）
2. 运行 umeng-cli skills install 将 Agent Skills 部署到已检测到的 AI Agent 平台目录（Claude Code、Cursor、Gemini CLI 等）

支持的平台

| 平台 | 架构 | NPM 包 | |------|------|--------| | macOS | Apple Silicon (ARM64) | @umengfe/umeng-cli-darwin-arm64 | | macOS | Intel (x64) | @umengfe/umeng-cli-darwin-x64 | | Linux | x86_64 | @umengfe/umeng-cli-linux-x64 | | Linux | ARM64 | @umengfe/umeng-cli-linux-arm64 | | Windows | x64 | @umengfe/umeng-cli-win32-x64 | | Windows | ARM64 | @umengfe/umeng-cli-win32-arm64 |

npm 通过 optionalDependencies 自动安装对应平台的包，无需手动选择。

快速开始

# 验证安装
umeng-cli --version

# 登录友盟
umeng-cli login

# 查看帮助
umeng-cli --help

# 查看已加载的 Skills
umeng-cli skills list

# 查看 Skill 详细用法
umeng-cli skills show <skill-name>

AI Agent 非交互式登录

在 AI Agent 终端中（如 Claude Code、Cursor），推荐使用两步非阻塞登录流程：

# 步骤一：生成登录链接，立即返回（不阻塞）
umeng-cli login start --no-qr

# 用户在浏览器中打开返回的链接完成登录

# 步骤二：完成登录验证并保存凭证
umeng-cli login complete

登录完成后运行 umeng-cli whoami 确认登录状态，之后即可调用所有命令。

命令速查

| 命令 | 说明 | |------|------| | login | 登录/重新登录（支持交互式和非交互式） | | logout | 登出当前账号并清除本地凭证 | | whoami | 查看当前登录状态和用户信息 | | account list | 列出所有已登录账号 | | account switch | 切换当前使用的账号 | | skills list | 列出所有已加载的 Skills | | skills show <name> | 查看 Skill 详细内容 | | skills install <name> | 从 Registry 安装 Skill | | skills update | 更新已安装的 Skill | | skills uninstall <name> | 卸载已安装的 Skill | | call '<schema>' '<args>' | 通用 API 调用（传入 tool schema JSON） | | openapi enable | 开通友盟 OpenAPI 并自动获取 API 密钥 | | self update | 检查并更新 umeng-cli 到最新版本 | | uninstall | 卸载 umeng-cli（删除二进制、Skills 和配置） |

升级

# 更新到最新版本
npm update -g @umengfe/umeng-cli

# 安装指定版本
npm install -g @umengfe/umeng-cli@<version>

注意：npm 安装方式下，umeng-cli self update 不可用。npm 版本由 @umengfe/umeng-cli 主包和平台包共同管理，直接替换二进制会破坏版本一致性，请始终通过 npm 更新。

卸载

# 使用内置卸载命令（删除二进制、Skills 和配置）
umeng-cli uninstall

# 或通过 npm 卸载
npm uninstall -g @umengfe/umeng-cli

其他安装方式

如果不想通过 npm 安装，也可以使用在线脚本：

# Shell 脚本安装（macOS / Linux）
curl -fsSL https://um-community.oss-cn-zhangjiakou.aliyuncs.com/umeng-cli/install.sh | sh

# PowerShell 安装（Windows）
irm https://um-community.oss-cn-zhangjiakou.aliyuncs.com/umeng-cli/install.ps1 | iex

提示：安装脚本支持 SHA256 校验和验证，且可通过 umeng-cli self update 自更新。如果同时使用 npm 和脚本安装，postinstall 脚本会检测并提醒 PATH 冲突。