uniner-cli

uniner-cli 是 Uniner 的 RPA 自动化命令行工具，提供：

• Web 自动化 —— 浏览器抓取、表单填写、元素交互
• Excel 操作 —— 读写、批量处理、样式
• OCR 识别 —— 支持验证码和通用 OCR
• 桌面 / SAP 自动化 —— 支持桌面软件的自动化（仅 Windows）
• 通用工具 —— 加密、HTTP、邮件、文件、PDF、压缩、FTP

安装时会自动注册一个 Claude Code 技能（~/.claude/skills/uniner-cli/SKILL.md），让 Claude 一启动就能识别并调用本 CLI。

安装

全局安装：

npm install -g uniner-cli

当前目录安装：

npm install uniner-cli

本地安装后通常通过 npx uniner-cli --help 或项目里的 npm scripts 调用；只有全局安装才适合在任意终端直接运行 uniner-cli。

安装过程中会自动完成：

1. 下载并配置当前平台所需的 uniner-cli 运行时
2. 注册 Claude Code 技能
3. 准备 uniner-cli 命令入口

全局安装完成后任意终端：

uniner-cli --help

系统要求

| 项 | 要求 | |---|---| | 操作系统 | Windows 10/11 x64 · macOS 12+ ARM64 · Linux x64/ARM64 | | Node.js | >= 14 | | 磁盘空间 | ≥ 500 MB（单平台） | | 网络 | 能访问 static.uniner.com |

安装脚本会自动检测当前系统并下载对应版本。

使用示例

# 看一级命令
uniner-cli --help

# 浏览器自动化
uniner-cli web browser open --url "https://example.com"
uniner-cli web element click --xpath "//button[@id='submit']"
uniner-cli web element get-text --xpath "//h1"

# Excel
uniner-cli excel data read --file data.xlsx --cell A1
uniner-cli excel data write --file out.xlsx --cell B2 --value "hello"

# OCR
uniner-cli tool ocr ddddocr --img captcha.png

完整命令树（一级 + 二级 + 三级参数）可通过 uniner-cli --help 查看。

升级

npm update -g uniner-cli

或者重新安装：

npm install -g uniner-cli@latest

不支持降级。如需回滚，请手动卸载后再装旧版。

卸载

重要提示：直接使用 npm uninstall 可能无法清理运行时文件。 请使用 CLI 自带的一键卸载命令以确保完全清理。

推荐卸载流程：

uniner-cli uninstall

该命令会先清理运行时残留，再自动判断安装范围并移除 npm 包本体：

• 全局安装：执行 npm uninstall -g uniner-cli
• 本地安装：在当前项目执行 npm uninstall uniner-cli

如果自动判断不符合预期，可显式指定：

uniner-cli uninstall --global
uniner-cli uninstall --local

清理内容：

• ~/.uniner-cli/ 整个运行时目录（含所有版本）
• ~/.claude/skills/uniner-cli/SKILL.md 技能文件

~/.claude/skills/uniner-cli/scenarios/ 下用户积累的场景数据不会被删除，需手动清理。

备选方式（如果 npm 包已经先被卸载，uniner-cli 不在 PATH 上）：

node ~/.uniner-cli/cleanup.js

该脚本只清理运行时残留，不再卸载 npm 包本体。

环境变量

无需手动配置。全局安装时，npm 会把命令链接到全局 bin 目录；如果终端识别不到 uniner-cli，按下方排查 PATH。

故障排查

uniner-cli: command not found

确认 npm 全局 bin 在 PATH 上：

# macOS / Linux
npm config get prefix
echo $PATH | tr ':' '\n' | grep npm

# Windows (PowerShell)
npm config get prefix
$env:Path -split ';' | Where-Object { $_ -like '*npm*' }

如果没有，手动将 npm 全局 bin 目录加入 PATH：

• macOS / Linux: $(npm config get prefix)/bin
• Windows: %APPDATA%\npm

安装时下载失败 / 超时

公司代理或防火墙可能屏蔽 static.uniner.com。试试：

npm config get proxy
npm config get https-proxy
# 设置代理：
npm config set https-proxy http://your-proxy:port

安装卡住 / 解压慢

杀软（360 / 火绒）可能会扫描大量新文件，慢则 5–10 分钟。让它跑完即可。

想重装

uniner-cli uninstall
npm install -g uniner-cli

链接

• 官网：https://www.uniner.com/
• 技术支持：[email protected]
• Claude Code：https://claude.com/claude-code

Changelog

1.1.0 (2026-07-05)

• feat: SDK 1.24.0 同步 —— 新增 tool ftp 子命令（create-folder / check-folder / check-file / list-dir），跨平台可用
• feat: web browser close 现在自动终止残留 chrome.exe 进程，避免进程泄漏
• feat: tool zip 新增 --if-exists 参数控制文件已存在时的行为（Windows-only）

1.0.8 (2026-06-30)

• feat: 改进 uniner-cli uninstall，增强清理逻辑与兼容性
• feat: 新增 Linux ARM64 支持

1.0.7 (2026-06-29)

• fix: 新增 uniner-cli uninstall，自动判断全局 / 本地安装范围，完整清理运行时文件并移除 npm 包。

1.0.6 (2026-06-28)

• fix: 修复 npm uninstall -g uniner-cli 未清理 ~/.uniner-cli/ 和 ~/.claude/skills/uniner-cli/SKILL.md 的问题。

1.0.5 (2026-06-27)

• 首个公开版本，支持 Windows 10/11 (x64)、macOS (Apple Silicon)、Linux (x64)

License

Proprietary. (C) 2026 Uniner Tech.