uniner-cli 1.0.0

package/LICENSE

@@ -0,0 +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/.

package/README.md

@@ -0,0 +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` 拉取约 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

@@ -0,0 +1,87 @@
+#!/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,
+} = 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 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 the Claude Code skill.
+    if (rmRf(skillDir())) didSomething = true;
+
+    if (!didSomething) {
+        log('Nothing to clean — already removed.');
+    }
+
+    console.log('');
+    console.log('Cleanup done. To complete uninstall, also run:');
+    console.log('  npm uninstall -g uniner-cli');
+    console.log('');
+}
+
+main();

package/bin/uniner-cli.js

@@ -0,0 +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);

package/lib/SKILL.md.template

@@ -0,0 +1,187 @@
+---
+name: uniner-cli
+description: RPA 自动化 CLI 工具，提供浏览器自动化、Excel 操作、OCR 识别、桌面/SAP 自动化、加密/HTTP/邮件等通用工具能力。Use when user mentions RPA、自动化、抓取网页、抓数据、填表、读 Excel、写 Excel、识别验证码、OCR、SAP、桌面操作、uniner-cli、爬虫、表单自动化.
+---
+
+# uniner-cli Skill
+
+> 由 UninerCLI Installer v{{VERSION}} 自动安装到 `%USERPROFILE%\.claude\skills\uniner-cli\`
+> 安装位置（绝对路径）：`{{INSTALL_PATH}}`
+
+## 何时使用本 Skill
+
+用户提到以下任一关键词或任务，**优先调用 uniner-cli**：
+
+- **网页类**：打开网页、抓取数据、点击/填表/登录、获取标题/表格、OCR 验证码
+- **Excel 类**：创建/读写 Excel、单元格操作、批量数据导出
+- **桌面类**：SAP 操作、窗口控制、键鼠模拟、图像识别（仅 Windows）
+- **工具类**：MD5/AES/RSA 加密、HTTP 请求、收发邮件、文件/PDF/ZIP 操作
+
+## 调用前提（已自动配置）
+
+- ✅ `uniner-cli` 命令已加入 PATH（安装时自动配置，新终端立即生效）
+- ✅ 环境变量 `UNINER_CLI_HOME = {{INSTALL_PATH}}`
+- ✅ Web 模块自动通过 CDP 连接本机 Chrome / Edge —— **不要手动启动 Chrome**
+- ⚠️ desktop 模块仅 Windows，依赖外部 Agent 服务（魔奈 RPA 编辑器自带）
+
+## 命令结构（一级 + 二级）
+
+```
+uniner-cli <模块> <子模块> <命令> [选项]
+
+excel              Excel 文件操作
+├── file           创建 / 打开 / 关闭 / 保存 / 复制 / 删除 / info / list
+├── sheet          工作表 创建 / 删除 / 重命名 / 复制 / info / list
+├── data           读 / 写 / 区域读 / 区域写 / 查找 / 清除
+└── style          字体 / 边框 / 填充 / 对齐 / 数字格式
+
+web                浏览器自动化（Playwright + CDP）
+├── browser        open / close / reconnect
+├── navigation     goto / back / forward / refresh / wait
+├── element        click / input / get-text / get-value / select / check / hover / screenshot
+├── iframe         enter / exit / list
+├── page           list / switch / close
+└── action         screenshot / execute-js / get-cookie / set-cookie
+
+tool               通用工具
+├── list           创建 / append / remove / find / sort / unique
+├── dict           创建 / get / set / remove / keys / values
+├── time           now / format / parse / calc / diff
+├── string         format / replace / split / join / trim / upper / lower
+├── data           json-parse / json-stringify / csv-parse / csv-write
+├── file           read / write / copy / move / delete / list / info / exists
+├── system         execute / kill-app / env / clipboard      [Windows]
+├── ui             alert / confirm / prompt                   [Windows]
+├── crypto         md5 / sha256 / aes-encrypt / aes-decrypt / rsa-* / base64-*
+├── math           add / sub / mul / div / round / abs / min / max
+├── pdf            read / merge / split / extract-text
+├── ocr            ddddocr（验证码） / paddleocr（通用） / image-to-text
+├── zip            create / extract / list
+├── ftp            connect / upload / download / list / delete
+├── email          send / receive / list
+└── http           get / post / put / delete
+
+desktop            桌面自动化 [仅 Windows]
+├── window         find / activate / close / info / list
+├── element        find / click / get-text / set-value
+├── keyboard       type / press / hotkey
+├── mouse          click / move / scroll / drag
+├── image          find / click / wait
+└── sap            login / transaction / field / table
+```
+
+## 全局选项（写在子命令前）
+
+```bash
+uniner-cli [全局选项] <模块> <子命令> <命令> [命令选项]
+
+--timeout, -t <毫秒>    超时（默认 3000ms）
+--exc <0|1>             异常处理：0=抛错退出，1=静默返回错误 JSON
+--verbose, -v           详细日志
+--quiet, -q             静默
+--json/--plain          输出格式（默认 --json）
+--config, -c <PATH>     配置文件路径
+```
+
+## 输出格式（始终是 JSON）
+
+```json
+// 成功
+{"success": true, "command": "web browser open", "data": {"session_id": "abc123"}, "timestamp": "..."}
+
+// 失败
+{"success": false, "error": "元素未找到: xpath=...", "error_type": "ElementNotFoundError"}
+```
+
+调用方应 `json.loads(stdout)` 解析，**不要 grep/regex**。
+
+## 场景 → 命令映射（高频）
+
+| 用户意图 | 命令模板 |
+|---|---|
+| 打开网页 | `web browser open --url <URL>` |
+| 等待元素出现 | `web navigation wait --type element --xpath <X>` |
+| 点击 | `web element click --xpath <X>` |
+| 输入文本 | `web element input --xpath <X> --value <V>` |
+| 获取文本 | `web element get-text --xpath <X>` |
+| 获取表格 / 复杂提取 | `web action execute-js --code "..."` |
+| 元素截图 | `web element screenshot --xpath <X> --output <PATH>` |
+| 进 iframe | `web iframe enter --xpath <X>`（或 XPath JSON 写法） |
+| 创建 Excel | `excel file create --file <PATH>` |
+| 读单元格 | `excel data read --file <PATH> --cell A1` |
+| 写单元格 | `excel data write --file <PATH> --cell A1 --value <V>` |
+| 区域写入 | `excel data write-range --file <PATH> --cell A1 --values <2D-JSON>` |
+| OCR 验证码 | `tool ocr ddddocr --img <PATH>` |
+| OCR 通用 | `tool ocr paddleocr --img <PATH>` |
+| MD5 / SHA256 | `tool crypto md5 --text <S>` |
+| HTTP GET | `tool http get --url <URL>` |
+| 发送邮件 | `tool email send --to <addr> --subject <S> --body <B>` |
+| 结束进程 | `tool system kill-app --name chrome.exe` |
+| SAP 登录 | `desktop sap login --user <U> --password <P>` |
+
+## 命令选择优先级
+
+1. **网页操作只用 `web`**（即使是桌面里嵌的 web）
+2. **`web action execute-js` 是万能 fallback**：Vue/React 组件、动态元素、复杂表格提取，普通 element 命令做不到时直接 JS
+3. **iframe 嵌套**用 XPath JSON 格式：`{"ElementName":"...","XPaths":[["iframe_xpath","element_xpath"],["backup_xpath"]]}`
+4. **session 自动管理**：第一次 `web browser open` 后，后续 web 命令默认用最新 session，可省 `--session`
+
+## 关键注意事项（6 条 TOC，详情看链接）
+
+1. **Chrome CDP 自动管理** — 别手动 kill Chrome；客户机必须装 Chrome 或 Edge
+2. **session 持久化** — `$TEMP\.uniner-cli\sessions.json`；CLI 退出后用 `web browser reconnect` 恢复
+3. **Vue/Element UI 组件** — 日期选择器、级联下拉等，用 `execute-js` 直接操作组件模型，不要硬 input
+4. **desktop 返回 -999** = Agent 服务未启动；此时改用 `web action execute-js` 或 `tool system execute`
+5. **Linux 平台** — Playwright 默认 HTTPS-only，访问 HTTP 站点需改 wrapper 加 `--disable-features=HttpsOnlyMode`，或用 Firefox `--browser-type 1`
+6. **Windows GBK 编码** — CLI 内部已强制 UTF-8 输出；调用方读 stdout 也要 UTF-8
+
+## 详细文档（按需 Read）
+
+| 主题 | 路径 |
+|---|---|
+| 命令树全集 + 三级参数 | [{{INSTALL_PATH}}\skills\cli\SKILL.md]({{INSTALL_PATH}}\skills\cli\SKILL.md) |
+| SDK ↔ CLI 命令映射 | [{{INSTALL_PATH}}\skills\cli\sdk-cli-mapping.md]({{INSTALL_PATH}}\skills\cli\sdk-cli-mapping.md) |
+| Windows 配置指南 | [{{INSTALL_PATH}}\skills\windows-setup-guide.md]({{INSTALL_PATH}}\skills\windows-setup-guide.md) |
+| Linux 配置指南 | [{{INSTALL_PATH}}\skills\linux-setup-guide.md]({{INSTALL_PATH}}\skills\linux-setup-guide.md) |
+| 实战案例（TMS 抓单） | [{{INSTALL_PATH}}\skills\tms-workflow-test-report.md]({{INSTALL_PATH}}\skills\tms-workflow-test-report.md) |
+| Helper 脚本（Chrome 启动 / Vue 日期 / 表格提取） | [{{INSTALL_PATH}}\skills\cli\helpers\]({{INSTALL_PATH}}\skills\cli\helpers\) |
+| 用户手册 | [{{INSTALL_PATH}}\docs\]({{INSTALL_PATH}}\docs\) |
+| 工作目录（保存截图/Excel/下载） | [{{INSTALL_PATH}}\workdir\]({{INSTALL_PATH}}\workdir\) |
+
+## 典型完整流程（参考）
+
+**网页 → OCR → 提取 → Excel**：
+
+```bash
+# 1. 打开浏览器
+uniner-cli web browser open --url "https://example.com/login"
+
+# 2. 输账号密码 + 截验证码 + OCR
+uniner-cli web element input --xpath "//input[@id='user']" --value "u01"
+uniner-cli web element input --xpath "//input[@id='pwd']" --value "p01"
+uniner-cli web element screenshot --xpath "//img[@id='captcha']" --output "{{INSTALL_PATH}}\workdir\cap.png"
+uniner-cli tool ocr ddddocr --img "{{INSTALL_PATH}}\workdir\cap.png"
+# 从返回 JSON 的 data.result 取识别文本
+
+# 3. 提交登录
+uniner-cli web element input --xpath "//input[@id='captcha']" --value "<识别结果>"
+uniner-cli web element click --xpath "//button[@type='submit']"
+
+# 4. 等表格 + 提取
+uniner-cli web navigation wait --type element --xpath "//table"
+uniner-cli web action execute-js --code "return Array.from(document.querySelectorAll('table tr')).map(r => Array.from(r.cells).map(c => c.textContent.trim()))"
+
+# 5. 写 Excel
+uniner-cli excel file create --file "{{INSTALL_PATH}}\workdir\out.xlsx"
+uniner-cli excel data write-range --file "{{INSTALL_PATH}}\workdir\out.xlsx" --cell A1 --values "<上一步的 JSON 二维数组>"
+
+# 6. 关浏览器
+uniner-cli web browser close
+```
+
+## 不确定时
+
+- `uniner-cli --help` 看一级
+- `uniner-cli web --help` 看二级
+- `uniner-cli web element click --help` 看具体参数
+- 仍不确定 → Read [{{INSTALL_PATH}}\skills\cli\SKILL.md]({{INSTALL_PATH}}\skills\cli\SKILL.md)

package/lib/paths.js

@@ -0,0 +1,78 @@
+// Path utilities shared by bin/, scripts/postinstall.js, scripts/preuninstall.js.
+// Single source of truth so we do not drift between launcher and installer.
+
+const os   = require('os');
+const path = require('path');
+const fs   = require('fs');
+
+const pkg = require('../package.json');
+
+// ----------------------------------------------------------------------
+// Layout we install into:
+//
+//   Windows:   %USERPROFILE%\.uniner-cli\<version>\
+//                bin\uniner-cli\uniner-cli.exe        ← real PyInstaller exe
+//                skills\
+//                docs\
+//                workdir\
+//   Linux:     ~/.uniner-cli/<version>/                (not yet shipped)
+//
+// We keep <version> in the path so two npm-installed versions can coexist
+// without colliding (`npm install uniner-cli@1.0.0` then `npm install uniner-cli@1.0.1`
+// won't clobber each other), and so postinstall is idempotent: if the
+// version-specific dir already has a working binary, we skip the download.
+// ----------------------------------------------------------------------
+
+function homeDir() {
+    return os.homedir();
+}
+
+function rootDir() {
+    return path.join(homeDir(), '.uniner-cli');
+}
+
+function versionDir(version) {
+    return path.join(rootDir(), version || pkg.version);
+}
+
+function realBinaryPath(version) {
+    const ver = version || pkg.version;
+    if (process.platform === 'win32') {
+        return path.join(versionDir(ver), 'bin', 'uniner-cli', 'uniner-cli.exe');
+    }
+    // Linux/Mac path will be filled in later when those builds exist.
+    return path.join(versionDir(ver), 'bin', 'uniner-cli', 'uniner-cli');
+}
+
+function skillDir() {
+    // Same place Claude Code looks for user-global skills.
+    return path.join(homeDir(), '.claude', 'skills', 'uniner-cli');
+}
+
+function skillFile() {
+    return path.join(skillDir(), 'SKILL.md');
+}
+
+function templatePath() {
+    return path.join(__dirname, 'SKILL.md.template');
+}
+
+function isInstalled(version) {
+    try {
+        return fs.statSync(realBinaryPath(version)).isFile();
+    } catch (_) {
+        return false;
+    }
+}
+
+module.exports = {
+    pkg,
+    homeDir,
+    rootDir,
+    versionDir,
+    realBinaryPath,
+    skillDir,
+    skillFile,
+    templatePath,
+    isInstalled,
+};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "uniner-cli",
+  "version": "1.0.0",
+  "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"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "files": [
+    "bin/",
+    "lib/",
+    "scripts/",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/scripts/postinstall.js

@@ -0,0 +1,367 @@
+#!/usr/bin/env node
+// postinstall.js — runs after `npm install -g uniner-cli`.
+//
+// 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%.
+//      - 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).
+//   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.
+//
+// Failures throw -> non-zero exit -> npm marks install as failed (strict mode).
+// User can then `npm install -g uniner-cli` again to retry cleanly.
+
+'use strict';
+
+const fs            = require('fs');
+const fsp           = require('fs').promises;
+const path          = require('path');
+const os            = require('os');
+const https         = require('https');
+const crypto        = require('crypto');
+const { spawnSync } = require('child_process');
+
+const {
+    pkg,
+    versionDir,
+    realBinaryPath,
+    isInstalled,
+    skillDir,
+    skillFile,
+    templatePath,
+} = require('../lib/paths');
+
+// ----------------------------------------------------------------------
+// Configuration
+// ----------------------------------------------------------------------
+
+const METADATA_URL =
+    'https://static.uniner.com/soft/editor/uninercli/latest.json';
+
+const DOWNLOAD_RETRIES = 3;
+const DOWNLOAD_TIMEOUT_MS = 600_000;  // 10 min per attempt
+const PROGRESS_INTERVAL_MS = 2000;
+
+// ----------------------------------------------------------------------
+// Logging
+// ----------------------------------------------------------------------
+
+function log(msg)  { console.log(`[uniner-cli] ${msg}`); }
+function step(msg) { console.log(`[uniner-cli] ==> ${msg}`); }
+function fail(msg) { throw new Error(`[uniner-cli] ${msg}`); }
+
+// ----------------------------------------------------------------------
+// HTTP helpers
+// ----------------------------------------------------------------------
+
+function getJSON(url) {
+    // Cache-bust to dodge any CDN that ignored the no-cache header.
+    const sep = url.includes('?') ? '&' : '?';
+    const bust = `${sep}t=${Date.now()}`;
+    return new Promise((resolve, reject) => {
+        const req = https.get(url + bust, { timeout: 30_000 }, res => {
+            if (res.statusCode === 301 || res.statusCode === 302) {
+                resolve(getJSON(res.headers.location));
+                return;
+            }
+            if (res.statusCode !== 200) {
+                reject(new Error(`HTTP ${res.statusCode} for ${url}`));
+                return;
+            }
+            let buf = '';
+            res.setEncoding('utf8');
+            res.on('data', chunk => { buf += chunk; });
+            res.on('end', () => {
+                try { resolve(JSON.parse(buf)); }
+                catch (e) { reject(new Error(`Bad JSON from ${url}: ${e.message}`)); }
+            });
+        });
+        req.on('timeout', () => { req.destroy(new Error('timeout')); });
+        req.on('error', reject);
+    });
+}
+
+function downloadStream(url, outFile, totalBytesHint) {
+    return new Promise((resolve, reject) => {
+        const tmp = outFile + '.partial';
+        const file = fs.createWriteStream(tmp);
+        let received = 0;
+        let total = totalBytesHint || 0;
+        let lastReport = Date.now();
+        let cleanup = () => {};
+
+        const req = https.get(url, { timeout: DOWNLOAD_TIMEOUT_MS }, res => {
+            if (res.statusCode === 301 || res.statusCode === 302) {
+                file.close(() => fs.unlink(tmp, () => {}));
+                resolve(downloadStream(res.headers.location, outFile, totalBytesHint));
+                return;
+            }
+            if (res.statusCode !== 200) {
+                file.close(() => fs.unlink(tmp, () => {}));
+                reject(new Error(`HTTP ${res.statusCode} for ${url}`));
+                return;
+            }
+
+            if (res.headers['content-length']) {
+                total = parseInt(res.headers['content-length'], 10);
+            }
+
+            res.on('data', chunk => {
+                received += chunk.length;
+                file.write(chunk);
+
+                const now = Date.now();
+                if (now - lastReport >= PROGRESS_INTERVAL_MS) {
+                    const mbDone = (received / 1048576).toFixed(1);
+                    if (total > 0) {
+                        const mbTotal = (total / 1048576).toFixed(1);
+                        const pct = ((received * 100) / total).toFixed(1);
+                        log(`    ${mbDone}/${mbTotal} MB (${pct}%)`);
+                    } else {
+                        log(`    ${mbDone} MB downloaded`);
+                    }
+                    lastReport = now;
+                }
+            });
+
+            res.on('end', () => {
+                file.end(() => {
+                    fs.rename(tmp, outFile, err => {
+                        if (err) reject(err); else resolve(received);
+                    });
+                });
+            });
+
+            cleanup = () => {
+                res.destroy();
+                file.close(() => fs.unlink(tmp, () => {}));
+            };
+        });
+
+        req.on('timeout', () => {
+            cleanup();
+            req.destroy(new Error('download timed out'));
+        });
+        req.on('error', err => {
+            cleanup();
+            reject(err);
+        });
+    });
+}
+
+async function downloadWithRetry(url, outFile, totalBytesHint) {
+    let lastErr;
+    for (let attempt = 1; attempt <= DOWNLOAD_RETRIES; attempt++) {
+        try {
+            log(`    Download attempt ${attempt}/${DOWNLOAD_RETRIES}...`);
+            const bytes = await downloadStream(url, outFile, totalBytesHint);
+            log(`    Downloaded ${bytes} bytes`);
+            return;
+        } catch (e) {
+            lastErr = e;
+            log(`    Attempt ${attempt} failed: ${e.message}`);
+            try { await fsp.unlink(outFile); } catch (_) {}
+            if (attempt < DOWNLOAD_RETRIES) {
+                await new Promise(r => setTimeout(r, 5000 * attempt));
+            }
+        }
+    }
+    fail(`Download failed after ${DOWNLOAD_RETRIES} attempts: ${lastErr.message}`);
+}
+
+// ----------------------------------------------------------------------
+// SHA-256
+// ----------------------------------------------------------------------
+
+function sha256OfFile(file) {
+    return new Promise((resolve, reject) => {
+        const hash = crypto.createHash('sha256');
+        const s = fs.createReadStream(file);
+        s.on('data', c => hash.update(c));
+        s.on('end', () => resolve(hash.digest('hex')));
+        s.on('error', reject);
+    });
+}
+
+// ----------------------------------------------------------------------
+// Extract via PowerShell (no native zip dep)
+// ----------------------------------------------------------------------
+
+function extractZipPS(zipFile, destDir) {
+    fs.mkdirSync(destDir, { recursive: true });
+
+    // Expand-Archive is built into Windows PowerShell 5.1+ (Win10/11 default).
+    // -Force overwrites any partial leftover from a previous failed install.
+    const ps = [
+        '-NoProfile',
+        '-NonInteractive',
+        '-ExecutionPolicy', 'Bypass',
+        '-Command',
+        `Expand-Archive -LiteralPath '${zipFile}' -DestinationPath '${destDir}' -Force`,
+    ];
+    const result = spawnSync('powershell.exe', ps, { stdio: 'inherit' });
+    if (result.error) {
+        fail(`Could not invoke PowerShell to extract: ${result.error.message}`);
+    }
+    if (result.status !== 0) {
+        fail(`Expand-Archive exited with status ${result.status}`);
+    }
+}
+
+// ----------------------------------------------------------------------
+// SKILL.md template render
+// ----------------------------------------------------------------------
+
+function writeSkillMd(installPath, version) {
+    const tplPath = templatePath();
+    if (!fs.existsSync(tplPath)) {
+        log(`    [WARN] SKILL.md.template missing at ${tplPath}; skipping skill install.`);
+        return;
+    }
+    let content = fs.readFileSync(tplPath, 'utf8');
+    // PowerShell-side StringChangeEx is case-insensitive; here we keep it strict
+    // because our template uses exactly these tokens.
+    content = content.split('{{INSTALL_PATH}}').join(installPath);
+    content = content.split('{{VERSION}}').join(version);
+
+    const dir = skillDir();
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(skillFile(), content, 'utf8');
+    log(`    SKILL.md written to ${skillFile()}`);
+}
+
+// ----------------------------------------------------------------------
+// Main
+// ----------------------------------------------------------------------
+
+async function main() {
+    console.log('');
+    console.log('==========================================');
+    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
+    // `npm install -g uniner-cli` idempotent and survives `npm rebuild`.
+    if (isInstalled(version)) {
+        log(`Already installed at ${realBinaryPath(version)}; skipping download.`);
+        log('To force a clean reinstall:');
+        log('  npm uninstall -g uniner-cli && npm install -g uniner-cli');
+        // Still re-render the skill — it's tiny and lets users edit the template
+        // and re-run rebuild to refresh.
+        writeSkillMd(versionDir(version), version);
+        return;
+    }
+
+    step('Reading version metadata');
+    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.');
+    }
+    log(`    Latest version: ${meta.version}`);
+    log(`    Package version (this npm release): ${version}`);
+
+    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.`);
+    }
+
+    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));
+
+    log(`    From: ${win.portable_url}`);
+    log(`    To:   ${zipPath}`);
+    await downloadWithRetry(win.portable_url, zipPath, win.portable_size);
+
+    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}`);
+    }
+    log('    Checksum verified.');
+
+    step('Extracting');
+    const targetDir = versionDir(version);
+    log(`    Target: ${targetDir}`);
+    // If a previous extraction left a half-written tree, blow it away.
+    if (fs.existsSync(targetDir)) {
+        log('    Removing previous half-extracted tree...');
+        fs.rmSync(targetDir, { recursive: true, force: true });
+    }
+    extractZipPS(zipPath, 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.
+    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'))) {
+            log('    Flattening extracted tree...');
+            for (const item of fs.readdirSync(inner)) {
+                fs.renameSync(path.join(inner, item), path.join(targetDir, item));
+            }
+            fs.rmdirSync(inner);
+        }
+    }
+
+    if (!isInstalled(version)) {
+        fail(`Extraction completed but the binary is not at ${realBinaryPath(version)}. ` +
+             `Inspect ${targetDir} to debug.`);
+    }
+
+    step('Cleaning up');
+    try { fs.unlinkSync(zipPath); } catch (_) {}
+    try { fs.rmdirSync(tmpDir); } catch (_) {}
+    log('    Removed temporary files.');
+
+    step('Installing Claude Code skill');
+    writeSkillMd(targetDir, version);
+
+    console.log('');
+    console.log('==========================================');
+    console.log(`  uniner-cli ${version} installed`);
+    console.log('==========================================');
+    console.log('');
+    console.log(`  Location: ${targetDir}`);
+    console.log(`  Skill:    ${skillFile()}`);
+    console.log('');
+    console.log('  Validate: uniner-cli --help');
+    console.log('');
+}
+
+main().catch(err => {
+    console.error('');
+    console.error(err.message || String(err));
+    console.error('');
+    console.error('Install failed. To retry:');
+    console.error('  npm uninstall -g uniner-cli');
+    console.error('  npm install -g uniner-cli');
+    console.error('');
+    process.exit(1);
+});