pi-cc-extensions 0.8.54 → 0.8.56

package/README.en.md

@@ -38,15 +38,15 @@ Run `/reload` after installation.
 
 ## Features
 
-
-| Feature                      | Description                                                                                                                                       | Entry point |
-| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
-| Claude Code Output     | Tool summaries, expand/collapse, rich edit/write diffs, and`on` / `compact` / `off` modes                                                         | `/ccstyle`  |
-| Fullscreen mode          | Tool card/group click-to-toggle, previews, hover highlight, and a back-to-bottom button | `TUIMODE=fullscreen` or `--tui-mode fullscreen` |
-| Settings panel               | `Style / Diff / Thinking / Feature` tabs: startup header toggle and wheel step                                                                    | `/ccstyle`  |
-| Context inspection           | Usage breakdown and previews for the system prompt, tools, skills, and messages                                                                   | `/context`  |
-| Session/Subagent references           | Search and inject effective context from previous Sessions or existing SubAgents                                                                  | `@` |
-| Theme                        | Bundled CC Dark and CC Light themes                                                                                                               | `/theme`    |
+| Feature                     | Description                                                                               | Entry point                                     |
+| --------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------- |
+| Claude Code Output          | Tool summaries, expand/collapse, rich edit/write diffs, and`on` / `compact` / `off` modes | `/ccstyle`                                      |
+| Markdown enhancements      | Mermaid art, admonitions, URL linking, and more                                           | Automatic                                        |
+| Fullscreen mode             | Tool card/group click-to-toggle, previews, hover highlight, and a back-to-bottom button   | `TUIMODE=fullscreen` or `--tui-mode fullscreen` |
+| Settings panel              | `Style / Diff / Thinking / Feature` tabs: startup header toggle and wheel step            | `/ccstyle`                                      |
+| Context inspection          | Usage breakdown and previews for the system prompt, tools, skills, and messages           | `/context`                                      |
+| Session/Subagent references | Search and inject effective context from previous Sessions or existing SubAgents          | `@`                                             |
+| Theme                       | Bundled CC Dark and CC Light themes                                                       | `/theme`                                        |
 
 ## Configuration
 
@@ -70,6 +70,8 @@ Run `/reload` after installation.
 }
 ```
 
+> **Tip**: set `markdown.mermaid` to `final` via `~/.pi/agent/settings.json` or the Mermaid diagrams option in `/settings`. Default `streaming` redraws per frame; `final` renders once at completion.
+
 ## Local development
 
 ```bash
@@ -84,15 +86,13 @@ npm run typecheck
 
 ## Recommended companions
 
-
 | Extension                                | Purpose                                                      |
-| ------------------------------------------ | -------------------------------------------------------------- |
+| ---------------------------------------- | ------------------------------------------------------------ |
 | `npm:@tintinweb/pi-subagents`            | Parallel SubAgents, background tasks, and worktree isolation |
 | `npm:@tintinweb/pi-tasks`                | Claude Code-style task tracking and coordination             |
 | `npm:pi-mcp-adapter`                     | On-demand MCP tool discovery with lower context usage        |
 | `npm:@ff-labs/pi-fff`                    | FFF-powered fuzzy file and content search (fffind / ffgrep)  |
 | `npm:pi-web-access`                      | Web search, URL fetching, GitHub cloning, PDF/video parsing  |
-| `npm:pi-theme-picker`                    | Theme search and live preview                                |
 | `npm:@narumitw/pi-usage`                 | Current-account usage for Codex / Copilot / OpenRouter       |
 | `git:github.com/DietrichGebert/ponytail` | Lazy-mode coding: forces the simplest working solution       |
 

package/README.md

@@ -38,15 +38,15 @@ pi install git:github.com/minuque/pi-cc-extensions
 
 ## 功能
 
-
-| 功能                 | 说明                                                                                                     | 入口        |
-| ---------------------- | ---------------------------------------------------------------------------------------------------------- | ------------- |
-| Claude Code UI | 工具摘要、折叠展开、rich edit/write diff，以及`on` / `compact` / `off` 三种模式                          | `/ccstyle`  |
-| Fullscreen mode  | 工具卡/group 点击展开与收起、预览、hover 高亮、回到底部按钮 | `TUIMODE=fullscreen` 或 `--tui-mode fullscreen` |
-| 配置面板             | `Style / Diff / Thinking / Feature` 四页签，含启动头开关与滚轮步进                                       | `/ccstyle`  |
-| 上下文检查           | 查看上下文占用，并预览 System prompt、Tools、Skills 和消息内容                                           | `/context`  |
-| Session/Subagent 引用         | 搜索并注入历史 Session 或现有 SubAgent 的有效上下文                                                      | `@` |
-| 主题                 | 随包提供内置 CC Dark、CC Light 主题                                                                      | `/theme`    |
+| 功能                  | 说明                                                                            | 入口                                            |
+| --------------------- | ------------------------------------------------------------------------------- | ----------------------------------------------- |
+| Claude Code UI        | 工具摘要、折叠展开、rich edit/write diff，以及`on` / `compact` / `off` 三种模式 | `/ccstyle`                                      |
+| Markdown 增强         | Mermaid 图、提示框、URL 链接化等                                                        | 自动生效                                        |
+| Fullscreen mode       | 工具卡/group 点击展开与收起、预览、hover 高亮、回到底部按钮                     | `TUIMODE=fullscreen` 或 `--tui-mode fullscreen` |
+| 配置面板              | `Style / Diff / Thinking / Feature` 四页签，含启动头开关与滚轮步进              | `/ccstyle`                                      |
+| 上下文检查            | 查看上下文占用，并预览 System prompt、Tools、Skills 和消息内容                  | `/context`                                      |
+| Session/Subagent 引用 | 搜索并注入历史 Session 或现有 SubAgent 的有效上下文                             | `@`                                             |
+| 主题                  | 随包提供内置 CC Dark、CC Light 主题                                             | `/theme`                                        |
 
 ## 配置
 
@@ -66,10 +66,18 @@ pi install git:github.com/minuque/pi-cc-extensions
   "previewLines": 3,                       // thinking 预览行数，0 隐藏预览正文
   "animationIntervalMs": 90,               // thinking 标题动画间隔（毫秒）
   "showStartupHeader": true,               // 自定义启动头（logo + tips）开关
-  "scrollStepLines": 3                     // fullscreen 滚轮滚动步进行数
+  "scrollStepLines": 3,                     // fullscreen 滚轮滚动步进行数
+  "enableSessionReference": true,           // @ session 引用（搜历史会话注入上下文）
+  "enableSubagentAutocomplete": true,       // @ subagent 自动补全与委派提示
+  "enableContextCommand": true,             // /context 上下文占用检查
+  "enableAgentSummary": true,               // 每回合工具统计摘要
+  "enableWorkingMessage": true,             // Working... 底部 token/耗时展示
+  "enableAliases": true                     // /clear、/exit 别名
 }
 ```
 
+> **建议**：`markdown.mermaid` 设为 `final`（`~/.pi/agent/settings.json` 或 `/settings` 面板的 Mermaid diagrams 选项）。默认 `streaming` 逐帧重绘，`final` 渲染最终版更稳定。
+
 ## 本地开发
 
 ```bash
@@ -78,22 +86,19 @@ npm run typecheck
 ./test.bat # or pi -e .
 ```
 
-
 ## 兼容性
 
 - Node.js `>=22.19.0`，Pi `^0.84.0`（通过根目录 `package.json` 的 `pi.extensions` 和 `pi.themes` 加载）
 
 ## 推荐搭配
 
-
 | 扩展                                     | 用途                                             |
-| ------------------------------------------ | -------------------------------------------------- |
+| ---------------------------------------- | ------------------------------------------------ |
 | `npm:@tintinweb/pi-subagents`            | 并行 SubAgent、后台任务与工作树隔离              |
 | `npm:@tintinweb/pi-tasks`                | Claude Code 风格任务跟踪与协调                   |
 | `npm:pi-mcp-adapter`                     | 按需发现 MCP 工具，减少上下文占用                |
 | `npm:@ff-labs/pi-fff`                    | 模糊文件与内容检索（fffind / ffgrep）            |
 | `npm:pi-web-access`                      | 网页搜索、URL 抓取、GitHub 克隆、PDF/视频解析    |
-| `npm:pi-theme-picker`                    | 主题搜索和实时预览                               |
 | `npm:@narumitw/pi-usage`                 | 查看当前账号用量（Codex / Copilot / OpenRouter） |
 | `git:github.com/DietrichGebert/ponytail` | 极简编码：强制最懒但有效的方案                   |
 

package/extensions/config/config.ts

@@ -25,6 +25,12 @@ export type Config = {
 	animationIntervalMs: number;
 	showStartupHeader: boolean;
 	scrollStepLines: number;
+	enableSessionReference: boolean;
+	enableSubagentAutocomplete: boolean;
+	enableContextCommand: boolean;
+	enableAgentSummary: boolean;
+	enableWorkingMessage: boolean;
+	enableAliases: boolean;
 };
 
 const AGENT_DIR = process.env.PI_CODING_AGENT_DIR ?? join(homedir(), ".pi", "agent");
@@ -67,6 +73,12 @@ export const DEFAULT_CONFIG: Config = {
 	animationIntervalMs: 90,
 	showStartupHeader: true,
 	scrollStepLines: 3,
+	enableSessionReference: true,
+	enableSubagentAutocomplete: true,
+	enableContextCommand: true,
+	enableAgentSummary: true,
+	enableWorkingMessage: true,
+	enableAliases: true,
 };
 
 function pickEnum<T extends string>(value: unknown, allowed: readonly T[], fallback: T): T {
@@ -148,6 +160,12 @@ export function normalizeConfig(input: unknown): Config {
 		),
 		showStartupHeader: source.showStartupHeader !== false,
 		scrollStepLines: pickPositiveInt(source.scrollStepLines, DEFAULT_CONFIG.scrollStepLines, 1, 50),
+		enableSessionReference: source.enableSessionReference !== false,
+		enableSubagentAutocomplete: source.enableSubagentAutocomplete !== false,
+		enableContextCommand: source.enableContextCommand !== false,
+		enableAgentSummary: source.enableAgentSummary !== false,
+		enableWorkingMessage: source.enableWorkingMessage !== false,
+		enableAliases: source.enableAliases !== false,
 	};
 }
 
@@ -189,6 +207,12 @@ export function formatConfigStatus(source: Config = config): string {
 		`thinkingAnimation=${source.animationIntervalMs}ms`,
 		`startupHeader=${source.showStartupHeader ? "on" : "off"}`,
 		`scrollStep=${source.scrollStepLines}`,
+		`sessionRef=${source.enableSessionReference ? "on" : "off"}`,
+		`subagentAuto=${source.enableSubagentAutocomplete ? "on" : "off"}`,
+		`context=${source.enableContextCommand ? "on" : "off"}`,
+		`agentSummary=${source.enableAgentSummary ? "on" : "off"}`,
+		`workingMsg=${source.enableWorkingMessage ? "on" : "off"}`,
+		`aliases=${source.enableAliases ? "on" : "off"}`,
 	].join(" · ");
 }
 

package/extensions/config/panel.ts

@@ -64,6 +64,30 @@ function diffIndicatorDescription(mode: DiffIndicatorMode): string {
 	return "Vertical bar indicators on changed lines (default).";
 }
 
+/** 额外功能开关项：on/off 二值，描述随状态切换；切换后需重启生效。 */
+function featureToggleSetting(
+	id: string,
+	label: string,
+	onDescription: string,
+	offDescription: string,
+	current: boolean,
+) {
+	const setting = {
+		id,
+		label,
+		description: current ? onDescription : offDescription,
+		currentValue: current ? "on" : "off",
+		values: ["on", "off"],
+	};
+	return {
+		setting,
+		apply(on: boolean): void {
+			setting.currentValue = on ? "on" : "off";
+			setting.description = on ? onDescription : offDescription;
+		},
+	};
+}
+
 function buildExcludeRenderersSubmenu(
 	onClose: () => void,
 	onLiveChange: () => void,
@@ -334,7 +358,68 @@ export async function showCcstylePanel(
 				buildNumberInputSubmenu(theme, scrollStepSetting, closeSubmenu),
 		};
 
+		// 额外功能开关：注册于扩展加载期，切换后需重启（/reload）生效。
+		const sessionReferenceToggle = featureToggleSetting(
+			"enableSessionReference",
+			"Session reference",
+			"@ session mentions search & inject referenced session context. Next restart applies.",
+			"Session reference disabled.",
+			config.enableSessionReference,
+		);
+		const subagentAutocompleteToggle = featureToggleSetting(
+			"enableSubagentAutocomplete",
+			"Subagent autocomplete",
+			"@ subagent mentions suggest agents and inject delegation instructions. Next restart applies.",
+			"Subagent autocomplete disabled.",
+			config.enableSubagentAutocomplete,
+		);
+		const contextCommandToggle = featureToggleSetting(
+			"enableContextCommand",
+			"Context usage",
+			"/context shows context-window distribution with previews. Next restart applies.",
+			"Context command disabled.",
+			config.enableContextCommand,
+		);
+		const agentSummaryToggle = featureToggleSetting(
+			"enableAgentSummary",
+			"Agent summary",
+			"Append per-round tool stats after each agent turn. Next restart applies.",
+			"Agent summary disabled.",
+			config.enableAgentSummary,
+		);
+		const workingMessageToggle = featureToggleSetting(
+			"enableWorkingMessage",
+			"Working message",
+			"Extend Working... footer with token count and elapsed time. Next restart applies.",
+			"Native Working... footer only.",
+			config.enableWorkingMessage,
+		);
+		const aliasesToggle = featureToggleSetting(
+			"enableAliases",
+			"Aliases",
+			"/clear and /exit aliases enabled. Next restart applies.",
+			"Aliases disabled.",
+			config.enableAliases,
+		);
+		const featureToggles: Record<string, { apply: (on: boolean) => void }> = {
+			enableSessionReference: sessionReferenceToggle,
+			enableSubagentAutocomplete: subagentAutocompleteToggle,
+			enableContextCommand: contextCommandToggle,
+			enableAgentSummary: agentSummaryToggle,
+			enableWorkingMessage: workingMessageToggle,
+			enableAliases: aliasesToggle,
+		};
+
 		const onSettingChange = (id: string, value: string) => {
+			// 额外功能开关：字段名与配置布尔字段一一对应，切换后重启生效。
+			const featureToggle = featureToggles[id];
+			if (featureToggle) {
+				(config as unknown as Record<string, boolean>)[id] = value === "on";
+				featureToggle.apply(value === "on");
+				saveConfig();
+				ctx.ui.notify(`Updated ${id}: ${value} (next restart)`, "info");
+				return;
+			}
 			switch (id) {
 				case "mode": {
 					// 选项值带 Experimental 标记，选择后还原为真实 mode 值。
@@ -450,7 +535,16 @@ export async function showCcstylePanel(
 			{
 				id: "feature",
 				label: "Feature",
-				items: [startupHeaderSetting, scrollStepSetting],
+				items: [
+					startupHeaderSetting,
+					scrollStepSetting,
+					sessionReferenceToggle.setting,
+					subagentAutocompleteToggle.setting,
+					contextCommandToggle.setting,
+					agentSummaryToggle.setting,
+					workingMessageToggle.setting,
+					aliasesToggle.setting,
+				],
 			},
 		];
 

package/extensions/feature/agent-summary/core.ts

@@ -9,6 +9,8 @@
  */
 
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { formatDuration } from "../../utils/format.ts";
+export { formatDuration };
 
 /** 工具分类。 */
 export type AgentToolCategory = "bash" | "read" | "edit" | "write" | "other";
@@ -98,18 +100,6 @@ export class AgentRunSummary {
 	}
 }
 
-/** 毫秒 → "1h 2m 3s"/"2m 3s"/"3s"；低于 1 秒返回 ""（省略）。 */
-export function formatDuration(ms: number): string {
-	const totalSec = Math.floor(ms / 1000);
-	if (totalSec < 1) return "";
-	const hours = Math.floor(totalSec / 3600);
-	const minutes = Math.floor((totalSec % 3600) / 60);
-	const seconds = totalSec % 60;
-	if (hours > 0) return `${hours}h ${minutes}m ${seconds}s`;
-	if (minutes > 0) return `${minutes}m ${seconds}s`;
-	return `${seconds}s`;
-}
-
 const plural = (count: number) => (count === 1 ? "" : "s");
 
 /** 输出顺序：bash → read → edit → write → other → failed。 */

package/extensions/feature/compact-thinking.ts

@@ -94,7 +94,7 @@ type AssistantInternals = {
 };
 
 type PatchedPrototype = typeof AssistantMessageComponent.prototype & {
-	updateContent: (message: AssistantMessage) => void;
+	updateContent: (message: AssistantMessage, isStreaming?: boolean) => void;
 };
 
 // 配置由 claude-code-style 管控（installCompactThinking 注入初始值，
@@ -334,9 +334,14 @@ function compactThinking(pi: ExtensionAPI) {
 		);
 	}
 
-	prototype.updateContent = function patchedUpdateContent(message: AssistantMessage) {
+	prototype.updateContent = function patchedUpdateContent(
+		message: AssistantMessage,
+		isStreaming?: boolean,
+	) {
 		const component = this as AssistantMessageComponentLike;
 		const self = this as unknown as AssistantInternals;
+		// isStreaming 丢失 → mermaid 流式误渲染来回闪。
+		self.isStreaming = isStreaming ?? self.isStreaming;
 		self.lastMessage = message;
 		latestComponent = component;
 		latestComponentTimestamp = message.timestamp;
@@ -344,7 +349,7 @@ function compactThinking(pi: ExtensionAPI) {
 		// Visible mode is intentionally untouched: Shift+Tab restores Pi's exact
 		// built-in Thinking Markdown renderer, including every OpenAI summary stage.
 		if (!self.hideThinkingBlock) {
-			originalUpdateContent.call(this, message);
+			originalUpdateContent.call(this, message, self.isStreaming);
 			return;
 		}
 

package/extensions/feature/reference/subagent.ts

@@ -184,7 +184,6 @@ export default function agentAutocompleteExtension(pi: ExtensionAPI): void {
 
 		const agentMap = new Map(agents.map((a) => [a.name, a]));
 		const agentList = mentions.map((n) => `"${n}" (${agentMap.get(n)!.displayName})`).join(", ");
-		const agentTypes = mentions.map((n) => `"${n}"`).join(" | ");
 
 		return {
 			systemPrompt:

package/extensions/feature/shell/startup-header.ts

@@ -2,7 +2,7 @@ import { VERSION, type AppKeybinding } from "@earendil-works/pi-coding-agent";
 import { getKeybindings } from "@earendil-works/pi-tui";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { config } from "../../config/config.ts";
-
+import { ansi16ToRgb, ansi256ToRgb } from "../../utils/ansi-color.ts";
 type Rgb = [number, number, number];
 type StyledPart = {
 	raw: string;
@@ -40,25 +40,6 @@ const PALETTE_SPAN = 0.25;
 // 行间相位偏移：小步累加 → 整体左上暗→右下亮的对角渐变
 const LOGO_ROW_PHASE_STEP = 0.08;
 
-const ANSI_16_RGB_TABLE: Rgb[] = [
-	[0, 0, 0],
-	[128, 0, 0],
-	[0, 128, 0],
-	[128, 128, 0],
-	[0, 0, 128],
-	[128, 0, 128],
-	[0, 128, 128],
-	[192, 192, 192],
-	[128, 128, 128],
-	[255, 0, 0],
-	[0, 255, 0],
-	[255, 255, 0],
-	[0, 0, 255],
-	[255, 0, 255],
-	[0, 255, 255],
-	[255, 255, 255],
-];
-
 function stripAnsi(text: string): string {
 	return text.replace(ANSI_PATTERN, "");
 }
@@ -104,27 +85,6 @@ function applyTruecolor(rgb: Rgb, text: string): string {
 	return `\x1b[38;2;${red};${green};${blue}m${text}${ANSI_RESET}`;
 }
 
-function ansi16ToRgb(index: number): Rgb {
-	return ANSI_16_RGB_TABLE[index] ?? [255, 255, 255];
-}
-
-function ansi256ToRgb(index: number): Rgb {
-	if (index < 16) return ansi16ToRgb(index);
-
-	if (index >= 232) {
-		const gray = 8 + (index - 232) * 10;
-		return [gray, gray, gray];
-	}
-
-	const cubeIndex = index - 16;
-	const redIndex = Math.floor(cubeIndex / 36);
-	const greenIndex = Math.floor((cubeIndex % 36) / 6);
-	const blueIndex = cubeIndex % 6;
-	const values = [0, 95, 135, 175, 215, 255];
-
-	return [values[redIndex]!, values[greenIndex]!, values[blueIndex]!];
-}
-
 function parseTruecolorAnsi(ansi: string): Rgb | undefined {
 	const match = ansi.match(/38;2;(\d+);(\d+);(\d+)/);
 	if (!match) return undefined;

package/extensions/feature/shell/working-message.ts

@@ -1,19 +1,10 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { formatDuration } from "../../utils/format.ts";
 
 const REFRESH_INTERVAL_MS = 1_000;
 /** Elapsed time is only shown once the turn has run this long. */
 const SHOW_TIMER_AFTER_MS = 3_000;
 
-function formatDuration(ms: number): string {
-	const totalSec = Math.floor(ms / 1000);
-	const hours = Math.floor(totalSec / 3600);
-	const minutes = Math.floor((totalSec % 3600) / 60);
-	const seconds = totalSec % 60;
-	if (hours > 0) return `${hours}h ${minutes}m ${seconds}s`;
-	if (minutes > 0) return `${minutes}m ${seconds}s`;
-	return `${seconds}s`;
-}
-
 function formatCount(value: number): string {
 	return new Intl.NumberFormat("en-US").format(value);
 }
@@ -91,7 +82,10 @@ export default function (pi: ExtensionAPI): void {
 		const tokens = tokenCount();
 		const parts: string[] = [];
 		if (tokens > 0) parts.push(`↓ ${formatCount(tokens)} tokens`);
-		if (elapsed >= SHOW_TIMER_AFTER_MS || tokens > 0) parts.push(formatDuration(elapsed));
+		if (elapsed >= SHOW_TIMER_AFTER_MS || tokens > 0) {
+			// formatDuration 低于 1 秒返回 ""，此处回退 "0s" 保持计时器连续跳动。
+			parts.push(formatDuration(elapsed) || "0s");
+		}
 		return parts.length ? `Working... (${parts.join(" · ")})` : "";
 	}
 

package/extensions/index.ts

@@ -1,4 +1,5 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { config } from "./config/config.ts";
 
 // shell
 import piAliases from "./feature/shell/aliases.ts";
@@ -18,17 +19,17 @@ import markdownEnhance from "./renderer/markdown-enhance.ts";
 
 export default function (pi: ExtensionAPI): void {
 	// shell chrome
-	piAliases(pi);
+	if (config.enableAliases) piAliases(pi);
 	piStartupHeader(pi);
-	workingMessage(pi);
+	if (config.enableWorkingMessage) workingMessage(pi);
 
 	// render stack：thinking controller 直接交给 style 作 query
 	markdownEnhance(pi);
 	claudeCodeStyle(pi, undefined, installCompactThinking(pi, getCompactThinkingConfig()));
 
 	// features
-	context(pi);
-	sessionReference(pi);
-	agentAutocomplete(pi);
-	agentSummary(pi);
+	if (config.enableContextCommand) context(pi);
+	if (config.enableSessionReference) sessionReference(pi);
+	if (config.enableSubagentAutocomplete) agentAutocomplete(pi);
+	if (config.enableAgentSummary) agentSummary(pi);
 }

package/extensions/renderer/compact-mode.ts

@@ -33,12 +33,8 @@ import {
 } from "./tool/diff/diff-renderer.ts";
 import { renderRichToolResult } from "./tool/diff/index.ts";
 import type { WriteExecutionMetadataStore } from "./tool/diff/write-execution.ts";
-import {
-	insetComponent,
-	oneLine,
-	renderExpandedToolResult,
-	scheduleAnimation,
-} from "./tool/result.ts";
+import { insetComponent, renderExpandedToolResult, scheduleAnimation } from "./tool/result.ts";
+import { oneLine } from "../utils/format.ts";
 import { paddedBackgroundRow, stripBackgroundAnsi } from "./tool/grouping.ts";
 
 /** compact 渲染层对 compact-thinking 的只读查询面（不建第二套计时器）。 */
@@ -763,13 +759,13 @@ export function installCompactMode(deps: CompactModeInstallDeps): CompactModeHoo
 		dispose: () => {},
 	};
 
-	const passThroughAssistant = (component: any, message: any): any => {
+	const passThroughAssistant = (component: any, message: any, isStreaming?: boolean): any => {
 		const self = component as any;
 		if (self[ASSISTANT_REENTRY_KEY] === patch)
-			return patch.assistantNative.call(component, message);
+			return patch.assistantNative.call(component, message, isStreaming);
 		self[ASSISTANT_REENTRY_KEY] = patch;
 		try {
-			return patch.assistantOriginal.call(component, message);
+			return patch.assistantOriginal.call(component, message, isStreaming);
 		} finally {
 			delete self[ASSISTANT_REENTRY_KEY];
 		}
@@ -838,12 +834,20 @@ export function installCompactMode(deps: CompactModeInstallDeps): CompactModeHoo
 		if (render) renderRound(round);
 	};
 
-	const renderAssistantWithoutThinking = (component: any, message: any): any => {
+	const renderAssistantWithoutThinking = (
+		component: any,
+		message: any,
+		isStreaming?: boolean,
+	): any => {
 		const content = Array.isArray(message?.content) ? message.content : [];
-		const result = passThroughAssistant(component, {
-			...message,
-			content: content.filter((item: any) => item?.type !== "thinking"),
-		});
+		const result = passThroughAssistant(
+			component,
+			{
+				...message,
+				content: content.filter((item: any) => item?.type !== "thinking"),
+			},
+			isStreaming,
+		);
 		component.lastMessage = message;
 		return result;
 	};
@@ -973,18 +977,20 @@ export function installCompactMode(deps: CompactModeInstallDeps): CompactModeHoo
 		stopRoundTick();
 	};
 
-	patch.assistantInstalled = function (this: any, message: any) {
+	patch.assistantInstalled = function (this: any, message: any, isStreaming?: boolean) {
 		const self = this as any;
+		// 同 compact-thinking：isStreaming 丢失 → mermaid 流式误渲染来回闪。
+		if (isStreaming !== undefined) self.isStreaming = isStreaming;
 		if (self[ASSISTANT_REENTRY_KEY] === patch) {
-			return patch.assistantNative.call(this, message);
+			return patch.assistantNative.call(this, message, isStreaming);
 		}
 		self.lastMessage = message;
 		trackedAssistantComponents.add(this);
 		if (!patch.active || config.mode !== "compact") {
-			return passThroughAssistant(this, message);
+			return passThroughAssistant(this, message, isStreaming);
 		}
 		if (!self.contentContainer || typeof self.contentContainer.clear !== "function") {
-			return passThroughAssistant(this, message);
+			return passThroughAssistant(this, message, isStreaming);
 		}
 
 		const content = Array.isArray(message?.content) ? message.content : [];

package/extensions/renderer/default-mode.ts

@@ -7,14 +7,13 @@
 import { ToolExecutionComponent } from "@earendil-works/pi-coding-agent";
 import { Text, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import { config, getToolDisplayConfig, type CompactStyleMode } from "../config/config.ts";
-import { isToolCallHovered } from "./mouse/interaction.ts";
+import { isToolCallHovered } from "./mouse/hover.ts";
 import {
 	countLines,
 	hasExpandableDetail,
 	headTruncateToWidth,
 	insetComponent,
 	isToolExpanded,
-	oneLine,
 	outputLineCount,
 	pendingIcon,
 	renderCollapsedToolResultToWidth,
@@ -27,6 +26,7 @@ import {
 	toolIconColor,
 	toolViewportWidth,
 } from "./tool/result.ts";
+import { oneLine } from "../utils/format.ts";
 import { showMoreHintText } from "./show-more-hint.ts";
 import { renderRichToolResult, type WriteExecutionMetadataStore } from "./tool/diff/index.ts";
 import { getMessageDisplayTheme } from "./message-display.ts";
@@ -272,11 +272,16 @@ function renderExpandedTaskResult(
 					: task.status === "in_progress"
 						? "warning"
 						: "muted";
-			return `   ${theme.fg("accent", `#${task.id}`)} ${theme.fg(color, task.status)} ${theme.fg("dim", task.subject)}`;
+			return `${theme.fg("accent", `#${task.id}`)} ${theme.fg(color, task.status)} ${theme.fg("dim", task.subject)}`;
 		});
 		if (tasks.length > rows.length)
-			rows.push(theme.fg("muted", `   … ${tasks.length - rows.length} more tasks`));
-		return new Text(` ↳ ${theme.fg("muted", taskListSummary(tasks))}\n${rows.join("\n")}`, 0, 0);
+			rows.push(theme.fg("muted", `… ${tasks.length - rows.length} more tasks`));
+		// 贴左：外层展开卡片 Box(1,1) 提供 1 格 padding
+		return new Text(
+			`↳ ${theme.fg("muted", taskListSummary(tasks))}\n${rows.map((r) => `  ${r}`).join("\n")}`,
+			0,
+			0,
+		);
 	}
 	const line = text.trim();
 	if (!line || line.includes("\n")) return undefined;
@@ -294,7 +299,7 @@ function renderExpandedTaskResult(
 	} else if (toolName === "TaskStop") {
 		formatted = `${theme.fg("success", "Stopped")} ${theme.fg("muted", line)}`;
 	}
-	return formatted ? new Text(` ↳ ${formatted}`, 0, 0) : undefined;
+	return formatted ? new Text(`↳ ${formatted}`, 0, 0) : undefined;
 }
 
 /** 用 ccstyle call/result 包装任意工具定义。 */
@@ -328,15 +333,21 @@ function createCcstyleTool(
 			const summary = singleToolCallSummary(toolName, label, args);
 			let cachedWidth: number | undefined;
 			let cachedLine: string | undefined;
+			const expanded = Boolean(context?.expanded);
 			return {
 				render(width: number) {
 					if (cachedLine !== undefined && cachedWidth === width) return [cachedLine];
 					const viewportWidth = toolViewportWidth(width);
-					const callWidth = Math.max(0, viewportWidth - visibleWidth(icon) - 2);
+					// 展开态贴左（外层 Box 已 pad 1）；折叠 self-shell 保留 1 格前导空格
+					const lead = expanded ? "" : " ";
+					const callWidth = Math.max(
+						0,
+						viewportWidth - visibleWidth(icon) - 1 - (expanded ? 0 : 1),
+					);
 					const mainWidth = Math.max(0, callWidth - visibleWidth(summary.detail));
 					cachedWidth = width;
 					// 纯文本先截断再着色（省略号不带 ANSI）；从头截断，与多 tool 一致
-					cachedLine = ` ${icon} ${theme.fg("toolTitle", headTruncateToWidth(summary.main, mainWidth))}${theme.fg("dim", summary.detail)}`;
+					cachedLine = `${lead}${icon} ${theme.fg("toolTitle", headTruncateToWidth(summary.main, mainWidth))}${theme.fg("dim", summary.detail)}`;
 					return [truncateToWidth(cachedLine, viewportWidth, "")];
 				},
 				invalidate() {},
@@ -352,13 +363,15 @@ function createCcstyleTool(
 				);
 			}
 
+			const expanded = isToolExpanded(options, context);
 			if (options?.isPartial) {
-				return new Text(theme.fg("muted", "   ↳ Pending…"), 0, 0);
+				// 展开态贴左（Box 提供 1 格 pad）；折叠态保持 3 格对齐标题
+				const pending = expanded ? "↳ Pending…" : "   ↳ Pending…";
+				return new Text(theme.fg("muted", pending), 0, 0);
 			}
 
 			const isError = options?.isError || context?.isError;
 			setToolVisualState(context, isError ? "error" : "success");
-			const expanded = isToolExpanded(options, context);
 			const toolCallId = context?.toolCallId;
 			if (shouldRenderRichDiff(config.mode, toolName, Boolean(isError))) {
 				// getter 保证 Diff indicator / wrap / limits 下次绘制即更新
@@ -376,7 +389,8 @@ function createCcstyleTool(
 					writeExecutionMetadata,
 					getToolDisplayConfig,
 				);
-				if (richResult) return insetComponent(richResult);
+				// 展开态由 Box(1,1) 提供内边距；折叠态 inset 一级缩进
+				if (richResult) return expanded ? richResult : insetComponent(richResult);
 			}
 
 			const text = textFromResult(result, expanded);
@@ -393,7 +407,8 @@ function createCcstyleTool(
 				? taskListSummary(tasks)
 				: isError
 					? text
-						? oneLine(text)
+						? // 72 与原 result.ts 默认一致，保持错误摘要截断宽度。
+							oneLine(text, 72)
 						: "Failed"
 					: outputLines
 						? `${outputLines} ${lineWord} ${action}`
@@ -411,6 +426,7 @@ function createCcstyleTool(
 					context?.lastComponent,
 					args,
 					context,
+					true, // mode=on：贴左，由外层 Box(1,1) 提供 1 格 padding
 				);
 			}
 			if (context?.state) context.state.ccstyleIoView = undefined;
@@ -689,7 +705,12 @@ export function installToolExpandedBackground(): () => void {
 			const theme = getMessageDisplayTheme();
 			if (!theme?.bg) return;
 			const box = this.contentBox;
-			if (box?.setBgFn) box.setBgFn((text: string) => theme.bg("userMessageBg", text));
+			// 展开最外层卡片：上下左右内间距 1 格
+			if (box) {
+				box.paddingX = 1;
+				box.paddingY = 1;
+				if (box.setBgFn) box.setBgFn((text: string) => theme.bg("userMessageBg", text));
+			}
 		},
 		original,
 		dispose: () => {

package/extensions/renderer/index.ts

@@ -27,12 +27,11 @@ import {
 	installToolMouseInteraction,
 	resetToolHoverState,
 	scheduleSessionRender,
-	setHoveredToolGroup,
-	setHoveredToolIo,
 	teardownToolMouseInteraction,
 	TOOL_MOUSE_DISABLE,
 } from "./mouse/interaction.ts";
 import { getToolMouseTui } from "./mouse/scroll.ts";
+import { setHoveredToolGroup, setHoveredToolIo } from "./mouse/hover.ts";
 import { clearAllAnimations } from "./tool/result.ts";
 import { installWriteOverride, WriteExecutionMetadataStore } from "./tool/diff/index.ts";
 import {

package/extensions/renderer/markdown-enhance.ts

@@ -55,9 +55,8 @@ const ADMONITION_STYLE: Record<string, { icon: string; label: string }> = {
 };
 
 /**
- * 把 > [!TYPE] 及其后续 > 行转成两列表格（图标标签列 + 内容列），视觉上成提示框。
- * 表格 cell 内不支持换行（<br> 显示为字面量），多行内容用空格合并。
- * 返回 null 表示该行不是提示框。
+ * 把 > [!TYPE] 及其后续 > 行转成带加粗标签的引用块，视觉上成提示框。
+ * 多行内容用空格合并为一行。返回 null 表示该行不是提示框。
  */
 function renderAdmonition(lines: string[], i: number): { output: string[]; next: number } | null {
 	const m = lines[i].match(ADMONITION);
@@ -70,11 +69,11 @@ function renderAdmonition(lines: string[], i: number): { output: string[]; next:
 		j++;
 	}
 	while (body.length > 0 && body[body.length - 1].trim() === "") body.pop();
-	// 内容里的 | 转义，避免拆出额外表格列
-	const content = body.join(" ").trim().replace(/\|/g, "\\|");
-	// 表格后补空行，防止紧接的段落被解析为表格数据行
+	// 内容合并为一行，作为引用块正文
+	const content = body.join(" ").trim();
+	// 保留引用块形态，标签改为加粗图标+类型（pi 渲染为左侧竖线，比表格轻量）
 	return {
-		output: [`| ${style.icon} ${style.label} | ${content} |`, "|---|---|", ""],
+		output: [`> **${style.icon} ${style.label}**${content ? ` ${content}` : ""}`, ""],
 		next: j,
 	};
 }
@@ -222,7 +221,7 @@ function renderDiagrams(
 	return out.join("\n");
 }
 
-/** GitHub 风格提示框 → 两列表格（跳过代码块）。 */
+/** GitHub 风格提示框 → 加粗标签引用块（跳过代码块）。 */
 function renderAdmonitions(markdown: string): string {
 	const lines = markdown.split("\n");
 	const out: string[] = [];

package/extensions/renderer/mouse/hover.ts

@@ -22,11 +22,13 @@ export function sharedToolHoverState(): SharedToolHoverState {
 	return (host[TOOL_HOVER_STATE_KEY] ??= { toolCallId: null });
 }
 
+// 状态单源在 globalThis 槽；hoveredToolCallId 变量仅为兼容旧 deep import 保留
+// （外部扩展可能直接从 interaction.ts re-export 读取），内部读取一律走槽。
 export let hoveredToolCallId: string | null = sharedToolHoverState().toolCallId;
 
 export function setHoveredToolCallId(toolCallId: string | null): void {
-	hoveredToolCallId = toolCallId;
 	sharedToolHoverState().toolCallId = toolCallId;
+	hoveredToolCallId = toolCallId;
 }
 
 export function isToolCallHovered(toolCallId: string | null | undefined): boolean {

package/extensions/renderer/mouse/interaction.ts

@@ -158,7 +158,6 @@ function toggleToolAtMouseClick(tui: any, packet: SgrMousePacket): boolean {
 	if (region.kind === "show-more") return tryOpenToolIoShowMore(region);
 	const component = region.component;
 	if (!component) return false;
-	const width = Math.max(1, Number(tui?.terminal?.columns) || 80);
 	if (region.kind === "expanded-card") {
 		component.setExpanded(false);
 		setHoveredToolCallId(null);

package/extensions/renderer/mouse/scroll.ts

@@ -74,10 +74,10 @@ export function resetScrollButtonState(): void {
 
 let scrollButtonSyncScheduled = false;
 
+// 交互开关只取决于配置模式：原实现按 isLazyProxyTui(toolMouseTui) 分两分支，
+// 两分支恒真（0.84+ 惰性 Proxy 下判定不再影响开关），折叠为单条件。
 export function toolMouseInteractionActive(): boolean {
-	if (config.mode === "off") return false;
-	if (isLazyProxyTui(toolMouseTui)) return true;
-	return true;
+	return config.mode !== "off";
 }
 
 /** 惰性 Proxy 官方 fullscreen（TuiAltScreen）判定。 */

package/extensions/renderer/tool/diff/diff-renderer.ts

@@ -19,6 +19,7 @@ import {
 	isFiniteSgrParam,
 	expandSgrReset,
 } from "./ansi-utils.ts";
+import { ansi256ToRgb } from "../../../utils/ansi-color.ts";
 import {
 	buildCollapsedDiffHintText,
 	clampRenderedLineToWidth,
@@ -1076,46 +1077,10 @@ function buildInlineHighlightMap(rows: SplitDiffRow[]): WeakMap<DiffLineEntry, D
 	return highlights;
 }
 
-function ansi256ToRgb(code: number): RgbColor {
-	if (code < 0) {
-		return { r: 0, g: 0, b: 0 };
-	}
-	if (code <= 15) {
-		const base16: RgbColor[] = [
-			{ r: 0, g: 0, b: 0 },
-			{ r: 128, g: 0, b: 0 },
-			{ r: 0, g: 128, b: 0 },
-			{ r: 128, g: 128, b: 0 },
-			{ r: 0, g: 0, b: 128 },
-			{ r: 128, g: 0, b: 128 },
-			{ r: 0, g: 128, b: 128 },
-			{ r: 192, g: 192, b: 192 },
-			{ r: 128, g: 128, b: 128 },
-			{ r: 255, g: 0, b: 0 },
-			{ r: 0, g: 255, b: 0 },
-			{ r: 255, g: 255, b: 0 },
-			{ r: 0, g: 0, b: 255 },
-			{ r: 255, g: 0, b: 255 },
-			{ r: 0, g: 255, b: 255 },
-			{ r: 255, g: 255, b: 255 },
-		];
-		return base16[code] ?? { r: 255, g: 255, b: 255 };
-	}
-	if (code >= 232) {
-		const value = Math.max(0, Math.min(255, 8 + (code - 232) * 10));
-		return { r: value, g: value, b: value };
-	}
-
-	const cube = code - 16;
-	const levels = [0, 95, 135, 175, 215, 255];
-	const blue = cube % 6;
-	const green = Math.floor(cube / 6) % 6;
-	const red = Math.floor(cube / 36) % 6;
-	return {
-		r: levels[red] ?? 0,
-		g: levels[green] ?? 0,
-		b: levels[blue] ?? 0,
-	};
+/** utils 版返回 tuple，此处适配为本文件使用的 RgbColor 形状。 */
+function ansi256ToRgbColor(code: number): RgbColor {
+	const [r, g, b] = ansi256ToRgb(code);
+	return { r, g, b };
 }
 
 function parseAnsiColorCode(ansi: string | undefined): RgbColor | null {
@@ -1140,14 +1105,14 @@ function parseAnsiColorCode(ansi: string | undefined): RgbColor | null {
 	if (bitMatch) {
 		const code = Number.parseInt(bitMatch[1] ?? "0", 10);
 		if (Number.isFinite(code)) {
-			return ansi256ToRgb(code);
+			return ansi256ToRgbColor(code);
 		}
 	}
 
 	const basicMatch = /\x1b\[(?:3|4)([0-7])m/.exec(ansi);
-	if (basicMatch) return ansi256ToRgb(Number(basicMatch[1]));
+	if (basicMatch) return ansi256ToRgbColor(Number(basicMatch[1]));
 	const brightMatch = /\x1b\[(?:9|10)([0-7])m/.exec(ansi);
-	if (brightMatch) return ansi256ToRgb(Number(brightMatch[1]) + 8);
+	if (brightMatch) return ansi256ToRgbColor(Number(brightMatch[1]) + 8);
 	return null;
 }
 

package/extensions/renderer/tool/grouping.ts

@@ -7,7 +7,7 @@ import {
 	type Component,
 } from "@earendil-works/pi-tui";
 import { TOOL_LOADING_INTERVAL_MS, toolLoadingIcon } from "../../utils/tool-loading-icon.ts";
-import { sanitizeToolResultText } from "../../utils/tool-result-sanitize.ts";
+import { oneLine } from "../../utils/format.ts";
 import { showMoreHintText } from "../show-more-hint.ts";
 
 const PATCH_KEY = Symbol.for("pi.ccstyle.tool-grouping-patch");
@@ -147,13 +147,6 @@ export function paddedBackgroundRow(
 	return `${bgAnsi}${stable}\x1b[49m`;
 }
 
-function oneLine(value: unknown, max = 96): string {
-	const text = sanitizeToolResultText(String(value ?? ""), 4096)
-		.replace(/\s+/g, " ")
-		.trim();
-	return text.length > max ? `${text.slice(0, max - 1)}…` : text;
-}
-
 function humanizeToolName(name: string): string {
 	return name
 		.replace(/([a-z0-9])([A-Z])/g, "$1 $2")
@@ -395,7 +388,8 @@ export class ToolGroupComponent extends Container {
 			const childLines = rendered.length ? rendered : [toolSummary(tool).main];
 			for (let lineIndex = 0; lineIndex < childLines.length; lineIndex++) {
 				const content =
-					lineIndex === 0 ? childLines[lineIndex] : stripLeadingSpaces(childLines[lineIndex], 2);
+					// 续行只剥外层 Box 的 1 格 left pad，保留 Input/Output 相对缩进
+					lineIndex === 0 ? childLines[lineIndex] : stripLeadingSpaces(childLines[lineIndex], 1);
 				const prefix =
 					lineIndex === 0
 						? `${fg("dim", branch)} ${fg(color, statusIcon(toolStatus))} `

package/extensions/renderer/tool/result.ts

@@ -23,13 +23,6 @@ export function insetComponent(component: any): any {
 	};
 }
 
-export function oneLine(value: unknown, max = 72): string {
-	const text = sanitizeToolResultText(String(value ?? ""))
-		.replace(/\s+/g, " ")
-		.trim();
-	return text.length > max ? `${text.slice(0, max - 1)}…` : text;
-}
-
 function rawTextFromResult(result: any): string {
 	return Array.isArray(result?.content)
 		? result.content
@@ -233,6 +226,8 @@ const EXPANDED_TOOL_IO_VIEW_GENERATION = Symbol("ccstyle-expanded-tool-io-view")
  *   └ Output  click to show more
  *     result line…
  *
+ * flushLeft=true（仅 mode=on 展开卡）：去掉树线前导空格，由外层 Box(1,1) 提供 1 格 padding。
+ *
  * Reused across re-renders via context.lastComponent when possible.
  */
 export class ExpandedToolIoView {
@@ -251,6 +246,9 @@ export class ExpandedToolIoView {
 	/** 0-based header line indexes that carry show-more after last render. */
 	private showMoreHeaderRows: { input?: number; output?: number } = {};
 
+	/** flushLeft：贴左渲染（mode=on 展开卡）；默认 false 保留前导空格（compact 等共用路径）。 */
+	private flushLeft: boolean;
+
 	constructor(
 		theme: any,
 		inputBody: string,
@@ -258,6 +256,7 @@ export class ExpandedToolIoView {
 		isError: boolean,
 		maxOutputLines = config.expandedPreviewMaxLines,
 		maxInputLines = config.expandedPreviewMaxLines,
+		flushLeft = false,
 	) {
 		this.theme = theme;
 		this.inputBody = inputBody;
@@ -265,6 +264,7 @@ export class ExpandedToolIoView {
 		this.isError = isError;
 		this.maxOutputLines = Math.max(1, maxOutputLines);
 		this.maxInputLines = Math.max(1, maxInputLines);
+		this.flushLeft = flushLeft;
 	}
 
 	setContent(
@@ -273,16 +273,19 @@ export class ExpandedToolIoView {
 		isError: boolean,
 		maxOutputLines?: number,
 		maxInputLines?: number,
+		flushLeft?: boolean,
 	): void {
 		const nextOut =
 			maxOutputLines !== undefined ? Math.max(1, maxOutputLines) : this.maxOutputLines;
 		const nextIn = maxInputLines !== undefined ? Math.max(1, maxInputLines) : this.maxInputLines;
+		const nextFlush = flushLeft !== undefined ? flushLeft : this.flushLeft;
 		if (
 			this.inputBody === inputBody &&
 			this.outputBody === outputBody &&
 			this.isError === isError &&
 			this.maxOutputLines === nextOut &&
-			this.maxInputLines === nextIn
+			this.maxInputLines === nextIn &&
+			this.flushLeft === nextFlush
 		) {
 			return;
 		}
@@ -291,6 +294,7 @@ export class ExpandedToolIoView {
 		this.isError = isError;
 		this.maxOutputLines = nextOut;
 		this.maxInputLines = nextIn;
+		this.flushLeft = nextFlush;
 		this.invalidate();
 	}
 
@@ -348,7 +352,9 @@ export class ExpandedToolIoView {
 
 		const theme = this.theme;
 		const safeWidth = Math.max(1, Math.floor(width));
-		const rail = " │ ";
+		// flushLeft：贴左（外层 Box 负责 1 格 pad）；否则保留 1 格前导空格（compact 共用）
+		const lead = this.flushLeft ? "" : " ";
+		const rail = `${lead}│ `;
 		const railWidth = visibleWidth(rail);
 		const bodyWidth = toolViewportWidth(safeWidth);
 		const contentWidth = Math.max(1, bodyWidth - railWidth);
@@ -363,7 +369,7 @@ export class ExpandedToolIoView {
 			section: ToolIoSection,
 			showMore: boolean,
 		) => {
-			const mark = theme.fg("dim", ` ${corner} `);
+			const mark = theme.fg("dim", `${lead}${corner} `);
 			const title = theme.fg(
 				"accent",
 				typeof theme.bold === "function" ? theme.bold(label) : label,
@@ -378,12 +384,13 @@ export class ExpandedToolIoView {
 		};
 
 		const pushRailLine = (styledContent: string, continued = true) => {
-			const prefix = continued ? rail : "   ";
+			// 续行 rail；Output 正文相对 └ 缩进 2 格（+ 可选 lead）
+			const prefix = continued ? rail : `${lead}  `;
 			lines.push(truncateToWidth(theme.fg("dim", prefix) + styledContent, safeWidth, ""));
 		};
 
 		const pushBlankRail = () => {
-			lines.push(truncateToWidth(theme.fg("dim", " │"), safeWidth, ""));
+			lines.push(truncateToWidth(theme.fg("dim", `${lead}│`), safeWidth, ""));
 		};
 
 		/** Style `key: value` input rows — dim keys, readable values. */
@@ -654,6 +661,8 @@ export function renderExpandedToolResult(
 	lastComponent?: unknown,
 	args?: unknown,
 	context?: any,
+	/** mode=on 展开卡贴左；compact 等保持默认前导空格 */
+	flushLeft = false,
 ): ExpandedToolIoView | ExpandedToolResultText | Text {
 	const inputBody = formatToolInputArgs(args);
 	const outputBody = body;
@@ -663,10 +672,18 @@ export function renderExpandedToolResult(
 	if (inputBody.trim() || outputBody.trim()) {
 		let view: ExpandedToolIoView;
 		if (isExpandedToolIoView(lastComponent)) {
-			lastComponent.setContent(inputBody, outputBody, isError, maxLines, maxLines);
+			lastComponent.setContent(inputBody, outputBody, isError, maxLines, maxLines, flushLeft);
 			view = lastComponent;
 		} else {
-			view = new ExpandedToolIoView(theme, inputBody, outputBody, isError, maxLines, maxLines);
+			view = new ExpandedToolIoView(
+				theme,
+				inputBody,
+				outputBody,
+				isError,
+				maxLines,
+				maxLines,
+				flushLeft,
+			);
 		}
 		if (context) rememberIoView(context, view);
 		return view;

package/extensions/utils/ansi-color.ts

@@ -0,0 +1,44 @@
+/** ANSI 16 色 → RGB（标准 xterm 色序）。 */
+const ANSI_16_RGB: readonly [number, number, number][] = [
+	[0, 0, 0],
+	[128, 0, 0],
+	[0, 128, 0],
+	[128, 128, 0],
+	[0, 0, 128],
+	[128, 0, 128],
+	[0, 128, 128],
+	[192, 192, 192],
+	[128, 128, 128],
+	[255, 0, 0],
+	[0, 255, 0],
+	[255, 255, 0],
+	[0, 0, 255],
+	[255, 0, 255],
+	[0, 255, 255],
+	[255, 255, 255],
+];
+
+/** ANSI 16 色码（0-15）→ RGB；越界回退白。 */
+export function ansi16ToRgb(index: number): [number, number, number] {
+	return ANSI_16_RGB[index] ?? [255, 255, 255];
+}
+
+/** ANSI 256 色码 → RGB（0-15 标准色 + 232-255 灰阶 + 16-231 六阶立方体）。 */
+export function ansi256ToRgb(code: number): [number, number, number] {
+	// SGR 正则可解析任意位数字，入口先规范：取整并钳制到合法区间，
+	// 否则灰阶分支对 code > 255 会算出超出 0-255 的非法 RGB。
+	if (!Number.isFinite(code)) return [0, 0, 0];
+	code = Math.min(255, Math.max(0, Math.trunc(code)));
+	if (code < 16) return ansi16ToRgb(code);
+	if (code >= 232) {
+		const gray = 8 + (code - 232) * 10;
+		return [gray, gray, gray];
+	}
+	const cubeIndex = code - 16;
+	const levels = [0, 95, 135, 175, 215, 255];
+	return [
+		levels[Math.floor(cubeIndex / 36)]!,
+		levels[Math.floor((cubeIndex % 36) / 6)]!,
+		levels[cubeIndex % 6]!,
+	];
+}

package/extensions/utils/format.ts

@@ -0,0 +1,21 @@
+import { sanitizeToolResultText } from "./tool-result-sanitize.ts";
+
+/** 毫秒 → "1h 2m 3s"/"2m 3s"/"3s"；低于 1 秒返回 ""（省略）。 */
+export function formatDuration(ms: number): string {
+	const totalSec = Math.floor(ms / 1000);
+	if (totalSec < 1) return "";
+	const hours = Math.floor(totalSec / 3600);
+	const minutes = Math.floor((totalSec % 3600) / 60);
+	const seconds = totalSec % 60;
+	if (hours > 0) return `${hours}h ${minutes}m ${seconds}s`;
+	if (minutes > 0) return `${minutes}m ${seconds}s`;
+	return `${seconds}s`;
+}
+
+/** 文本单行化：去换行空白，超宽截断加省略号。 */
+export function oneLine(value: unknown, max = 96): string {
+	const text = sanitizeToolResultText(String(value ?? ""), 4096)
+		.replace(/\s+/g, " ")
+		.trim();
+	return text.length > max ? `${text.slice(0, max - 1)}…` : text;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-cc-extensions",
-	"version": "0.8.54",
+	"version": "0.8.56",
 	"license": "MIT",
 	"description": "A Pi productivity suite with Claude Code-style UI, context inspection, and agent/session references",
 	"type": "module",
@@ -42,7 +42,8 @@
 		"format": "biome format --write .",
 		"format:check": "biome format .",
 		"docs:tool-render": "node scripts/generate-tool-render-examples.mjs",
-		"preversion": "npm run format && npm run typecheck && npm test && npm run docs:tool-render",
+		"lint": "biome check .",
+		"preversion": "npm run format && npm run lint && npm run typecheck && npm test && npm run docs:tool-render",
 		"release": "npm version patch && npm publish",
 		"release:minor": "npm version minor && npm publish",
 		"release:major": "npm version major && npm publish"