pi-cc-extensions 0.9.0 → 0.9.2

package/README.en.md

@@ -37,13 +37,13 @@ Run `/reload` after installation.
 
 | Feature                     | Description                                                                               | Entry point                                     |
 | --------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------- |
-| Claude Code Output          | Tool summaries, expand/collapse, rich edit/write diffs, and`on` / `compact` / `off` modes | `/ccstyle`                                      |
-| Markdown enhancements      | Mermaid art, admonitions, URL linking, and more                                           | Automatic                                        |
+| 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 click to expand, double-click to collapse, previews, hover highlight, and a back-to-bottom button | `TUIMODE=fullscreen` or `--tui-mode fullscreen` |
-| Settings panel              | `Style / Diff / Thinking / UI / Feature` tabs                                             | `/ccstyle`                                      |
+| 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                  | Two-line chips: model, context, cache, cost, git; requires a Nerd Font                    | `/ccstyle` Feature                              |
+| 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`                                        |
 
 ## Configuration
@@ -52,9 +52,26 @@ Run `/reload` after installation.
 
 ```js
 {
+  // style
   "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 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 diff/TaskList bodies
+  "inputClip": 100,                        // tool summary path/command clip length
+  "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
@@ -69,22 +86,13 @@ Run `/reload` after installation.
   "animationIntervalMs": 90,               // title animation interval (ms)
   "dimThinkingText": false,                // dim thinking body text
 
-  // 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 diff/TaskList bodies
-  "inputClip": 100,                        // tool summary path/command clip length
-  "showStartupHeader": true,               // startup header (logo + tips) toggle
-  "scrollStepLines": 3,                    // fullscreen wheel scroll step
-
-  // features
-  "enableSessionReference": true,          // @ session references
-  "enableSubagentAutocomplete": true,      // @ subagent 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
-  "enableCustomFooter": true               // two-line chips status bar (needs a Nerd Font)
+  // 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
 }
 ```
 
@@ -102,7 +110,7 @@ npm run typecheck
 
 ## Compatibility
 
-- Node.js `>=22.19.0`, Pi `^0.84.0` (loaded through `pi.extensions` and `pi.themes` in the root `package.json`)
+- Node.js `>=22.19.0`, Pi `^0.84.0`
 
 ## Recommended companions
 
@@ -114,7 +122,6 @@ npm run typecheck
 | `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       |
-| `git:github.com/DietrichGebert/ponytail` | Lazy-mode coding: forces the simplest working solution       |
 
 ## Credits
 

package/README.md

@@ -40,10 +40,10 @@ pi install git:github.com/minuque/pi-cc-extensions
 | Claude Code UI        | 工具摘要、折叠展开、rich edit/write diff，以及`on` / `compact` / `off` 三种模式 | `/ccstyle`                                      |
 | Markdown 增强         | Mermaid 图、提示框、URL 链接化等                                                        | 自动生效                                        |
 | Fullscreen mode       | 工具卡/group 单击展开、双击收起、预览、hover 高亮、回到底部按钮                 | `TUIMODE=fullscreen` 或 `--tui-mode fullscreen` |
-| 配置面板              | `Style / Diff / Thinking / UI / Feature` 五页签                                 | `/ccstyle`                                      |
+| 配置面板              | `Style / Features / UI / Diff / Thinking / Footer` 六页签                       | `/ccstyle`                                      |
 | 上下文检查            | 查看上下文占用，并预览 System prompt、Memory、Skills、Tools definition 和消息内容 | `/context`                                      |
 | Session/Subagent 引用 | 搜索并注入历史 Session 或现有 SubAgent 的有效上下文                             | `@`                                             |
-| 状态栏                | 两行 chips：模型、上下文、缓存、费用、git；需要 Nerd Font                       | `/ccstyle` Feature                              |
+| 状态栏                | 显示：模型、上下文、缓存、费用、git并适配 @narumitw/pi-usage 实时显示额度；git/缓存图标可关 Nerd Font | `/ccstyle`                              |
 | 主题                  | 随包提供内置 CC Dark、CC Light 主题                                             | `/theme`                                        |
 
 ## 配置
@@ -52,9 +52,26 @@ pi install git:github.com/minuque/pi-cc-extensions
 
 ```js
 {
+  // style
   "mode": "on",                            // on / compact / off
   "excludeRenderers": [],                  // 走原生渲染的工具名；Agent 始终保留专用渲染器
 
+  // features
+  "enableSessionReference": true,          // @ session 引用
+  "enableSubagentAutocomplete": true,      // @ subagent 补全与委派提示
+  "enableContextCommand": true,            // /context 上下文检查
+  "enableAgentSummary": true,              // 每回合工具摘要
+  "enableWorkingMessage": true,            // Working... 底部 token/耗时
+  "enableAliases": true,                   // /clear、/exit 别名
+
+  // ui
+  "expandedInputMaxLines": 5,              // 展开工具卡 Input 可见行数，超出在末行显示展开提示
+  "expandedOutputMaxLines": 10,            // 展开工具卡 Output 可见行数，超出在末行显示展开提示
+  "expandedPreviewMaxLines": 40,           // 展开 diff/TaskList 正文最大行数
+  "inputClip": 100,                        // 工具摘要 path/command 折叠字符数
+  "showStartupHeader": true,               // 启动头（logo + tips）开关
+  "scrollStepLines": 3,                    // fullscreen 滚轮步进
+
   // diff
   "diffViewMode": "auto",                  // 布局：auto / split / unified
   "diffIndicatorMode": "bars",             // 变更指示：bars / classic / none
@@ -69,26 +86,17 @@ pi install git:github.com/minuque/pi-cc-extensions
   "animationIntervalMs": 90,               // 标题动画间隔（毫秒）
   "dimThinkingText": false,                // thinking 正文用 dim 色
 
-  // ui
-  "expandedInputMaxLines": 5,              // 展开工具卡 Input 可见行数，超出在末行显示展开提示
-  "expandedOutputMaxLines": 10,            // 展开工具卡 Output 可见行数，超出在末行显示展开提示
-  "expandedPreviewMaxLines": 40,           // 展开 diff/TaskList 正文最大行数
-  "inputClip": 100,                        // 工具摘要 path/command 折叠字符数
-  "showStartupHeader": true,               // 启动头（logo + tips）开关
-  "scrollStepLines": 3,                    // fullscreen 滚轮步进
-
-  // features
-  "enableSessionReference": true,          // @ session 引用
-  "enableSubagentAutocomplete": true,      // @ subagent 补全与委派提示
-  "enableContextCommand": true,            // /context 上下文检查
-  "enableAgentSummary": true,              // 每回合工具摘要
-  "enableWorkingMessage": true,            // Working... 底部 token/耗时
-  "enableAliases": true,                   // /clear、/exit 别名
-  "enableCustomFooter": true               // 两行 chips 状态栏（需 Nerd Font）
+  // footer
+  "enableCustomFooter": true,              // 自定义状态栏
+  "footerNerdIcons": true,                 // git/缓存用 Nerd Font 图标；false 为纯文本
+  "footerHiddenKeys": [],                  // 隐藏的插件芯片 key
+  "footerLine1Keys": ["pi-usage"],         // line1 插件芯片顺序；pi-usage 默认显示，数据来自 @narumitw/pi-usage
+  "footerLine2Keys": [],                   // line2 插件芯片顺序（接在 cwd/git 后）
+  "footerLine3Keys": []                    // line3 备用槽，有可见芯片才占行
 }
 ```
 
-> **Fullscreen**：单击 `click to show more` 展开工具卡、思考、Skill 和 compact 摘要；展开后 Input/Output 超行时，末行 `… +N more lines • click to show more` 打开全量预览。双击展开面板收起。
+> **Fullscreen**：单击 `click to show more` 展开工具卡、思考、Skill 和 compact 摘要；展开后 Input/Output 超行时，末行 `… +N more lines • click to show more` 打开全量预览, 双击展开面板收起。
 >
 > **建议**：`markdown.mermaid` 设为 `final`（`~/.pi/agent/settings.json` 或 `/settings` 面板的 Mermaid diagrams 选项）。默认 `streaming` 逐帧重绘，`final` 渲染最终版更稳定。
 
@@ -114,7 +122,6 @@ npm run typecheck
 | `npm:@ff-labs/pi-fff`                    | 模糊文件与内容检索（fffind / ffgrep）            |
 | `npm:pi-web-access`                      | 网页搜索、URL 抓取、GitHub 克隆、PDF/视频解析    |
 | `npm:@narumitw/pi-usage`                 | 查看当前账号用量（Codex / Copilot / OpenRouter） |
-| `git:github.com/DietrichGebert/ponytail` | 极简编码：强制最懒但有效的方案                   |
 
 ## 致谢
 

package/extensions/config/config.ts

@@ -1,4 +1,9 @@
 import type { CompactThinkingConfig } from "../feature/compact-thinking.ts";
+import {
+	DEFAULT_FOOTER_CHIP_LAYOUT,
+	formatFooterChipSummary,
+	normalizeFooterChipLayout,
+} from "../feature/shell/footer-layout.ts";
 import { existsSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
@@ -65,6 +70,11 @@ export type Config = {
 	enableWorkingMessage: boolean;
 	enableAliases: boolean;
 	enableCustomFooter: boolean;
+	footerNerdIcons: boolean;
+	footerHiddenKeys: string[];
+	footerLine1Keys: string[];
+	footerLine2Keys: string[];
+	footerLine3Keys: string[];
 };
 
 const AGENT_DIR = process.env.PI_CODING_AGENT_DIR ?? join(homedir(), ".pi", "agent");
@@ -128,6 +138,8 @@ export const DEFAULT_CONFIG: Config = {
 	enableWorkingMessage: true,
 	enableAliases: true,
 	enableCustomFooter: true,
+	footerNerdIcons: true,
+	...DEFAULT_FOOTER_CHIP_LAYOUT,
 };
 
 function pickEnum<T extends string>(value: unknown, allowed: readonly T[], fallback: T): T {
@@ -227,6 +239,8 @@ export function normalizeConfig(input: unknown): Config {
 		enableWorkingMessage: source.enableWorkingMessage !== false,
 		enableAliases: source.enableAliases !== false,
 		enableCustomFooter: source.enableCustomFooter !== false,
+		footerNerdIcons: source.footerNerdIcons !== false,
+		...normalizeFooterChipLayout(source),
 	};
 }
 
@@ -281,6 +295,8 @@ export function formatConfigStatus(source: Config = config): string {
 		`workingMsg=${source.enableWorkingMessage ? "on" : "off"}`,
 		`aliases=${source.enableAliases ? "on" : "off"}`,
 		`footer=${source.enableCustomFooter ? "on" : "off"}`,
+		`footerIcons=${source.footerNerdIcons ? "nerd" : "plain"}`,
+		formatFooterChipSummary(source),
 	].join(" · ");
 }
 

package/extensions/config/panel.ts

@@ -7,8 +7,23 @@
 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 { applyCustomFooter } from "../feature/shell/footer.ts";
-import { applyStartupHeader } from "../feature/shell/startup-header.ts";
+import {
+	applyCustomFooter,
+	clearCustomFooter,
+	getFooterStatusSnapshot,
+} from "../feature/shell/footer.ts";
+import {
+	footerChipDescription,
+	footerLineOfKey,
+	formatFooterChipSummary,
+	orderedFooterKeys,
+	reorderFooterKey,
+	resolveFooterChipLayout,
+	shiftFooterKeyLine,
+	toggleFooterKeyHidden,
+	type FooterChipLayout,
+} from "../feature/shell/footer-layout.ts";
+import { applyStartupHeader, clearStartupHeader } from "../feature/shell/startup-header.ts";
 import type { ToolGroupingHooks } from "../renderer/tool/grouping.ts";
 import {
 	config,
@@ -59,6 +74,120 @@ function excludeRenderersDescription(names: readonly string[]): string {
 		: `Native renderer for: ${names.join(", ")}. Agent is always native. Enter to toggle.`;
 }
 
+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.";
+}
+
+function pluginChipsDescription(): string {
+	return `Arrange plugin chips: ${formatFooterChipSummary(config)}. Enter to edit.`;
+}
+
+function footerLayoutFromConfig(): FooterChipLayout {
+	return {
+		footerHiddenKeys: config.footerHiddenKeys,
+		footerLine1Keys: config.footerLine1Keys,
+		footerLine2Keys: config.footerLine2Keys,
+		footerLine3Keys: config.footerLine3Keys,
+	};
+}
+
+function persistFooterLayout(layout: FooterChipLayout): void {
+	updateConfig({
+		footerHiddenKeys: layout.footerHiddenKeys,
+		footerLine1Keys: layout.footerLine1Keys,
+		footerLine2Keys: layout.footerLine2Keys,
+		footerLine3Keys: layout.footerLine3Keys,
+	});
+}
+
+function footerChipItem(
+	key: string,
+	layout: FooterChipLayout,
+	snapshot: ReadonlyMap<string, string>,
+) {
+	const line = footerLineOfKey(layout, key) ?? 2;
+	const hidden = layout.footerHiddenKeys.includes(key);
+	const live = snapshot.get(key)?.trim() ?? "";
+	return {
+		id: key,
+		label: key,
+		description: footerChipDescription(key, live),
+		currentValue: hidden ? `line${line} · hidden` : `line${line}`,
+	};
+}
+
+function buildFooterChipsSubmenu(
+	onClose: () => void,
+	onLiveChange: () => void,
+): {
+	render: (width: number) => string[];
+	invalidate: () => void;
+	handleInput: (data: string) => void;
+} {
+	const snapshot = () => getFooterStatusSnapshot();
+	const resolved = () => resolveFooterChipLayout(footerLayoutFromConfig(), [...snapshot().keys()]);
+	const items: ReturnType<typeof footerChipItem>[] = [];
+	const rebuildItems = (layout: FooterChipLayout, selectedKey?: string) => {
+		const next = orderedFooterKeys(layout).map((key) => footerChipItem(key, layout, snapshot()));
+		items.length = 0;
+		items.push(...next);
+		if (!selectedKey) return 0;
+		const index = items.findIndex((item) => item.id === selectedKey);
+		return index >= 0 ? index : 0;
+	};
+	rebuildItems(resolved());
+	const list = new SettingsList(
+		items,
+		Math.min(8, Math.max(4, items.length)),
+		getSettingsListTheme(),
+		() => {},
+		() => onClose(),
+		{ enableSearch: false },
+	);
+	const listState = list as unknown as { selectedIndex: number; items: typeof items };
+
+	const mutate = (transform: (layout: FooterChipLayout, key: string) => FooterChipLayout) => {
+		const key = listState.items[listState.selectedIndex]?.id;
+		if (!key) return;
+		const next = transform(resolved(), key);
+		persistFooterLayout(next);
+		listState.selectedIndex = rebuildItems(
+			resolveFooterChipLayout(next, [...snapshot().keys()]),
+			key,
+		);
+		onLiveChange();
+	};
+
+	return {
+		render: (width: number) => list.render(width),
+		invalidate: () => list.invalidate(),
+		handleInput: (data: string) => {
+			if (matchesKey(data, "left")) {
+				mutate((layout, key) => shiftFooterKeyLine(layout, key, -1));
+				return;
+			}
+			if (matchesKey(data, "right")) {
+				mutate((layout, key) => shiftFooterKeyLine(layout, key, 1));
+				return;
+			}
+			if (data === "[") {
+				mutate((layout, key) => reorderFooterKey(layout, key, -1));
+				return;
+			}
+			if (data === "]") {
+				mutate((layout, key) => reorderFooterKey(layout, key, 1));
+				return;
+			}
+			if (data === " " || matchesKey(data, "space")) {
+				mutate((layout, key) => toggleFooterKeyHidden(layout, key));
+				return;
+			}
+			list.handleInput(data);
+		},
+	};
+}
+
 function diffViewModeDescription(mode: DiffViewMode): string {
 	if (mode === "split") return "Force side-by-side diff when width allows; otherwise unified.";
 	if (mode === "unified") return "Always render a single unified diff column.";
@@ -186,7 +315,7 @@ function buildNumberInputSubmenu(
 
 /** Section tabs for /ccstyle — matches Zentui-style "A / B / C" headers. */
 type CcstyleSection = {
-	id: "style" | "diff" | "thinking" | "ui" | "feature";
+	id: "style" | "diff" | "thinking" | "ui" | "feature" | "footer";
 	label: string;
 	items: any[];
 };
@@ -242,19 +371,22 @@ export async function showCcstylePanel(
 			currentValue: config.mode === "compact" ? "compact (Experimental)" : config.mode,
 			values: ["on", "compact (Experimental)", "off"],
 		};
-		// Tracks whether the Exclude-tools submenu is open so Tab switches sections
+		// Tracks whether a nested submenu is open so Tab switches sections
 		// only at the top level (mirrors Zentui settings: Tab = switch sections).
-		let excludeSubmenuOpen = false;
+		let nestedSubmenuOpen = false;
+		let nestedHint = "";
 		const excludeSetting = {
 			id: "excludeRenderers",
 			label: "Exclude tools",
 			description: excludeRenderersDescription(config.excludeRenderers),
 			currentValue: formatExcludeRenderers(config.excludeRenderers),
 			submenu: (_current: string, closeSubmenu: (selected?: string) => void) => {
-				excludeSubmenuOpen = true;
+				nestedSubmenuOpen = true;
+				nestedHint = "  Enter/Space to toggle · Esc back to Style";
 				return buildExcludeRenderersSubmenu(
 					() => {
-						excludeSubmenuOpen = false;
+						nestedSubmenuOpen = false;
+						nestedHint = "";
 						excludeSetting.currentValue = formatExcludeRenderers(config.excludeRenderers);
 						excludeSetting.description = excludeRenderersDescription(config.excludeRenderers);
 						closeSubmenu();
@@ -456,13 +588,45 @@ export async function showCcstylePanel(
 			"Aliases disabled.",
 			config.enableAliases,
 		);
-		const customFooterToggle = featureToggleSetting(
-			"enableCustomFooter",
-			"Status bar",
-			"Two-line chips status bar with model, context, git, and usage. Applies immediately. Needs a Nerd Font.",
-			"Pi native footer restored.",
-			config.enableCustomFooter,
-		);
+		const footerNerdIconsSetting = {
+			id: "footerNerdIcons",
+			label: "Nerd Font icons",
+			description: config.footerNerdIcons
+				? "Git and cache chips use Nerd Font glyphs. Turn off for plain text."
+				: "Git and cache chips use plain text. No Nerd Font required.",
+			currentValue: config.footerNerdIcons ? "on" : "off",
+			values: ["on", "off"],
+		};
+		const customFooterSetting = {
+			id: "enableCustomFooter",
+			label: "Status bar",
+			description: customFooterDescription(config.enableCustomFooter),
+			currentValue: config.enableCustomFooter ? "on" : "off",
+			values: ["on", "off"],
+		};
+		const pluginChipsSetting = {
+			id: "footerPluginChips",
+			label: "Plugin chips",
+			description: pluginChipsDescription(),
+			currentValue: formatFooterChipSummary(config),
+			submenu: (_current: string, closeSubmenu: (selected?: string) => void) => {
+				nestedSubmenuOpen = true;
+				nestedHint = "  ←→ line · [ ] reorder · Space hide · Esc back to Footer";
+				return buildFooterChipsSubmenu(
+					() => {
+						nestedSubmenuOpen = false;
+						nestedHint = "";
+						pluginChipsSetting.currentValue = formatFooterChipSummary(config);
+						pluginChipsSetting.description = pluginChipsDescription();
+						closeSubmenu();
+					},
+					() => {
+						pluginChipsSetting.currentValue = formatFooterChipSummary(config);
+						pluginChipsSetting.description = pluginChipsDescription();
+					},
+				);
+			},
+		};
 		const featureToggles: Record<string, { apply: (on: boolean) => void }> = {
 			enableSessionReference: sessionReferenceToggle,
 			enableSubagentAutocomplete: subagentAutocompleteToggle,
@@ -474,9 +638,22 @@ export async function showCcstylePanel(
 
 		const onSettingChange = (id: string, value: string) => {
 			if (id === "enableCustomFooter") {
-				updateConfig({ enableCustomFooter: value === "on" });
-				customFooterToggle.apply(value === "on");
-				applyCustomFooter(ctx);
+				const enabled = value === "on";
+				updateConfig({ enableCustomFooter: enabled });
+				customFooterSetting.currentValue = enabled ? "on" : "off";
+				customFooterSetting.description = customFooterDescription(enabled);
+				if (enabled) applyCustomFooter(ctx);
+				else clearCustomFooter(ctx);
+				ctx.ui.notify(`Updated ${id}: ${value}`, "info");
+				return;
+			}
+			if (id === "footerNerdIcons") {
+				const enabled = value === "on";
+				updateConfig({ footerNerdIcons: enabled });
+				footerNerdIconsSetting.currentValue = enabled ? "on" : "off";
+				footerNerdIconsSetting.description = enabled
+					? "Git and cache chips use Nerd Font glyphs. Turn off for plain text."
+					: "Git and cache chips use plain text. No Nerd Font required.";
 				ctx.ui.notify(`Updated ${id}: ${value}`, "info");
 				return;
 			}
@@ -601,14 +778,16 @@ export async function showCcstylePanel(
 						? "Thinking text uses the theme's dim color."
 						: "Keep the default thinking text color.";
 					break;
-				case "showStartupHeader":
-					updateConfig({ showStartupHeader: value === "on" });
+				case "showStartupHeader": {
+					const enabled = value === "on";
+					updateConfig({ showStartupHeader: enabled });
 					startupHeaderSetting.description = config.showStartupHeader
 						? "Show the custom startup header (logo + tips) on new sessions."
 						: "Use Pi's native startup header instead.";
-					// 实时切换：on → 自定义 header；off → 官方默认 header。
-					applyStartupHeader(ctx);
+					if (enabled) applyStartupHeader(ctx);
+					else clearStartupHeader(ctx);
 					break;
+				}
 				case "scrollStepLines":
 					updateConfig({
 						scrollStepLines: pickPositiveInt(value, DEFAULT_CONFIG.scrollStepLines, 1, 50),
@@ -629,6 +808,30 @@ export async function showCcstylePanel(
 				label: "Style",
 				items: [modeSetting, excludeSetting],
 			},
+			{
+				id: "feature",
+				label: "Features",
+				items: [
+					sessionReferenceToggle.setting,
+					subagentAutocompleteToggle.setting,
+					contextCommandToggle.setting,
+					agentSummaryToggle.setting,
+					workingMessageToggle.setting,
+					aliasesToggle.setting,
+				],
+			},
+			{
+				id: "ui",
+				label: "UI",
+				items: [
+					expandedInputSetting,
+					expandedOutputSetting,
+					expandedMaxSetting,
+					inputClipSetting,
+					startupHeaderSetting,
+					scrollStepSetting,
+				],
+			},
 			{
 				id: "diff",
 				label: "Diff",
@@ -652,29 +855,9 @@ export async function showCcstylePanel(
 				],
 			},
 			{
-				id: "ui",
-				label: "UI",
-				items: [
-					expandedInputSetting,
-					expandedOutputSetting,
-					expandedMaxSetting,
-					inputClipSetting,
-					startupHeaderSetting,
-					scrollStepSetting,
-				],
-			},
-			{
-				id: "feature",
-				label: "Feature",
-				items: [
-					sessionReferenceToggle.setting,
-					subagentAutocompleteToggle.setting,
-					contextCommandToggle.setting,
-					agentSummaryToggle.setting,
-					workingMessageToggle.setting,
-					aliasesToggle.setting,
-					customFooterToggle.setting,
-				],
+				id: "footer",
+				label: "Footer",
+				items: [customFooterSetting, footerNerdIconsSetting, pluginChipsSetting],
 			},
 		];
 
@@ -695,7 +878,7 @@ export async function showCcstylePanel(
 		const activeList = () => lists[activeSection]!;
 
 		const switchSection = (delta: number) => {
-			if (excludeSubmenuOpen) return;
+			if (nestedSubmenuOpen) return;
 			activeSection = (activeSection + delta + sections.length) % sections.length;
 		};
 
@@ -745,7 +928,8 @@ export async function showCcstylePanel(
 					truncateToWidth(
 						theme.fg(
 							"dim",
-							"  Enter/Space to change · Enter on numbers types a custom value · Tab/Shift+Tab to switch sections · Esc to close",
+							nestedHint ||
+								"  Enter/Space to change · Enter on numbers types a custom value · Tab/Shift+Tab to switch sections · Esc to close",
 						),
 						safeWidth,
 					),
@@ -756,12 +940,12 @@ export async function showCcstylePanel(
 				for (const list of lists) list.invalidate();
 			},
 			handleInput(data: string) {
-				if (!excludeSubmenuOpen && isForwardTabKey(data)) {
+				if (!nestedSubmenuOpen && isForwardTabKey(data)) {
 					switchSection(1);
 					tui.requestRender();
 					return;
 				}
-				if (!excludeSubmenuOpen && isBackTabKey(data)) {
+				if (!nestedSubmenuOpen && isBackTabKey(data)) {
 					switchSection(-1);
 					tui.requestRender();
 					return;

package/extensions/feature/shell/footer-layout.ts

@@ -0,0 +1,229 @@
+/**
+ * 自定义 footer 插件芯片布局：行、顺序、隐藏。
+ * 纯函数，供 config 规范化、footer 渲染、配置面板共用。
+ */
+
+export const PI_USAGE_KEY = "pi-usage";
+export const PI_USAGE_SOURCE = "@narumitw/pi-usage";
+const LEGACY_PI_USAGE_KEYS = new Set(["localUsage", "piUsage"]);
+export const SKIP_FOOTER_STATUS_KEY = "model";
+
+export type FooterLineId = 1 | 2 | 3;
+
+export type FooterChipLayout = {
+	footerHiddenKeys: string[];
+	footerLine1Keys: string[];
+	footerLine2Keys: string[];
+	footerLine3Keys: string[];
+};
+
+export const DEFAULT_FOOTER_CHIP_LAYOUT: FooterChipLayout = {
+	footerHiddenKeys: [],
+	footerLine1Keys: [PI_USAGE_KEY],
+	footerLine2Keys: [],
+	footerLine3Keys: [],
+};
+
+export function isSkippedFooterStatusKey(key: string): boolean {
+	return key === SKIP_FOOTER_STATUS_KEY;
+}
+
+/** 未单独配置时的默认行：usage 类和本包用量在 line1，其余 line2。不会默认进 line3。 */
+export function defaultFooterLine(key: string): FooterLineId {
+	if (key === PI_USAGE_KEY) return 1;
+	if (/usage|quota|balance/i.test(key)) return 1;
+	return 2;
+}
+
+export function normalizeFooterKeyList(value: unknown): string[] {
+	if (!Array.isArray(value)) return [];
+	const out: string[] = [];
+	const seen = new Set<string>();
+	for (const item of value) {
+		if (typeof item !== "string") continue;
+		let key = item.trim();
+		if (LEGACY_PI_USAGE_KEYS.has(key)) key = PI_USAGE_KEY;
+		if (!key || isSkippedFooterStatusKey(key) || seen.has(key)) continue;
+		seen.add(key);
+		out.push(key);
+	}
+	return out;
+}
+
+function takeUnique(keys: string[], seen: Set<string>): string[] {
+	const out: string[] = [];
+	for (const key of keys) {
+		if (seen.has(key)) continue;
+		seen.add(key);
+		out.push(key);
+	}
+	return out;
+}
+
+/** 跨行去重（line1 → line2 → line3）；补上 pi-usage 槽位。 */
+export function normalizeFooterChipLayout(source: Record<string, unknown>): FooterChipLayout {
+	const hasHidden = Array.isArray(source.footerHiddenKeys);
+	const hasAnyLine = [source.footerLine1Keys, source.footerLine2Keys, source.footerLine3Keys].some(
+		Array.isArray,
+	);
+	const seen = new Set<string>();
+	let footerLine1Keys = takeUnique(normalizeFooterKeyList(source.footerLine1Keys), seen);
+	const footerLine2Keys = takeUnique(normalizeFooterKeyList(source.footerLine2Keys), seen);
+	const footerLine3Keys = takeUnique(normalizeFooterKeyList(source.footerLine3Keys), seen);
+	const footerHiddenKeys = normalizeFooterKeyList(source.footerHiddenKeys);
+
+	if (!seen.has(PI_USAGE_KEY)) {
+		footerLine1Keys = [PI_USAGE_KEY, ...footerLine1Keys];
+	}
+	if (!hasHidden && !hasAnyLine) {
+		return { ...DEFAULT_FOOTER_CHIP_LAYOUT };
+	}
+	return { footerHiddenKeys, footerLine1Keys, footerLine2Keys, footerLine3Keys };
+}
+
+/** 面板描述用：pi-usage 数据来自 @narumitw/pi-usage，其它芯片用来源 setStatus key。 */
+export function footerChipSource(key: string): string {
+	return key === PI_USAGE_KEY ? PI_USAGE_SOURCE : key;
+}
+
+export function footerChipDescription(key: string, liveText: string): string {
+	const source = footerChipSource(key);
+	const live = liveText.trim();
+	if (live) return `${live} · from ${source}`;
+	if (key === PI_USAGE_KEY) return `From ${source}. No text right now.`;
+	return `inactive · from ${source}`;
+}
+
+export function footerLineOfKey(layout: FooterChipLayout, key: string): FooterLineId | undefined {
+	if (layout.footerLine1Keys.includes(key)) return 1;
+	if (layout.footerLine2Keys.includes(key)) return 2;
+	if (layout.footerLine3Keys.includes(key)) return 3;
+	return undefined;
+}
+
+function keysOnLine(layout: FooterChipLayout, line: FooterLineId): string[] {
+	if (line === 1) return layout.footerLine1Keys;
+	if (line === 2) return layout.footerLine2Keys;
+	return layout.footerLine3Keys;
+}
+
+function withLineKeys(
+	layout: FooterChipLayout,
+	line: FooterLineId,
+	keys: string[],
+): FooterChipLayout {
+	if (line === 1) return { ...layout, footerLine1Keys: keys };
+	if (line === 2) return { ...layout, footerLine2Keys: keys };
+	return { ...layout, footerLine3Keys: keys };
+}
+
+/**
+ * 配置里还没有的 live key 接到默认行末尾（按 key 字母序，避免每次渲染乱序）。
+ * pi-usage 由 normalize 保证已在某一行。
+ */
+export function resolveFooterChipLayout(
+	layout: FooterChipLayout,
+	liveKeys: readonly string[],
+): FooterChipLayout {
+	const known = new Set([
+		...layout.footerLine1Keys,
+		...layout.footerLine2Keys,
+		...layout.footerLine3Keys,
+	]);
+	const extras = [
+		...new Set(liveKeys.filter((key) => key && !isSkippedFooterStatusKey(key) && !known.has(key))),
+	].sort((a, b) => a.localeCompare(b));
+	const next: FooterChipLayout = {
+		footerHiddenKeys: [...layout.footerHiddenKeys],
+		footerLine1Keys: [...layout.footerLine1Keys],
+		footerLine2Keys: [...layout.footerLine2Keys],
+		footerLine3Keys: [...layout.footerLine3Keys],
+	};
+	for (const key of extras) {
+		if (defaultFooterLine(key) === 1) next.footerLine1Keys.push(key);
+		else next.footerLine2Keys.push(key);
+	}
+	return next;
+}
+
+export function moveFooterKeyToLine(
+	layout: FooterChipLayout,
+	key: string,
+	line: FooterLineId,
+): FooterChipLayout {
+	if (isSkippedFooterStatusKey(key)) return layout;
+	const current = footerLineOfKey(layout, key);
+	if (current === line) return layout;
+	const stripped: FooterChipLayout = {
+		footerHiddenKeys: [...layout.footerHiddenKeys],
+		footerLine1Keys: layout.footerLine1Keys.filter((item) => item !== key),
+		footerLine2Keys: layout.footerLine2Keys.filter((item) => item !== key),
+		footerLine3Keys: layout.footerLine3Keys.filter((item) => item !== key),
+	};
+	return withLineKeys(stripped, line, [...keysOnLine(stripped, line), key]);
+}
+
+export function shiftFooterKeyLine(
+	layout: FooterChipLayout,
+	key: string,
+	delta: -1 | 1,
+): FooterChipLayout {
+	const current = footerLineOfKey(layout, key);
+	if (!current) return layout;
+	const next = (current + delta) as number;
+	if (next < 1 || next > 3) return layout;
+	return moveFooterKeyToLine(layout, key, next as FooterLineId);
+}
+
+export function reorderFooterKey(
+	layout: FooterChipLayout,
+	key: string,
+	delta: -1 | 1,
+): FooterChipLayout {
+	const line = footerLineOfKey(layout, key);
+	if (!line) return layout;
+	const keys = [...keysOnLine(layout, line)];
+	const index = keys.indexOf(key);
+	const nextIndex = index + delta;
+	if (index < 0 || nextIndex < 0 || nextIndex >= keys.length) return layout;
+	const swap = keys[nextIndex]!;
+	keys[nextIndex] = key;
+	keys[index] = swap;
+	return withLineKeys(layout, line, keys);
+}
+
+export function toggleFooterKeyHidden(layout: FooterChipLayout, key: string): FooterChipLayout {
+	if (isSkippedFooterStatusKey(key)) return layout;
+	const hidden = new Set(layout.footerHiddenKeys);
+	if (hidden.has(key)) hidden.delete(key);
+	else hidden.add(key);
+	return { ...layout, footerHiddenKeys: [...hidden] };
+}
+
+/** 按行顺序收集可见、且当前有文案的插件芯片文本。 */
+export function visibleFooterPluginTexts(
+	lineKeys: readonly string[],
+	hiddenKeys: readonly string[],
+	texts: ReadonlyMap<string, string>,
+): string[] {
+	const hidden = new Set(hiddenKeys);
+	const out: string[] = [];
+	for (const key of lineKeys) {
+		if (hidden.has(key)) continue;
+		const text = texts
+			.get(key)
+			?.replace(/[\r\n\t]+/g, " ")
+			.trim();
+		if (text) out.push(text);
+	}
+	return out;
+}
+
+export function formatFooterChipSummary(layout: FooterChipLayout): string {
+	const hidden = layout.footerHiddenKeys.length;
+	return `hidden=${hidden} · L1=${layout.footerLine1Keys.length} · L2=${layout.footerLine2Keys.length} · L3=${layout.footerLine3Keys.length}`;
+}
+
+export function orderedFooterKeys(layout: FooterChipLayout): string[] {
+	return [...layout.footerLine1Keys, ...layout.footerLine2Keys, ...layout.footerLine3Keys];
+}

package/extensions/feature/shell/footer.ts

@@ -1,8 +1,9 @@
 /**
  * 自定义底栏：chips + zentui 图标/句子
  *
- * 第一行：model  thinking · ██████░░░░ 45%/200k · 󰆼 42% · $0.01 · 用量
- * 第二行：cwd in session on  branch (+16 −1) · 其他扩展状态
+ * 第一行：model  thinking · ██████░░░░ 45%/200k · 󰆼 42% · $0.01 · 用户排到 line1 的插件芯片
+ * 第二行：cwd in session on  branch (+16 −1) · 用户排到 line2 的插件芯片
+ * 第三行：仅当 line3 有可见插件芯片时出现
  *
  *  - line1 短芯片，· 分隔；缓存用 zentui 󰆼，费用 success
  *  - line2 用 zentui 句式 in / on + 
@@ -20,13 +21,26 @@ import { join } from "node:path";
 import { pathToFileURL } from "node:url";
 import { config } from "../../config/config.ts";
 import { stripAnsi } from "../../utils/ansi-text.ts";
+import {
+	PI_USAGE_KEY,
+	isSkippedFooterStatusKey,
+	resolveFooterChipLayout,
+	visibleFooterPluginTexts,
+	type FooterChipLayout,
+} from "./footer-layout.ts";
 
 const GIT_REFRESH_INTERVAL_MS = 10_000;
 const USAGE_REFRESH_INTERVAL_MS = 5 * 60 * 1000;
 const USAGE_TIMEOUT_MS = 15_000;
-// zentui NERD_DEFAULT_ICONS：git / cacheHit
-const ICON_GIT = "";
-const ICON_CACHE = "󰆼";
+// 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 } {
+	return nerdIcons
+		? { git: FOOTER_NERD_ICON_GIT, cache: FOOTER_NERD_ICON_CACHE }
+		: { git: "", cache: "" };
+}
 
 type GitStats = { add: number; del: number };
 
@@ -54,12 +68,6 @@ export function parseGitStats(stdout: string): GitStats {
 	return { add, del };
 }
 
-export function classifyStatus(key: string): "usage" | "skip" | "other" {
-	if (key === "model") return "skip"; // line1 已有供应商/模型
-	if (/usage|quota|balance/i.test(key)) return "usage";
-	return "other";
-}
-
 export function formatXaiFooterChip(report: XaiFooterReport): string | undefined {
 	const included = report.buckets?.find((b) => b.id === "included-allowance");
 	if (included?.unit === "percent" && typeof included.used === "number") {
@@ -87,14 +95,44 @@ export function formatXaiFooterChip(report: XaiFooterReport): string | undefined
 	return undefined;
 }
 
-export function pickFooterUsageText(
-	pluginUsage: string | undefined,
-	localChip: string | undefined,
-): string | undefined {
-	const plugin = pluginUsage?.trim();
-	if (plugin && !/^checking$/i.test(plugin)) return plugin;
-	const local = localChip?.trim();
-	return local || undefined;
+const cachedExtensionStatuses = new Map<string, string>();
+let cachedLocalUsageText = "";
+
+/** 面板用：当前 setStatus 文案 + 本包 pi-usage（无文案时为空字符串）。 */
+export function getFooterStatusSnapshot(): Map<string, string> {
+	const out = new Map<string, string>();
+	for (const [key, text] of cachedExtensionStatuses) {
+		if (isSkippedFooterStatusKey(key)) continue;
+		out.set(key, text);
+	}
+	out.set(PI_USAGE_KEY, cachedLocalUsageText);
+	return out;
+}
+
+function rememberExtensionStatuses(entries: Iterable<[string, string]>): void {
+	cachedExtensionStatuses.clear();
+	for (const [key, raw] of entries) {
+		if (isSkippedFooterStatusKey(key)) continue;
+		const text = stripAnsi(raw.replace(/[\r\n\t]+/g, " ").trim());
+		if (text) cachedExtensionStatuses.set(key, text);
+	}
+}
+
+function pluginTextsForRender(localUsageChip: string): Map<string, string> {
+	cachedLocalUsageText = stripAnsi(localUsageChip.replace(/[\r\n\t]+/g, " ").trim());
+	const texts = new Map<string, string>(cachedExtensionStatuses);
+	if (cachedLocalUsageText) texts.set(PI_USAGE_KEY, cachedLocalUsageText);
+	else texts.delete(PI_USAGE_KEY);
+	return texts;
+}
+
+function layoutFromConfig(): FooterChipLayout {
+	return {
+		footerHiddenKeys: config.footerHiddenKeys,
+		footerLine1Keys: config.footerLine1Keys,
+		footerLine2Keys: config.footerLine2Keys,
+		footerLine3Keys: config.footerLine3Keys,
+	};
 }
 
 let piUsageMod: any | null | undefined;
@@ -317,26 +355,33 @@ const createCustomFooterFactory =
 			const thinkingLevelStr = ctx.thinkingLevel || "off";
 			const thinkingColor = theme.getThinkingBorderColor(thinkingLevelStr);
 
-			const otherStatuses: string[] = [];
-			const usageStatuses: string[] = [];
-			for (const [key, raw] of Array.from(
+			rememberExtensionStatuses(
 				footerData.getExtensionStatuses().entries() as Iterable<[string, string]>,
-			).sort(([a], [b]) => a.localeCompare(b))) {
-				const t = raw.replace(/[\r\n\t]+/g, " ").trim();
-				if (!t) continue;
-				const kind = classifyStatus(key);
-				if (kind === "skip") continue;
-				if (kind === "usage") {
-					usageStatuses.push(stripAnsi(t));
-				} else {
-					otherStatuses.push(theme.fg("dim", stripAnsi(t)));
-				}
-			}
-
-			const usageText = pickFooterUsageText(usageStatuses[0], localUsageChip);
+			);
+			const pluginTexts = pluginTextsForRender(localUsageChip);
+			const layout = resolveFooterChipLayout(layoutFromConfig(), [...pluginTexts.keys()]);
+			const dimPlugin = (text: string) => colorUsageChip(theme, text);
+			const line1Plugins = visibleFooterPluginTexts(
+				layout.footerLine1Keys,
+				layout.footerHiddenKeys,
+				pluginTexts,
+			).map(dimPlugin);
+			const line2Plugins = visibleFooterPluginTexts(
+				layout.footerLine2Keys,
+				layout.footerHiddenKeys,
+				pluginTexts,
+			).map(dimPlugin);
+			const line3Plugins = visibleFooterPluginTexts(
+				layout.footerLine3Keys,
+				layout.footerHiddenKeys,
+				pluginTexts,
+			).map(dimPlugin);
 
 			const pctLabel = percent === null || percent === undefined ? "?" : `${Math.floor(percent)}%`;
 			const cachePct = getCachePct();
+			const glyphs = footerGlyphs(config.footerNerdIcons);
+			const cacheLabel =
+				cachePct > 0 ? `${glyphs.cache ? `${glyphs.cache} ` : ""}${Math.floor(cachePct)}%` : "";
 			const costChip =
 				cost || usingSubscription
 					? theme.fg("dim", `$${cost.toFixed(2)}`) +
@@ -346,9 +391,9 @@ const createCustomFooterFactory =
 				theme.fg("accent", modelLabel),
 				model?.reasoning ? thinkingColor(thinkingLevelStr) : "",
 				barGauge(percent ?? 0) + theme.fg("dim", ` ${pctLabel}/${fmt(contextWindow)}`),
-				cachePct > 0 ? theme.fg("dim", `${ICON_CACHE} ${Math.floor(cachePct)}%`) : "",
+				cacheLabel ? theme.fg("dim", cacheLabel) : "",
 				costChip,
-				usageText ? colorUsageChip(theme, usageText) : "",
+				...line1Plugins,
 			]);
 
 			const gitColor = theme.getThinkingBorderColor("medium");
@@ -367,11 +412,17 @@ const createCustomFooterFactory =
 							theme.fg("error", `−${gitStats.del}`) +
 							theme.fg("dim", ")")
 						: "";
-				place += theme.fg("muted", " on ") + gitColor(`${ICON_GIT} ${branch}`) + stats;
+				const gitLabel = glyphs.git ? `${glyphs.git} ${branch}` : branch;
+				place += theme.fg("muted", " on ") + gitColor(gitLabel) + stats;
 			}
-			const line2 = joinChips([place, ...otherStatuses]);
-
-			return [truncateToWidth(line1, width), ...(line2 ? [truncateToWidth(line2, width)] : [])];
+			const line2 = joinChips([place, ...line2Plugins]);
+			const line3 = joinChips(line3Plugins);
+
+			return [
+				truncateToWidth(line1, width),
+				...(line2 ? [truncateToWidth(line2, width)] : []),
+				...(line3 ? [truncateToWidth(line3, width)] : []),
+			];
 		};
 
 		return {
@@ -395,16 +446,9 @@ const createCustomFooterFactory =
 		};
 	};
 
-/**
- * 按配置应用底栏：on → 自定义 footer；off → 恢复官方默认 footer。
- * 导出供 /ccstyle 面板在切换开关时实时重应用。
- */
+/** Apply the configured custom footer without disturbing another extension's footer when disabled. */
 export function applyCustomFooter(ctx: ExtensionContext): void {
-	if (!ctx?.hasUI || typeof ctx.ui?.setFooter !== "function") return;
-	if (!config.enableCustomFooter) {
-		ctx.ui.setFooter(undefined);
-		return;
-	}
+	if (!ctx?.hasUI || typeof ctx.ui?.setFooter !== "function" || !config.enableCustomFooter) return;
 	try {
 		ctx.ui.setFooter(createCustomFooterFactory(ctx));
 	} catch (err) {
@@ -412,6 +456,12 @@ export function applyCustomFooter(ctx: ExtensionContext): void {
 	}
 }
 
+/** Restore Pi's native footer when the user explicitly disables this extension's active footer. */
+export function clearCustomFooter(ctx: ExtensionContext): void {
+	if (!ctx?.hasUI || typeof ctx.ui?.setFooter !== "function") return;
+	ctx.ui.setFooter(undefined);
+}
+
 export default function (pi: ExtensionAPI) {
 	// 模型/思考级别变化时强制重渲染（自定义 footer 不会被内置 invalidate() 触达）
 	pi.on("model_select", () => {

package/extensions/feature/shell/startup-header.ts

@@ -279,15 +279,9 @@ export function renderHeaderLines(
 	);
 }
 
-/**
- * 按配置应用启动头：on → 自定义 header；off → 恢复官方默认 header。
- * 导出供 /ccstyle 面板在切换开关时实时重应用。
- */
+/** 按配置安装启动头。禁用时不碰槽位，避免清掉其他扩展的 header。 */
 export function applyStartupHeader(ctx: any): void {
-	if (!ctx?.hasUI || typeof ctx.ui?.setHeader !== "function") return;
-	if (!config.showStartupHeader) {
-		// 恢复官方内置 header（logo + 快捷键提示 + onboarding）。
-		ctx.ui.setHeader(undefined);
+	if (!ctx?.hasUI || typeof ctx.ui?.setHeader !== "function" || !config.showStartupHeader) {
 		return;
 	}
 	ctx.ui.setHeader((_tui: unknown, theme: any) => ({
@@ -298,6 +292,12 @@ export function applyStartupHeader(ctx: any): void {
 	}));
 }
 
+/** 用户从 /ccstyle 关掉本扩展启动头时，恢复官方 header。 */
+export function clearStartupHeader(ctx: any): void {
+	if (!ctx?.hasUI || typeof ctx.ui?.setHeader !== "function") return;
+	ctx.ui.setHeader(undefined);
+}
+
 export default function piStartupHeader(pi: ExtensionAPI) {
 	pi.on("session_start", async (_event, ctx) => {
 		applyStartupHeader(ctx);

package/package.json

@@ -1,8 +1,8 @@
 {
 	"name": "pi-cc-extensions",
-	"version": "0.9.0",
+	"version": "0.9.2",
 	"license": "MIT",
-	"description": "A Pi productivity suite with Claude Code-style UI, context inspection, and agent/session references",
+	"description": "Claude Code-style TUI output with some personal touches and handy utilities.",
 	"type": "module",
 	"keywords": [
 		"pi-package",