pi-cc-extensions 0.9.8 → 0.9.10

package/README.en.md

@@ -25,16 +25,16 @@ Run `/reload` after installation.
 
 ## Features
 
-| 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                                       |
-| 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`                                      |
-| Session/Subagent references | Search and inject effective context from previous Sessions or existing SubAgents          | `@`                                             |
+| 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                                       |
+| 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`                                      |
+| Session/Subagent references | Search and inject effective context from previous Sessions or existing SubAgents                                                             | `@`                                             |
 | Status bar                  | Shows model, context, cache, cost, and git; also works with `@narumitw/pi-usage` for live quota. Git/cache Nerd Font icons can be turned off | `/ccstyle`                                      |
-| Theme                       | Bundled CC Dark and CC Light themes                                                       | `/theme`                                        |
+| Theme                       | Bundled CC Dark and CC Light themes                                                                                                          | `/theme`                                        |
 
 Renderer snapshots for `on` / `compact` modes: [default](./docs/tool-render-examples-default.md) · [compact](./docs/tool-render-examples-compact.md)
 
@@ -45,51 +45,52 @@ Renderer snapshots for `on` / `compact` modes: [default](./docs/tool-render-exam
 ```jsonc
 {
   // style
-  "mode": "on",                            // on / compact / off
-  "excludeRenderers": [],                  // tools keeping the native renderer; Agent always keeps its dedicated renderer
+  "mode": "on", // on / compact / off
+  "excludeRenderers": [], // tools keeping the native renderer; Agent always keeps its dedicated renderer
 
   // features
-  "enableSessionReference": true,          // @ session references
-  "enableSubagentAutocomplete": true,      // @subagent:[name] completion and delegation hints
-  "enableContextCommand": true,            // /context usage check
-  "enableAgentSummary": true,              // per-turn tool summary
-  "enableWorkingMessage": true,            // Working... bottom token/elapsed
-  "enableAliases": true,                   // /clear, /exit aliases
+  "enableSessionReference": true, // @ session references
+  "enableSubagentAutocomplete": true, // @subagent:[name] completion and delegation hints
+  "enableContextCommand": true, // /context usage check
+  "enableAgentSummary": true, // per-turn tool summary
+  "enableWorkingMessage": true, // Working... bottom token/elapsed
+  "enableAliases": true, // /clear, /exit aliases
 
   // 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)
-  "inputClip": 100,                        // tool summary path/command clip length
-  "showStartupHeader": true,               // startup header (logo + tips) toggle
-  "scrollStepLines": 3,                    // fullscreen wheel scroll step
+  "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.
+  "inputClip": 0, // tool summary path/command clip length; 0 = fit width
+  "showStartupHeader": true, // startup header (logo + tips) toggle
+  "scrollStepLines": 3, // fullscreen wheel scroll step
 
   // diff
-  "diffViewMode": "auto",                  // layout: auto / split / unified
-  "diffIndicatorMode": "bars",             // change indicators: bars / classic / none
-  "diffSplitMinWidth": 120,                // min terminal width for side-by-side columns
-  "editDiffCollapsedLines": 24,            // Edit collapse lines; beyond that shows the expand hint
-  "writeDiffCollapsedLines": 0,            // write collapse lines; 0 = creation summary only
-  "diffWordWrap": true,                    // wrap long diff lines
+  "diffViewMode": "auto", // layout: auto / split / unified
+  "diffIndicatorMode": "bars", // change indicators: bars / classic / none
+  "diffSplitMinWidth": 120, // min terminal width for side-by-side columns
+  "editDiffCollapsedLines": 24, // Edit collapse lines; beyond that shows the expand hint
+  "writeDiffCollapsedLines": 0, // write collapse lines; 0 = creation summary only
+  "diffWordWrap": true, // wrap long diff lines
 
   // thinking
   "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
+  "previewLines": 3, // preview lines; 0 hides
+  "animationIntervalMs": 90, // title animation interval (ms)
+  "dimThinkingText": false, // dim thinking body text
 
   // footer
-  "enableCustomFooter": true,              // custom status bar
-  "footerNerdIcons": true,                 // Nerd Font glyphs for git/cache; false = plain text
-  "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
+  "enableCustomFooter": true, // custom status bar
+  "footerNerdIcons": true, // Nerd Font glyphs for git/cache; false = plain text
+  "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
 }
 ```
 
 > [!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 (dragging inside the card selects text).
+> **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 (dragging inside the card selects text).
 
 > [!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.
@@ -99,7 +100,9 @@ Renderer snapshots for `on` / `compact` modes: [default](./docs/tool-render-exam
 ```bash
 npm test
 npm run typecheck
-./test.bat # or pi -e .
+./test.sh # macOS/Linux: load the local checkout for one run, then restore
+test.bat  # Windows: same
+# one-off run without touching settings: pi -e .
 ```
 
 ## Compatibility
@@ -108,14 +111,11 @@ npm run typecheck
 
 ## Recommended companions
 
-| Extension                                | Purpose                                                      |
-| ---------------------------------------- | ------------------------------------------------------------ |
-| `npm:@tintinweb/pi-subagents`            | Parallel SubAgents, background tasks, and worktree isolation |
-| `npm:@tintinweb/pi-tasks`                | Claude Code-style task tracking and coordination             |
-| `npm:pi-mcp-adapter`                     | On-demand MCP tool discovery with lower context usage        |
-| `npm:@ff-labs/pi-fff`                    | FFF-powered fuzzy file and content search (fffind / ffgrep)  |
-| `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:@ff-labs/pi-fff`    | FFF-powered fuzzy file and content search (fffind / ffgrep) |
+| `npm:pi-web-access`      | Web search, URL fetching, GitHub cloning, PDF/video parsing |
+| `npm:@narumitw/pi-usage` | Current-account usage for Codex / Copilot / OpenRouter      |
 
 ## Credits
 

package/README.md

@@ -60,7 +60,8 @@ pi install git:github.com/minuque/pi-cc-extensions
   "expandedInputMaxLines": 5,              // 展开工具卡 Input 可见行数，超出在末行显示展开提示
   "expandedOutputMaxLines": 10,            // 展开工具卡 Output 可见行数，超出在末行显示展开提示
   "expandedPreviewMaxLines": 40,           // 展开 TaskList 正文最大行数（展开 diff 始终全量）
-  "inputClip": 100,                        // 工具摘要 path/command 折叠字符数
+  "expandedCardBackground": "userMessageBg", // 展开卡背景槽位；userMessageBg 与用户消息同色，toolPendingBg 为中性灰
+  "inputClip": 0,                          // 工具摘要 path/command 折叠字符数；0 = 按可用宽度
   "showStartupHeader": true,               // 启动头（logo + tips）开关
   "scrollStepLines": 3,                    // fullscreen 滚轮步进
 
@@ -89,7 +90,7 @@ 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` 打开全量预览，单击收起（卡内拖动为选中文本）。
+> **全屏模式**：单击 `click to show more` 展开工具卡、思考、Skill 和 compact 摘要；工具卡展开态 diff 全量显示，Input/Output 超行时末行 `… +N more lines · click to show more` 打开全量预览，单击收起（卡内拖动为选中文本）。
 
 > [!NOTE]
 > **Mermaid 渲染**：建议把 `markdown.mermaid` 设为 `final`（`~/.pi/agent/settings.json` 或 `/settings` 面板的 Mermaid diagrams 选项）。默认 `streaming` 逐帧重绘，`final` 渲染最终版更稳定。
@@ -99,7 +100,9 @@ pi install git:github.com/minuque/pi-cc-extensions
 ```bash
 npm test
 npm run typecheck
-./test.bat # or pi -e .
+./test.sh # macOS/Linux：临时加载本地检出，退出后还原
+test.bat  # Windows：同上
+# 只想跑一次、不改配置：pi -e .
 ```
 
 ## 兼容性
@@ -110,9 +113,6 @@ npm run typecheck
 
 | 扩展                                     | 用途                                             |
 | ---------------------------------------- | ------------------------------------------------ |
-| `npm:@tintinweb/pi-subagents`            | 并行 SubAgent、后台任务与工作树隔离              |
-| `npm:@tintinweb/pi-tasks`                | Claude Code 风格任务跟踪与协调                   |
-| `npm:pi-mcp-adapter`                     | 按需发现 MCP 工具，减少上下文占用                |
 | `npm:@ff-labs/pi-fff`                    | 模糊文件与内容检索（fffind / ffgrep）            |
 | `npm:pi-web-access`                      | 网页搜索、URL 抓取、GitHub 克隆、PDF/视频解析    |
 | `npm:@narumitw/pi-usage`                 | 查看当前账号用量（Codex / Copilot / OpenRouter） |

package/extensions/config/config.ts

@@ -1,3 +1,4 @@
+import type { ThemeBg } from "@earendil-works/pi-coding-agent";
 import type { CompactThinkingConfig } from "../feature/compact-thinking.ts";
 import {
 	DEFAULT_FOOTER_CHIP_LAYOUT,
@@ -18,7 +19,7 @@ export interface ToolDisplayConfig {
 	diffIndicatorMode: DiffIndicatorMode;
 	diffSplitMinWidth: number;
 	editDiffCollapsedLines: number;
-	/** Write-only collapsed body lines. 0 = `↳ created • click to show more`. */
+	/** Write-only collapsed body lines. 0 = `↳ created · click to show more`. */
 	writeDiffCollapsedLines: number;
 	diffWordWrap: boolean;
 	expandedPreviewMaxLines: number;
@@ -32,7 +33,7 @@ export const DEFAULT_TOOL_DISPLAY_CONFIG: ToolDisplayConfig = {
 	editDiffCollapsedLines: 24,
 	/**
 	 * Write create/overwrite collapsed body.
-	 * 0 = `↳ created • click to show more` (stats stay on the title).
+	 * 0 = `↳ created · click to show more` (stats stay on the title).
 	 */
 	writeDiffCollapsedLines: 0,
 	diffWordWrap: true,
@@ -53,6 +54,7 @@ export type Config = {
 	writeDiffCollapsedLines: number;
 	diffWordWrap: boolean;
 	expandedPreviewMaxLines: number;
+	expandedCardBackground: ThemeBg;
 	expandedInputMaxLines: number;
 	expandedOutputMaxLines: number;
 	inputClip: number;
@@ -88,12 +90,26 @@ export const DIFF_COLLAPSED_LINES_VALUES = ["12", "24", "36", "48", "80", "120"]
 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 可见行数预设。 */
 export const EXPANDED_OUTPUT_MAX_LINES_VALUES = ["10", "20", "40", "80", "120"];
-/** 工具摘要里 path/command 等输入的折叠字符数。 */
-export const INPUT_CLIP_VALUES = ["40", "60", "80", "100", "120", "160"];
+/** 工具摘要里 path/command 等输入的折叠字符数；0 = 只按可用宽度截断。 */
+export const INPUT_CLIP_VALUES = ["0", "40", "60", "80", "100", "120", "160"];
 export const THINKING_PREVIEW_LINES_VALUES = ["0", "1", "3", "5", "10"];
 export const THINKING_ANIMATION_INTERVAL_VALUES = ["40", "60", "90", "120", "180"];
 /** fullscreen 滚轮步进行数预设。 */
@@ -122,9 +138,11 @@ 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,
-	inputClip: 100,
+	inputClip: 0,
 	useSummaryTitlesAsThinkingTitle: true,
 	previewLines: 3,
 	animationIntervalMs: 90,
@@ -154,6 +172,12 @@ export function pickPositiveInt(value: unknown, fallback: number, min = 1, max =
 	return Math.min(max, Math.max(min, Math.floor(n)));
 }
 
+/** inputClip：0 表示按宽度自适应，其余夹到 8..500。 */
+export function pickInputClip(value: unknown): number {
+	const n = typeof value === "number" ? value : typeof value === "string" ? Number(value) : NaN;
+	return n === 0 ? 0 : pickPositiveInt(value, DEFAULT_CONFIG.inputClip, 8, 500);
+}
+
 export function pickPositiveNumber(value: unknown, fallback: number, min = 1): number {
 	const n = typeof value === "number" ? value : typeof value === "string" ? Number(value) : NaN;
 	return Number.isFinite(n) ? Math.max(min, n) : fallback;
@@ -205,6 +229,11 @@ 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,
@@ -217,7 +246,7 @@ export function normalizeConfig(input: unknown): Config {
 			1,
 			5_000,
 		),
-		inputClip: pickPositiveInt(source.inputClip, DEFAULT_CONFIG.inputClip, 8, 500),
+		inputClip: pickInputClip(source.inputClip),
 		useSummaryTitlesAsThinkingTitle: source.useSummaryTitlesAsThinkingTitle !== false,
 		previewLines: pickPositiveInt(
 			source.previewLines,

package/extensions/config/panel.ts

@@ -4,7 +4,7 @@
  * 渲染副作用（applyStyleMode / refreshCurrentTranscript）由 renderer 经
  * CcstylePanelHooks 注入，避免 config → renderer 循环依赖。
  */
-import { getSettingsListTheme } from "@earendil-works/pi-coding-agent";
+import { getSettingsListTheme, type ThemeBg } 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 {
@@ -33,11 +33,13 @@ 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,
 	formatExcludeRenderers,
 	getCompactThinkingConfig,
+	pickInputClip,
 	pickPositiveInt,
 	pickPositiveNumber,
 	SCROLL_STEP_LINES_VALUES,
@@ -200,6 +202,14 @@ 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,
@@ -403,7 +413,7 @@ export async function showCcstylePanel(
 			id: "inputClip",
 			label: "Input clip",
 			description:
-				"Max characters for path/command/name in single and grouped tool summaries. Enter to type a custom value.",
+				"Max characters for path/command/name in single and grouped tool summaries; 0 fits available width. Enter to type a custom value.",
 			currentValue: String(config.inputClip),
 			values: [...INPUT_CLIP_VALUES],
 			submenu: (_current: string, closeSubmenu: (selected?: string) => void) =>
@@ -491,6 +501,13 @@ 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",
@@ -667,7 +684,7 @@ export async function showCcstylePanel(
 			switch (id) {
 				case "inputClip":
 					updateConfig({
-						inputClip: pickPositiveInt(value, DEFAULT_CONFIG.inputClip, 8, 500),
+						inputClip: pickInputClip(value),
 					});
 					inputClipSetting.currentValue = String(config.inputClip);
 					break;
@@ -758,6 +775,12 @@ 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;
@@ -826,6 +849,7 @@ export async function showCcstylePanel(
 					expandedInputSetting,
 					expandedOutputSetting,
 					expandedMaxSetting,
+					expandedCardBgSetting,
 					inputClipSetting,
 					startupHeaderSetting,
 					scrollStepSetting,

package/extensions/feature/compact-thinking.ts

@@ -18,6 +18,8 @@ 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 { isToolTuiFullscreen } from "../renderer/tool/show-more-hint.ts";
 import {
 	animateCompactThinkingText,
@@ -309,14 +311,15 @@ function hiddenPreviewHint(
 	const action = thinkingExpandAction() ?? "";
 	if (hiddenLines > 0) {
 		const noun = hiddenLines === 1 ? "line" : "lines";
+		// 与其它提示同一套写法：小圆点连接，不用逗号和括号
 		return {
-			prefix: ` • (${hiddenLines} more ${noun}${action ? ", " : ""}`,
+			prefix: ` · ${hiddenLines} more ${noun}${action ? " · " : ""}`,
 			action,
-			suffix: ")",
+			suffix: "",
 		};
 	}
 	if (forceExpandHint && isToolTuiFullscreen()) {
-		return { prefix: " • ", action: "click to show more", suffix: "" };
+		return { prefix: " · ", action: "click to show more", suffix: "" };
 	}
 	return undefined;
 }
@@ -432,7 +435,7 @@ export class ThinkingPreviewBlock implements Component {
 				: heading;
 			const bgFn =
 				this.theme && typeof this.theme.bg === "function"
-					? (text: string) => this.theme!.bg("userMessageBg" as never, text)
+					? (text: string) => this.theme!.bg(styleConfig.expandedCardBackground, text)
 					: undefined;
 			const box = new Box(1, 1, bgFn);
 			box.addChild({

package/extensions/feature/shell/footer.ts

@@ -28,18 +28,24 @@ import {
 	visibleFooterPluginTexts,
 	type FooterChipLayout,
 } from "./footer-layout.ts";
+import { MCP_STATUS_KEY, buildMcpChip } from "./mcp-chip.ts";
 
 const GIT_REFRESH_INTERVAL_MS = 10_000;
 const USAGE_REFRESH_INTERVAL_MS = 5 * 60 * 1000;
+// 后台连接 MCP 服务器不会触发 footer 重绘，靠这个兜底轮询把芯片刷出来
+const MCP_REFRESH_INTERVAL_MS = 5_000;
 const USAGE_TIMEOUT_MS = 15_000;
 // zentui NERD_DEFAULT_ICONS：git / cacheHit。无 Nerd Font 时留空，只保留文字。
 export const FOOTER_NERD_ICON_GIT = "";
 export const FOOTER_NERD_ICON_CACHE = "󰆼";
 
-export function footerGlyphs(nerdIcons: boolean): { git: string; cache: string } {
+// md power-plug：MCP 服务器连接数
+export const FOOTER_NERD_ICON_MCP = "\u{f06a5}";
+
+export function footerGlyphs(nerdIcons: boolean): { git: string; cache: string; mcp: string } {
 	return nerdIcons
-		? { git: FOOTER_NERD_ICON_GIT, cache: FOOTER_NERD_ICON_CACHE }
-		: { git: "", cache: "" };
+		? { git: FOOTER_NERD_ICON_GIT, cache: FOOTER_NERD_ICON_CACHE, mcp: FOOTER_NERD_ICON_MCP }
+		: { git: "", cache: "", mcp: "" };
 }
 
 type GitStats = { add: number; del: number };
@@ -97,8 +103,15 @@ export function formatXaiFooterChip(report: XaiFooterReport): string | undefined
 
 const cachedExtensionStatuses = new Map<string, string>();
 let cachedLocalUsageText = "";
+/** 本包推算的内置 MCP 芯片（含 nerd 图标）；空字符串表示不显示。 */
+let cachedMcpChip = "";
+
+/** 别的扩展（pi-mcp-adapter）自己写了 mcp 状态时不画，避免两个芯片。 */
+function ownMcpChip(): string {
+	return cachedMcpChip && !cachedExtensionStatuses.has(MCP_STATUS_KEY) ? cachedMcpChip : "";
+}
 
-/** 面板用：当前 setStatus 文案 + 本包 pi-usage（无文案时为空字符串）。 */
+/** 面板用：当前 setStatus 文案 + 本包 pi-usage / MCP（无文案时为空字符串）。 */
 export function getFooterStatusSnapshot(): Map<string, string> {
 	const out = new Map<string, string>();
 	for (const [key, text] of cachedExtensionStatuses) {
@@ -106,6 +119,8 @@ export function getFooterStatusSnapshot(): Map<string, string> {
 		out.set(key, text);
 	}
 	out.set(PI_USAGE_KEY, cachedLocalUsageText);
+	const mcpChip = ownMcpChip();
+	if (mcpChip) out.set(MCP_STATUS_KEY, mcpChip);
 	return out;
 }
 
@@ -167,6 +182,9 @@ function colorUsageChip(theme: any, text: string): string {
 let currentTui: any = undefined;
 let refreshCurrentGitStats: (() => void) | undefined;
 let refreshCurrentUsage: (() => void) | undefined;
+let refreshCurrentMcpChip: (() => void) | undefined;
+/** 工具/命令列表在 pi API 上，而 footer 工厂只拿得到 ctx，加载时记下来。 */
+let extensionApi: Pick<ExtensionAPI, "getAllTools" | "getCommands"> | undefined;
 
 const createCustomFooterFactory =
 	(ctx: ExtensionContext) => (tui: any, theme: any, footerData: any) => {
@@ -281,6 +299,21 @@ const createCustomFooterFactory =
 		const usageRefreshTimer = setInterval(refreshUsage, USAGE_REFRESH_INTERVAL_MS);
 		usageRefreshTimer.unref?.();
 
+		// 内置 MCP 的状态不经 setStatus 暴露，只能轮询 pi API 与 mcp.json 推算
+		const refreshMcp = () => {
+			if (disposed) return;
+			const chip = buildMcpChip(ctx, extensionApi);
+			const glyph = footerGlyphs(config.footerNerdIcons).mcp;
+			const next = chip ? `${glyph ? `${glyph} ` : ""}${chip}` : "";
+			if (cachedMcpChip === next) return;
+			cachedMcpChip = next;
+			tui.requestRender();
+		};
+		refreshCurrentMcpChip = refreshMcp;
+		refreshMcp();
+		const mcpRefreshTimer = setInterval(refreshMcp, MCP_REFRESH_INTERVAL_MS);
+		mcpRefreshTimer.unref?.();
+
 		// 分支变化时同步更新分支名和相对 HEAD 的统计。
 		const unsubBranch = footerData.onBranchChange(() => {
 			refreshGitStats();
@@ -359,6 +392,8 @@ const createCustomFooterFactory =
 				footerData.getExtensionStatuses().entries() as Iterable<[string, string]>,
 			);
 			const pluginTexts = pluginTextsForRender(localUsageChip);
+			const mcpChip = ownMcpChip();
+			if (mcpChip) pluginTexts.set(MCP_STATUS_KEY, mcpChip);
 			const layout = resolveFooterChipLayout(layoutFromConfig(), [...pluginTexts.keys()]);
 			const dimPlugin = (text: string) => colorUsageChip(theme, text);
 			const line1Plugins = visibleFooterPluginTexts(
@@ -436,11 +471,13 @@ const createCustomFooterFactory =
 				usageAbort = undefined;
 				clearInterval(gitRefreshTimer);
 				clearInterval(usageRefreshTimer);
+				clearInterval(mcpRefreshTimer);
 				unsubBranch();
 				if (currentTui === tui) {
 					currentTui = undefined;
 					refreshCurrentGitStats = undefined;
 					refreshCurrentUsage = undefined;
+					refreshCurrentMcpChip = undefined;
 				}
 			},
 		};
@@ -463,6 +500,7 @@ export function clearCustomFooter(ctx: ExtensionContext): void {
 }
 
 export default function (pi: ExtensionAPI) {
+	extensionApi = pi;
 	// 模型/思考级别变化时强制重渲染（自定义 footer 不会被内置 invalidate() 触达）
 	pi.on("model_select", () => {
 		currentTui?.requestRender();
@@ -470,7 +508,11 @@ export default function (pi: ExtensionAPI) {
 	});
 	pi.on("thinking_level_select", () => currentTui?.requestRender());
 	// 工具执行完成后立即刷新；定时器只负责兜底捕获外部文件变化。
-	pi.on("tool_execution_end", () => refreshCurrentGitStats?.());
+	pi.on("tool_execution_end", () => {
+		refreshCurrentGitStats?.();
+		// 懒连接的 MCP 服务器可能刚被调用过
+		refreshCurrentMcpChip?.();
+	});
 
 	// 启动 / /reload / 新建会话 时按配置恢复
 	pi.on("session_start", (_event, ctx) => {