uniner-cli 1.0.3 → 1.0.6

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,181 @@
-# 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` 拉取对应平台的便携包（Windows ~280MB / macOS ~75MB / Linux ~185MB）
+3. 解压到 `~/.uniner-cli/<version>/`
+4. 写入 `~/.claude/skills/uniner-cli/SKILL.md`
+
+完成后任意终端：
+
+```bash
+uniner-cli --help
+```
+
+## 系统要求
+
+| 项 | 要求 |
+|---|---|
+| 操作系统 | Windows 10/11 x64 · macOS 12+ ARM64 · Linux x64 |
+| Node.js | >= 14 |
+| 磁盘空间 | ≥ 500 MB（单平台） |
+| 网络 | 能访问 `static.uniner.com` |
+
+> 安装脚本会自动检测当前系统并下载对应版本。
+
+## 使用示例
+
+```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
+```
+
+完整命令树（一级 + 二级 + 三级参数）见安装后 `~/.uniner-cli/<version>/skills/cli/SKILL.md`。
+
+## 升级
+
+```bash
+npm update -g uniner-cli
+```
+
+或者重新安装：
+
+```bash
+npm install -g uniner-cli@latest
+```
+
+> 不支持降级。如需回滚，请手动卸载后再装旧版。
+
+## 卸载
+
+```bash
+npm uninstall -g uniner-cli
+```
+
+卸载时 `preuninstall` 钩子会自动清理：
+
+- `~/.uniner-cli/` 整个运行时目录（含所有版本）
+- `~/.claude/skills/uniner-cli/SKILL.md` 技能文件
+
+> `~/.claude/skills/uniner-cli/scenarios/` 下用户积累的场景数据不会被自动删除，需手动清理。
+
+如需手动触发清理（如 npm 包已不在但残留仍在）：
+
+```bash
+uniner-cli-uninstall
+```
+
+## 环境变量
+
+无需手动配置。npm 全局 bin 目录已自动加入 PATH。
+
+## 故障排查
+
+### `uniner-cli: command not found`
+
+确认 npm 全局 bin 在 PATH 上：
+
+```bash
+# 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`。试试：
+
+```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
+```
+
+## 备选安装方式（仅 Windows，不走 npm）
+
+如果你不想要 Node.js 依赖，可以用 PowerShell 一行安装（基于 Inno Setup 安装器）：
+
+```powershell
+iwr https://static.uniner.com/soft/editor/uninercli/install.ps1 -UseBasicParsing | iex
+```
+
+> macOS / Linux 用户请使用 npm 安装。
+
+两种方式互不干扰，但**不要**同时启用——会有两份 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)
+
+## Changelog
+
+### 1.0.6 (2026-06-28)
+
+- **fix**: 修复 `npm uninstall -g uniner-cli` 未清理 `~/.uniner-cli/` 和 `~/.claude/skills/uniner-cli/SKILL.md` 的问题（新增 `preuninstall` 钩子）
+
+### 1.0.5 (2026-06-27)
+
+- 首个公开版本，支持 Windows 10/11 (x64)、macOS (Apple Silicon)、Linux (x64)
+
+## License
+
+Proprietary. (C) 2026 Uniner Tech.

package/bin/uniner-cli-uninstall.js

@@ -1,145 +1,48 @@
 #!/usr/bin/env node
-// uniner-cli-uninstall - removes the runtime tree and Claude Code skill.
+// uniner-cli-uninstall — manual cleanup command.
 //
-// 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.
+// Since v1.0.6 we register a `preuninstall` lifecycle hook that does the
+// same cleanup automatically when you run `npm uninstall -g uniner-cli`.
+// This manual command is still available for users who want verbose
+// feedback, or who want to clean up without going through npm
+// (e.g. the npm package is already gone but the runtime files remain).
 //
 // Recommended workflow:
-//   uniner-cli-uninstall              # this script: clean ~/.uniner-cli/ + skill
-//   npm uninstall -g uniner-cli       # npm: remove the npm package itself
+//   npm uninstall -g uniner-cli              # hook runs the cleanup automatically
+//
+// If something is still left behind, run this to force a verbose cleanup:
+//   npx uniner-cli-uninstall                 # before uninstalling
+//   # or, after npm already removed the package:
+//   node ~/.uniner-cli/<version>/bin/uniner-cli-uninstall.js   (if the shim is gone)
 //
 // 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');
+const { cleanup } = require('../scripts/cleanup');
 
-function log(msg)  { console.log(`[uniner-cli] ${msg}`); }
-function warn(msg) { console.warn(`[uniner-cli] [WARN] ${msg}`); }
+console.log('');
+console.log('==========================================');
+console.log('  uniner-cli uninstall cleanup');
+console.log('==========================================');
 
-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;
-    }
-}
+const result = cleanup({ verbose: true });
 
-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('');
+if (result.scenariosKept > 0) {
     console.log('==========================================');
-    console.log('  uniner-cli uninstall cleanup');
+    console.log(`  ${result.scenariosKept} scenario(s) PRESERVED at:`);
+    console.log(`    ${result.scenariosDir}`);
+    console.log('  (your accumulated knowledge — not deleted)');
+    console.log('  To delete them too:');
+    console.log(`    rm -rf "${result.scenariosDir}"          # bash`);
+    console.log(`    Remove-Item "${result.scenariosDir}" -Recurse -Force   # PowerShell`);
     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();
+if (result.didSomething) {
+    console.log('Cleanup done.');
+} else {
+    console.log('Nothing to clean — already removed.');
+}
+console.log('');

package/bin/uniner-cli.js

@@ -1,42 +1,42 @@
-#!/usr/bin/env node
-// Tiny launcher: forward every CLI invocation to the real PyInstaller exe.
-//
-// `npm install -g uniner-cli` registers this file as the global `uniner-cli`
-// command (because of the `bin` entry in package.json). We just spawn the real
-// binary with the same argv/stdio and exit with its status code.
-
-'use strict';
-
-const { spawnSync } = require('child_process');
-const fs = require('fs');
-const { realBinaryPath, isInstalled, pkg } = require('../lib/paths');
-
-const exe = realBinaryPath();
-
-if (!isInstalled()) {
-    console.error('');
-    console.error(`[uniner-cli] Real binary not found at: ${exe}`);
-    console.error('[uniner-cli] The npm postinstall step must not have completed.');
-    console.error('[uniner-cli] Try one of:');
-    console.error('[uniner-cli]   npm rebuild -g uniner-cli');
-    console.error('[uniner-cli]   npm uninstall -g uniner-cli && npm install -g uniner-cli');
-    console.error('');
-    process.exit(127);
-}
-
-// stdio:'inherit' forwards stdin/stdout/stderr unchanged so interactive prompts
-// and ANSI color survive. shell:false avoids any path-quoting surprises.
-const result = spawnSync(exe, process.argv.slice(2), {
-    stdio: 'inherit',
-    shell: false,
-    windowsHide: false,
-});
-
-if (result.error) {
-    console.error(`[uniner-cli] Failed to launch ${exe}: ${result.error.message}`);
-    process.exit(1);
-}
-
-// `status` is null when the child was killed by a signal; in that case let
-// the user see we did not exit cleanly.
-process.exit(result.status === null ? 1 : result.status);
+#!/usr/bin/env node
+// Tiny launcher: forward every CLI invocation to the real PyInstaller exe.
+//
+// `npm install -g uniner-cli` registers this file as the global `uniner-cli`
+// command (because of the `bin` entry in package.json). We just spawn the real
+// binary with the same argv/stdio and exit with its status code.
+
+'use strict';
+
+const { spawnSync } = require('child_process');
+const fs = require('fs');
+const { realBinaryPath, isInstalled, pkg } = require('../lib/paths');
+
+const exe = realBinaryPath();
+
+if (!isInstalled()) {
+    console.error('');
+    console.error(`[uniner-cli] Real binary not found at: ${exe}`);
+    console.error('[uniner-cli] The npm postinstall step must not have completed.');
+    console.error('[uniner-cli] Try one of:');
+    console.error('[uniner-cli]   npm rebuild -g uniner-cli');
+    console.error('[uniner-cli]   npm uninstall -g uniner-cli && npm install -g uniner-cli');
+    console.error('');
+    process.exit(127);
+}
+
+// stdio:'inherit' forwards stdin/stdout/stderr unchanged so interactive prompts
+// and ANSI color survive. shell:false avoids any path-quoting surprises.
+const result = spawnSync(exe, process.argv.slice(2), {
+    stdio: 'inherit',
+    shell: false,
+    windowsHide: false,
+});
+
+if (result.error) {
+    console.error(`[uniner-cli] Failed to launch ${exe}: ${result.error.message}`);
+    process.exit(1);
+}
+
+// `status` is null when the child was killed by a signal; in that case let
+// the user see we did not exit cleanly.
+process.exit(result.status === null ? 1 : result.status);