pi-one-ui 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -6,6 +6,23 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.9.0] - 2026-10-02
+
+### Changed
+
+- Restyle Pi's built-in fullscreen end-of-transcript indicator with the pi-one-ui button look: `[ ↓ Back to bottom · <shortcut> ]` in accent color, switching to the text color while hovered. The shortcut text follows the actual `tui.altScreen.bottom` binding. Display conditions, centering, click-to-scroll, and the keyboard shortcut stay on Pi's native mechanism.
+
+### Removed
+
+- Remove `renderer.scrollStepLines`. Wheel stepping is controlled by Pi's own `fullscreenWheelScrollLines` setting; the removed wiring assigned a `tui.wheelScrollLines` property that Pi's TUI does not expose, so the configured value never reached the wheel accelerator. A `scrollStepLines` key left in an existing config file is ignored and preserved on save.
+- Remove the fullscreen "Back to bottom" button and its `Ctrl+End` binding. The button duplicated Pi's built-in end-of-transcript indicator (present since Pi 0.99); use the official `End` shortcut and indicator instead.
+
+### Migration
+
+- Wheel stepping is now controlled by Pi's own `fullscreenWheelScrollLines` setting in `~/.pi/agent/settings.json` (an integer such as `3`, or `"auto"`). A leftover `renderer.scrollStepLines` key in the pi-one-ui config is ignored and preserved on save.
+- The fullscreen "Back to bottom" button and its `Ctrl+End` binding are gone. Use the official `End` shortcut and the restyled end-of-transcript indicator instead.
+- For an unpinned npm installation, run `pi update npm:pi-one-ui`; for an existing version pin, run `pi install npm:pi-one-ui@0.9.0`. Fully exit and restart Pi after updating the package.
+
 ## [0.8.0] - 2026-09-30
 
 ### Changed
@@ -26,6 +43,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 - After updating the package, fully exit and restart Pi instead of running `/reload`: the cross-reload patch coordination keys were renamed, so an in-place reload would leave the previous instance's marks unrecognized until the process restarts.
 - For an unpinned npm installation, run `pi update npm:pi-one-ui`; for an existing version pin, run `pi install npm:pi-one-ui@0.8.0`.
 
+### Release verification
+
+- Release source: [`e178ac3`](https://github.com/kerolt/pi-one-ui/commit/e178ac3cdef113ea3991996ea711e5be859aef2b). [CI](https://github.com/kerolt/pi-one-ui/actions/runs/36699814167) and [Publish](https://github.com/kerolt/pi-one-ui/actions/runs/36699814519) completed successfully; local and CI `npm run verify` passed 1,190 tests across 70 files, and `npm run pack:check` confirmed 124 package files.
+- npm `latest` resolves to `0.8.0`, published `2026-09-30T10:04:37.491Z` with `gitHead` `e178ac3cdef113ea3991996ea711e5be859aef2b`, package SHA-1 `cf0b057b31feb86fd5e6b8a9de968977b660b526`, integrity `sha512-q39+leDnJf2iSF09OUDbPrRVfrLW1Q+olLIRuhB0uU/6UISnKzHXUyVgzC6mFd2D8spzzDQSPS4LtkxnSoMttw==`, and a published provenance statement (Sigstore log index [3016341299](https://search.sigstore.dev/?logIndex=3016341299)).
+- Real Pi regular/fullscreen TUI probes were not run for this release, so terminal, theme, reload, and third-party Editor combinations still require manual verification.
+
 ## [0.7.2] - 2026-09-28
 
 ### Changed
@@ -200,7 +223,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 - Reduced rendering lag when expanding settled tool groups by reusing cached child output.
 
-[Unreleased]: https://github.com/kerolt/pi-one-ui/compare/v0.8.0...HEAD
+[Unreleased]: https://github.com/kerolt/pi-one-ui/compare/v0.9.0...HEAD
+[0.9.0]: https://github.com/kerolt/pi-one-ui/compare/v0.8.0...v0.9.0
 [0.8.0]: https://github.com/kerolt/pi-one-ui/compare/v0.7.2...v0.8.0
 [0.7.2]: https://github.com/kerolt/pi-one-ui/compare/v0.7.1...v0.7.2
 [0.7.1]: https://github.com/kerolt/pi-one-ui/compare/v0.7.0...v0.7.1

package/README.en.md

@@ -76,9 +76,9 @@ Then open the unified settings panel:
 /oneui
 ```
 
-### Upgrading to 0.8.0
+### Upgrading to 0.9.0
 
-Pi `>= 0.99.0` is now required. The Editor model label, cwd label, and static border read a theme's `editorModel` / `cwd` / `editorBorder` keys through the palette shape the current Pi exposes; `colors.*` accepts Pi official theme tokens and explicit terminal colors only, so bare terminal color names such as `purple` must be written as `fg:purple`; and the legacy `zentui` values in `selectorBorders.style`, extension status `colorModes`, and the turn summary entry type use new names, with legacy values still read for compatibility.
+This release removes the `renderer.scrollStepLines` setting: wheel stepping is now controlled by Pi's own `fullscreenWheelScrollLines` setting in `~/.pi/agent/settings.json` (an integer such as `3`, or `"auto"`), and a leftover `scrollStepLines` key in the pi-one-ui config is ignored and preserved on save. The fullscreen "Back to bottom" button and its `Ctrl+End` binding are removed; use the official `End` shortcut and indicator instead. The indicator keeps the pi-one-ui button look (accent color, hover highlight).
 
 For an unpinned npm installation, run:
 
@@ -86,7 +86,7 @@ For an unpinned npm installation, run:
 pi update npm:pi-one-ui
 ```
 
-If your installation pins a version, run `pi install npm:pi-one-ui@0.8.0` to update the pin. Fully exit and restart Pi after updating the package instead of running `/reload`: the cross-reload patch coordination keys were renamed, so an in-place reload would leave the previous instance's marks unrecognized.
+If your installation pins a version, run `pi install npm:pi-one-ui@0.9.0` to update the pin. Fully exit and restart Pi after updating the package.
 
 ## Configuration
 

package/README.md

@@ -76,9 +76,9 @@ pi install git:github.com/kerolt/pi-one-ui
 /oneui
 ```
 
-### 升级到 0.8.0
+### 升级到 0.9.0
 
-本次要求 Pi `>= 0.99.0`。Editor 的模型名、目录标签与 static 外框改为从当前 Pi 的调色板结构读取主题里的 `editorModel` / `cwd` / `editorBorder` 键；`colors.*` 收敛为 Pi 官方主题 token 与显式终端色两种写法，裸终端色名（如 `purple`）不再接受，需写成 `fg:purple`；`selectorBorders.style`、扩展状态 `colorModes` 与轮次摘要条目类型中的旧 `zentui` 值改为新名称，读取端仍兼容旧值。
+本次移除了 `renderer.scrollStepLines` 配置项，滚轮步进改由 Pi 官方设置 `fullscreenWheelScrollLines` 控制（`~/.pi/agent/settings.json` 中写入整数如 `3`，或 `"auto"`），配置文件里遗留的 `scrollStepLines` 键会被忽略并保留。fullscreen 的回到底部按钮与 `Ctrl+End` 绑定一并移除，请使用官方 `End` 快捷键与指示条；指示条外观已替换为 pi-one-ui 样式（accent 色、悬停变色）。
 
 未固定版本的 npm 安装可执行：
 
@@ -86,7 +86,7 @@ pi install git:github.com/kerolt/pi-one-ui
 pi update npm:pi-one-ui
 ```
 
-若安装时固定了版本，执行 `pi install npm:pi-one-ui@0.8.0` 更新版本指定。更新安装包后，完整退出并重启 Pi，不要使用 `/reload`：跨 reload 的补丁协调键已改名，直接重载会让旧实例留下的标记无法被识别。
+若安装时固定了版本，执行 `pi install npm:pi-one-ui@0.9.0` 更新版本指定。更新安装包后，完整退出并重启 Pi。
 
 ## 配置
 

package/extensions/app/config/renderer.ts

@@ -56,7 +56,6 @@ export type Config = {
   animationIntervalMs: number;
   dimThinkingText: boolean;
   showStartupHeader: boolean;
-  scrollStepLines: number;
   enableSessionReference: boolean;
   enableSubagentAutocomplete: boolean;
   enableContextCommand: boolean;
@@ -130,8 +129,6 @@ export const THINKING_ANIMATION_INTERVAL_VALUES = [
   "120",
   "180",
 ];
-/** fullscreen 滚轮步进行数预设。 */
-export const SCROLL_STEP_LINES_VALUES = ["1", "2", "3", "5", "10"];
 /** Tools commonly toggled in excludeRenderers via the settings panel. */
 export const EXCLUDE_RENDERER_CANDIDATES = [
   "bash",
@@ -161,7 +158,6 @@ export const DEFAULT_CONFIG: Config = {
   animationIntervalMs: 90,
   dimThinkingText: false,
   showStartupHeader: true,
-  scrollStepLines: 3,
   enableSessionReference: true,
   enableSubagentAutocomplete: true,
   enableContextCommand: true,
@@ -287,12 +283,6 @@ export function normalizeConfig(input: unknown): Config {
     ),
     dimThinkingText: source.dimThinkingText === true,
     showStartupHeader: source.showStartupHeader !== false,
-    scrollStepLines: pickPositiveInt(
-      source.scrollStepLines,
-      DEFAULT_CONFIG.scrollStepLines,
-      1,
-      50,
-    ),
     enableSessionReference: source.enableSessionReference !== false,
     enableSubagentAutocomplete: source.enableSubagentAutocomplete !== false,
     enableContextCommand: source.enableContextCommand !== false,
@@ -347,7 +337,6 @@ export function formatConfigStatus(source: Config = config): string {
     `thinkingAnimation=${source.animationIntervalMs}ms`,
     `thinkingDim=${source.dimThinkingText ? "on" : "off"}`,
     `startupHeader=${source.showStartupHeader ? "on" : "off"}`,
-    `scrollStep=${source.scrollStepLines}`,
     `sessionRef=${source.enableSessionReference ? "on" : "off"}`,
     `subagentAuto=${source.enableSubagentAutocomplete ? "on" : "off"}`,
     `context=${source.enableContextCommand ? "on" : "off"}`,

package/extensions/layouts/context/renderer/mouse/hover.ts

@@ -12,7 +12,6 @@ import {
   type ToolIoSection,
 } from "../tool/result.ts";
 import { type ComponentRowHit, componentAtLocalRow } from "./layout.ts";
-import { setScrollButtonHovered } from "./scroll.ts";
 
 type SharedToolHoverState = { toolCallId: string | null };
 
@@ -132,7 +131,6 @@ export function cachedFullscreenComponentAtRow(
 
 /** fullscreen 鼠标悬停目标。 */
 export type FullscreenHoverTarget =
-  | { kind: "button" }
   | { kind: "group"; component: ToolGroupComponent }
   | { kind: "thinking"; component: ThinkingPreviewBlock }
   | { kind: "message"; component: any }
@@ -169,7 +167,5 @@ export function applyFullscreenHover(
   const nextView = target?.kind === "tool" ? target.view : null;
   const nextSection = target?.kind === "tool" ? target.section : null;
   if (setHoveredToolIo(nextView, nextSection)) changed = true;
-  const nextButton = target?.kind === "button";
-  if (setScrollButtonHovered(nextButton)) changed = true;
   if (changed) tui.requestRender?.();
 }

package/extensions/layouts/context/renderer/mouse/interaction.ts

@@ -1,4 +1,4 @@
-import { config } from "../../../../app/config/renderer.ts";
+import { getKeybindings } from "@earendil-works/pi-tui";
 import {
   type InputRouter,
   inputRouter,
@@ -63,20 +63,9 @@ import {
 } from "./packets.ts";
 import {
   fullscreenLazyTui,
-  getScrollButtonVisible,
-  getScrollButtonWidget,
   getToolMouseTui,
-  hideScrollButton,
-  isScrollBottomInput,
-  renderScrollButton,
-  resetScrollButtonState,
-  scheduleScrollButtonSync,
-  setScrollButtonHovered,
-  setScrollButtonVisible,
-  setScrollButtonWidget,
   setToolMouseTui,
   toolMouseInteractionActive,
-  updateScrollButtonFromInput,
 } from "./scroll.ts";
 
 type FrameToolRender = {
@@ -86,7 +75,7 @@ type FrameToolRender = {
 };
 
 type InteractionRegion = {
-  kind: "collapsed-hint" | "expanded-card" | "show-more" | "scroll-bottom";
+  kind: "collapsed-hint" | "expanded-card" | "show-more";
   row: number;
   startCol: number;
   endCol: number;
@@ -101,6 +90,11 @@ const TOOL_MOUSE_WIDGET_KEY = "oneui-tool-mouse";
 const TOOL_MOUSE_MOTION_ENABLE = "\x1b[?1003h\x1b[?1006h";
 const TOOL_MOUSE_MOTION_DISABLE = "\x1b[?1003l";
 const FULLSCREEN_MOTION_ENABLED = Symbol("pi-one-ui.fullscreen-motion-enabled");
+const FULLSCREEN_SCROLL_END_STYLE_PATCH = Symbol(
+  "pi-one-ui.fullscreen-scroll-end-style-patch",
+);
+/** 指示条 hover 状态：样式函数与命中检测同模块，模块级绑定即可。 */
+let scrollEndIndicatorHovered = false;
 const DEFAULT_TOOL_MOUSE_OWNER = {};
 export const TOOL_MOUSE_DISABLE = "\x1b[?1006l\x1b[?1003l\x1b[?1000l";
 
@@ -130,7 +124,6 @@ function interactionRegionAt(packet: SgrMousePacket): InteractionRegion | null {
   );
   return (
     matches.find((region) => region.kind === "show-more") ??
-    matches.find((region) => region.kind === "scroll-bottom") ??
     matches.find((region) => region.kind === "collapsed-hint") ??
     matches.find((region) => region.kind === "expanded-card") ??
     null
@@ -156,8 +149,6 @@ function tryOpenToolIoShowMore(region: InteractionRegion): boolean {
 function updateToolSummaryHover(tui: any, packet: SgrMousePacket): void {
   if ((packet.code & 32) === 0 || packet.final !== "M") return;
   const region = interactionRegionAt(packet);
-  const nextScrollButtonHovered = region?.kind === "scroll-bottom";
-  const scrollButtonChanged = setScrollButtonHovered(nextScrollButtonHovered);
   const component = region?.component;
   const nextToolCallId =
     region?.kind === "collapsed-hint" ? (component?.toolCallId ?? null) : null;
@@ -169,7 +160,6 @@ function updateToolSummaryHover(tui: any, packet: SgrMousePacket): void {
   const changed = nextToolCallId !== sharedToolHoverState().toolCallId;
   setHoveredToolCallId(nextToolCallId);
   if (
-    scrollButtonChanged ||
     setHoveredToolIo(nextIoView, nextIoSection) ||
     setHoveredToolGroup(nextGroup) ||
     changed
@@ -218,7 +208,6 @@ function collapseExpandedCard(tui: any, card: any): boolean {
 function toggleToolAtMouseClick(tui: any, packet: SgrMousePacket): boolean {
   const region = interactionRegionAt(packet);
   if (!region) return false;
-  if (region.kind === "scroll-bottom") return false;
   if (region.kind === "show-more") return tryOpenToolIoShowMore(region);
   const component = region.component;
   if (!component) return false;
@@ -255,13 +244,6 @@ function ensureFullscreenToolMouseMotion(tui: any): void {
     releaseFullscreenToolMouseMotion(tui);
     return;
   }
-  // 面板改 scrollStepLines 后，下一帧渲染即同步（restore 仍按 original 恢复）。
-  if (
-    typeof tui.wheelScrollLines === "number" &&
-    tui.wheelScrollLines !== config.scrollStepLines
-  ) {
-    tui.wheelScrollLines = config.scrollStepLines;
-  }
   if (
     !toolMouseInteractionActive() ||
     tui.mouseEnabled === false ||
@@ -299,14 +281,11 @@ function releaseFullscreenToolMouseMotion(tui?: any): void {
 }
 
 const FULLSCREEN_VIEWPORT_PATCH = Symbol("pi-one-ui.fullscreen-viewport-patch");
-const FULLSCREEN_WHEEL_SCROLL_ORIGINAL = Symbol(
-  "pi-one-ui.fullscreen-wheel-scroll-original",
-);
 
 /**
  * 官方 fullscreen 工具卡点击：collapsed hint 单击展开
  * （有且仅保持一个展开：展开前收起其他工具卡），expanded 整卡双击收起，
- * 截断头 show-more 单击打开全量预览；回到底部按钮 scrollToBottom。
+ * 截断头 show-more 单击打开全量预览。
  * 滚动条列、含 OSC8 链接行、非工具区域、展开卡单击放行官方。
  */
 function handleFullscreenToolClick(tui: any, packet: SgrMousePacket): boolean {
@@ -316,6 +295,8 @@ function handleFullscreenToolClick(tui: any, packet: SgrMousePacket): boolean {
   const x = packet.col - 1;
   const y = packet.row - 1;
   if (isScrollbarColumnAt(layout, x)) return false;
+  // 指示条覆盖层优先：命中区放行官方，由官方 rect 命中触发 scrollToBottom。
+  if (isScrollEndIndicatorAt(tui, x, y)) return false;
   const hit = fullscreenLeafAt(layout, x, y);
   if (!hit) return false;
   const width = Math.max(1, Number(tui.terminal?.columns) || 80);
@@ -330,12 +311,6 @@ function handleFullscreenToolClick(tui: any, packet: SgrMousePacket): boolean {
   if (!target) return false;
   const component = target.component;
   const card = target.group ?? component;
-  // 回到底部按钮：按组件引用命中，不依赖渲染行缓存。
-  if (getScrollButtonVisible() && component === getScrollButtonWidget()) {
-    tui.scrollToBottom?.();
-    hideScrollButton(tui);
-    return true;
-  }
   const line = hit.box.lines?.[hit.localRow];
   if (typeof line !== "string" || /\x1b]8;[^;]*;/.test(line)) return false;
   const isTool = isToolExecutionComponent(component);
@@ -401,30 +376,96 @@ function handleFullscreenToolClick(tui: any, packet: SgrMousePacket): boolean {
 
 /**
  * fullscreen 鼠标悬停：collapsed 卡 [click to show more] hint、
- * expanded 卡截断头 show-more、回到底部按钮。motion 不 consume，官方链照常。
+ * expanded 卡截断头 show-more、回到底部指示条。motion 不 consume，官方链照常。
  */
+function formatKeyDisplay(keys: string[]): string {
+  return keys
+    .join("/")
+    .split("/")
+    .map((part) =>
+      part
+        .split("+")
+        .map((piece) =>
+          piece.length <= 1
+            ? piece.toUpperCase()
+            : `${piece[0]?.toUpperCase() ?? ""}${piece.slice(1)}`,
+        )
+        .join("+"),
+    )
+    .join("/");
+}
+
+/** 回到底部快捷键（tui.altScreen.bottom）显示文本；未配置时省略快捷键段。 */
+function scrollEndShortcutText(): string {
+  const keys = getKeybindings().getKeys("tui.altScreen.bottom");
+  return keys.length > 0 ? formatKeyDisplay(keys) : "";
+}
+
+/** pi-one-ui 按钮样式：[ ↓ Back to bottom · <key> ]，accent 色、hover 转 text 色。 */
+function renderScrollEndIndicatorLabel(theme: any): string {
+  const shortcut = scrollEndShortcutText();
+  const label = `[ ↓ Back to bottom${shortcut ? ` · ${shortcut}` : ""} ]`;
+  return theme.fg(scrollEndIndicatorHovered ? "text" : "accent", label);
+}
+
+/** 指示条是 composite 层覆盖物（不在布局树内），按官方 rect 判定命中。 */
+function isScrollEndIndicatorAt(tui: any, x: number, y: number): boolean {
+  const rect = tui.scrollToEndIndicatorRect;
+  return Boolean(
+    rect && y === rect.row && x >= rect.column && x < rect.column + rect.width,
+  );
+}
+
+/** 指示条 hover 同步；返回是否悬停在指示条上（命中时优先于下方组件）。 */
+function updateScrollEndIndicatorHover(
+  tui: any,
+  x: number,
+  y: number,
+): boolean {
+  const hovered = isScrollEndIndicatorAt(tui, x, y);
+  if (hovered !== scrollEndIndicatorHovered) {
+    scrollEndIndicatorHovered = hovered;
+    tui.requestRender?.();
+  }
+  return hovered;
+}
+
+/**
+ * 覆盖官方 scrollToEndIndicator 样式函数（实例字段，官方每帧调用取标签文本；
+ * 显示条件、居中、点击命中、scrollToBottom 均保留官方机制）。惰性 Proxy 的
+ * get 会包装函数属性，保存到 Symbol 的是等价转发包装，恢复后行为不变。
+ */
+function installScrollEndIndicatorStyle(tui: any, theme: any): void {
+  if (tui[FULLSCREEN_SCROLL_END_STYLE_PATCH]) return;
+  const original = tui.scrollToEndIndicator;
+  if (typeof original !== "function") return;
+  tui[FULLSCREEN_SCROLL_END_STYLE_PATCH] = original;
+  tui.scrollToEndIndicator = () => renderScrollEndIndicatorLabel(theme);
+}
+
+function restoreScrollEndIndicatorStyle(tui: any): void {
+  const original = tui?.[FULLSCREEN_SCROLL_END_STYLE_PATCH];
+  if (typeof original !== "function") return;
+  tui.scrollToEndIndicator = original;
+  tui[FULLSCREEN_SCROLL_END_STYLE_PATCH] = undefined;
+  scrollEndIndicatorHovered = false;
+}
+
 function handleFullscreenToolHover(tui: any, packet: SgrMousePacket): void {
   if (packet.final !== "M") return;
   const layout = tui.currentLayout;
   if (!layout?.root) return;
   const x = packet.col - 1;
   const y = packet.row - 1;
+  if (updateScrollEndIndicatorHover(tui, x, y)) {
+    applyFullscreenHover(tui, null);
+    return;
+  }
   let target: FullscreenHoverTarget | null = null;
   const hit = fullscreenLeafAt(layout, x, y);
   if (hit) {
     const line = hit.box.lines?.[hit.localRow];
-    // 回到底部按钮：渲染行文本 + 列区间识别（零组件树开销）。
-    if (
-      typeof line === "string" &&
-      getScrollButtonVisible() &&
-      line.includes("[ ↓")
-    ) {
-      const plain = stripTerminalSequencesPreservingLayout(line);
-      const idx = plain.indexOf("[ ↓");
-      if (idx >= 0 && x >= idx && x <= idx + plain.length - 1) {
-        target = { kind: "button" };
-      }
-    } else if (typeof line === "string" && !/\x1b]8;/.test(line)) {
+    if (typeof line === "string" && !/\x1b]8;/.test(line)) {
       const width = Math.max(1, Number(tui.terminal?.columns) || 80);
       const contentWidth = fullscreenContentWidth(hit.box, width);
       // 与点击共用同一定位算法，避免 hover 自建行段与真实组件树错位。
@@ -489,17 +530,9 @@ function patchFullscreenViewportInput(tui: any): void {
   const proto = Object.getPrototypeOf(tui);
   const original = proto?.handleViewportInput;
   if (typeof original !== "function") return;
-  // 官方原生 routeWheel 已完整处理嵌套 ScrollView；只调整默认步进（config.scrollStepLines）。
-  if (typeof tui.wheelScrollLines === "number") {
-    tui[FULLSCREEN_WHEEL_SCROLL_ORIGINAL] = tui.wheelScrollLines;
-    tui.wheelScrollLines = config.scrollStepLines;
-  }
   tui[FULLSCREEN_VIEWPORT_PATCH] = true;
   tui.handleViewportInput = function (this: any, data: string) {
     if (toolMouseInteractionActive() && tui.mode === "fullscreen") {
-      // 滚动输入（wheel/pageUp/end 等）后同步回到底部按钮显隐；
-      // 官方 viewport 会消费键盘，扩展监听器无法补偿，必须在这里调度。
-      scheduleScrollButtonSync(tui, data);
       const packets = parseSgrMousePackets(data);
       // 官方 fullscreen 会消费全部鼠标；文本预览 overlay 活动时放行给 focused
       // custom component，使 [esc] 点击和滚轮可用。
@@ -529,11 +562,6 @@ function restoreFullscreenViewportInput(tui: any): void {
   if (typeof proto?.handleViewportInput === "function") {
     tui.handleViewportInput = proto.handleViewportInput;
   }
-  const originalWheelScrollLines = tui[FULLSCREEN_WHEEL_SCROLL_ORIGINAL];
-  if (typeof originalWheelScrollLines === "number") {
-    tui.wheelScrollLines = originalWheelScrollLines;
-    tui[FULLSCREEN_WHEEL_SCROLL_ORIGINAL] = undefined;
-  }
   tui[FULLSCREEN_VIEWPORT_PATCH] = false;
 }
 
@@ -857,24 +885,12 @@ function handleToolMouseInput(data: string): { consume: true } | undefined {
   if (!getToolMouseTui()) return undefined;
   // 惰性 Proxy fullscreen：鼠标由 handleViewportInput 包装消费（官方链之前），
   // 此处只处理键盘（鼠标事件在官方 listener 已被 consume，到不了这里）。
-  if (fullscreenLazyTui(getToolMouseTui())) {
-    scheduleScrollButtonSync(getToolMouseTui(), data);
-    if (isScrollBottomInput(data)) {
-      getToolMouseTui().scrollToBottom?.();
-      hideScrollButton(getToolMouseTui());
-      return { consume: true };
-    }
-    return undefined;
-  }
-  updateScrollButtonFromInput(getToolMouseTui(), data);
+  if (fullscreenLazyTui(getToolMouseTui())) return undefined;
   // Off mode restores native input: wheel keeps scrolling through Pi's normal
   // dispatcher, while hover/click affordances are entirely inactive.
   if (!toolMouseInteractionActive()) return undefined;
   const packets = parseSgrMousePackets(data);
-  if (!packets) {
-    scheduleScrollButtonSync(getToolMouseTui(), data);
-    return undefined;
-  }
+  if (!packets) return undefined;
 
   let consumed = false;
   for (const packet of packets) {
@@ -887,7 +903,6 @@ function handleToolMouseInput(data: string): { consume: true } | undefined {
 
   // Let scrolling, motion, release, and clicks outside tool results reach the
   // normal TUI input chain (including other extensions such as pi-zentui).
-  scheduleScrollButtonSync(getToolMouseTui(), data);
   return consumed ? { consume: true } : undefined;
 }
 
@@ -923,21 +938,19 @@ export function teardownToolMouseInteraction(
   }
   restoreToolMouseRenderPatch();
   restoreFullscreenViewportInput(getToolMouseTui());
-  resetScrollButtonState();
+  restoreScrollEndIndicatorStyle(getToolMouseTui());
   setToolMouseTui(null);
   toolMouseUi = null;
   patchRegistry.dispose(TOOL_MOUSE_OWNER_KEY, owner);
   if (toolMouseInstallationOwner === owner) toolMouseInstallationOwner = null;
 }
 
-/** off 模式清理：清空 hover 与回到底部按钮状态（跨模块 rebind 统一经由此函数）。 */
+/** off 模式清理：清空 hover 状态（跨模块 rebind 统一经由此函数）。 */
 export function resetToolHoverState(): void {
   setHoveredToolCallId(null);
   setHoveredThinking(null);
   setHoveredMessageDisplay(null);
   setHoveredCompactAssistant(null);
-  setScrollButtonVisible(false);
-  setScrollButtonHovered(false);
   releaseFullscreenToolMouseMotion(getToolMouseTui());
 }
 
@@ -983,26 +996,24 @@ export function installToolMouseInteraction(
     if (isLazyProxyTui(tui)) {
       patchFullscreenViewportInput(tui);
       ensureFullscreenToolMouseMotion(tui);
-      setScrollButtonWidget({
-        render: (width: number) => {
+      installScrollEndIndicatorStyle(tui, theme);
+      return {
+        render: () => {
+          // 惰性 Proxy 下 renderer 可能被替换，每帧补装 viewport 包装与 motion。
           patchFullscreenViewportInput(tui);
           ensureFullscreenToolMouseMotion(tui);
-          return renderScrollButton(width, theme);
+          installScrollEndIndicatorStyle(tui, theme);
+          return [];
         },
         invalidate() {},
-      });
-      return getScrollButtonWidget();
+      };
     }
     // Wrap doRender to capture the live frame for tool click/hover mapping.
     patchToolMouseMotionAfterRender(tui);
+    installScrollEndIndicatorStyle(tui, theme);
     if (toolMouseInteractionActive())
       tui?.terminal?.write?.(TOOL_MOUSE_MOTION_ENABLE);
-    const widget = {
-      render: (width: number) => renderScrollButton(width, theme),
-      invalidate() {},
-    };
-    setScrollButtonWidget(widget);
-    return widget;
+    return { render: () => [], invalidate() {} };
   });
   const removeInput = services.input.bind(
     ctx.ui,

package/extensions/layouts/context/renderer/mouse/layout.ts

@@ -7,7 +7,6 @@ import {
   isToolExecutionComponent,
   stripTerminalSequencesPreservingLayout,
 } from "./packets.ts";
-import { getScrollButtonWidget } from "./scroll.ts";
 
 export type ComponentRowHit = {
   component: any;
@@ -156,9 +155,6 @@ export function componentAtLocalRow(
   if (isMessageDisplayComponent(component)) {
     return { component, row: localRow };
   }
-  if (component === getScrollButtonWidget()) {
-    return { component, row: localRow };
-  }
   if (!Array.isArray(component.children)) return null;
   let offset = 0;
   for (const child of component.children) {

package/extensions/layouts/context/renderer/mouse/scroll.ts

@@ -1,28 +1,13 @@
-import {
-  getKeybindings,
-  type Keybinding,
-  matchesKey,
-  truncateToWidth,
-  visibleWidth,
-} from "@earendil-works/pi-tui";
 import { config } from "../../../../app/config/renderer.ts";
 import { isLazyProxyTui } from "../../../../tools/fullscreen-detect.ts";
 import {
   patchRegistry,
-  SCROLL_BUTTON_STATE_SLOT,
   TOOL_MOUSE_TUI_SLOT,
 } from "../../../../tools/patch-keys.ts";
-import { parseSgrMousePackets } from "./packets.ts";
-
-const PAGE_UP_INPUT =
-  /^\x1b\[5;9(?::[12])?~$|^\x1b\[57421;9(?::[12])?u$|^\x1b\[1;6A$/;
-const PAGE_DOWN_INPUT =
-  /^\x1b\[6;9(?::[12])?~$|^\x1b\[57422;9(?::[12])?u$|^\x1b\[1;6B$/;
-const SCROLL_BOTTOM_SHORTCUT = "ctrl+end";
 
 /**
- * 当前安装的 tui 宿主。宿主放本模块（滚动按钮/调度依赖它），
- * 由 mouse-interaction 经 setToolMouseTui 维护；跨模块一律经绑定/setter 访问。
+ * 当前安装的 tui 宿主。由 mouse-interaction 经 setToolMouseTui 维护；
+ * 跨模块一律经绑定/setter 访问。
  *
  * 状态镜像到 globalThis（Symbol 槽）：jiti 转译下经 re-export 链读取的
  * 模块级 let 绑定是初始值快照（死绑定，实测恒 null），函数调用才是活引用。
@@ -38,50 +23,6 @@ export function setToolMouseTui(tui: any): void {
   patchRegistry.install(TOOL_MOUSE_TUI_SLOT, tui);
 }
 
-// 滚动按钮状态同 toolMouseTui：镜像到 globalThis（Symbol 槽），跨模块读取
-// 一律用 getter（jiti 转译下模块级 let 绑定是初始值快照）。
-type ScrollButtonState = { visible: boolean; hovered: boolean; widget: any };
-function scrollButtonState(): ScrollButtonState {
-  return patchRegistry.ensure(SCROLL_BUTTON_STATE_SLOT, () => ({
-    visible: false,
-    hovered: false,
-    widget: null,
-  }));
-}
-export function getScrollButtonVisible(): boolean {
-  return scrollButtonState().visible;
-}
-export function getScrollButtonHovered(): boolean {
-  return scrollButtonState().hovered;
-}
-export function getScrollButtonWidget(): any {
-  return scrollButtonState().widget;
-}
-export function setScrollButtonVisible(visible: boolean): void {
-  scrollButtonState().visible = visible;
-}
-
-/** 返回是否发生变化（调用方据此决定是否需要重渲染）。 */
-export function setScrollButtonHovered(hovered: boolean): boolean {
-  if (hovered === scrollButtonState().hovered) return false;
-  scrollButtonState().hovered = hovered;
-  return true;
-}
-
-export function setScrollButtonWidget(widget: any): void {
-  scrollButtonState().widget = widget;
-}
-
-/** teardown 全量清零（visible/hovered/widget/sync 调度）。 */
-export function resetScrollButtonState(): void {
-  scrollButtonState().visible = false;
-  scrollButtonState().hovered = false;
-  scrollButtonState().widget = null;
-  scrollButtonSyncScheduled = false;
-}
-
-let scrollButtonSyncScheduled = false;
-
 // 交互开关只取决于配置模式：原实现按 isLazyProxyTui(toolMouseTui) 分两分支，
 // 两分支恒真（0.84+ 惰性 Proxy 下判定不再影响开关），折叠为单条件。
 export function toolMouseInteractionActive(): boolean {
@@ -92,125 +33,3 @@ export function toolMouseInteractionActive(): boolean {
 export function fullscreenLazyTui(tui: any): boolean {
   return isLazyProxyTui(tui) && tui.mode === "fullscreen";
 }
-
-/**
- * Reports whether fullscreen output is following the bottom of the context.
- */
-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)}`,
-    )
-    .join("+");
-}
-
-export function isScrollBottomInput(data: string): boolean {
-  return matchesKey(data, SCROLL_BOTTOM_SHORTCUT);
-}
-
-function isScrollNavigationInput(data: string): boolean {
-  if (
-    matchesKey(data, "pageUp") ||
-    matchesKey(data, "pageDown") ||
-    PAGE_UP_INPUT.test(data) ||
-    PAGE_DOWN_INPUT.test(data) ||
-    // 官方 fullscreen viewport 的可滚动键（half-page/prompt/top/bottom）。
-    [
-      "tui.altScreen.pageUp",
-      "tui.altScreen.pageDown",
-      "tui.altScreen.halfPageUp",
-      "tui.altScreen.halfPageDown",
-      "tui.altScreen.previousPrompt",
-      "tui.altScreen.nextPrompt",
-      "tui.altScreen.top",
-      "tui.altScreen.bottom",
-    ].some((key) => getKeybindings().matches(data, key as Keybinding))
-  ) {
-    return true;
-  }
-  const packets = parseSgrMousePackets(data);
-  return Boolean(
-    packets?.some((packet) => {
-      const baseButton = packet.code & ~(4 | 8 | 16 | 32);
-      return packet.final === "M" && (baseButton === 64 || baseButton === 65);
-    }),
-  );
-}
-
-/**
- * Reports whether the context is at the bottom for the detected TUI mode.
- */
-function isAtContextBottom(tui: any): boolean {
-  // 惰性 Proxy fullscreen：官方 viewport 以 isFollowingOutput 判定是否在底部。
-  if (fullscreenLazyTui(tui)) return isFullscreenAtBottom(tui);
-  return true;
-}
-
-export function hideScrollButton(tui: any): void {
-  const changed = getScrollButtonVisible() || getScrollButtonHovered();
-  setScrollButtonVisible(false);
-  setScrollButtonHovered(false);
-  if (changed) tui.requestRender?.();
-}
-
-export function scheduleScrollButtonSync(tui: any, data: string): void {
-  if (
-    !fullscreenLazyTui(tui) ||
-    !toolMouseInteractionActive() ||
-    !isScrollNavigationInput(data) ||
-    scrollButtonSyncScheduled
-  )
-    return;
-  scrollButtonSyncScheduled = true;
-  const previousLines = tui.previousLines;
-  const check = (attempt: number) => {
-    scrollButtonSyncScheduled = false;
-    if (toolMouseTui !== tui) return;
-    // Pi renders on its own frame timer. Inspect the resulting viewport before
-    // showing the button so empty or non-scrollable contexts never flash it.
-    const rendered = tui.previousLines !== previousLines;
-    // fullscreen 下 isFollowingOutput 是即时状态，无需等待官方帧渲染。
-    if (!rendered && attempt < 4 && !fullscreenLazyTui(tui)) {
-      scrollButtonSyncScheduled = true;
-      const timer = setTimeout(() => check(attempt + 1), 16);
-      if (typeof timer === "object" && timer !== null && "unref" in timer) {
-        (timer as { unref: () => void }).unref();
-      }
-      return;
-    }
-    const nextVisible = !isAtContextBottom(tui);
-    if (nextVisible !== getScrollButtonVisible()) {
-      setScrollButtonVisible(nextVisible);
-      tui.requestRender?.();
-    }
-  };
-  process.nextTick(() => check(0));
-}
-
-export function updateScrollButtonFromInput(tui: any, data: string): void {
-  if (!fullscreenLazyTui(tui) || !toolMouseInteractionActive()) return;
-  if (matchesKey(data, "enter") || matchesKey(data, "return"))
-    hideScrollButton(tui);
-}
-
-export function renderScrollButton(width: number, theme: any): string[] {
-  if (!getScrollButtonVisible() || !fullscreenLazyTui(toolMouseTui)) return [];
-  const shortcut = formatShortcut(SCROLL_BOTTOM_SHORTCUT);
-  const label = theme.fg(
-    getScrollButtonHovered() ? "text" : "accent",
-    `[ ↓ Back to bottom · ${shortcut} ]`,
-  );
-  const leftPad = Math.max(0, Math.floor((width - visibleWidth(label)) / 2));
-  return [`${" ".repeat(leftPad)}${truncateToWidth(label, width, "…")}`];
-}

package/extensions/tools/patch-keys.ts

@@ -81,9 +81,6 @@ export const TOOL_GROUPING_GENERATION_KEY = Symbol.for(
 // ── 鼠标交互 ──
 export const TOOL_MOUSE_OWNER_KEY = Symbol.for("pi-one-ui.tool-mouse-owner");
 export const TOOL_MOUSE_TUI_SLOT = Symbol.for("pi-one-ui.tool-mouse-tui");
-export const SCROLL_BUTTON_STATE_SLOT = Symbol.for(
-  "pi-one-ui.scroll-button-state",
-);
 export const FLUSH_DOCKED_BASH_PATCH = Symbol.for(
   "pi-one-ui.flush-docked-bash-patch",
 );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-one-ui",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "A single, customizable Pi UI package with layout-oriented Context and Shell rendering for Pi.",
   "type": "module",
   "license": "MIT",