@jonathanleelx/meddle 0.3.1 → 0.4.0-beta.10

package/bin/commands/update.js

@@ -0,0 +1,236 @@
+/**
+ * meddle update - Check for updates and upgrade meddle
+ *
+ * Usage:
+ *   meddle update                    check and upgrade to the latest version
+ *   meddle update --beta             check and upgrade to the latest beta version
+ *   meddle update --check            only check, print the available version
+ *   meddle update --version <x.y.z>  install a specific version
+ *   meddle update --auto on|off      enable/disable auto-update (default off)
+ *   meddle update status             show install method / versions / auto-update
+ */
+
+const os = require('os')
+const path = require('path')
+const { spawnSync } = require('child_process')
+const { resolveMeddleHome } = require('../lib/meddle-home')
+const output = require('../lib/output')
+const {
+    compareVersions,
+    getLatestVersionNpm,
+    getLatestVersionGithub,
+    getInstallMethod,
+    checkForUpdate,
+    downloadBinaryAsset,
+    getAutoUpdate,
+    setAutoUpdate,
+    inferChannel,
+} = require('../lib/update-check')
+
+const PACKAGE_NAME = '@jonathanleelx/meddle'
+
+const args = process.argv.slice(2)
+const jsonFlag = args.includes('--json')
+output.setJsonMode(jsonFlag)
+
+const current = require(path.join(__dirname, '../../package.json')).version
+const home = resolveMeddleHome()
+const installMethod = getInstallMethod({ moduleDir: __dirname })
+
+function isNpmInstall() {
+    return installMethod === 'npm'
+}
+
+function formatBytes(bytes) {
+    if (bytes >= 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MB`
+    if (bytes >= 1024) return `${(bytes / 1024).toFixed(1)} KB`
+    return `${bytes} B`
+}
+
+const PROGRESS_WIDTH = 40
+
+function drawProgressBar({ received, total, attempt, maxAttempts }) {
+    const label = attempt > 1 ? ` (第 ${attempt}/${maxAttempts} 次尝试)` : ''
+    if (total > 0) {
+        const ratio = Math.min(1, received / total)
+        const filled = Math.round(PROGRESS_WIDTH * ratio)
+        const bar = '#'.repeat(filled) + '-'.repeat(PROGRESS_WIDTH - filled)
+        const line = `    [${bar}] ${(ratio * 100).toFixed(1)}% ${formatBytes(received)}/${formatBytes(total)}${label}`
+        process.stdout.write(`\r${line}`)
+    } else {
+        process.stdout.write(`\r    下载中 ${formatBytes(received)}${label}...`)
+    }
+}
+
+function showHelp() {
+    output.plain(`
+meddle update - 检查并升级 meddle
+
+用法:
+  meddle update                   检查并升级（beta 版本默认走 beta 频道）
+  meddle update --beta            切换到 beta 频道并升级到最新 beta 版本
+  meddle update --stable          切换到稳定频道并升级到最新稳定版本（可降级）
+  meddle update --check           仅检查，提示可用版本 (有新版本时退出码为 2)
+  meddle update --check --beta    仅检查 beta 版本
+  meddle update --version <x.y.z> 安装指定版本
+  meddle update --auto on|off     启用/禁用自动更新 (默认关闭)
+  meddle update status            查看安装方式、当前版本和自动更新开关
+  meddle update --help, -h        显示帮助
+`)
+}
+
+async function resolveLatest({ force = false, notify = true, channel = 'stable', explicitChannel = false } = {}) {
+    const info = await checkForUpdate({
+        home,
+        installMethod,
+        current,
+        force,
+        channel,
+        explicitChannel,
+    })
+    if (notify) {
+        if (info.outdated) {
+            output.info(`发现新版本 ${info.latest} (当前 ${info.current})`)
+        } else if (info.latest === info.current) {
+            output.success(`已是最新版本 (${info.current})`)
+        } else {
+            const channelLabel = info.channel === 'beta' ? 'beta' : '稳定'
+            output.info(`当前 ${info.current} 已超过${channelLabel}频道最新版本 ${info.latest}`)
+        }
+    }
+    return info
+}
+
+async function installVersion(version) {
+    if (!isNpmInstall()) {
+        const binDir = process.env.MEDDLE_BIN_DIR || path.join(home, 'bin')
+        const destFile = path.join(binDir, os.platform() === 'win32' ? 'meddle.exe' : 'meddle')
+        output.info(`下载 meddle ${version} (${os.platform()}/${os.arch()})...`)
+        let progressShown = false
+        const showProgress = output.isJsonMode() ? () => {} : drawProgressBar
+        try {
+            const result = await downloadBinaryAsset({
+                version,
+                destFile,
+                platform: os.platform(),
+                arch: os.arch(),
+                onAttempt: (attempt, maxAttempts) => {
+                    if (attempt > 1) {
+                        process.stdout.write('\n')
+                        progressShown = false
+                        output.info(`连接中断，正在重试 (${attempt}/${maxAttempts})...`)
+                    }
+                },
+                onProgress: (p) => {
+                    showProgress(p)
+                    progressShown = true
+                },
+            })
+            if (progressShown) process.stdout.write('\n')
+            output.success(`已安装 meddle ${version} 到 ${result.installed}`)
+            if (result.backup) output.info(`旧版本已备份到 ${result.backup}`)
+            output.info('重启 meddle 后新版本生效')
+        } catch (err) {
+            if (progressShown) process.stdout.write('\n')
+            output.error(`升级失败: ${err && err.message ? err.message : err}`)
+            process.exit(1)
+        }
+        return
+    }
+
+    output.info(`正在通过 npm 升级 ${PACKAGE_NAME}@${version}...`)
+    const child = spawnSync('npm', ['install', '-g', `${PACKAGE_NAME}@${version}`], {
+        stdio: 'inherit',
+        // On Windows `npm` resolves to npm.cmd which Node cannot spawn directly
+        // unless run through a shell (Node >=18.20.2/20.12.2/22.3.0: EINVAL; older: ENOENT).
+        shell: os.platform() === 'win32',
+    })
+    if (child.error) {
+        output.error(`npm 升级失败: ${child.error.message}`)
+        process.exit(1)
+    }
+    if (child.status !== 0) {
+        output.error(`npm 升级失败 (exit ${child.status})`)
+        process.exit(child.status || 1)
+    }
+    output.success(`已升级到 ${PACKAGE_NAME}@${version}`)
+}
+
+async function run() {
+    const flag = args.find((a) => a === '--check' || a === 'status' || a === '--help' || a === '-h')
+    const versionFlagIndex = args.indexOf('--version')
+    const autoFlagIndex = args.indexOf('--auto')
+    const explicitChannel = args.includes('--beta') || args.includes('--stable')
+    const channel = args.includes('--beta') ? 'beta' : args.includes('--stable') ? 'stable' : inferChannel(current)
+
+    if (flag === '--help' || flag === '-h') {
+        showHelp()
+        return
+    }
+
+    if (flag === 'status') {
+        const info = await resolveLatest({ notify: false, channel, explicitChannel })
+        output.header('Meddle Update Status')
+        output.kv('Install method', installMethod)
+        output.kv('Channel', channel)
+        output.kv('Current', info.current)
+        output.kv('Latest', info.latest)
+        output.kv('Auto-update', getAutoUpdate(home) ? 'on' : 'off')
+        output.info(info.outdated ? '有新版本可用，运行 meddle update 升级' : '已是最新版本')
+        return
+    }
+
+    if (autoFlagIndex >= 0) {
+        const value = args[autoFlagIndex + 1]
+        if (value !== 'on' && value !== 'off') {
+            output.error('--auto 需要 on 或 off')
+            process.exit(1)
+        }
+        setAutoUpdate(home, value === 'on')
+        if (value === 'on' && isNpmInstall()) {
+            output.success('自动更新已启用（npm 安装下仅启动时提示，仍需要运行 meddle update 升级）')
+        } else {
+            output.success(
+                `自动更新已${value === 'on' ? '启用' : '关闭'}${value === 'on' ? '（重启 meddle 后生效）' : ''}`,
+            )
+        }
+        return
+    }
+
+    if (versionFlagIndex >= 0) {
+        const version = args[versionFlagIndex + 1]
+        if (!version) {
+            output.error('--version 需要版本号')
+            process.exit(1)
+        }
+        const currentCompare = (() => {
+            try { return compareVersions(version, current) } catch (_) { return null }
+        })()
+        if (currentCompare === null) {
+            output.error(`无效版本号: ${version}`)
+            process.exit(1)
+        }
+        if (currentCompare <= 0) {
+            output.info(`当前已是 ${current}，无需降级`)
+            return
+        }
+        await installVersion(version)
+        return
+    }
+
+    if (flag === '--check') {
+        const info = await resolveLatest({ channel, explicitChannel })
+        if (info.outdated) process.exit(2)
+        return
+    }
+
+    // default: check + upgrade
+    const info = await resolveLatest({ channel, explicitChannel })
+    if (!info.outdated) return
+    await installVersion(info.latest)
+}
+
+run().catch((err) => {
+    output.error(`检查更新失败: ${err && err.message ? err.message : err}`)
+    process.exit(1)
+})

package/bin/index.js

@@ -32,6 +32,7 @@ const commands = {
   'url': './commands/url.js',
   'status': './commands/status.js',
   'version': './commands/version.js',
+  'update': './commands/update.js',
   'session': './commands/session/index.js',
   'mock': './commands/mock/index.js',
   'route': './commands/route/index.js'
@@ -77,6 +78,9 @@ Meddle - 开发代理工具
   meddle status                   查看代理状态
   meddle version                  查看版本信息
   meddle --version, -v            查看版本信息 (快捷别名)
+  meddle update                   检查并升级到最新版本
+  meddle update --check           仅检查更新
+  meddle update --auto on|off     启用/禁用自动更新 (默认关闭)
 
 Session 命令 (多实例隔离，预览功能):
   meddle session create [--name <label>] [--port <port>]

package/bin/lib/update-check.js

@@ -0,0 +1,523 @@
+/**
+ * meddle update-check — version check + update download utilities.
+ *
+ * Pure JS so it runs unmodified in the npm package and in the deno-compiled
+ * binary (bin/ is bundled at compile time). Network is injected via
+ * `fetchImpl` so specs can point at local fixtures without touching the
+ * real npm registry / GitHub.
+ *
+ * Version sources:
+ *   - npm installs  → npm registry (https://registry.npmjs.org/@jonathanleeelx/meddle/latest)
+ *   - binary installs → GitHub releases/latest redirect (same logic as scripts/install-binary.sh)
+ */
+
+const fs = require('fs')
+const os = require('os')
+const path = require('path')
+const crypto = require('crypto')
+const { resolveMeddleHome } = require('./meddle-home')
+
+const PACKAGE_NAME = '@jonathanleelx/meddle'
+const REPO = 'JonathanLee-LX/meddle'
+const DEFAULT_NPM_REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`
+const DEFAULT_NPM_BETA_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/beta`
+const DEFAULT_GITHUB_LATEST_URL = `https://github.com/${REPO}/releases/latest`
+const DEFAULT_DOWNLOAD_BASE_URL = `https://github.com/${REPO}/releases/download`
+const DEFAULT_CACHE_TTL_MS = 24 * 60 * 60 * 1000
+const DEFAULT_TIMEOUT_MS = 5000
+const DEFAULT_DOWNLOAD_TIMEOUT_MS = 5 * 60 * 1000
+
+const VERSION_RE = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/
+
+/**
+ * Parse a semver-ish string. Returns { major, minor, patch, prerelease } or
+ * null when the input is not a valid version.
+ */
+function parseVersion(value) {
+    if (typeof value !== 'string') return null
+    const m = VERSION_RE.exec(value.trim())
+    if (!m) return null
+    return {
+        major: Number(m[1]),
+        minor: Number(m[2]),
+        patch: Number(m[3]),
+        prerelease: m[4] ? m[4].split('.') : [],
+    }
+}
+
+/**
+ * @param {unknown} value
+ * @returns {boolean}
+ */
+function isValidVersion(value) {
+    return parseVersion(value) !== null
+}
+
+/**
+ * Compare two semver strings. -1 when a < b, 0 when equal, 1 when a > b.
+ * Prereleases sort before their release (0.4.0-beta.1 < 0.4.0).
+ * @throws {Error} when either argument is not a valid version.
+ */
+function compareVersions(a, b) {
+    const va = parseVersion(a)
+    const vb = parseVersion(b)
+    if (!va) throw new Error(`Invalid version: ${a}`)
+    if (!vb) throw new Error(`Invalid version: ${b}`)
+
+    const partsA = [va.major, va.minor, va.patch]
+    const partsB = [vb.major, vb.minor, vb.patch]
+    for (let i = 0; i < 3; i++) {
+        if (partsA[i] !== partsB[i]) return partsA[i] < partsB[i] ? -1 : 1
+    }
+
+    if (va.prerelease.length === 0 && vb.prerelease.length === 0) return 0
+    if (va.prerelease.length === 0) return 1
+    if (vb.prerelease.length === 0) return -1
+
+    const len = Math.max(va.prerelease.length, vb.prerelease.length)
+    for (let i = 0; i < len; i++) {
+        const pa = va.prerelease[i]
+        const pb = vb.prerelease[i]
+        if (pa === undefined) return -1
+        if (pb === undefined) return 1
+        const na = /^\d+$/.test(pa)
+        const nb = /^\d+$/.test(pb)
+        if (na && nb) {
+            if (Number(pa) !== Number(pb)) return Number(pa) < Number(pb) ? -1 : 1
+        } else if (na !== nb) {
+            // numeric identifiers always sort below non-numeric ones
+            return na ? -1 : 1
+        } else if (pa !== pb) {
+            return pa < pb ? -1 : 1
+        }
+    }
+    return 0
+}
+
+/**
+ * Fetch the latest version from the npm registry.
+ * @param {{ fetchImpl?: Function, registryUrl?: string, timeoutMs?: number, distTag?: string }} opts
+ * @returns {Promise<string>}
+ */
+async function getLatestVersionNpm({ fetchImpl, registryUrl, timeoutMs, distTag } = {}) {
+    const doFetch = fetchImpl || fetch
+    const url = registryUrl
+        || (distTag === 'beta'
+            ? (process.env.MEDDLE_NPM_BETA_REGISTRY_URL || process.env.MEDDLE_NPM_REGISTRY_URL || DEFAULT_NPM_BETA_URL)
+            : (process.env.MEDDLE_NPM_REGISTRY_URL || DEFAULT_NPM_REGISTRY_URL))
+    const response = await doFetch(url, { signal: AbortSignal.timeout(timeoutMs || DEFAULT_TIMEOUT_MS) })
+    if (!response.ok) throw new Error(`npm registry responded ${response.status}`)
+    const data = await response.json()
+    const version = data && typeof data.version === 'string' ? data.version : ''
+    if (!isValidVersion(version)) throw new Error(`npm registry returned no valid version`)
+    return version
+}
+
+/**
+ * Fetch the latest stable version from the GitHub releases/latest redirect
+ * (prereleases are excluded by GitHub). Beta versions resolve through the npm
+ * registry `beta` dist-tag instead — see checkForUpdate.
+ * @param {{ fetchImpl?: Function, latestUrl?: string, timeoutMs?: number }} opts
+ * @returns {Promise<string>}
+ */
+async function getLatestVersionGithub({ fetchImpl, latestUrl, timeoutMs } = {}) {
+    const doFetch = fetchImpl || fetch
+    const url = latestUrl || process.env.MEDDLE_GITHUB_LATEST_URL || DEFAULT_GITHUB_LATEST_URL
+    const response = await doFetch(url, {
+        redirect: 'manual',
+        signal: AbortSignal.timeout(timeoutMs || DEFAULT_TIMEOUT_MS),
+    })
+    if (response.status < 300 || response.status >= 400) {
+        throw new Error(`GitHub latest release did not redirect (${response.status})`)
+    }
+    const location = response.headers.get('location') || ''
+    const match = /\/tag\/(v?[\d][\w.-]*)$/.exec(location)
+    if (!match) throw new Error(`Could not resolve latest release tag`)
+    return match[1].replace(/^v/, '')
+}
+
+/**
+ * Detect how meddle was installed.
+ * npm → the module lives inside a node_modules directory.
+ * binary → deno-compiled binary (bin/ bundled inside the executable).
+ * @param {{ moduleDir: string }} opts
+ * @returns {'npm' | 'binary'}
+ */
+function getInstallMethod({ moduleDir }) {
+    return /[\\/]node_modules[\\/]/.test(moduleDir) ? 'npm' : 'binary'
+}
+
+/**
+ * @param {string} home meddle home directory
+ * @returns {string} path of the update check cache file
+ */
+function updateCachePath(home) {
+    return path.join(home, '.cache', 'update-check.json')
+}
+
+/**
+ * Infer the update channel from the current version: prerelease versions
+ * (e.g. 0.4.0-beta.4) default to the beta channel, releases to stable.
+ * @param {string} current
+ * @returns {'stable' | 'beta'}
+ */
+function inferChannel(current) {
+    return isValidVersion(current) && parseVersion(current).prerelease.length > 0 ? 'beta' : 'stable'
+}
+
+/**
+ * Decide whether the install should move to `latest`. Explicit channel flags
+ * (--beta/--stable) mean "switch channels", so a different channel always
+ * triggers the move (even a downgrade); the inferred channel only upgrades.
+ * @param {{ latest: string, current: string, channel: string, explicitChannel: boolean }} opts
+ * @returns {boolean}
+ */
+function outdatedByChannel({ latest, current, channel, explicitChannel }) {
+    if (explicitChannel && channel !== inferChannel(current)) return true
+    return compareVersions(latest, current) > 0
+}
+
+/**
+ * @param {{ home: string, fetchImpl?: Function, installMethod: string, current: string,
+ *           now?: number, ttlMs?: number, force?: boolean,
+ *           registryUrl?: string, latestUrl?: string, timeoutMs?: number,
+ *           channel?: string, explicitChannel?: boolean }} opts
+ * @returns {Promise<{ current: string, latest: string, outdated: boolean, fromCache: boolean, checkedAt: number, channel: string }>}
+ */
+async function checkForUpdate(opts) {
+    const {
+        home,
+        installMethod,
+        current,
+        now = Date.now(),
+        ttlMs = DEFAULT_CACHE_TTL_MS,
+        force = false,
+        fetchImpl,
+        registryUrl,
+        latestUrl,
+        timeoutMs,
+        channel = inferChannel(current),
+        explicitChannel = false,
+    } = opts
+
+    const cacheFile = updateCachePath(home)
+    let cached = null
+    try {
+        cached = JSON.parse(fs.readFileSync(cacheFile, 'utf8'))
+    } catch (_) {}
+
+    if (!force && cached && typeof cached.version === 'string' && typeof cached.checkedAt === 'number'
+        && (cached.channel || 'stable') === channel) {
+        if (now - cached.checkedAt < ttlMs) {
+            return {
+                current,
+                latest: cached.version,
+                outdated: outdatedByChannel({ latest: cached.version, current, channel, explicitChannel }),
+                fromCache: true,
+                checkedAt: cached.checkedAt,
+                channel,
+            }
+        }
+    }
+
+    // Beta channel always resolves via the npm registry `beta` dist-tag — the
+    // GitHub releases API is rate-limited (403) for unauthenticated callers.
+    // Binary installs still download assets from GitHub, but resolve the
+    // version number from npm where it is published in lockstep with releases.
+    const latest = channel === 'beta'
+        ? await getLatestVersionNpm({ fetchImpl, registryUrl, timeoutMs, distTag: 'beta' })
+        : installMethod === 'binary'
+            ? await getLatestVersionGithub({ fetchImpl, latestUrl, timeoutMs })
+            : await getLatestVersionNpm({ fetchImpl, registryUrl, timeoutMs })
+
+    const checkedAt = now
+    try {
+        fs.mkdirSync(path.dirname(cacheFile), { recursive: true })
+        fs.writeFileSync(cacheFile, JSON.stringify({ version: latest, checkedAt, channel }), 'utf8')
+    } catch (_) {}
+
+    return {
+        current,
+        latest,
+        outdated: outdatedByChannel({ latest, current, channel, explicitChannel }),
+        fromCache: false,
+        checkedAt,
+        channel,
+    }
+}
+
+/**
+ * Map platform/arch to the GitHub release asset name.
+ * @param {{ platform: string, arch: string }} opts
+ * @returns {string}
+ */
+function getAssetName({ platform, arch }) {
+    let osTag
+    switch (platform) {
+        case 'linux': osTag = 'linux'; break
+        case 'darwin': osTag = 'darwin'; break
+        case 'win32': osTag = 'windows'; break
+        default: throw new Error(`unsupported platform: ${platform}`)
+    }
+    let archTag
+    switch (arch) {
+        case 'x64': case 'amd64': archTag = 'x64'; break
+        case 'arm64': case 'aarch64': archTag = 'arm64'; break
+        default: throw new Error(`unsupported arch: ${arch}`)
+    }
+    const ext = platform === 'win32' ? '.exe' : ''
+    return `meddle-${osTag}-${archTag}${ext}`
+}
+
+function sha256Hex(buffer) {
+    return crypto.createHash('sha256').update(buffer).digest('hex')
+}
+
+/**
+ * Download a release binary, verify its SHA256 sidecar and atomically replace
+ * the existing binary. The previous binary is kept as `<destFile>.bak`. When
+ * the final replace fails the backup is restored and a descriptive error is
+ * thrown (Windows commonly fails with EPERM on a running binary).
+ *
+ * The payload download is retried (default 3 attempts) because binaries are
+ * large (100MB+) and flaky connections drop mid-body. Progress is reported
+ * via `onProgress` while streaming (received/total bytes), and `onAttempt`
+ * fires before each attempt (skipping retries is visible to callers).
+ * @param {{ version: string, destFile: string, platform: string, arch: string,
+ *           baseUrl?: string, fetchImpl?: Function, timeoutMs?: number,
+ *           retries?: number, retryDelayMs?: number,
+ *           onProgress?: Function, onAttempt?: Function,
+ *           fsImpl?: object }} opts
+ * @returns {Promise<{ installed: string, backup: string, version: string }>}
+ */
+async function downloadBinaryAsset(opts) {
+    const { version, destFile, platform, arch } = opts
+    const baseUrl = opts.baseUrl || process.env.MEDDLE_UPDATE_BASE_URL || DEFAULT_DOWNLOAD_BASE_URL
+    const doFetch = opts.fetchImpl || fetch
+    const fsImpl = opts.fsImpl || fs
+    const payloadTimeout = opts.timeoutMs || DEFAULT_DOWNLOAD_TIMEOUT_MS
+    const maxRetries = opts.retries === undefined ? 3 : opts.retries
+    const retryDelayMs = opts.retryDelayMs === undefined ? 1000 : opts.retryDelayMs
+    const onProgress = typeof opts.onProgress === 'function' ? opts.onProgress : () => {}
+    const onAttempt = typeof opts.onAttempt === 'function' ? opts.onAttempt : () => {}
+
+    const asset = getAssetName({ platform, arch })
+    const assetUrl = `${baseUrl}/v${version}/${asset}`
+    const shaUrl = `${assetUrl}.sha256`
+
+    // The binary is large (100MB+); the checksum sidecar is tiny. Use a long
+    // timeout for the payload and the regular timeout for the metadata fetch.
+    const fetchPayload = async () => {
+        let lastError = null
+        for (let attempt = 1; attempt <= maxRetries + 1; attempt++) {
+            if (attempt > 1 && retryDelayMs > 0) {
+                await new Promise((r) => setTimeout(r, retryDelayMs * (attempt - 1)))
+            }
+            onAttempt(attempt, maxRetries + 1)
+            try {
+                const response = await doFetch(assetUrl, { signal: AbortSignal.timeout(payloadTimeout) })
+                if (!response.ok) throw new Error(`download failed (${response.status})`)
+                const total = Number(response.headers.get('content-length')) || 0
+                const chunks = []
+                let received = 0
+                if (response.body && typeof response.body.getReader === 'function') {
+                    const reader = response.body.getReader()
+                    for (;;) {
+                        const { done, value } = await reader.read()
+                        if (done) break
+                        chunks.push(Buffer.from(value))
+                        received += value.byteLength
+                        onProgress({ received, total })
+                    }
+                } else {
+                    const buf = Buffer.from(await response.arrayBuffer())
+                    chunks.push(buf)
+                    received = buf.length
+                    onProgress({ received, total })
+                }
+                return Buffer.concat(chunks)
+            } catch (err) {
+                lastError = err
+                if (attempt > maxRetries) break
+            }
+        }
+        throw lastError || new Error(`download failed for ${assetUrl}`)
+    }
+
+    const shaResponse = await doFetch(shaUrl, { signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS) })
+    if (!shaResponse.ok) throw new Error(`checksum sidecar missing (${shaResponse.status})`)
+
+    const payload = await fetchPayload()
+    const shaText = await shaResponse.text()
+    const expected = shaText.trim().split(/\s+/)[0]
+    if (!/^[0-9a-f]{64}$/i.test(expected)) throw new Error(`invalid checksum sidecar`)
+    if (sha256Hex(payload) !== expected.toLowerCase()) {
+        throw new Error(`checksum mismatch for ${asset}`)
+    }
+
+    const dir = path.dirname(destFile)
+    fsImpl.mkdirSync(dir, { recursive: true })
+
+    const tmpFile = `${destFile}.tmp-${process.pid}`
+    fsImpl.writeFileSync(tmpFile, payload)
+    if (platform !== 'win32') fsImpl.chmodSync(tmpFile, 0o755)
+
+    const backup = `${destFile}.bak`
+    try {
+        if (fsImpl.existsSync(backup)) fsImpl.unlinkSync(backup)
+        if (fsImpl.existsSync(destFile)) fsImpl.renameSync(destFile, backup)
+    } catch (_) {}
+    try {
+        fsImpl.renameSync(tmpFile, destFile)
+    } catch (err) {
+        try {
+            if (fsImpl.existsSync(backup) && !fsImpl.existsSync(destFile)) {
+                fsImpl.renameSync(backup, destFile)
+            }
+        } catch (_) {}
+        try { fsImpl.unlinkSync(tmpFile) } catch (_) {}
+        const hint = process.platform === 'win32'
+            ? 'Windows 下无法替换运行中的 meddle.exe，请先停止 meddle 再运行 meddle update'
+            : '替换二进制失败，请检查文件权限'
+        throw new Error(`${hint}: ${(err && err.code) || (err && err.message) || err}`)
+    }
+
+    return { installed: destFile, backup: fsImpl.existsSync(backup) ? backup : null, version }
+}
+
+/**
+ * Read the auto-update setting. Precedence: MEDDLE_AUTO_UPDATE env var
+ * (when set) → settings.json `autoUpdate` (default false).
+ * @param {string} home
+ * @returns {boolean}
+ */
+function getAutoUpdate(home) {
+    const env = process.env.MEDDLE_AUTO_UPDATE
+    if (env !== undefined && env !== '') {
+        return env === '1' || env.toLowerCase() === 'true'
+    }
+    try {
+        const settings = JSON.parse(fs.readFileSync(path.join(home, 'settings.json'), 'utf8'))
+        return settings.autoUpdate === true
+    } catch (_) {
+        return false
+    }
+}
+
+/**
+ * Persist the auto-update setting into settings.json, preserving other keys.
+ * @param {string} home
+ * @param {boolean} value
+ */
+function setAutoUpdate(home, value) {
+    const settingsPath = path.join(home, 'settings.json')
+    let settings = {}
+    try {
+        settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'))
+    } catch (_) {}
+    if (!settings || typeof settings !== 'object' || Array.isArray(settings)) settings = {}
+    settings.autoUpdate = value === true
+    fs.mkdirSync(path.dirname(settingsPath), { recursive: true })
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf8')
+}
+
+function printUpdateNotice(info) {
+    const channel = process.env.MEDDLE_UPDATE_SILENT ? undefined : console
+    if (!channel) return
+    if (info.autoUpdated) {
+        channel.log(`\n[meddle] 已自动升级到 ${info.latest}（重启 meddle 后生效）`)
+        return
+    }
+    channel.log(
+        `\n[meddle] 发现新版本 ${info.latest}（当前 ${info.current}），运行 "meddle update" 升级`
+    )
+}
+
+/**
+ * Fire-and-forget startup check. Never blocks, never throws, never keeps the
+ * process alive. When auto-update is enabled (binary installs) the new binary
+ * is downloaded and verified on disk — but only when the running executable
+ * actually matches the install dir, otherwise the download would land where it
+ * can never take effect. npm installs only get a notice.
+ * @param {{ home?: string, installMethod?: string, current: string,
+ *           binDir?: string, execPath?: string, delayMs?: number,
+ *           fetchImpl?: Function, onOutdated?: Function }} opts
+ * @returns {void}
+ */
+function resolveRealPath(p) {
+    try { return fs.realpathSync(p) } catch (_) { return path.resolve(p) }
+}
+
+function isSameBinary(a, b) {
+    return resolveRealPath(a) === resolveRealPath(b)
+}
+
+function runAsyncUpdateCheck(opts) {
+    const home = opts.home || resolveMeddleHome()
+    const installMethod = opts.installMethod || getInstallMethod({ moduleDir: __dirname })
+    const binDir = opts.binDir || process.env.MEDDLE_BIN_DIR || path.join(home, 'bin')
+    const delayMs = opts.delayMs === undefined ? 1500 : opts.delayMs
+    const execPath = opts.execPath || process.execPath
+    const exeBase = path.basename(execPath).toLowerCase()
+    const isMeddleExecutable = exeBase === 'meddle' || exeBase === 'meddle.exe'
+
+    const timer = setTimeout(() => {
+        ;(async () => {
+            const info = await checkForUpdate({
+                home,
+                installMethod,
+                current: opts.current,
+                fetchImpl: opts.fetchImpl,
+            })
+            if (!info.outdated) return
+            let finalInfo = info
+            if (getAutoUpdate(home) && installMethod === 'binary') {
+                const destFile = path.join(binDir, os.platform() === 'win32' ? 'meddle.exe' : 'meddle')
+                if (isMeddleExecutable && !isSameBinary(destFile, execPath)) {
+                    finalInfo = {
+                        ...info,
+                        skipAutoUpdate: '安装路径与当前运行路径不一致，跳过自动更新',
+                    }
+                } else {
+                    try {
+                        await downloadBinaryAsset({
+                            version: info.latest,
+                            destFile,
+                            platform: os.platform(),
+                            arch: os.arch(),
+                            baseUrl: opts.baseUrl,
+                            fetchImpl: opts.fetchImpl,
+                        })
+                        finalInfo = { ...info, autoUpdated: true, destFile }
+                    } catch (err) {
+                        finalInfo = { ...info, autoUpdateFailed: err && err.message ? err.message : String(err) }
+                    }
+                }
+            }
+            if (opts.onOutdated) {
+                opts.onOutdated(finalInfo)
+            } else {
+                printUpdateNotice(finalInfo)
+            }
+        })().catch(() => {})
+    }, delayMs)
+
+    if (typeof timer.unref === 'function') timer.unref()
+}
+
+module.exports = {
+    compareVersions,
+    isValidVersion,
+    parseVersion,
+    inferChannel,
+    getLatestVersionNpm,
+    getLatestVersionGithub,
+    getInstallMethod,
+    checkForUpdate,
+    getAssetName,
+    downloadBinaryAsset,
+    getAutoUpdate,
+    setAutoUpdate,
+    runAsyncUpdateCheck,
+    DEFAULT_DOWNLOAD_TIMEOUT_MS,
+}

package/dist/helpers.d.ts

@@ -23,6 +23,19 @@ export declare function routeRulesToLegacyMaps(rules: RouteRuleEntry[]): {
     excludeMap: ExcludeMap;
 };
 export declare function getFreePort(): Promise<number>;
+/**
+ * Listen on a port, retrying with a fresh free port when the requested one is
+ * taken. Unlike a bare `server.listen()`, a port conflict surfaces as a
+ * retryable error here instead of an async 'error' event that would escape a
+ * try/catch and crash the process via uncaughtException.
+ * @returns the port the server actually bound to
+ * @throws the last listen error when all attempts fail
+ */
+export declare function listenWithRetry(server: {
+    listen(port: number, host: string, cb?: () => void): unknown;
+} & NodeJS.EventEmitter, host: string, port: number, opts?: {
+    maxRetries?: number;
+}): Promise<number>;
 export declare const ROUTE_RULES_DIR: string;
 export interface ParseEprcResult {
     rules: RouteRuleEntry[];

package/dist/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../helpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC7C,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAElD,+BAA+B;AAC/B,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;CACxB;AA2BD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAWvE;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,EAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAW9G;AAuDD,kDAAkD;AAClD,wBAAgB,oBAAoB,CAChC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,cAAc,EAAE,GACxB;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAUvD;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,GAAG,IAAI,CAE7F;AAYD,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAC5B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,cAAc,EAAE,GAAG,OAAO,EACtC,UAAU,CAAC,EAAE,UAAU,GACxB,MAAM,GAAG,IAAI,CAKf;AAED,iDAAiD;AACjD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAQ5G;AAKD,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAKnD;AAED,eAAO,MAAM,eAAe,QAAmD,CAAC;AAKhF,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;CAC1B;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAmDxE;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,MAAM,CAmCnF;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAQ/D"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../helpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC7C,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAElD,+BAA+B;AAC/B,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;CACxB;AA2BD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAWvE;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,EAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAW9G;AAuDD,kDAAkD;AAClD,wBAAgB,oBAAoB,CAChC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,cAAc,EAAE,GACxB;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAUvD;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,GAAG,IAAI,CAE7F;AAYD,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAC5B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,cAAc,EAAE,GAAG,OAAO,EACtC,UAAU,CAAC,EAAE,UAAU,GACxB,MAAM,GAAG,IAAI,CAKf;AAED,iDAAiD;AACjD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAQ5G;AAKD,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAKnD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC3B,MAAM,EAAE;IAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAA;CAAE,GAAG,MAAM,CAAC,YAAY,EAC9F,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACnC,OAAO,CAAC,MAAM,CAAC,CA+BjB;AAED,eAAO,MAAM,eAAe,QAAmD,CAAC;AAKhF,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;CAC1B;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAmDxE;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,MAAM,CAmCnF;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAQ/D"}

package/dist/helpers.js

@@ -41,6 +41,7 @@ exports.resolveTargetUrlFromRules = resolveTargetUrlFromRules;
 exports.resolveTargetUrl = resolveTargetUrl;
 exports.routeRulesToLegacyMaps = routeRulesToLegacyMaps;
 exports.getFreePort = getFreePort;
+exports.listenWithRetry = listenWithRetry;
 exports.parseEprcWithExclusions = parseEprcWithExclusions;
 exports.parseEprc = parseEprc;
 exports.ruleMapToEprcText = ruleMapToEprcText;
@@ -193,6 +194,47 @@ async function getFreePort() {
     (0, portfinder_1.setHighestPort)(highestPort);
     return (0, portfinder_1.getPortPromise)();
 }
+/**
+ * Listen on a port, retrying with a fresh free port when the requested one is
+ * taken. Unlike a bare `server.listen()`, a port conflict surfaces as a
+ * retryable error here instead of an async 'error' event that would escape a
+ * try/catch and crash the process via uncaughtException.
+ * @returns the port the server actually bound to
+ * @throws the last listen error when all attempts fail
+ */
+function listenWithRetry(server, host, port, opts = {}) {
+    const maxRetries = opts.maxRetries ?? 5;
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const settle = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            fn();
+        };
+        const attempt = (attemptPort, remaining) => {
+            const onListening = () => {
+                server.removeListener('error', onError);
+                const addr = server.address();
+                settle(() => resolve(addr ? addr.port : attemptPort));
+            };
+            const onError = (err) => {
+                server.removeListener('listening', onListening);
+                if (err && err.code === 'EADDRINUSE' && remaining > 0) {
+                    getFreePort()
+                        .then((nextPort) => attempt(nextPort, remaining - 1))
+                        .catch((e) => settle(() => reject(e)));
+                    return;
+                }
+                settle(() => reject(err));
+            };
+            server.once('error', onError);
+            server.once('listening', onListening);
+            server.listen(attemptPort, host);
+        };
+        attempt(port, maxRetries);
+    });
+}
 exports.ROUTE_RULES_DIR = path.resolve((0, meddle_home_1.resolveMeddleHome)(), 'route-rules');
 const FILE_PATTERN = /^file:\/\//;
 const LOCAL_FILE_PATTERN = /^[A-Za-z]:\\|^\/|^\\/;

package/dist/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../helpers.ts"],"names":[],"mappings":"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"}

package/index.js

@@ -4,7 +4,7 @@ const fs = require('fs')
 const path = require('path')
 const { connect } = require('net')
 const { WebSocket, WebSocketServer } = require('ws')
-const { resolveTargetUrl, getFreePort } = require('./dist/helpers')
+const { resolveTargetUrl, getFreePort, listenWithRetry } = require('./dist/helpers')
 const { crtMgr, ensureRootCA, getRootCAPath } = require('./dist/cert')
 const { decideRoute } = require('./dist/core/route-decision')
 const { sendShortResponse } = require('./dist/core/short-response')
@@ -21,6 +21,7 @@ const {
     pluginClientIdentity,
 } = require('./dist/core/client-identity')
 const { createApplicationIdentityResolver } = require('./dist/core/application-identity')
+const { runAsyncUpdateCheck } = require('./bin/lib/update-check')
 const {
     authorizeProxyClient,
     buildRemoteAccessConfig,
@@ -493,6 +494,8 @@ localWSServer.on('connection', (client, req) => {})
 
 // ===== 启动 =====
 ;(async () => {
+    // 非阻塞异步版本检查：不会阻塞启动，失败静默，1.5s 后发起且 timer unref
+    runAsyncUpdateCheck({ current: require('./package.json').version })
     await ensureRootCA()
     await pluginBoot.bootstrapBuiltinPlugins()
     const port = await getFreePort()
@@ -868,7 +871,8 @@ proxyServer.on('connect', async (req, socket, head) => {
         if (!server) {
             const port = await getFreePort()
             server = await createHttpsServerByCert()
-            server.listen(port, '127.0.0.1', () => { proxyDebug('listening on ' + port) })
+            const boundPort = await listenWithRetry(server, '127.0.0.1', port)
+            proxyDebug('listening on ' + boundPort)
             ctx.httpsServerMap.set(originHost, server)
         } else {
             markMitmServerUsed(server)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jonathanleelx/meddle",
-  "version": "0.3.1",
+  "version": "0.4.0-beta.10",
   "description": "A simple development proxy server with custom routing rules, mock responses, HTTPS interception, and a plugin system",
   "type": "commonjs",
   "main": "index.js",
@@ -20,6 +20,7 @@
     "test:identity": "pnpm run build && node scripts/application-identity-smoke.js",
     "test:e2e": "npm run build:web && npm run build && node tests/e2e/interactions.e2e.cjs",
     "test:e2e:rule-drag": "npm run build:web && npm run build && node tests/e2e/rule-drag.e2e.cjs",
+    "test:e2e:update": "node tests/e2e/update.e2e.cjs",
     "test:watch": "vitest",
     "test:refactor": "npm run build && node -c index.js && npm test",
     "bench:logs": "node scripts/log-performance-benchmark.js",