uniner-cli 1.0.3 → 1.0.6

package/scripts/postinstall.js

@@ -1,428 +1,385 @@
-#!/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 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 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.
-//
-// 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}`);
-    }
-}
-
-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
-// ----------------------------------------------------------------------
-
-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 });
-
-    // IMPORTANT: only writeFileSync the single SKILL.md file. Do NOT touch
-    // anything else under ~/.claude/skills/uniner-cli/. In particular, the
-    // scenarios/ subdirectory is the user's accumulated knowledge — if we
-    // ever rmdir or rmSync this directory we'd wipe their library on every
-    // upgrade. Single-file write is the contract.
-    fs.writeFileSync(skillFile(), content, 'utf8');
-    log(`    SKILL.md written to ${skillFile()}`);
-
-    // Tell the user we kept their scenarios (if any).
-    const scenariosDir = path.join(dir, 'scenarios');
-    if (fs.existsSync(scenariosDir)) {
-        try {
-            const count = fs.readdirSync(scenariosDir).filter(n => {
-                const meta = path.join(scenariosDir, n, 'meta.json');
-                return fs.existsSync(meta);
-            }).length;
-            log(`    [INFO] Preserved ${count} scenario(s) in ${scenariosDir}`);
-        } catch (_) {
-            // best-effort; never fail postinstall over a logging stat
-        }
-    }
-}
-
-// ----------------------------------------------------------------------
-// Main
-// ----------------------------------------------------------------------
-
-async function main() {
-    console.log('');
-    console.log('==========================================');
-    console.log('  uniner-cli postinstall');
-    console.log('==========================================');
-
-    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 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 artifacts from latest.json.`);
-    }
-
-    step('Downloading portable archive');
-    const tmpDir = path.join(os.tmpdir(), 'uniner-cli-npm-install');
-    fs.mkdirSync(tmpDir, { recursive: true });
-    const archivePath = path.join(tmpDir, path.basename(platform.archiveUrl));
-
-    log(`    From: ${platform.archiveUrl}`);
-    log(`    To:   ${archivePath}`);
-    await downloadWithRetry(platform.archiveUrl, archivePath, platform.archiveSize);
-
-    step('Verifying SHA-256');
-    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.');
-
-    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 });
-    }
-    platform.extract(archivePath, targetDir);
-
-    // 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, platform.expectedInnerBinary))) {
-            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(archivePath); } 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);
-});
+#!/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');
+
+const {
+    getPlatformInfo,
+    selectMetadata,
+    extractArchive,
+    getBinaryName
+} = require('./postinstall-helpers');
+
+// ----------------------------------------------------------------------
+// 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);
+    });
+}
+
+// ----------------------------------------------------------------------
+// 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 });
+
+    // IMPORTANT: only writeFileSync the single SKILL.md file. Do NOT touch
+    // anything else under ~/.claude/skills/uniner-cli/. In particular, the
+    // scenarios/ subdirectory is the user's accumulated knowledge — if we
+    // ever rmdir or rmSync this directory we'd wipe their library on every
+    // upgrade. Single-file write is the contract.
+    fs.writeFileSync(skillFile(), content, 'utf8');
+    log(`    SKILL.md written to ${skillFile()}`);
+
+    // Tell the user we kept their scenarios (if any).
+    const scenariosDir = path.join(dir, 'scenarios');
+    if (fs.existsSync(scenariosDir)) {
+        try {
+            const count = fs.readdirSync(scenariosDir).filter(n => {
+                const meta = path.join(scenariosDir, n, 'meta.json');
+                return fs.existsSync(meta);
+            }).length;
+            log(`    [INFO] Preserved ${count} scenario(s) in ${scenariosDir}`);
+        } catch (_) {
+            // best-effort; never fail postinstall over a logging stat
+        }
+    }
+}
+
+// ----------------------------------------------------------------------
+// Main
+// ----------------------------------------------------------------------
+
+async function main() {
+    console.log('');
+    console.log('==========================================');
+    console.log('  uniner-cli postinstall');
+    console.log('==========================================');
+
+    // 检查平台支持
+    const platformInfo = getPlatformInfo();
+    if (!platformInfo) {
+        fail(`不支持的平台: ${process.platform} ${process.arch}。` +
+             '当前仅支持 Windows x64 和 macOS ARM64。');
+    }
+
+    log(`平台: ${platformInfo.platform} ${platformInfo.arch}`);
+
+    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 platformMeta = selectMetadata(meta);
+    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 archivePath = path.join(tmpDir, path.basename(platformMeta.portable_url));
+
+    log(`    From: ${platformMeta.portable_url}`);
+    log(`    To:   ${archivePath}`);
+    await downloadWithRetry(platformMeta.portable_url, archivePath, platformMeta.portable_size);
+
+    step('Verifying SHA-256');
+    const actual = await sha256OfFile(archivePath);
+    if (actual.toLowerCase() !== platformMeta.portable_sha256.toLowerCase()) {
+        try { fs.unlinkSync(archivePath); } catch (_) {}
+        fail(`SHA-256 mismatch.\n  expected: ${platformMeta.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 });
+    }
+    extractArchive(archivePath, targetDir);
+
+    // 获取当前平台的二进制文件名
+    const binaryName = getBinaryName();
+
+    // build_portable.bat / build_cli_mac.sh puts everything inside an extra 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', binaryName))) {
+            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(archivePath); } 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('');
+
+    // macOS 首次运行提示（无代码签名）
+    if (platformInfo.platform === 'darwin') {
+        console.log('  ⚠️  macOS 首次运行提示:');
+        console.log('     如果系统提示"无法验证开发者"，请前往:');
+        console.log('     系统设置 → 隐私与安全性 → 仍要打开');
+        console.log('');
+    }
+
+    // Linux headless 环境提示
+    if (platformInfo.platform === 'linux') {
+        console.log('  ℹ️  Linux 环境提示:');
+        console.log('     浏览器自动化（web 模块）在 headless 环境下');
+        console.log('     可能需要 xvfb 或设置 Playwright HTTPS-only 模式');
+        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);
+});