pi-cc-extensions 1.0.6 → 1.0.8

package/README.en.md

@@ -28,7 +28,7 @@ Run `/reload` after installation.
 | Feature                     | Description                                                                                                                                  | Entry point                                     |
 | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
 | Claude Code UI              | Tool summaries, expand/collapse, rich edit/write diffs, and `on` / `compact` / `off` modes                                                   | `/ccstyle`                                      |
-| Markdown enhancements       | Mermaid diagrams, admonitions, URL linking, and more                                                                                         | Automatic                                       |
+| Markdown enhancements       | Mermaid dialects and circled-number conversion                                                                                               | Automatic; turn off with `enableMarkdownEnhance: false` |
 | Fullscreen mode             | Tool card/group expand and collapse on click, previews, hover highlight, and a back-to-bottom button                                         | `TUIMODE=fullscreen` or `--tui-mode fullscreen` |
 | Settings panel              | `Style / Features / UI / Diff / Thinking / Footer` tabs                                                                                      | `/ccstyle`                                      |
 | Context inspection          | Usage breakdown and previews for the system prompt, memory, skills, tools definition, and messages                                           | `/context`                                      |
@@ -55,6 +55,7 @@ Renderer snapshots for `on` / `compact` modes: [default](./docs/tool-render-exam
   "enableAgentSummary": true,              // per-turn tool summary
   "enableWorkingMessage": true,            // Working... bottom token/elapsed
   "enableAliases": true,                   // /clear, /exit aliases
+  "enableMarkdownEnhance": true,             // markdown pass: Mermaid dialects and circled-number conversion; false hands it to other extensions
   "enableEditorPrefix": true,              // editor ❯ prefix
 
   // ui
@@ -97,6 +98,8 @@ Renderer snapshots for `on` / `compact` modes: [default](./docs/tool-render-exam
 
 > [!TIP]
 > **Fullscreen**: click `click to show more` to expand tool cards, thinking, Skill, and compact summaries. An expanded diff always shows every line; when expanded Input/Output exceeds the line cap, the footer `… +N more lines · click to show more` opens a full preview. Click to collapse.
+>
+> Both `scrollButtonMode` values show the same `Back to bottom` / `N new message(s)` text: `dock` draws it in a dedicated row, `native` in Pi’s floating overlay.
 
 > [!NOTE]
 > **Mermaid rendering**: 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.
@@ -115,10 +118,11 @@ pi -e .              # one run, does not edit settings.json
 
 ## Recommended companions
 
-| Extension                | Purpose                                                     |
-| ------------------------ | ----------------------------------------------------------- |
-| `npm:pi-web-access`      | Web search, URL fetching, GitHub cloning, PDF/video parsing |
-| `npm:@narumitw/pi-usage` | Current-account usage for Codex / Copilot / OpenRouter      |
+| Extension                                | Purpose                                                     |
+| ---------------------------------------- | ----------------------------------------------------------- |
+| `npm:pi-web-access`                      | Web search, URL fetching, GitHub cloning, PDF/video parsing |
+| `npm:@narumitw/pi-usage`                 | Current-account usage for Codex / Copilot / OpenRouter      |
+| `npm:@juicesharp/rpiv-ask-user-question` | Multiple-choice questionnaire the model can ask you         |
 
 ## Credits
 

package/README.md

@@ -28,7 +28,7 @@ pi install git:github.com/minuque/pi-cc-extensions
 | 功能                  | 说明                                                                            | 入口                                            |
 | --------------------- | ------------------------------------------------------------------------------- | ----------------------------------------------- |
 | Claude Code UI        | 工具摘要、折叠展开、rich edit/write diff，以及`on` / `compact` / `off` 三种模式 | `/ccstyle`                                      |
-| Markdown 增强         | Mermaid 图、提示框、URL 链接化等                                                        | 自动生效                                        |
+| Markdown 增强         | Mermaid 方言渲染、圈数字转半角括号                                                         | 自动生效；`enableMarkdownEnhance: false` 关闭   |
 | Fullscreen mode       | 工具卡/group 单击展开与收起、预览、hover 高亮、回到底部按钮                 | `TUIMODE=fullscreen` 或 `--tui-mode fullscreen` |
 | 配置面板              | `Style / Features / UI / Diff / Thinking / Footer` 六页签                       | `/ccstyle`                                      |
 | 上下文检查            | 查看上下文占用，并预览 System prompt、Memory、Skills、Tools definition 和消息内容 | `/context`                                      |
@@ -55,6 +55,7 @@ pi install git:github.com/minuque/pi-cc-extensions
   "enableAgentSummary": true,              // 每回合工具摘要
   "enableWorkingMessage": true,            // Working... 底部 token/耗时
   "enableAliases": true,                   // /clear、/exit 别名
+  "enableMarkdownEnhance": true,             // markdown 转换：Mermaid 方言渲染、圈数字转半角括号；false 让位给其他扩展
   "enableEditorPrefix": true,              // 输入框 ❯ 前缀
 
   // ui
@@ -97,6 +98,8 @@ pi install git:github.com/minuque/pi-cc-extensions
 
 > [!TIP]
 > **全屏模式**：单击 `click to show more` 展开工具卡、思考、Skill 和 compact 摘要；工具卡展开态 diff 全量显示，Input/Output 超行时末行 `… +N more lines · click to show more` 打开全量预览，单击收起。
+>
+> `scrollButtonMode` 两种模式文案相同（`Back to bottom` / `N new message(s)`）：`dock` 画在独占行，`native` 画在 Pi 原生浮层。
 
 > [!NOTE]
 > **Mermaid 渲染**：建议把 `markdown.mermaid` 设为 `final`（`~/.pi/agent/settings.json` 或 `/settings` 面板的 Mermaid diagrams 选项）。默认 `streaming` 逐帧重绘，`final` 渲染最终版更稳定。
@@ -119,6 +122,7 @@ pi -e .              # 只跑一次，不改 settings.json
 | ---------------------------------------- | ------------------------------------------------ |
 | `npm:pi-web-access`                      | 网页搜索、URL 抓取、GitHub 克隆、PDF/视频解析    |
 | `npm:@narumitw/pi-usage`                 | 查看当前账号用量（Codex / Copilot / OpenRouter） |
+| `npm:@juicesharp/rpiv-ask-user-question` | 模型拿不准时向你提问的选择题面板                 |
 
 ## 致谢
 

package/extensions/config/config.ts

@@ -66,7 +66,7 @@ export type Config = {
 	showStartupHeader: boolean;
 	/** fullscreen：userMessage 正文首行滚出视口上沿后钉住，直到下一条指令接手。 */
 	stickyUserMessage: boolean;
-	/** fullscreen 回到底部按钮：扩展 dock 行，或 Pi 原生浮层。 */
+	/** fullscreen 回到底部按钮：扩展 dock 行，或 Pi 原生浮层；两者文案相同。 */
 	scrollButtonMode: ScrollButtonMode;
 	enableSessionReference: boolean;
 	enableSubagentAutocomplete: boolean;
@@ -74,6 +74,8 @@ export type Config = {
 	enableAgentSummary: boolean;
 	enableWorkingMessage: boolean;
 	enableAliases: boolean;
+	/** markdown 转换：Mermaid 方言渲染、圈数字转半角括号。关掉让位给其他扩展。 */
+	enableMarkdownEnhance: boolean;
 	/** 输入框 `❯ ` 前缀（占左侧 2 列，颜色随 thinking/bash mode 联动）。 */
 	enableEditorPrefix: boolean;
 	enableCustomFooter: boolean;
@@ -157,6 +159,7 @@ export const DEFAULT_CONFIG: Config = {
 	enableAgentSummary: true,
 	enableWorkingMessage: true,
 	enableAliases: true,
+	enableMarkdownEnhance: true,
 	enableEditorPrefix: true,
 	enableCustomFooter: true,
 	footerTokenRate: true,
@@ -290,6 +293,7 @@ export function normalizeConfig(input: unknown): Config {
 		enableAgentSummary: source.enableAgentSummary !== false,
 		enableWorkingMessage: source.enableWorkingMessage !== false,
 		enableAliases: source.enableAliases !== false,
+		enableMarkdownEnhance: source.enableMarkdownEnhance !== false,
 		enableEditorPrefix: (source.enableEditorPrefix ?? source.enableInputPrompt) !== false, // 兼容旧配置键
 		enableCustomFooter: source.enableCustomFooter !== false,
 		footerTokenRate: source.footerTokenRate !== false,
@@ -361,6 +365,7 @@ export function formatConfigStatus(source: Config = config): string {
 		`agentSummary=${source.enableAgentSummary ? "on" : "off"}`,
 		`workingMsg=${source.enableWorkingMessage ? "on" : "off"}`,
 		`aliases=${source.enableAliases ? "on" : "off"}`,
+		`markdownEnhance=${source.enableMarkdownEnhance ? "on" : "off"}`,
 		`editorPrefix=${source.enableEditorPrefix ? "on" : "off"}`,
 		`footer=${source.enableCustomFooter ? "on" : "off"}`,
 		`footerTokenRate=${source.footerTokenRate ? "on" : "off"}`,

package/extensions/config/panel.ts

@@ -604,11 +604,11 @@ export async function showCcstylePanel(
 		};
 		const scrollButtonSetting = {
 			id: "scrollButtonMode",
-			label: "Scroll to bottom",
+			label: "Scroll button mode",
 			description:
 				config.scrollButtonMode === "dock"
 					? "Fullscreen: show the extension's dedicated Back to bottom row."
-					: "Fullscreen: use Pi's native floating Jump to latest overlay.",
+					: "Fullscreen: show the same Back to bottom text in Pi's native floating overlay.",
 			currentValue: config.scrollButtonMode,
 			values: [...SCROLL_BUTTON_MODES],
 		};
@@ -656,6 +656,13 @@ export async function showCcstylePanel(
 			"Aliases disabled.",
 			config.enableAliases,
 		);
+		const markdownEnhanceToggle = featureToggleSetting(
+			"enableMarkdownEnhance",
+			"Markdown enhance",
+			"Mermaid dialects and circled-number conversion. Next restart applies.",
+			"Markdown enhancements off; another extension can own the markdown pass.",
+			config.enableMarkdownEnhance,
+		);
 		const footerCurrencySetting = {
 			id: "footerCurrency",
 			label: "Cost currency",
@@ -798,6 +805,7 @@ export async function showCcstylePanel(
 			enableAgentSummary: agentSummaryToggle,
 			enableWorkingMessage: workingMessageToggle,
 			enableAliases: aliasesToggle,
+			enableMarkdownEnhance: markdownEnhanceToggle,
 		};
 
 		const onSettingChange = (id: string, value: string) => {
@@ -1012,7 +1020,7 @@ export async function showCcstylePanel(
 					scrollButtonSetting.description =
 						config.scrollButtonMode === "dock"
 							? "Fullscreen: show the extension's dedicated Back to bottom row."
-							: "Fullscreen: use Pi's native floating Jump to latest overlay.";
+							: "Fullscreen: show the same Back to bottom text in Pi's native floating overlay.";
 					break;
 				}
 				case "showStartupHeader": {
@@ -1049,6 +1057,7 @@ export async function showCcstylePanel(
 					agentSummaryToggle.setting,
 					workingMessageToggle.setting,
 					aliasesToggle.setting,
+					markdownEnhanceToggle.setting,
 				],
 			},
 			{

package/extensions/feature/shell/footer-layout.ts

@@ -40,10 +40,7 @@ const LEGACY_FIXED_FOOTER_KEYS = [
 	FOOTER_GIT_KEY,
 ] as const;
 
-const BUILTIN_FOOTER_KEYS = new Set<string>([
-	...DEFAULT_FOOTER_LINE1_KEYS,
-	...DEFAULT_FOOTER_LINE2_KEYS,
-]);
+const BUILTIN_FOOTER_KEYS = new Set<string>(LEGACY_FIXED_FOOTER_KEYS);
 
 export function isBuiltinFooterKey(key: string): boolean {
 	return BUILTIN_FOOTER_KEYS.has(key);

package/extensions/feature/shell/token-rate.ts

@@ -3,8 +3,10 @@
  *
  * average：一次用户指令的墙钟平均（工具等待计入分母），显示 `avg`。
  * live：最近 1 秒的瞬时速率，生成期暂停时钟，显示 `live`；指令结束定格为整段平均。
- * token 与 working-message 同源：优先 provider `usage.output`，否则按 delta 增量估算
- * （CJK 1 token，其余 chars/4）。provider 值回填到本段消息窗口。
+ * token 与 working-message 同源：变大的 provider `usage.output` 覆盖估算，否则按 delta 累加
+ * （CJK 1 token，其余 chars/4）。没有变大的 usage 不当作累计值：Anthropic 的 message_start
+ * 会给出一个很小的 output_tokens，并在每个 partial 上重复，直到最后的 message_delta。
+ * 消息结束时用 message_end 上的 usage 定格本段总量。
  * Pi 的 turn 是单次 assistant 消息，工具调用结束会开新 turn。token 跨 turn 累加，
  * 计时与 TTFT 直到下一条用户指令才重置。
  * TTFT：用户指令开始到第一个内容块（text/thinking/toolcall）开始的毫秒数，
@@ -120,15 +122,29 @@ export function sampleTokenDelta(delta: string, now = Date.now()): void {
 }
 
 /**
- * 记录本段 provider `usage.output`。usage 按锚点摊回窗口：
+ * 记录本段 provider `usage.output`。变大的 usage 按锚点摊回窗口：
  * 首次报告从消息起点铺到现在，之后每次把增量摊在上次报告之后。
+ * 没有变大的报告直接忽略，避免 message_start 的占位值反复覆盖 delta 累计。
+ * `final` 用于消息结束：以本次 output 为本段总量，估算偏高偏低都按它修正。
+ * 结束值含未逐字流出的思考 token，它们不属于最近一秒，所以窗口只整体平移，不回填。
  */
-export function recordProviderUsage(output: number, now = Date.now()): void {
+export function recordProviderUsage(output: number, now = Date.now(), final = false): void {
 	if (!runStartTime || output <= 0) return;
+	if (final) {
+		const shift = output - currentTokens;
+		for (const sample of samples) sample.cum += shift;
+		countedUsage = output;
+		currentTokens = output;
+		usageAnchorTime = now;
+		usageAnchorTokens = output;
+		updateRates(now);
+		return;
+	}
+	if (output <= countedUsage) return;
 	const firstReport = countedUsage === 0;
 	const jump = output - countedUsage;
 	countedUsage = output;
-	// provider 是权威计数；首次报告以它为准，之后增量接管。
+	// 变大的 provider 计数是权威值，覆盖本段估算。
 	currentTokens = output;
 	if (firstReport) {
 		samples = samples.filter((sample) => sample.t < usageAnchorTime);

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

@@ -49,9 +49,9 @@ export default function (pi: ExtensionAPI): void {
 		return totalTokens();
 	}
 
-	function updateProviderUsage(message: StreamMessage): void {
+	function updateProviderUsage(message: StreamMessage, final = false): void {
 		const output = outputUsage(message);
-		if (output > 0) recordProviderUsage(output);
+		if (output > 0) recordProviderUsage(output, Date.now(), final);
 	}
 
 	function buildWorkingMessage(): string {
@@ -171,13 +171,20 @@ export default function (pi: ExtensionAPI): void {
 			// 分段锚点只在 turn_start 重置。这里再重置会把累计 usage.output 当成新的首报。
 			markFirstToken();
 			updateProviderUsage(evt.partial);
-		} else if (evt.type === "thinking_delta" || evt.type === "text_delta") {
+		} else if (
+			evt.type === "thinking_delta" ||
+			evt.type === "text_delta" ||
+			evt.type === "toolcall_delta"
+		) {
+			// 工具参数走 toolcall_delta；不计入的话，写长文件这类调用期间 token 一直不涨。
 			if (typeof evt.delta === "string") sampleTokenDelta(evt.delta);
 			updateProviderUsage(evt.partial);
 		} else if (evt.type === "text_end" || evt.type === "thinking_end") {
 			updateProviderUsage(evt.partial);
 		} else if (evt.type === "done") {
-			updateProviderUsage(evt.message);
+			// Pi 目前不会把 done/error 转成 message_update，定格在下面的 message_end 里做。
+			// 这两个分支只在宿主直接转发 done/error 时生效；同一个值重复定格不改变结果。
+			updateProviderUsage(evt.message, true);
 		} else if (evt.type === "error") {
 			updateProviderUsage(evt.error);
 		} else {
@@ -188,6 +195,18 @@ export default function (pi: ExtensionAPI): void {
 		scheduleRefreshTick();
 	});
 
+	// message_delta 的累计 usage 只出现在 message_end 上，含未逐字流出的思考 token。
+	// message_end 在工具执行和 turn_end 之前，先于 carryTokenRate 结转。
+	pi.on("message_end", async (event, ctx) => {
+		const message = event?.message;
+		if (message?.role !== "assistant") return;
+		activeCtx = ctx;
+		// 出错/中断时 usage 可能还是 message_start 的占位值，只接受变大的值。
+		const failed = message.stopReason === "error" || message.stopReason === "aborted";
+		updateProviderUsage(message, !failed);
+		syncWorkingMessage();
+	});
+
 	pi.on("tool_execution_start", async () => {
 		pauseTokenRate();
 	});

package/extensions/index.ts

@@ -35,7 +35,8 @@ export default function (pi: ExtensionAPI): void {
 	});
 
 	// render stack：thinking controller 直接交给 style 作 query
-	markdownEnhance(pi);
+	// markdownEnhance 单独开关：其他扩展也注册 transformer 时会互相改写输出。
+	if (config.enableMarkdownEnhance) markdownEnhance(pi);
 	claudeCodeStyle(pi, undefined, installCompactThinking(pi, getCompactThinkingConfig()));
 
 	// features

package/extensions/renderer/compact-mode.ts

@@ -7,9 +7,11 @@
  * 与 `editDiffCollapsedLines` / `writeDiffCollapsedLines` / `expandedPreviewMaxLines`。
  * Agent/Task 族：调用只进摘要计数，tool 卡始终折叠（避免 pending→完成高度闪动）。
  * edit/write 与 ask_user_question 留在外层：不进摘要计数，折叠态也单独成行。
+ * 外层行一旦在消息里出现，当前回合就地完结（不计静默期），后续消息另起回合：
+ * 摘要行因此只折叠连续的一段工具调用，展开/收起不再跨外层行搬位置。
  * 用户消息是回合的硬边界：steer 消息插进回合中间、或上一回合没正文就收尾时，回合
- * 就地收口、后续消息另起一回合，区间里的用户消息不会被当成外来行挪走（摘要行、
- * 展开面板因此留在自己回合的位置上）。
+ * 就地收口、后续消息另起一回合。custom 通知/summary 类组件既不是成员也不算外来行，
+ * 原地留在两段之间，不打断统计也不被挪位。
  * 底部 Agents/Tasks 面板由 pi-subagents/pi-tasks 独立 widget 负责，不经 tool 卡外置。
  *
  * live 围观态（回合进行中 / 收尾静默期）：正文跟折叠态同形；摘要行与单一槽位卡
@@ -30,6 +32,7 @@
  */
 import {
 	AssistantMessageComponent,
+	CustomMessageComponent,
 	SkillInvocationMessageComponent,
 	ToolExecutionComponent,
 	UserMessageComponent,
@@ -385,6 +388,9 @@ function layoutExpandedToolCard(
 ): { lines: string[]; hits: Array<{ child: any; start: number; end: number }> } {
 	const slot = aggregateToolCardBgSlot(children.map((child) => child?.__ccTool).filter(Boolean));
 	const toolBgAnsi = darkenBgAnsi(theme, slot);
+	// 展开面板外卡底色随组内工具状态聚合（与 default 模式分组卡同口径）：
+	// 有一个失败用失败底色、没有失败但有进行中用进行中底色、全成功用成功底色。
+	const outerSlot = slot;
 	/** live 每行前面的标记宽度（首行 `↳ `，其余对齐空格）。 */
 	const markerWidth = live ? 2 : 0;
 	const innerWidth = Math.max(0, width - 2 - markerWidth);
@@ -399,7 +405,7 @@ function layoutExpandedToolCard(
 			// 面板 pad 1 是唯一左边距：剥掉子行 collapsed 态自带的 1 格 lead，
 			// 否则标题行偏到 2、↳ 行偏到 4，左右不再对称。
 			const line = raw.replace(/^((?:\x1b\[[0-?]*[ -/]*[@-~])*) /, "$1");
-			lines.push(paddedBackgroundRow(theme, slot, line, width));
+			lines.push(paddedBackgroundRow(theme, outerSlot, line, width));
 			return;
 		}
 		// 槽位里不重复展开入口（见 SLOT_HINT_PATTERNS）。
@@ -420,14 +426,13 @@ function layoutExpandedToolCard(
 	};
 	const pushBlank = () => {
 		if (live || lastBlank) return;
-		lines.push(paddedBackgroundRow(theme, slot, "", width));
+		lines.push(paddedBackgroundRow(theme, outerSlot, "", width));
 		lastBlank = true;
 	};
 	for (let childIndex = 0; childIndex < children.length; childIndex++) {
 		const child = children[childIndex];
 		const painted = paints?.[childIndex];
 		const childLines = Array.isArray(painted) ? painted : child.render(innerWidth);
-		// live 不留空行、也不叠深色内卡：槽位没有边框。
 		const innerCard = !live && isThinkingPreview(child) && child.expanded === true;
 		let first = -1;
 		let last = -1;
@@ -440,7 +445,7 @@ function layoutExpandedToolCard(
 		if (first < 0) {
 			if (live) continue;
 			for (const line of childLines) {
-				lines.push(paddedBackgroundRow(theme, slot, line, width));
+				lines.push(paddedBackgroundRow(theme, outerSlot, line, width));
 				lastBlank = !hasVisibleText(line);
 			}
 			continue;
@@ -502,6 +507,7 @@ function compactRoundCard(
 		| undefined;
 	const layout = (width: number) => {
 		const theme = themeOf();
+		// 与 default 模式分组卡同口径：外卡底色随组内工具聚合，子卡状态变了要重绘。
 		const bgSlot = aggregateToolCardBgSlot(
 			children.map((child) => child?.__ccTool).filter(Boolean),
 		);
@@ -1320,6 +1326,16 @@ export function installCompactMode(deps: CompactModeInstallDeps): CompactModeHoo
 		}, FOLD_SETTLE_MS);
 	};
 
+	/**
+	 * 外层行（edit/write/ask）切出的段落封口：跳过静默期直接定稿。
+	 * 静默期是为"正文 token 先于 toolCall 到达"的双重转场准备的；外层边界
+	 * 出现时摘要段内容已完整，立即收拢让 Ran for 当场落位，槽位卡一并撤走。
+	 */
+	const sealRound = (round: CompactRound, endTimestamp?: number): void => {
+		finalizeRound(round, endTimestamp);
+		renderRound(round);
+	};
+
 	/** 新回合接替时立即收掉还在静默期的回合，把两次转场并成一次。 */
 	const flushSettle = (): void => {
 		for (const round of [...pendingFoldRounds]) {
@@ -1460,6 +1476,13 @@ export function installCompactMode(deps: CompactModeInstallDeps): CompactModeHoo
 	const isUserMessageComponent = (value: any): boolean =>
 		value instanceof UserMessageComponent || value instanceof SkillInvocationMessageComponent;
 
+	/**
+	 * 回合内的透明行：custom 通知（系统提示、extension 注入）既不是成员也不算外来行。
+	 * 它落在两个成员之间时原地保留——不打断统计、不被搬到摘要行下方。
+	 * 硬边界仍只有用户消息；summary/compaction 块由各自的 message 边界收口。
+	 */
+	const isTransparentComponent = (value: any): boolean => value instanceof CustomMessageComponent;
+
 	/**
 	 * 新组件与回合已有成员之间是否隔着一条用户消息。隔着就说明这是下一回合的内容：
 	 * steer 消息插进了回合中间，或上一回合没有正文就收尾、用户又问了新问题。
@@ -1599,7 +1622,14 @@ export function installCompactMode(deps: CompactModeInstallDeps): CompactModeHoo
 		const intruders: any[] = [];
 		for (let i = last - 1; i > first; i--) {
 			// 用户消息永远留在原地：挪走会把别人的消息挪到用户消息下面去。
-			if (isMember(children[i]) || isUserMessageComponent(children[i])) continue;
+			// custom 通知同理：它是回合内的透明行，不被统计也不挪位。
+			if (
+				isMember(children[i]) ||
+				isUserMessageComponent(children[i]) ||
+				isTransparentComponent(children[i])
+			) {
+				continue;
+			}
 			intruders.unshift(children.splice(i, 1)[0]);
 		}
 		if (lastMember) last = children.indexOf(lastMember);
@@ -1759,22 +1789,24 @@ export function installCompactMode(deps: CompactModeInstallDeps): CompactModeHoo
 
 		const thinkingKids: any[] = [];
 		for (const [component, message] of round.messages) {
-			if (component !== previewComponent) {
+			if (component === previewComponent) {
+				passThroughAssistant(component, message);
+				const kids = Array.isArray(component.contentContainer?.children)
+					? [...component.contentContainer.children]
+					: [];
 				component.contentContainer?.clear?.();
-				continue;
-			}
-			passThroughAssistant(component, message);
-			const kids = Array.isArray(component.contentContainer?.children)
-				? [...component.contentContainer.children]
-				: [];
-			component.contentContainer?.clear?.();
-			// 只摘思考预览块进槽位；已收尾的思考回收进摘要行。
-			for (const kid of kids) {
-				if (typeof kid?.setHintHovered === "function") thinkingKids.push(kid);
+				// 只摘思考预览块进槽位；已收尾的思考回收进摘要行。
+				for (const kid of kids) {
+					if (typeof kid?.setHintHovered === "function") thinkingKids.push(kid);
+				}
 			}
+			// text 在各消息自己的位置渲染，不随回合折叠态；非 anchor 成员的
+			// 中止/错误状态仍汇总在 anchor 外层，不在成员处重复成行。
+			renderAssistantWithoutThinking(
+				component,
+				component === round.anchor ? message : { ...message, stopReason: "stop" },
+			);
 		}
-		// 正文照折叠态渲染（不含 thinking）：live 与收尾后同形，收尾只剩槽位卡消失。
-		renderAssistantWithoutThinking(round.anchor, round.messages.get(round.anchor));
 
 		const toolsById = new Map<string, any>();
 		for (const tool of trackedToolComponents) {
@@ -1900,10 +1932,14 @@ export function installCompactMode(deps: CompactModeInstallDeps): CompactModeHoo
 			// 否则消息内容里的 thinking（[thinking, text, toolCall]）会盖到文本上面。
 			const anchorChildren: any[] = [];
 			let cardItems: Array<{ child?: any; tool?: any }> = [];
-			const flushPanel = () => {
+			// 纯 spacer 串拆不开面板，还给它所在消息的组件（通常是上一个
+			// text 块的前导空行）。
+			const flushPanel = (spacerOwner: any = round.anchor) => {
 				if (cardItems.length === 0) return;
 				if (cardItems.every((item) => !item.tool && isSpacerComponent(item.child))) {
-					for (const item of cardItems) anchorChildren.push(item.child);
+					for (const item of cardItems) {
+						spacerOwner?.contentContainer?.addChild?.(item.child);
+					}
 				} else {
 					// 面板上沿留 1 行卡外空行：面板底色与 userMessage 同色，
 					// 贴在一起会看成一个块；卡内顶部再加 1 行 padding 保持上下对称。
@@ -1920,13 +1956,15 @@ export function installCompactMode(deps: CompactModeInstallDeps): CompactModeHoo
 				}
 				cardItems = [];
 			};
-			const takeChild = (child: any, outside: boolean) => {
+			// outside 的块（text 及其前导空行）留在各自组件上原位渲染：展开态下
+			// 助手文本不跨消息搬家；它不切断面板——cardItems 跨消息延续，回合的
+			// thinking/工具统一汇成末尾的一张共享面板，混排 text 不再把卡撕成几段。
+			const takeChild = (component: any, child: any, outside: boolean) => {
 				if (!outside) {
 					cardItems.push({ child });
 					return;
 				}
-				flushPanel();
-				anchorChildren.push(child);
+				component.contentContainer?.addChild?.(child);
 			};
 			const placedToolIds = new Set<string>();
 			const placeTool = (id: string, fallbackName?: string) => {
@@ -1972,11 +2010,11 @@ export function installCompactMode(deps: CompactModeInstallDeps): CompactModeHoo
 					}
 				}
 				while (cursor.i < kids.length) local.push({ outside: false, child: kids[cursor.i++] });
-				for (const entry of local) if (entry.outside) takeChild(entry.child, true);
+				for (const entry of local) if (entry.outside) takeChild(component, entry.child, true);
 				for (const entry of local) {
 					if (entry.outside) continue;
 					if (entry.toolId) placeTool(entry.toolId, entry.toolName);
-					else takeChild(entry.child, false);
+					else takeChild(component, entry.child, false);
 				}
 			}
 			for (const message of round.detachedMessages) {
@@ -2001,15 +2039,10 @@ export function installCompactMode(deps: CompactModeInstallDeps): CompactModeHoo
 					!explicitRoundToolIds.has(String(tool.toolCallId ?? "")),
 			);
 			flushPanel();
+			// anchorChildren 只剩面板件（spacer+panelBoundSpacer 都是 childAtRow 组件）：
+			// 面板挂回摘要行原位，text 已在各自组件上。
 			if (mounted) {
-				// 正文留在各自的 assistant 消息上，面板挂回摘要行原位。
-				const outside: any[] = [];
-				const panel: any[] = [];
-				for (const child of anchorChildren) {
-					(typeof child?.childAtRow === "function" ? panel : outside).push(child);
-				}
-				for (const child of outside) round.anchor.contentContainer.addChild(child);
-				if (panel.length > 0) mountRoundTail(round, () => panel);
+				if (anchorChildren.length > 0) mountRoundTail(round, () => anchorChildren);
 				else unmountRoundTail(round);
 			} else {
 				unmountRoundTail(round);
@@ -2041,7 +2074,8 @@ export function installCompactMode(deps: CompactModeInstallDeps): CompactModeHoo
 				// 折叠时工具行被隐藏：abort/error/length 必须挂在摘要外层。
 				appendStopStatus(component, stopStatus);
 			} else {
-				component.contentContainer?.clear?.();
+				// 成员的 text 同样留在自己组件上；中止状态只在 anchor 外层报一次。
+				renderAssistantWithoutThinking(component, { ...message, stopReason: "stop" });
 			}
 		}
 	};
@@ -2143,6 +2177,15 @@ export function installCompactMode(deps: CompactModeInstallDeps): CompactModeHoo
 
 		const content = Array.isArray(message?.content) ? message.content : [];
 		const hasToolCalls = content.some((item: any) => item?.type === "toolCall");
+		const hasOuterToolCall = content.some(
+			(item: any) => item?.type === "toolCall" && OUTER_TOOLS.has(String(item?.name ?? "")),
+		);
+		const hasInnerToolCall = content.some(
+			(item: any) => item?.type === "toolCall" && !OUTER_TOOLS.has(String(item?.name ?? "")),
+		);
+		const hasThinkingContent = content.some(
+			(item: any) => item?.type === "thinking" && String(item?.thinking ?? "").trim(),
+		);
 		const hasText = content.some(
 			(item: any) => item?.type === "text" && typeof item.text === "string" && item.text.trim(),
 		);
@@ -2150,13 +2193,54 @@ export function installCompactMode(deps: CompactModeInstallDeps): CompactModeHoo
 
 		if (hasToolCalls) {
 			let round = roundByComponent.get(this);
+			const previousMessage = round?.messages.get(this);
+			const previousHadOuter = Array.isArray(previousMessage?.content)
+				? previousMessage.content.some(
+						(item: any) => item?.type === "toolCall" && OUTER_TOOLS.has(String(item?.name ?? "")),
+					)
+				: false;
 			if (!round) {
-				// 本条消息是否带 text 不是回合边界：pi 流式协议里同一条
-				// assistant 消息会以 text+toolCall、toolCall-only 反复到达。
-				// 只在「组件未挂进任何回合」时并入 activeRound；被用户消息
-				// 隔开（steer/上回合没正文）时由 joinOrCreateRound 收尾另起。
-				round = joinOrCreateRound(this, message);
-				roundByComponent.set(this, round);
+				// 外层行打断摘要段：本条消息带外层调用且可并入的活动回合已有内容时，
+				// 旧回合就地完结（不走静默期）。本条消息自己含 inner 调用或思考才另起一段；
+				// 外层独段（edit-only 消息）不建回合——没有可汇总内容，建段只会挂空摘要行。
+				const joinable = joinableActiveRound(this);
+				if (joinable && hasOuterToolCall) {
+					sealRound(joinable, message?.timestamp);
+					if (hasInnerToolCall || hasThinkingContent) {
+						round = createRound(this, message);
+						roundByComponent.set(this, round);
+						round.messages.set(this, message);
+						if (isUsableTimestamp(message.timestamp) && message.timestamp < round.startedAt) {
+							round.startedAt = message.timestamp;
+						}
+						renderRound(round);
+						return undefined;
+					}
+					// 外层独段：text/thinking 照原生渲染，edit 行由 tool render 外置，没有摘要行。
+					return passThroughAssistant(this, message);
+				}
+				if (hasInnerToolCall || hasThinkingContent) {
+					// 本条消息是否带 text 不是回合边界：pi 流式协议里同一条
+					// assistant 消息会以 text+toolCall、toolCall-only 反复到达。
+					// 只在「组件未挂进任何回合」时并入 activeRound；被用户消息
+					// 隔开（steer/上回合没正文）时由 joinOrCreateRound 收尾另起。
+					round = joinOrCreateRound(this, message);
+					roundByComponent.set(this, round);
+					round.messages.set(this, message);
+					if (isUsableTimestamp(message.timestamp) && message.timestamp < round.startedAt) {
+						round.startedAt = message.timestamp;
+					}
+					renderRound(round);
+					return undefined;
+				}
+				// 外层独段、又没有可并入的活动回合：不建回合，text/工具各归其位。
+				if (activeRound) finishRound(activeRound, message?.timestamp);
+				return passThroughAssistant(this, message);
+			}
+			if (hasOuterToolCall && !previousHadOuter && roundLive(round)) {
+				// 消息入段后流式增长才冒出外层调用（先 thinking 后 toolCall）：
+				// 就地封口所在段，本条消息按消息级归属留在原段，后续消息另起一段。
+				sealRound(round, message?.timestamp);
 			}
 			round.messages.set(this, message);
 			if (isUsableTimestamp(message.timestamp) && message.timestamp < round.startedAt) {

package/extensions/renderer/markdown-enhance.ts

@@ -41,99 +41,6 @@ function collectFence(lines: string[], i: number): { diagram: string; next: numb
 	return null; // 未闭合：放弃转换，保持原文
 }
 
-// ============================================================================
-// GitHub 风格提示框（admonition）
-// ============================================================================
-
-const ADMONITION = /^>\s*\[\s*!(NOTE|TIP|IMPORTANT|WARNING|CAUTION)\s*\]\s*(.*)$/i;
-const ADMONITION_STYLE: Record<string, { icon: string; label: string }> = {
-	NOTE: { icon: "💡", label: "NOTE" },
-	TIP: { icon: "✅", label: "TIP" },
-	IMPORTANT: { icon: "❗", label: "IMPORTANT" },
-	WARNING: { icon: "⚠️", label: "WARNING" },
-	CAUTION: { icon: "⚠️", label: "CAUTION" },
-};
-
-/**
- * 把 > [!TYPE] 及其后续 > 行转成带加粗标签的引用块，视觉上成提示框。
- * 多行内容用空格合并为一行。返回 null 表示该行不是提示框。
- */
-function renderAdmonition(lines: string[], i: number): { output: string[]; next: number } | null {
-	const m = lines[i].match(ADMONITION);
-	if (!m) return null;
-	const style = ADMONITION_STYLE[m[1].toUpperCase()];
-	const body: string[] = [m[2]];
-	let j = i + 1;
-	while (j < lines.length && /^>\s?/.test(lines[j]) && !ADMONITION.test(lines[j])) {
-		body.push(lines[j].replace(/^>\s?/, ""));
-		j++;
-	}
-	while (body.length > 0 && body[body.length - 1].trim() === "") body.pop();
-	// 内容合并为一行，作为引用块正文
-	const content = body.join(" ").trim();
-	// 保留引用块形态（pi 渲染为左侧竖线），标签加粗
-	return {
-		output: [`> **${style.icon} ${style.label}**${content ? ` ${content}` : ""}`, ""],
-		next: j,
-	};
-}
-
-// ============================================================================
-// 裸 URL 转可点击超链接
-// ============================================================================
-
-const URL_RE = /(?<!<)(?<!\]\()https?:\/\/[^\s<>'"|，。；：！？、」』】（）【】《》『』「」]+/g;
-const TRIM_URL_RE = /[.,;:!?】」』"'》）}]+$/;
-
-/**
- * 去掉 URL 尾部标点；括号按平衡保留（如 Wikipedia 链接含括号、
- * IPv6 地址含 [::1]），尾部不成对的 ] 与 ) 会截掉。
- */
-function trimUrl(url: string): string {
-	let t = url.replace(TRIM_URL_RE, "");
-	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;
-}
-
-/**
- * 把代码块和行内代码外的裸 URL 转成 markdown 链接。
- * 已有的 [text](url) / ![alt](url) / <url> 自动链接用 lookbehind 排除。
- */
-function linkifyUrls(markdown: string): string {
-	const lines = markdown.split("\n");
-	const out: string[] = [];
-	let fence: MarkdownFence | undefined;
-	for (const line of lines) {
-		const scanned = scanMarkdownFence(line, fence);
-		fence = scanned.fence;
-		if (scanned.protected) {
-			out.push(line);
-			continue;
-		}
-		// 行内代码（`...`）按反引号分片，只处理偶数片（代码外）
-		const parts = line.split("`");
-		for (let p = 0; p < parts.length; p++) {
-			if (p % 2 === 0) {
-				parts[p] = parts[p].replace(URL_RE, (url) => {
-					const trimmed = trimUrl(url);
-					if (trimmed.length === 0) return url;
-					return `[${trimmed}](${trimmed})`;
-				});
-			}
-		}
-		out.push(parts.join("`"));
-	}
-	return out.join("\n");
-}
-
 // ============================================================================
 // 圈数字 → 半角括号
 // ============================================================================
@@ -231,7 +138,9 @@ function normalizeMultilineLinks(markdown: string): string {
 
 export default function (pi: ExtensionAPI): void {
 	// 注意：pi 每个扩展只有一个 markdownTransformer 槽位，多次注册会互相覆盖，
-	// 所以三个转换合并为一次注册，内部按序链式执行。
+	// 所以剩下的转换合并为一次注册，内部按序链式执行。
+	// 提示框和裸 URL 不接管：pi 的 marked 已自带裸 URL 链接化（带尾标点回退，
+	// 且在链接文本内不再嵌套），提示框交给默认引用块风格。
 	pi.registerMarkdownTransformer((markdown, context) => {
 		const { messageType, isStreaming = false } = context ?? {};
 		// thinking 保持原文；普通回复即使流式中也先关闭跨行链接的空白点击区。
@@ -241,11 +150,7 @@ export default function (pi: ExtensionAPI): void {
 		// 0. 圈数字转半角括号（Nerd Font 补丁字形缺陷规避）
 		markdown = deCircled(markdown);
 		// 1. Mermaid 方言渲染
-		markdown = renderDiagrams(markdown, context);
-		// 2. GitHub 风格提示框
-		markdown = renderAdmonitions(markdown);
-		// 3. 裸 URL 转超链接
-		return linkifyUrls(markdown);
+		return renderDiagrams(markdown, context);
 	});
 }
 
@@ -307,32 +212,3 @@ function renderDiagrams(
 	}
 	return out.join("\n");
 }
-
-/** GitHub 风格提示框 → 加粗标签引用块（跳过代码块）。 */
-function renderAdmonitions(markdown: string): string {
-	const lines = markdown.split("\n");
-	const out: string[] = [];
-	let fence: MarkdownFence | undefined;
-	let i = 0;
-	while (i < lines.length) {
-		const line = lines[i];
-		const scanned = scanMarkdownFence(line, fence);
-		fence = scanned.fence;
-		if (scanned.protected) {
-			out.push(line);
-			i++;
-			continue;
-		}
-		if (/^>\s*\[\s*!/i.test(line)) {
-			const result = renderAdmonition(lines, i);
-			if (result) {
-				out.push(...result.output);
-				i = result.next;
-				continue;
-			}
-		}
-		out.push(line);
-		i++;
-	}
-	return out.join("\n");
-}

package/extensions/renderer/mouse/interaction.ts

@@ -50,8 +50,8 @@ import {
 	hideScrollButton,
 	dockScrollButtonActive,
 	restoreOfficialScrollToEnd,
+	restoreNativeScrollIndicatorText,
 	syncOfficialScrollToEnd,
-	isScrollBottomInput,
 	renderScrollButton,
 	resetScrollButtonState,
 	scheduleScrollButtonSync,
@@ -78,6 +78,7 @@ import {
 } from "./hover.ts";
 import {
 	handleStickyPromptClick,
+	stickyBarHit,
 	resetStickyPromptState,
 	updateStickyPromptHover,
 } from "./sticky-prompt.ts";
@@ -613,6 +614,18 @@ function packetInsideOverlay(tui: any, packet: SgrMousePacket): boolean {
 	return false;
 }
 
+/** 原生指示器优先于工具卡；覆盖它的粘性行仍保留原有点击优先级。 */
+function packetOnNativeIndicator(tui: any, packet: SgrMousePacket): boolean {
+	const rect = tui.scrollToEndIndicatorRect;
+	return Boolean(
+		rect &&
+			packet.row - 1 === rect.row &&
+			packet.col - 1 >= rect.column &&
+			packet.col - 1 < rect.column + rect.width &&
+			!stickyBarHit(tui, packet),
+	);
+}
+
 /**
  * 实例级包装 TuiAltScreen.handleViewportInput（惰性 Proxy 安全）：
  * 原型方法取 original（绕开 proxy 函数包装），实例 own property 装 wrapper
@@ -636,6 +649,13 @@ function patchFullscreenViewportInput(tui: any): void {
 			// dispatchMouseToOverlay → overlay.handleMouse；overlay 外的包仍
 			// 走扩展收起/展开/hover。两条路径各管各的。
 			if (packets) {
+				const nativePacket = packets.find((packet) => packetOnNativeIndicator(tui, packet));
+				if (nativePacket) {
+					clearPendingCollapsePress();
+					applyFullscreenHover(tui, null);
+					updateStickyPromptHover(tui, nativePacket);
+					return Reflect.apply(original, this, [data]);
+				}
 				// 布局还没出来或仍是上一帧：不要把点击收成工具展开。返回 undefined
 				// 让焦点 overlay 的 handleInput 拿到原始 SGR；官方链也靠这份布局，调它会消费且打到 transcript。
 				if (tui.hasOverlay?.() && !overlayLayoutsCurrent(tui)) return undefined;
@@ -985,13 +1005,9 @@ function handleToolMouseInput(data: string): { consume: true } | undefined {
 	if (!getToolMouseTui()) return undefined;
 	// 惰性 Proxy fullscreen：鼠标由 handleViewportInput 包装消费（官方链之前），
 	// 此处只处理键盘（鼠标事件在官方 listener 已被 consume，到不了这里）。
+	// 回底键归 Pi viewport（tui.altScreen.bottom，overlay 聚焦时让给 overlay），不在此重复处理。
 	if (fullscreenLazyTui(getToolMouseTui())) {
 		scheduleScrollButtonSync(getToolMouseTui(), data);
-		if (isScrollBottomInput(data)) {
-			getToolMouseTui().scrollToBottom?.();
-			hideScrollButton(getToolMouseTui());
-			return { consume: true };
-		}
 		return undefined;
 	}
 	updateScrollButtonFromInput(getToolMouseTui(), data);
@@ -1080,6 +1096,7 @@ export function resetToolHoverState(): void {
 	setScrollButtonVisible(false);
 	setScrollButtonHovered(false);
 	resetStickyPromptState();
+	restoreNativeScrollIndicatorText();
 	restoreOfficialScrollToEnd(getToolMouseTui());
 	releaseFullscreenToolMouseMotion(getToolMouseTui());
 }
@@ -1172,6 +1189,7 @@ export function installToolMouseInteraction(
 					return renderScrollButton(width, theme);
 				},
 				invalidate() {},
+				dispose: restoreNativeScrollIndicatorText,
 			});
 			return getScrollButtonWidget();
 		}

package/extensions/renderer/mouse/scroll.ts

@@ -17,7 +17,7 @@ import {
 
 const ZENTUI_PAGE_UP_INPUT = /^\x1b\[5;9(?::[12])?~$|^\x1b\[57421;9(?::[12])?u$|^\x1b\[1;6A$/;
 const ZENTUI_PAGE_DOWN_INPUT = /^\x1b\[6;9(?::[12])?~$|^\x1b\[57422;9(?::[12])?u$|^\x1b\[1;6B$/;
-const SCROLL_BOTTOM_SHORTCUT = "ctrl+end";
+const SCROLL_BOTTOM_KEYBINDING = "tui.altScreen.bottom";
 
 patchRegistry.ensure(TOOL_MOUSE_TUI_SLOT, () => null);
 export function getToolMouseTui(): any {
@@ -68,6 +68,14 @@ export function setScrollButtonVisible(visible: boolean): void {
 export function noteNewTranscriptItem(): void {
 	const state = scrollButtonState();
 	const tui = getToolMouseTui();
+	if (nativeScrollTextEnabled(tui)) {
+		syncOfficialScrollToEnd(tui);
+		if (nativeScrollTextPatch && !isFullscreenAtBottom(tui)) {
+			state.newCount += 1;
+			tui.requestRender?.();
+		}
+		return;
+	}
 	if (!dockScrollButtonActive() || !state.visible || !tui) return;
 	// 提交新消息时官方可能直接跳回底部（不经过滚动输入）：先按实时跟随状态校正，
 	// 否则跟随期间的内容会被当成“离开底部时的新消息”计入。
@@ -137,34 +145,78 @@ export function restoreOfficialScrollToEnd(tui: any): void {
 	tui[OFFICIAL_SCROLL_TO_END_KEY] = undefined;
 }
 
-/** dock 模式替换官方浮层；native 或 ccstyle off 时保留 Pi 原生 Jump to latest。 */
+/** dock 模式替换官方浮层；native 保留 Pi 原生浮层并换上 dock 文案；ccstyle off 还原 Pi 原样。 */
 export function syncOfficialScrollToEnd(tui: any): void {
+	if (!nativeScrollTextEnabled(tui)) restoreNativeScrollIndicatorText();
 	if (dockScrollButtonActive()) {
 		disableOfficialScrollToEnd(tui);
 		return;
 	}
 	restoreOfficialScrollToEnd(tui);
+	if (nativeScrollTextEnabled(tui)) {
+		// 离开 dock 时清零一次；native 的后续渲染保留共享计数。
+		if (getScrollButtonVisible()) setScrollButtonVisible(false);
+		setScrollButtonHovered(false);
+		syncNativeScrollIndicatorText(tui);
+		return;
+	}
 	setScrollButtonVisible(false);
 	setScrollButtonHovered(false);
 }
 
+/** 只记录文案补丁；dock 的显隐、快捷键和原生浮层开关仍走原路径。 */
+let nativeScrollTextPatch: { renderer: any; original: () => string } | undefined;
+
+function nativeScrollTextEnabled(tui: any): boolean {
+	return (
+		toolMouseInteractionActive() && config.scrollButtonMode === "native" && fullscreenLazyTui(tui)
+	);
+}
+
+/** widget 销毁或离开 native 模式时还原 Pi 的原始回调。 */
+export function restoreNativeScrollIndicatorText(): void {
+	if (!nativeScrollTextPatch) return;
+	const { renderer, original } = nativeScrollTextPatch;
+	renderer.scrollToEndIndicator = original;
+	nativeScrollTextPatch = undefined;
+	scrollButtonState().newCount = 0;
+}
+
+function syncNativeScrollIndicatorText(tui: any): void {
+	// Pi 的稳定 Proxy 会重绑捕获的方法；文案回调必须从真实 renderer 上取得。
+	const renderer = tui.valueOf();
+	if (nativeScrollTextPatch?.renderer !== renderer) restoreNativeScrollIndicatorText();
+	if (!nativeScrollTextPatch) {
+		const original = renderer.scrollToEndIndicator;
+		if (typeof original !== "function") return;
+		nativeScrollTextPatch = { renderer, original };
+		renderer.scrollToEndIndicator = () =>
+			original.call(renderer).replace("Jump to latest message", scrollButtonText());
+	}
+	if (isFullscreenAtBottom(renderer)) scrollButtonState().newCount = 0;
+}
+
 /** 官方 fullscreen：是否已跟随 transcript 底部（按钮隐藏条件）。 */
 export function isFullscreenAtBottom(tui: any): boolean {
 	const following = tui.isFollowingOutput ?? tui.getPrimaryScrollView?.()?.isFollowingEnd ?? true;
 	return Boolean(following);
 }
 
-function formatShortcut(shortcut: string): string {
-	return shortcut
-		.split("+")
-		.map((part) =>
-			part.length <= 1 ? part.toUpperCase() : `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`,
+/** 与 Pi 原生浮层同源（keyDisplayText）：用户实际绑定，首字母大写，macOS 上 alt 显示为 option。 */
+function scrollBottomShortcutText(): string {
+	return getKeybindings()
+		.getKeys(SCROLL_BOTTOM_KEYBINDING)
+		.map((key) =>
+			key
+				.split("+")
+				.map((part) => {
+					const display =
+						process.platform === "darwin" && part.toLowerCase() === "alt" ? "option" : part;
+					return display.charAt(0).toUpperCase() + display.slice(1);
+				})
+				.join("+"),
 		)
-		.join("+");
-}
-
-export function isScrollBottomInput(data: string): boolean {
-	return matchesKey(data, SCROLL_BOTTOM_SHORTCUT);
+		.join("/");
 }
 
 function isScrollNavigationInput(data: string): boolean {
@@ -251,9 +303,8 @@ export function updateScrollButtonFromInput(tui: any, data: string): void {
 /** 无新内容时提示原文案；有新内容时换成累计条数。 */
 function scrollButtonText(): string {
 	const count = getScrollButtonNewCount();
-	const shortcut = formatShortcut(SCROLL_BOTTOM_SHORTCUT);
-	if (count <= 0) return `Back to bottom · ${shortcut}`;
-	return `${count} new message${count === 1 ? "" : "s"} · ${shortcut}`;
+	if (count <= 0) return "Back to bottom";
+	return `${count} new message${count === 1 ? "" : "s"}`;
 }
 
 export function renderScrollButton(width: number, theme: any): string[] {
@@ -263,9 +314,11 @@ export function renderScrollButton(width: number, theme: any): string[] {
 		!fullscreenLazyTui(getToolMouseTui())
 	)
 		return [];
+	// 未绑定时与 Pi 原生一样省略快捷键段。
+	const shortcut = scrollBottomShortcutText();
 	const label = theme.fg(
 		getScrollButtonHovered() ? "text" : "accent",
-		`[ ↓ ${scrollButtonText()} ]`,
+		`[ ↓ ${scrollButtonText()}${shortcut ? ` · ${shortcut}` : ""} ]`,
 	);
 	const leftPad = Math.max(0, Math.floor((width - visibleWidth(label)) / 2));
 	return [`${" ".repeat(leftPad)}${truncateToWidth(label, width, "…")}`];

package/extensions/renderer/mouse/sticky-prompt.ts

@@ -296,7 +296,7 @@ export function renderStickyPromptScreen(
 }
 
 /** 行与列都落在本帧画出的粘性条内。滚动条那一列在条外。 */
-function stickyBarHit(tui: any, packet: SgrMousePacket): boolean {
+export function stickyBarHit(tui: any, packet: SgrMousePacket): boolean {
 	const state = stickyState();
 	if (!stickyPromptActive() || !state.visible || state.layout !== tui?.currentLayout) return false;
 	if (packet.row - 1 !== state.row) return false;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-cc-extensions",
-	"version": "1.0.6",
+	"version": "1.0.8",
 	"license": "MIT",
 	"description": "Claude Code-style TUI output with some personal touches and handy utilities.",
 	"type": "module",