@morndream/mihomo-tui 0.5.0-rc.0

package/dist/cli.js

@@ -0,0 +1,221 @@
+#!/usr/bin/env node
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * commander 入口。无子命令时进入 TUI（检查点 5 接入），带子命令时走 CLI。
+ * 所有子命令共享同一份 ~/.config/mihomo-tui/config.json，并支持 --json。
+ */
+import { Command, CommanderError } from 'commander';
+import { MihomoClient } from './api/client.js';
+import { loadConfig } from './config.js';
+import { runStatus } from './commands/status.js';
+import { runProxyLs, runProxyTest, runProxyUnfix, runProxyUse } from './commands/proxy.js';
+import { runProxyInit, runProxyOff, runProxyOn, runProxyStatus } from './commands/proxyEnv.js';
+import { runProviderCheck, runProviderLs, runProviderUpdate } from './commands/provider.js';
+import { runConnClose, runConnLs, runReload } from './commands/conn.js';
+import { runLogs } from './commands/logs.js';
+import { runRuleProviderLs, runRuleProviderUpdate, runRulesLs, runRulesTest } from './commands/rules.js';
+import { EXIT, exitAfterFlush, reportError } from './commands/output.js';
+import { VERSION } from './version.js';
+const program = new Command();
+program
+    .name('mihomo-tui')
+    .description('mihomo 内核的 CLI + TUI 管理工具（API 驱动，写配置仅限带备份与回滚的事务层）')
+    .version(VERSION, '-V, --version', '显示本工具版本')
+    .option('--api <url>', '覆盖控制口地址，默认取配置文件中的 api')
+    .option('--secret <token>', '覆盖控制口密钥')
+    .showHelpAfterError('（用 --help 查看用法）')
+    // commander 默认对参数错误用退出码 1，本项目约定参数错误为 2
+    .exitOverride((err) => {
+    if (err.code === 'commander.helpDisplayed' || err.code === 'commander.help') {
+        process.exit(EXIT.ok);
+    }
+    if (err.code === 'commander.version')
+        process.exit(EXIT.ok);
+    process.exit(err.exitCode === 0 ? EXIT.ok : EXIT.usage);
+});
+/** 合并配置文件与全局选项，命令行优先 */
+function resolveConfig() {
+    const options = program.opts();
+    const config = loadConfig();
+    if (options.api)
+        config.api = options.api.replace(/\/+$/, '');
+    if (options.secret !== undefined)
+        config.secret = options.secret;
+    return config;
+}
+/** 统一异常出口：把三类失败翻译成人话与退出码 */
+function wrap(fn) {
+    return async (...args) => {
+        try {
+            await fn(...args);
+        }
+        catch (err) {
+            reportError(err);
+        }
+    };
+}
+program
+    .command('status')
+    .description('显示内核版本、模式、端口与 provider 概览')
+    .option('--json', '输出原始 JSON')
+    .action(wrap(async (options) => runStatus(resolveConfig(), options)));
+const proxy = program.command('proxy').description('代理组与节点操作；on/off 切换本 shell 的系统代理环境变量');
+proxy
+    .command('on')
+    .description('开启系统代理：输出 export 代码（eval 执行），把本 shell 流量指向本机 mihomo 混合端口')
+    .option('--json', '输出原始 JSON（含端口与 script）')
+    .option('--port <n>', '显式指定混合端口，默认按「内核 /configs → config.yaml」发现')
+    .option('--lan', 'no_proxy 追加私有网段（旧版 curl/wget 不识别 CIDR，默认关闭）')
+    .option('--all', '同时设置 all_proxy（部分工具按 socks 语义解释，默认不设）')
+    .option('--start', '内核离线时先拉起 systemd 用户服务')
+    .action(wrap(async (options) => runProxyOn(resolveConfig(), options)));
+proxy
+    .command('off')
+    .description('关闭系统代理：输出 unset 代码（eval 执行）；不访问内核，离线可用')
+    .option('--json', '输出原始 JSON')
+    .action(wrap(async (options) => runProxyOff(resolveConfig(), options)));
+proxy
+    .command('status')
+    .description('查看内核 mixed-port 与本 shell 代理环境变量的一致性')
+    .option('--json', '输出原始 JSON')
+    .action(wrap(async (options) => runProxyStatus(resolveConfig(), options)));
+proxy
+    .command('init')
+    .description('输出 shell 集成函数（proxy / proxy-on / proxy-off / proxy-tui）')
+    .option('--json', '输出原始 JSON')
+    .action(wrap(async (options) => runProxyInit(resolveConfig(), options)));
+proxy
+    .command('ls')
+    .argument('[group]', '代理组名；省略则列出所有代理组')
+    .description('列出代理组及当前选中；带组名则列出该组节点与延迟')
+    .option('--json', '输出原始 JSON')
+    .action(wrap(async (group, options) => runProxyLs(resolveConfig(), group, options)));
+proxy
+    .command('use')
+    .argument('<group>', '代理组名')
+    .argument('<name>', '节点名')
+    .description('切换代理组当前选中节点')
+    .option('--json', '输出原始 JSON')
+    .action(wrap(async (group, name, options) => runProxyUse(resolveConfig(), group, name, options)));
+proxy
+    .command('unfix')
+    .argument('<group>', '代理组名')
+    .description('解除 url-test/fallback 组的钉选，恢复自动选路')
+    .option('--json', '输出原始 JSON')
+    .action(wrap(async (group, options) => runProxyUnfix(resolveConfig(), group, options)));
+proxy
+    .command('test')
+    .argument('<group>', '代理组名')
+    .description('整组延迟测试')
+    .option('--json', '输出原始 JSON')
+    .option('-u, --url <url>', '测速地址，默认取组自身的 testUrl')
+    .option('-t, --timeout <ms>', '单节点超时（毫秒）')
+    .action(wrap(async (group, options) => runProxyTest(resolveConfig(), group, options)));
+const provider = program.command('provider').description('订阅（proxy-providers）管理');
+provider
+    .command('ls')
+    .description('列出所有 provider，含节点数、流量、到期与更新时间')
+    .option('--json', '输出原始 JSON')
+    .action(wrap(async (options) => runProviderLs(resolveConfig(), options)));
+provider
+    .command('update')
+    .argument('[name]', 'provider 名称；省略则更新全部')
+    .description('更新订阅（内核重新拉取，不重启进程）')
+    .option('--json', '输出原始 JSON')
+    .action(wrap(async (name, options) => runProviderUpdate(resolveConfig(), name, options)));
+provider
+    .command('check')
+    .argument('<name>', 'provider 名称')
+    .description('触发该 provider 的健康检查')
+    .option('--json', '输出原始 JSON')
+    .action(wrap(async (name, options) => runProviderCheck(resolveConfig(), name, options)));
+const rules = program.command('rules').description('查看当前生效规则并测试命中');
+rules
+    .command('ls')
+    .description('列出当前生效规则（按匹配优先级）')
+    .option('--type <type>', '只看指定类型，如 DOMAIN-SUFFIX')
+    .option('--json', '输出原始 JSON')
+    .action(wrap(async (options) => runRulesLs(resolveConfig(), options)));
+rules
+    .command('test')
+    .argument('<host>', '要测试的域名或 IP')
+    .description('保守本地匹配域名/IP；依赖内核数据时返回无法判定')
+    .option('--json', '输出原始 JSON')
+    .action(wrap(async (host, options) => runRulesTest(resolveConfig(), host, options)));
+const ruleProvider = program
+    .command('rule-provider')
+    .description('规则集（rule-providers）管理');
+ruleProvider
+    .command('ls')
+    .description('列出所有规则集')
+    .option('--json', '输出原始 JSON')
+    .action(wrap(async (options) => runRuleProviderLs(resolveConfig(), options)));
+ruleProvider
+    .command('update')
+    .argument('<name>', '规则集名称')
+    .description('更新指定规则集（内核重新拉取）')
+    .option('--json', '输出 JSON')
+    .action(wrap(async (name, options) => runRuleProviderUpdate(resolveConfig(), name, options)));
+const conn = program.command('conn').description('连接管理');
+conn
+    .command('ls')
+    .description('列出当前活跃连接')
+    .option('--json', '输出原始 JSON')
+    .option('-s, --sort <field>', '排序方式：traffic / time / host', 'traffic')
+    .option('-n, --limit <count>', '最多显示多少条')
+    .action(wrap(async (options) => runConnLs(resolveConfig(), options)));
+conn
+    .command('close')
+    .argument('[id]', '连接 ID，支持 ls 显示的 8 位前缀')
+    .description('关闭指定连接，或用 --all 关闭全部')
+    .option('--all', '关闭全部连接')
+    .option('--json', '输出原始 JSON')
+    .action(wrap(async (id, options) => runConnClose(resolveConfig(), id, options)));
+program
+    .command('logs')
+    .description('实时日志')
+    .option('-l, --level <level>', '日志级别：silent/error/warning/info/debug', 'info')
+    .option('-f, --follow', '持续跟随，Ctrl+C 退出')
+    .option('-n, --lines <count>', '非 follow 模式下收集多少条后退出', '20')
+    .option('--idle <seconds>', '非 follow 模式下多久无新日志则退出', '5')
+    .option('-g, --grep <pattern>', '按正则过滤（不区分大小写）')
+    .option('--json', '每行输出原始 JSON')
+    .action(wrap(async (options) => runLogs(resolveConfig(), options)));
+program
+    .command('reload')
+    .description('让内核热重载配置文件（本程序不写配置，只触发重读）')
+    .option('-p, --path <path>', '配置文件路径，省略则用内核启动时的路径')
+    .option('--json', '输出原始 JSON')
+    .action(wrap(async (options) => runReload(resolveConfig(), options)));
+program.action(async () => {
+    // 无子命令 → 进入 TUI。
+    // 先握一次 REST：内核不可达时给退出码 3，而不是渲染一个空界面让人猜。
+    const config = resolveConfig();
+    const client = new MihomoClient(config);
+    let version;
+    let mode;
+    try {
+        const [v, c] = await Promise.all([client.version(), client.configs()]);
+        version = v.version;
+        mode = c.mode;
+    }
+    catch (err) {
+        reportError(err);
+    }
+    if (!process.stdout.isTTY) {
+        process.stderr.write('TUI 需要交互式终端。管道场景请使用子命令，如 mihomo-tui proxy ls --json\n');
+        process.exit(EXIT.usage);
+    }
+    const { render } = await import('ink');
+    const { App } = await import('./App.js');
+    const instance = render(_jsx(App, { config: config, version: version, mode: mode }), {
+        // 使用备用屏幕：TUI 运行在独立屏幕，退出后恢复到进入前的终端状态（类似 vim/htop）
+        alternateScreen: true,
+        exitOnCtrlC: false,
+    });
+    await instance.waitUntilExit();
+    // mihomo 不回 WebSocket close 帧，句柄不释放 → 必须显式退出（SPEC 3.6）
+    await exitAfterFlush(EXIT.ok);
+});
+program.parseAsync(process.argv).catch(reportError);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/conn.js

@@ -0,0 +1,122 @@
+/** proxy_tui conn ls / close，以及 reload */
+import { MihomoClient } from '../api/client.js';
+import { EXIT, formatBytes, printJson, renderTable, terminalWidth } from './output.js';
+/** 连接持续时长 */
+function formatDuration(start) {
+    const began = Date.parse(start);
+    if (Number.isNaN(began))
+        return '---';
+    const seconds = Math.max(0, Math.floor((Date.now() - began) / 1000));
+    if (seconds < 60)
+        return `${seconds}s`;
+    if (seconds < 3600)
+        return `${Math.floor(seconds / 60)}m${seconds % 60}s`;
+    return `${Math.floor(seconds / 3600)}h${Math.floor((seconds % 3600) / 60)}m`;
+}
+/** 展示用主机名：优先 host，回退嗅探结果与目标 IP */
+function describeHost(conn) {
+    const { host, sniffHost, destinationIP, destinationPort } = conn.metadata;
+    const name = host || sniffHost || destinationIP || '?';
+    return destinationPort ? `${name}:${destinationPort}` : name;
+}
+export async function runConnLs(config, options) {
+    const client = new MihomoClient(config);
+    const data = await client.connections();
+    // 无连接时内核返回 null 而非 []（实测，见 SPEC 3.5）
+    const conns = data.connections ?? [];
+    const sort = options.sort ?? 'traffic';
+    if (!['traffic', 'time', 'host'].includes(sort)) {
+        process.stderr.write('错误：--sort 只支持 traffic / time / host\n');
+        process.exit(EXIT.usage);
+    }
+    const sorted = conns.slice().sort((a, b) => {
+        if (sort === 'time')
+            return Date.parse(a.start) - Date.parse(b.start);
+        if (sort === 'host')
+            return describeHost(a).localeCompare(describeHost(b));
+        return b.download + b.upload - (a.download + a.upload);
+    });
+    const limit = options.limit ? Number(options.limit) : undefined;
+    if (limit !== undefined && (!Number.isFinite(limit) || limit <= 0)) {
+        process.stderr.write('错误：--limit 需为正整数\n');
+        process.exit(EXIT.usage);
+    }
+    const shown = limit === undefined ? sorted : sorted.slice(0, limit);
+    if (options.json) {
+        printJson({
+            uploadTotal: data.uploadTotal,
+            downloadTotal: data.downloadTotal,
+            memory: data.memory,
+            count: conns.length,
+            connections: shown,
+        });
+        return;
+    }
+    if (shown.length === 0) {
+        process.stdout.write(`当前无活跃连接。累计 ↑${formatBytes(data.uploadTotal)} ↓${formatBytes(data.downloadTotal)}\n`);
+        return;
+    }
+    // 窄终端下省略代理链列，避免横向截断导致乱码
+    const narrow = terminalWidth() < 100;
+    const header = narrow
+        ? ['ID', 'HOST', 'UP', 'DOWN', 'TIME']
+        : ['ID', 'HOST', 'RULE', 'CHAIN', 'UP', 'DOWN', 'TIME'];
+    const rows = shown.map((conn) => {
+        const id = conn.id.slice(0, 8);
+        const base = [id, describeHost(conn)];
+        const tail = [formatBytes(conn.upload), formatBytes(conn.download), formatDuration(conn.start)];
+        if (narrow)
+            return [...base, ...tail];
+        const rule = conn.rulePayload ? `${conn.rule}(${conn.rulePayload})` : conn.rule;
+        // chains 是从出口到入口排列，反转后读起来才是流量实际经过的顺序
+        return [...base, rule, conn.chains.slice().reverse().join(' → '), ...tail];
+    });
+    process.stdout.write(`${renderTable(header, rows)}\n`);
+    process.stdout.write(`\n共 ${conns.length} 条连接${shown.length < conns.length ? `（显示前 ${shown.length} 条）` : ''}，累计 ↑${formatBytes(data.uploadTotal)} ↓${formatBytes(data.downloadTotal)}，内核内存 ${formatBytes(data.memory)}\n`);
+}
+export async function runConnClose(config, id, options) {
+    const client = new MihomoClient(config);
+    if (options.all) {
+        const before = await client.connections();
+        const count = before.connections?.length ?? 0;
+        await client.closeAllConnections();
+        if (options.json)
+            printJson({ closed: 'all', count });
+        else
+            process.stdout.write(`已关闭全部连接（${count} 条）\n`);
+        return;
+    }
+    if (!id) {
+        process.stderr.write('用法：conn close <id> 或 conn close --all\n');
+        process.exit(EXIT.usage);
+    }
+    // 支持用 ls 显示的 8 位短 ID
+    const data = await client.connections();
+    const conns = data.connections ?? [];
+    const matched = conns.filter((conn) => conn.id === id || conn.id.startsWith(id));
+    if (matched.length === 0) {
+        process.stderr.write(`错误：未找到连接：${id}\n`);
+        process.exit(EXIT.error);
+    }
+    if (matched.length > 1) {
+        process.stderr.write(`错误：ID 前缀 ${id} 匹配到 ${matched.length} 条连接，请给出更长的 ID\n`);
+        process.exit(EXIT.usage);
+    }
+    const target = matched[0];
+    await client.closeConnection(target.id);
+    if (options.json)
+        printJson({ closed: target.id, host: describeHost(target) });
+    else
+        process.stdout.write(`已关闭连接 ${target.id.slice(0, 8)}（${describeHost(target)}）\n`);
+}
+export async function runReload(config, options) {
+    const client = new MihomoClient(config);
+    // 本程序不写配置文件，只让内核自己重新读盘（PUT /configs?force=false，实测 204 且 PID 不变）
+    await client.reload(options.path ?? '');
+    const version = await client.version();
+    if (options.json)
+        printJson({ reloaded: true, version: version.version });
+    else
+        process.stdout.write(`配置已热重载，内核 ${version.version} 未重启\n`);
+}
+//# sourceMappingURL=conn.js.map

package/dist/commands/conn.js.map

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

package/dist/commands/logs.js

@@ -0,0 +1,99 @@
+/** proxy_tui logs —— WebSocket 实时日志 */
+import { MihomoClient } from '../api/client.js';
+import { RingBuffer, Stream } from '../api/stream.js';
+import { EXIT, exitAfterFlush } from './output.js';
+const LEVELS = ['silent', 'error', 'warning', 'info', 'debug'];
+export async function runLogs(config, options) {
+    const level = (options.level ?? 'info');
+    if (!LEVELS.includes(level)) {
+        process.stderr.write(`错误：--level 只支持 ${LEVELS.join(' / ')}\n`);
+        process.exit(EXIT.usage);
+    }
+    let pattern;
+    if (options.grep) {
+        try {
+            pattern = new RegExp(options.grep, 'i');
+        }
+        catch (err) {
+            process.stderr.write(`错误：--grep 正则无效：${err instanceof Error ? err.message : err}\n`);
+            process.exit(EXIT.usage);
+        }
+    }
+    const wanted = options.lines ? Number(options.lines) : 20;
+    if (!Number.isFinite(wanted) || wanted <= 0) {
+        process.stderr.write('错误：--lines 需为正整数\n');
+        process.exit(EXIT.usage);
+    }
+    const idleSeconds = options.idle ? Number(options.idle) : 5;
+    if (!Number.isFinite(idleSeconds) || idleSeconds <= 0) {
+        process.stderr.write('错误：--idle 需为正数（秒）\n');
+        process.exit(EXIT.usage);
+    }
+    const client = new MihomoClient(config);
+    // 先握一次 REST，内核不可达时直接给退出码 3，而不是让 WebSocket 静默重连
+    await client.version();
+    // 环形缓冲上限 1000 行，防止 -f 长跑内存膨胀（SPEC 5.3）
+    const buffer = new RingBuffer(1000);
+    let count = 0;
+    await new Promise((resolve) => {
+        let idleTimer;
+        let stream;
+        const finish = () => {
+            if (idleTimer)
+                clearTimeout(idleTimer);
+            idleTimer = undefined;
+            stream?.close();
+            resolve();
+        };
+        /**
+         * 空闲超时：内核闲着不产日志时，非 follow 模式必须能自己退出，
+         * 否则 `logs -n 5` 会永久挂住（实测过）。
+         */
+        const resetIdle = () => {
+            if (options.follow)
+                return;
+            if (idleTimer)
+                clearTimeout(idleTimer);
+            idleTimer = setTimeout(() => {
+                if (count === 0) {
+                    process.stderr.write(`[${idleSeconds}s 内无日志输出，已退出]\n`);
+                }
+                finish();
+            }, idleSeconds * 1000);
+        };
+        stream = new Stream(client.logsUrl(level), {
+            onMessage: (frame) => {
+                if (typeof frame?.payload !== 'string')
+                    return;
+                if (pattern && !pattern.test(frame.payload)) {
+                    // 被过滤掉的帧也算「有动静」，避免刷屏时被空闲超时误杀
+                    resetIdle();
+                    return;
+                }
+                buffer.push(frame);
+                count += 1;
+                process.stdout.write(options.json
+                    ? `${JSON.stringify(frame)}\n`
+                    : `${frame.type.padEnd(7)} ${frame.payload}\n`);
+                if (!options.follow && count >= wanted) {
+                    finish();
+                    return;
+                }
+                resetIdle();
+            },
+            onState: (state, detail) => {
+                // 状态信息走 stderr，stdout 保持纯日志以便管道消费
+                if (state === 'open')
+                    resetIdle();
+                if (state === 'reconnecting') {
+                    process.stderr.write(`[连接断开，正在重连${detail ? `：${detail}` : ''}]\n`);
+                }
+            },
+        });
+        process.once('SIGINT', finish);
+        process.once('SIGTERM', finish);
+    });
+    // mihomo 不回 WebSocket close 帧，句柄不会释放，必须显式退出（见 exitAfterFlush 注释）
+    await exitAfterFlush(EXIT.ok);
+}
+//# sourceMappingURL=logs.js.map

package/dist/commands/logs.js.map

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

package/dist/commands/output.js

@@ -0,0 +1,177 @@
+/** CLI 输出与错误处理的公共部分：统一表格排版、脱敏、退出码。 */
+import { ApiBusinessError, HttpStatusError, KernelUnreachableError, } from '../api/client.js';
+import { CONFIG_PATH } from '../config.js';
+import { InvalidTargetError } from '../rules/matcher.js';
+/** 退出码约定：0 成功，1 通用错误，2 参数错误，3 内核不可达 */
+export const EXIT = { ok: 0, error: 1, usage: 2, unreachable: 3 };
+export function printJson(value) {
+    process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+/**
+ * 订阅 URL 含 token，任何展示都必须脱敏。
+ * 实现随 v0.2.0 迁至 config/subscriptions.ts（清单模块是 token 的属主），
+ * 这里保留导出以维持既有调用方与测试的导入路径。
+ */
+export { redactUrl } from '../config/subscriptions.js';
+/**
+ * 终端宽度。
+ * 非 TTY（输出被管道或重定向）时不做窄屏降级 —— 那种场景是给 grep/jq 消费的，
+ * 信息完整比排版好看更重要，故返回 Infinity。
+ */
+export function terminalWidth() {
+    if (!process.stdout.isTTY)
+        return Number.POSITIVE_INFINITY;
+    return process.stdout.columns && process.stdout.columns > 0 ? process.stdout.columns : 80;
+}
+/** 中日韩字符与 emoji 占两列，等宽终端下必须按显示宽度对齐而非按码点数 */
+export function displayWidth(text) {
+    let width = 0;
+    for (const char of text) {
+        const code = char.codePointAt(0) ?? 0;
+        if (code === 0xfe0f || (code >= 0x1f1e6 && code <= 0x1f1ff)) {
+            // 变体选择符不占宽。区域指示符（国旗的一半）按 2 计：终端对成对 RI
+            // 的渲染宽度有分歧（多数按组合字符 2 列，pyte 等按两个宽字符 4 列）。
+            // 预算取最坏情况——宁可行尾多留白，也不能让整行超宽折行撑爆面板。
+            width += code === 0xfe0f ? 0 : 2;
+            continue;
+        }
+        width += isWide(code) ? 2 : 1;
+    }
+    return width;
+}
+function isWide(code) {
+    return ((code >= 0x1100 && code <= 0x115f) ||
+        (code >= 0x2e80 && code <= 0xa4cf) ||
+        (code >= 0xac00 && code <= 0xd7a3) ||
+        (code >= 0xf900 && code <= 0xfaff) ||
+        (code >= 0xfe30 && code <= 0xfe6f) ||
+        (code >= 0xff00 && code <= 0xff60) ||
+        (code >= 0xffe0 && code <= 0xffe6) ||
+        (code >= 0x1f300 && code <= 0x1f64f) ||
+        (code >= 0x1f900 && code <= 0x1f9ff) ||
+        (code >= 0x20000 && code <= 0x3fffd));
+}
+export function padDisplay(text, width) {
+    const pad = width - displayWidth(text);
+    return pad > 0 ? text + ' '.repeat(pad) : text;
+}
+/**
+ * 按**显示宽度**截断，超出时以 … 结尾。
+ * 不能用 slice —— 那是按码点数切，中文和 emoji 会把列宽撑破导致错位。
+ */
+export function truncateDisplay(text, max) {
+    if (max <= 0)
+        return '';
+    if (displayWidth(text) <= max)
+        return text;
+    let out = '';
+    for (const char of text) {
+        if (displayWidth(out + char) > max - 1)
+            break;
+        out += char;
+    }
+    return `${out}…`;
+}
+/** 先按显示宽度截断再补齐，保证该列恒定占 width 列 */
+export function fitDisplay(text, width) {
+    return padDisplay(truncateDisplay(text, width), width);
+}
+/** 按显示宽度输出表格，最后一列不补空格，便于 grep */
+export function renderTable(header, rows) {
+    const widths = header.map((cell, index) => Math.max(displayWidth(cell), ...rows.map((row) => displayWidth(row[index] ?? ''))));
+    const lines = [header, ...rows].map((row) => row
+        .map((cell, index) => (index === row.length - 1 ? cell : padDisplay(cell, widths[index] ?? 0)))
+        .join('  ')
+        .trimEnd());
+    return lines.join('\n');
+}
+export function formatBytes(bytes) {
+    if (!Number.isFinite(bytes) || bytes < 0)
+        return '---';
+    const units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB'];
+    let value = bytes;
+    let unit = 0;
+    while (value >= 1024 && unit < units.length - 1) {
+        value /= 1024;
+        unit += 1;
+    }
+    return `${value >= 100 || unit === 0 ? Math.round(value) : value.toFixed(2)} ${units[unit]}`;
+}
+/** 相对时间，用于 provider 的 UPDATED 列 */
+export function formatRelativeTime(iso) {
+    if (!iso)
+        return '---';
+    const time = Date.parse(iso);
+    if (Number.isNaN(time))
+        return '---';
+    const seconds = Math.floor((Date.now() - time) / 1000);
+    if (seconds < 0)
+        return '刚刚';
+    if (seconds < 60)
+        return `${seconds}s 前`;
+    if (seconds < 3600)
+        return `${Math.floor(seconds / 60)}m 前`;
+    if (seconds < 86400)
+        return `${Math.floor(seconds / 3600)}h 前`;
+    return `${Math.floor(seconds / 86400)}d 前`;
+}
+/**
+ * 冲净 stdout/stderr 后退出。
+ *
+ * 为什么需要：mihomo 不回应 WebSocket 的 close 帧（实测 v1.19.24），
+ * undici 的关闭握手永不完成，TCP 句柄一直挂在事件循环上，进程不会自然退出。
+ * 凡是用过 Stream 的命令都必须走这里显式退出。
+ *
+ * 手段说明：Node 官方没有 flush API，「写空串等回调」依赖流按 FIFO
+ * 处理写队列的实现行为（回调触发即代表其前的数据已处理完）；该行为
+ * 无文档背书，故回调若因流异常永不触发，超时护栏保证进程仍能退出。
+ */
+const FLUSH_TIMEOUT_MS = 1000;
+export async function exitAfterFlush(code) {
+    for (const stream of [process.stdout, process.stderr]) {
+        if (stream.writableLength > 0) {
+            await new Promise((resolve) => {
+                const timer = setTimeout(resolve, FLUSH_TIMEOUT_MS);
+                stream.write('', () => {
+                    clearTimeout(timer);
+                    resolve();
+                });
+            });
+        }
+    }
+    process.exit(code);
+}
+/**
+ * 把异常翻译成一行人话 + 退出码。
+ * 业务错误（如延迟测试失败）由调用方自行处理，不该走到这里。
+ */
+export function reportError(err) {
+    if (err instanceof InvalidTargetError) {
+        process.stderr.write(`错误：${err.message}\n`);
+        process.exit(EXIT.usage);
+    }
+    if (err instanceof KernelUnreachableError) {
+        process.stderr.write(`错误：${err.message}\n`);
+        process.stderr.write('内核可能未运行，请排查：systemctl --user status mihomo\n');
+        process.exit(EXIT.unreachable);
+    }
+    if (err instanceof HttpStatusError) {
+        if (err.status === 401) {
+            process.stderr.write(`错误：控制口鉴权失败（HTTP 401），请检查 secret 配置：${CONFIG_PATH}\n`);
+            process.exit(EXIT.error);
+        }
+        if (err.status === 404) {
+            process.stderr.write(`错误：目标不存在（HTTP 404）：${decodeURIComponent(err.path)}\n`);
+            process.exit(EXIT.error);
+        }
+        process.stderr.write(`错误：${err.message}\n`);
+        process.exit(EXIT.error);
+    }
+    if (err instanceof ApiBusinessError) {
+        process.stderr.write(`错误：${err.message}\n`);
+        process.exit(EXIT.error);
+    }
+    process.stderr.write(`错误：${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(EXIT.error);
+}
+//# sourceMappingURL=output.js.map