@deepseek-harness-tui/dsh-tui 0.11.0 → 0.11.2

package/lib/types/components/InlineMathParagraph.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import type { Tokens } from 'marked';
+import type { CliHighlight } from '../terminal-utils/cliHighlight.js';
+/**
+ * A top-level paragraph whose inline formulas show as terminal images
+ * (`mathRendering: image`, Kitty or Sixel graphics, a measured cell size).
+ *
+ * It renders exactly like the plain <Text> paragraph until it can switch
+ * whole: the paragraph's width is measured, and every formula has settled
+ * (typeset into a one-row image, or failed). The switch then happens once,
+ * so formulas arriving one by one never shift the wrap points. Formulas that
+ * failed or would shrink below legibility on one row keep their Unicode
+ * form. Each row is laid out by `layoutInlineMedia` and drawn as text
+ * pieces with one-row <Image> slots between them.
+ */
+type Props = {
+    token: Tokens.Paragraph;
+    highlight: CliHighlight | null;
+};
+export declare function InlineMathParagraph({ token, highlight }: Props): React.ReactNode;
+export {};
+//# sourceMappingURL=InlineMathParagraph.d.ts.map

package/lib/types/components/InlineMathParagraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InlineMathParagraph.d.ts","sourceRoot":"","sources":["../../../src/components/InlineMathParagraph.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAS,MAAM,EAAE,MAAM,QAAQ,CAAA;AAQ3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAQrE;;;;;;;;;;;GAWG;AAEH,KAAK,KAAK,GAAG;IACX,KAAK,EAAE,MAAM,CAAC,SAAS,CAAA;IACvB,SAAS,EAAE,YAAY,GAAG,IAAI,CAAA;CAC/B,CAAA;AAOD,wBAAgB,mBAAmB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CAiGhF"}

package/lib/types/components/InlineMathParagraph.js

@@ -0,0 +1,178 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { Box, Image, Text, useTerminalImageCellSize, useTerminalImageProtocol, useTerminalImages } from '../ui.js';
+import measureElement from '../ink/measure-element.js';
+import { useTerminalSize } from '../ink/hooks/use-terminal-size.js';
+import { INLINE_MEDIA_MAX, inlineMediaPlaceholder, layoutInlineMedia } from '../math/inline-layout.js';
+import { peekMathRaster, renderMathRaster } from '../math/renderer.js';
+import { getTheme } from '../theme.js';
+import { formatToken } from '../terminal-utils/markdown.js';
+import { isMathToken, renderInlineMath } from '../terminal-utils/math.js';
+import { useTerminalBackground, useTheme } from './design-system/ThemeProvider.js';
+import { themeInkHex } from './MathBlock.js';
+import { getMathImageBacking, subscribeMathImageBacking } from '../tuiDisplayPrefs.js';
+import { useMathPreviewOpener } from './mathPreview.js';
+const WIDTH_PROBE = ' '.repeat(1024);
+/** Distinct widths applied before measurement freezes (see Divider). */
+const MAX_APPLIED_MEASUREMENTS = 4;
+export function InlineMathParagraph({ token, highlight }) {
+    const plain = React.useMemo(() => formatToken(token, 0, null, null, highlight).trim(), [token, highlight]);
+    const formulas = React.useMemo(() => collectInlineMath(token).slice(0, INLINE_MEDIA_MAX), [token]);
+    const graphics = useTerminalImages(formulas.length > 0);
+    const protocol = useTerminalImageProtocol();
+    const cellSize = useTerminalImageCellSize();
+    const [themeName] = useTheme();
+    const color = themeInkHex(getTheme(themeName).text);
+    const previewMath = useMathPreviewOpener();
+    const backdrop = React.useSyncExternalStore(subscribeMathImageBacking, getMathImageBacking);
+    const composited = backdrop === 'terminal';
+    const terminalBackground = useTerminalBackground();
+    const width = useMeasuredWidth();
+    const requests = React.useMemo(() => {
+        if (!graphics || (protocol !== 'kitty' && protocol !== 'sixel') || cellSize === undefined || color === undefined)
+            return undefined;
+        if (width.value === undefined || formulas.length === 0)
+            return undefined;
+        return formulas.map(formula => ({
+            tex: formula.text, display: false, color, cellSize, maxColumns: width.value, maxRows: 1,
+        }));
+    }, [graphics, protocol, cellSize, color, width.value, formulas]);
+    const results = useSettledRasters(requests);
+    const layout = React.useMemo(() => {
+        if (results === undefined || width.value === undefined)
+            return undefined;
+        const media = [];
+        const slot = new Map();
+        formulas.forEach((formula, index) => {
+            const result = results[index];
+            // Failures and formulas that did not fit one row keep their Unicode.
+            if (!result.ok || result.raster.rows !== 1)
+                return;
+            slot.set(formula, inlineMediaPlaceholder(media.length, result.raster.columns));
+            media.push({ formula, raster: result.raster });
+        });
+        if (media.length === 0)
+            return undefined;
+        const formatted = formatToken(withPlaceholders(token, slot), 0, null, null, highlight).trim();
+        const rows = layoutInlineMedia(formatted, width.value, media.map(entry => entry.raster.columns));
+        return rows === undefined ? undefined : { rows, media };
+    }, [results, width.value, formulas, token, highlight]);
+    return (_jsxs(Box, { ref: width.ref, flexDirection: "column", children: [_jsx(Box, { height: 0, overflow: "hidden", children: _jsx(Text, { wrap: "truncate", children: WIDTH_PROBE }) }), layout === undefined
+                ? _jsx(Text, { children: plain })
+                : layout.rows.map((row, rowIndex) => (_jsx(Box, { flexDirection: "row", height: 1, softWrapContinuation: row.continuation ? layout.rows[rowIndex - 1]?.width : undefined, children: row.pieces.map((piece, pieceIndex) => {
+                        if (piece.kind === 'text') {
+                            return (_jsx(Box, { width: piece.width, flexShrink: 0, children: _jsx(Text, { wrap: "truncate", children: piece.text }) }, `t${pieceIndex}`));
+                        }
+                        const { formula, raster } = layout.media[piece.index];
+                        // Keyed by the formula slot, so an unchanged layout keeps the
+                        // same image node (placements follow node identity). The
+                        // transcript presentation is what lets Sixel paint the one-row
+                        // slot at all, and crops instead of dropping it at a viewport
+                        // edge — the same contract block formulas use.
+                        const formulaRequest = requests?.[piece.index];
+                        const painted = (_jsx(Image, { ...(composited ? {} : { transparent: true }), presentation: "transcript", source: raster.source, width: piece.columns, height: 1, alt: formula.text, copyText: formula.raw, children: _jsx(Text, { dimColor: true, wrap: "truncate", children: renderInlineMath(formula.text) ?? formula.raw }) }));
+                        const image = composited
+                            ? (_jsx(Box, { width: piece.columns, height: 1, flexShrink: 0, backgroundColor: terminalBackground, children: painted }))
+                            : painted;
+                        return previewMath === undefined || formulaRequest === undefined
+                            ? _jsx(React.Fragment, { children: image }, `m${piece.index}:${raster.key}`)
+                            : (_jsx(Box, { onClick: event => { event.stopImmediatePropagation(); previewMath({ tex: formula.text, request: formulaRequest, source: raster.source }); }, children: image }, `m${piece.index}:${raster.key}`));
+                    }) }, rowIndex)))] }));
+}
+/** Inline math tokens of a paragraph, in reading order. */
+function collectInlineMath(token) {
+    const found = [];
+    const walk = (tokens) => {
+        for (const child of tokens ?? []) {
+            if (isMathToken(child))
+                found.push(child);
+            else
+                walk(child.tokens);
+        }
+    };
+    walk(token.tokens);
+    return found;
+}
+/** A copy of `token` whose listed math tokens format as placeholder runs. */
+function withPlaceholders(token, slot) {
+    const children = token.tokens;
+    if (children === undefined)
+        return token;
+    return {
+        ...token,
+        tokens: children.map(child => {
+            const placeholder = isMathToken(child) ? slot.get(child) : undefined;
+            return placeholder !== undefined
+                ? { type: 'escape', raw: child.raw, text: placeholder }
+                : withPlaceholders(child, slot);
+        }),
+    };
+}
+/**
+ * Results for every request once all have settled; a cached set is used on
+ * the first render (a paragraph scrolled back into view switches at once).
+ */
+function useSettledRasters(requests) {
+    const key = requests === undefined ? undefined : requests.map(requestKey).join('\u0001');
+    const cached = React.useMemo(() => {
+        if (requests === undefined)
+            return undefined;
+        const peeked = requests.map(peekMathRaster);
+        return peeked.every(result => result !== undefined) ? peeked : undefined;
+        // `key` captures every field of every request.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [key]);
+    const [settled, setSettled] = React.useState();
+    React.useEffect(() => {
+        if (requests === undefined || cached !== undefined || key === undefined)
+            return;
+        let live = true;
+        void Promise.all(requests.map(renderMathRaster)).then(results => {
+            if (live)
+                setSettled({ key, results });
+        });
+        return () => { live = false; };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [key]);
+    if (cached !== undefined)
+        return cached;
+    return settled !== undefined && settled.key === key ? settled.results : undefined;
+}
+function requestKey(request) {
+    return [request.tex, request.color, request.cellSize.width, request.cellSize.height, request.maxColumns, request.maxRows].join('\u0000');
+}
+/**
+ * The laid-out width of the paragraph box. Its width comes from the parent,
+ * not from its content, but the guard from Divider still bounds how many
+ * distinct widths are applied per terminal width in case a layout ever
+ * feeds back.
+ */
+function useMeasuredWidth() {
+    const { columns } = useTerminalSize();
+    const ref = React.useRef(null);
+    const [value, setValue] = React.useState();
+    const negotiation = React.useRef({ columns, applied: [], frozen: false });
+    React.useLayoutEffect(() => {
+        const node = ref.current;
+        if (node === null)
+            return;
+        const state = negotiation.current;
+        if (state.columns !== columns) {
+            state.columns = columns;
+            state.applied = [];
+            state.frozen = false;
+        }
+        if (state.frozen)
+            return;
+        const measured = Math.floor(measureElement(node).width);
+        if (measured <= 0 || measured === value)
+            return;
+        if (state.applied.includes(measured) || state.applied.length >= MAX_APPLIED_MEASUREMENTS) {
+            state.frozen = true;
+            return;
+        }
+        state.applied.push(measured);
+        setValue(measured);
+    });
+    return { ref, value };
+}

package/lib/types/components/LogoV2.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 import { type Tip } from '../tips.js';
 import { type UpstreamDriftSummary } from '../dsh-adapter/contract.js';
+import { type SplashEgg } from './splashEggs.js';
 import { type WhaleIntroId } from './whaleFrames.js';
 /**
  * The header splash: one layout, two phases. The **opening** (~1.7–3.5s,
@@ -14,12 +15,23 @@ import { type WhaleIntroId } from './whaleFrames.js';
  *
  * Layout: the 13-row pixel whale beside a text column of matching height —
  * the `✦ dsh-TUI` wordmark with version, the `DEEPSEEK`/`HARNESS` tagline in
- * the 5-row block font (brand-blue → ice gradient), the model/effort and
+ * the 5-row block font (brand-blue → ice gradient, a blank row between the
+ * two words, both stretched to the same width — see `splashFonts.ts` for the
+ * eight faces and the per-face kerning), the model/effort and
  * cwd in plain text (no brand-color highlight), the startup tip, and below
  * the whale the welcome tagline, centered under the art, in ice
- * blue. Narrow terminals drop the whale and keep the text column.
+ * blue. Narrow terminals climb down the `resolveSplashLayout` ladder —
+ * whale + big text, then the big text alone, then the whale alone, then one
+ * plain title line. The face rotates by local date (`pickSplashFont`), so a
+ * given day always shows the same one.
+ *
+ * Two easter eggs sit on top of that layout without changing it (both live in
+ * `splashEggs.ts`): the holiday word pair swaps the two big-text words on its
+ * date (`MERRY` on 12/25, …), and a 1-in-20 roll replaces the welcome tagline
+ * with a clickable "star us on GitHub" line whose indent is recomputed from
+ * its own width.
  */
-export declare function LogoV2({ model, effort, cwd, skipIntro, intro, tip, whale, whaleIdle, working, drift, }: {
+export declare function LogoV2({ model, effort, cwd, skipIntro, intro, tip, fontId, whale, whaleIdle, whaleGirl, starred, starReveal, onStarClick, working, drift, egg, starChance, }: {
     model: string;
     effort?: string | undefined;
     cwd: string;
@@ -27,10 +39,36 @@ export declare function LogoV2({ model, effort, cwd, skipIntro, intro, tip, whal
     skipIntro?: boolean;
     /** Test seam: pin the intro animation instead of rolling one at startup. */
     intro?: WhaleIntroId;
+    /** Big-text face id (settings `dsh-tui.splashFont`); undefined → the
+     * date-rotated `pickSplashFont()`. */
+    fontId?: string | undefined;
     /** Test seam: pin the startup tip line (probes need a deterministic tip). */
     tip?: Tip;
+    /** Test seam: pin the holiday word pair instead of reading the local date
+     * (`null` forces the normal words; `undefined` — production — rolls by
+     * date). See `splashEggs.ts`. */
+    egg?: SplashEgg | null;
+    /** Test seam: pin the star tagline's chance (1 forces the egg, 0 suppresses
+     * it; production rolls `SPLASH_STAR_CHANCE` once per mount). */
+    starChance?: number;
     /** Show the pixel whale art (settings `dsh-tui.whale`); off → text-only header. */
     whale?: boolean;
+    /** Swap the header's pixel whale for the maid portrait (settings
+     * `dsh-tui.whaleGirl`; off by default). The portrait renders FIRST as a
+     * real raster through the terminal image protocols (Kitty/Sixel —
+     * `maidPortrait.tsx`), keeping the art's full fidelity; when the terminal
+     * cannot (inline mode, unsupported protocol, decode failure) the
+     * character-art maid (`WhaleGirl.tsx`, the author's placeholder to be
+     * replaced with better art) takes the slot. Both forms are static, so
+     * `whaleIdle` only animates the whale. */
+    whaleGirl?: boolean;
+    /** 本次会话已经 star 过：彩蛋标题换成「捡到一颗小星星啦」，不再重复求。 */
+    starred?: boolean;
+    /** 彩蛋渐显的测试缝：`instant` 时三行一次画全（静态渲染夹具用；真机不传）。 */
+    starReveal?: 'instant';
+    /** 求 star 标语那一行被点击时执行（一键 star，与 `/star` / `Alt+S` 同一个
+     * 动作）。不传则那一行不可点——只有它出现时才有这个交互。 */
+    onStarClick?: () => void;
     /** Welcome-phase idle whale behaviors — fin flutters, tail thumps,
      * sleep after inactivity (settings `dsh-tui.whaleIdle`; on by default —
      * an explicit `false` keeps the settled header timer-free). Click-hearts

package/lib/types/components/LogoV2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LogoV2.d.ts","sourceRoot":"","sources":["../../../src/components/LogoV2.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAiB,KAAK,GAAG,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAoD,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAYxH,OAAO,EAA+E,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAsDjI;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CAAC,EACrB,KAAK,EACL,MAAM,EACN,GAAG,EACH,SAAiB,EACjB,KAAK,EACL,GAAG,EACH,KAAY,EACZ,SAAgB,EAChB,OAAe,EACf,KAAK,GACN,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,GAAG,CAAA;IACT,mFAAmF;IACnF,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;4CAGwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;mCAG+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;2EACuE;IACvE,KAAK,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAA;CACpC,GAAG,KAAK,CAAC,SAAS,CAqOlB"}
+{"version":3,"file":"LogoV2.d.ts","sourceRoot":"","sources":["../../../src/components/LogoV2.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAiB,KAAK,GAAG,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAoD,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAWxH,OAAO,EAAiC,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAQ/E,OAAO,EAA+E,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAA;AA+CjI;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,MAAM,CAAC,EACrB,KAAK,EACL,MAAM,EACN,GAAG,EACH,SAAiB,EACjB,KAAK,EACL,GAAG,EACH,MAAM,EACN,KAAY,EACZ,SAAgB,EAChB,SAAiB,EACjB,OAAe,EACf,UAAU,EACV,WAAW,EACX,OAAe,EACf,KAAK,EACL,GAAG,EACH,UAAU,GACX,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB;0CACsC;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,6EAA6E;IAC7E,GAAG,CAAC,EAAE,GAAG,CAAA;IACT;;qCAEiC;IACjC,GAAG,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;IACtB;oEACgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mFAAmF;IACnF,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;;;;8CAO0C;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,gDAAgD;IAChD,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB;sCACkC;IAClC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB;;;4CAGwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;mCAG+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;2EACuE;IACvE,KAAK,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAA;CACpC,GAAG,KAAK,CAAC,SAAS,CAgZlB"}

package/lib/types/components/LogoV2.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import React from 'react';
 import { getLang, t as tr, tOr } from '../i18n.js';
 import { pickRandomTip } from '../tips.js';
@@ -6,14 +6,21 @@ import { upstreamDriftSummary, UPSTREAM_VALIDATED_VERSION } from '../dsh-adapter
 import { readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { Box, Text, useAnimationFrame, useTerminalSize } from '../ui.js';
+import { Box, Text, useAnimationFrame, useTerminalImages, useTerminalSize } from '../ui.js';
 import { getTheme } from '../theme.js';
 import { useTheme } from './design-system/ThemeProvider.js';
 import { parseRGB } from './Spinner/spinnerUtils.js';
 import { renderBigText } from './bigfont.js';
+import { COLUMN_GAP, WHALE_BOX_WIDTH, resolveSplashLayout } from './splashLayout.js';
+import { withTagline, pickSplashFont, splashFontById } from './splashFonts.js';
+import { pickSplashEgg, splashStarLine } from './splashEggs.js';
+import { isHistoricMilestone, markStarAsked, pendingStarMilestone, recordLaunch, STAR_MILESTONES, usageSnapshot } from '../usageStats.js';
+import { effectiveComboDisplay } from '../utils/keymap.js';
 import { stringWidth } from '../ink/stringWidth.js';
 import { BRAND, FLASH, ICE, PALE, sweep } from './shimmer.js';
 import { STANDARD_FRAME_INDEX, WhaleArt } from './Whale.js';
+import { WhaleGirlArt } from './WhaleGirl.js';
+import { MAID_BOX_CENTER, MaidPortrait, useMaidPortraits } from './maidPortrait.js';
 import { OPENING_SEQUENCES, pickOpeningSequence, WHALE_FRAME_INDEX } from './whaleFrames.js';
 import { RESTING_POSE } from './whaleLayers.js';
 import { initialWhaleIdleState, nextWhaleIdleStep, } from './whaleIdle.js';
@@ -35,14 +42,6 @@ const VERSION = (() => {
         return '0.1.0';
     }
 })();
-/** Below this width the whale hides and the header goes text-only. */
-const WHALE_MIN_COLUMNS = 64;
-/**
- * Fixed whale box width: the tail-wag frames reach 4 columns further right
- * than the standard pose, and a pinned width keeps the text column from
- * shifting sideways during the opening animation.
- */
-const FULL_WHALE_WIDTH = 40;
 /**
  * Center of the whale art's bounding box: sprite columns 3..34 (center
  * 18.5) of the 40-wide box. The welcome tagline is indented so its own
@@ -54,6 +53,8 @@ const FULL_WHALE_WIDTH = 40;
  * centered under the art too.
  */
 const WHALE_CENTER = 18.5;
+/** 「高兴鲸娘」停留时长（点她之后自动回安静版）。 */
+const MAID_HAPPY_MS = 3000;
 /** `max` → `Max` (effort levels arrive lower-case from the adapter). */
 function capitalize(text) {
     return text.length === 0 ? text : text[0].toUpperCase() + text.slice(1);
@@ -70,12 +71,23 @@ function capitalize(text) {
  *
  * Layout: the 13-row pixel whale beside a text column of matching height —
  * the `✦ dsh-TUI` wordmark with version, the `DEEPSEEK`/`HARNESS` tagline in
- * the 5-row block font (brand-blue → ice gradient), the model/effort and
+ * the 5-row block font (brand-blue → ice gradient, a blank row between the
+ * two words, both stretched to the same width — see `splashFonts.ts` for the
+ * eight faces and the per-face kerning), the model/effort and
  * cwd in plain text (no brand-color highlight), the startup tip, and below
  * the whale the welcome tagline, centered under the art, in ice
- * blue. Narrow terminals drop the whale and keep the text column.
+ * blue. Narrow terminals climb down the `resolveSplashLayout` ladder —
+ * whale + big text, then the big text alone, then the whale alone, then one
+ * plain title line. The face rotates by local date (`pickSplashFont`), so a
+ * given day always shows the same one.
+ *
+ * Two easter eggs sit on top of that layout without changing it (both live in
+ * `splashEggs.ts`): the holiday word pair swaps the two big-text words on its
+ * date (`MERRY` on 12/25, …), and a 1-in-20 roll replaces the welcome tagline
+ * with a clickable "star us on GitHub" line whose indent is recomputed from
+ * its own width.
  */
-export function LogoV2({ model, effort, cwd, skipIntro = false, intro, tip, whale = true, whaleIdle = true, working = false, drift, }) {
+export function LogoV2({ model, effort, cwd, skipIntro = false, intro, tip, fontId, whale = true, whaleIdle = true, whaleGirl = false, starred = false, starReveal, onStarClick, working = false, drift, egg, starChance, }) {
     // One intro per logo mount: the production path rolls (startup splash
     // and each /deepseek replay roll independently), the `intro` seam pins
     // a specific animation for probes.
@@ -134,13 +146,52 @@ export function LogoV2({ model, effort, cwd, skipIntro = false, intro, tip, whal
             clearTimeout(timer);
         };
     }, [heartSeq, heartKey, settled, whaleIdle, whaleFrozen]);
+    /** 预览缝：`DSH_TUI_STAR_LINE=1` 时开屏就显示求 star 标语行（不记账）。 */
+    const starLinePreview = process.env.DSH_TUI_STAR_LINE === '1';
     const [themeName] = useTheme();
+    /** 终端真底色（Sixel 不透明衬底；见渲染处的注释）。 */
     const theme = getTheme(themeName);
     const { columns } = useTerminalSize();
     const wordmarkRGB = parseRGB(theme.accent) ?? BRAND;
     const wordmarkShimmerRGB = parseRGB(theme.accentShimmer) ?? ICE;
     const taglineRGB = parseRGB(theme.activity) ?? ICE;
-    const showWhale = whale && columns >= WHALE_MIN_COLUMNS;
+    // 按天轮换的大字字体：同一天内恒定、隔天换一款；`fontId`（设置项）可 pin 住一款。
+    const [dailyFont] = React.useState(() => pickSplashFont());
+    const font = fontId === undefined ? dailyFont : splashFontById(fontId);
+    // 节日彩蛋：本地日期整天恒定，每次 mount 只判一次（照 pickSplashFont 的写法）。
+    // 只换词——字身宽度不变、字距按新词重解，所以阶梯阈值也跟着当天真实标题宽度走。
+    const [dailyEgg] = React.useState(() => (egg === undefined ? pickSplashEgg() : egg));
+    const titleFont = dailyEgg === null ? font : withTagline(font, dailyEgg.top, dailyEgg.bottom);
+    // 窄终端阶梯：鲸鱼 + 大字 → 纯大字 → 纯鲸鱼 → 一行纯文字（阈值随字体字身宽度变）。
+    const { showWhale, showBigTitle, showPlainTitle } = resolveSplashLayout(columns, { whale, font: titleFont });
+    // 女仆娘档优先走**真图**（Kitty/Sixel 终端图像协议，见 `maidPortrait.tsx`）；
+    // 协议不可用（内联模式、终端不支持）或资产解码失败时，回落到字符画版
+    // 女仆娘（`WhaleGirl.tsx` 半块精灵——作者占位，之后会换更好看的）。
+    // 两种形态都是静态立绘：闲置动画与点击爱心仍是鲸鱼专属。
+    // `maidImageActive` 只在「真图画出来了」时为真。
+    const imagesAvailable = useTerminalImages(whaleGirl);
+    const portraits = useMaidPortraits(whaleGirl && imagesAvailable);
+    const maidSource = portraits?.normal;
+    const maidImageActive = whaleGirl && imagesAvailable && maidSource !== undefined;
+    // 点一下她 → 换成「高兴鲸娘」几秒（自动回安静版；第一个任务后定格、
+    // 不再响应，与鲸鱼的规则一致）。定时器在卸载/重挂时清掉。
+    const [maidHappy, setMaidHappy] = React.useState(false);
+    const maidHappyTimerRef = React.useRef(null);
+    const reactMaid = React.useCallback(() => {
+        setMaidHappy(true);
+        if (maidHappyTimerRef.current !== null)
+            clearTimeout(maidHappyTimerRef.current);
+        const timer = setTimeout(() => {
+            maidHappyTimerRef.current = null;
+            setMaidHappy(false);
+        }, MAID_HAPPY_MS);
+        timer.unref?.();
+        maidHappyTimerRef.current = timer;
+    }, []);
+    React.useEffect(() => () => {
+        if (maidHappyTimerRef.current !== null)
+            clearTimeout(maidHappyTimerRef.current);
+    }, []);
     // Welcome-phase idle behaviors (settings `dsh-tui.whaleIdle`): fin
     // flutters, tail thumps and blinks while idle, and a sleep-Z loop after
     // sustained inactivity — all as INDEPENDENT layers composed per tick
@@ -156,7 +207,9 @@ export function LogoV2({ model, effort, cwd, skipIntro = false, intro, tip, whal
     const pendingHeartRef = React.useRef(false);
     const tickRef = React.useRef(null);
     React.useEffect(() => {
-        if (!settled || !whaleIdle || !showWhale || whaleFrozen) {
+        // 女仆娘档（真图或字符画）没有闲置规划器：立绘是静态的，开屏定格
+        // 后不给她留任何定时器。
+        if (!settled || !whaleIdle || !showWhale || whaleFrozen || whaleGirl) {
             setIdlePose(null);
             tickRef.current = null;
             return;
@@ -187,7 +240,7 @@ export function LogoV2({ model, effort, cwd, skipIntro = false, intro, tip, whal
             if (timer !== undefined)
                 clearTimeout(timer);
         };
-    }, [settled, whaleIdle, showWhale, working, whaleFrozen]);
+    }, [settled, whaleIdle, showWhale, working, whaleFrozen, whaleGirl]);
     // Render priority: the layered planner pose owns the settled header while
     // it runs (hearts and blinks compose over the body planes). Otherwise a
     // click heart plays as whole heart frames over the intro — or over the
@@ -201,6 +254,55 @@ export function LogoV2({ model, effort, cwd, skipIntro = false, intro, tip, whal
     // off-screen, leaving the static gradient behind.
     const t = settled ? 0 : time;
     const tagline = tr('logo-tagline');
+    // 求 star 改由**本机用量里程碑**触发（累计启动次数 / 累计在线时长），不再每次随机：
+    // 跨档时只报最高那一档、每档只报一次（`usageStats` 记账）。`starChance` 退化成测试缝
+    // ——0 关掉、非 0 强开（强开时用最高那档的文案）。`DSH_TUI_STAR_LINE=1`
+    // 是给人看效果的预览缝：强开标语行且**不记账**（生产不设这个变量）。
+    const [starMilestone] = React.useState(() => {
+        const usage = recordLaunch();
+        if (starLinePreview)
+            return STAR_MILESTONES.length - 1;
+        if (starChance === 0)
+            return null;
+        if (starChance !== undefined)
+            return STAR_MILESTONES.length - 1;
+        const pending = pendingStarMilestone(usage);
+        // 历史性时刻（99h / 999 次）不走标语行——那两档归 Chat 的开屏弹窗
+        //（弹窗自己 markStarAsked）。这里既不画也不记，档位保持待报；
+        // 弹窗这轮没机会弹（回合中等）就留给下一次启动。
+        return pending !== null && isHistoricMilestone(pending) ? null : pending;
+    });
+    const starLine = starMilestone === null
+        ? null
+        : splashStarLine({ usage: usageSnapshot(), keyHint: effectiveComboDisplay('star'), caught: starred });
+    // 彩蛋的渐显：标题先出，数字一秒后、求星行两秒后各跟一行（只在标语块
+    // 出现时播一次；本次会话已 star 过、或重挂时直接展开）。
+    const starLineActive = starLine !== null;
+    const starRevealInstant = starReveal === 'instant';
+    const [revealed, setRevealed] = React.useState(() => (starRevealInstant ? 2 : 0));
+    React.useEffect(() => {
+        if (!starLineActive)
+            return;
+        if (starRevealInstant || starred === true) {
+            setRevealed(2);
+            return;
+        }
+        const timers = [
+            setTimeout(() => setRevealed(previous => Math.max(previous, 1)), 1000),
+            setTimeout(() => setRevealed(previous => Math.max(previous, 2)), 2000),
+        ];
+        for (const timer of timers)
+            timer.unref?.();
+        return () => { for (const timer of timers)
+            clearTimeout(timer); };
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- 只在标语块出现时播一次
+    }, [starLineActive]);
+    // 显示过就把这一档记下来，下次启动不再冒出来（同档只求一次）。预览缝
+    // （`DSH_TUI_STAR_LINE=1`）不记账——那是给人看效果的，不该消耗档位。
+    React.useEffect(() => {
+        if (starMilestone !== null && !starLinePreview)
+            markStarAsked(starMilestone);
+    }, [starMilestone]);
     // One random tip per mount: the settled header must not re-roll on every
     // repaint (language switch, terminal resize), or the line would flicker.
     // `tip` is a test seam; production always passes undefined and rolls.
@@ -209,20 +311,42 @@ export function LogoV2({ model, effort, cwd, skipIntro = false, intro, tip, whal
     // the same memoized contract data the adapter checks (undefined when the
     // install matches). `drift` is a test seam to pin or suppress it.
     const [driftLine] = React.useState(() => drift === undefined ? upstreamDriftSummary() : drift);
-    // Indent that centers the tagline under the whale art's bounding box.
+    // Indent that centers the tagline under the whale art's bounding box, from
+    // the width the line ACTUALLY shows: the star easter egg renders a longer
+    // line than `logo-tagline`, so reusing the tagline's width would push it
+    // visibly off-center.
+    const welcomeWidth = starLine === null ? stringWidth(tagline) : starLine.width;
     const welcomePad = showWhale
-        ? Math.max(0, Math.round(WHALE_CENTER - stringWidth(tagline) / 2))
+        ? Math.max(0, Math.round((whaleGirl ? MAID_BOX_CENTER : WHALE_CENTER) - welcomeWidth / 2))
         : 2;
-    const bigDeepSeek = renderBigText('DEEPSEEK', t, wordmarkRGB, taglineRGB, FLASH, 60);
-    const bigHarness = renderBigText('HARNESS', t, taglineRGB, PALE, FLASH, 60);
-    return (_jsxs(Box, { ref: ref, flexDirection: "column", marginTop: 1, children: [_jsxs(Box, { flexDirection: "row", gap: 2, width: "100%", alignItems: "center", children: [showWhale && (_jsx(Box, { flexShrink: 0, onClick: () => {
+    // 两行标题各自用字体声明的字距；下排再按 `bottomIndent` 居中——
+    // 两者一起保证画出来的列数相等（见 splashFonts 的 tagline 契约）。
+    // 节日彩蛋换的就是这里的两排词（`titleFont` 已按当天词对重解字距）；字体若自带
+    // 配色（半立体那款的灰阶）就用它，否则沿用主题的 accent→activity。
+    const { top, bottom, topKerning, bottomKerning, bottomIndent } = titleFont.tagline;
+    const bigDeepSeek = renderBigText(titleFont, top, t, titleFont.palette?.from ?? wordmarkRGB, titleFont.palette?.to ?? taglineRGB, FLASH, 60, topKerning);
+    const bigHarness = renderBigText(titleFont, bottom, t, titleFont.palette?.from ?? taglineRGB, titleFont.palette?.to ?? PALE, FLASH, 60, bottomKerning, bottomIndent);
+    // 立绘槽位的**唯一真源**：文字列的实际行数——词标 1 + 两排大字 + 两排
+    // 之间空 1 行 + 模型/目录/提示 3 行。槽位与它等高，图片既不压过文字列
+    // 也不留一截在下面（实机反馈「超出去、不和谐」）；大字换字体/换词时也
+    // 自动跟着变，不写死 15。
+    const textColumnRows = bigDeepSeek.length + bigHarness.length + 5;
+    return (_jsxs(Box, { ref: ref, flexDirection: "column", marginTop: 1, children: [_jsxs(Box, { flexDirection: "row", gap: COLUMN_GAP, width: "100%", alignItems: "center", children: [showWhale && (_jsx(Box, { flexShrink: 0, onClick: () => {
                             // Frozen (first task started): the whale is a static logo —
                             // clicks do nothing. Settled: the layered planner consumes the
                             // click on its next tick — run that tick immediately so the
                             // heart shows instantly instead of after the current delay.
-                            // Intro: the whole-frame heart pass above.
+                            // Intro: the whole-frame heart pass above. The maid (raster)
+                            // reacts with the happy portrait instead of hearts; character-
+                            // art fallback stays static.
                             if (whaleFrozen)
                                 return;
+                            if (maidImageActive) {
+                                reactMaid();
+                                return;
+                            }
+                            if (whaleGirl)
+                                return;
                             if (settled && whaleIdle) {
                                 pendingHeartRef.current = true;
                                 tickRef.current?.();
@@ -231,9 +355,9 @@ export function LogoV2({ model, effort, cwd, skipIntro = false, intro, tip, whal
                                 setHeartSeq(0);
                                 setHeartKey(k => k + 1);
                             }
-                        }, children: _jsx(WhaleArt, { frameIndex: frameIndex, pose: settled && whaleIdle && !whaleFrozen ? (idlePose ?? RESTING_POSE) : undefined, width: FULL_WHALE_WIDTH }) })), _jsxs(Box, { flexDirection: "column", flexShrink: 1, children: [_jsxs(Text, { wrap: "truncate-end", children: [sweep('✦ dsh-TUI', t, wordmarkRGB, wordmarkShimmerRGB, 60), _jsx(Text, { dimColor: true, children: '  v' + VERSION })] }), bigDeepSeek.map((row, index) => (_jsx(Text, { wrap: "truncate-end", children: row }, `ds-${index}`))), bigHarness.map((row, index) => (_jsx(Text, { wrap: "truncate-end", children: row }, `h-${index}`))), _jsxs(Text, { wrap: "truncate-end", children: [model, effort !== undefined && _jsx(Text, { dimColor: true, children: ' · ' + capitalize(effort) + ' effort' })] }), _jsx(Text, { dimColor: true, wrap: "truncate-end", children: cwd }), _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { dimColor: true, children: tr('logo-tip-prefix') }), getLang() === 'zh' ? randomTip.zh : randomTip.en, _jsx(Text, { dimColor: true, children: ' · /tips ' + tr('logo-tip-more') })] }), driftLine != null && (_jsxs(Text, { color: "warning", wrap: "wrap", children: ["\u26A0", ' ', tOr(`logo-drift-${driftLine.kind}`, `The dsh engine (${driftLine.versions.join(' / ')}) does not match the validated ${UPSTREAM_VALIDATED_VERSION}; reinstall via npm i -g @deepseek-ai/dsh@${UPSTREAM_VALIDATED_VERSION}.`, {
+                        }, children: whaleGirl ? (_jsx(Box, { width: WHALE_BOX_WIDTH, height: textColumnRows, flexDirection: "row", justifyContent: "center", alignItems: "center", children: maidImageActive ? (_jsx(MaidPortrait, { source: maidHappy ? (portraits?.happy ?? maidSource) : maidSource, maxColumns: WHALE_BOX_WIDTH, maxRows: textColumnRows, presentation: "transcript" })) : (_jsx(WhaleGirlArt, { width: WHALE_BOX_WIDTH })) })) : (_jsx(WhaleArt, { frameIndex: frameIndex, pose: settled && whaleIdle && !whaleFrozen ? (idlePose ?? RESTING_POSE) : undefined, width: WHALE_BOX_WIDTH })) })), (showBigTitle || showPlainTitle) && (_jsxs(Box, { flexDirection: "column", flexShrink: 1, children: [_jsxs(Text, { wrap: "truncate-end", children: [sweep('✦ dsh-TUI', t, wordmarkRGB, wordmarkShimmerRGB, 60), _jsx(Text, { dimColor: true, children: '  v' + VERSION })] }), showBigTitle ? (_jsxs(_Fragment, { children: [bigDeepSeek.map((row, index) => (_jsx(Text, { wrap: "truncate-end", children: row }, `ds-${index}`))), _jsx(Box, { height: 1 }), bigHarness.map((row, index) => (_jsx(Text, { wrap: "truncate-end", children: row }, `h-${index}`)))] })) : (showPlainTitle && (_jsx(Text, { color: "accent", bold: true, wrap: "truncate-end", children: "DeepSeek Harness" }))), _jsxs(Text, { wrap: "truncate-end", children: [model, effort !== undefined && _jsx(Text, { dimColor: true, children: ' · ' + capitalize(effort) + ' effort' })] }), _jsx(Text, { dimColor: true, wrap: "truncate-end", children: cwd }), _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { dimColor: true, children: tr('logo-tip-prefix') }), getLang() === 'zh' ? randomTip.zh : randomTip.en, _jsx(Text, { dimColor: true, children: ' · /tips ' + tr('logo-tip-more') })] }), driftLine != null && (_jsxs(Text, { color: "warning", wrap: "wrap", children: ["\u26A0", ' ', tOr(`logo-drift-${driftLine.kind}`, `The dsh engine (${driftLine.versions.join(' / ')}) does not match the validated ${UPSTREAM_VALIDATED_VERSION}; reinstall via npm i -g @deepseek-ai/dsh@${UPSTREAM_VALIDATED_VERSION}.`, {
                                         installed: driftLine.versions.join(' / '),
                                         validated: UPSTREAM_VALIDATED_VERSION,
                                         primary: UPSTREAM_VALIDATED_VERSION,
-                                    })] }))] })] }), _jsx(Box, { marginTop: 1, paddingLeft: welcomePad, children: _jsx(Text, { children: sweep(tagline, t, taglineRGB, FLASH, 60) }) })] }));
+                                    })] }))] }))] }), _jsx(Box, { flexDirection: "column", marginTop: 1, ...(starLine === null || onStarClick === undefined ? {} : { onClick: onStarClick }), children: starLine === null ? (_jsx(Box, { paddingLeft: welcomePad, children: _jsx(Text, { children: sweep(tagline, t, taglineRGB, FLASH, 60) }) })) : (_jsxs(_Fragment, { children: [_jsx(Box, { paddingLeft: welcomePad, children: _jsx(Text, { children: sweep(starLine.title, t, taglineRGB, FLASH, 60) }) }), revealed >= 1 && (_jsx(Box, { paddingLeft: welcomePad, children: _jsx(Text, { dimColor: true, children: starLine.stats }) })), revealed >= 2 && starred !== true && starLine.ask !== null && (_jsx(Box, { paddingLeft: welcomePad, children: _jsx(Text, { children: starLine.ask }) }))] })) })] }));
 }

package/lib/types/components/Markdown.d.ts

@@ -4,8 +4,9 @@ import { type Token } from 'marked';
  * Markdown 渲染组件：marked 分词 + ANSI 格式化。
  *
  * 表格 token 交给 MarkdownTable 渲染为带边框的 flexbox 布局，mermaid
- * 代码块交给 MermaidDiagram 画成 box-drawing 图（两者都需要终端宽度，
- * 所以是独立节点而不是 ANSI 字符串）；
+ * 代码块交给 MermaidDiagram 画成 box-drawing 图，`$$` 公式块交给
+ * MathBlock 排成多行 Unicode（三者都需要终端宽度，所以是独立节点而不是
+ * ANSI 字符串）；行内公式在 formatToken 里转成单行 Unicode；
  * 其余块级内容由 formatToken 转成 ANSI 字符串，按块边界分批放进
  * Text（只去整段首尾空白）。代码块高亮由 cli-highlight 异步提供，
  * 加载完成后自动触发一次重渲染。无 markdown 语法的纯文本走快速
@@ -17,6 +18,12 @@ type Props = {
     dimColor?: boolean;
     /** 为 false 时跳过 token 缓存（流式尾部的内容逐帧变化，缓存必然失效） */
     cacheTokens?: boolean;
+    /**
+     * Whether paragraphs may show inline math as images (`mathRendering:
+     * image`). Streaming text passes false: a paragraph switching to images
+     * mid-stream would re-wrap under the reader; the settled message switches.
+     */
+    inlineMathImages?: boolean;
 };
 /**
  * Tokens that render as their own layout node (a width-aware component)
@@ -36,7 +43,7 @@ export declare function isStandaloneToken(token: Token): boolean;
  * block — the dominant long-output stall (string-width via wrap-ansi, 60%+
  * of CPU in streaming profiles).
  */
-declare function MarkdownImpl({ children, dimColor, cacheTokens }: Props): React.ReactNode;
+declare function MarkdownImpl({ children, dimColor, cacheTokens, inlineMathImages }: Props): React.ReactNode;
 /**
  * Memoized Markdown: skips the whole token→ANSI→layout pipeline when the
  * content string is the same reference (see MarkdownImpl's doc comment).

package/lib/types/components/Markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Markdown.d.ts","sourceRoot":"","sources":["../../../src/components/Markdown.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAU,KAAK,KAAK,EAAe,MAAM,QAAQ,CAAA;AAQxD;;;;;;;;;;GAUG;AAEH,KAAK,KAAK,GAAG;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AA4ED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEvD;AAgFD;;;;;;;;;;GAUG;AACH,iBAAS,YAAY,CAAC,EAAE,QAAQ,EAAE,QAAgB,EAAE,WAAkB,EAAE,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CA6BhG;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,gDAMpB,CAAA"}
+{"version":3,"file":"Markdown.d.ts","sourceRoot":"","sources":["../../../src/components/Markdown.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAU,KAAK,KAAK,EAAe,MAAM,QAAQ,CAAA;AAYxD;;;;;;;;;;;GAWG;AAEH,KAAK,KAAK,GAAG;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B,CAAA;AAyED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEvD;AAuGD;;;;;;;;;;GAUG;AACH,iBAAS,YAAY,CAAC,EAAE,QAAQ,EAAE,QAAgB,EAAE,WAAkB,EAAE,gBAAuB,EAAE,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CAkCzH;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,gDAOpB,CAAA"}