pi-cc-extensions 0.8.56 → 0.8.59

package/extensions/renderer/compact-mode.ts

@@ -24,8 +24,8 @@ import { config, getToolDisplayConfig } from "../config/config.ts";
 import { toolLoadingIcon } from "../utils/tool-loading-icon.ts";
 import { sanitizeToolResultText } from "../utils/tool-result-sanitize.ts";
 import { refreshTranscriptComponent } from "./transcript-refresh.ts";
-import { getMessageDisplayTheme } from "./message-display.ts";
-import { showMoreHintText } from "./show-more-hint.ts";
+import { getMessageDisplayTheme } from "./tool/message-display.ts";
+import { showMoreHintText } from "./tool/show-more-hint.ts";
 import {
 	countEditDiffStats,
 	countWriteDiffStats,
@@ -35,7 +35,21 @@ import { renderRichToolResult } from "./tool/diff/index.ts";
 import type { WriteExecutionMetadataStore } from "./tool/diff/write-execution.ts";
 import { insetComponent, renderExpandedToolResult, scheduleAnimation } from "./tool/result.ts";
 import { oneLine } from "../utils/format.ts";
-import { paddedBackgroundRow, stripBackgroundAnsi } from "./tool/grouping.ts";
+import { paddedBackgroundRow } from "./tool/grouping.ts";
+import { hasVisibleText, stripBackgroundAnsi } from "../utils/ansi-text.ts";
+import { walkComponentTree } from "../utils/component-tree.ts";
+import {
+	ASSISTANT_REENTRY_DESCRIPTION,
+	ASSISTANT_REENTRY_KEY,
+	ASSISTANT_SET_EXPANDED_DESCRIPTION,
+	ASSISTANT_SET_EXPANDED_KEY,
+	ASSISTANT_TOGGLE_ROUND_DESCRIPTION,
+	ASSISTANT_TOGGLE_ROUND_KEY,
+	COMPACT_MODE_PATCH_KEY,
+	COMPACT_THINKING_PATCH_KEY,
+	patchRegistry,
+	PROTOTYPE_ORIGINAL_KEY,
+} from "../utils/patch-keys.ts";
 
 /** compact 渲染层对 compact-thinking 的只读查询面（不建第二套计时器）。 */
 export type CompactThinkingQuery = {
@@ -45,16 +59,6 @@ export type CompactThinkingQuery = {
 	setCompactSummaryActive?(active: boolean): void;
 };
 
-const COMPACT_MODE_PATCH_KEY = Symbol.for("pi.ccstyle.compact-mode-patch");
-const COMPACT_THINKING_PATCH_KEY = Symbol.for("pi.ccstyle.compact-thinking-update");
-const PROTOTYPE_ORIGINAL_KEY = Symbol.for("pi.ccstyle.prototype-original");
-const ASSISTANT_SET_EXPANDED_DESCRIPTION = "pi.ccstyle.compact-assistant-set-expanded";
-const ASSISTANT_TOGGLE_ROUND_DESCRIPTION = "pi.ccstyle.compact-assistant-toggle-round";
-const ASSISTANT_REENTRY_DESCRIPTION = "pi.ccstyle.compact-assistant-reentry";
-const ASSISTANT_SET_EXPANDED_KEY = Symbol.for(ASSISTANT_SET_EXPANDED_DESCRIPTION);
-const ASSISTANT_TOGGLE_ROUND_KEY = Symbol.for(ASSISTANT_TOGGLE_ROUND_DESCRIPTION);
-const ASSISTANT_REENTRY_KEY = Symbol.for(ASSISTANT_REENTRY_DESCRIPTION);
-
 const EDIT_WRITE_TOOLS = new Set(["edit", "write"]);
 
 type CompactThinkingTheme = Pick<Theme, "fg" | "italic" | "bold">;
@@ -284,16 +288,6 @@ function darkenBgAnsi(theme: any, slot: string): string {
 	return `\x1b[48;2;${r};${g};${b}m`;
 }
 
-/** 去掉行内所有 CSI/OSC 序列后是否有可见文本（判断工具卡首尾内容行）。 */
-function hasVisibleText(line: string): boolean {
-	return (
-		line
-			.replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, "")
-			.replace(/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g, "")
-			.trim().length > 0
-	);
-}
-
 /** 工具卡深色行：左右内缩（左 2 右 3 格，含工具卡自身 padding），背景只到内容区，
  *  修复行尾 reset 截断。 */
 function toolCardBgRow(
@@ -314,7 +308,7 @@ function toolCardBgRow(
 	const body = ` ${clipped}${" ".repeat(pad)} `;
 	const stable = body.replace(/\x1b\[(?:0)?m/g, (reset) => reset + bgAnsi);
 	const outerBg = typeof theme?.getBgAnsi === "function" ? String(theme.getBgAnsi(slot)) : "";
-	const inset = (n) => (outerBg ? `${outerBg}${" ".repeat(n)}\x1b[49m` : " ".repeat(n));
+	const inset = (n: number) => (outerBg ? `${outerBg}${" ".repeat(n)}\x1b[49m` : " ".repeat(n));
 	return `${inset(leftInset)}${bgAnsi}${stable}\x1b[49m${inset(rightInset)}`;
 }
 /** edit/write 展开卡：保持原样式（userMessageBg Box），不应用工具卡深色/间距改动。 */
@@ -694,16 +688,9 @@ function ensureAssistantSetExpanded(component: any): void {
 
 function collectMountedComponents(root: any): void {
 	if (!root || typeof root !== "object") return;
-	const seen = new Set<any>();
 	const assistants = new Set<any>();
 	const tools = new Set<any>();
-	const visit = (value: any): void => {
-		if (!value || typeof value !== "object" || seen.has(value)) return;
-		seen.add(value);
-		if (Array.isArray(value)) {
-			for (const child of value) visit(child);
-			return;
-		}
+	walkComponentTree(root, (value: any) => {
 		if (isAssistantComponent(value)) {
 			assistants.add(value);
 			// 仅在 compact 模式给实例装 setExpanded，避免 on/off 下 Ctrl+O/mouse 回归。
@@ -711,20 +698,7 @@ function collectMountedComponents(root: any): void {
 		} else if (isToolComponent(value)) {
 			tools.add(value);
 		}
-		const children = value.children;
-		if (Array.isArray(children)) {
-			for (const child of children) visit(child);
-		}
-		try {
-			const mounted = value.getMountedRoots?.();
-			if (Array.isArray(mounted)) {
-				for (const root2 of mounted) visit(root2);
-			}
-		} catch {
-			// renderer 切换中的惰性 Proxy 可能暂时没有 mounted roots
-		}
-	};
-	visit(root);
+	});
 	// 扫到组件才替换跟踪表。面板/custom UI 打开时 root 往往扫不到 transcript，
 	// 若此时清空会丢掉 live updateContent/updateDisplay 已登记的实例，
 	// /ccstyle 切换就只能靠 /reload 重建。
@@ -739,8 +713,7 @@ function collectMountedComponents(root: any): void {
 }
 
 export function installCompactMode(deps: CompactModeInstallDeps): CompactModeHooks {
-	const host = globalThis as any;
-	const previous = host[COMPACT_MODE_PATCH_KEY] as CompactModePatch | undefined;
+	const previous = patchRegistry.get<CompactModePatch>(COMPACT_MODE_PATCH_KEY);
 	if (previous) previous.dispose();
 
 	const assistantPrototype = AssistantMessageComponent.prototype as any;
@@ -1149,7 +1122,7 @@ export function installCompactMode(deps: CompactModeInstallDeps): CompactModeHoo
 		if (toolPrototype.updateDisplay === patch.toolInstalledUpdateDisplay) {
 			toolPrototype.updateDisplay = patch.toolOriginalUpdateDisplay;
 		}
-		if (host[COMPACT_MODE_PATCH_KEY] === patch) delete host[COMPACT_MODE_PATCH_KEY];
+		patchRegistry.dispose(COMPACT_MODE_PATCH_KEY, patch);
 		for (const component of trackedAssistantComponents) detachAssistantExpansion(component);
 		trackedAssistantComponents.clear();
 		trackedToolComponents.clear();
@@ -1160,7 +1133,7 @@ export function installCompactMode(deps: CompactModeInstallDeps): CompactModeHoo
 	assistantPrototype.updateContent = patch.assistantInstalled;
 	toolPrototype.render = patch.toolInstalledRender;
 	toolPrototype.updateDisplay = patch.toolInstalledUpdateDisplay;
-	host[COMPACT_MODE_PATCH_KEY] = patch;
+	patchRegistry.install(COMPACT_MODE_PATCH_KEY, patch);
 
 	const syncGlobalExpanded = (ctx: any): void => {
 		let globalExpanded = false;

package/extensions/renderer/default-mode.ts

@@ -7,6 +7,12 @@
 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 {
+	COMPONENT_TOOL_RENDER_MODE,
+	GLOBAL_TOOL_RENDER_PATCH,
+	patchRegistry,
+	TOOL_EXPANDED_BACKGROUND_PATCH,
+} from "../utils/patch-keys.ts";
 import { isToolCallHovered } from "./mouse/hover.ts";
 import {
 	countLines,
@@ -27,25 +33,15 @@ import {
 	toolViewportWidth,
 } from "./tool/result.ts";
 import { oneLine } from "../utils/format.ts";
-import { showMoreHintText } from "./show-more-hint.ts";
+import { showMoreHintText } from "./tool/show-more-hint.ts";
 import { renderRichToolResult, type WriteExecutionMetadataStore } from "./tool/diff/index.ts";
-import { getMessageDisplayTheme } from "./message-display.ts";
+import { getMessageDisplayTheme } from "./tool/message-display.ts";
+import { humanizeToolLabel, toolCallSummary } from "./tool/names.ts";
 
 // 成功勾：亮绿 truecolor（与 message-display 一致）
 const BRIGHT_GREEN = "\x1b[38;2;80;220;100m";
 const ANSI_FG_RESET = "\x1b[39m";
 
-const GLOBAL_TOOL_RENDER_PATCH = Symbol.for("pi.ccstyle.global-tool-render-patch");
-const COMPONENT_TOOL_RENDER_MODE = Symbol.for("pi.ccstyle.component-tool-render-mode");
-const COMPONENT_TOOL_SELF_SHELL_MODE = Symbol.for("pi.ccstyle.component-tool-self-shell-mode");
-const TOOL_EXPANDED_BACKGROUND_PATCH = Symbol.for("pi.ccstyle.tool-expanded-background-patch");
-
-const AGENT_FAMILY_TOOL_NAMES = new Set([
-	"Agent",
-	"Agents",
-	"get_subagent_result",
-	"steer_subagent",
-]);
 // pi-subagents 等扩展为 Agent 提供专用渲染器，ccstyle 必须保留。
 const DEDICATED_RENDERER_TOOLS = new Set(["Agent"]);
 
@@ -141,94 +137,6 @@ function renderDefault(tool: any, slot: "renderCall" | "renderResult", args: any
 	return new Text(fallback, 0, 0);
 }
 
-function humanizeToolLabel(label: string): string {
-	return label
-		.replace(/([a-z0-9])([A-Z])/g, "$1 $2")
-		.replace(/[_-]+/g, " ")
-		.replace(/\b\w/g, (char) => char.toUpperCase());
-}
-
-function singleToolCallSummary(
-	toolName: string,
-	label: string,
-	args: any,
-): { main: string; detail: string } {
-	const title = label === toolName ? humanizeToolLabel(label) : label;
-	if (!args || typeof args !== "object") return { main: title, detail: "" };
-	const name = toolName.toLowerCase();
-	const value = (fallback: string, ...keys: string[]) => {
-		const found = keys.map((key) => args[key]).find((item) => typeof item === "string" && item);
-		// 与多 tool 摘要对齐：从头截断，上限 96 字符（tool-grouping oneLine 默认值）。
-		return `${title} ${oneLine(found || fallback, 96)}`;
-	};
-	if (AGENT_FAMILY_TOOL_NAMES.has(toolName) && args.agent_id) {
-		return { main: `${title} ${oneLine(args.agent_id, 96)}`, detail: "" };
-	}
-	// Agents 走 ccstyle wrapper；Agent 保留专用渲染器。
-	if (name === "agents") {
-		return {
-			main: value("launch agents", "description", "prompt"),
-			detail: "",
-		};
-	}
-	if (name === "skill") return { main: value("run skill", "name"), detail: "" };
-	if (name === "enterplanmode" || name === "enter_plan_mode") {
-		return { main: `${title} enable read-only planning`, detail: "" };
-	}
-	if (name === "exitplanmode" || name === "exit_plan_mode") {
-		return { main: `${title} present plan`, detail: "" };
-	}
-	if (name === "taskcreate") return { main: value("create task", "subject"), detail: "" };
-	if (name === "tasklist") return { main: `${title} task list`, detail: "" };
-	if (name === "taskget" || name === "taskupdate") {
-		return { main: value("task", "taskId", "task_id"), detail: "" };
-	}
-	if (name === "taskoutput" || name === "taskstop") {
-		return { main: value("background task", "task_id", "taskId"), detail: "" };
-	}
-	if (name === "taskexecute") {
-		const ids = Array.isArray(args.task_ids)
-			? args.task_ids
-			: Array.isArray(args.taskIds)
-				? args.taskIds
-				: [];
-		const summary = ids.length
-			? `${ids[0]}${ids.length > 1 ? ` (+${ids.length - 1} tasks)` : ""}`
-			: "start tasks";
-		return { main: `${title} ${summary}`, detail: "" };
-	}
-	if (toolName === "read") {
-		const details = [
-			args.offset !== undefined ? `offset=${args.offset}` : "",
-			args.limit !== undefined ? `limit=${args.limit}` : "",
-		].filter(Boolean);
-		return {
-			main: `${title}${args.path ? ` ${oneLine(args.path, 96)}` : ""}`,
-			detail: details.length ? ` (${details.join(", ")})` : "",
-		};
-	}
-	const preferred =
-		args.path ??
-		args.file_path ??
-		args.command ??
-		args.query ??
-		args.question ??
-		args.pattern ??
-		args.url ??
-		args.name ??
-		args.tool_use_id ??
-		args.toolCallId ??
-		args.id ??
-		args.message;
-	return {
-		main:
-			preferred !== undefined && preferred !== null && typeof preferred !== "object"
-				? `${title} ${oneLine(preferred, 96)}`
-				: title,
-		detail: "",
-	};
-}
-
 type ParsedTask = { id: string; status: string; subject: string };
 
 function parseTaskList(text: string): ParsedTask[] {
@@ -330,7 +238,10 @@ function createCcstyleTool(
 				visualState === "success"
 					? `${BRIGHT_GREEN}${rawIcon}${ANSI_FG_RESET}`
 					: theme.fg(toolIconColor(context), rawIcon);
-			const summary = singleToolCallSummary(toolName, label, args);
+			const summary = toolCallSummary(toolName, args, {
+				title: label === toolName ? humanizeToolLabel(label) : label,
+				variant: "default",
+			});
 			let cachedWidth: number | undefined;
 			let cachedLine: string | undefined;
 			const expanded = Boolean(context?.expanded);
@@ -485,11 +396,6 @@ function shouldGloballyStyleTool(component: any, patch: GlobalToolRenderPatch):
 	return useCcstyle;
 }
 
-function shouldUseSelfShell(component: any, _patch: GlobalToolRenderPatch): boolean {
-	component[COMPONENT_TOOL_SELF_SHELL_MODE] = false;
-	return false;
-}
-
 function getGloballyStyledTool(component: any, patch: GlobalToolRenderPatch): any {
 	const definition = component.toolDefinition ?? component.builtInToolDefinition;
 	if (definition && typeof definition === "object") {
@@ -527,21 +433,6 @@ function isOwnershipAwarePatch(value: any): value is GlobalToolRenderPatch {
 	);
 }
 
-function isLegacyInstalledWrapper(method: unknown, downstreamField: string): boolean {
-	if (typeof method !== "function") return false;
-	try {
-		const source = Function.prototype.toString.call(method);
-		return (
-			source.includes(downstreamField) &&
-			(source.includes("shouldGloballyStyleTool") ||
-				source.includes("shouldUseSelfShell") ||
-				source.includes("getGloballyStyledTool"))
-		);
-	} catch {
-		return false;
-	}
-}
-
 function downstreamForGlobalToolInstall(prototype: any, previous: any): ToolRenderMethods {
 	const current = prototypeToolRenderMethods(prototype);
 	if (!previous || previous.prototype !== prototype) return current;
@@ -566,27 +457,26 @@ function downstreamForGlobalToolInstall(prototype: any, previous: any): ToolRend
 		};
 	}
 
-	// pre-v2 Symbol 无 wrapper 引用；能识别则回退，否则保留当前方法为 external。
-	const legacyDownstream = (method: Function, field: string): Function => {
-		const saved = previous[field];
-		return typeof saved === "function" && isLegacyInstalledWrapper(method, field) ? saved : method;
-	};
+	// pre-v2 Symbol：originalX 显式记录真实下游（native 原型方法），无需源码嗅探。
+	// 缺失字段回退到当前原型方法（视作 external）。
+	const originalOrCurrent = (field: string, method: Function): Function =>
+		typeof previous[field] === "function" ? previous[field] : method;
 	return {
-		hasRendererDefinition: legacyDownstream(
-			current.hasRendererDefinition,
+		hasRendererDefinition: originalOrCurrent(
 			"originalHasRendererDefinition",
+			current.hasRendererDefinition,
 		) as ToolRenderMethods["hasRendererDefinition"],
-		getRenderShell: legacyDownstream(
-			current.getRenderShell,
+		getRenderShell: originalOrCurrent(
 			"originalGetRenderShell",
+			current.getRenderShell,
 		) as ToolRenderMethods["getRenderShell"],
-		getCallRenderer: legacyDownstream(
-			current.getCallRenderer,
+		getCallRenderer: originalOrCurrent(
 			"originalGetCallRenderer",
+			current.getCallRenderer,
 		) as ToolRenderMethods["getCallRenderer"],
-		getResultRenderer: legacyDownstream(
-			current.getResultRenderer,
+		getResultRenderer: originalOrCurrent(
 			"originalGetResultRenderer",
+			current.getResultRenderer,
 		) as ToolRenderMethods["getResultRenderer"],
 	};
 }
@@ -606,8 +496,7 @@ function installGlobalToolRendering(
 	writeExecutionMetadata: WriteExecutionMetadataStore,
 ): GlobalToolRenderPatch {
 	const prototype = (ToolExecutionComponent as any).prototype;
-	const host = globalThis as any;
-	const previous = host[GLOBAL_TOOL_RENDER_PATCH];
+	const previous = patchRegistry.get<GlobalToolRenderPatch>(GLOBAL_TOOL_RENDER_PATCH);
 	const downstream = downstreamForGlobalToolInstall(prototype, previous);
 	// 外部仍持有的旧 wrapper 先变为无回调 pass-through，再挂新安装。
 	disconnectGlobalToolRenderPatch(previous);
@@ -637,14 +526,12 @@ function installGlobalToolRendering(
 		},
 		getRenderShell: function (this: any, ...args: any[]) {
 			if (!patch.active) return patch.downstream.getRenderShell.apply(this, args);
-			const useSelfShell = shouldUseSelfShell(this, patch);
 			const useCcstyle = shouldGloballyStyleTool(this, patch);
-			const shell =
-				useSelfShell || (useCcstyle && !this.expanded)
-					? "self"
-					: useCcstyle
-						? "default"
-						: patch.downstream.getRenderShell.apply(this, args);
+			const shell = useCcstyle
+				? this.expanded
+					? "default"
+					: "self"
+				: patch.downstream.getRenderShell.apply(this, args);
 			syncToolShell(this, shell);
 			return shell;
 		},
@@ -666,7 +553,7 @@ function installGlobalToolRendering(
 	prototype.getRenderShell = patch.installed.getRenderShell;
 	prototype.getCallRenderer = patch.installed.getCallRenderer;
 	prototype.getResultRenderer = patch.installed.getResultRenderer;
-	host[GLOBAL_TOOL_RENDER_PATCH] = patch;
+	patchRegistry.install(GLOBAL_TOOL_RENDER_PATCH, patch);
 	return patch;
 }
 
@@ -691,8 +578,7 @@ function deactivateGlobalToolRendering(patch: GlobalToolRenderPatch): void {
 /** 展开面板背景统一为 user message 背景色；折叠行保持原生状态色。
  *  必须在 compact-mode 之后安装，shutdown 时先于 compact-mode 释放。 */
 export function installToolExpandedBackground(): () => void {
-	const host = globalThis as any;
-	const previous = host[TOOL_EXPANDED_BACKGROUND_PATCH] as ToolExpandedBackgroundPatch | undefined;
+	const previous = patchRegistry.get<ToolExpandedBackgroundPatch>(TOOL_EXPANDED_BACKGROUND_PATCH);
 	if (previous) previous.dispose();
 	const prototype = ToolExecutionComponent.prototype as unknown as { updateDisplay: () => void };
 	const original = prototype.updateDisplay;
@@ -718,13 +604,11 @@ export function installToolExpandedBackground(): () => void {
 			if (prototype.updateDisplay === patch.installed) {
 				prototype.updateDisplay = original;
 			}
-			if (host[TOOL_EXPANDED_BACKGROUND_PATCH] === patch) {
-				delete host[TOOL_EXPANDED_BACKGROUND_PATCH];
-			}
+			patchRegistry.dispose(TOOL_EXPANDED_BACKGROUND_PATCH, patch);
 		},
 	};
 	prototype.updateDisplay = patch.installed;
-	host[TOOL_EXPANDED_BACKGROUND_PATCH] = patch;
+	patchRegistry.install(TOOL_EXPANDED_BACKGROUND_PATCH, patch);
 	return patch.dispose;
 }
 
@@ -736,7 +620,7 @@ export function installDefaultMode(
 	return {
 		isOwner() {
 			return (
-				(globalThis as any)[GLOBAL_TOOL_RENDER_PATCH] === globalToolRendering &&
+				patchRegistry.owns(GLOBAL_TOOL_RENDER_PATCH, globalToolRendering) &&
 				globalToolRendering.active
 			);
 		},

package/extensions/renderer/index.ts

@@ -14,12 +14,13 @@ import {
 } from "./default-mode.ts";
 import { isLazyProxyTui } from "../utils/fullscreen-detect.ts";
 import { showCcstylePanel } from "../config/panel.ts";
+import { GLOBAL_COMPACTION_RENDER_PATCH, patchRegistry } from "../utils/patch-keys.ts";
 import {
 	config,
 	formatConfigStatus,
 	normalizeConfig,
-	saveConfig,
 	setConfig,
+	updateConfig,
 	type CompactStyleMode,
 	type Config,
 } from "../config/config.ts";
@@ -38,7 +39,7 @@ import {
 	installMessageDisplayRendering,
 	refreshMessageDisplays,
 	setMessageDisplayTheme,
-} from "./message-display.ts";
+} from "./tool/message-display.ts";
 
 /**
  * Claude Code Style for pi — 装配入口。
@@ -48,8 +49,6 @@ import {
  * 共用        → tool-grouping / message-display / mouse / write override
  */
 
-const GLOBAL_COMPACTION_RENDER_PATCH = Symbol.for("pi.ccstyle.compaction-render-patch");
-
 let compactModeHooks: CompactModeHooks | undefined;
 
 function refreshCurrentTranscript(ctx?: any, toolGrouping?: ToolGroupingHooks): void {
@@ -68,8 +67,7 @@ function syncCompactMode(ctx: any): void {
 }
 
 function applyStyleMode(mode: CompactStyleMode, ctx: any, toolGrouping?: ToolGroupingHooks): void {
-	config.mode = mode;
-	saveConfig();
+	updateConfig({ mode });
 	if (mode === "off") {
 		// Native rendering：清 hover/click，关闭鼠标上报以恢复终端默认滚轮。
 		resetToolHoverState();
@@ -101,9 +99,7 @@ type LegacyCompactionRenderPatch = {
 
 /** Disable the pre-native compaction monkey patch left alive by /reload. */
 function deactivateLegacyCompactionRendering() {
-	const patch = (globalThis as any)[GLOBAL_COMPACTION_RENDER_PATCH] as
-		| LegacyCompactionRenderPatch
-		| undefined;
+	const patch = patchRegistry.get<LegacyCompactionRenderPatch>(GLOBAL_COMPACTION_RENDER_PATCH);
 	if (patch) patch.enabled = () => false;
 }
 

package/extensions/renderer/markdown-enhance.ts

@@ -71,7 +71,7 @@ function renderAdmonition(lines: string[], i: number): { output: string[]; next:
 	while (body.length > 0 && body[body.length - 1].trim() === "") body.pop();
 	// 内容合并为一行，作为引用块正文
 	const content = body.join(" ").trim();
-	// 保留引用块形态，标签改为加粗图标+类型（pi 渲染为左侧竖线，比表格轻量）
+	// 保留引用块形态（pi 渲染为左侧竖线），标签加粗
 	return {
 		output: [`> **${style.icon} ${style.label}**${content ? ` ${content}` : ""}`, ""],
 		next: j,
@@ -82,14 +82,23 @@ function renderAdmonition(lines: string[], i: number): { output: string[]; next:
 // 裸 URL 转可点击超链接
 // ============================================================================
 
-const URL_RE = /(?<!<)(?<!\]\()https?:\/\/[^\s<>'"|，。；：！？、」』】]+/g;
-const TRIM_URL_RE = /[.,;:!?】」』"'》]+$/;
+const URL_RE = /(?<!<)(?<!\]\()https?:\/\/[^\s<>'"|，。；：！？、」』】（）【】《》『』「」]+/g;
+const TRIM_URL_RE = /[.,;:!?】」』"'》）}]+$/;
 
-/** 去掉 URL 尾部标点；括号按平衡保留（如 Wikipedia 链接含括号）。 */
+/**
+ * 去掉 URL 尾部标点；括号按平衡保留（如 Wikipedia 链接含括号、
+ * IPv6 地址含 [::1]），尾部不成对的 ] 与 ) 会截掉。
+ */
 function trimUrl(url: string): string {
 	let t = url.replace(TRIM_URL_RE, "");
-	while (t.endsWith(")") && (t.match(/\(/g)?.length ?? 0) < (t.match(/\)/g)?.length ?? 0)) {
-		t = t.slice(0, -1);
+	for (;;) {
+		if (t.endsWith(")") && (t.match(/\(/g)?.length ?? 0) < (t.match(/\)/g)?.length ?? 0)) {
+			t = t.slice(0, -1);
+		} else if (t.endsWith("]") && (t.match(/\[/g)?.length ?? 0) < (t.match(/\]/g)?.length ?? 0)) {
+			t = t.slice(0, -1);
+		} else {
+			break;
+		}
 	}
 	return t;
 }

package/extensions/renderer/mouse/hover.ts

@@ -1,4 +1,5 @@
 import { setHoveredCompactAssistant } from "../compact-mode.ts";
+import { patchRegistry, TOOL_HOVER_STATE_KEY } from "../../utils/patch-keys.ts";
 import {
 	isExpandedToolIoView,
 	invalidateIoView,
@@ -9,8 +10,6 @@ import type { ToolGroupComponent } from "../tool/grouping.ts";
 import { componentAtLocalRow, type ComponentRowHit } from "./layout.ts";
 import { setScrollButtonHovered } from "./scroll.ts";
 
-const TOOL_HOVER_STATE_KEY = Symbol.for("pi.ccstyle.tool-hover-state");
-
 type SharedToolHoverState = { toolCallId: string | null };
 
 /**
@@ -18,8 +17,7 @@ type SharedToolHoverState = { toolCallId: string | null };
  * 测试依赖该跨实例语义。
  */
 export function sharedToolHoverState(): SharedToolHoverState {
-	const host = globalThis as any;
-	return (host[TOOL_HOVER_STATE_KEY] ??= { toolCallId: null });
+	return patchRegistry.ensure(TOOL_HOVER_STATE_KEY, () => ({ toolCallId: null }));
 }
 
 // 状态单源在 globalThis 槽；hoveredToolCallId 变量仅为兼容旧 deep import 保留

package/extensions/renderer/mouse/interaction.ts

@@ -1,9 +1,10 @@
 import { hasActiveTextPreview, showTextPreview } from "../../feature/context.ts";
+import { patchRegistry, TOOL_MOUSE_OWNER_KEY } from "../../utils/patch-keys.ts";
 import { ToolGroupComponent } from "../tool/grouping.ts";
 import { isCompactAssistantComponent, setHoveredCompactAssistant } from "../compact-mode.ts";
 import { config } from "../../config/config.ts";
 import { isLazyProxyTui } from "../../utils/fullscreen-detect.ts";
-import { setToolTuiFullscreen } from "../show-more-hint.ts";
+import { setToolTuiFullscreen } from "../tool/show-more-hint.ts";
 import {
 	type ExpandedToolIoView,
 	getActiveIoViewFrame,
@@ -81,7 +82,6 @@ const TOOL_MOUSE_WIDGET_KEY = "ccstyle-tool-mouse";
 const TOOL_MOUSE_MOTION_ENABLE = "\x1b[?1003h\x1b[?1006h";
 const TOOL_MOUSE_MOTION_DISABLE = "\x1b[?1003l";
 const FULLSCREEN_MOTION_ENABLED = Symbol("ccstyle.fullscreen-motion-enabled");
-const TOOL_MOUSE_OWNER_KEY = Symbol.for("pi.ccstyle.tool-mouse-owner");
 const DEFAULT_TOOL_MOUSE_OWNER = {};
 export const TOOL_MOUSE_DISABLE = "\x1b[?1006l\x1b[?1003l\x1b[?1000l";
 
@@ -768,8 +768,8 @@ function handleToolMouseInput(data: string): { consume: true } | undefined {
 export function teardownToolMouseInteraction(
 	owner: object = toolMouseInstallationOwner ?? DEFAULT_TOOL_MOUSE_OWNER,
 ): void {
-	const host = globalThis as any;
-	if (host[TOOL_MOUSE_OWNER_KEY] && host[TOOL_MOUSE_OWNER_KEY] !== owner) return;
+	const current = patchRegistry.get<object>(TOOL_MOUSE_OWNER_KEY);
+	if (current && current !== owner) return;
 	if (sessionRenderTimer) {
 		clearTimeout(sessionRenderTimer);
 		sessionRenderTimer = null;
@@ -796,7 +796,7 @@ export function teardownToolMouseInteraction(
 	resetScrollButtonState();
 	setToolMouseTui(null);
 	toolMouseUi = null;
-	if (host[TOOL_MOUSE_OWNER_KEY] === owner) delete host[TOOL_MOUSE_OWNER_KEY];
+	patchRegistry.dispose(TOOL_MOUSE_OWNER_KEY, owner);
 	if (toolMouseInstallationOwner === owner) toolMouseInstallationOwner = null;
 }
 
@@ -819,7 +819,7 @@ export function installToolMouseInteraction(
 		return;
 
 	toolMouseInstallationOwner = owner;
-	(globalThis as any)[TOOL_MOUSE_OWNER_KEY] = owner;
+	patchRegistry.install(TOOL_MOUSE_OWNER_KEY, owner);
 	setHoveredToolCallId(null);
 	toolMouseUi = ctx.ui;
 	// 0.84+ 的 tui 是惰性 Proxy：regular 保留原生 scrollback；fullscreen