@deepseek-harness-tui/dsh-tui 0.8.5 → 0.8.7

package/lib/types/theme.js

@@ -58,6 +58,8 @@ const darkTheme = {
     autoAccept: rgb('#B3A0D4'), // Soft violet
     bashBorder: rgb('#D194AE'), // Mist rose
     claude: rgb('#7DA1DE'), // Accent Soft — mist brand blue
+    toolNameMutate: rgb('#E5C07B'), // soft gold — Edit/Write (warm accent)
+    toolNameExec: rgb('#56B6C2'), // mist cyan — Bash/exec tools
     claudeShimmer: rgb('#ABC2EC'), // Border Blue for shimmer effect
     claudeBlue_FOR_SYSTEM_SPINNER: rgb('#7DA1DE'),
     claudeBlueShimmer_FOR_SYSTEM_SPINNER: rgb('#ABC2EC'),
@@ -93,16 +95,16 @@ const darkTheme = {
     toolDotWrite: rgb('#B3A0D4'), // soft violet — edit/write
     toolDotWeb: rgb('#7DA1DE'), // mist blue — web search/fetch
     toolDotTask: rgb('#D194AE'), // mist rose — subagent/jobs
-    syntaxKeyword: rgb('#8FA8E8'), // mist blue
-    syntaxString: rgb('#9FBF8F'), // soft sage
-    syntaxComment: rgb('#6B7280'), // neutral grey
-    syntaxNumber: rgb('#D9A97E'), // warm tan
-    syntaxFunction: rgb('#82B8C7'), // cyan blue
-    syntaxType: rgb('#B39DDB'), // soft violet
+    syntaxKeyword: rgb('#78A0D6'), // muted anchor blue
+    syntaxString: rgb('#79AD91'), // mist green, distinct without neon saturation
+    syntaxComment: rgb('#74808D'), // neutral blue-grey
+    syntaxNumber: rgb('#C89B70'), // softened warm amber
+    syntaxFunction: rgb('#6FAEB5'), // muted cyan
+    syntaxType: rgb('#A98FBF'), // softened violet
     syntaxVariable: rgb('#C9D1D9'), // near-text
     syntaxOperator: rgb('#93A1B0'), // blue grey
     syntaxPunctuation: rgb('#7A8694'), // dim blue grey
-    syntaxConstant: rgb('#D98C9B'), // soft rose
+    syntaxConstant: rgb('#C98291'), // softened rose
     red_FOR_SUBAGENTS_ONLY: rgb('#D4685E'),
     blue_FOR_SUBAGENTS_ONLY: rgb('#7496D6'),
     green_FOR_SUBAGENTS_ONLY: rgb('#66B285'),
@@ -115,8 +117,8 @@ const darkTheme = {
     chromeYellow: rgb('#D8B270'),
     clawd_body: rgb('#D98A63'), // Warm mascot orange
     clawd_background: rgb('#000000'),
-    userMessageBackground: rgb('#292D36'),
-    userMessageBackgroundHover: rgb('#343945'),
+    userMessageBackground: '', // user turn: no fill, gold bold text only (Kimi style)
+    userMessageBackgroundHover: rgb('#3B5BDB'), // hover/expand: blue block with gold text
     messageActionsBackground: rgb('#2E333D'),
     selectionBg: rgb('#3B4A66'), // Mist-blue tint on dark
     bashMessageBackgroundColor: rgb('#2C3038'),
@@ -125,7 +127,7 @@ const darkTheme = {
     rate_limit_empty: rgb('#3C414B'),
     fastMode: rgb('#E09A58'),
     fastModeShimmer: rgb('#EAB478'),
-    briefLabelYou: rgb('#ABC2EC'),
+    briefLabelYou: rgb('#FFDF80'),
     briefLabelClaude: rgb('#7DA1DE'),
     rainbow_red: rgb('#D98F8A'),
     rainbow_orange: rgb('#D9A97E'),
@@ -141,6 +143,14 @@ const darkTheme = {
     rainbow_blue_shimmer: rgb('#AFBFE2'),
     rainbow_indigo_shimmer: rgb('#BFB4DE'),
     rainbow_violet_shimmer: rgb('#D1B4D1'),
+    subagentBullet: rgb('#D194AE'),
+    subagentDescription: rgb('#E8E6E0'),
+    subagentModel: rgb('#8D95A6'),
+    subagentElapsed: rgb('#8D95A6'),
+    subagentToolName: rgb('#7DA1DE'),
+    subagentStatusRunning: rgb('#7DA1DE'),
+    subagentStatusCompleted: rgb('#82B89D'),
+    subagentStatusFailed: rgb('#DA8A93'),
 };
 /**
  * Gentle Mist Blue light theme — the strict original card. Blue carries
@@ -152,6 +162,8 @@ const lightTheme = {
     autoAccept: rgb('#9B86B8'), // Muted violet (from surface-alt pink-mist)
     bashBorder: rgb('#C07A93'), // Muted rose (from surface-alt pink-mist)
     claude: rgb('#3F6CC4'), // Primary Blue — brand
+    toolNameMutate: rgb('#8A6A00'), // deep gold - Edit/Write (warm accent)
+    toolNameExec: rgb('#0F7A8A'), // deep cyan - Bash/exec tools
     claudeShimmer: rgb('#5E88CC'), // Accent Blue for shimmer effect
     claudeBlue_FOR_SYSTEM_SPINNER: rgb('#3F6CC4'),
     claudeBlueShimmer_FOR_SYSTEM_SPINNER: rgb('#5E88CC'),
@@ -187,16 +199,16 @@ const lightTheme = {
     toolDotWrite: rgb('#7A5CA8'),
     toolDotWeb: rgb('#4A63A8'),
     toolDotTask: rgb('#B04A5A'),
-    syntaxKeyword: rgb('#4A63A8'),
-    syntaxString: rgb('#4E7A4E'),
-    syntaxComment: rgb('#8A8F98'),
-    syntaxNumber: rgb('#A96B32'),
-    syntaxFunction: rgb('#3F7E8F'),
-    syntaxType: rgb('#7A5CA8'),
+    syntaxKeyword: rgb('#3F68B5'), // clear primary blue without neon saturation
+    syntaxString: rgb('#3F805F'), // readable muted green
+    syntaxComment: rgb('#7D858F'), // neutral blue-grey
+    syntaxNumber: rgb('#A7652B'), // warm amber accent
+    syntaxFunction: rgb('#2E7E8A'), // muted cyan
+    syntaxType: rgb('#7E55A4'), // softened violet
     syntaxVariable: rgb('#343945'),
     syntaxOperator: rgb('#5B6672'),
     syntaxPunctuation: rgb('#9AA0A8'),
-    syntaxConstant: rgb('#B04A5A'),
+    syntaxConstant: rgb('#A84472'), // muted rose accent
     red_FOR_SUBAGENTS_ONLY: rgb('#BE5A52'),
     blue_FOR_SUBAGENTS_ONLY: rgb('#3F6CC4'),
     green_FOR_SUBAGENTS_ONLY: rgb('#4E9675'),
@@ -209,8 +221,8 @@ const lightTheme = {
     chromeYellow: rgb('#C99A3F'),
     clawd_body: rgb('#D98A63'), // Warm mascot orange
     clawd_background: rgb('#F6F3ED'),
-    userMessageBackground: rgb('#EEE5D2'), // Surface
-    userMessageBackgroundHover: rgb('#E4D9E5'), // Surface Alt
+    userMessageBackground: '', // user turn: no fill in light mode, gold text only
+    userMessageBackgroundHover: rgb('#DCE4FB'), // subtle blue tint on hover/expand
     messageActionsBackground: rgb('#E4D9E5'),
     selectionBg: rgb('#D5DEF2'), // Mist-blue tint on warm white
     bashMessageBackgroundColor: rgb('#EAE1D3'),
@@ -219,7 +231,7 @@ const lightTheme = {
     rate_limit_empty: rgb('#DDD5C7'),
     fastMode: rgb('#D98E4A'),
     fastModeShimmer: rgb('#E2A465'),
-    briefLabelYou: rgb('#5E88CC'),
+    briefLabelYou: rgb('#A67600'),
     briefLabelClaude: rgb('#3F6CC4'),
     rainbow_red: rgb('#D98888'),
     rainbow_orange: rgb('#D9A276'),
@@ -235,6 +247,14 @@ const lightTheme = {
     rainbow_blue_shimmer: rgb('#A9BCE0'),
     rainbow_indigo_shimmer: rgb('#B7AFD8'),
     rainbow_violet_shimmer: rgb('#CFB0CC'),
+    subagentBullet: rgb('#C07A93'),
+    subagentDescription: rgb('#343945'),
+    subagentModel: rgb('#8991A0'),
+    subagentElapsed: rgb('#8991A0'),
+    subagentToolName: rgb('#3F6CC4'),
+    subagentStatusRunning: rgb('#3F6CC4'),
+    subagentStatusCompleted: rgb('#4E9675'),
+    subagentStatusFailed: rgb('#C65D6B'),
 };
 /**
  * Dark ANSI theme using only the 16 standard ANSI colors, for terminals
@@ -248,6 +268,8 @@ const darkAnsiTheme = {
     autoAccept: 'ansi:magentaBright',
     bashBorder: 'ansi:magentaBright',
     claude: 'ansi:blueBright',
+    toolNameMutate: 'ansi:yellowBright',
+    toolNameExec: 'ansi:cyanBright',
     claudeShimmer: 'ansi:blueBright',
     claudeBlue_FOR_SYSTEM_SPINNER: 'ansi:blueBright',
     claudeBlueShimmer_FOR_SYSTEM_SPINNER: 'ansi:blueBright',
@@ -305,8 +327,8 @@ const darkAnsiTheme = {
     chromeYellow: 'ansi:yellowBright',
     clawd_body: 'ansi:redBright',
     clawd_background: 'ansi:black',
-    userMessageBackground: 'ansi:blackBright',
-    userMessageBackgroundHover: 'ansi:white',
+    userMessageBackground: '',
+    userMessageBackgroundHover: 'ansi:blue',
     messageActionsBackground: 'ansi:blackBright',
     selectionBg: 'ansi:blue',
     bashMessageBackgroundColor: 'ansi:black',
@@ -315,7 +337,7 @@ const darkAnsiTheme = {
     rate_limit_empty: 'ansi:white',
     fastMode: 'ansi:redBright',
     fastModeShimmer: 'ansi:redBright',
-    briefLabelYou: 'ansi:blueBright',
+    briefLabelYou: 'ansi:yellowBright',
     briefLabelClaude: 'ansi:blueBright',
     rainbow_red: 'ansi:red',
     rainbow_orange: 'ansi:redBright',
@@ -331,6 +353,14 @@ const darkAnsiTheme = {
     rainbow_blue_shimmer: 'ansi:cyanBright',
     rainbow_indigo_shimmer: 'ansi:blueBright',
     rainbow_violet_shimmer: 'ansi:magentaBright',
+    subagentBullet: 'ansi:magentaBright',
+    subagentDescription: 'ansi:whiteBright',
+    subagentModel: 'ansi:white',
+    subagentElapsed: 'ansi:white',
+    subagentToolName: 'ansi:cyanBright',
+    subagentStatusRunning: 'ansi:blueBright',
+    subagentStatusCompleted: 'ansi:greenBright',
+    subagentStatusFailed: 'ansi:redBright',
 };
 /**
  * Resolve a theme name to its concrete color palette.
@@ -363,6 +393,30 @@ export function getTheme(themeName) {
  * (markdown inline code) resolves user themes through getActiveTheme().
  */
 let customThemeResolver;
+/**
+ * Whether the active theme's RESOLVED palette renders on a light background.
+ * Keyed off the resolved palette's IDENTITY for the built-ins (auto resolves
+ * to the shared light/dark instance, so this covers auto-with-light-terminal
+ * that theme-NAME comparisons miss) and off the ink-text luminance for
+ * custom themes (light palettes pair with dark ink). The palette's
+ * `background` field is a badge fill, not the terminal background — never a
+ * lightness signal. Colour-pair variants (effort ignition hues) consume this.
+ */
+export function isLightThemeActive(themeName) {
+    const theme = getTheme(themeName);
+    if (theme === lightTheme)
+        return true;
+    if (theme === darkTheme || theme === darkAnsiTheme)
+        return false;
+    // 自定义主题：按文本墨色亮度判定——浅底配深墨（ink）、深底配亮墨。
+    // 调色板的 background 字段是徽标填充色而非终端背景，不能作判据。
+    const ink = theme.text;
+    const rgb = /^rgb\((\d+),(\d+),(\d+)\)$/.exec(ink);
+    if (rgb === null)
+        return false;
+    const [r, g, b] = [Number(rgb[1]), Number(rgb[2]), Number(rgb[3])];
+    return 0.299 * r + 0.587 * g + 0.114 * b < 140;
+}
 /**
  * Register the custom-theme resolver. Called once by ThemeProvider; the
  * resolver must return `undefined` for names it does not know so getTheme

package/lib/types/tips.js

@@ -60,10 +60,10 @@ export const TIPS = [
         en: 'In trajectory, / queries fields like tool:, err:, >10s, tok>1k',
     },
     {
-        id: 'keys-ctrl-x',
+        id: 'keys-ctrl-g',
         group: 'keys',
-        zh: 'Ctrl+X 用 $VISUAL 编辑器编辑当前输入',
-        en: 'Ctrl+X edits your input in the $VISUAL editor',
+        zh: 'Ctrl+G 用 $VISUAL/$EDITOR 编辑器编辑当前输入',
+        en: 'Ctrl+G edits your input in the $VISUAL/$EDITOR editor',
     },
     {
         id: 'keys-ctrl-enter',

package/lib/types/trajectory/effortIgnition.d.ts

@@ -0,0 +1,66 @@
+/** 三幕时间轴（ms）：扫光全长、字样启动（波至中段）、字样渐亮、渐隐起止。边框扫光与输入行字样徽标共用。 */
+export declare const IGNITION_TIMELINE: {
+    readonly sweepMs: 1000;
+    readonly labelStartMs: 600;
+    readonly labelBrightenMs: 160;
+    readonly fadeStartMs: 1500;
+    readonly fadeEndMs: 2000;
+};
+/**
+ * Effort ignition motion math — pure functions, zero dependencies.
+ *
+ * Waveform semantics ported from Codex CLI's effort_ignition(_styles).rs
+ * (openai/codex PR #34365) and revalidated in a dsh-TUI integration: a
+ * cosine-bell travelling wave produces per-column colours only — a renderer
+ * that keeps glyphs constant and changes colours per frame stays SGR-only
+ * by construction.
+ *
+ * Consumers ride the FOREGROUND channel (a constant block glyph under a
+ * varying fg colour): pure-background cells never reached the terminal in
+ * the fullscreen log-update pipeline, while foreground is the channel every
+ * live element already rides.
+ */
+import type { RGBColor } from '../components/Spinner/spinnerUtils.js';
+/** 扫光全长（ms），仅用于把墙钟时间折算成动画秒数，不创建任何定时器。 */
+export declare const SWEEP_TOTAL_MS = 1000;
+export declare function ignitionHues(onLight: boolean): readonly [RGBColor, RGBColor, RGBColor];
+/**
+ * 充能色对（前缀强调用）：从带底色调暗端到全值，与波共用 hues[0]。
+ */
+export declare function accentRamp(onLight: boolean): {
+    dim: RGBColor;
+    full: RGBColor;
+};
+/** 余弦钟形：`crest(0)=1`、`crest(±1)=0`、之外为 0（负距离同样静默——
+ * 现有调用方都传 `Math.abs`，这里兜底防未来调用方拿到全强度）。 */
+export declare function crest(distance: number): number;
+/** ease-out cubic：`1-(1-p)³`，两端 clamp。 */
+export declare function easeOutCubic(progress: number): number;
+/** ease-in-out cubic：前半 `4p³`、后半镜像，两端 clamp。 */
+export declare function easeInOutCubic(progress: number): number;
+/** 线性混色（t=0 → a，t=1 → b，不 clamp）。 */
+export declare function blend(a: RGBColor, b: RGBColor, t: number): RGBColor;
+/**
+ * 扫光某一时刻的整行颜色。
+ *
+ * @param options.elapsedMs - 距触发的时间；达到 {@link SWEEP_TOTAL_MS}
+ *   后整行返回空数组（无波，行恢复本底）。
+ * @param options.width - 行列数（终端宽）。
+ * @param options.onLight - 浅色主题时用浅底色板与浅带底色。
+ * @returns 逐列颜色（`rgb(r,g,b)` 字符串）；无波的列为 `undefined`，
+ *   渲染层应输出本底色，保持行宽恒定。
+ */
+export declare function ignitionLineColors(options: {
+    elapsedMs: number;
+    width: number;
+    onLight: boolean;
+}): ReadonlyArray<string | undefined>;
+/**
+ * 顶档切入判定：从「已有档位」变为「另一档位」且新档位是档位表末位
+ * 最高档。冷启动恢复偏好、单档表、档位表未知都不触发。
+ */
+export declare function entersTopTier(previous: string | undefined, current: string | undefined, levels: readonly string[] | undefined): boolean;
+/** 充能时长（ms）与充能进度（钳 [0,1]，负 elapsed 钳 0）。 */
+export declare const CHARGE_MS = 150;
+export declare function chargeProgress(elapsedMs: number): number;
+//# sourceMappingURL=effortIgnition.d.ts.map

package/lib/types/trajectory/effortIgnition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effortIgnition.d.ts","sourceRoot":"","sources":["../../../src/trajectory/effortIgnition.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB;;;;;;CAMpB,CAAA;AAEV;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAGrE,yCAAyC;AACzC,eAAO,MAAM,cAAc,OAAO,CAAA;AA8BlC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAEtF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG;IAAE,GAAG,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAG9E;AAED;0CAC0C;AAC1C,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED,0CAA0C;AAC1C,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKvD;AAaD,qCAAqC;AACrC,wBAAgB,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ,CAMnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;CACjB,GAAG,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC,CA0BpC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACpC,OAAO,CAST;AAED,4CAA4C;AAC5C,eAAO,MAAM,SAAS,MAAM,CAAA;AAE5B,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGxD"}

package/lib/types/trajectory/effortIgnition.js

@@ -0,0 +1,142 @@
+/** 三幕时间轴（ms）：扫光全长、字样启动（波至中段）、字样渐亮、渐隐起止。边框扫光与输入行字样徽标共用。 */
+export const IGNITION_TIMELINE = {
+    sweepMs: 1000,
+    labelStartMs: 600,
+    labelBrightenMs: 160,
+    fadeStartMs: 1500,
+    fadeEndMs: 2000,
+};
+import { rgbString } from './motion.js';
+/** 扫光全长（ms），仅用于把墙钟时间折算成动画秒数，不创建任何定时器。 */
+export const SWEEP_TOTAL_MS = 1000;
+/** 波形宽度参数（列）。 */
+const WAVE_HALF_WIDTH = 14;
+/** 波形参数：`[launch, travel]`（秒）——扫光在何时启动、多久行至右缘。 */
+const BAND = [0.1, 0.75];
+/**
+ * 高亮彩色色板：亮蓝/亮青/亮紫三 hue（浅色背景用加深变体——浅底上
+ * 亮色没有对比度）。波只点亮 hues[0]，前两个 hue 留给未来的多带风格。
+ */
+const HUES_DARK = [
+    { r: 130, g: 185, b: 255 },
+    { r: 140, g: 252, b: 248 },
+    { r: 195, g: 172, b: 255 },
+];
+const HUES_LIGHT = [
+    { r: 30, g: 95, b: 235 },
+    { r: 10, g: 160, b: 200 },
+    { r: 120, g: 80, b: 235 },
+];
+/**
+ * 带底色（波向终端本底淡入的目标色）。近似值：取主题深/浅背景的典
+ * 型值而非逐主题读取——波只存活一秒，色差在低 alpha 下不可辨。
+ */
+const BAND_DARK = { r: 27, g: 30, b: 40 };
+const BAND_LIGHT = { r: 240, g: 240, b: 242 };
+export function ignitionHues(onLight) {
+    return onLight ? HUES_LIGHT : HUES_DARK;
+}
+/**
+ * 充能色对（前缀强调用）：从带底色调暗端到全值，与波共用 hues[0]。
+ */
+export function accentRamp(onLight) {
+    const band = onLight ? BAND_LIGHT : BAND_DARK;
+    return { dim: blend(band, ignitionHues(onLight)[0], 0.45), full: ignitionHues(onLight)[0] };
+}
+/** 余弦钟形：`crest(0)=1`、`crest(±1)=0`、之外为 0（负距离同样静默——
+ * 现有调用方都传 `Math.abs`，这里兜底防未来调用方拿到全强度）。 */
+export function crest(distance) {
+    if (distance >= 1 || distance <= -1)
+        return 0;
+    return 0.5 * (1 + Math.cos(Math.PI * distance));
+}
+/** ease-out cubic：`1-(1-p)³`，两端 clamp。 */
+export function easeOutCubic(progress) {
+    const p = Math.min(1, Math.max(0, progress));
+    const inverse = 1 - p;
+    return 1 - inverse * inverse * inverse;
+}
+/** ease-in-out cubic：前半 `4p³`、后半镜像，两端 clamp。 */
+export function easeInOutCubic(progress) {
+    const p = Math.min(1, Math.max(0, progress));
+    if (p < 0.5)
+        return 4 * p * p * p;
+    const inverse = -2 * p + 2;
+    return 1 - (inverse * inverse * inverse) / 2;
+}
+/** 单列对波带的采样：三 hue 权重（未归一；单波形只点亮 hue[0]）。 */
+function sampleColumn(elapsed, column, width) {
+    const weights = [0, 0, 0];
+    const [launch, travel] = BAND;
+    const progress = (elapsed - launch) / travel;
+    if (progress < 0 || progress > 1)
+        return weights;
+    const center = easeInOutCubic(progress) * (width + 2 * WAVE_HALF_WIDTH) - WAVE_HALF_WIDTH;
+    weights[0] = crest(Math.abs(column - center) / WAVE_HALF_WIDTH);
+    return weights;
+}
+/** 线性混色（t=0 → a，t=1 → b，不 clamp）。 */
+export function blend(a, b, t) {
+    return {
+        r: Math.round(a.r + (b.r - a.r) * t),
+        g: Math.round(a.g + (b.g - a.g) * t),
+        b: Math.round(a.b + (b.b - a.b) * t),
+    };
+}
+/**
+ * 扫光某一时刻的整行颜色。
+ *
+ * @param options.elapsedMs - 距触发的时间；达到 {@link SWEEP_TOTAL_MS}
+ *   后整行返回空数组（无波，行恢复本底）。
+ * @param options.width - 行列数（终端宽）。
+ * @param options.onLight - 浅色主题时用浅底色板与浅带底色。
+ * @returns 逐列颜色（`rgb(r,g,b)` 字符串）；无波的列为 `undefined`，
+ *   渲染层应输出本底色，保持行宽恒定。
+ */
+export function ignitionLineColors(options) {
+    const { elapsedMs, width, onLight } = options;
+    const elapsed = elapsedMs / 1000;
+    const total = SWEEP_TOTAL_MS / 1000;
+    if (width <= 0 || !Number.isFinite(elapsed) || elapsed <= 0 || elapsed >= total)
+        return [];
+    const hue = ignitionHues(onLight)[0];
+    const band = onLight ? BAND_LIGHT : BAND_DARK;
+    const colors = new Array(width);
+    for (let column = 0; column < width; column++) {
+        const weight = sampleColumn(elapsed, column, width)[0];
+        if (weight <= 0.01) {
+            colors[column] = undefined;
+            continue;
+        }
+        // 波按强度淡入带底色：alpha=1 是纯 hue，alpha→0 收敛回本底；高亮
+        // 度档满强度纯 hue 直出。输出前通道量化到 8 步长——渐变列因此能
+        // 合并成长段（渲染层 RLE 段数降一个数量级），8/256 的色差在终端
+        // cell 分辨率下不可辨。
+        const tinted = blend(band, hue, Math.min(weight, 1));
+        colors[column] = rgbString({
+            r: Math.round(tinted.r / 8) * 8,
+            g: Math.round(tinted.g / 8) * 8,
+            b: Math.round(tinted.b / 8) * 8,
+        });
+    }
+    return colors;
+}
+/**
+ * 顶档切入判定：从「已有档位」变为「另一档位」且新档位是档位表末位
+ * 最高档。冷启动恢复偏好、单档表、档位表未知都不触发。
+ */
+export function entersTopTier(previous, current, levels) {
+    return (current !== undefined &&
+        previous !== undefined &&
+        current !== previous &&
+        levels !== undefined &&
+        levels.length > 1 &&
+        current === levels[levels.length - 1]);
+}
+/** 充能时长（ms）与充能进度（钳 [0,1]，负 elapsed 钳 0）。 */
+export const CHARGE_MS = 150;
+export function chargeProgress(elapsedMs) {
+    if (!Number.isFinite(elapsedMs))
+        return 0;
+    return Math.min(1, Math.max(0, Math.max(0, elapsedMs) / CHARGE_MS));
+}

package/lib/types/update.d.ts

@@ -88,6 +88,24 @@ export declare function tuiUpdatePluginArgs(profile: string, targetVersion?: str
  * token, so matching both keeps the retry from masking real failures.
  */
 export declare function isTransientUpdateFailure(stderr: string): boolean;
+/**
+ * Best-effort migrate the GLOBAL launcher to the delegating shim (0.8.7):
+ * after a successful profile update, copy this package's `bin/dsh-tui.js`
+ * and `package.json` over the global install so the launcher can never lag
+ * the profile again — the shim delegates all logic to the profile copy it
+ * just updated. Single-file-safe by contract: the new bin imports nothing
+ * from lib/ (see its header), so overwriting it inside an older global
+ * install cannot dangle a missing helper.
+ *
+ * Locating the global dir relies on argv[1] being the global `dsh-tui.js`
+ * (true when booted through the `dsh-tui` command). Source checkouts and
+ * direct `dsh --profile` boots resolve nothing — the migration is a silent
+ * no-op there. Write failures (permissions, locked files) are equally
+ * silent: the launcher-alignment warning remains the fallback diagnosis.
+ *
+ * @returns true when the global launcher files were replaced.
+ */
+export declare function migrateGlobalLauncher(): boolean;
 /**
  * Update the installed dsh-tui package and restart the same launcher while
  * preserving the active session. The TUI must already be unmounted before

package/lib/types/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/update.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAIlD,OAAO,EAAE,UAAU,EAAE,CAAA;AAQrB,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf;AAED,4DAA4D;AAC5D,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAA;AAEvB,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAiBxD;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,SAAS,MAAM,EAAiB,GAAG,MAAM,GAAG,SAAS,CAahG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAW5C;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIzE;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG7D;AA4BD;;;;;;;;;;;;GAYG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,eAAe,CAAC,CAcvE;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAG5E;AA6DD,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAIrF;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,eAAe,CAAC,CAuE1B"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/update.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAIlD,OAAO,EAAE,UAAU,EAAE,CAAA;AAQrB,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf;AAED,4DAA4D;AAC5D,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAA;AAEvB,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAiBxD;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,SAAS,MAAM,EAAiB,GAAG,MAAM,GAAG,SAAS,CAahG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAW5C;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIzE;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG7D;AA4BD;;;;;;;;;;;;GAYG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,eAAe,CAAC,CAcvE;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAG5E;AA6DD,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAIrF;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CA2C/C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,eAAe,CAAC,CA+E1B"}

package/lib/types/update.js

@@ -1,7 +1,7 @@
 import { spawn } from 'node:child_process';
-import { readFileSync } from 'node:fs';
+import { readFileSync, realpathSync, renameSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { dirname, join } from 'node:path';
+import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { gte, gt, lt, valid } from 'semver';
 import { shellQuote } from './utils/shellQuote.js';
@@ -225,6 +225,70 @@ export function tuiUpdatePluginArgs(profile, targetVersion) {
 export function isTransientUpdateFailure(stderr) {
     return /ENOENT|EPERM|EBUSY/i.test(stderr) && /_tmp_\d+/i.test(stderr);
 }
+/**
+ * Best-effort migrate the GLOBAL launcher to the delegating shim (0.8.7):
+ * after a successful profile update, copy this package's `bin/dsh-tui.js`
+ * and `package.json` over the global install so the launcher can never lag
+ * the profile again — the shim delegates all logic to the profile copy it
+ * just updated. Single-file-safe by contract: the new bin imports nothing
+ * from lib/ (see its header), so overwriting it inside an older global
+ * install cannot dangle a missing helper.
+ *
+ * Locating the global dir relies on argv[1] being the global `dsh-tui.js`
+ * (true when booted through the `dsh-tui` command). Source checkouts and
+ * direct `dsh --profile` boots resolve nothing — the migration is a silent
+ * no-op there. Write failures (permissions, locked files) are equally
+ * silent: the launcher-alignment warning remains the fallback diagnosis.
+ *
+ * @returns true when the global launcher files were replaced.
+ */
+export function migrateGlobalLauncher() {
+    const launcherBin = process.argv[1];
+    if (launcherBin === undefined || !launcherBin.endsWith('dsh-tui.js'))
+        return false;
+    // Walk up from the bin to the containing package; accept it only when it
+    // is OUR package and not the profile copy we are running from (junction
+    // layouts collapse both onto the same real path — copying onto ourselves
+    // would be a no-op at best).
+    let dir = dirname(resolve(launcherBin));
+    const ownDir = dirname(dirname(fileURLToPath(import.meta.url)));
+    for (let depth = 0; depth < 4; depth++) {
+        const manifest = join(dir, 'package.json');
+        try {
+            const parsed = JSON.parse(readFileSync(manifest, 'utf8'));
+            if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)
+                && parsed.name === PACKAGE_NAME) {
+                let same = false;
+                try {
+                    same = realpathSync(dir) === realpathSync(ownDir);
+                }
+                catch {
+                    same = resolve(dir) === resolve(ownDir);
+                }
+                if (same)
+                    return false;
+                // tmp + rename keeps each file atomic; a crash mid-migration leaves
+                // either the old or the new file, never a truncated one.
+                const replace = (target, source) => {
+                    const staged = `${target}.dsh-tui-migrate`;
+                    writeFileSync(staged, readFileSync(source));
+                    renameSync(staged, target);
+                };
+                replace(join(dir, 'bin', 'dsh-tui.js'), join(ownDir, 'bin', 'dsh-tui.js'));
+                replace(manifest, join(ownDir, 'package.json'));
+                return true;
+            }
+        }
+        catch {
+            // Unreadable manifest at this level — keep walking up.
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return false;
+        dir = parent;
+    }
+    return false;
+}
 /**
  * Update the installed dsh-tui package and restart the same launcher while
  * preserving the active session. The TUI must already be unmounted before
@@ -297,6 +361,13 @@ export async function updateTuiAndRestart(sessionId, profile, targetVersion) {
             return { updateCode: 1, restartCode: 1 };
         }
     }
+    // Launcher migration (0.8.7): the freshly installed profile carries the
+    // delegating shim — stamp it over the global launcher so this is the LAST
+    // time the outer copy can lag. Best-effort; the alignment warning stays as
+    // the fallback when the copy is impossible.
+    if (migrateGlobalLauncher()) {
+        process.stderr.write('dsh-tui: global launcher aligned to the delegating shim (no manual npm i -g needed anymore).\n');
+    }
     const restartCode = await runProcess(process.execPath, [...process.execArgv, ...process.argv.slice(1)], {
         env: {
             ...process.env,

package/lib/types/utils/execFileNoThrow.d.ts

@@ -4,31 +4,14 @@ export interface ExecFileNoThrowResult {
     stdout: string;
     stderr: string;
 }
-/**
- * Options for {@link execFileNoThrow}: stdin payload, timeout, and child
- * working directory.
- */
+/** Options for {@link execFileNoThrow}: stdin payload, timeout, and child
+ * working directory. */
 export interface ExecFileNoThrowOptions {
-    /** Stdin payload (OSC 52 clipboard helpers and tmux load-buffer). */
     input?: string;
-    /** Kill the child after this many milliseconds. */
     timeout?: number;
-    /**
-     * Accepted for call-site compatibility with the original execa-based
-     * implementation; `false` (the only value the Ink core passes) matches this
-     * shim's behavior of running in the current working directory.
-     */
     useCwd?: boolean;
-    /** Working directory for the child; defaults to the parent's cwd. */
     cwd?: string;
 }
-/**
- * Run a command without throwing: resolves with `{ code, stdout, stderr }`
- * even when the process exits non-zero or cannot spawn.
- * @param file - The executable path to spawn.
- * @param args - Command-line arguments; defaults to none.
- * @param options - Spawn options (input, timeout, cwd).
- * @returns The process outcome: exit code, captured stdout, and captured stderr.
- */
+/** Run a command without throwing; child output is bounded for safety. */
 export declare function execFileNoThrow(file: string, args?: readonly string[], options?: ExecFileNoThrowOptions): Promise<ExecFileNoThrowResult>;
 //# sourceMappingURL=execFileNoThrow.d.ts.map

package/lib/types/utils/execFileNoThrow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execFileNoThrow.d.ts","sourceRoot":"","sources":["../../../src/utils/execFileNoThrow.ts"],"names":[],"mappings":"AAEA,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CAiChC"}
+{"version":3,"file":"execFileNoThrow.d.ts","sourceRoot":"","sources":["../../../src/utils/execFileNoThrow.ts"],"names":[],"mappings":"AAKA,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED;wBACwB;AACxB,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AA6BD,0EAA0E;AAC1E,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,SAAS,MAAM,EAAO,EAC5B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CA+BhC"}