lark-remote 0.5.19 → 0.5.21

package/dist/card/tool-render.d.ts

@@ -17,7 +17,7 @@ export { displayWidth, truncateMiddleToDisplayWidth, truncateToDisplayWidth, } f
  * 手机（~390px 内容宽）上折叠面板的标题只有**一行**可用：减去图标与内边距约
  * 320px，按 ~7.5px/半角算 ≈ 42 个半角宽度（iPhone SE 更窄，超出时按 `·`/空格
  * 折行仍可读，但不能整段换行）。超过就折行，断点常常落在 URL 或命令
- * 中间（2026-10-19 截图反馈）。完整参数在展开后的正文里，标题只负责"哪个工具、
+ * 中间。完整参数在展开后的正文里，标题只负责"哪个工具、
  * 动了什么"，并带上 `HH:mm` 时间戳（一起计入预算）。
  */
 export declare const HEADER_DISPLAY_MAX = 42;

package/dist/card/tool-render.js

@@ -20,7 +20,7 @@ export { displayWidth, truncateMiddleToDisplayWidth, truncateToDisplayWidth, } f
  * 手机（~390px 内容宽）上折叠面板的标题只有**一行**可用：减去图标与内边距约
  * 320px，按 ~7.5px/半角算 ≈ 42 个半角宽度（iPhone SE 更窄，超出时按 `·`/空格
  * 折行仍可读，但不能整段换行）。超过就折行，断点常常落在 URL 或命令
- * 中间（2026-10-19 截图反馈）。完整参数在展开后的正文里，标题只负责"哪个工具、
+ * 中间。完整参数在展开后的正文里，标题只负责"哪个工具、
  * 动了什么"，并带上 `HH:mm` 时间戳（一起计入预算）。
  */
 export const HEADER_DISPLAY_MAX = 42;
@@ -98,11 +98,23 @@ export function toolBodyMd(tool, opts = {}) {
     // 同上：走 truncate 保证切点不落在代理对中间（末尾 '…' 由 truncate 附加以对齐预算）。
     return `${truncate(body, BODY_TOTAL_MAX)}\n\n_（body 已截断，完整内容查日志）_`;
 }
-// --- Named render bodies (shared by tool-name cases and toolHint branches) ---
-function renderBashInput(str) {
-    const cmd = str('command');
-    return cmd ? `**Command**\n\`\`\`bash\n${truncate(cmd, BODY_FIELD_MAX)}\n\`\`\`` : '';
+function renderFieldInput(str, spec) {
+    const value = str(spec.key);
+    if (!value)
+        return '';
+    const shown = spec.truncate ? truncate(value, BODY_FIELD_MAX) : value;
+    return spec.fence
+        ? `**${spec.label}**\n\`\`\`${spec.fence}\n${shown}\n\`\`\``
+        : `**${spec.label}** \`${shown}\``;
 }
+const BASH_FIELD = {
+    key: 'command',
+    label: 'Command',
+    truncate: true,
+    fence: 'bash',
+};
+const GLOB_FIELD = { key: 'pattern', label: 'Pattern', truncate: true };
+const LS_FIELD = { key: 'path', label: 'Path', truncate: false };
 function renderFileInput(str) {
     const fp = str('file_path') || str('path');
     return fp ? `**File** \`${fp}\`` : '';
@@ -115,14 +127,6 @@ function renderGrepInput(str) {
         lines.push(`**Path** \`${str('path')}\``);
     return lines.join('\n');
 }
-function renderGlobInput(str) {
-    const p = str('pattern');
-    return p ? `**Pattern** \`${truncate(p, BODY_FIELD_MAX)}\`` : '';
-}
-function renderLsInput(str) {
-    const p = str('path');
-    return p ? `**Path** \`${p}\`` : '';
-}
 function renderWebFetchInput(str) {
     return str('url') ? `**URL** ${str('url')}` : '';
 }
@@ -149,7 +153,7 @@ function renderInput(tool) {
     // 完全一致。hint 分支与 name case 共用同一渲染函数，无复制粘贴。
     switch (tool.toolHint) {
         case 'shell':
-            return renderBashInput(str);
+            return renderFieldInput(str, BASH_FIELD);
         case 'file':
         case 'patch':
             return renderFileInput(str);
@@ -162,15 +166,15 @@ function renderInput(tool) {
     }
     switch (toolKindOf(tool.name)) {
         case 'shell':
-            return renderBashInput(str);
+            return renderFieldInput(str, BASH_FIELD);
         case 'file':
             return renderFileInput(str);
         case 'grep':
             return renderGrepInput(str);
         case 'glob':
-            return renderGlobInput(str);
+            return renderFieldInput(str, GLOB_FIELD);
         case 'ls':
-            return renderLsInput(str);
+            return renderFieldInput(str, LS_FIELD);
         case 'webfetch':
             return renderWebFetchInput(str);
         case 'websearch':

package/dist/card/usage-format.d.ts

@@ -9,17 +9,24 @@ import type { UsageSnapshot } from '../session-contract.js';
 /** `formatUsageStats` 只读这几项：会话/进度卡片上的紧凑用量行。 */
 export type SessionDisplayUsage = Pick<UsageSnapshot, 'contextLength' | 'contextLimit' | 'compactCount' | 'cacheReadTokens' | 'cacheCreationTokens'>;
 /**
- * Format usage stats (context length, compact count, cache tokens) into a display string.
- * Each stat on its own line with blank lines between sections.
- * @param usage - Usage stats object
- * @param options - Optional display options (showResult adds result line)
+ * Format number to human-readable unit string.
+ * - >= 999_500: M with at most one decimal (e.g., 999_600 → 1M, 1200000 → 1.2M,
+ *   25000000 → 25M)
+ * - >= 1K: rounded to nearest integer K (e.g., 1500 → 2K, 120000 → 120K)
+ * - < 1K: as-is (e.g., 500 → "500")
+ *
+ * 千位边界取 M 档：999_500 起按 K 四舍五入会得到 "1000K"，直接按 M 档展示。
+ * 此前 run-renderer 另有一份 formatTokens 只在这边带此边界护栏，两处已收敛
+ * 到本函数（run-renderer 的状态行 `📊 N` 也走这里）。
  */
-export declare function formatUsageStats(usage?: UsageSnapshot & {
+export declare function formatTokenK(n: number): string;
+interface UsageStatsInput extends UsageSnapshot {
     /** 实际生效模型（system.init 携带）。非空字符串才显示。 */
     model?: string;
     /** 本次 run 花费（USD）。存在才显示。 */
     costUsd?: number;
-}, options?: {
+}
+interface UsageDisplayOptions {
     showResult?: boolean;
     result?: string;
     /**
@@ -27,4 +34,12 @@ export declare function formatUsageStats(usage?: UsageSnapshot & {
      * 本轮 turn 结束不等于任务结束。
      */
     completedLabel?: string;
-}): string;
+}
+/**
+ * Format usage stats (context length, compact count, cache tokens) into a display string.
+ * Each stat on its own line with blank lines between sections.
+ * @param usage - Usage stats object
+ * @param options - Optional display options (showResult adds result line)
+ */
+export declare function formatUsageStats(usage?: UsageStatsInput, options?: UsageDisplayOptions): string;
+export {};

package/dist/card/usage-format.js

@@ -7,12 +7,17 @@
  */
 /**
  * Format number to human-readable unit string.
- * - >= 1M: one decimal, M suffix (e.g., 1200000 → 1.2M, 25000000 → 25M)
+ * - >= 999_500: M with at most one decimal (e.g., 999_600 → 1M, 1200000 → 1.2M,
+ *   25000000 → 25M)
  * - >= 1K: rounded to nearest integer K (e.g., 1500 → 2K, 120000 → 120K)
  * - < 1K: as-is (e.g., 500 → "500")
+ *
+ * 千位边界取 M 档：999_500 起按 K 四舍五入会得到 "1000K"，直接按 M 档展示。
+ * 此前 run-renderer 另有一份 formatTokens 只在这边带此边界护栏，两处已收敛
+ * 到本函数（run-renderer 的状态行 `📊 N` 也走这里）。
  */
-function formatTokenK(n) {
-    if (n >= 1_000_000) {
+export function formatTokenK(n) {
+    if (n >= 999_500) {
         const m = n / 1_000_000;
         const rounded = Math.round(m * 10) / 10;
         // Drop unnecessary ".0" for whole numbers (2.0M → 2M)
@@ -24,122 +29,136 @@ function formatTokenK(n) {
     }
     return n.toString();
 }
+function cumulativeField(value) {
+    return value !== undefined ? ` · 累计 ${formatTokenK(value)}` : '';
+}
+function cumulativeCachePercent(usage) {
+    const cumInput = usage?.cumulativeInputTokens;
+    const cumCacheRead = usage?.cumulativeCacheReadTokens;
+    return cumInput !== undefined && cumCacheRead !== undefined && cumInput + cumCacheRead > 0
+        ? Math.round((cumCacheRead / (cumInput + cumCacheRead)) * 100)
+        : null;
+}
+function cumulativeParts(usage) {
+    const cumCacheRead = usage?.cumulativeCacheReadTokens;
+    const percent = cumulativeCachePercent(usage);
+    const cacheRead = cumCacheRead !== undefined
+        ? cumulativeField(cumCacheRead) + (percent !== null ? ` (${percent}%)` : '')
+        : '';
+    return {
+        input: cumulativeField(usage?.cumulativeInputTokens),
+        output: cumulativeField(usage?.cumulativeOutputTokens),
+        cacheRead,
+        cacheCreate: cumulativeField(usage?.cumulativeCacheCreationTokens),
+    };
+}
 /**
- * Format usage stats (context length, compact count, cache tokens) into a display string.
- * Each stat on its own line with blank lines between sections.
- * @param usage - Usage stats object
- * @param options - Optional display options (showResult adds result line)
+ * 一致性护栏：本 run ≤ 累计 是硬不变量（累计 = 所有 run 之和，必 ≥ 本 run）。
+ * 违反说明来源 scope 混用（如 DeepSeek live result usage 是累积/超大 scope，
+ * 大于 jsonl 去重聚合的 session 累计）。只标记不修正——数字保持原样便于排查，
+ * 由数据源修复。两侧都有值时校验（避免旧数据/缺失字段误报）。
+ * 两个分支（real input/output / 10% 估计）共用，保证"本 run > 累计"在任意
+ * 路径都显式暴露。
  */
-export function formatUsageStats(usage, options) {
+function cumulativeTotalSuffix(usage, totalTokens) {
+    const cum = usage?.cumulativeTotalTokens;
+    if (cum === undefined)
+        return '';
+    const guard = totalTokens > cum ? ' · ⚠️ 累计异常' : '';
+    return cumulativeField(cum) + guard;
+}
+function contextLine(length, usage) {
+    const ctxLimit = usage.contextLimit;
+    const ctxPercent = ctxLimit !== undefined && ctxLimit > 0 ? ` (${Math.round((length / ctxLimit) * 100)}%)` : '';
+    const preCompact = usage.compactPreContextLength !== undefined
+        ? `（压缩前 ${formatTokenK(usage.compactPreContextLength)}）`
+        : '';
+    return `Context - ${formatTokenK(length)}${ctxPercent}${preCompact}`;
+}
+function headerLines(usage, options) {
     const lines = [];
-    // 1. Success 状态（通用格式，无具体结果值）
     lines.push(options?.completedLabel ?? '✅ 已完成');
-    // 1.4. 实际生效模型（非空字符串才显示）
-    if (usage?.model) {
+    if (usage?.model)
         lines.push(`Model - ${usage.model}`);
-    }
-    // 1.5. 可选的结果行（showResult 为 true 时显示）
-    if (options?.showResult && options?.result) {
+    if (options?.showResult && options?.result)
         lines.push(`结果 - ${options.result}`);
-    }
-    // 2. Context 长度（compact 卡同时展示压缩前水位）
-    if (usage?.contextLength !== undefined) {
-        const ctxLimit = usage.contextLimit;
-        const ctxPercent = ctxLimit !== undefined && ctxLimit > 0
-            ? ` (${Math.round((usage.contextLength / ctxLimit) * 100)}%)`
-            : '';
-        const preCompact = usage.compactPreContextLength !== undefined
-            ? `（压缩前 ${formatTokenK(usage.compactPreContextLength)}）`
-            : '';
-        lines.push(`Context - ${formatTokenK(usage.contextLength)}${ctxPercent}${preCompact}`);
-    }
-    // 3. Compact 次数
-    if (usage?.compactCount) {
+    if (usage?.contextLength !== undefined)
+        lines.push(contextLine(usage.contextLength, usage));
+    if (usage?.compactCount)
         lines.push(`Compact - ${usage.compactCount}次`);
+    return lines;
+}
+/** 命中率分母由调用方给：real 分支是 input+cacheRead，estimate 分支是 totalInput。 */
+function makeTokenLines(input, output, cacheRead, cacheCreation, totalTokens, cachePercent, parts, usage) {
+    const lines = [
+        `Input token - ${formatTokenK(input)}${parts.input}`,
+        `Output token - ${formatTokenK(output)}${parts.output}`,
+    ];
+    if (cacheCreation > 0) {
+        lines.push(`Cache create - ${formatTokenK(cacheCreation)}${parts.cacheCreate}`);
     }
-    // 4-7. Token 统计
+    lines.push(`Cached token - ${formatTokenK(cacheRead)} (${cachePercent}%)${parts.cacheRead}`);
+    lines.push(`Total token - ${formatTokenK(totalTokens)}${cumulativeTotalSuffix(usage, totalTokens)}`);
+    return lines;
+}
+function realTokenLines(usage, realInput, realOutput, parts) {
+    // Unified ccusage-aligned formula:
+    //   total = max(total_tokens, input + output + cacheRead + cacheCreation)
+    //   cache% = cacheRead / (input + cacheRead)
+    // cacheRead/cacheCreation are never double-counted; total_tokens folds in any
+    // extra (e.g. opencode reasoning, which is separate from output) via max().
+    const cacheRead = usage.cacheReadTokens ?? 0;
+    const cacheCreation = usage.cacheCreationTokens ?? 0;
+    const sumParts = realInput + realOutput + cacheRead + cacheCreation;
+    const totalTokens = usage.totalTokens != null ? Math.max(usage.totalTokens, sumParts) : sumParts;
+    const promptTokens = realInput + cacheRead;
+    const cachePercent = promptTokens > 0 ? Math.round((cacheRead / promptTokens) * 100) : 0;
+    return makeTokenLines(realInput, realOutput, cacheRead, cacheCreation, totalTokens, cachePercent, parts, usage);
+}
+function estimateTokenLines(usage, parts) {
+    // Estimate path: when real input/output are absent,
+    // fall back to the 10% estimate based on contextLength.
     const cacheRead = usage?.cacheReadTokens ?? 0;
     const cacheCreation = usage?.cacheCreationTokens ?? 0;
+    const inputRef = usage?.contextLength ?? cacheRead;
+    if (inputRef <= 0 && cacheRead <= 0 && cacheCreation <= 0)
+        return [];
+    const totalInput = inputRef + cacheRead;
+    const outputEst = inputRef > 0 ? Math.round(inputRef * 0.1) : 0;
+    const cachePercent = totalInput > 0 ? Math.round((cacheRead / totalInput) * 100) : 0;
+    const totalTokens = totalInput + outputEst + cacheCreation;
+    return makeTokenLines(totalInput, outputEst, cacheRead, cacheCreation, totalTokens, cachePercent, parts, usage);
+}
+function tokenLines(usage, parts) {
     const realInput = usage?.inputTokens;
     const realOutput = usage?.outputTokens;
-    // Cumulative suffix (session-wide totals), appended to Input/Output lines.
-    const cumInputSuffix = usage?.cumulativeInputTokens !== undefined
-        ? ` · 累计 ${formatTokenK(usage.cumulativeInputTokens)}`
-        : '';
-    const cumOutputSuffix = usage?.cumulativeOutputTokens !== undefined
-        ? ` · 累计 ${formatTokenK(usage.cumulativeOutputTokens)}`
-        : '';
-    const cumTotalSuffix = usage?.cumulativeTotalTokens !== undefined
-        ? ` · 累计 ${formatTokenK(usage.cumulativeTotalTokens)}`
-        : '';
-    // 一致性护栏：本 run ≤ 累计 是硬不变量（累计 = 所有 run 之和，必 ≥ 本 run）。
-    // 违反说明来源 scope 混用（如 DeepSeek live result usage 是累积/超大 scope，
-    // 大于 jsonl 去重聚合的 session 累计）。只标记不修正——数字保持原样便于排查，
-    // 由数据源修复。两侧都有值时校验（避免旧数据/缺失字段误报）。
-    // 两个分支（real input/output / 10% 估计）共用，保证"本 run > 累计"在任意
-    // 路径都显式暴露。
-    const withCumGuard = (totalTokens) => cumTotalSuffix +
-        (usage?.cumulativeTotalTokens !== undefined && totalTokens > usage.cumulativeTotalTokens
-            ? ' · ⚠️ 累计异常'
-            : '');
-    // 计算累计 cache 命中率
-    const cumInput = usage?.cumulativeInputTokens;
-    const cumCacheRead = usage?.cumulativeCacheReadTokens;
-    const cumCachePercent = cumInput !== undefined && cumCacheRead !== undefined && cumInput + cumCacheRead > 0
-        ? Math.round((cumCacheRead / (cumInput + cumCacheRead)) * 100)
-        : null;
-    // 构建累计 suffix
-    const cumCacheReadSuffix = cumCacheRead !== undefined
-        ? ` · 累计 ${formatTokenK(cumCacheRead)}` +
-            (cumCachePercent !== null ? ` (${cumCachePercent}%)` : '')
-        : '';
-    const cumCacheCreateSuffix = usage?.cumulativeCacheCreationTokens !== undefined
-        ? ` · 累计 ${formatTokenK(usage.cumulativeCacheCreationTokens)}`
-        : '';
     if (realInput !== undefined && realOutput !== undefined) {
-        // Unified ccusage-aligned formula:
-        //   total = max(total_tokens, input + output + cacheRead + cacheCreation)
-        //   cache% = cacheRead / (input + cacheRead)
-        // cacheRead/cacheCreation are never double-counted; total_tokens folds in any
-        // extra (e.g. opencode reasoning, which is separate from output) via max().
-        const promptTokens = realInput + cacheRead;
-        const cachePercent = promptTokens > 0 ? Math.round((cacheRead / promptTokens) * 100) : 0;
-        const sumParts = realInput + realOutput + cacheRead + cacheCreation;
-        const totalTokens = usage?.totalTokens != null ? Math.max(usage.totalTokens, sumParts) : sumParts;
-        lines.push(`Input token - ${formatTokenK(realInput)}${cumInputSuffix}`);
-        lines.push(`Output token - ${formatTokenK(realOutput)}${cumOutputSuffix}`);
-        if (cacheCreation > 0) {
-            lines.push(`Cache create - ${formatTokenK(cacheCreation)}${cumCacheCreateSuffix}`);
-        }
-        lines.push(`Cached token - ${formatTokenK(cacheRead)} (${cachePercent}%)${cumCacheReadSuffix}`);
-        lines.push(`Total token - ${formatTokenK(totalTokens)}${withCumGuard(totalTokens)}`);
+        return realTokenLines(usage, realInput, realOutput, parts);
     }
-    else {
-        // Estimate path: when real input/output are absent,
-        // fall back to the 10% estimate based on contextLength.
-        const inputRef = usage?.contextLength ?? cacheRead;
-        if (inputRef > 0 || cacheRead > 0 || cacheCreation > 0) {
-            const totalInput = inputRef + cacheRead;
-            const outputEst = inputRef > 0 ? Math.round(inputRef * 0.1) : 0;
-            const cachePercent = totalInput > 0 ? Math.round((cacheRead / totalInput) * 100) : 0;
-            const totalTokens = totalInput + outputEst + cacheCreation;
-            lines.push(`Input token - ${formatTokenK(totalInput)}${cumInputSuffix}`);
-            lines.push(`Output token - ${formatTokenK(outputEst)}${cumOutputSuffix}`);
-            if (cacheCreation > 0) {
-                lines.push(`Cache create - ${formatTokenK(cacheCreation)}${cumCacheCreateSuffix}`);
-            }
-            lines.push(`Cached token - ${formatTokenK(cacheRead)} (${cachePercent}%)${cumCacheReadSuffix}`);
-            lines.push(`Total token - ${formatTokenK(totalTokens)}${withCumGuard(totalTokens)}`);
-        }
-    }
-    // 8. 本次 run 花费（USD）
+    return estimateTokenLines(usage, parts);
+}
+function trailingLines(usage) {
+    const lines = [];
     if (usage?.costUsd !== undefined) {
         lines.push(`Cost - $${usage.costUsd.toFixed(4)}`);
     }
-    // 9. 推理 token（> 0 才显示，格式对齐既有 token 行）
     if (usage?.reasoningTokens !== undefined && usage.reasoningTokens > 0) {
         lines.push(`Reasoning token - ${formatTokenK(usage.reasoningTokens)}`);
     }
-    return lines.join('\n');
+    return lines;
+}
+/**
+ * Format usage stats (context length, compact count, cache tokens) into a display string.
+ * Each stat on its own line with blank lines between sections.
+ * @param usage - Usage stats object
+ * @param options - Optional display options (showResult adds result line)
+ */
+export function formatUsageStats(usage, options) {
+    const parts = cumulativeParts(usage);
+    return [
+        ...headerLines(usage, options),
+        ...tokenLines(usage, parts),
+        ...trailingLines(usage),
+    ].join('\n');
 }
 //# sourceMappingURL=usage-format.js.map

package/dist/cli.js

@@ -92,10 +92,17 @@ export async function bootstrap(deps) {
         forwarders.set(sig, forwarder);
         onSignal(sig, forwarder);
     }
-    child.on('error', () => {
+    child.on('error', (err) => {
+        // bun 拉起失败（ENOENT/EACCES）会静默切 node 兜底，但错误本身必须留痕，
+        // 否则「为什么跑在了 node 上」无从排查。logger 此时尚未初始化，console
+        // 是规则允许的启动期例外。
+        console.error('[lark-remote] bun spawn failed, falling back to node:', err);
         for (const [sig, forwarder] of forwarders)
             offSignal(sig, forwarder);
-        void importEntry().catch(() => exit(1));
+        void importEntry().catch((importErr) => {
+            console.error('[lark-remote] node fallback import failed:', importErr);
+            exit(1);
+        });
     });
     child.on('exit', (code, signal) => {
         if (signal) {
@@ -146,7 +153,12 @@ function main() {
         killSelf: (sig) => process.kill(process.pid, sig),
         exit: (code) => process.exit(code),
     };
-    void bootstrap(deps).catch(() => process.exit(1));
+    // bootstrap 是第一接触面：静默 exit(1) 会让安装损坏/依赖缺失表现为零输出
+    // 退出，必须把根因打到 stderr（logger 未初始化，console 为规则允许的例外）。
+    void bootstrap(deps).catch((err) => {
+        console.error('[lark-remote] bootstrap failed:', err);
+        process.exit(1);
+    });
 }
 if (isDirectEntry()) {
     main();

package/dist/clone.js

@@ -237,7 +237,7 @@ export class CloneSession {
             // 图片发送失败不阻断流程：给出浏览器打开兜底。
             await this.connector
                 .sendWithRetry(ctx.chatId, { text: `⚠️ 二维码图片发送失败，请在浏览器打开创建：${info.url}` }, { replyTo: ctx.messageId })
-                .catch(() => { });
+                .catch((err) => getLogger().warn('[clone] fallback notice send failed:', err));
             return;
         }
         finally {
@@ -336,7 +336,7 @@ export class CloneSession {
                     `新应用凭证（请妥善保管）：App ID ${result.client_id}\n` +
                     '可修复本机问题后用 /clone 重新走一遍流程（会创建新应用）',
             }, { replyTo: ctx.messageId })
-                .catch(() => { });
+                .catch((sendErr) => getLogger().warn('[clone] finalize failure notice send failed:', sendErr));
         }
         finally {
             this.state = 'idle';

package/dist/common/text-width.js

@@ -33,33 +33,45 @@ export function displayWidth(text) {
         total += charWidth(ch);
     return total;
 }
+/**
+ * 显示宽度为 2 的码点区间（闭区间，Map 的键 = 下界、值 = 上界）。
+ *
+ * 用 Map 而非对象字面量：对象字面量的 `constructor` / `toString` 等键会命中
+ * Object.prototype，查表会拿到非预期值；数字键的 Map 无此问题。顺序与原 if 链
+ * 一致（所有区间都返回同一宽度，遍历早停即等价），逐字保留：
+ * - [0x1100,0x115f] Hangul Jamo；U+2329 / U+232A 单独列为单码点区间；
+ * - CJK 统一表意文字 / 假名 / 全角标点 / 兼容表意 / 全角 / Hangul 音节；
+ * - 常见 emoji（0x1f300–0x1faff）与 Misc Symbols（0x2600–0x27bf）；
+ * - Misc Technical 块（U+2300–U+23FF）：⏱⏹⏳⏸⏺ 等计时器/播放器符号在
+ *   状态行里实际使用，手机端按 emoji 宽度渲染——按 1 计会系统性低估行宽，
+ *   窄屏余量比设计值更小。
+ */
+const WIDE_CODE_POINT_RANGES = new Map([
+    [0x1100, 0x115f],
+    [0x2329, 0x2329],
+    [0x232a, 0x232a],
+    [0x2e80, 0xa4cf],
+    [0xac00, 0xd7a3],
+    [0xf900, 0xfaff],
+    [0xfe30, 0xfe6f],
+    [0xff00, 0xff60],
+    [0xffe0, 0xffe6],
+    [0x1f300, 0x1faff],
+    [0x2600, 0x27bf],
+    [0x2300, 0x23ff],
+]);
+/** 码点是否落在任一「宽度 2」区间内（模块级命名函数，供 charWidth 查表）。 */
+function isWideCodePoint(code) {
+    for (const [lo, hi] of WIDE_CODE_POINT_RANGES) {
+        if (code >= lo && code <= hi)
+            return true;
+    }
+    return false;
+}
 function charWidth(ch) {
     const code = ch.codePointAt(0) ?? 0;
     // CJK 统一表意文字、假名、全角标点、常见 emoji 都按两个半角算。
-    if (code >= 0x1100 && (code <= 0x115f || code === 0x2329 || code === 0x232a))
-        return 2;
-    if (code >= 0x2e80 && code <= 0xa4cf)
-        return 2;
-    if (code >= 0xac00 && code <= 0xd7a3)
-        return 2;
-    if (code >= 0xf900 && code <= 0xfaff)
-        return 2;
-    if (code >= 0xfe30 && code <= 0xfe6f)
-        return 2;
-    if (code >= 0xff00 && code <= 0xff60)
-        return 2;
-    if (code >= 0xffe0 && code <= 0xffe6)
-        return 2;
-    if (code >= 0x1f300 && code <= 0x1faff)
-        return 2;
-    if (code >= 0x2600 && code <= 0x27bf)
-        return 2;
-    // Misc Technical 块（U+2300–U+23FF）：⏱⏹⏳⏸⏺ 等计时器/播放器符号在
-    // 状态行里实际使用，手机端按 emoji 宽度渲染——按 1 计会系统性低估行宽，
-    // 窄屏余量比设计值更小。
-    if (code >= 0x2300 && code <= 0x23ff)
-        return 2;
-    return 1;
+    return isWideCodePoint(code) ? 2 : 1;
 }
 /**
  * 中间省略截断：保留开头与结尾，只在中间打 `…`。