@herbertgao/pi-extensions 2026.9.20 → 2026.10.0

package/node_modules/@herbertgao/pi-cc-extensions/README.en.md

@@ -8,7 +8,7 @@
 
 ## Preview
 
-<a href="https://github.com/user-attachments/assets/6c858000-fdad-43f9-957f-4d0278648498"><img src="./assets/readme/preview.webp" alt="pi-cc-extensions UI preview" width="100%"></a>
+<a href="https://github.com/user-attachments/assets/6c858000-fdad-43f9-957f-4d0278648498"><img src="https://raw.githubusercontent.com/HerbertGao/pi-extensions/master/packages/pi-cc-extensions/assets/readme/preview.webp" alt="pi-cc-extensions UI preview" width="100%"></a>
 
 Click the cover to play the demo video
 
@@ -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": 0,                          // tool summary path/command clip length; 0 = fit width
-  "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,23 +100,22 @@ 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 (calls test.ps1)
+# one-off run without touching settings: pi -e .
 ```
 
 ## Compatibility
 
-- Node.js `>=22.19.0`, Pi `^0.84.0`
+- Node.js `>=24`; the monorepo uses Pi `1.0.4`, with published Pi peer versions kept at `*`.
 
 ## 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/node_modules/@herbertgao/pi-cc-extensions/README.md

@@ -8,7 +8,7 @@
 
 ## 界面预览
 
-<a href="https://github.com/user-attachments/assets/6c858000-fdad-43f9-957f-4d0278648498"><img src="./assets/readme/preview.webp" alt="pi-cc-extensions 界面预览" width="100%"></a>
+<a href="https://github.com/user-attachments/assets/6c858000-fdad-43f9-957f-4d0278648498"><img src="https://raw.githubusercontent.com/HerbertGao/pi-extensions/master/packages/pi-cc-extensions/assets/readme/preview.webp" alt="pi-cc-extensions 界面预览" width="100%"></a>
 
 点击封面播放演示视频
 
@@ -60,6 +60,7 @@ pi install git:github.com/HerbertGao/pi-extensions
   "expandedInputMaxLines": 5,              // 展开工具卡 Input 可见行数，超出在末行显示展开提示
   "expandedOutputMaxLines": 10,            // 展开工具卡 Output 可见行数，超出在末行显示展开提示
   "expandedPreviewMaxLines": 40,           // 展开 TaskList 正文最大行数（展开 diff 始终全量）
+  "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/HerbertGao/pi-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,20 +100,19 @@ pi install git:github.com/HerbertGao/pi-extensions
 ```bash
 npm test
 npm run typecheck
-./test.bat # or pi -e .
+./test.sh # macOS/Linux：临时加载本地检出，退出后还原
+test.bat  # Windows：同上（调用 test.ps1）
+# 只想跑一次、不改配置：pi -e .
 ```
 
 ## 兼容性
 
-- Node.js `>=22.19.0`，Pi `^0.84.0`
+- Node.js `>=24`；monorepo 使用 Pi `1.0.4`，发布包的 Pi peer 版本保持 `*`。
 
 ## 推荐搭配
 
 | 扩展                                     | 用途                                             |
 | ---------------------------------------- | ------------------------------------------------ |
-| `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/node_modules/@herbertgao/pi-cc-extensions/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,6 +90,20 @@ 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 可见行数预设。 */
@@ -122,6 +138,8 @@ 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: 0,
@@ -211,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,

package/node_modules/@herbertgao/pi-cc-extensions/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,6 +33,7 @@ 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,
@@ -201,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,
@@ -492,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",
@@ -759,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;
@@ -827,6 +849,7 @@ export async function showCcstylePanel(
 					expandedInputSetting,
 					expandedOutputSetting,
 					expandedMaxSetting,
+					expandedCardBgSetting,
 					inputClipSetting,
 					startupHeaderSetting,
 					scrollStepSetting,

package/node_modules/@herbertgao/pi-cc-extensions/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/node_modules/@herbertgao/pi-cc-extensions/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) => {

package/node_modules/@herbertgao/pi-cc-extensions/extensions/feature/shell/mcp-chip.ts

@@ -0,0 +1,136 @@
+/**
+ * 内置 MCP 的状态栏芯片。
+ *
+ * pi 的内置 MCP 不写 setStatus：连接状态只在 `/mcp` 菜单里，扩展读不到。这里用公开数据推算
+ * 「已连接/已配置」，并在别的扩展接管 `/mcp` 时让位（pi-mcp-adapter 这类扩展自己会写 "mcp" 状态）。
+ *
+ * - 已连接：`pi.getAllTools()` 里来源是 builtin:mcp、曝光非 hidden 的工具，按 namespace 去重。
+ *   断线后工具仍在、0 个工具的服务器连上也看不见，needs-auth / failed 与 connecting 也分不开，
+ *   所以这只是近似值。
+ * - 已配置：mcp.json 里 enabled !== false 的条目（项目级要已 trust）。
+ */
+
+import { readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+/** 与 pi-mcp-adapter 共用同一个 status key；它写了 key 时本扩展不画。 */
+export const MCP_STATUS_KEY = "mcp";
+/** 内置 MCP 扩展的资源路径。 */
+export const BUILTIN_MCP_SOURCE = "builtin:mcp";
+const MCP_NAMESPACE_PREFIX = "mcp__";
+
+type McpConfigCacheEntry = { mtimeMs: number; names: string[] };
+
+const configCache = new Map<string, McpConfigCacheEntry>();
+
+export function mcpAgentDir(): string {
+	return process.env.PI_CODING_AGENT_DIR ?? join(homedir(), ".pi", "agent");
+}
+
+/** pi 把 `-` 与 `_` 视作同一个服务器名（`mcpNamespace` 只把 `-` 换成 `_`）。 */
+export function normalizeMcpServerName(name: string): string {
+	return name.trim().replace(/-/g, "_");
+}
+
+/** `mcp__<server>` → `<server>`；不是 MCP 命名空间返回 undefined。 */
+export function mcpNamespaceServer(namespace: string): string | undefined {
+	if (!namespace.startsWith(MCP_NAMESPACE_PREFIX)) return undefined;
+	const server = namespace.slice(MCP_NAMESPACE_PREFIX.length);
+	return server || undefined;
+}
+
+/** 已连接的服务器名（按 namespace 去重，返回规范化名字）。 */
+export function connectedMcpServers(tools: readonly any[]): string[] {
+	const fromBuiltin = new Set<string>();
+	const fromNamespace = new Set<string>();
+	for (const tool of tools ?? []) {
+		if (tool?.exposure === "hidden") continue;
+		const server = mcpNamespaceServer(String(tool?.namespace?.name ?? ""));
+		if (!server) continue;
+		const name = normalizeMcpServerName(server);
+		if (tool?.sourceInfo?.path === BUILTIN_MCP_SOURCE) fromBuiltin.add(name);
+		else fromNamespace.add(name);
+	}
+	// 版本漂移兜底：来源路径对不上时按 namespace 认（接管 /mcp 的扩展已在此之前排除）
+	return [...(fromBuiltin.size > 0 ? fromBuiltin : fromNamespace)];
+}
+
+/** `MCP 2/3`：已连接/（已连接 ∪ 已配置）。两边都空时不显示。 */
+export function formatMcpChip(
+	connected: readonly string[],
+	configured: readonly string[],
+): string | undefined {
+	const connectedNames = new Set(connected.map(normalizeMcpServerName).filter(Boolean));
+	const configuredNames = new Set(configured.map(normalizeMcpServerName).filter(Boolean));
+	const total = new Set([...connectedNames, ...configuredNames]).size;
+	if (total === 0) return undefined;
+	return `MCP ${connectedNames.size}/${total}`;
+}
+
+/** 读一个 mcp.json 里启用中的服务器名；文件缺失或损坏返回 undefined。 */
+function readMcpConfigNames(path: string): string[] | undefined {
+	try {
+		const { mtimeMs } = statSync(path);
+		const cached = configCache.get(path);
+		if (cached && cached.mtimeMs === mtimeMs) return cached.names;
+		const parsed = JSON.parse(readFileSync(path, "utf8")) as { mcpServers?: unknown };
+		const servers = parsed?.mcpServers;
+		const names: string[] = [];
+		if (servers && typeof servers === "object" && !Array.isArray(servers)) {
+			for (const [name, entry] of Object.entries(servers as Record<string, unknown>)) {
+				if (!entry || typeof entry !== "object" || Array.isArray(entry)) continue;
+				if ((entry as { enabled?: unknown }).enabled === false) continue;
+				names.push(name);
+			}
+		}
+		configCache.set(path, { mtimeMs, names });
+		return names;
+	} catch {
+		configCache.delete(path);
+		return undefined;
+	}
+}
+
+/** mcp.json 里启用中的服务器名：用户级，加上已信任时的项目级（同名以项目为准，计数时去重）。 */
+export function configuredMcpServers(options: {
+	agentDir: string;
+	cwd: string;
+	projectTrusted: boolean;
+}): string[] {
+	const names = [...(readMcpConfigNames(join(options.agentDir, "mcp.json")) ?? [])];
+	if (options.projectTrusted) {
+		names.push(...(readMcpConfigNames(join(options.cwd, ".pi", "mcp.json")) ?? []));
+	}
+	return names;
+}
+
+/** 注册了 `/mcp` 的都是内置 MCP；别的扩展接管时它自己会写状态芯片。 */
+export function builtinMcpOwnsCommand(commands: readonly any[]): boolean {
+	const mcpCommands = (commands ?? []).filter((command) => command?.name === MCP_STATUS_KEY);
+	return (
+		mcpCommands.length > 0 &&
+		mcpCommands.every((command) => command?.sourceInfo?.path === BUILTIN_MCP_SOURCE)
+	);
+}
+
+/** footer 渲染用：当前芯片文案（不含 nerd 图标），不适用时返回 undefined。 */
+export function buildMcpChip(ctx: any, api: any): string | undefined {
+	try {
+		// 工具与命令列表在 pi API 上，ctx 只提供 cwd / trust
+		if (!builtinMcpOwnsCommand(api?.getCommands?.() ?? [])) return undefined;
+		const tools = api?.getAllTools?.();
+		if (!Array.isArray(tools)) return undefined;
+		return formatMcpChip(
+			connectedMcpServers(tools),
+			configuredMcpServers({
+				agentDir: mcpAgentDir(),
+				cwd: String(ctx?.cwd ?? process.cwd()),
+				projectTrusted: ctx?.isProjectTrusted?.() === true,
+			}),
+		);
+	} catch {
+		// footer 不能因为读配置或读工具列表失败而中断渲染
+		return undefined;
+	}
+}