@deepseek-harness-tui/dsh-tui 0.8.4 → 0.8.6

package/lib/types/tips.js

@@ -443,8 +443,8 @@ export const TIPS = [
     {
         id: 'disp-activity',
         group: 'display',
-        zh: '/activity frames comet 换状态行动画（31 种）',
-        en: '/activity frames comet changes the spinner (31 presets)',
+        zh: '/activity frames comet 换状态行动画（35 种）',
+        en: '/activity frames comet changes the spinner (35 presets)',
     },
     {
         id: 'disp-diff-layout',

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/tuiDisplayPrefs.d.ts

@@ -0,0 +1,47 @@
+/** Background treatment applied to tool-call cards. */
+export type ToolBackground = 'none' | 'subtle' | 'strong';
+/** Individually selectable fields in the status footer. */
+export interface StatusBarConfig {
+    /** Prefer the compact, single-line presentation when space permits. */
+    compact: boolean;
+    /** Live model id. */
+    model: boolean;
+    /** Reasoning effort / thinking mode. */
+    thinking: boolean;
+    /** Session working directory. */
+    cwd: boolean;
+    /** Current context-window consumption. */
+    contextUsage: boolean;
+    /** Prompt-cache hit rate. */
+    cache: boolean;
+    /** Running input/output token totals. */
+    tokens: boolean;
+    /** Live and recent output speed. */
+    tps: boolean;
+    /** Current git branch. */
+    gitBranch: boolean;
+    /** Current session title. */
+    sessionTitle: boolean;
+    /** Non-default session mode. */
+    mode: boolean;
+    /** Segmented context progress bar on its own footer row. */
+    contextBar: boolean;
+    /** Idle working-activity summary. */
+    activity: boolean;
+    /** Mini trajectory wake rendered at the footer's right edge. */
+    trajectory: boolean;
+    /** Idle `? for shortcuts` reminder; shortcut keys remain available when hidden. */
+    shortcutHint: boolean;
+}
+/** Defaults keep the essential route/context information visible. */
+export declare const DEFAULT_STATUS_BAR: Readonly<StatusBarConfig>;
+/** Normalize untrusted/config-layer values without mutating the input. */
+export declare function normalizeToolBackground(value: unknown): ToolBackground;
+/** Merge a partial settings value over the stable status-bar defaults. */
+export declare function normalizeStatusBar(value: unknown): StatusBarConfig;
+/**
+ * Format context-window usage for future status-line consumers.
+ * Invalid or unavailable inputs intentionally produce no field.
+ */
+export declare function formatContextUsage(used: number | undefined, contextWindow: number | undefined, compact?: boolean): string | undefined;
+//# sourceMappingURL=tuiDisplayPrefs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tuiDisplayPrefs.d.ts","sourceRoot":"","sources":["../../src/tuiDisplayPrefs.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEzD,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAA;IAChB,qBAAqB;IACrB,KAAK,EAAE,OAAO,CAAA;IACd,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAA;IACjB,iCAAiC;IACjC,GAAG,EAAE,OAAO,CAAA;IACZ,0CAA0C;IAC1C,YAAY,EAAE,OAAO,CAAA;IACrB,6BAA6B;IAC7B,KAAK,EAAE,OAAO,CAAA;IACd,yCAAyC;IACzC,MAAM,EAAE,OAAO,CAAA;IACf,oCAAoC;IACpC,GAAG,EAAE,OAAO,CAAA;IACZ,0BAA0B;IAC1B,SAAS,EAAE,OAAO,CAAA;IAClB,6BAA6B;IAC7B,YAAY,EAAE,OAAO,CAAA;IACrB,gCAAgC;IAChC,IAAI,EAAE,OAAO,CAAA;IACb,4DAA4D;IAC5D,UAAU,EAAE,OAAO,CAAA;IACnB,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAA;IACjB,gEAAgE;IAChE,UAAU,EAAE,OAAO,CAAA;IACnB,mFAAmF;IACnF,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,eAAe,CAgBvD,CAAA;AAKF,0EAA0E;AAC1E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAItE;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CASlE;AASD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,OAAO,UAAO,GACb,MAAM,GAAG,SAAS,CASpB"}

package/lib/types/tuiDisplayPrefs.js

@@ -0,0 +1,60 @@
+/** Defaults keep the essential route/context information visible. */
+export const DEFAULT_STATUS_BAR = Object.freeze({
+    compact: true,
+    model: true,
+    thinking: true,
+    cwd: true,
+    contextUsage: true,
+    cache: true,
+    tokens: false,
+    tps: false,
+    gitBranch: false,
+    sessionTitle: false,
+    mode: false,
+    contextBar: false,
+    activity: false,
+    trajectory: false,
+    shortcutHint: false,
+});
+const TOOL_BACKGROUNDS = new Set(['none', 'subtle', 'strong']);
+const STATUS_BAR_KEYS = Object.keys(DEFAULT_STATUS_BAR);
+/** Normalize untrusted/config-layer values without mutating the input. */
+export function normalizeToolBackground(value) {
+    return typeof value === 'string' && TOOL_BACKGROUNDS.has(value)
+        ? value
+        : 'none';
+}
+/** Merge a partial settings value over the stable status-bar defaults. */
+export function normalizeStatusBar(value) {
+    const normalized = { ...DEFAULT_STATUS_BAR };
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return normalized;
+    const input = value;
+    for (const key of STATUS_BAR_KEYS) {
+        if (typeof input[key] === 'boolean')
+            normalized[key] = input[key];
+    }
+    return normalized;
+}
+function formatTokenCount(value) {
+    const rounded = Math.max(0, Math.round(value));
+    if (rounded < 1_000)
+        return String(rounded);
+    if (rounded < 1_000_000)
+        return `${(rounded / 1_000).toFixed(rounded < 10_000 ? 1 : 0)}k`;
+    return `${(rounded / 1_000_000).toFixed(rounded < 10_000_000 ? 1 : 0)}m`;
+}
+/**
+ * Format context-window usage for future status-line consumers.
+ * Invalid or unavailable inputs intentionally produce no field.
+ */
+export function formatContextUsage(used, contextWindow, compact = true) {
+    if (!Number.isFinite(used) || !Number.isFinite(contextWindow) || used === undefined || contextWindow === undefined || contextWindow <= 0) {
+        return undefined;
+    }
+    const safeUsed = Math.max(0, used);
+    const percent = Math.min(999, (safeUsed / contextWindow) * 100);
+    const percentText = `${percent < 10 ? percent.toFixed(1) : Math.round(percent)}%`;
+    const counts = `${formatTokenCount(safeUsed)}/${formatTokenCount(contextWindow)}`;
+    return compact ? `${percentText} (${counts})` : `${counts} (${percentText})`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepseek-harness-tui/dsh-tui",
-  "version": "0.8.4",
+  "version": "0.8.6",
   "description": "Claude Code style interactive TUI front door for DeepSeek Harness agents, built on the ported Ink core.",
   "license": "MIT",
   "repository": {
@@ -113,7 +113,10 @@
     "verify:plugin-commands": "node --import tsx/esm scripts/verify-plugin-commands.ts",
     "verify:plugin-negotiation": "node --import tsx/esm scripts/verify-plugin-negotiation.ts",
     "verify:plugin-lifecycle": "node --import tsx/esm scripts/verify-plugin-lifecycle.ts",
-    "verify:tips": "node --import tsx/esm scripts/verify-tips.tsx"
+    "verify:tips": "node --import tsx/esm scripts/verify-tips.tsx",
+    "verify:thinking-preview": "node --import tsx/esm scripts/verify-thinking-preview.tsx",
+    "sync:profile": "node scripts/sync-profile.mjs",
+    "sync:profile:check": "node scripts/sync-profile.mjs --check"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
@@ -158,7 +161,7 @@
     "cli-highlight": "^2.1.11",
     "code-excerpt": "^3.0.0 || ^4.0.0",
     "diff": "^8.0.4",
-    "dsh-working-activity": "^0.3.0",
+    "dsh-working-activity": "^0.3.2",
     "emoji-regex": "^10.0.0",
     "figures": "^6.1.0",
     "get-east-asian-width": "^1.0.0",