@umengfe/umeng-cli

@umengfe/umeng-cli

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

安装

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

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

要求：Node.js >= 18

安装时会自动：

• 根据当前系统平台和架构下载对应的原生二进制文件（见下方平台表）
• 运行 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 冲突。