pi-cc-extensions 1.0.7 → 1.0.8

package/README.en.md

@@ -98,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.
@@ -116,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

@@ -98,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` 渲染最终版更稳定。
@@ -120,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;

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],
 		};
@@ -1020,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": {

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/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.7",
+	"version": "1.0.8",
 	"license": "MIT",
 	"description": "Claude Code-style TUI output with some personal touches and handy utilities.",
 	"type": "module",