uniner-cli 1.0.1 → 1.0.3

package/README.md

@@ -21,9 +21,13 @@ 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`
+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`
 
 完成后任意终端：
 
@@ -35,12 +39,16 @@ uniner-cli --help
 
 | 项 | 要求 |
 |---|---|
-| 操作系统 | 64 位 Windows 10 / 11 |
+| 操作系统 | Windows 10/11 x64；Ubuntu 24.04+ x64 |
 | Node.js | >= 14 |
 | 磁盘空间 | ≥ 1.5 GB |
 | 网络 | 能访问 `static.uniner.com` |
 
-> Linux / macOS 支持在路上。
+Linux 说明：
+- Linux 包当前基于 Ubuntu 24.04 / glibc 2.39 构建和验证。
+- 已验证模块：`tool` / `excel` / `skill` / `ddddocr OCR`。
+- `web` 模块需要目标机安装 Chrome/Chromium。
+- `desktop` 模块不支持 Linux。
 
 ## 使用示例
 
@@ -61,7 +69,9 @@ uniner-cli excel data write --file out.xlsx --cell B2 --value "hello"
 uniner-cli tool ocr ddddocr --img captcha.png
 ```
 
-完整命令树（一级 + 二级 + 三级参数）见安装后 `%USERPROFILE%\.uniner-cli\<version>\skills\cli\SKILL.md`。
+完整命令树（一级 + 二级 + 三级参数）见安装后：
+- Windows: `%USERPROFILE%\.uniner-cli\<version>\skills\cli\SKILL.md`
+- Linux: `~/.uniner-cli/<version>/skills/cli/SKILL.md`
 
 ## 升级
 

package/lib/SKILL.md.template

@@ -8,6 +8,29 @@ description: RPA 自动化 CLI 工具，提供浏览器自动化、Excel 操作
 > 由 UninerCLI Installer v{{VERSION}} 自动安装到 `%USERPROFILE%\.claude\skills\uniner-cli\`
 > 安装位置（绝对路径）：`{{INSTALL_PATH}}`
 
+## 🛑 任务结束硬性规则（最重要，先读这一节）
+
+**每次用 uniner-cli 完成一个任务后，在你要说"任务完成"或写汇总表之前，必须先执行下面这段：**
+
+如果这次任务**满足任一条件**：
+
+- 调用了 ≥ 3 个 uniner-cli 命令
+- 涉及 web / desktop / OCR 任何一个模块
+- 用户提到过"以后还会跑" / "每天都要" / "做成自动化"
+- 任务里踩过坑（XPath 不稳、参数名错、Vue 组件、超时调整等）
+
+→ **必须主动问用户**："这个流程涉及多步，要不要保存为可重放场景？以后 `uniner-cli skill run <name> --param ...` 就能 0 token 重放，可以放定时任务/RPA 平台里跑。要保存吗？"
+
+不要等用户开口，**主动**问。这是最有价值的一步——你刚刚花了上千 token 调通的流程，沉淀下来下次就能秒跑。
+
+如果用户说"好" / "可以" / "保存吧"：按下面"场景沉淀（4 步流程）"章节执行。
+
+如果用户说"不用"：直接结束，不再追问。
+
+**违反这条规则 = 任务未完成。** 不管你跑得多顺，没问就是没问完整。
+
+---
+
 ## 何时使用本 Skill
 
 用户提到以下任一关键词或任务，**优先调用 uniner-cli**：
@@ -179,20 +202,9 @@ uniner-cli excel data write-range --file "{{INSTALL_PATH}}\workdir\out.xlsx" --c
 uniner-cli web browser close
 ```
 
-## 场景沉淀（重要：完成任务后主动建议保存）
-
-每完成一个完整 RPA 流程后，**主动建议**用户把它沉淀为可重放的场景。
-之后用户用 `uniner-cli skill run <name>` 即可 **0 token 重放**——
-不再需要 Claude，直接命令行就能跑、能放进定时任务 / Airflow / RPA 平台。
-
-### 何时建议保存
+## 场景沉淀（4 步流程）
 
-下面任一情况都该建议：
-- 任务跑完且至少调用了 ≥3 个 uniner-cli 命令
-- 任务里踩过坑（XPath 不稳、参数名错、Element UI 组件等）
-- 用户表达过 "以后还会跑"
-
-### 怎么保存：3 个文件 + 4 步流程
+> 这是顶部"任务结束硬性规则"提到的"4 步流程"。用户同意保存场景后，按这里走。
 
 每个场景一个目录，三件套：`meta.json` + `steps.json` + `SKILL.md`，存到：
 
@@ -326,20 +338,21 @@ Open Claude Code, paste this:
 
 客户复制这段给你 → 你 Read steps.json 调试 → 改完 `Write` 回去 → 让客户重跑。
 
-### 给 Claude 的对话范式
-
-完成任务后说类似的话（**主动询问，不等用户开口**）：
+### 给 Claude 的对话范式（用户同意保存后）
 
-> "这个流程涉及 OCR、Vue 组件、XPath 等不稳定环节，我帮你保存为可重放场景吧？以后你直接 `uniner-cli skill run <name>` 就能 0 token 重放，还能放定时任务里跑。要保存吗？"
-
-得到确认后：
+按这个顺序，**不要跳步**：
 
 1. 想一个 kebab-case 名字（如 `tms-export-waybills` / `sap-monthly-report`）
-2. Bash 跑 `uniner-cli skill init <name>`
-3. Write 写 meta.json（含动态参数 schema）+ steps.json（完整步骤 + 已知坑的避坑配置）+ SKILL.md（经验文档）
-4. Bash 跑 `uniner-cli skill validate <name>`
+2. Bash 跑 `uniner-cli skill init <name>`（生成骨架）
+3. Write 写**真正的**：
+   - `meta.json`：含动态参数 schema（URL / USERNAME / PASSWORD / DATE_FROM 等）
+   - `steps.json`：把刚才跑过的命令序列**完整**写进去，含已知坑的避坑配置（retry / on_fail / always_run）
+   - `SKILL.md`：经验文档（已知坑、用法说明）
+4. Bash 跑 `uniner-cli skill validate <name>` 确认格式无误
 5. 让用户 `uniner-cli skill run <name> --param ...` 自己跑一次确认 0 token 重放可行
 
+**关键**：steps.json 不是命令清单的注释——是**真正可执行的工作流**。要把 `${URL}` `${USERNAME}` `${ocrResult.data.result}` 这种变量绑好，让 `skill run` 真能跑通。
+
 ### 已沉淀的场景库
 
 ```bash

package/package.json

@@ -1,46 +1,47 @@
-{
-    "name":  "uniner-cli",
-    "version":  "1.0.1",
-    "description":  "uniner-cli — RPA automation CLI: browser automation (Playwright/CDP), Excel, OCR, desktop/SAP, crypto/HTTP/email tools. Auto-installs a Claude Code skill on install.",
-    "keywords":  [
-                     "rpa",
-                     "automation",
-                     "uniner",
-                     "playwright",
-                     "excel",
-                     "ocr",
-                     "claude-code",
-                     "ai-agent"
-                 ],
-    "homepage":  "https://www.uniner.com/",
-    "bugs":  {
-                 "url":  "https://www.uniner.com/",
-                 "email":  "support@uniner.com"
-             },
-    "license":  "Proprietary",
-    "author":  "Uniner Tech",
-    "main":  "lib/paths.js",
-    "bin":  {
-                "uniner-cli":  "bin/uniner-cli.js",
-                "uniner-cli-uninstall":  "bin/uniner-cli-uninstall.js"
-            },
-    "scripts":  {
-                    "postinstall":  "node scripts/postinstall.js"
-                },
-    "engines":  {
-                    "node":  "\u003e=14"
-                },
-    "os":  [
-               "win32"
-           ],
-    "cpu":  [
-                "x64"
-            ],
-    "files":  [
-                  "bin/",
-                  "lib/",
-                  "scripts/",
-                  "README.md",
-                  "LICENSE"
-              ]
-}
+{
+  "name": "uniner-cli",
+  "version": "1.0.3",
+  "description": "uniner-cli — RPA automation CLI: browser automation (Playwright/CDP), Excel, OCR, desktop/SAP, crypto/HTTP/email tools. Auto-installs a Claude Code skill on install.",
+  "keywords": [
+    "rpa",
+    "automation",
+    "uniner",
+    "playwright",
+    "excel",
+    "ocr",
+    "claude-code",
+    "ai-agent"
+  ],
+  "homepage": "https://www.uniner.com/",
+  "bugs": {
+    "url": "https://www.uniner.com/",
+    "email": "support@uniner.com"
+  },
+  "license": "Proprietary",
+  "author": "Uniner Tech",
+  "main": "lib/paths.js",
+  "bin": {
+    "uniner-cli": "bin/uniner-cli.js",
+    "uniner-cli-uninstall": "bin/uniner-cli-uninstall.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "engines": {
+    "node": ">=14"
+  },
+  "os": [
+    "win32",
+    "linux"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "files": [
+    "bin/",
+    "lib/",
+    "scripts/",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/scripts/postinstall.js

@@ -3,12 +3,14 @@
 //
 // What it does:
 //   1. If the binary is already in place at ~/.uniner-cli/<version>/, exit (idempotent).
-//   2. Fetch latest.json from the OSS metadata URL to get portable_url + sha256.
-//   3. Stream-download the matching portable .zip into %TEMP%.
+//   2. Fetch latest.json from the OSS metadata URL to get platform URL + sha256.
+//   3. Stream-download the matching portable archive into temp dir.
+//      - Windows: .zip
+//      - Linux:   .tar.gz
 //      - Live progress every 2 seconds.
 //      - Up to 3 retries with exponential backoff.
 //   4. Verify SHA-256.
-//   5. Extract via PowerShell's Expand-Archive (no native dep).
+//   5. Extract via platform-native tools (PowerShell Expand-Archive / tar).
 //   6. Render SKILL.md.template with {{INSTALL_PATH}} / {{VERSION}} substituted
 //      and write to ~/.claude/skills/uniner-cli/SKILL.md.
 //   7. Print "ready" and how to validate.
@@ -213,6 +215,58 @@ function extractZipPS(zipFile, destDir) {
     }
 }
 
+function extractTarGz(tarFile, destDir) {
+    fs.mkdirSync(destDir, { recursive: true });
+
+    const result = spawnSync('tar', ['-xzf', tarFile, '-C', destDir], {
+        stdio: 'inherit',
+    });
+    if (result.error) {
+        fail(`Could not invoke tar to extract: ${result.error.message}`);
+    }
+    if (result.status !== 0) {
+        fail(`tar exited with status ${result.status}`);
+    }
+}
+
+function getPlatformInfo(meta) {
+    if (process.arch !== 'x64') {
+        fail(`Unsupported architecture: ${process.arch}. Only x64 is supported.`);
+    }
+
+    if (process.platform === 'win32') {
+        const info = meta && meta.windows && meta.windows.x64;
+        if (!info || !info.portable_url || !info.portable_sha256) {
+            fail('latest.json is missing windows.x64.portable_url / portable_sha256.');
+        }
+        return {
+            platformKey: 'windows.x64',
+            archiveUrl: info.portable_url,
+            archiveSha256: info.portable_sha256,
+            archiveSize: info.portable_size,
+            extract: extractZipPS,
+            expectedInnerBinary: path.join('bin', 'uniner-cli', 'uniner-cli.exe'),
+        };
+    }
+
+    if (process.platform === 'linux') {
+        const info = meta && meta.linux && meta.linux.x64;
+        if (!info || !info.portable_url || !info.portable_sha256) {
+            fail('latest.json is missing linux.x64.portable_url / portable_sha256.');
+        }
+        return {
+            platformKey: 'linux.x64',
+            archiveUrl: info.portable_url,
+            archiveSha256: info.portable_sha256,
+            archiveSize: info.portable_size,
+            extract: extractTarGz,
+            expectedInnerBinary: path.join('bin', 'uniner-cli', 'uniner-cli'),
+        };
+    }
+
+    fail(`Unsupported platform: ${process.platform}. Supported: win32-x64, linux-x64.`);
+}
+
 // ----------------------------------------------------------------------
 // SKILL.md template render
 // ----------------------------------------------------------------------
@@ -265,16 +319,6 @@ async function main() {
     console.log('  uniner-cli postinstall');
     console.log('==========================================');
 
-    // We only build a Windows binary right now. Refuse other platforms loudly
-    // so users don't end up with a broken install.
-    if (process.platform !== 'win32') {
-        fail('Only Windows x64 is supported in this release. ' +
-             'Linux/macOS support is on the roadmap.');
-    }
-    if (process.arch !== 'x64') {
-        fail(`Unsupported architecture: ${process.arch}. Only x64 is supported.`);
-    }
-
     const version = pkg.version;
 
     // Skip when a working binary is already there. This makes
@@ -293,34 +337,30 @@ async function main() {
     log(`    URL: ${METADATA_URL}`);
     const meta = await getJSON(METADATA_URL);
 
-    const win = meta && meta.windows && meta.windows.x64;
-    if (!win || !win.portable_url || !win.portable_sha256) {
-        fail('latest.json is missing windows.x64.portable_url / portable_sha256. ' +
-             'The OSS metadata may be from an older release.');
-    }
+    const platform = getPlatformInfo(meta);
     log(`    Latest version: ${meta.version}`);
     log(`    Package version (this npm release): ${version}`);
+    log(`    Platform: ${platform.platformKey}`);
 
     if (meta.version !== version) {
         log(`    [INFO] Server has ${meta.version} but this npm package is pinned ` +
-            `to ${version}. Will fetch the package's own version artifacts ` +
-            `from the OSS path that the URL implies.`);
+            `to ${version}. Will fetch the package artifacts from latest.json.`);
     }
 
     step('Downloading portable archive');
     const tmpDir = path.join(os.tmpdir(), 'uniner-cli-npm-install');
     fs.mkdirSync(tmpDir, { recursive: true });
-    const zipPath = path.join(tmpDir, path.basename(win.portable_url));
+    const archivePath = path.join(tmpDir, path.basename(platform.archiveUrl));
 
-    log(`    From: ${win.portable_url}`);
-    log(`    To:   ${zipPath}`);
-    await downloadWithRetry(win.portable_url, zipPath, win.portable_size);
+    log(`    From: ${platform.archiveUrl}`);
+    log(`    To:   ${archivePath}`);
+    await downloadWithRetry(platform.archiveUrl, archivePath, platform.archiveSize);
 
     step('Verifying SHA-256');
-    const actual = await sha256OfFile(zipPath);
-    if (actual.toLowerCase() !== win.portable_sha256.toLowerCase()) {
-        try { fs.unlinkSync(zipPath); } catch (_) {}
-        fail(`SHA-256 mismatch.\n  expected: ${win.portable_sha256}\n  got:      ${actual}`);
+    const actual = await sha256OfFile(archivePath);
+    if (actual.toLowerCase() !== platform.archiveSha256.toLowerCase()) {
+        try { fs.unlinkSync(archivePath); } catch (_) {}
+        fail(`SHA-256 mismatch.\n  expected: ${platform.archiveSha256}\n  got:      ${actual}`);
     }
     log('    Checksum verified.');
 
@@ -332,16 +372,17 @@ async function main() {
         log('    Removing previous half-extracted tree...');
         fs.rmSync(targetDir, { recursive: true, force: true });
     }
-    extractZipPS(zipPath, targetDir);
+    platform.extract(archivePath, targetDir);
 
-    // build_portable.bat puts everything inside an extra `uniner-cli-portable`
-    // top-level folder. If we see exactly one subdir and the binary is one
-    // level deeper, flatten so realBinaryPath() resolves cleanly.
+    // Portable archives put everything inside an extra top-level folder
+    // (`uniner-cli-portable` on Windows, `uniner-cli-linux-portable` on Linux).
+    // If we see exactly one subdir and the expected binary is one level deeper,
+    // flatten so realBinaryPath() resolves cleanly.
     const entries = fs.readdirSync(targetDir);
     if (entries.length === 1) {
         const inner = path.join(targetDir, entries[0]);
         if (fs.statSync(inner).isDirectory() &&
-            fs.existsSync(path.join(inner, 'bin', 'uniner-cli', 'uniner-cli.exe'))) {
+            fs.existsSync(path.join(inner, platform.expectedInnerBinary))) {
             log('    Flattening extracted tree...');
             for (const item of fs.readdirSync(inner)) {
                 fs.renameSync(path.join(inner, item), path.join(targetDir, item));
@@ -356,7 +397,7 @@ async function main() {
     }
 
     step('Cleaning up');
-    try { fs.unlinkSync(zipPath); } catch (_) {}
+    try { fs.unlinkSync(archivePath); } catch (_) {}
     try { fs.rmdirSync(tmpDir); } catch (_) {}
     log('    Removed temporary files.');