@morndream/mihomo-tui 0.5.0-rc.0

package/dist/kernel/installer.js

@@ -0,0 +1,317 @@
+/**
+ * 内核安装四段式（spec 2026-09-13 settings-kernel §3.4，范式照搬 mihari）：
+ * staging 下载（流式 gunzip + sha256）→ 验证（-v 输出比对）→ 原子替换
+ * （备份旧二进制 + 同目录 tmp+rename）→ 重启服务并轮询 /version 确认。
+ *
+ * 任何一步失败都保证目标二进制可用：验证阶段失败只留 staging 残留（finally
+ * 清理）；替换后失败从备份恢复并再次重启。已下载过的版本归档在
+ * kernelsDir/<tag>/mihomo，切回时离线直换（跳过下载）。
+ */
+import { execFile } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { chmodSync, copyFileSync, createWriteStream, existsSync, mkdirSync, mkdtempSync, readdirSync, renameSync, rmSync, } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+import { Readable, Transform } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { createGunzip } from 'node:zlib';
+import { promisify } from 'node:util';
+import { MIHOMO_BIN_DEFAULT } from '../config/manager.js';
+import { alphaShaFromAssetName, assetNamesFor } from './releases.js';
+import { MAX_ASSET_BYTES, assetDownloadUrl, resolveSources } from './sources.js';
+export const KERNELS_DIR_DEFAULT = join(homedir(), '.local', 'share', 'mihomo-tui', 'kernels');
+const execFileAsync = promisify(execFile);
+const DOWNLOAD_TIMEOUT_MS = 15 * 60 * 1000;
+const PROBE_INTERVAL_MS = 500;
+const PROBE_ATTEMPTS = 20;
+const BACKUP_KEEP = 2;
+export class InstallError extends Error {
+    phase;
+    detail;
+    constructor(message, phase, detail) {
+        super(message);
+        this.phase = phase;
+        this.detail = detail;
+        this.name = 'InstallError';
+    }
+}
+function msg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+const defaultSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/** 归档键：稳定版用 tag；alpha 滚动 tag 每次构建的 sha 都不同，按 sha 键控避免换上陈旧 alpha */
+export function archiveKeyFor(tag, alpha, asset) {
+    if (!alpha)
+        return tag;
+    const sha = asset ? alphaShaFromAssetName(asset.name) : undefined;
+    return sha ? `Prerelease-Alpha-${sha}` : `${tag}-${Date.now()}`;
+}
+/** 归档路径：kernelsDir/<key>/mihomo */
+export function archivedBinPath(kernelsDir, key) {
+    return join(kernelsDir, key, 'mihomo');
+}
+/** 本机已归档的版本键列表（目录名即键，仅保留含 mihomo 的目录；staging-* 是崩溃残留不是归档） */
+export function listArchivedTags(kernelsDir) {
+    let entries;
+    try {
+        entries = readdirSync(kernelsDir);
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter((entry) => !entry.startsWith('staging-') && existsSync(join(kernelsDir, entry, 'mihomo')))
+        .sort();
+}
+/** 同盘原子替换：先拷到目标同目录临时名再 rename；跨盘（EXDEV）退化为直接拷贝 */
+function replaceFile(src, dst) {
+    try {
+        const tmp = `${dst}.next`;
+        copyFileSync(src, tmp);
+        renameSync(tmp, dst);
+    }
+    catch (err) {
+        if (err.code !== 'EXDEV')
+            throw err;
+        copyFileSync(src, dst);
+    }
+}
+/** 保留最近 keep 份 <bin>.bak.* 备份（含刚创建的那份），其余清理 */
+function pruneBackups(binPath, keep) {
+    const prefix = `${basename(binPath)}.bak.`;
+    let entries;
+    try {
+        entries = readdirSync(dirname(binPath));
+    }
+    catch {
+        return;
+    }
+    const backups = entries
+        .filter((entry) => entry.startsWith(prefix))
+        .map((entry) => join(dirname(binPath), entry))
+        .sort()
+        .reverse();
+    for (const stale of backups.slice(keep)) {
+        rmSync(stale, { force: true });
+    }
+}
+/** 流式下载 .gz：边下边算 sha256，gunzip 落盘到 binFile；字节进度按 ≥512KB 节流上报 */
+async function downloadAndGunzip(url, binFile, total, deps) {
+    const { fetchImpl = fetch } = deps;
+    const response = await fetchImpl(url, {
+        headers: { 'User-Agent': 'mihomo-tui' },
+        signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT_MS),
+    });
+    if (!response.ok || !response.body) {
+        throw new InstallError(`下载失败：HTTP ${response.status}`, 'download');
+    }
+    const declared = Number(response.headers.get('content-length'));
+    const totalBytes = total ?? (Number.isFinite(declared) && declared > 0 ? declared : undefined);
+    const hash = createHash('sha256');
+    let received = 0;
+    let lastEmit = 0;
+    const counter = new Transform({
+        transform(chunk, _enc, callback) {
+            received += chunk.length;
+            hash.update(chunk);
+            if (received - lastEmit >= 512 * 1024) {
+                lastEmit = received;
+                deps.onProgress?.({
+                    phase: 'download',
+                    message: '下载内核',
+                    received,
+                    ...(totalBytes !== undefined ? { total: totalBytes } : {}),
+                });
+            }
+            callback(null, chunk);
+        },
+    });
+    await pipeline(Readable.fromWeb(response.body), counter, createGunzip(), createWriteStream(binFile, { mode: 0o700 }));
+    return { sha256: hash.digest('hex'), received };
+}
+/** 候选二进制验证：chmod 0700 → `-v` 输出必须含验证标记（稳定版 tag / alpha sha） */
+async function verifyBinary(binFile, marker) {
+    chmodSync(binFile, 0o700);
+    let output;
+    try {
+        const { stdout, stderr } = await execFileAsync(binFile, ['-v'], { timeout: 15_000 });
+        output = `${stdout}${stderr}`;
+    }
+    catch (err) {
+        const e = err;
+        throw new InstallError('内核二进制无法执行', 'verify', `${e.stdout ?? ''}${e.stderr ?? ''}`.trim() || msg(err));
+    }
+    if (!output.includes(marker)) {
+        throw new InstallError(`-v 输出不含目标版本标记 ${marker}`, 'verify', output.trim());
+    }
+}
+/**
+ * 从备份恢复目标二进制并尽力恢复服务；返回回滚过程中的问题清单
+ * （空数组 = 干净回滚）。恢复失败也仍尝试重启：与其留下一个可能损坏的
+ * 目标二进制 + 停摆的服务，不如让服务拉起盘上现存的二进制。
+ */
+async function restoreBackup(binPath, backupPath, restart) {
+    const problems = [];
+    if (backupPath && existsSync(backupPath)) {
+        try {
+            replaceFile(backupPath, binPath);
+        }
+        catch (err) {
+            problems.push(`恢复备份失败：${msg(err)}`);
+        }
+    }
+    if (restart) {
+        try {
+            await restart();
+        }
+        catch (err) {
+            problems.push(`恢复性重启失败：${msg(err)}`);
+        }
+    }
+    return problems;
+}
+/** 把回滚问题并进错误文案：干净回滚注明「已回滚」，失败则如实陈述（绝不静默撒谎） */
+function rollbackSuffix(problems) {
+    return problems.length > 0 ? `；回滚失败：${problems.join('；')}` : '（已回滚旧内核）';
+}
+/** 安装/切换内核：四段式 + 失败回滚。成功返回 { tag, fromArchive }。 */
+export async function installKernel(input, deps = {}) {
+    const binPath = deps.mihomoBin ?? MIHOMO_BIN_DEFAULT;
+    const kernelsDir = deps.kernelsDir ?? KERNELS_DIR_DEFAULT;
+    const sleep = deps.sleep ?? defaultSleep;
+    const emit = (progress) => deps.onProgress?.(progress);
+    const { tag } = input;
+    if (input.alpha && !input.asset) {
+        throw new InstallError('Alpha 版需要资产信息才能确定验证标记', 'download');
+    }
+    // -v 输出验证标记：稳定版为 tag（如 v1.19.30）；alpha 为资产名中的短 sha
+    const marker = input.alpha
+        ? (input.asset ? alphaShaFromAssetName(input.asset.name) : undefined) ?? tag
+        : tag;
+    mkdirSync(kernelsDir, { recursive: true });
+    const archiveKey = archiveKeyFor(tag, Boolean(input.alpha), input.asset);
+    const archivedBin = archivedBinPath(kernelsDir, archiveKey);
+    const fromArchive = existsSync(archivedBin);
+    if (!fromArchive) {
+        const staging = mkdtempSync(join(kernelsDir, 'staging-'));
+        try {
+            const names = input.asset ? [input.asset.name] : assetNamesFor(tag);
+            const binFile = join(staging, 'mihomo');
+            emit({
+                phase: 'download',
+                message: '下载内核',
+                received: 0,
+                ...(input.asset?.size ? { total: input.asset.size } : {}),
+            });
+            // 源 × 资产名组合逐个尝试：镜像不可达或 404（如无 compatible 变体）都落到下一组合
+            let sha256;
+            let lastError;
+            outer: for (const source of resolveSources(deps.sourceConfig, 'dl')) {
+                for (const name of names) {
+                    const url = `${source.prefix}${assetDownloadUrl(tag, name)}`;
+                    try {
+                        const result = await downloadAndGunzip(url, binFile, input.asset?.size, deps);
+                        if (result.received > MAX_ASSET_BYTES) {
+                            throw new InstallError(`下载体积超过 ${MAX_ASSET_BYTES} 字节上限`, 'download');
+                        }
+                        sha256 = result.sha256;
+                        break outer;
+                    }
+                    catch (err) {
+                        lastError = err;
+                        rmSync(binFile, { force: true });
+                    }
+                }
+            }
+            if (sha256 === undefined) {
+                throw lastError instanceof InstallError
+                    ? lastError
+                    : new InstallError(`下载失败：${msg(lastError)}`, 'download', msg(lastError));
+            }
+            // digest 校验放在执行候选二进制之前（不可信内容不执行）
+            const expectedDigest = input.asset?.digest;
+            if (expectedDigest && expectedDigest.replace(/^sha256:/, '') !== sha256) {
+                throw new InstallError('sha256 校验失败：下载内容与 release 摘要不符', 'verify');
+            }
+            emit({ phase: 'verify', message: '校验二进制' });
+            await verifyBinary(binFile, marker);
+            emit({ phase: 'replace', message: '替换二进制' });
+            mkdirSync(dirname(archivedBin), { recursive: true });
+            renameSync(binFile, archivedBin);
+        }
+        finally {
+            rmSync(staging, { recursive: true, force: true });
+        }
+    }
+    // 备份 + 原子替换（tmpNext 与目标同目录，rename 原子生效）
+    let backupPath;
+    if (existsSync(binPath)) {
+        backupPath = `${binPath}.bak.${Date.now()}`;
+        copyFileSync(binPath, backupPath);
+    }
+    emit({ phase: 'replace', message: '替换二进制' });
+    try {
+        replaceFile(archivedBin, binPath);
+        chmodSync(binPath, 0o700);
+    }
+    catch (err) {
+        const problems = await restoreBackup(binPath, backupPath, deps.restart);
+        throw new InstallError(`替换二进制失败${rollbackSuffix(problems)}：${msg(err)}`, 'replace', msg(err));
+    }
+    // 重启 + 轮询 /version 直到出现目标标记；失败恢复备份
+    if (deps.restart) {
+        emit({ phase: 'restart', message: '重启服务' });
+        try {
+            await deps.restart();
+        }
+        catch (err) {
+            const problems = await restoreBackup(binPath, backupPath, deps.restart);
+            throw new InstallError(`重启服务失败${rollbackSuffix(problems)}：${msg(err)}`, 'restart', msg(err));
+        }
+    }
+    emit({ phase: 'confirm', message: '确认内核状态' });
+    const hasProbe = Boolean(deps.probeVersion ?? deps.isActive);
+    if (hasProbe) {
+        let probeDetail;
+        let confirmed = false;
+        for (let attempt = 0; attempt < PROBE_ATTEMPTS && !confirmed; attempt += 1) {
+            await sleep(PROBE_INTERVAL_MS);
+            if (deps.isActive) {
+                try {
+                    if (!(await deps.isActive())) {
+                        probeDetail = '服务未处于 active 状态';
+                        continue;
+                    }
+                }
+                catch (err) {
+                    probeDetail = msg(err);
+                    continue;
+                }
+            }
+            if (deps.probeVersion) {
+                try {
+                    const version = await deps.probeVersion();
+                    if (version && version.includes(marker)) {
+                        confirmed = true;
+                    }
+                    else {
+                        probeDetail = version ? `运行版本 ${version} 与目标 ${marker} 不符` : '版本探针无响应';
+                    }
+                }
+                catch (err) {
+                    probeDetail = msg(err);
+                }
+            }
+            else {
+                confirmed = true;
+            }
+        }
+        if (!confirmed) {
+            const problems = await restoreBackup(binPath, backupPath, deps.restart);
+            throw new InstallError(`切换后未确认到内核 ${marker}${rollbackSuffix(problems)}`, 'confirm', probeDetail);
+        }
+    }
+    pruneBackups(binPath, BACKUP_KEEP);
+    return { tag, fromArchive };
+}
+//# sourceMappingURL=installer.js.map

package/dist/kernel/installer.js.map

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

package/dist/kernel/releases.js

@@ -0,0 +1,111 @@
+/**
+ * mihomo release 数据（spec 2026-09-13 settings-kernel §3.4）：
+ * 稳定版列表 + Alpha 滚动 tag（Prerelease-Alpha）；资产按
+ * mihomo-<goos>-<goarch>-<tag>.gz 规则选择（amd64 命中 404 时回退 -compatible）。
+ */
+import { fetchJsonThrough } from './sources.js';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function toRelease(raw) {
+    if (!isRecord(raw) || typeof raw.tag_name !== 'string')
+        return undefined;
+    const assets = Array.isArray(raw.assets)
+        ? raw.assets
+            .map((item) => {
+            if (!isRecord(item) || typeof item.name !== 'string')
+                return undefined;
+            const digest = typeof item.digest === 'string' ? item.digest : undefined;
+            return {
+                name: item.name,
+                size: typeof item.size === 'number' ? item.size : 0,
+                ...(digest ? { digest } : {}),
+            };
+        })
+            .filter((item) => item !== undefined)
+        : [];
+    return {
+        tag: raw.tag_name,
+        ...(typeof raw.published_at === 'string' ? { publishedAt: raw.published_at } : {}),
+        assets,
+    };
+}
+/** 稳定版列表（过滤 prerelease/draft，按 API 返回顺序即新到旧；per_page=12 供过滤后取前 10） */
+export async function listStableReleases(options = {}) {
+    const { data } = await fetchJsonThrough('/releases?per_page=12', options);
+    if (!Array.isArray(data))
+        return [];
+    return data
+        .filter((raw) => isRecord(raw) && raw.prerelease !== true && raw.draft !== true && typeof raw.tag_name === 'string')
+        .map(toRelease)
+        .filter((release) => release !== undefined);
+}
+/** Alpha 滚动 tag 的最新 release（不存在或请求失败由调用方处理） */
+export async function fetchAlphaRelease(options = {}) {
+    const { data } = await fetchJsonThrough('/releases/tags/Prerelease-Alpha', options);
+    const release = toRelease(data);
+    if (!release) {
+        throw new Error('Prerelease-Alpha 响应缺少 tag_name');
+    }
+    return release;
+}
+function goArch(arch) {
+    switch (arch) {
+        case 'x64':
+            return 'amd64';
+        case 'arm':
+            return 'armv7';
+        default:
+            return arch; // arm64 / armv6 / armv7 / riscv64 / loong64 等直接沿用
+    }
+}
+/** 资产命名规则：mihomo-<goos>-<goarch>-<tag>.gz（Windows .zip 不支持，本项目 Linux/macOS only） */
+export function assetNamesFor(tag, platform = process.platform, arch = process.arch) {
+    const goarch = goArch(arch);
+    const names = [`mihomo-${platform}-${goarch}-${tag}.gz`];
+    // amd64 直连性能版对 CPU 指令集有要求，老 CPU 用 compatible 通用版
+    if (goarch === 'amd64') {
+        names.push(`mihomo-${platform}-amd64-compatible-${tag}.gz`);
+    }
+    return names;
+}
+/**
+ * 从 release 资产里选出目标平台的 .gz：按 assetNamesFor 顺序精确匹配。
+ * alpha 版资产名形如 mihomo-linux-amd64-alpha-<hexsha>.gz——tag 不是
+ * Prerelease-Alpha 时才按 tag 匹配；alpha 走 alphaAssetName。
+ */
+export function selectAsset(release, tag, platform = process.platform, arch = process.arch) {
+    for (const name of assetNamesFor(tag, platform, arch)) {
+        const found = release.assets.find((asset) => asset.name === name);
+        if (found)
+            return found;
+    }
+    return undefined;
+}
+/** alpha 资产名：mihomo-<goos>-<goarch>-alpha-<sha>.gz（取 release 资产里第一个匹配 goos/goarch 的） */
+export function selectAlphaAsset(release, platform = process.platform, arch = process.arch) {
+    const goarch = goArch(arch);
+    return release.assets.find((asset) => asset.name.startsWith(`mihomo-${platform}-${goarch}-alpha-`) && asset.name.endsWith('.gz'));
+}
+/** 从 alpha 资产名解析短 sha（-v 输出验证用） */
+export function alphaShaFromAssetName(name) {
+    const match = /-alpha-([0-9a-f]+)\.gz$/.exec(name);
+    return match?.[1];
+}
+/** 语义化版本比较：v1.19.30 > v1.19.9；无法解析时按字符串不等判定 */
+export function isNewerVersion(candidate, current) {
+    const parse = (tag) => {
+        const match = /^v?(\d+)\.(\d+)\.(\d+)/.exec(tag);
+        return match ? [Number(match[1]), Number(match[2]), Number(match[3])] : undefined;
+    };
+    const a = parse(candidate);
+    const b = parse(current);
+    if (!a || !b)
+        return candidate !== current;
+    for (let i = 0; i < 3; i += 1) {
+        if ((a[i] ?? 0) !== (b[i] ?? 0))
+            return (a[i] ?? 0) > (b[i] ?? 0);
+    }
+    return false;
+}
+//# sourceMappingURL=releases.js.map

package/dist/kernel/releases.js.map

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

package/dist/kernel/sources.js

@@ -0,0 +1,98 @@
+export const SOURCES = [
+    { id: 'direct', label: '直连 GitHub', api: true, dl: true, prefix: '' },
+    {
+        id: 'gh-proxy.com',
+        label: 'gh-proxy.com',
+        api: true,
+        dl: true,
+        prefix: 'https://gh-proxy.com/',
+    },
+    {
+        id: 'ghfast.top',
+        label: 'ghfast.top',
+        api: false,
+        dl: true,
+        prefix: 'https://ghfast.top/',
+    },
+];
+export const REPO_API = 'https://api.github.com/repos/MetaCubeX/mihomo';
+export const REPO_DOWNLOAD = 'https://github.com/MetaCubeX/mihomo/releases/download';
+/** JSON 响应上限：releases 列表带巨大 changelog（实测单 release ~156KB），4MB 封顶 */
+export const MAX_JSON_BYTES = 4 * 1024 * 1024;
+/** 资产下载上限 */
+export const MAX_ASSET_BYTES = 128 * 1024 * 1024;
+export class SourceError extends Error {
+    attempts;
+    constructor(message, attempts) {
+        super(message);
+        this.attempts = attempts;
+        this.name = 'SourceError';
+    }
+}
+/**
+ * 按配置解析请求源列表（顺序即回退顺序）：
+ *   auto   → 全部具备该角色能力的源，直连优先；
+ *   direct / 具名源 → 锁定单一源，失败不静默回退（用户意图优先）；
+ *   custom → 仅用户自定义前缀（同时用于 API 与下载）。
+ */
+export function resolveSources(config, role) {
+    const mode = config?.mode ?? 'auto';
+    if (mode === 'auto') {
+        return SOURCES.filter((source) => (role === 'api' ? source.api : source.dl));
+    }
+    if (mode === 'direct') {
+        return SOURCES.filter((source) => source.id === 'direct');
+    }
+    if (mode === 'custom') {
+        const prefix = config?.customPrefix;
+        if (!prefix) {
+            throw new SourceError('自定义下载源前缀未配置', []);
+        }
+        return [{ id: 'custom', label: '自定义', api: true, dl: true, prefix }];
+    }
+    const locked = SOURCES.filter((source) => source.id === mode && (role === 'api' ? source.api : source.dl));
+    if (locked.length === 0) {
+        throw new SourceError(`下载源 ${mode} 不支持${role === 'api' ? 'API 请求' : '资产下载'}`, []);
+    }
+    return locked;
+}
+/** GitHub API 要求显式 UA；Accept 固定到 vnd.github+json */
+function githubHeaders() {
+    return { 'User-Agent': 'mihomo-tui', Accept: 'application/vnd.github+json' };
+}
+/**
+ * 经镜像回退请求 GitHub API：按 resolveSources 顺序尝试，全部失败抛
+ * SourceError（attempts 记录每个源的失败原因）。响应超过 MAX_JSON_BYTES 视为该源失败。
+ */
+export async function fetchJsonThrough(path, options = {}) {
+    const { fetchImpl = fetch, sourceConfig, timeoutMs = 8000 } = options;
+    const sources = resolveSources(sourceConfig, 'api');
+    const attempts = [];
+    for (const source of sources) {
+        try {
+            const response = await fetchImpl(`${source.prefix}${REPO_API}${path}`, {
+                headers: githubHeaders(),
+                signal: AbortSignal.timeout(timeoutMs),
+            });
+            if (!response.ok) {
+                attempts.push(`${source.id}: HTTP ${response.status}`);
+                continue;
+            }
+            const buffer = await response.arrayBuffer();
+            if (buffer.byteLength > MAX_JSON_BYTES) {
+                attempts.push(`${source.id}: 响应超过 ${MAX_JSON_BYTES} 字节上限`);
+                continue;
+            }
+            return { data: JSON.parse(new TextDecoder().decode(buffer)), source: source.id };
+        }
+        catch (err) {
+            attempts.push(`${source.id}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    throw new SourceError(`获取 GitHub 数据失败（已尝试 ${sources.length} 个源）`, attempts);
+}
+/** release 资产下载 URL：tag + 资产名（浏览器下载地址可从 API 响应取，这里按规则拼装） */
+export function assetDownloadUrl(tag, assetName) {
+    return `${REPO_DOWNLOAD}/${tag}/${assetName}`;
+}
+//# sourceMappingURL=sources.js.map

package/dist/kernel/sources.js.map

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