uniner-cli 1.0.3 → 1.0.5

package/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2026 Uniner Tech. All rights reserved.
-
-This software is proprietary. Use is subject to the terms of the
-license agreement at https://www.uniner.com/.
+Copyright (c) 2026 Uniner Tech. All rights reserved.
+
+This software is proprietary. Use is subject to the terms of the
+license agreement at https://www.uniner.com/.

package/README.md

@@ -1,171 +1,161 @@
-# uniner-cli
-
-`uniner-cli` 是 [Uniner](https://www.uniner.com/) 的 RPA 自动化命令行工具，提供：
-
-- **Web 自动化**（Playwright + CDP）—— 浏览器抓取、表单填写、元素交互
-- **Excel 操作** —— 读写、批量处理、样式
-- **OCR 识别** —— ddddocr（验证码）+ PaddleOCR（通用）
-- **桌面 / SAP 自动化**（仅 Windows）
-- **通用工具** —— 加密、HTTP、邮件、文件、PDF、压缩
-
-安装时会自动注册一个 [Claude Code](https://claude.com/claude-code) 技能（`~/.claude/skills/uniner-cli/SKILL.md`），让 Claude 一启动就能识别并调用本 CLI。
-
----
-
-## 安装
-
-```bash
-npm install -g uniner-cli
-```
-
-安装过程：
-
-1. npm 装本壳包（约 50KB）
-2. `postinstall` 钩子根据当前平台从 `static.uniner.com` 拉取便携包：
-   - Windows: `uniner-cli-v<version>-win-x64.zip`
-   - Linux: `uniner-cli-v<version>-linux-x64.tar.gz`
-3. 解压到用户目录：
-   - Windows: `%USERPROFILE%\.uniner-cli\<version>\`
-   - Linux: `~/.uniner-cli/<version>/`
-4. 写入 Claude Code skill：`~/.claude/skills/uniner-cli/SKILL.md`
-
-完成后任意终端：
-
-```bash
-uniner-cli --help
-```
-
-## 系统要求
-
-| 项 | 要求 |
-|---|---|
-| 操作系统 | Windows 10/11 x64；Ubuntu 24.04+ x64 |
-| Node.js | >= 14 |
-| 磁盘空间 | ≥ 1.5 GB |
-| 网络 | 能访问 `static.uniner.com` |
-
-Linux 说明：
-- Linux 包当前基于 Ubuntu 24.04 / glibc 2.39 构建和验证。
-- 已验证模块：`tool` / `excel` / `skill` / `ddddocr OCR`。
-- `web` 模块需要目标机安装 Chrome/Chromium。
-- `desktop` 模块不支持 Linux。
-
-## 使用示例
-
-```bash
-# 看一级命令
-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
-```
-
-完整命令树（一级 + 二级 + 三级参数）见安装后：
-- Windows: `%USERPROFILE%\.uniner-cli\<version>\skills\cli\SKILL.md`
-- Linux: `~/.uniner-cli/<version>/skills/cli/SKILL.md`
-
-## 升级
-
-```bash
-npm update -g uniner-cli
-```
-
-或者重新安装：
-
-```bash
-npm install -g uniner-cli@latest
-```
-
-> 不支持降级。如需回滚，请手动卸载后再装旧版。
-
-## 卸载
-
-```bash
-# 1. 先清理运行时数据（删 ~/.uniner-cli/ 和 Claude Code 技能）
-uniner-cli-uninstall
-
-# 2. 再卸载 npm 包本身
-npm uninstall -g uniner-cli
-```
-
-> **为什么是两步？** npm 7+ 出于安全考虑不再在卸载时运行 lifecycle 脚本，所以我们提供 `uniner-cli-uninstall` 命令让你显式触发清理。
-
-清理会移除：
-
-- `%USERPROFILE%\.uniner-cli\<version>\` 安装目录
-- `%USERPROFILE%\.claude\skills\uniner-cli\SKILL.md` 技能
-
-## 环境变量
-
-无需手动配置。npm 全局 bin 目录已自动加入 PATH。
-
-## 故障排查
-
-### `uniner-cli: command not found`
-
-确认 npm 全局 bin 在 PATH 上：
-
-```powershell
-npm config get prefix
-# 应输出类似 C:\Users\xxx\AppData\Roaming\npm
-$env:Path -split ';' | Where-Object { $_ -like '*npm*' }
-```
-
-如果没有，手动加 `%APPDATA%\npm` 到 PATH。
-
-### 安装时下载失败 / 超时
-
-公司代理或防火墙可能屏蔽 `static.uniner.com`。试试：
-
-```bash
-npm config get proxy
-npm config get https-proxy
-# 设置代理：
-npm config set https-proxy http://your-proxy:port
-```
-
-或者直接走原生安装方式（不走 npm）：
-
-```powershell
-iwr https://static.uniner.com/soft/editor/uninercli/install.ps1 -UseBasicParsing | iex
-```
-
-### postinstall 卡在解压
-
-杀软（360 / 火绒）会扫描 1279 个新文件，慢则 5–10 分钟。让它跑完即可。
-
-### 想重装
-
-```bash
-npm uninstall -g uniner-cli
-npm install -g uniner-cli
-```
-
-## 备选安装方式（不走 npm）
-
-如果你不想要 Node.js 依赖，可以用 PowerShell 一行安装（基于 Inno Setup 安装器）：
-
-```powershell
-iwr https://static.uniner.com/soft/editor/uninercli/install.ps1 -UseBasicParsing | iex
-```
-
-两种方式互不干扰，但**不要**同时启用——会有两份 SKILL.md / 两份二进制。
-
-## 链接
-
-- 官网：[https://www.uniner.com/](https://www.uniner.com/)
-- 技术支持：support@uniner.com
-- Claude Code：[https://claude.com/claude-code](https://claude.com/claude-code)
-
-## License
-
-Proprietary. (C) 2026 Uniner Tech.
+# uniner-cli
+
+`uniner-cli` 是 [Uniner](https://www.uniner.com/) 的 RPA 自动化命令行工具，提供：
+
+- **Web 自动化**（Playwright + CDP）—— 浏览器抓取、表单填写、元素交互
+- **Excel 操作** —— 读写、批量处理、样式
+- **OCR 识别** —— ddddocr（验证码）+ PaddleOCR（通用）
+- **桌面 / SAP 自动化**（仅 Windows）
+- **通用工具** —— 加密、HTTP、邮件、文件、PDF、压缩
+
+安装时会自动注册一个 [Claude Code](https://claude.com/claude-code) 技能（`~/.claude/skills/uniner-cli/SKILL.md`），让 Claude 一启动就能识别并调用本 CLI。
+
+---
+
+## 安装
+
+```bash
+npm install -g uniner-cli
+```
+
+安装过程：
+
+1. npm 装本壳包（约 50KB）
+2. `postinstall` 钩子从 `static.uniner.com` 拉取约 250MB 便携包
+3. 解压到 `%USERPROFILE%\.uniner-cli\<version>\`
+4. 写入 `%USERPROFILE%\.claude\skills\uniner-cli\SKILL.md`
+
+完成后任意终端：
+
+```bash
+uniner-cli --help
+```
+
+## 系统要求
+
+| 项 | 要求 |
+|---|---|
+| 操作系统 | 64 位 Windows 10 / 11 |
+| Node.js | >= 14 |
+| 磁盘空间 | ≥ 1.5 GB |
+| 网络 | 能访问 `static.uniner.com` |
+
+> Linux / macOS 支持在路上。
+
+## 使用示例
+
+```bash
+# 看一级命令
+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
+```
+
+完整命令树（一级 + 二级 + 三级参数）见安装后 `%USERPROFILE%\.uniner-cli\<version>\skills\cli\SKILL.md`。
+
+## 升级
+
+```bash
+npm update -g uniner-cli
+```
+
+或者重新安装：
+
+```bash
+npm install -g uniner-cli@latest
+```
+
+> 不支持降级。如需回滚，请手动卸载后再装旧版。
+
+## 卸载
+
+```bash
+# 1. 先清理运行时数据（删 ~/.uniner-cli/ 和 Claude Code 技能）
+uniner-cli-uninstall
+
+# 2. 再卸载 npm 包本身
+npm uninstall -g uniner-cli
+```
+
+> **为什么是两步？** npm 7+ 出于安全考虑不再在卸载时运行 lifecycle 脚本，所以我们提供 `uniner-cli-uninstall` 命令让你显式触发清理。
+
+清理会移除：
+
+- `%USERPROFILE%\.uniner-cli\<version>\` 安装目录
+- `%USERPROFILE%\.claude\skills\uniner-cli\SKILL.md` 技能
+
+## 环境变量
+
+无需手动配置。npm 全局 bin 目录已自动加入 PATH。
+
+## 故障排查
+
+### `uniner-cli: command not found`
+
+确认 npm 全局 bin 在 PATH 上：
+
+```powershell
+npm config get prefix
+# 应输出类似 C:\Users\xxx\AppData\Roaming\npm
+$env:Path -split ';' | Where-Object { $_ -like '*npm*' }
+```
+
+如果没有，手动加 `%APPDATA%\npm` 到 PATH。
+
+### 安装时下载失败 / 超时
+
+公司代理或防火墙可能屏蔽 `static.uniner.com`。试试：
+
+```bash
+npm config get proxy
+npm config get https-proxy
+# 设置代理：
+npm config set https-proxy http://your-proxy:port
+```
+
+或者直接走原生安装方式（不走 npm）：
+
+```powershell
+iwr https://static.uniner.com/soft/editor/uninercli/install.ps1 -UseBasicParsing | iex
+```
+
+### postinstall 卡在解压
+
+杀软（360 / 火绒）会扫描 1279 个新文件，慢则 5–10 分钟。让它跑完即可。
+
+### 想重装
+
+```bash
+npm uninstall -g uniner-cli
+npm install -g uniner-cli
+```
+
+## 备选安装方式（不走 npm）
+
+如果你不想要 Node.js 依赖，可以用 PowerShell 一行安装（基于 Inno Setup 安装器）：
+
+```powershell
+iwr https://static.uniner.com/soft/editor/uninercli/install.ps1 -UseBasicParsing | iex
+```
+
+两种方式互不干扰，但**不要**同时启用——会有两份 SKILL.md / 两份二进制。
+
+## 链接
+
+- 官网：[https://www.uniner.com/](https://www.uniner.com/)
+- 技术支持：support@uniner.com
+- Claude Code：[https://claude.com/claude-code](https://claude.com/claude-code)
+
+## License
+
+Proprietary. (C) 2026 Uniner Tech.

package/bin/uniner-cli-uninstall.js

@@ -1,145 +1,145 @@
-#!/usr/bin/env node
-// uniner-cli-uninstall - removes the runtime tree and Claude Code skill.
-//
-// npm 7+ no longer runs preuninstall/postuninstall lifecycle scripts on
-// uninstall (security tightening). So we ship this command for users to
-// run BEFORE `npm uninstall -g uniner-cli` to clean their machine.
-//
-// Recommended workflow:
-//   uniner-cli-uninstall              # this script: clean ~/.uniner-cli/ + skill
-//   npm uninstall -g uniner-cli       # npm: remove the npm package itself
-//
-// Idempotent: if files are already gone, just no-ops.
-
-'use strict';
-
-const fs   = require('fs');
-const path = require('path');
-
-const {
-    pkg,
-    rootDir,
-    versionDir,
-    skillDir,
-    skillFile,
-} = require('../lib/paths');
-
-function log(msg)  { console.log(`[uniner-cli] ${msg}`); }
-function warn(msg) { console.warn(`[uniner-cli] [WARN] ${msg}`); }
-
-function rmRf(p) {
-    try {
-        if (fs.existsSync(p)) {
-            fs.rmSync(p, { recursive: true, force: true });
-            log(`Removed ${p}`);
-            return true;
-        }
-        return false;
-    } catch (e) {
-        warn(`Could not remove ${p}: ${e.message}`);
-        return false;
-    }
-}
-
-function rmFile(p) {
-    try {
-        if (fs.existsSync(p)) {
-            fs.unlinkSync(p);
-            log(`Removed ${p}`);
-            return true;
-        }
-        return false;
-    } catch (e) {
-        warn(`Could not remove ${p}: ${e.message}`);
-        return false;
-    }
-}
-
-function main() {
-    console.log('');
-    console.log('==========================================');
-    console.log('  uniner-cli uninstall cleanup');
-    console.log('==========================================');
-
-    const myVersion = pkg.version;
-    const myVersionDir = versionDir(myVersion);
-    let didSomething = false;
-
-    // 1. Remove our version's runtime tree.
-    if (rmRf(myVersionDir)) didSomething = true;
-
-    // 2. If ~/.uniner-cli/ has no other versions, drop the whole directory.
-    try {
-        const root = rootDir();
-        if (fs.existsSync(root)) {
-            const remaining = fs.readdirSync(root);
-            if (remaining.length === 0) {
-                fs.rmdirSync(root);
-                log(`Removed empty ${root}`);
-                didSomething = true;
-            } else {
-                log(`Other uniner-cli versions still installed: ${remaining.join(', ')}`);
-                log(`Keeping ${root}`);
-            }
-        }
-    } catch (e) {
-        warn(`Could not inspect ${rootDir()}: ${e.message}`);
-    }
-
-    // 3. Remove ONLY the SKILL.md file. NEVER rm -rf the whole skill dir,
-    //    because the user's accumulated scenarios/<name>/ subdirectories
-    //    live there and represent real work they've sedimented over time.
-    //    If they really want everything gone they can do it manually; we
-    //    surface the path below so they know where to look.
-    const dir = skillDir();
-    if (rmFile(skillFile())) didSomething = true;
-
-    // 4. Look for scenarios/ — if there are any, keep them and tell the user.
-    let scenariosKept = 0;
-    const scenariosDir = path.join(dir, 'scenarios');
-    if (fs.existsSync(scenariosDir)) {
-        try {
-            scenariosKept = fs.readdirSync(scenariosDir).filter(n => {
-                const meta = path.join(scenariosDir, n, 'meta.json');
-                return fs.existsSync(meta);
-            }).length;
-        } catch (_) {
-            // best-effort
-        }
-    }
-
-    // 5. If skill dir is now genuinely empty, remove it. Otherwise keep it.
-    try {
-        if (fs.existsSync(dir)) {
-            const remaining = fs.readdirSync(dir);
-            if (remaining.length === 0) {
-                fs.rmdirSync(dir);
-                log(`Removed empty ${dir}`);
-                didSomething = true;
-            }
-        }
-    } catch (_) {
-        // best-effort
-    }
-
-    if (!didSomething) {
-        log('Nothing to clean — already removed.');
-    }
-
-    console.log('');
-    if (scenariosKept > 0) {
-        console.log('==========================================');
-        console.log(`  ${scenariosKept} scenario(s) PRESERVED at:`);
-        console.log(`    ${scenariosDir}`);
-        console.log('  (your accumulated knowledge — not deleted)');
-        console.log('  To delete them too:');
-        console.log(`    rm -rf "${scenariosDir}"          # bash`);
-        console.log(`    Remove-Item "${scenariosDir}" -Recurse -Force   # PowerShell`);
-        console.log('==========================================');
-    }
-    console.log('Cleanup done. To complete uninstall, also run:');
-    console.log('  npm uninstall -g uniner-cli');
-    console.log('');
-}
-
-main();
+#!/usr/bin/env node
+// uniner-cli-uninstall - removes the runtime tree and Claude Code skill.
+//
+// npm 7+ no longer runs preuninstall/postuninstall lifecycle scripts on
+// uninstall (security tightening). So we ship this command for users to
+// run BEFORE `npm uninstall -g uniner-cli` to clean their machine.
+//
+// Recommended workflow:
+//   uniner-cli-uninstall              # this script: clean ~/.uniner-cli/ + skill
+//   npm uninstall -g uniner-cli       # npm: remove the npm package itself
+//
+// Idempotent: if files are already gone, just no-ops.
+
+'use strict';
+
+const fs   = require('fs');
+const path = require('path');
+
+const {
+    pkg,
+    rootDir,
+    versionDir,
+    skillDir,
+    skillFile,
+} = require('../lib/paths');
+
+function log(msg)  { console.log(`[uniner-cli] ${msg}`); }
+function warn(msg) { console.warn(`[uniner-cli] [WARN] ${msg}`); }
+
+function rmRf(p) {
+    try {
+        if (fs.existsSync(p)) {
+            fs.rmSync(p, { recursive: true, force: true });
+            log(`Removed ${p}`);
+            return true;
+        }
+        return false;
+    } catch (e) {
+        warn(`Could not remove ${p}: ${e.message}`);
+        return false;
+    }
+}
+
+function rmFile(p) {
+    try {
+        if (fs.existsSync(p)) {
+            fs.unlinkSync(p);
+            log(`Removed ${p}`);
+            return true;
+        }
+        return false;
+    } catch (e) {
+        warn(`Could not remove ${p}: ${e.message}`);
+        return false;
+    }
+}
+
+function main() {
+    console.log('');
+    console.log('==========================================');
+    console.log('  uniner-cli uninstall cleanup');
+    console.log('==========================================');
+
+    const myVersion = pkg.version;
+    const myVersionDir = versionDir(myVersion);
+    let didSomething = false;
+
+    // 1. Remove our version's runtime tree.
+    if (rmRf(myVersionDir)) didSomething = true;
+
+    // 2. If ~/.uniner-cli/ has no other versions, drop the whole directory.
+    try {
+        const root = rootDir();
+        if (fs.existsSync(root)) {
+            const remaining = fs.readdirSync(root);
+            if (remaining.length === 0) {
+                fs.rmdirSync(root);
+                log(`Removed empty ${root}`);
+                didSomething = true;
+            } else {
+                log(`Other uniner-cli versions still installed: ${remaining.join(', ')}`);
+                log(`Keeping ${root}`);
+            }
+        }
+    } catch (e) {
+        warn(`Could not inspect ${rootDir()}: ${e.message}`);
+    }
+
+    // 3. Remove ONLY the SKILL.md file. NEVER rm -rf the whole skill dir,
+    //    because the user's accumulated scenarios/<name>/ subdirectories
+    //    live there and represent real work they've sedimented over time.
+    //    If they really want everything gone they can do it manually; we
+    //    surface the path below so they know where to look.
+    const dir = skillDir();
+    if (rmFile(skillFile())) didSomething = true;
+
+    // 4. Look for scenarios/ — if there are any, keep them and tell the user.
+    let scenariosKept = 0;
+    const scenariosDir = path.join(dir, 'scenarios');
+    if (fs.existsSync(scenariosDir)) {
+        try {
+            scenariosKept = fs.readdirSync(scenariosDir).filter(n => {
+                const meta = path.join(scenariosDir, n, 'meta.json');
+                return fs.existsSync(meta);
+            }).length;
+        } catch (_) {
+            // best-effort
+        }
+    }
+
+    // 5. If skill dir is now genuinely empty, remove it. Otherwise keep it.
+    try {
+        if (fs.existsSync(dir)) {
+            const remaining = fs.readdirSync(dir);
+            if (remaining.length === 0) {
+                fs.rmdirSync(dir);
+                log(`Removed empty ${dir}`);
+                didSomething = true;
+            }
+        }
+    } catch (_) {
+        // best-effort
+    }
+
+    if (!didSomething) {
+        log('Nothing to clean — already removed.');
+    }
+
+    console.log('');
+    if (scenariosKept > 0) {
+        console.log('==========================================');
+        console.log(`  ${scenariosKept} scenario(s) PRESERVED at:`);
+        console.log(`    ${scenariosDir}`);
+        console.log('  (your accumulated knowledge — not deleted)');
+        console.log('  To delete them too:');
+        console.log(`    rm -rf "${scenariosDir}"          # bash`);
+        console.log(`    Remove-Item "${scenariosDir}" -Recurse -Force   # PowerShell`);
+        console.log('==========================================');
+    }
+    console.log('Cleanup done. To complete uninstall, also run:');
+    console.log('  npm uninstall -g uniner-cli');
+    console.log('');
+}
+
+main();