@bachi/pi-coder 1.0.0

package/extensions/thinking-collapse.ts

@@ -0,0 +1,60 @@
+/**
+ * Thinking Window Extension（文件名沿用 thinking-collapse.ts）
+ *
+ * 把 assistant 的 thinking 块渲染成**一条连续横向滚动的行**，避免大段推理刷屏。
+ * 纯显示层：session / 模型上下文里的原文完全不变。
+ *
+ * 形状永远是：
+ *
+ *     Think: …最新写下的 token 一直追加在行尾
+ *
+ * 设计意图是「一条不间断的 token 流」：
+ *   - **不分段、不换行**：thinking 里所有换行（模型自己折的行、空行分段、列表项、代码围栏内）
+ *     全部拼进这同一条行 —— 上一段结束后，下一段直接接续在上一段的结尾，**不另起一行**。
+ *     于是 Think 区域从头到尾只有一行在滚动，不会看到「换行重新起头」的动作。
+ *   - **段落接缝（原文空行处）中文 ↔ 中文补一个逗号**，免得两段无缝粘连读起来像一句话
+ *     （`第一段，第二段`）；上一段末尾本来就有标点时不重复补，英文 / 中英混排仍按空格规则。
+ *     段内折行（没有空行）不补逗号 —— 否则模型自己折的每一行都会多一个。
+ *   - 整行超出终端宽度时从**头部**丢掉溢出字符、行首补一个 `…`，行尾永远是最新写下的 token；
+ *     放得下就全量显示，不补 `…`。
+ *   - 行首带 `Think: ` 标签（顶格，无竖线 gutter），始终钉在这一行最前面。
+ *
+ * 这里**没有**「短段回填补满整行」的逻辑：曾经有过（最后一段太短时把被顶出去的开头拉回来
+ * 拼满行，还配过 `isStreaming` 闸门只在定型后补），但它会不断改变整行构成、打断「token 持续
+ * 流动」的观感，已整体移除。现在短 thinking 就是短，行尾留白，不补。
+ *
+ * 标签用 `\x1b[23m` 关掉斜体再 `\x1b[3m` 打开，于是标签是正常字形、正文仍是 pi 给 thinking
+ * 块的斜体 + thinkingText 颜色（终端不支持 ANSI 时不夹这对控制码）。
+ *
+ * 刻意**不再**输出 `… (123 tokens hidden)` 提示行：底部 spinner 已经在数 token 了。
+ *
+ * ## 硬性不折行（本扩展的核心约束）
+ *
+ * 本扩展输出的行必须**恰好一行**，绝不允许被 pi 二次折行 —— thinking 内容不会被仔细阅读，
+ * 格式整洁比内容完整更重要，所以宁可截掉字符（补 `…`）也不折行。全行拼接、头部截断、
+ * 反引号配对、出口兜底截断的全部实现与理由都在 `./thinking-collapse/window.ts`
+ * （那个模块**不 import pi / pi-tui**，宽度函数注入，因此 `node --test` 能直接跑它）。
+ *
+ * 行宽度量用 pi-tui 的 `visibleWidth`（和 pi 自己的渲染器同一套实现），所以本扩展预裁出来的
+ * 行在 pi 那边不会再被二次折行。
+ *
+ * **刻意不注册命令**：窗口形态只有这一种，没有需要用户调的状态，也没有开关；
+ * 曾经有过 `/thinking-collapse off | on | <n>`，已移除。
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { visibleWidth } from "@earendil-works/pi-tui";
+
+import { buildThinkingWindow } from "./thinking-collapse/window.ts";
+
+/** 终端明显不支持 ANSI 时不要夹控制码，否则会把 `\x1b[23m` 当字面字符画出来。 */
+function ansiCapable(): boolean {
+	return process.env.TERM !== "dumb" && !process.env.NO_COLOR;
+}
+
+export default function (pi: ExtensionAPI) {
+	pi.registerMarkdownTransformer((markdown, context) => {
+		if (context.messageType !== "assistant-thinking") return markdown;
+		return buildThinkingWindow(markdown, context.availableWidth, visibleWidth, ansiCapable());
+	});
+}

package/extensions/tool-diff/title-row.test.ts

@@ -0,0 +1,254 @@
+/**
+ * Tests for title-row.ts — `Edit` / `Write` 标题行的纯排版（预算分配、按宽度截断、闪烁占位、行数缩略）。
+ *
+ * Run with:  node --test clients/pi/extensions/tool-diff/title-row.test.ts
+ *
+ * 被测模块不 import pi / pi-tui（宽度与截断函数都是注入的），所以这里喂假实现：
+ * ASCII = 1 列、CJK = 2 列；`●`（U+25CF）与 `…` 都是 1 列 —— 与 pi-tui 的 `visibleWidth`
+ * 已核对一致（`visibleWidth("●") === 1`）。主题的 `fg` 换成恒等函数，断言里直接看纯文本。
+ */
+
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+
+import {
+	BLINK_MARKER,
+	ELLIPSIS,
+	TitleRow,
+	blinkSuffix,
+	formatCount,
+	shortenPath,
+	statsSuffix,
+	truncateStartToWidth,
+	type TitleRowDeps,
+	type TitleTheme,
+} from "./title-row.ts";
+
+/** 恒等主题：不着色，断言直接比对纯文本。 */
+const plainTheme: TitleTheme = { fg: (_color, text) => text };
+
+/** 假宽度函数：CJK 常见全角区间按 2 列，其余按 1 列。 */
+function widthOf(text: string): number {
+	let width = 0;
+	for (const ch of text) {
+		const code = ch.codePointAt(0) ?? 0;
+		const wide =
+			(code >= 0x1100 && code <= 0x115f) ||
+			(code >= 0x2e80 && code <= 0xa4cf) ||
+			(code >= 0xac00 && code <= 0xd7a3) ||
+			(code >= 0xf900 && code <= 0xfaff) ||
+			(code >= 0xfe30 && code <= 0xfe6f) ||
+			(code >= 0xff00 && code <= 0xff60) ||
+			(code >= 0xffe0 && code <= 0xffe6);
+		width += wide ? 2 : 1;
+	}
+	return width;
+}
+
+/** 假截断函数（生产环境传 pi-tui 的 truncateToWidth）：从尾部硬切，够用。 */
+function truncateToWidth(text: string, width: number, ellipsis = ELLIPSIS): string {
+	if (widthOf(text) <= width) return text;
+	let out = "";
+	let used = 0;
+	for (const ch of text) {
+		const w = widthOf(ch);
+		if (used + w > width - widthOf(ellipsis)) break;
+		out += ch;
+		used += w;
+	}
+	return out + ellipsis;
+}
+
+function deps(home = "/Users/me"): TitleRowDeps {
+	return { widthOf, truncateToWidth, home, indent: " " };
+}
+
+/** 一条必须从头部截断才能放进 90 列的深层路径。 */
+const LONG_PATH =
+	"/Users/me/work/project/packages/renderer/src/components/inner/deep/deeper/deepest/final/renderer-impl.ts";
+
+function titleLine(path: string, suffix: string, width: number, rowDeps: TitleRowDeps = deps()): string {
+	return new TitleRow(rowDeps, plainTheme, "Write", path, suffix).render(width)[0] ?? "";
+}
+
+describe("blinkSuffix: 灭态等宽占位", () => {
+	it("keeps the same visible width in both phases so the path budget cannot move", () => {
+		assert.equal(widthOf(blinkSuffix(plainTheme, true)), 1);
+		assert.equal(widthOf(blinkSuffix(plainTheme, false)), 1);
+		assert.equal(widthOf(blinkSuffix(plainTheme, true)), widthOf(blinkSuffix(plainTheme, false)));
+	});
+
+	it("renders the marker only while the phase is on (the dark phase is blank)", () => {
+		assert.equal(blinkSuffix(plainTheme, true), BLINK_MARKER);
+		assert.equal(blinkSuffix(plainTheme, false).trim(), "");
+	});
+});
+
+describe("TitleRow: 闪烁期间超长路径不摆动（回归）", () => {
+	it("renders the same line in both blink phases, modulo the marker itself", () => {
+		const on = titleLine(LONG_PATH, blinkSuffix(plainTheme, true), 90);
+		const off = titleLine(LONG_PATH, blinkSuffix(plainTheme, false), 90);
+		// 两态的唯一差别是标记字符 —— 修复前灭态是空串，预算每帧跳 2 列，
+		// 截断窗口跟着左右挪（`…ccccc` vs `…ccccccc`），观感就是"文件名也在闪"
+		assert.equal(on.replace(BLINK_MARKER, " "), off);
+		assert.equal(widthOf(on), widthOf(off));
+	});
+
+	it("keeps the file name and the line width stable across a sweep of widths", () => {
+		for (let width = 40; width <= 140; width += 1) {
+			const on = titleLine(LONG_PATH, blinkSuffix(plainTheme, true), width);
+			const off = titleLine(LONG_PATH, blinkSuffix(plainTheme, false), width);
+			assert.ok(widthOf(on) <= width, `line wider than ${width}: ${JSON.stringify(on)}`);
+			assert.equal(on.replace(BLINK_MARKER, " "), off, `path moved at width ${width}`);
+			// 路径永远保留尾部：无论宽度多窄，文件名都能完整看到
+			assert.ok(on.replace(BLINK_MARKER, " ").trimEnd().endsWith("renderer-impl.ts"), `no file name at width ${width}`);
+		}
+	});
+
+	it("keeps the tail (file name) visible while dropping the head of a long path", () => {
+		const line = titleLine(LONG_PATH, blinkSuffix(plainTheme, true), 90);
+		assert.ok(line.startsWith(" Write "), line);
+		assert.ok(line.includes(ELLIPSIS), line);
+		assert.ok(line.includes("/final/renderer-impl.ts"), line);
+		assert.ok(!line.includes("/Users/me/work"), line);
+	});
+});
+
+describe("TitleRow: 工具名与尾部永远完整", () => {
+	it("keeps a wide stats suffix intact and truncates the path instead", () => {
+		const line = titleLine(LONG_PATH, statsSuffix(plainTheme, { added: 123456, removed: 9999 }), 90);
+		assert.ok(line.endsWith("(+123k -9999)"), line);
+		assert.ok(line.includes(ELLIPSIS), line);
+		assert.ok(widthOf(line) <= 90, line);
+	});
+
+	it("falls back to whole-line truncation when the path budget runs out", () => {
+		const line = titleLine(LONG_PATH, blinkSuffix(plainTheme, true), 8);
+		assert.equal(widthOf(line) <= 8, true, line);
+		assert.ok(line.includes("Write"), line);
+		// 退回整行截断时两态同样只差标记：尾部是等宽空格，预算不会跳
+		const off = titleLine(LONG_PATH, blinkSuffix(plainTheme, false), 8);
+		assert.equal(line.replace(BLINK_MARKER, " "), off);
+	});
+
+	it("renders the streaming-start form (no path yet) without a dangling separator", () => {
+		assert.equal(titleLine("", blinkSuffix(plainTheme, true), 60).trimEnd(), " Write ●");
+	});
+});
+
+describe("TitleRow: 路径与缩进", () => {
+	it("shortens the home prefix and honours a custom indent", () => {
+		const line = titleLine("/Users/me/work/project/src/index.ts", "", 60, {
+			...deps(),
+			indent: "   ",
+		});
+		assert.equal(line, "   Write ~/work/project/src/index.ts");
+	});
+
+	it("colors the path with the text token, after truncation (ANSI never reaches the measurer)", () => {
+		const calls: Array<[string, string]> = [];
+		const recordingTheme: TitleTheme = {
+			fg: (color, text) => {
+				calls.push([color, text]);
+				return text;
+			},
+		};
+		new TitleRow(deps(), recordingTheme, "Write", LONG_PATH, "").render(90);
+		assert.equal(calls.length, 1);
+		assert.equal(calls[0]?.[0], "text");
+		assert.ok(calls[0]?.[1].startsWith(ELLIPSIS), calls[0]?.[1]);
+	});
+});
+
+describe("formatCount", () => {
+	it("keeps counts below 10k exact", () => {
+		assert.equal(formatCount(0), "0");
+		assert.equal(formatCount(1), "1");
+		assert.equal(formatCount(9999), "9999");
+	});
+
+	it("abbreviates counts at or above 10k with a k suffix", () => {
+		assert.equal(formatCount(10_000), "10k");
+		assert.equal(formatCount(10_043), "10k");
+		assert.equal(formatCount(11_133), "11.1k");
+		assert.equal(formatCount(10_450), "10.5k");
+		assert.equal(formatCount(99_999), "100k");
+		assert.equal(formatCount(123_456), "123k");
+		assert.equal(formatCount(1_234_567), "1235k");
+	});
+});
+
+describe("statsSuffix", () => {
+	/** 记录 fg 调用的主题，用来断言着色 token。 */
+	function recorder(): { theme: TitleTheme; calls: Array<[string, string]> } {
+		const calls: Array<[string, string]> = [];
+		return {
+			calls,
+			theme: {
+				fg: (color, text) => {
+					calls.push([color, text]);
+					return text;
+				},
+			},
+		};
+	}
+
+	it("returns an empty string when there is nothing to report", () => {
+		assert.equal(statsSuffix(plainTheme, undefined), "");
+		assert.equal(statsSuffix(plainTheme, { added: 0, removed: 0 }), "");
+	});
+
+	it("omits the side that is zero", () => {
+		assert.equal(statsSuffix(plainTheme, { added: 3, removed: 0 }), "(+3)");
+		assert.equal(statsSuffix(plainTheme, { added: 0, removed: 5 }), "(-5)");
+	});
+
+	it("shows both sides with the diff color tokens", () => {
+		const { theme, calls } = recorder();
+		assert.equal(statsSuffix(theme, { added: 3, removed: 5 }), "(+3 -5)");
+		assert.deepEqual(calls, [
+			["toolDiffAdded", "+3"],
+			["toolDiffRemoved", "-5"],
+			["dim", "("],
+			["dim", ")"],
+		]);
+	});
+
+	it("abbreviates huge counts (the tail must stay narrow)", () => {
+		assert.equal(statsSuffix(plainTheme, { added: 10_043, removed: 11_133 }), "(+10k -11.1k)");
+	});
+});
+
+describe("shortenPath", () => {
+	it("shortens the home prefix at a path boundary only", () => {
+		assert.equal(shortenPath("/Users/me/work/index.ts", "/Users/me"), "~/work/index.ts");
+		assert.equal(shortenPath("/Users/me", "/Users/me"), "~");
+		// `/Users/melo` 不该被缩成 `~lo`
+		assert.equal(shortenPath("/Users/melo/index.ts", "/Users/me"), "/Users/melo/index.ts");
+	});
+
+	it("leaves the path alone without a home directory or outside of it", () => {
+		assert.equal(shortenPath("/tmp/renderer.ts", ""), "/tmp/renderer.ts");
+		assert.equal(shortenPath("/tmp/renderer.ts", "/Users/me"), "/tmp/renderer.ts");
+	});
+});
+
+describe("truncateStartToWidth", () => {
+	it("returns the text unchanged when it fits", () => {
+		assert.equal(truncateStartToWidth("abcdef", 6, widthOf), "abcdef");
+	});
+
+	it("keeps the tail and marks the dropped head with an ellipsis", () => {
+		assert.equal(truncateStartToWidth("abcdef", 4, widthOf), "…def");
+		assert.equal(truncateStartToWidth("abcdef", 1, widthOf), ELLIPSIS);
+	});
+
+	it("returns nothing when there is no room at all", () => {
+		assert.equal(truncateStartToWidth("abcdef", 0, widthOf), "");
+		assert.equal(truncateStartToWidth("abcdef", -3, widthOf), "");
+	});
+
+	it("measures CJK characters as two columns", () => {
+		assert.equal(truncateStartToWidth("路径文件名", 5, widthOf), "…件名");
+	});
+});

package/extensions/tool-diff/title-row.ts

@@ -0,0 +1,191 @@
+/**
+ * title-row.ts — `Edit` / `Write` 标题行（`Edit <path> (+3 -5)`）的纯排版逻辑。
+ * 工具名由调用方传入（`titleRow(theme, "Edit", …)`），本模块不认工具、只看宽度。
+ *
+ * 从 `tool-diff.ts` 抽出来的理由有两个：
+ *
+ *   1. **可单测**。这段是纯字符串排版（预算分配 + 按宽度截断），却埋在 1300 多行、到处
+ *      import pi 的 `tool-diff.ts` 里，`node --test` 根本 import 不进来。抽出后本模块
+ *      **不 import pi / pi-tui**：宽度函数 `widthOf`、截断函数 `truncateToWidth`、home
+ *      目录、缩进全部从 `deps` 注入（与 `working-summary.ts` 同一套做法），测试里喂一个
+ *      ASCII=1 / CJK=2 的假量宽函数就能跑满每个分支。
+ *   2. **「超长路径跟着闪烁一起抖」的现场就在这里**。路径预算按「可用宽度 − 工具名 −
+ *      尾部」算，而流式期间尾部是那个闪烁的 `●` —— 亮 / 灭两态各自占 2 列和 0 列，于是
+ *      每 500ms 预算变一次、路径的截断窗口跟着左右挪 2 列，看起来就是「文件名自己在闪」。
+ *      修法见 `blinkSuffix`（灭态等宽占位）。
+ *
+ * 模块放在 `extensions/tool-diff/` 这个**同名目录**下（`tool-diff.ts` 与 `tool-diff/` 可以
+ * 并存）：目录里没有 `index.ts`，而 pi 的加载器只认 `extensions/<name>.ts` 与
+ * `extensions/<name>/index.ts`（loader.js 的 `discoverExtensionsInDir` → `resolveExtensionEntries`
+ * 找不到入口就整目录跳过），所以它不会被当成扩展加载。
+ */
+
+/** 从头部截断时用的省略号。1 列宽。 */
+export const ELLIPSIS = "…";
+/** 流式加载中的标记字符。1 列宽（`visibleWidth("●") === 1`，已核对）。 */
+export const BLINK_MARKER = "●";
+
+/** 渲染需要的主题子集（`Theme.fg` 的方法声明是**双变**的，真实 `Theme` 可直接赋值）。 */
+export interface TitleTheme {
+	fg(color: string, text: string): string;
+}
+
+/** 标题行尾部 `(+N -M)` 的行数统计。 */
+export interface TitleStats {
+	added: number;
+	removed: number;
+}
+
+/**
+ * 排版依赖（全部注入，本模块因此不 import pi / pi-tui）。
+ *
+ * `widthOf` / `truncateToWidth` 运行时传 pi-tui 的 `visibleWidth` / `truncateToWidth`
+ * （与渲染器同一套实现，量出来的宽度与 pi 实际折行严格一致）；`home` 传 `os.homedir()`；
+ * `indent` 传调用方的标题缩进。
+ */
+export interface TitleRowDeps {
+	/** 可见宽度（忽略 ANSI 转义、CJK 记 2 列） */
+	widthOf(text: string): number;
+	/** 按可见宽度从**尾部**截断（ANSI 安全），超出部分换成一个省略号 */
+	truncateToWidth(text: string, width: number, ellipsis: string): string;
+	/** home 目录（`""` = 不做 `~` 缩写） */
+	home?: string;
+	/** 标题缩进，默认 1 个空格 */
+	indent?: string;
+}
+
+/**
+ * 闪烁标记的着色尾部。**灭态返回等宽空格占位，绝不返回空串。**
+ *
+ * 为什么不能返回空串：`TitleRow` 的路径预算 = 可用宽度 − 工具名 − 尾部（分隔空格 + 标记），
+ * 尾部在「亮 = 2 列 / 灭 = 0 列」之间来回就是**预算每 500ms 跳 2 列**。路径短（装得下）时
+ * 看不出来，路径长到需要截断时，截断窗口跟着一起左右挪 —— 实测每个闪烁周期里路径的前半段
+ * （`…` 之后那截）和文件名的落点都会平移 2 列，观感是「标记在闪、文件名也在闪」。
+ * 用空格占位后两态同宽，路径恒定，只有标记本身在亮灭。
+ */
+export function blinkSuffix(theme: TitleTheme, on: boolean): string {
+	return theme.fg("dim", on ? BLINK_MARKER : " ");
+}
+
+/**
+ * 行数的显示形态：万位以上缩略成 `k`（`10043` → `10k`、`11133` → `11.1k`）。
+ *
+ * 尾部 `(+N -M)` 是这一行里**不能被截掉**的部分，但两个五位数并排能吃掉 13 列以上，
+ * 窄终端里那几列本该留给路径。缩到 `k` 之后最多 5-6 列，路径的可用宽度也稳定了
+ * （写入量越大越极端，这里只影响显示，不影响任何统计口径）。
+ * 万位以下原样显示 —— `+1043` 比 `+1.0k` 精确，也不长。
+ */
+export function formatCount(count: number): string {
+	if (!Number.isFinite(count) || count < 10_000) return String(count);
+	const thousands = count / 1000;
+	if (thousands < 100) {
+		const rounded = Math.round(thousands * 10) / 10;
+		return `${Number.isInteger(rounded) ? rounded.toFixed(0) : rounded.toFixed(1)}k`;
+	}
+	return `${Math.round(thousands)}k`;
+}
+
+/**
+ * 标题行尾部的 `(+3 -5)`：新增绿、删除红（沿用 diff 的 `toolDiffAdded` / `toolDiffRemoved`，
+ * 跟卡片里的 +/- 行同色），括号保持 dim。为 0 的一侧省略，两侧都为 0（无改动 / 算不出来）
+ * 返回空串 —— 空括号比没有括号更难看。
+ */
+export function statsSuffix(theme: TitleTheme, stats: TitleStats | undefined): string {
+	if (stats === undefined) return "";
+	const parts: string[] = [];
+	if (stats.added > 0) parts.push(theme.fg("toolDiffAdded", `+${formatCount(stats.added)}`));
+	if (stats.removed > 0) parts.push(theme.fg("toolDiffRemoved", `-${formatCount(stats.removed)}`));
+	if (parts.length === 0) return "";
+	return `${theme.fg("dim", "(")}${parts.join(" ")}${theme.fg("dim", ")")}`;
+}
+
+/** 把 home 目录前缀缩写成 `~`，跟内置工具标题的惯例一致 */
+export function shortenPath(path: string, home: string): string {
+	if (home === "" || !path.startsWith(home)) return path;
+	const rest = path.slice(home.length);
+	// 只在边界处缩写：`~` 本身或 `~/...`，避免把 `/Users/bachir/...` 误缩成 `~r/...`
+	if (rest === "" || rest.startsWith("/")) return `~${rest}`;
+	return path;
+}
+
+/**
+ * 从**头部**截断到指定列宽：保留尾部，前面用一个 `…` 顶替被丢掉的字符。
+ * 按**码点**走（不是 UTF-16 单元），所以代理对不会被切成半个；宽度用 `widthOf`
+ * 逐字符量，CJK / emoji 占 2 列也算得对。
+ */
+export function truncateStartToWidth(
+	text: string,
+	maxWidth: number,
+	widthOf: (text: string) => number,
+	ellipsis = ELLIPSIS,
+): string {
+	if (maxWidth <= 0) return "";
+	if (widthOf(text) <= maxWidth) return text;
+	const budget = maxWidth - widthOf(ellipsis);
+	if (budget <= 0) return ellipsis;
+	const chars = Array.from(text);
+	let used = 0;
+	let start = chars.length;
+	for (let i = chars.length - 1; i >= 0; i -= 1) {
+		const charWidth = widthOf(chars[i] ?? "");
+		if (used + charWidth > budget) break;
+		used += charWidth;
+		start = i;
+	}
+	return ellipsis + chars.slice(start).join("");
+}
+
+/**
+ * 标题行组件。用 `Text` 的话长路径会被折成两三行（工具名 / 路径 / 计数各一行），
+ * 所以自己按宽度排版成**恒一行**。
+ *
+ * 排版优先级：工具名和尾部（`(+N -M)` / 闪烁的 `●`）**永远完整**，路径吃剩下的宽度、
+ * 超宽时从头部截断。尾部是这一行的信息量所在，被截掉就失去意义了；只有窄到连一个
+ * 字符的路径都放不下时，才退回整行尾部截断（至少保住工具名）。
+ */
+export class TitleRow {
+	// 字段显式声明 + 构造里赋值，**不用参数属性**（`constructor(private readonly x)`）：
+	// Node 的类型剥离不支持它（`ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX`），而本模块要能被
+	// `node --test` 直接 import。
+	private readonly deps: TitleRowDeps;
+	private readonly theme: TitleTheme;
+	/** 已着色的工具名 */
+	private readonly tool: string;
+	/** 纯文本路径（未着色）—— 先按宽度截断再上色，否则 ANSI 串会被截断逻辑当成可见字符 */
+	private readonly path: string;
+	/** 已着色的尾部 */
+	private readonly suffix: string;
+
+	constructor(deps: TitleRowDeps, theme: TitleTheme, tool: string, path: string, suffix: string) {
+		this.deps = deps;
+		this.theme = theme;
+		this.tool = tool;
+		this.path = path;
+		this.suffix = suffix;
+	}
+
+	render(width: number): string[] {
+		const { widthOf } = this.deps;
+		const indent = this.deps.indent ?? " ";
+		// 缩进占 1 列，所以正文的可用宽度要相应减 1，否则整行会超宽
+		const available = Math.max(1, width - widthOf(indent));
+		const path = this.path === "" ? "" : shortenPath(this.path, this.deps.home ?? "");
+		const toolWidth = widthOf(this.tool);
+		// 尾部与路径各占一个分隔空格
+		const suffixWidth = this.suffix === "" ? 0 : 1 + widthOf(this.suffix);
+		const pathBudget = available - toolWidth - suffixWidth - (path === "" ? 0 : 1);
+
+		if (path === "" || pathBudget < 1) {
+			const fallback = [this.tool, path === "" ? "" : this.theme.fg("text", path), this.suffix]
+				.filter((part) => part !== "")
+				.join(" ");
+			return [indent + this.deps.truncateToWidth(fallback, available, ELLIPSIS)];
+		}
+
+		const shown = this.theme.fg("text", truncateStartToWidth(path, pathBudget, widthOf));
+		const tail = this.suffix === "" ? "" : ` ${this.suffix}`;
+		return [indent + `${this.tool} ${shown}${tail}`];
+	}
+
+	invalidate(): void {}
+}