pi-cc-extensions 1.0.4 → 1.0.6

package/README.en.md

@@ -55,15 +55,16 @@ 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
+  "enableEditorPrefix": true,              // editor ❯ prefix
 
   // ui
   "expandedInputMaxLines": 5,              // expanded tool Input lines; overflow shows a footer hint
   "expandedOutputMaxLines": 10,            // expanded tool Output lines; overflow shows a footer hint
   "expandedPreviewMaxLines": 40,           // max lines for expanded TaskList bodies (expanded diffs always show all)
-  "expandedCardBackground": "userMessageBg", // expanded card background slot: userMessageBg (same as user prompts) / toolPendingBg (neutral) etc.
   "toolLabelClip": 0,                      // tool summary path/command clip length; 0 = fit width
   "showStartupHeader": true,               // startup header (logo + tips) toggle
   "stickyUserMessage": true,               // fullscreen: pin a user message's first line once it scrolls off the top edge, until the next one takes over
+  "scrollButtonMode": "dock",              // fullscreen: extension dock row / native Pi floating overlay
 
   // diff
   "diffViewMode": "auto",                  // layout: auto / split / unified
@@ -77,7 +78,6 @@ Renderer snapshots for `on` / `compact` modes: [default](./docs/tool-render-exam
   "useSummaryTitlesAsThinkingTitle": true, // use latest summary as thinking title
   "previewLines": 3,                       // preview lines; 0 hides
   "animationIntervalMs": 90,               // title animation interval (ms)
-  "dimThinkingText": false,                // dim thinking body text
 
   // footer
   "enableCustomFooter": true,              // custom status bar
@@ -88,10 +88,10 @@ Renderer snapshots for `on` / `compact` modes: [default](./docs/tool-render-exam
   "footerCurrencyRate": null,              // display units per 1 cost unit; null changes the symbol only
   "footerNerdIcons": true,                 // Nerd Font glyphs for git/cache; false = plain text
   "footerGitStatsMode": "working",         // working (default): uncommitted; branch: cumulative net changes
-  "footerHiddenKeys": [],                  // hidden plugin chip keys
-  "footerLine1Keys": ["pi-usage"],         // line1 plugin chip order; pi-usage is shown by default, data from @narumitw/pi-usage
-  "footerLine2Keys": [],                   // line2 plugin chip order (after cwd/git)
-  "footerLine3Keys": [],                   // line3 overflow slot; painted only when a chip is visible
+  "footerHiddenKeys": [],                  // hidden chip keys
+  "footerLine1Keys": ["model", "context", "cache", "rate", "cost", "pi-usage"], // chip order per line; builtins and plugins share one layout
+  "footerLine2Keys": ["cwd", "git"],        // cwd: directory and session; git: branch and changes. Either can move to any line
+  "footerLine3Keys": [],                   // painted only when a chip is visible
 }
 ```
 

package/README.md

@@ -55,15 +55,16 @@ pi install git:github.com/minuque/pi-cc-extensions
   "enableAgentSummary": true,              // 每回合工具摘要
   "enableWorkingMessage": true,            // Working... 底部 token/耗时
   "enableAliases": true,                   // /clear、/exit 别名
+  "enableEditorPrefix": true,              // 输入框 ❯ 前缀
 
   // ui
   "expandedInputMaxLines": 5,              // 展开工具卡 Input 可见行数，超出在末行显示展开提示
   "expandedOutputMaxLines": 10,            // 展开工具卡 Output 可见行数，超出在末行显示展开提示
   "expandedPreviewMaxLines": 40,           // 展开 TaskList 正文最大行数（展开 diff 始终全量）
-  "expandedCardBackground": "userMessageBg", // 展开卡背景槽位；userMessageBg 与用户消息同色，toolPendingBg 为中性灰
   "toolLabelClip": 0,                      // 工具摘要 path/command 折叠字符数；0 = 按可用宽度
   "showStartupHeader": true,               // 启动头（logo + tips）开关
   "stickyUserMessage": true,               // fullscreen：userMessage 正文首行滚出视口上沿后钉住，直到下一条指令接手
+  "scrollButtonMode": "dock",              // fullscreen：dock 独占行 / native Pi 原生浮层
 
   // diff
   "diffViewMode": "auto",                  // 布局：auto / split / unified
@@ -77,7 +78,6 @@ pi install git:github.com/minuque/pi-cc-extensions
   "useSummaryTitlesAsThinkingTitle": true, // 用最新摘要作思考标题
   "previewLines": 3,                       // 预览行数，0 隐藏
   "animationIntervalMs": 90,               // 标题动画间隔（毫秒）
-  "dimThinkingText": false,                // thinking 正文用 dim 色
 
   // footer
   "enableCustomFooter": true,              // 自定义状态栏
@@ -88,10 +88,10 @@ pi install git:github.com/minuque/pi-cc-extensions
   "footerCurrencyRate": null,              // 1 单位费用换成多少显示币种；null 只换符号、不乘倍率
   "footerNerdIcons": true,                 // git/缓存用 Nerd Font 图标；false 为纯文本
   "footerGitStatsMode": "working",         // working（默认）：未提交改动；branch：分支累计净改动
-  "footerHiddenKeys": [],                  // 隐藏的插件芯片 key
-  "footerLine1Keys": ["pi-usage"],         // line1 插件芯片顺序；pi-usage 默认显示，数据来自 @narumitw/pi-usage
-  "footerLine2Keys": [],                   // line2 插件芯片顺序（接在 cwd/git 后）
-  "footerLine3Keys": []                    // line3 备用槽，有可见芯片才占行
+  "footerHiddenKeys": [],                  // 隐藏的芯片 key
+  "footerLine1Keys": ["model", "context", "cache", "rate", "cost", "pi-usage"], // 每行芯片顺序；内置项与插件同一套排布
+  "footerLine2Keys": ["cwd", "git"],        // cwd：目录和会话名；git：分支和改动。可换到任意行
+  "footerLine3Keys": []                    // 有可见芯片才占行
 }
 ```
 

package/extensions/config/config.ts

@@ -1,4 +1,3 @@
-import type { ThemeBg } from "@earendil-works/pi-coding-agent";
 import type { CompactThinkingConfig } from "../feature/compact-thinking.ts";
 import {
 	DEFAULT_FOOTER_CHIP_LAYOUT,
@@ -15,6 +14,7 @@ export type DiffViewMode = "auto" | "split" | "unified";
 export type DiffIndicatorMode = "bars" | "classic" | "none";
 export type FooterGitStatsMode = "working" | "branch";
 export type FooterTokenRateMode = "average" | "live";
+export type ScrollButtonMode = "dock" | "native";
 
 export interface ToolDisplayConfig {
 	diffViewMode: DiffViewMode;
@@ -57,23 +57,25 @@ export type Config = {
 	writeDiffCollapsedLines: number;
 	diffWordWrap: boolean;
 	expandedPreviewMaxLines: number;
-	expandedCardBackground: ThemeBg;
 	expandedInputMaxLines: number;
 	expandedOutputMaxLines: number;
 	toolLabelClip: number;
 	useSummaryTitlesAsThinkingTitle: boolean;
 	previewLines: number;
 	animationIntervalMs: number;
-	dimThinkingText: boolean;
 	showStartupHeader: boolean;
 	/** fullscreen：userMessage 正文首行滚出视口上沿后钉住，直到下一条指令接手。 */
 	stickyUserMessage: boolean;
+	/** fullscreen 回到底部按钮：扩展 dock 行，或 Pi 原生浮层。 */
+	scrollButtonMode: ScrollButtonMode;
 	enableSessionReference: boolean;
 	enableSubagentAutocomplete: boolean;
 	enableContextCommand: boolean;
 	enableAgentSummary: boolean;
 	enableWorkingMessage: boolean;
 	enableAliases: boolean;
+	/** 输入框 `❯ ` 前缀（占左侧 2 列，颜色随 thinking/bash mode 联动）。 */
+	enableEditorPrefix: boolean;
 	enableCustomFooter: boolean;
 	/** footer 输出速率芯片。关则不显示。 */
 	footerTokenRate: boolean;
@@ -101,26 +103,13 @@ export const DIFF_VIEW_MODES: DiffViewMode[] = ["auto", "split", "unified"];
 export const DIFF_INDICATOR_MODES: DiffIndicatorMode[] = ["bars", "classic", "none"];
 export const FOOTER_GIT_STATS_MODES: FooterGitStatsMode[] = ["working", "branch"];
 export const FOOTER_TOKEN_RATE_MODES: FooterTokenRateMode[] = ["average", "live"];
+export const SCROLL_BUTTON_MODES: ScrollButtonMode[] = ["dock", "native"];
 export const DIFF_SPLIT_MIN_WIDTH_VALUES = ["80", "100", "120", "140", "160", "180"];
 export const DIFF_COLLAPSED_LINES_VALUES = ["0", "12", "24", "36", "48", "80", "120"];
 /** Write collapsed presets. 0 = stats only (`+N -0` + expand hint). */
 export const WRITE_DIFF_COLLAPSED_LINES_VALUES = ["0", "4", "8", "12", "24", "36"];
 /** Presets for expanded body height — keep low options first so cycling stays TUI-friendly. */
 export const EXPANDED_PREVIEW_MAX_LINES_VALUES = ["40", "60", "80", "120", "200", "500", "2000"];
-/**
- * 展开卡可用的主题背景槽位。theme.bg/getBgAnsi 只认这些 token，
- * 别的名字会抛 Unknown theme color，所以按白名单校验；
- * 面板顺序把 userMessageBg（默认）和 toolPendingBg（内置主题的中性灰）放最前。
- */
-export const EXPANDED_CARD_BACKGROUND_SLOTS: readonly ThemeBg[] = [
-	"userMessageBg",
-	"toolPendingBg",
-	"customMessageBg",
-	"selectedBg",
-	"searchMatchBg",
-	"toolSuccessBg",
-	"toolErrorBg",
-];
 /** 展开工具卡 Input 可见行数预设。 */
 export const EXPANDED_INPUT_MAX_LINES_VALUES = ["5", "10", "20", "40", "80"];
 /** 展开工具卡 Output 可见行数预设。 */
@@ -153,23 +142,22 @@ export const DEFAULT_CONFIG: Config = {
 	writeDiffCollapsedLines: DEFAULT_TOOL_DISPLAY_CONFIG.writeDiffCollapsedLines,
 	diffWordWrap: DEFAULT_TOOL_DISPLAY_CONFIG.diffWordWrap,
 	expandedPreviewMaxLines: DEFAULT_TOOL_DISPLAY_CONFIG.expandedPreviewMaxLines,
-	/** 展开卡背景。userMessageBg 与用户消息同色（ccstyle 原约定）。 */
-	expandedCardBackground: "userMessageBg",
 	expandedInputMaxLines: 5,
 	expandedOutputMaxLines: 10,
 	toolLabelClip: 0,
 	useSummaryTitlesAsThinkingTitle: true,
 	previewLines: 3,
 	animationIntervalMs: 90,
-	dimThinkingText: false,
 	showStartupHeader: true,
 	stickyUserMessage: true,
+	scrollButtonMode: "dock",
 	enableSessionReference: true,
 	enableSubagentAutocomplete: true,
 	enableContextCommand: true,
 	enableAgentSummary: true,
 	enableWorkingMessage: true,
 	enableAliases: true,
+	enableEditorPrefix: true,
 	enableCustomFooter: true,
 	footerTokenRate: true,
 	footerTokenRateMode: "average",
@@ -263,11 +251,6 @@ export function normalizeConfig(input: unknown): Config {
 			10,
 			50_000,
 		),
-		expandedCardBackground: pickEnum(
-			source.expandedCardBackground,
-			EXPANDED_CARD_BACKGROUND_SLOTS,
-			DEFAULT_CONFIG.expandedCardBackground,
-		),
 		expandedInputMaxLines: pickPositiveInt(
 			source.expandedInputMaxLines,
 			DEFAULT_CONFIG.expandedInputMaxLines,
@@ -294,15 +277,20 @@ export function normalizeConfig(input: unknown): Config {
 			source.animationIntervalMs,
 			DEFAULT_CONFIG.animationIntervalMs,
 		),
-		dimThinkingText: source.dimThinkingText === true,
 		showStartupHeader: source.showStartupHeader !== false,
 		stickyUserMessage: source.stickyUserMessage !== false,
+		scrollButtonMode: pickEnum(
+			source.scrollButtonMode,
+			SCROLL_BUTTON_MODES,
+			DEFAULT_CONFIG.scrollButtonMode,
+		),
 		enableSessionReference: source.enableSessionReference !== false,
 		enableSubagentAutocomplete: source.enableSubagentAutocomplete !== false,
 		enableContextCommand: source.enableContextCommand !== false,
 		enableAgentSummary: source.enableAgentSummary !== false,
 		enableWorkingMessage: source.enableWorkingMessage !== false,
 		enableAliases: source.enableAliases !== false,
+		enableEditorPrefix: (source.enableEditorPrefix ?? source.enableInputPrompt) !== false, // 兼容旧配置键
 		enableCustomFooter: source.enableCustomFooter !== false,
 		footerTokenRate: source.footerTokenRate !== false,
 		footerTokenRateMode: pickEnum(
@@ -364,15 +352,16 @@ export function formatConfigStatus(source: Config = config): string {
 		`thinkingTitle=${source.useSummaryTitlesAsThinkingTitle ? "summary" : "default"}`,
 		`thinkingPreview=${source.previewLines}`,
 		`thinkingAnimation=${source.animationIntervalMs}ms`,
-		`thinkingDim=${source.dimThinkingText ? "on" : "off"}`,
 		`startupHeader=${source.showStartupHeader ? "on" : "off"}`,
 		`stickyUserMessage=${source.stickyUserMessage ? "on" : "off"}`,
+		`scrollButton=${source.scrollButtonMode}`,
 		`sessionRef=${source.enableSessionReference ? "on" : "off"}`,
 		`subagentAuto=${source.enableSubagentAutocomplete ? "on" : "off"}`,
 		`context=${source.enableContextCommand ? "on" : "off"}`,
 		`agentSummary=${source.enableAgentSummary ? "on" : "off"}`,
 		`workingMsg=${source.enableWorkingMessage ? "on" : "off"}`,
 		`aliases=${source.enableAliases ? "on" : "off"}`,
+		`editorPrefix=${source.enableEditorPrefix ? "on" : "off"}`,
 		`footer=${source.enableCustomFooter ? "on" : "off"}`,
 		`footerTokenRate=${source.footerTokenRate ? "on" : "off"}`,
 		`footerTokenRateMode=${source.footerTokenRateMode}`,

package/extensions/config/panel.ts

@@ -4,7 +4,7 @@
  * 渲染副作用（applyStyleMode / refreshCurrentTranscript）由 renderer 经
  * CcstylePanelHooks 注入，避免 config → renderer 循环依赖。
  */
-import { getSettingsListTheme, type ThemeBg } from "@earendil-works/pi-coding-agent";
+import { getSettingsListTheme } from "@earendil-works/pi-coding-agent";
 import { Input, SettingsList, matchesKey, truncateToWidth } from "@earendil-works/pi-tui";
 import type { CompactThinkingController } from "../feature/compact-thinking.ts";
 import {
@@ -28,6 +28,7 @@ import {
 	toggleFooterKeyHidden,
 	type FooterChipLayout,
 } from "../feature/shell/footer-layout.ts";
+import { applyPromptEditor, clearPromptEditor } from "../feature/shell/prompt-editor.ts";
 import { applyStartupHeader, clearStartupHeader } from "../feature/shell/startup-header.ts";
 import type { ToolGroupingHooks } from "../renderer/tool/grouping.ts";
 import {
@@ -38,7 +39,6 @@ import {
 	DIFF_SPLIT_MIN_WIDTH_VALUES,
 	DIFF_VIEW_MODES,
 	EXCLUDE_RENDERER_CANDIDATES,
-	EXPANDED_CARD_BACKGROUND_SLOTS,
 	EXPANDED_INPUT_MAX_LINES_VALUES,
 	EXPANDED_OUTPUT_MAX_LINES_VALUES,
 	EXPANDED_PREVIEW_MAX_LINES_VALUES,
@@ -49,6 +49,7 @@ import {
 	pickPositiveInt,
 	pickPositiveNumber,
 	pickToolLabelClip,
+	SCROLL_BUTTON_MODES,
 	THINKING_ANIMATION_INTERVAL_VALUES,
 	THINKING_PREVIEW_LINES_VALUES,
 	TOOL_LABEL_CLIP_VALUES,
@@ -60,6 +61,7 @@ import {
 	type DiffViewMode,
 	type FooterGitStatsMode,
 	type FooterTokenRateMode,
+	type ScrollButtonMode,
 } from "./config.ts";
 
 /** renderer 注入的渲染副作用，面板自身不触碰渲染状态。 */
@@ -86,7 +88,7 @@ function excludeRenderersDescription(names: readonly string[]): string {
 
 function customFooterDescription(enabled: boolean): string {
 	if (!enabled) return "Pi native footer restored. Chip layout below still applies when turned on.";
-	return "Custom status bar with model, context, cache, cost, git, and plugin chips.";
+	return "Custom status bar. Model, context, cache, rate, cost, cwd, git, and plugin chips share one layout.";
 }
 
 function footerTokenRateDescription(enabled: boolean): string {
@@ -114,7 +116,7 @@ function footerGitStatsDescription(mode: FooterGitStatsMode): string {
 }
 
 function pluginChipsDescription(): string {
-	return `Arrange plugin chips: ${formatFooterChipSummary(config)}. Enter to edit.`;
+	return `Arrange footer chips: ${formatFooterChipSummary(config)}. Enter to edit.`;
 }
 
 function footerLayoutFromConfig(): FooterChipLayout {
@@ -234,14 +236,6 @@ function diffIndicatorDescription(mode: DiffIndicatorMode): string {
 	return "Vertical bar indicators on changed lines (default).";
 }
 
-function expandedCardBackgroundDescription(slot: ThemeBg): string {
-	if (slot === "userMessageBg") {
-		return "Expanded cards share the user message background. Pick another slot to tell them apart.";
-	}
-	if (slot === "toolPendingBg") return "Expanded cards use the theme's neutral tool background.";
-	return `Expanded cards use the theme's ${slot} background.`;
-}
-
 /** 额外功能开关项：on/off 二值，描述随状态切换；切换后需重启生效。 */
 function featureToggleSetting(
 	id: string,
@@ -565,13 +559,6 @@ export async function showCcstylePanel(
 			submenu: (_current: string, closeSubmenu: (selected?: string) => void) =>
 				buildNumberInputSubmenu(theme, expandedMaxSetting, closeSubmenu),
 		};
-		const expandedCardBgSetting = {
-			id: "expandedCardBackground",
-			label: "Expanded card bg",
-			description: expandedCardBackgroundDescription(config.expandedCardBackground),
-			currentValue: config.expandedCardBackground,
-			values: [...EXPANDED_CARD_BACKGROUND_SLOTS],
-		};
 		const thinkingTitleSetting = {
 			id: "useSummaryTitlesAsThinkingTitle",
 			label: "Summary title",
@@ -597,15 +584,6 @@ export async function showCcstylePanel(
 			submenu: (_current: string, closeSubmenu: (selected?: string) => void) =>
 				buildNumberInputSubmenu(theme, thinkingAnimationSetting, closeSubmenu),
 		};
-		const thinkingDimSetting = {
-			id: "dimThinkingText",
-			label: "Dim thinking text",
-			description: config.dimThinkingText
-				? "Thinking text uses the theme's dim color."
-				: "Keep the default thinking text color.",
-			currentValue: config.dimThinkingText ? "on" : "off",
-			values: ["on", "off"],
-		};
 		const startupHeaderSetting = {
 			id: "showStartupHeader",
 			label: "Startup header",
@@ -624,6 +602,16 @@ export async function showCcstylePanel(
 			currentValue: config.stickyUserMessage ? "on" : "off",
 			values: ["on", "off"],
 		};
+		const scrollButtonSetting = {
+			id: "scrollButtonMode",
+			label: "Scroll to bottom",
+			description:
+				config.scrollButtonMode === "dock"
+					? "Fullscreen: show the extension's dedicated Back to bottom row."
+					: "Fullscreen: use Pi's native floating Jump to latest overlay.",
+			currentValue: config.scrollButtonMode,
+			values: [...SCROLL_BUTTON_MODES],
+		};
 
 		// 额外功能开关：注册于扩展加载期，切换后需重启（/reload）生效。
 		const sessionReferenceToggle = featureToggleSetting(
@@ -736,6 +724,15 @@ export async function showCcstylePanel(
 			currentValue: config.footerNerdIcons ? "on" : "off",
 			values: ["on", "off"],
 		};
+		const editorPrefixSetting = {
+			id: "enableEditorPrefix",
+			label: "Editor prefix",
+			description: config.enableEditorPrefix
+				? "Show ❯ before the input line; color follows thinking level / bash mode."
+				: "Plain input line, no ❯ glyph.",
+			currentValue: config.enableEditorPrefix ? "on" : "off",
+			values: ["on", "off"],
+		};
 		const customFooterSetting = {
 			id: "enableCustomFooter",
 			label: "Status bar",
@@ -773,7 +770,7 @@ export async function showCcstylePanel(
 		};
 		const pluginChipsSetting = {
 			id: "footerPluginChips",
-			label: "Plugin chips",
+			label: "Footer chips",
 			description: pluginChipsDescription(),
 			currentValue: formatFooterChipSummary(config),
 			submenu: (_current: string, closeSubmenu: (selected?: string) => void) => {
@@ -868,6 +865,18 @@ export async function showCcstylePanel(
 				ctx.ui.notify(`Updated ${id}: ${value}`, "info");
 				return;
 			}
+			if (id === "enableEditorPrefix") {
+				const enabled = value === "on";
+				updateConfig({ enableEditorPrefix: enabled });
+				editorPrefixSetting.currentValue = enabled ? "on" : "off";
+				editorPrefixSetting.description = enabled
+					? "Show ❯ before the input line; color follows thinking level / bash mode."
+					: "Plain input line, no ❯ glyph.";
+				if (enabled) applyPromptEditor(ctx);
+				else clearPromptEditor(ctx);
+				ctx.ui.notify(`Updated ${id}: ${value}`, "info");
+				return;
+			}
 			if (id === "footerNerdIcons") {
 				const enabled = value === "on";
 				updateConfig({ footerNerdIcons: enabled });
@@ -978,12 +987,6 @@ export async function showCcstylePanel(
 					});
 					expandedMaxSetting.currentValue = String(config.expandedPreviewMaxLines);
 					break;
-				case "expandedCardBackground":
-					updateConfig({ expandedCardBackground: value as ThemeBg });
-					expandedCardBgSetting.description = expandedCardBackgroundDescription(
-						config.expandedCardBackground,
-					);
-					break;
 				case "useSummaryTitlesAsThinkingTitle":
 					updateConfig({ useSummaryTitlesAsThinkingTitle: value === "on" });
 					break;
@@ -997,12 +1000,6 @@ export async function showCcstylePanel(
 					});
 					thinkingAnimationSetting.currentValue = String(config.animationIntervalMs);
 					break;
-				case "dimThinkingText":
-					updateConfig({ dimThinkingText: value === "on" });
-					thinkingDimSetting.description = config.dimThinkingText
-						? "Thinking text uses the theme's dim color."
-						: "Keep the default thinking text color.";
-					break;
 				case "stickyUserMessage": {
 					updateConfig({ stickyUserMessage: value === "on" });
 					stickyUserMessageSetting.description = config.stickyUserMessage
@@ -1010,6 +1007,14 @@ export async function showCcstylePanel(
 						: "User messages scroll normally.";
 					break;
 				}
+				case "scrollButtonMode": {
+					updateConfig({ scrollButtonMode: value as ScrollButtonMode });
+					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.";
+					break;
+				}
 				case "showStartupHeader": {
 					const enabled = value === "on";
 					updateConfig({ showStartupHeader: enabled });
@@ -1053,10 +1058,11 @@ export async function showCcstylePanel(
 					expandedInputSetting,
 					expandedOutputSetting,
 					expandedMaxSetting,
-					expandedCardBgSetting,
 					toolLabelClipSetting,
 					stickyUserMessageSetting,
+					scrollButtonSetting,
 					startupHeaderSetting,
+					editorPrefixSetting,
 				],
 			},
 			{
@@ -1074,12 +1080,7 @@ export async function showCcstylePanel(
 			{
 				id: "thinking",
 				label: "Thinking",
-				items: [
-					thinkingTitleSetting,
-					thinkingPreviewSetting,
-					thinkingAnimationSetting,
-					thinkingDimSetting,
-				],
+				items: [thinkingTitleSetting, thinkingPreviewSetting, thinkingAnimationSetting],
 			},
 			{
 				id: "footer",

package/extensions/feature/compact-thinking.ts

@@ -18,8 +18,7 @@ import {
 	wrapTextWithAnsi,
 } from "@earendil-works/pi-tui";
 import { Box, Markdown, Spacer, Text, type Component } from "@earendil-works/pi-tui";
-// 展开卡背景是 ccstyle 的渲染约定，不随上游 CompactThinkingConfig 走，直接读全局配置。
-import { config as styleConfig } from "../config/config.ts";
+import { TOOL_CARD_BG_SLOT } from "../renderer/tool/tool-state.ts";
 import { isToolTuiFullscreen } from "../renderer/tool/names.ts";
 import {
 	animateCompactThinkingText,
@@ -435,7 +434,7 @@ export class ThinkingPreviewBlock implements Component {
 				: heading;
 			const bgFn =
 				this.theme && typeof this.theme.bg === "function"
-					? (text: string) => this.theme!.bg(styleConfig.expandedCardBackground, text)
+					? (text: string) => this.theme!.bg(TOOL_CARD_BG_SLOT.success, text)
 					: undefined;
 			const box = new Box(1, 1, bgFn);
 			box.addChild({

package/extensions/feature/context.ts

@@ -11,6 +11,7 @@ import {
 import { Key, Markdown, matchesKey, visibleWidth } from "@earendil-works/pi-tui";
 import { type Color, rgbColor } from "@earendil-works/pi-tui";
 import { padLine } from "../utils/format.ts";
+import { mouseBaseButton, parseSgrMousePacket } from "../utils/sgr-mouse.ts";
 
 export type ContextPart = {
 	label: string;
@@ -34,6 +35,61 @@ type ContextPreview = {
 	content: string;
 };
 
+/** Pi 居中 overlay 的屏幕起点。没有 renderedOverlayLayouts 时用它，避免把 1-based 屏幕坐标当局部坐标。 */
+function centeredOverlayOrigin(
+	tui: any,
+	margin: number,
+	maxHeightPercent: number,
+	width: number,
+	height: number,
+) {
+	const termWidth = Math.max(1, tui.terminal?.columns ?? 80);
+	const termHeight = Math.max(1, tui.terminal?.rows ?? 24);
+	const availWidth = Math.max(1, termWidth - margin * 2);
+	const availHeight = Math.max(1, termHeight - margin * 2);
+	const maxHeight = Math.max(
+		1,
+		Math.min(Math.floor((termHeight * maxHeightPercent) / 100), availHeight),
+	);
+	const effectiveHeight = Math.min(height, maxHeight);
+	return {
+		col: Math.max(
+			margin,
+			Math.min(margin + Math.floor((availWidth - width) / 2), termWidth - margin - width),
+		),
+		row: Math.max(
+			margin,
+			Math.min(
+				margin + Math.floor((availHeight - effectiveHeight) / 2),
+				termHeight - margin - effectiveHeight,
+			),
+		),
+	};
+}
+
+function localMouseFromSgr(
+	tui: any,
+	mouse: { code: number; col: number; row: number; final: "M" | "m" },
+	fallback: { col: number; row: number },
+) {
+	// 用焦点组件自己的布局。取最上层会在多个 overlay 叠放时把下层的点击算偏。
+	const layouts = Array.isArray(tui.renderedOverlayLayouts) ? tui.renderedOverlayLayouts : [];
+	const focused = tui.focusedComponent;
+	const layout =
+		layouts.findLast((candidate: { entry?: { component?: unknown } }) =>
+			focused ? candidate.entry?.component === focused : false,
+		) ??
+		(focused ? undefined : layouts.at(-1)) ??
+		fallback;
+	return {
+		col: mouse.col - 1 - layout.col,
+		row: mouse.row - 1 - layout.row,
+		release: mouse.final === "m",
+		motion: (mouse.code & 32) !== 0,
+		baseButton: mouseBaseButton(mouse.code),
+	};
+}
+
 function normalizePreviewText(text: string): string {
 	return text
 		.replace(/\r\n?/g, "\n")
@@ -122,6 +178,7 @@ export async function showTextPreview(
 					  }
 					| undefined;
 				let scrollbarDragOffset: number | null = null;
+				let screenOrigin = { col: 0, row: 0 };
 				const markdownView = new Markdown(content, 0, 0, getMarkdownTheme());
 
 				const scrollTo = (nextOffset: number): void => {
@@ -277,6 +334,11 @@ export async function showTextPreview(
 						else if (matchesKey(data, "pageDown")) scrollTo(scrollOffset + pageSize);
 						else if (matchesKey(data, Key.home)) scrollTo(0);
 						else if (matchesKey(data, Key.end)) scrollTo(totalLines - pageSize);
+						else {
+							const mouse = parseSgrMousePacket(data);
+							if (!mouse) return;
+							handlePreviewMouse(localMouseFromSgr(tui, mouse, screenOrigin));
+						}
 					},
 					// overlay 事件对象路径：官方 dispatchMouseToOverlay 把鼠标派到
 					// handleMouse，event.x/y 是相对弹框左上角的 0-based 局部坐标，
@@ -362,8 +424,7 @@ export async function showTextPreview(
 						const start = totalLines === 0 ? 0 : scrollOffset + 1;
 						const end = Math.min(totalLines, scrollOffset + pageSize);
 						const status = `${start}-${end} / ${totalLines} lines · ↑↓ PgUp/PgDn Home/End`;
-
-						return [
+						const lines = [
 							border(`╭${"─".repeat(inner)}╮`),
 							`${border("│")}${padLine(` ${theme.bold(theme.fg("accent", title))}`, inner - actionsWidth)}${theme.fg(copyHovered ? "text" : "muted", COPY_LABEL)} ${theme.fg(escHovered ? "text" : "muted", ESC_LABEL)}${border("│")}`,
 							`${border("├")}${border("─".repeat(inner))}${border("┤")}`,
@@ -372,6 +433,8 @@ export async function showTextPreview(
 							`${border("│")}${padLine(theme.fg("dim", ` ${status}`), inner)}${border("│")}`,
 							border(`╰${"─".repeat(inner)}╯`),
 						];
+						screenOrigin = centeredOverlayOrigin(tui, 2, 80, width, lines.length);
+						return lines;
 					},
 				};
 			},
@@ -708,6 +771,7 @@ export default function contextUsageExtension(pi: ExtensionAPI) {
 							let escHitbox: { row: number; startCol: number; endCol: number } | undefined;
 							let escHovered = false;
 							let hoveredKey: PreviewKey | undefined;
+							let screenOrigin = { col: 0, row: 0 };
 
 							/** context 主弹框鼠标共用处：handleInput（raw SGR）与 handleMouse（overlay
 							 * 事件对象）同一套 hover/选中/关闭行为。返回 true 表示被预览消费。 */
@@ -784,6 +848,9 @@ export default function contextUsageExtension(pi: ExtensionAPI) {
 										done(visiblePreviews[selectedPreviewIndex]?.key);
 										return;
 									}
+									const mouse = parseSgrMousePacket(data);
+									if (!mouse) return;
+									handleDialogMouse(localMouseFromSgr(tui, mouse, screenOrigin));
 								},
 								// overlay 事件对象路径：event.x/y 是弹框局部 0-based 坐标，
 								// 与 hitbox 同基准。click 是 press+release 的合成，动作已在
@@ -874,6 +941,7 @@ export default function contextUsageExtension(pi: ExtensionAPI) {
 												]
 											: [];
 									});
+									screenOrigin = centeredOverlayOrigin(tui, 1, 90, width, visibleHeight);
 
 									return lines;
 								},

package/extensions/feature/reference/index.ts

@@ -417,9 +417,8 @@ export default function sessionReferenceExtension(pi: ExtensionAPI): void {
 
 		getAvailableReferences = getReferences;
 		if (ctx.mode === "tui") {
-			// 预取是 detached 的，必须兜住 rejection，否则 stale 错误会变成
-			// unhandled rejection 直接终止 Pi。
-			void getReferences().catch(() => {});
+			// 不在这里预取：SessionManager.listAll() 会读完整个会话库，大库要几秒，
+			// 而启动并不需要结果。首次 @ 输入由 getSuggestions 触发加载。
 			// Register after other session_start handlers. pi-fff claims every @
 			// prefix, so a provider installed before it would never see session mentions.
 			setTimeout(() => {