pi-firecode 0.8.1 → 1.0.0

package/flame.ts

@@ -0,0 +1,149 @@
+/**
+ * 火焰动效：全局唯一动画时钟、盲文火苗与落定过渡。凡是“正在运行”的东西都用这里的火苗；
+ * 所有动效由同一个时钟驱动，没有订阅者时计时器停止，帧号取绝对时间，多处火苗天然同步。
+ */
+export type Rgb = readonly [number, number, number];
+
+/** 火焰色板：heat 从余烬烧到白金；ash 是横幅副标题淡入的终色灰。 */
+export const HEAT_COLORS = {
+	ember: [110, 30, 22],
+	red: [255, 47, 32],
+	orange: [255, 119, 28],
+	gold: [255, 195, 61],
+	white: [255, 239, 184],
+	ash: [128, 123, 115],
+	green: [124, 196, 120],
+	fail: [226, 78, 66],
+} as const satisfies Record<string, Rgb>;
+
+const FPS = 12;
+const FRAME_MS = 1000 / FPS;
+const SETTLE_MS = 400;
+/** 一格火苗与三格火苗的火舌高度轮廓（每格两个点列）。 */
+const PROFILE = { 1: [0.75, 1], 3: [0.3, 0.6, 0.9, 1, 0.7, 0.35] } as const;
+// 盲文点位：左列自上而下 1 2 3 7，右列 4 5 6 8。
+const DOT = [
+	[0x01, 0x02, 0x04, 0x40],
+	[0x08, 0x10, 0x20, 0x80],
+] as const;
+const HEAT_STOPS: readonly [number, Rgb][] = [
+	[0, HEAT_COLORS.ember],
+	[0.3, HEAT_COLORS.red],
+	[0.55, HEAT_COLORS.orange],
+	[0.8, HEAT_COLORS.gold],
+	[1, HEAT_COLORS.white],
+];
+
+const listeners = new Set<() => void>();
+let timer: ReturnType<typeof setInterval> | undefined;
+
+/** 订阅动画帧；返回取消函数。最后一个订阅者离开时计时器随之停止。 */
+export function onFrame(listener: () => void): () => void {
+	listeners.add(listener);
+	if (!timer) {
+		timer = setInterval(() => {
+			for (const notify of listeners) notify();
+		}, FRAME_MS);
+		timer.unref?.();
+	}
+	return () => {
+		listeners.delete(listener);
+		if (listeners.size || !timer) return;
+		clearInterval(timer);
+		timer = undefined;
+	};
+}
+
+/** 按帧量化的绝对秒数；所有火苗共用同一相位基准。 */
+const frameSeconds = () => Math.floor(Date.now() / FRAME_MS) / FPS;
+
+const clamp = (value: number) => Math.min(1, Math.max(0, value));
+const easeOut = (k: number) => 1 - (1 - clamp(k)) ** 3;
+
+export function mix(from: Rgb, to: Rgb, k: number): Rgb {
+	const t = clamp(k);
+	return [from[0] + (to[0] - from[0]) * t, from[1] + (to[1] - from[1]) * t, from[2] + (to[2] - from[2]) * t];
+}
+
+export function heat(value: number): Rgb {
+	const x = clamp(value);
+	for (let index = 1; index < HEAT_STOPS.length; index++) {
+		const [at, color] = HEAT_STOPS[index];
+		const [fromAt, from] = HEAT_STOPS[index - 1];
+		if (x <= at) return mix(from, color, (x - fromAt) / (at - fromAt));
+	}
+	return HEAT_COLORS.white;
+}
+
+/** 只设置/复位前景色，不注入全量 reset，可安全嵌进带背景的行。 */
+export function paint(color: Rgb, text: string): string {
+	return text ? `\x1b[38;2;${color[0] | 0};${color[1] | 0};${color[2] | 0}m${text}\x1b[39m` : "";
+}
+
+/** 三个不可公约频率叠加的火势，0.1–1 之间起伏。 */
+export function flicker(phase: number, t = frameSeconds()): number {
+	const tau = Math.PI * 2;
+	return 0.55
+		+ 0.2 * Math.sin(tau * (1.1 * t + phase))
+		+ 0.15 * Math.sin(tau * (2.7 * t + 1.7 * phase) + 1.3)
+		+ 0.1 * Math.sin(tau * (5.9 * t + 3.1 * phase) + 0.4);
+}
+
+/**
+ * 盲文火苗：每个点列是一根随时钟起伏的火舌，火尖随风摆，顶行只留一个点保持尖顶。
+ * phase 让并列的火苗错开。
+ */
+export function flame(cells: 1 | 3, phase: number): string {
+	const profile = PROFILE[cells];
+	const columns = cells * 2;
+	const t = frameSeconds();
+	const sway = Math.round(Math.sin(Math.PI * 2 * (0.7 * t + phase)) * 0.6);
+	const heights = Array.from({ length: columns }, (_, index) => {
+		const base = profile[Math.min(columns - 1, Math.max(0, index - sway))];
+		return Math.round(clamp(base * (0.7 + 0.45 * flicker(phase + index * 0.37, t))) * 4);
+	});
+	const peak = Math.max(...heights);
+	let topSeen = false;
+	let out = "";
+	for (let cell = 0; cell < cells; cell++) {
+		let bits = 0;
+		for (let side = 0; side < 2; side++) {
+			let height = heights[cell * 2 + side];
+			if (height === peak && height > 1) {
+				if (topSeen) height -= 1;
+				topSeen = true;
+			}
+			for (let row = 0; row < height; row++) bits |= DOT[side][3 - row];
+		}
+		const core = cells === 1 ? 0.5 : 1 - Math.abs(cell - (cells - 1) / 2) / cells;
+		const color = heat(0.35 + 0.45 * core + 0.2 * flicker(phase + cell, t));
+		out += paint(color, String.fromCodePoint(0x2800 + bits));
+	}
+	return out;
+}
+
+export type Settle = "done" | "failed";
+
+/**
+ * 落定标记：歇下那一刻就是 ✓/✗（与定格文字同帧出现，不留冷却中的火苗残帧），颜色在 0.4 秒内从火焰橙转到终色。
+ */
+export function settleMark(kind: Settle, sinceMs: number): string {
+	const k = easeOut(sinceMs / SETTLE_MS);
+	return kind === "done"
+		? paint(mix(HEAT_COLORS.orange, HEAT_COLORS.green, k), "✓")
+		: paint(mix(HEAT_COLORS.orange, HEAT_COLORS.fail, k), "✗");
+}
+
+/** 落定过渡是否仍在播放；调用方据此决定是否继续订阅时钟。 */
+export const settling = (sinceMs: number) => sinceMs < SETTLE_MS;
+
+const SPINNER = "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏";
+
+/** 审查：金色盲文转圈点，与火苗同一时钟、同一字符族，靠金色与火焰橙区分；phase 错开并列的转圈。 */
+export function reviewMark(phase = 0): string {
+	const frame = Math.floor(Date.now() / FRAME_MS + phase * SPINNER.length);
+	return paint(HEAT_COLORS.gold, SPINNER[frame % SPINNER.length]);
+}
+
+/** 并列火苗的相位：按序号错开，避免一排火苗同起同落。 */
+export const phaseOf = (index: number) => index * 0.23 + 0.11;

package/format.ts

@@ -2,9 +2,22 @@
 import { visibleWidth } from "@earendil-works/pi-tui";
 
 const ELLIPSIS = "…";
+const ANSI_SEQUENCE = /(\x1b(?:\[[0-?]*[ -/]*[@-~]|\][\s\S]*?(?:\x07|\x1b\\)))/g;
 const segmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
 
 /** 压平换行与连续空白，用于把任意文本塞进单行 UI。 */
+/** 消息 content 里的正文：字符串原样；块数组只取 text 块，按行拼接。全插件只此一处。 */
+export function textOf(content: unknown): string {
+	if (typeof content === "string") return content;
+	if (!Array.isArray(content)) return "";
+	return content
+		.filter((part): part is { type: "text"; text: string } =>
+			typeof part === "object" && part !== null && (part as { type?: unknown }).type === "text"
+			&& typeof (part as { text?: unknown }).text === "string")
+		.map((part) => part.text)
+		.join("\n");
+}
+
 export function oneLine(value = ""): string {
 	return value
 		.replace(/[\r\n\t]+/g, " ")
@@ -25,50 +38,90 @@ export function clip(
 	ellipsis: string = ELLIPSIS,
 ): string {
 	if (width <= 0) return "";
-	if (visibleWidth(text) <= width) return text;
-	const target = Math.max(0, width - visibleWidth(ellipsis));
-	const segments = [...segmenter.segment(text)].map((entry) => entry.segment);
-	let output = "";
-	let used = 0;
-	if (from === "start") {
-		for (let index = segments.length - 1; index >= 0; index--) {
-			const segmentWidth = visibleWidth(segments[index]);
-			if (used + segmentWidth > target) break;
-			output = segments[index] + output;
-			used += segmentWidth;
+	const textWidth = visibleWidth(text);
+	if (textWidth <= width) return text;
+	const ellipsisWidth = visibleWidth(ellipsis);
+	if (ellipsisWidth > width) return clip(ellipsis, width, "end", "");
+	const target = width - ellipsisWidth;
+	let output = from === "start" ? ellipsis : "";
+	let column = 0;
+	let clipped = false;
+	const chunks = text.split(ANSI_SEQUENCE);
+	for (let index = 0; index < chunks.length; index++) {
+		if (index % 2) {
+			// 连被裁掉文字后的颜色关闭/链接关闭也保留，避免样式泄漏；不注入全量 reset。
+			output += chunks[index];
+			continue;
+		}
+		for (const { segment } of segmenter.segment(chunks[index])) {
+			const columns = visibleWidth(segment);
+			if (from === "start") {
+				if (column >= textWidth - target) output += segment;
+			} else if (!clipped) {
+				if (column + columns <= target) output += segment;
+				else { output += ellipsis; clipped = true; }
+			}
+			column += columns;
 		}
-		return ellipsis + output;
-	}
-	for (const segment of segments) {
-		const segmentWidth = visibleWidth(segment);
-		if (used + segmentWidth > target) break;
-		output += segment;
-		used += segmentWidth;
 	}
-	return output + ellipsis;
+	return output;
 }
 
-/** 1234 → 1.2k，1_500_000 → 1.5M；0 与 undefined 显示为 ?。 */
+/** 1234 → 1.2k，1_500_000 → 1.5M，整数不带小数（1M、200k）；0 与 undefined 显示为 ?。 */
 export function formatTokens(tokens: number): string {
-	if (tokens >= 1_000_000) {
-		const value = tokens / 1_000_000;
-		return value >= 10 ? `${Math.round(value)}M` : `${value.toFixed(1)}M`;
-	}
-	if (tokens >= 1_000) {
-		const value = tokens / 1_000;
-		return value >= 10 ? `${Math.round(value)}k` : `${value.toFixed(1)}k`;
-	}
+	if (tokens >= 1_000_000) return `${scaled(tokens / 1_000_000)}M`;
+	if (tokens >= 1_000) return `${scaled(tokens / 1_000)}k`;
 	return tokens ? `${tokens}` : "?";
 }
 
-/** 900 → 0.9s，12_400 → 12s，93_000 → 1m33s。 */
+const scaled = (value: number) => (value >= 10 ? Math.round(value) : Number(value.toFixed(1)));
+
+const FENCE = /^\s*```/u;
+const HEADING = /^\s*#{1,6}\s+/u;
+const TABLE_ROW = /^\s*\|.*\|\s*$/u;
+const RULE = /^\s*([-*_])(?:\s*\1){2,}\s*$/u;
+/** 块级标记：引用符、列表符、序号（含任务框）。 */
+const BLOCK_MARK = /^\s*(?:>\s*)*(?:(?:[-*+]|\d+[.)])\s+(?:\[[ xX]\]\s+)?)?/u;
+/** 句末：中文句末标点，或后接空白/行尾的英文句末标点——但缩写的点不算。 */
+const SENTENCE_END = /[。！？]|(?<!\b(?:e\.g|i\.e|etc|vs|cf|Mr|Mrs|Ms|Dr|St|No))[.!?](?=\s|$)/u;
+
+/**
+ * 一行预览用的首句（机器消息行、中间回复、Master 事件卡与会话标题共用）：认 Markdown 结构，
+ * 跳过标题、围栏、表格行与分隔线，剥掉引用符、列表符与序号，去掉行内标记；只有标题没有正文时才用标题文字。
+ * 首句以冒号结尾（如“标准输出：”）本身没有信息，并入下一有效行的首句。
+ */
+export function firstSentence(text: string): string {
+	const lines = text.split("\n").filter((line) => !FENCE.test(line) && !TABLE_ROW.test(line) && !RULE.test(line));
+	const body = lines.filter((line) => !HEADING.test(line));
+	const source = body.some((line) => line.trim()) ? body : lines.map((line) => line.replace(HEADING, ""));
+	return sentenceOf(source.map((line) => oneLine(inline(line.replace(BLOCK_MARK, "")))).filter(Boolean));
+}
+
+/** 预览是纯文本：链接只留文字，去掉粗体与行内代码标记。 */
+function inline(line: string): string {
+	return line
+		.replace(/!?\[([^\]]*)\]\([^)]*\)/gu, "$1")
+		.replace(/(\*\*|__)(.+?)\1/gu, "$2")
+		.replace(/`([^`]+)`/gu, "$1");
+}
+
+function sentenceOf([head = "", ...rest]: string[]): string {
+	const end = SENTENCE_END.exec(head);
+	const sentence = end ? head.slice(0, end.index + 1) : head;
+	const colon = /[：:]$/u.exec(sentence)?.[0];
+	if (!colon || rest.length === 0) return sentence;
+	return `${sentence}${colon === ":" ? " " : ""}${sentenceOf(rest)}`;
+}
+
+/** 紧凑耗时：十秒以内保留一位小数，长耗时按小时、分钟、秒进位。 */
 export function formatDuration(milliseconds: number): string {
 	if (milliseconds < 10_000) return `${(milliseconds / 1_000).toFixed(1)}s`;
 	const totalSeconds = Math.round(milliseconds / 1_000);
 	if (totalSeconds < 60) return `${totalSeconds}s`;
-	const minutes = Math.floor(totalSeconds / 60);
+	const hours = Math.floor(totalSeconds / 3_600);
+	const minutes = Math.floor(totalSeconds / 60) % 60;
 	const seconds = totalSeconds % 60;
-	return seconds ? `${minutes}m${seconds}s` : `${minutes}m`;
+	return `${hours ? `${hours}h` : ""}${minutes ? `${minutes}m` : ""}${seconds ? `${seconds}s` : ""}`;
 }
 
 /** 去掉模型 id 的 provider 前缀与日期后缀。 */

package/header.ts

@@ -1,92 +1,218 @@
-/** 会话启动横幅：终端够宽显示火焰 + FireCode 字标，否则退化成一行。 */
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+/**
+ * 会话启动横幅：半格方块像素火焰 + 字标，按终端宽度分三档，三档都带同一行副标题（pi 版本 · 工作目录，
+ * 放不下只留目录、从开头按整段省略）。启动时字标自左向右点亮、扫光一道，约 1.5 秒后定格并退订动画时钟——
+ * 横幅会滚出视口，定格后不再触发重绘。
+ */
+import { homedir } from "node:os";
+import { type ExtensionAPI, VERSION } from "@earendil-works/pi-coding-agent";
+import type { TUI } from "@earendil-works/pi-tui";
 import { visibleWidth } from "@earendil-works/pi-tui";
+import { flame, flicker, HEAT_COLORS, heat, mix, onFrame, paint, type Rgb } from "./flame.js";
 import { clip } from "./format.js";
-import { ANSI, FLAME } from "./theme.js";
-
-const GAP = "     ";
-const EXTRA_RIGHT_PAD = " ";
-/** 字标相对火焰顶部下沉的行数 */
-const TEXT_TOP_PAD = 4;
-
-const FLAME_ART = [
-	"⠀⠀⠀⠀⠀⠀⢱⣆⠀⠀⠀⠀⠀⠀",
-	"⠀⠀⠀⠀⠀⠀⠈⣿⣷⡀⠀⠀⠀⠀",
-	"⠀⠀⠀⠀⠀⠀⢸⣿⣿⣷⣧⠀⠀⠀",
-	"⠀⠀⠀⠀⡀⢠⣿⡟⣿⣿⣿⡇⠀⠀",
-	"⠀⠀⠀⠀⣳⣼⣿⡏⢸⣿⣿⣿⢀⠀",
-	"⠀⠀⠀⣰⣿⣿⡿⠁⢸⣿⣿⡟⣼⡆",
-	"⢰⢀⣾⣿⣿⠟⠀⠀⣾⢿⣿⣿⣿⣿",
-	"⢸⣿⣿⣿⡏⠀⠀⠀⠃⠸⣿⣿⣿⡿",
-	"⢳⣿⣿⣿⠀⠀⠀⠀⠀⠀⢹⣿⡿⡁",
-	"⠀⠹⣿⣿⡄⠀⠀⠀⠀⠀⢠⣿⡞⠁",
-	"⠀⠀⠈⠛⢿⣄⠀⠀⠀⣠⠞⠋⠀⠀",
-];
-const WORDMARK = [
-	"___________.__                 _________            .___      ",
-	"\\_   _____/|__|______   ____   \\_   ___ \\  ____   __| _/____  ",
-	" |    __)  |  \\_  __ \\_/ __ \\  /    \\  \\/ /  _ \\ / __ |/ __ \\ ",
-	" |     \\   |  ||  | \\/\\  ___/  \\     \\___(  <_> ) /_/ \\  ___/ ",
-	" \\___  /   |__||__|    \\___  >  \\______  /\\____/\\____ |\\___  >",
-	"     \\/                    \\/          \\/            \\/    \\/ ",
-];
-const FLAME_COLORS = [
-	FLAME.red,
-	FLAME.red,
-	FLAME.orange,
-	FLAME.orange,
-	FLAME.gold,
-	FLAME.white,
-	FLAME.white,
-	FLAME.gold,
-	FLAME.orange,
-	FLAME.red,
-	FLAME.red,
-];
-const TEXT_COLORS = [
-	FLAME.textTop,
-	FLAME.textTop,
-	FLAME.textMid,
-	FLAME.textCore,
-	FLAME.gold,
-	FLAME.gold,
-];
-
-function padToWidth(line: string, width: number): string {
-	return line + " ".repeat(Math.max(0, width - visibleWidth(line)));
+
+const LARGE_MIN_WIDTH = 83;
+const MID_MIN_WIDTH = 52;
+const REVEAL_END = 0.7;
+const SWEEP_END = 1.5;
+const TINY_FLAME_PHASE = 0.4;
+/** 副标题从这一深底色淡入成灰；终端底色不可知，取深色主题的近似底色。 */
+const FADE_FROM: Rgb = [20, 19, 18];
+const RULE: Rgb = [60, 57, 53];
+/** 单行档副标题至少留这么宽才显示（省略号加几个字），右侧横线至少留这么长。 */
+const TINY_SUBTITLE_MIN = 8;
+const TINY_RULE_MIN = 3;
+
+const clamp = (value: number) => Math.min(1, Math.max(0, value));
+const ease = (k: number) => 1 - (1 - clamp(k)) ** 3;
+
+/** 像素画：每个终端格承载上下两个方形像素，▀ 的前景画上半、背景画下半。 */
+type Pixels = (Rgb | undefined)[][];
+
+const background = (color: Rgb) => `\x1b[48;2;${color[0] | 0};${color[1] | 0};${color[2] | 0}m`;
+
+function halfBlocks(pixels: Pixels): string[] {
+	const lines: string[] = [];
+	for (let y = 0; y < pixels.length; y += 2) {
+		let line = "";
+		pixels[y].forEach((top, x) => {
+			const bottom = pixels[y + 1]?.[x];
+			if (top && bottom) line += `${background(bottom)}${paint(top, "▀")}\x1b[49m`;
+			else if (top) line += paint(top, "▀");
+			else if (bottom) line += paint(bottom, "▄");
+			else line += " ";
+		});
+		lines.push(line);
+	}
+	return lines;
+}
+
+/** 水滴火焰：下部半圆、上部按幂曲线收成火尖，火尖随时间摆动；离焰芯越近越接近白金。 */
+function roundFlame(widthPx: number, heightPx: number, t: number): Pixels {
+	const radius = widthPx / 2;
+	const belly = 0.36;
+	const tall = 0.9 + 0.1 * flicker(0.2, t);
+	return Array.from({ length: heightPx }, (_, y) => {
+		const row: (Rgb | undefined)[] = Array(widthPx).fill(undefined);
+		const v = (heightPx - 0.5 - y) / heightPx / tall;
+		if (v > 1) return row;
+		const half = v < belly
+			? radius * Math.sqrt(1 - ((belly - v) / belly) ** 2)
+			: radius * ((1 - v) / (1 - belly)) ** 1.25;
+		const sway = 1.3 * v * v * Math.sin(Math.PI * 2 * 0.6 * t) + 0.4 * v * Math.sin(Math.PI * 2 * (1.7 * t + v * 2));
+		const reach = half + 0.25 * flicker(v * 3.1, t) * v;
+		for (let x = 0; x < widthPx; x++) {
+			const distance = Math.abs(x + 0.5 - radius - sway);
+			if (distance > reach) continue;
+			const core = 1 - distance / (reach + 0.01);
+			row[x] = heat(0.12 + 0.55 * core * (1 - v * 0.6) + 0.45 * (1 - v) ** 2);
+		}
+		return row;
+	});
+}
+
+/** 8 像素高的细笔画字形：1 像素笔画，转角缺一角做出圆角。 */
+const FONT: Record<string, string[]> = {
+	F: ["#####", "#....", "#....", "####.", "#....", "#....", "#....", "#...."],
+	i: ["#", ".", "#", "#", "#", "#", "#", "#"],
+	r: ["....", "....", ".###", "#...", "#...", "#...", "#...", "#..."],
+	e: [".....", ".....", ".###.", "#...#", "#####", "#....", "#....", ".####"],
+	C: [".####", "#....", "#....", "#....", "#....", "#....", "#....", ".####"],
+	o: [".....", ".....", ".###.", "#...#", "#...#", "#...#", "#...#", ".###."],
+	d: ["....#", "....#", ".####", "#...#", "#...#", "#...#", "#...#", ".####"],
+};
+const WORD = "FireCode";
+
+const wordBits = (gap: number): boolean[][] =>
+	FONT.F.map((_, y) => [...WORD].flatMap((char, index) => [
+		...Array<boolean>(index ? gap : 0).fill(false),
+		...[...FONT[char][y]].map((pixel) => pixel === "#"),
+	]));
+const WORD_BITS = { 1: wordBits(1), 2: wordBits(2) } as const;
+
+/** 字标：横向红→橙→金；入场时自左向右点亮（亮边白热），随后一道斜向扫光。 */
+function wordmark(gap: 1 | 2, t: number): Pixels {
+	const bits = WORD_BITS[gap];
+	const width = bits[0].length;
+	const edge = (t / REVEAL_END) * (width + 8);
+	const sweep = ((t - REVEAL_END - 0.1) / (SWEEP_END - REVEAL_END)) * (width + 16) - 8;
+	return bits.map((row, y) => row.map((on, x) => {
+		if (!on || x > edge) return undefined;
+		const half = width / 2;
+		const base = x < half
+			? mix(HEAT_COLORS.red, HEAT_COLORS.orange, x / half)
+			: mix(HEAT_COLORS.orange, HEAT_COLORS.gold, (x - half) / half);
+		const hotEdge = t < REVEAL_END ? clamp(1 - (edge - x) / 6) : 0;
+		const shine = t > REVEAL_END && t < SWEEP_END ? clamp(1 - Math.abs(x - y * 0.6 - sweep) / 4.5) : 0;
+		return mix(base, HEAT_COLORS.white, Math.max(hotEdge, shine * 0.9));
+	}));
+}
+
+function sideBySide(left: string[], right: string[], gap: number, rightTop = 0): string[] {
+	const leftWidth = Math.max(...left.map(visibleWidth));
+	return Array.from({ length: Math.max(left.length, right.length + rightTop) }, (_, index) => {
+		const cell = left[index] ?? "";
+		return `${cell}${" ".repeat(leftWidth - visibleWidth(cell) + gap)}${right[index - rightTop] ?? ""}`;
+	});
+}
+
+/** 副标题的来源：三档共用同一份。 */
+interface Subtitle {
+	version: string;
+	cwd: string;
+}
+
+/** 放得下就是“pi 版本 · 工作目录”；放不下只留目录，从开头按整段省略（…/末尾几段），连末段都放不下才裁字。 */
+function fitSubtitle({ version, cwd }: Subtitle, width: number): string {
+	const full = `pi ${version} · ${cwd}`;
+	if (visibleWidth(full) <= width) return full;
+	const segments = cwd.split("/");
+	for (let index = 1; index < segments.length; index++) {
+		const tail = `…/${segments.slice(index).join("/")}`;
+		if (visibleWidth(tail) <= width) return tail;
+	}
+	return clip(segments.at(-1) ?? cwd, width, "start");
+}
+
+/** 副标题：从深底色淡入成灰。 */
+function subtitleLine(subtitle: Subtitle, width: number, t: number): string {
+	return paint(mix(FADE_FROM, HEAT_COLORS.ash, ease((t - 0.4) / 0.6)), fitSubtitle(subtitle, width));
+}
+
+function large(t: number, subtitle: Subtitle): string[] {
+	const word = halfBlocks(wordmark(2, t));
+	return sideBySide(halfBlocks(roundFlame(10, 16, t)), [...word, "", subtitleLine(subtitle, visibleWidth(word[0]), t)], 3, 2);
+}
+
+function mid(t: number, subtitle: Subtitle): string[] {
+	const word = halfBlocks(wordmark(1, t));
+	return sideBySide(halfBlocks(roundFlame(6, 8, t)), [...word, subtitleLine(subtitle, visibleWidth(word[0]), t)], 2);
+}
+
+/** 一行档：火苗 + 渐变字标逐字亮起 + 副标题 + 向右渐隐的横线；太窄时只留横线。 */
+function tiny(width: number, t: number, glyph: string, subtitle: Subtitle): string {
+	const sweep = ((t - REVEAL_END) / (SWEEP_END - REVEAL_END)) * 14 - 3;
+	const letters = [...WORD].map((char, index) => {
+		if (t <= (index / WORD.length) * REVEAL_END) return " ";
+		const shine = t > REVEAL_END && t < SWEEP_END ? clamp(1 - Math.abs(index - sweep) / 2) : 0;
+		return paint(mix(mix(HEAT_COLORS.orange, HEAT_COLORS.gold, index / (WORD.length - 1)), HEAT_COLORS.white, shine), char);
+	}).join("");
+	const word = `${glyph} \x1b[1m${letters}\x1b[22m `;
+	const room = width - visibleWidth(word) - 1 - TINY_RULE_MIN;
+	const head = room >= TINY_SUBTITLE_MIN ? `${word}${subtitleLine(subtitle, room, t)} ` : word;
+	const length = width - visibleWidth(head);
+	const reveal = clamp((t - 0.2) / REVEAL_END);
+	let rule = "";
+	for (let index = 0; index < length; index++)
+		rule += index / length <= reveal
+			? paint(mix(HEAT_COLORS.gold, RULE, ease(index / Math.max(8, length * 0.7))), "─")
+			: " ";
+	return clip(head + rule, width, "end", "");
+}
+
+function center(lines: string[], width: number): string[] {
+	const pad = " ".repeat(Math.max(0, Math.floor((width - Math.max(...lines.map(visibleWidth))) / 2)));
+	return lines.map((line) => clip(pad + line, width, "end", ""));
+}
+
+function banner(width: number, t: number, glyph: string, subtitle: Subtitle): string[] {
+	if (width >= LARGE_MIN_WIDTH) return ["", ...center(large(t, subtitle), width), ""];
+	if (width >= MID_MIN_WIDTH) return ["", ...center(mid(t, subtitle), width), ""];
+	return [tiny(width, t, glyph, subtitle), ""];
 }
 
-const FLAME_WIDTH = Math.max(...FLAME_ART.map(visibleWidth));
-const FULL_WIDTH = Math.max(
-	...FLAME_ART.map((flame, index) => {
-		const text = WORDMARK[index - TEXT_TOP_PAD] ?? "";
-		return visibleWidth(`${padToWidth(flame, FLAME_WIDTH)}${GAP}${text}${EXTRA_RIGHT_PAD}`);
-	}),
-);
-const FULL = FLAME_ART.map((art, index) => {
-	const textIndex = index - TEXT_TOP_PAD;
-	const wordmark = WORDMARK[textIndex] ?? "";
-	const flame = `${FLAME_COLORS[index]}${padToWidth(art, FLAME_WIDTH)}${ANSI.reset}`;
-	const title = wordmark
-		? `${ANSI.bold}${TEXT_COLORS[textIndex]}${wordmark}${ANSI.reset}`
-		: "";
-	return padToWidth(`${flame}${GAP}${title}`, FULL_WIDTH);
-});
-const TINY = [`${FLAME.orange}🔥 Fire${ANSI.reset} ${FLAME.textCore}Code${ANSI.reset}`];
-
-function center(line: string, width: number): string {
-	const clipped = clip(line, width, "end", "");
-	return " ".repeat(Math.max(0, Math.floor((width - visibleWidth(clipped)) / 2))) + clipped;
+function createBanner(tui: TUI, subtitle: Subtitle) {
+	const start = Date.now();
+	const elapsed = () => Math.min(SWEEP_END, (Date.now() - start) / 1000);
+	let unsubscribe: (() => void) | undefined;
+	const dispose = () => {
+		unsubscribe?.();
+		unsubscribe = undefined;
+	};
+	unsubscribe = onFrame(() => {
+		tui.requestRender();
+		if (elapsed() >= SWEEP_END) dispose();
+	});
+	let frozenGlyph: string | undefined;
+	let frozen: { width: number; lines: string[] } | undefined;
+	return {
+		invalidate() {},
+		dispose,
+		render(width: number): string[] {
+			const t = elapsed();
+			if (t < SWEEP_END) return banner(width, t, flame(3, TINY_FLAME_PHASE), subtitle);
+			if (frozen?.width !== width) {
+				frozenGlyph ??= flame(3, TINY_FLAME_PHASE);
+				frozen = { width, lines: banner(width, t, frozenGlyph, subtitle) };
+			}
+			return frozen.lines;
+		},
+	};
 }
 
 export function registerHeader(pi: ExtensionAPI): void {
 	pi.on("session_start", (_event, ctx) => {
-		ctx.ui.setHeader(() => ({
-			invalidate() {},
-			render(width: number): string[] {
-				const lines = width >= FULL_WIDTH ? FULL : TINY;
-				return ["", ...lines.map((line) => center(line, width)), ""];
-			},
-		}));
+		const home = homedir();
+		const cwd = ctx.cwd.startsWith(home) ? `~${ctx.cwd.slice(home.length)}` : ctx.cwd;
+		ctx.ui.setHeader((tui) => createBanner(tui, { version: VERSION, cwd }));
 	});
 }