uniner-cli 1.0.6 → 1.0.7

package/README.md

@@ -2,10 +2,10 @@
 
 `uniner-cli` 是 [Uniner](https://www.uniner.com/) 的 RPA 自动化命令行工具，提供：
 
-- **Web 自动化**（Playwright + CDP）—— 浏览器抓取、表单填写、元素交互
+- **Web 自动化** —— 浏览器抓取、表单填写、元素交互
 - **Excel 操作** —— 读写、批量处理、样式
-- **OCR 识别** —— ddddocr（验证码）+ PaddleOCR（通用）
-- **桌面 / SAP 自动化**（仅 Windows）
+- **OCR 识别** —— 支持验证码和通用 OCR
+- **桌面 / SAP 自动化** —— 支持桌面软件的自动化（仅 Windows）
 - **通用工具** —— 加密、HTTP、邮件、文件、PDF、压缩
 
 安装时会自动注册一个 [Claude Code](https://claude.com/claude-code) 技能（`~/.claude/skills/uniner-cli/SKILL.md`），让 Claude 一启动就能识别并调用本 CLI。
@@ -14,18 +14,27 @@
 
 ## 安装
 
+全局安装：
+
 ```bash
 npm install -g uniner-cli
 ```
 
-安装过程：
+当前目录安装：
+
+```bash
+npm install 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`
+> 本地安装后通常通过 `npx uniner-cli --help` 或项目里的 npm scripts 调用；只有全局安装才适合在任意终端直接运行 `uniner-cli`。
 
-完成后任意终端：
+安装过程中会自动完成：
+
+1. 下载并配置当前平台所需的 uniner-cli 运行时
+2. 注册 Claude Code 技能
+3. 准备 `uniner-cli` 命令入口
+
+全局安装完成后任意终端：
 
 ```bash
 uniner-cli --help
@@ -61,7 +70,7 @@ uniner-cli excel data write --file out.xlsx --cell B2 --value "hello"
 uniner-cli tool ocr ddddocr --img captcha.png
 ```
 
-完整命令树（一级 + 二级 + 三级参数）见安装后 `~/.uniner-cli/<version>/skills/cli/SKILL.md`。
+完整命令树（一级 + 二级 + 三级参数）可通过 `uniner-cli --help` 查看。
 
 ## 升级
 
@@ -79,26 +88,45 @@ npm install -g uniner-cli@latest
 
 ## 卸载
 
+> **重要提示**：直接使用 `npm uninstall` 可能无法清理运行时文件。
+> 请使用 CLI 自带的一键卸载命令以确保完全清理。
+
+**推荐卸载流程**：
+
+```bash
+uniner-cli uninstall
+```
+
+该命令会先清理运行时残留，再自动判断安装范围并移除 npm 包本体：
+
+- 全局安装：执行 `npm uninstall -g uniner-cli`
+- 本地安装：在当前项目执行 `npm uninstall uniner-cli`
+
+如果自动判断不符合预期，可显式指定：
+
 ```bash
-npm uninstall -g uniner-cli
+uniner-cli uninstall --global
+uniner-cli uninstall --local
 ```
 
-卸载时 `preuninstall` 钩子会自动清理：
+清理内容：
 
 - `~/.uniner-cli/` 整个运行时目录（含所有版本）
 - `~/.claude/skills/uniner-cli/SKILL.md` 技能文件
 
-> `~/.claude/skills/uniner-cli/scenarios/` 下用户积累的场景数据不会被自动删除，需手动清理。
+> `~/.claude/skills/uniner-cli/scenarios/` 下用户积累的场景数据不会被删除，需手动清理。
 
-如需手动触发清理（如 npm 包已不在但残留仍在）：
+**备选方式**（如果 npm 包已经先被卸载，`uniner-cli` 不在 PATH 上）：
 
 ```bash
-uniner-cli-uninstall
+node ~/.uniner-cli/cleanup.js
 ```
 
+> 该脚本只清理运行时残留，不再卸载 npm 包本体。
+
 ## 环境变量
 
-无需手动配置。npm 全局 bin 目录已自动加入 PATH。
+无需手动配置。全局安装时，npm 会把命令链接到全局 bin 目录；如果终端识别不到 `uniner-cli`，按下方排查 PATH。
 
 ## 故障排查
 
@@ -131,35 +159,17 @@ 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 分钟。让它跑完即可。
+杀软（360 / 火绒）可能会扫描大量新文件，慢则 5–10 分钟。让它跑完即可。
 
 ### 想重装
 
 ```bash
-npm uninstall -g uniner-cli
+uniner-cli uninstall
 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/)
@@ -168,9 +178,13 @@ iwr https://static.uniner.com/soft/editor/uninercli/install.ps1 -UseBasicParsing
 
 ## Changelog
 
+### 1.0.7 (2026-06-29)
+
+- **fix**: 新增 `uniner-cli uninstall`，自动判断全局 / 本地安装范围，完整清理运行时文件并移除 npm 包。
+
 ### 1.0.6 (2026-06-28)
 
-- **fix**: 修复 `npm uninstall -g uniner-cli` 未清理 `~/.uniner-cli/` 和 `~/.claude/skills/uniner-cli/SKILL.md` 的问题（新增 `preuninstall` 钩子）
+- **fix**: 修复 `npm uninstall -g uniner-cli` 未清理 `~/.uniner-cli/` 和 `~/.claude/skills/uniner-cli/SKILL.md` 的问题。
 
 ### 1.0.5 (2026-06-27)
 

package/bin/uniner-cli-uninstall.js

@@ -1,48 +1,84 @@
-#!/usr/bin/env node
-// uniner-cli-uninstall — manual cleanup command.
-//
-// 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:
-//   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 { cleanup } = require('../scripts/cleanup');
-
-console.log('');
-console.log('==========================================');
-console.log('  uniner-cli uninstall cleanup');
-console.log('==========================================');
-
-const result = cleanup({ verbose: true });
-
-console.log('');
-if (result.scenariosKept > 0) {
-    console.log('==========================================');
-    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('==========================================');
-}
-
-if (result.didSomething) {
-    console.log('Cleanup done.');
-} else {
-    console.log('Nothing to clean — already removed.');
-}
-console.log('');
+#!/usr/bin/env node
+// uniner-cli-uninstall — manual cleanup command.
+//
+// Background:
+//   npm 7+ (including npm 11) does NOT reliably run the `preuninstall`
+//   lifecycle hook for globally installed packages. This means
+//   `npm uninstall -g uniner-cli` removes the npm package but leaves
+//   residual files behind:
+//     - ~/.uniner-cli/            (runtime binaries, skills, docs)
+//     - ~/.claude/skills/uniner-cli/SKILL.md  (Claude Code skill file)
+//
+// To solve this, postinstall writes a self-contained cleanup script to
+// ~/.uniner-cli/cleanup.js. That file survives `npm uninstall` and can
+// always be run manually.
+//
+// Recommended workflow (ensures a clean uninstall):
+//   npm uninstall -g uniner-cli
+//   node ~/.uniner-cli/cleanup.js        # always works, even after npm removes the package
+//
+// Alternative (only works BEFORE you run `npm uninstall -g`):
+//   uniner-cli-uninstall                 # this command; removed along with the package
+//   npm uninstall -g uniner-cli
+//
+// Idempotent: if files are already gone, just no-ops.
+
+'use strict';
+
+const path = require('path');
+const os   = require('os');
+const fs   = require('fs');
+
+// Prefer the standalone cleanup.js if it exists (written by postinstall,
+// survives npm uninstall). Fall back to the in-package cleanup module
+// (only works while the npm package is still installed).
+const standalonePath = path.join(os.homedir(), '.uniner-cli', 'cleanup.js');
+
+if (fs.existsSync(standalonePath)) {
+    // Delegate to the standalone script. It handles everything: removing
+    // ~/.uniner-cli/, removing SKILL.md, preserving scenarios/.
+    // Use spawnSync to avoid any require() path issues.
+    const { spawnSync } = require('child_process');
+    const result = spawnSync(process.execPath, [standalonePath], {
+        stdio: 'inherit',
+    });
+    process.exit(result.status || 0);
+}
+
+// Fallback: the standalone script is gone (old install before this fix).
+// Use the in-package cleanup module.
+'use strict';
+
+const { cleanup } = require('../scripts/cleanup');
+
+console.log('');
+console.log('==========================================');
+console.log('  uniner-cli uninstall cleanup (fallback)');
+console.log('==========================================');
+console.log('');
+console.log('  Note: ~/.uniner-cli/cleanup.js not found.');
+console.log('  This fallback will be removed in a future version.');
+console.log('  Reinstall to get the standalone cleanup script:');
+console.log('    npm install -g uniner-cli');
+console.log('');
+
+const result = cleanup({ verbose: true });
+
+console.log('');
+if (result.scenariosKept > 0) {
+    console.log('==========================================');
+    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('==========================================');
+}
+
+if (result.didSomething) {
+    console.log('Cleanup done.');
+} else {
+    console.log('Nothing to clean — already removed.');
+}
+console.log('');

package/bin/uniner-cli.js

@@ -1,15 +1,207 @@
 #!/usr/bin/env node
-// Tiny launcher: forward every CLI invocation to the real PyInstaller exe.
+// Tiny launcher: handle npm-owned commands, then forward everything else 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.
+// command (because of the `bin` entry in package.json).
 
 'use strict';
 
 const { spawnSync } = require('child_process');
 const fs = require('fs');
+const path = require('path');
 const { realBinaryPath, isInstalled, pkg } = require('../lib/paths');
+const { cleanup } = require('../scripts/cleanup');
+
+function npmCommand() {
+    return process.platform === 'win32' ? 'npm.cmd' : 'npm';
+}
+
+function printUninstallHelp() {
+    console.log('');
+    console.log('Usage: uniner-cli uninstall [--global|--local]');
+    console.log('');
+    console.log('Cleans ~/.uniner-cli and the installed Claude Code skill,');
+    console.log('then removes this npm package from the detected install scope.');
+    console.log('');
+}
+
+function realPath(p) {
+    try {
+        return fs.realpathSync.native(p);
+    } catch (_) {
+        return path.resolve(p);
+    }
+}
+
+function samePath(a, b) {
+    const left = realPath(a);
+    const right = realPath(b);
+    if (process.platform === 'win32') {
+        return left.toLowerCase() === right.toLowerCase();
+    }
+    return left === right;
+}
+
+function npmOutput(args, opts) {
+    const result = spawnSync(npmCommand(), args, Object.assign({
+        encoding: 'utf8',
+        shell: false,
+        windowsHide: false,
+    }, opts || {}));
+    if (result.error || result.status !== 0) {
+        return null;
+    }
+    return (result.stdout || '').trim();
+}
+
+function packageJsonHasDependency(file) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(file, 'utf8'));
+        const sections = [
+            parsed.dependencies,
+            parsed.devDependencies,
+            parsed.optionalDependencies,
+            parsed.peerDependencies,
+        ];
+        return sections.some(section => section && section[pkg.name]);
+    } catch (_) {
+        return false;
+    }
+}
+
+function findLocalProjectRoot(startDir) {
+    let dir = path.resolve(startDir);
+    while (true) {
+        const packageJson = path.join(dir, 'package.json');
+        if (fs.existsSync(packageJson) && packageJsonHasDependency(packageJson)) {
+            return dir;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            return null;
+        }
+        dir = parent;
+    }
+}
+
+function localProjectFromPackageDir(packageDir) {
+    const nodeModulesDir = path.dirname(packageDir);
+    if (path.basename(nodeModulesDir) !== 'node_modules') {
+        return null;
+    }
+    const projectRoot = path.dirname(nodeModulesDir);
+    const packageJson = path.join(projectRoot, 'package.json');
+    if (fs.existsSync(packageJson)) {
+        return projectRoot;
+    }
+    return null;
+}
+
+function detectUninstallPlan(args) {
+    if (args.includes('--global') || args.includes('-g')) {
+        return {
+            scope: 'global',
+            npmArgs: ['uninstall', '-g', pkg.name],
+            cwd: process.cwd(),
+            manualCommand: `npm uninstall -g ${pkg.name}`,
+        };
+    }
+
+    if (args.includes('--local')) {
+        const projectRoot = findLocalProjectRoot(process.cwd()) ||
+            localProjectFromPackageDir(path.resolve(__dirname, '..')) ||
+            process.cwd();
+        return {
+            scope: 'local',
+            npmArgs: ['uninstall', pkg.name],
+            cwd: projectRoot,
+            manualCommand: `cd "${projectRoot}" && npm uninstall ${pkg.name}`,
+        };
+    }
+
+    const packageDir = path.resolve(__dirname, '..');
+    const globalRoot = npmOutput(['root', '-g']);
+    if (globalRoot && samePath(packageDir, path.join(globalRoot, pkg.name))) {
+        return {
+            scope: 'global',
+            npmArgs: ['uninstall', '-g', pkg.name],
+            cwd: process.cwd(),
+            manualCommand: `npm uninstall -g ${pkg.name}`,
+        };
+    }
+
+    const projectRoot = findLocalProjectRoot(process.cwd()) ||
+        localProjectFromPackageDir(packageDir);
+    if (projectRoot) {
+        return {
+            scope: 'local',
+            npmArgs: ['uninstall', pkg.name],
+            cwd: projectRoot,
+            manualCommand: `cd "${projectRoot}" && npm uninstall ${pkg.name}`,
+        };
+    }
+
+    return {
+        scope: 'global',
+        npmArgs: ['uninstall', '-g', pkg.name],
+        cwd: process.cwd(),
+        manualCommand: `npm uninstall -g ${pkg.name}`,
+    };
+}
+
+function runFullUninstall() {
+    console.log('');
+    console.log('==========================================');
+    console.log('  uniner-cli uninstall');
+    console.log('==========================================');
+
+    const cleanupResult = cleanup({ verbose: true });
+
+    console.log('');
+    const plan = detectUninstallPlan(process.argv.slice(3));
+    console.log(`[uniner-cli] Removing ${plan.scope} npm package...`);
+    if (plan.scope === 'local') {
+        console.log(`[uniner-cli] Project: ${plan.cwd}`);
+    }
+    const result = spawnSync(npmCommand(), plan.npmArgs, {
+        cwd: plan.cwd,
+        stdio: 'inherit',
+        shell: false,
+        windowsHide: false,
+    });
+
+    if (result.error) {
+        console.error('');
+        console.error(`[uniner-cli] Failed to run npm uninstall: ${result.error.message}`);
+        console.error('[uniner-cli] Runtime cleanup has already been attempted.');
+        console.error(`[uniner-cli] Please run manually: ${plan.manualCommand}`);
+        console.error('');
+        process.exit(1);
+    }
+
+    const status = result.status === null ? 1 : result.status;
+    if (status === 0) {
+        console.log('');
+        if (cleanupResult.scenariosKept > 0) {
+            console.log(`[uniner-cli] Preserved ${cleanupResult.scenariosKept} scenario(s) at:`);
+            console.log(`[uniner-cli]   ${cleanupResult.scenariosDir}`);
+        }
+        console.log('[uniner-cli] Uninstall complete.');
+        console.log('');
+    }
+    process.exit(status);
+}
+
+if (process.argv[2] === 'uninstall' &&
+    (process.argv[3] === '--help' || process.argv[3] === '-h')) {
+    printUninstallHelp();
+    process.exit(0);
+}
+
+if (process.argv[2] === 'uninstall') {
+    runFullUninstall();
+}
 
 const exe = realBinaryPath();
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "uniner-cli",
-    "version":  "1.0.6",
+    "version":  "1.0.7",
     "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",
@@ -47,4 +47,4 @@
                   "README.md",
                   "LICENSE"
               ]
-}
+}

package/scripts/postinstall.js

@@ -28,6 +28,7 @@ const { spawnSync } = require('child_process');
 
 const {
     pkg,
+    rootDir,
     versionDir,
     realBinaryPath,
     isInstalled,
@@ -237,6 +238,159 @@ function writeSkillMd(installPath, version) {
     }
 }
 
+// ----------------------------------------------------------------------
+// Write standalone cleanup script to ~/.uniner-cli/cleanup.js
+//
+// npm 7+ no longer reliably runs `preuninstall` hooks for global packages,
+// so `npm uninstall -g uniner-cli` leaves ~/.uniner-cli/ and the SKILL.md
+// behind. To give users a reliable cleanup path, we write a self-contained
+// cleanup script to ~/.uniner-cli/cleanup.js during install. This file lives
+// OUTSIDE the npm package directory, so it survives `npm uninstall`.
+//
+// Usage after `npm uninstall -g uniner-cli`:
+//   node ~/.uniner-cli/cleanup.js
+// ----------------------------------------------------------------------
+
+function writeCleanupScript() {
+    const root = path.join(os.homedir(), '.uniner-cli');
+    const cleanupPath = path.join(root, 'cleanup.js');
+
+    // NOTE: this string is written verbatim to disk — no require(), no
+    // imports, no template tokens. It must be 100% self-contained Node.js.
+    const script = `#!/usr/bin/env node
+// cleanup.js — uninstall cleanup for uniner-cli.
+//
+// WHY THIS FILE EXISTS
+// --------------------
+// npm 7+ (including npm 11) does NOT reliably execute the \`preuninstall\`
+// lifecycle hook for globally installed packages. Running
+// \`npm uninstall -g uniner-cli\` removes the npm package but leaves:
+//   - ~/.uniner-cli/           (runtime binaries, skills, docs)
+//   - ~/.claude/skills/uniner-cli/SKILL.md  (Claude Code skill file)
+//
+// This script was written to this location by the postinstall hook. Because
+// it lives OUTSIDE the npm package directory, it survives \`npm uninstall\`
+// and can always be invoked manually:
+//
+//   node ~/.uniner-cli/cleanup.js
+//
+// Idempotent: running it twice is harmless; the second run just reports
+// "nothing to clean".
+//
+// WHAT IT PRESERVES
+// -----------------
+// The \`scenarios/\` subdirectory under
+//   ~/.claude/skills/uniner-cli/scenarios/
+// contains user-accumulated knowledge (saved workflows). Those are NEVER
+// deleted by this script — only the single SKILL.md file is removed.
+
+'use strict';
+
+const fs   = require('fs');
+const path = require('path');
+const os   = require('os');
+
+const rootDir      = path.join(os.homedir(), '.uniner-cli');
+const claudeSkillRoot = path.join(os.homedir(), '.claude', 'skills', 'uniner-cli');
+const skillFilePath   = path.join(claudeSkillRoot, 'SKILL.md');
+const scenariosDir    = path.join(claudeSkillRoot, 'scenarios');
+
+function rmRf(p) {
+    try {
+        if (fs.existsSync(p)) {
+            fs.rmSync(p, { recursive: true, force: true });
+            return true;
+        }
+        return false;
+    } catch (_) { return false; }
+}
+
+function rmFile(p) {
+    try {
+        if (fs.existsSync(p)) {
+            fs.unlinkSync(p);
+            return true;
+        }
+        return false;
+    } catch (_) { return false; }
+}
+
+console.log('');
+console.log('==========================================');
+console.log('  uniner-cli uninstall cleanup');
+console.log('==========================================');
+
+let didSomething = false;
+
+// 1. Remove entire ~/.uniner-cli/ tree (all versions + this script itself).
+if (rmRf(rootDir)) {
+    console.log('[uniner-cli] Removed ' + rootDir);
+    didSomething = true;
+}
+
+// 2. Remove ONLY the SKILL.md file. NEVER rm -rf the whole skill dir —
+//    scenarios/ lives there and is the user's accumulated knowledge.
+if (rmFile(skillFilePath)) {
+    console.log('[uniner-cli] Removed ' + skillFilePath);
+    didSomething = true;
+}
+
+// 3. Count preserved scenarios.
+let scenariosKept = 0;
+if (fs.existsSync(scenariosDir)) {
+    try {
+        scenariosKept = fs.readdirSync(scenariosDir).filter(function(n) {
+            return fs.existsSync(path.join(scenariosDir, n, 'meta.json'));
+        }).length;
+    } catch (_) {}
+}
+
+// 4. If the skill dir is now empty, remove it. Otherwise keep it.
+try {
+    if (fs.existsSync(claudeSkillRoot)) {
+        var remaining = fs.readdirSync(claudeSkillRoot);
+        if (remaining.length === 0) {
+            fs.rmdirSync(claudeSkillRoot);
+            console.log('[uniner-cli] Removed empty ' + claudeSkillRoot);
+            didSomething = true;
+        } else if (scenariosKept > 0) {
+            console.log('[uniner-cli] Keeping ' + claudeSkillRoot +
+                        ' (' + scenariosKept + ' scenario(s) preserved)');
+        }
+    }
+} catch (_) {}
+
+console.log('');
+if (scenariosKept > 0) {
+    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('');
+}
+
+if (didSomething) {
+    console.log('Cleanup done.');
+} else {
+    console.log('Nothing to clean — already removed.');
+}
+console.log('');
+`;
+
+    try {
+        fs.mkdirSync(root, { recursive: true });
+        fs.writeFileSync(cleanupPath, script, 'utf8');
+        log(`Uninstall cleanup helper written to ${cleanupPath}`);
+        log(`  After \`npm uninstall -g uniner-cli\`, run:`);
+        log(`    node ${cleanupPath}`);
+    } catch (e) {
+        // Non-fatal: cleanup.js is a convenience, not required for install to succeed.
+        log(`[WARN] Could not write cleanup helper: ${e.message}`);
+    }
+}
+
 // ----------------------------------------------------------------------
 // Main
 // ----------------------------------------------------------------------
@@ -267,6 +421,9 @@ async function main() {
         // Still re-render the skill — it's tiny and lets users edit the template
         // and re-run rebuild to refresh.
         writeSkillMd(versionDir(version), version);
+        // Refresh the cleanup helper too — it's idempotent and ensures the
+        // script is always present after any postinstall run.
+        writeCleanupScript();
         return;
     }
 
@@ -344,6 +501,13 @@ async function main() {
     step('Installing Claude Code skill');
     writeSkillMd(targetDir, version);
 
+    // Write the standalone cleanup helper to ~/.uniner-cli/cleanup.js.
+    // This survives `npm uninstall` (the npm package dir is gone but this
+    // file persists), giving users a reliable way to clean up residual
+    // files even when the `preuninstall` hook doesn't fire.
+    step('Writing uninstall cleanup helper');
+    writeCleanupScript();
+
     console.log('');
     console.log('==========================================');
     console.log(`  uniner-cli ${version} installed`);
@@ -352,6 +516,10 @@ async function main() {
     console.log(`  Location: ${targetDir}`);
     console.log(`  Skill:    ${skillFile()}`);
     console.log('');
+    console.log('  To uninstall:');
+    console.log('    uniner-cli uninstall   # auto-detects global vs local install');
+    console.log(`    node ${path.join(rootDir(), 'cleanup.js')}   # fallback cleanup after npm uninstall`);
+    console.log('');
 
     // macOS 首次运行提示（无代码签名）
     if (platformInfo.platform === 'darwin') {