uniner-cli 1.0.2 → 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/package.json

@@ -1,46 +1,47 @@
-{
-    "name":  "uniner-cli",
-    "version":  "1.0.2",
-    "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.');