uniner-cli 1.0.8 → 1.0.10

package/README.md

@@ -6,7 +6,7 @@
 - **Excel 操作** —— 读写、批量处理、样式
 - **OCR 识别** —— 支持验证码和通用 OCR
 - **桌面 / SAP 自动化** —— 支持桌面软件的自动化（仅 Windows）
-- **通用工具** —— 加密、HTTP、邮件、文件、PDF、压缩
+- **通用工具** —— 加密、HTTP、邮件、文件、PDF、压缩、FTP
 
 安装时会自动注册一个 [Claude Code](https://claude.com/claude-code) 技能（`~/.claude/skills/uniner-cli/SKILL.md`），让 Claude 一启动就能识别并调用本 CLI。
 
@@ -178,6 +178,12 @@ npm install -g uniner-cli
 
 ## Changelog
 
+### 1.1.0 (2026-07-05)
+
+- **feat**: SDK 1.24.0 同步 —— 新增 `tool ftp` 子命令（create-folder / check-folder / check-file / list-dir），跨平台可用
+- **feat**: `web browser close` 现在自动终止残留 chrome.exe 进程，避免进程泄漏
+- **feat**: `tool zip` 新增 `--if-exists` 参数控制文件已存在时的行为（Windows-only）
+
 ### 1.0.8 (2026-06-30)
 
 - **feat**: 改进 `uniner-cli uninstall`，增强清理逻辑与兼容性

package/bin/uniner-cli.js

@@ -26,6 +26,19 @@ function printUninstallHelp() {
     console.log('');
 }
 
+function isTopLevelHelp(args) {
+    return args.length === 1 &&
+        (args[0] === '--help' || args[0] === '-h' || args[0] === 'help');
+}
+
+function printPackageCommandsHelp() {
+    console.log('');
+    console.log('Package commands:');
+    console.log('  uninstall    Clean runtime files and remove this npm package');
+    console.log('');
+    console.log('Run "uniner-cli uninstall --help" for uninstall options.');
+}
+
 function realPath(p) {
     try {
         return fs.realpathSync.native(p);
@@ -204,6 +217,7 @@ if (process.argv[2] === 'uninstall') {
 }
 
 const exe = realBinaryPath();
+const forwardedArgs = process.argv.slice(2);
 
 if (!isInstalled()) {
     console.error('');
@@ -216,9 +230,34 @@ if (!isInstalled()) {
     process.exit(127);
 }
 
+if (isTopLevelHelp(forwardedArgs)) {
+    const helpResult = spawnSync(exe, forwardedArgs, {
+        encoding: 'utf8',
+        shell: false,
+        windowsHide: false,
+    });
+
+    if (helpResult.stdout) {
+        process.stdout.write(helpResult.stdout);
+    }
+    if (helpResult.stderr) {
+        process.stderr.write(helpResult.stderr);
+    }
+    if (helpResult.error) {
+        console.error(`[uniner-cli] Failed to launch ${exe}: ${helpResult.error.message}`);
+        process.exit(1);
+    }
+
+    const status = helpResult.status === null ? 1 : helpResult.status;
+    if (status === 0) {
+        printPackageCommandsHelp();
+    }
+    process.exit(status);
+}
+
 // 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), {
+const result = spawnSync(exe, forwardedArgs, {
     stdio: 'inherit',
     shell: false,
     windowsHide: false,

package/lib/SKILL.md.template

@@ -152,7 +152,7 @@ uniner-cli [全局选项] <模块> <子命令> <命令> [命令选项]
 ## 关键注意事项（6 条 TOC，详情看链接）
 
 1. **Chrome CDP 自动管理** — 别手动 kill Chrome；客户机必须装 Chrome 或 Edge
-2. **session 持久化** — `$TEMP/uniner-cli-sessions/sessions.json`（Windows: `%TEMP%\uniner-cli-sessions\sessions.json`）；CLI 退出后用 `web browser reconnect` 恢复
+2. **session 持久化** — `$TEMP/.uniner-cli/sessions.json`（Windows: `%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`
@@ -163,8 +163,11 @@ uniner-cli [全局选项] <模块> <子命令> <命令> [命令选项]
 | 主题 | 路径 |
 |---|---|
 | 命令树全集 + 三级参数 | [{{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) |
+| 完整命令结构（120+ 命令） | [{{INSTALL_PATH}}/skills/cli/command-tree.md]({{INSTALL_PATH}}/skills/cli/command-tree.md) |
+| execute-js 使用指南 | [{{INSTALL_PATH}}/skills/cli/execute-js-guide.md]({{INSTALL_PATH}}/skills/cli/execute-js-guide.md) |
+| 典型场景示例 | [{{INSTALL_PATH}}/skills/cli/examples.md]({{INSTALL_PATH}}/skills/cli/examples.md) |
 | Windows 配置指南 | [{{INSTALL_PATH}}/skills/windows-setup-guide.md]({{INSTALL_PATH}}/skills/windows-setup-guide.md) |
+| macOS 配置指南 | [{{INSTALL_PATH}}/skills/macos-setup-guide.md]({{INSTALL_PATH}}/skills/macos-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/) |

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "uniner-cli",
-    "version":  "1.0.8",
+    "version":  "1.0.10",
     "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",