pi-cc-extensions 0.8.53 → 0.8.55

package/README.en.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="./assets/readme/hero.svg" width="100%" alt="pi-cc-extensions: a productivity extension suite for Pi">
+  <img src="./assets/readme/hero.en.svg" width="100%" alt="pi-cc-extensions: a productivity extension suite for Pi">
 </p>
 
 <p align="center">
@@ -10,7 +10,7 @@
 </p>
 
 <p align="center">
-  Claude Code-style output, context inspection, and Agent / Session references.
+  Claude Code-style TUI output with some personal touches and handy utilities.
 </p>
 
 <p align="center">
@@ -38,15 +38,14 @@ Run `/reload` after installation.
 
 ## Features
 
-
-| Feature                      | Description                                                                                                                                       | Entry point |
-| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
-| Claude Code-style output     | Tool summaries, expand/collapse, rich edit/write diffs, and`on` / `compact` / `off` modes                                                         | `/ccstyle`  |
-| Fullscreen mouse interaction | Tool card/group click-to-toggle, previews, hover highlight, and a back-to-bottom button | `TUIMODE=fullscreen` or `--tui-mode fullscreen` |
-| Settings panel               | `Style / Diff / Thinking / Feature` tabs: startup header toggle and wheel step                                                                    | `/ccstyle`  |
-| Context inspection           | Usage breakdown and previews for the system prompt, tools, skills, and messages                                                                   | `/context`  |
-| Session references           | Search and inject effective context from previous Sessions or existing SubAgents                                                                  | `@session:` |
-| Theme                        | Bundled CC Dark and CC Light themes                                                                                                               | `/theme`    |
+| Feature                     | Description                                                                               | Entry point                                     |
+| --------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------- |
+| Claude Code Output          | Tool summaries, expand/collapse, rich edit/write diffs, and`on` / `compact` / `off` modes | `/ccstyle`                                      |
+| Fullscreen mode             | Tool card/group click-to-toggle, previews, hover highlight, and a back-to-bottom button   | `TUIMODE=fullscreen` or `--tui-mode fullscreen` |
+| Settings panel              | `Style / Diff / Thinking / Feature` tabs: startup header toggle and wheel step            | `/ccstyle`                                      |
+| Context inspection          | Usage breakdown and previews for the system prompt, tools, skills, and messages           | `/context`                                      |
+| Session/Subagent references | Search and inject effective context from previous Sessions or existing SubAgents          | `@`                                             |
+| Theme                       | Bundled CC Dark and CC Light themes                                                       | `/theme`                                        |
 
 ## Configuration
 
@@ -78,26 +77,22 @@ npm run typecheck
 ./test.bat # or pi -e .
 ```
 
-Run `/reload` after changing extensions.
-
 ## Compatibility
 
 - Node.js `>=22.19.0`, Pi `^0.84.0` (loaded through `pi.extensions` and `pi.themes` in the root `package.json`)
 
 ## 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:pi-theme-picker`                    | Theme search and live preview                                |
 | `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
 
-- Rich diffs are adapted from [`MasuRii/pi-tool-display`](https://github.com/MasuRii/pi-tool-display) (MIT). See [`extensions/tool-diff/ATTRIBUTION.md`](./extensions/tool-diff/ATTRIBUTION.md).
+- Rich diffs are adapted from [`MasuRii/pi-tool-display`](https://github.com/MasuRii/pi-tool-display) (MIT). See [`extensions/renderer/tool/diff/ATTRIBUTION.md`](./extensions/renderer/tool/diff/ATTRIBUTION.md).

package/README.md

@@ -10,7 +10,7 @@
 </p>
 
 <p align="center">
-  类 Claude Code TUI 输出风格、上下文检查，以及 Agent / Session 引用。
+  类 Claude Code TUI 输出风格，并融入了一些个人喜好，和一些实用小功能。
 </p>
 
 <p align="center">
@@ -38,15 +38,14 @@ pi install git:github.com/minuque/pi-cc-extensions
 
 ## 功能
 
-
-| 功能                 | 说明                                                                                                     | 入口        |
-| ---------------------- | ---------------------------------------------------------------------------------------------------------- | ------------- |
-| Claude Code 风格输出 | 工具摘要、折叠展开、rich edit/write diff，以及`on` / `compact` / `off` 三种模式                          | `/ccstyle`  |
-| Fullscreen 鼠标交互  | 工具卡/group 点击展开与收起、预览、hover 高亮、回到底部按钮 | `TUIMODE=fullscreen` 或 `--tui-mode fullscreen` |
-| 配置面板             | `Style / Diff / Thinking / Feature` 四页签，含启动头开关与滚轮步进                                       | `/ccstyle`  |
-| 上下文检查           | 查看上下文占用，并预览 System prompt、Tools、Skills 和消息内容                                           | `/context`  |
-| Session 引用         | 搜索并注入历史 Session 或现有 SubAgent 的有效上下文                                                      | `@session:` |
-| 主题                 | 随包提供内置 CC Dark、CC Light 主题                                                                      | `/theme`    |
+| 功能                  | 说明                                                                            | 入口                                            |
+| --------------------- | ------------------------------------------------------------------------------- | ----------------------------------------------- |
+| Claude Code UI        | 工具摘要、折叠展开、rich edit/write diff，以及`on` / `compact` / `off` 三种模式 | `/ccstyle`                                      |
+| Fullscreen mode       | 工具卡/group 点击展开与收起、预览、hover 高亮、回到底部按钮                     | `TUIMODE=fullscreen` 或 `--tui-mode fullscreen` |
+| 配置面板              | `Style / Diff / Thinking / Feature` 四页签，含启动头开关与滚轮步进              | `/ccstyle`                                      |
+| 上下文检查            | 查看上下文占用，并预览 System prompt、Tools、Skills 和消息内容                  | `/context`                                      |
+| Session/Subagent 引用 | 搜索并注入历史 Session 或现有 SubAgent 的有效上下文                             | `@`                                             |
+| 主题                  | 随包提供内置 CC Dark、CC Light 主题                                             | `/theme`                                        |
 
 ## 配置
 
@@ -66,7 +65,13 @@ pi install git:github.com/minuque/pi-cc-extensions
   "previewLines": 3,                       // thinking 预览行数，0 隐藏预览正文
   "animationIntervalMs": 90,               // thinking 标题动画间隔（毫秒）
   "showStartupHeader": true,               // 自定义启动头（logo + tips）开关
-  "scrollStepLines": 3                     // fullscreen 滚轮滚动步进行数
+  "scrollStepLines": 3,                     // fullscreen 滚轮滚动步进行数
+  "enableSessionReference": true,           // @ session 引用（搜历史会话注入上下文）
+  "enableSubagentAutocomplete": true,       // @ subagent 自动补全与委派提示
+  "enableContextCommand": true,             // /context 上下文占用检查
+  "enableAgentSummary": true,               // 每回合工具统计摘要
+  "enableWorkingMessage": true,             // Working... 底部 token/耗时展示
+  "enableAliases": true                     // /clear、/exit 别名
 }
 ```
 
@@ -78,26 +83,22 @@ npm run typecheck
 ./test.bat # or pi -e .
 ```
 
-修改扩展后执行 `/reload`。
-
 ## 兼容性
 
 - Node.js `>=22.19.0`，Pi `^0.84.0`（通过根目录 `package.json` 的 `pi.extensions` 和 `pi.themes` 加载）
 
 ## 推荐搭配
 
-
 | 扩展                                     | 用途                                             |
-| ------------------------------------------ | -------------------------------------------------- |
+| ---------------------------------------- | ------------------------------------------------ |
 | `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:pi-theme-picker`                    | 主题搜索和实时预览                               |
 | `npm:@narumitw/pi-usage`                 | 查看当前账号用量（Codex / Copilot / OpenRouter） |
 | `git:github.com/DietrichGebert/ponytail` | 极简编码：强制最懒但有效的方案                   |
 
 ## 致谢
 
-- Rich diff 改编自 [`MasuRii/pi-tool-display`](https://github.com/MasuRii/pi-tool-display)（MIT）；详见 [`extensions/tool-diff/ATTRIBUTION.md`](./extensions/tool-diff/ATTRIBUTION.md)。
+- Rich diff 改编自 [`MasuRii/pi-tool-display`](https://github.com/MasuRii/pi-tool-display)（MIT）；详见 [`extensions/renderer/tool/diff/ATTRIBUTION.md`](./extensions/renderer/tool/diff/ATTRIBUTION.md)。

package/assets/readme/hero.en.svg

@@ -0,0 +1,101 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="400" viewBox="0 0 1200 400" role="img" aria-labelledby="title desc">
+  <title id="title">pi-cc-extensions
+  </title>
+  <desc id="desc">The Claude and Pi brand marks together connect three extension capabilities: Claude Code-style output, context inspection, and historical Session references.
+  </desc>
+  <defs>
+    <linearGradient id="panel" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#0D131B"/>
+      <stop offset="1" stop-color="#090D12"/>
+    </linearGradient>
+  </defs>
+  <rect width="1200" height="400" rx="28" fill="url(#panel)"/>
+  <rect x="1" y="1" width="1198" height="398" rx="27" fill="none" stroke="#263241" stroke-width="2"/>
+  <g id="title-block" transform="translate(64 58)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', sans-serif">
+    <g font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="16" font-weight="600" letter-spacing="1.4">
+      <text x="0" y="0" fill="#66E3C4">PI EXTENSION
+      </text>
+    </g>
+    <text x="0" y="82" fill="#F4F7FA" font-size="54" font-weight="750" letter-spacing="-1.5">pi-cc-extensions
+    </text>
+    <text x="0" y="130" fill="#B8C3CF" font-size="23">Make Pi work like Claude Code 🙃
+    </text>
+    <g transform="translate(0 180)" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="17">
+      <rect width="488" height="58" rx="12" fill="#111923" stroke="#2B3948"/>
+      <text x="20" y="36" fill="#66E3C4">›
+      </text>
+      <text x="44" y="36" fill="#F4F7FA">/ccstyle
+      </text>
+      <text x="155" y="36" fill="#536172">·
+      </text>
+      <text x="178" y="36" fill="#7CC7FF">/context
+      </text>
+      <text x="292" y="36" fill="#536172">·
+      </text>
+      <text x="315" y="36" fill="#F2C879">@session:
+      </text>
+      <rect x="411" y="22" width="9" height="20" rx="2" fill="#66E3C4"/>
+    </g>
+    <g transform="translate(0 282)" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">
+      <circle cx="6" cy="-5" r="6" fill="#66E3C4"/>
+      <text x="22" y="0" fill="#8B9AAD">3 EXTENSIONS
+      </text>
+      <text x="160" y="0" fill="#3B4857">•
+      </text>
+      <text x="183" y="0" fill="#8B9AAD">TYPESCRIPT
+      </text>
+      <text x="303" y="0" fill="#3B4857">•
+      </text>
+      <text x="326" y="0" fill="#8B9AAD">NODE ≥ 22.19
+      </text>
+    </g>
+  </g>
+  <g id="extension-map" transform="translate(662 48)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', sans-serif">
+    <g id="claude-pi-mark" transform="translate(0 0)">
+      <!-- Official Claude starburst vector; source: Anthropic Claude brand mark. -->
+        <path transform="translate(2 2) scale(.34)" fill="#D97757" d="m19.6 66.5 19.7-11 .3-1-.3-.5h-1l-3.3-.2-11.2-.3L14 53l-9.5-.5-2.4-.5L0 49l.2-1.5 2-1.3 2.9.2 6.3.5 9.5.6 6.9.4L38 49.1h1.6l.2-.7-.5-.4-.4-.4L29 41l-10.6-7-5.6-4.1-3-2-1.5-2-.6-4.2 2.7-3 3.7.3.9.2 3.7 2.9 8 6.1L37 36l1.5 1.2.6-.4.1-.3-.7-1.1L33 25l-6-10.4-2.7-4.3-.7-2.6c-.3-1-.4-2-.4-3l3-4.2L28 0l4.2.6L33.8 2l2.6 6 4.1 9.3L47 29.9l2 3.8 1 3.4.3 1h.7v-.5l.5-7.2 1-8.7 1-11.2.3-3.2 1.6-3.8 3-2L61 2.6l2 2.9-.3 1.8-1.1 7.7L59 27.1l-1.5 8.2h.9l1-1.1 4.1-5.4 6.9-8.6 3-3.5L77 13l2.3-1.8h4.3l3.1 4.7-1.4 4.9-4.4 5.6-3.7 4.7-5.3 7.1-3.2 5.7.3.4h.7l12-2.6 6.4-1.1 7.6-1.3 3.5 1.6.4 1.6-1.4 3.4-8.2 2-9.6 2-14.3 3.3-.2.1.2.3 6.4.6 2.8.2h6.8l12.6 1 3.3 2 1.9 2.7-.3 2-5.1 2.6-6.8-1.6-16-3.8-5.4-1.3h-.8v.4l4.6 4.5 8.3 7.5L89 80.1l.5 2.4-1.3 2-1.4-.2-9.2-7-3.6-3-8-6.8h-.5v.7l1.8 2.7 9.8 14.7.5 4.5-.7 1.4-2.6 1-2.7-.6-5.8-8-6-9-4.7-8.2-.5.4-2.9 30.2-1.3 1.5-3 1.2-2.5-2-1.4-3 1.4-6.2 1.6-8 1.3-6.4 1.2-7.9.7-2.6v-.2H49L43 72l-9 12.3-7.2 7.6-1.7.7-3-1.5.3-2.8L24 86l10-12.8 6-7.9 4-4.6-.1-.5h-.3L17.2 77.4l-4.7.6-2-2 .2-3 1-1 8-5.5Z"/>
+        <path d="M50 3V35" stroke="#3A4857" stroke-width="2"/>
+        <!-- Official Pi logo vectors; source: https://pi.dev/logo-auto.svg -->
+          <g transform="translate(52 -5) scale(.06)" fill="#F4F7FA">
+            <path fill-rule="evenodd" d="M165.29 165.29H517.36V400H400V517.36H282.65V634.72H165.29ZM282.65 282.65V400H400V282.65Z"/>
+            <path d="M517.36 400H634.72V634.72H517.36Z"/>
+          </g>
+          <text x="104" y="15" fill="#F4F7FA" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15" font-weight="700" letter-spacing=".8">CLAUDE CODE UX
+          </text>
+          <text x="104" y="34" fill="#7F8D9C" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="13" letter-spacing="1.2">FOR PI
+          </text>
+        </g>
+        <g transform="translate(0 52)">
+          <rect width="474" height="82" rx="14" fill="#101821" stroke="#2C3A48"/>
+          <rect width="5" height="82" rx="2.5" fill="#66E3C4"/>
+          <text x="26" y="32" fill="#F4F7FA" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="18" font-weight="700">/ccstyle
+          </text>
+          <text x="26" y="59" fill="#8B9AAD" font-size="16">Tool summaries · Diffs · Status bar
+          </text>
+          <circle cx="438" cy="29" r="9" fill="#66E3C4" opacity=".18"/>
+          <path d="M434 29l3 3 6-7" fill="none" stroke="#66E3C4" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+        </g>
+        <g transform="translate(0 144)">
+          <rect width="474" height="82" rx="14" fill="#101821" stroke="#2C3A48"/>
+          <rect width="5" height="82" rx="2.5" fill="#7CC7FF"/>
+          <text x="26" y="32" fill="#F4F7FA" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="18" font-weight="700">/context
+          </text>
+          <text x="26" y="59" fill="#8B9AAD" font-size="16">Usage breakdown · Injected content preview
+          </text>
+          <g transform="translate(416 23)">
+            <rect width="42" height="14" rx="7" fill="#1C2B38"/>
+            <rect width="27" height="14" rx="7" fill="#7CC7FF"/>
+          </g>
+        </g>
+        <g transform="translate(0 236)">
+          <rect width="474" height="82" rx="14" fill="#101821" stroke="#2C3A48"/>
+          <rect width="5" height="82" rx="2.5" fill="#F2C879"/>
+          <text x="26" y="32" fill="#F4F7FA" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="18" font-weight="700">@session:
+          </text>
+          <text x="26" y="59" fill="#8B9AAD" font-size="16">History completion · Cross-session references
+          </text>
+          <text x="431" y="40" fill="#F2C879" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="26">@
+          </text>
+        </g>
+      </g>
+    </svg>

package/extensions/config/config.ts

@@ -4,7 +4,7 @@ import {
 	type DiffIndicatorMode,
 	type DiffViewMode,
 	type ToolDisplayConfig,
-} from "../renderer/tool-diff/index.ts";
+} from "../renderer/tool/diff/index.ts";
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
@@ -25,6 +25,12 @@ export type Config = {
 	animationIntervalMs: number;
 	showStartupHeader: boolean;
 	scrollStepLines: number;
+	enableSessionReference: boolean;
+	enableSubagentAutocomplete: boolean;
+	enableContextCommand: boolean;
+	enableAgentSummary: boolean;
+	enableWorkingMessage: boolean;
+	enableAliases: boolean;
 };
 
 const AGENT_DIR = process.env.PI_CODING_AGENT_DIR ?? join(homedir(), ".pi", "agent");
@@ -67,6 +73,12 @@ export const DEFAULT_CONFIG: Config = {
 	animationIntervalMs: 90,
 	showStartupHeader: true,
 	scrollStepLines: 3,
+	enableSessionReference: true,
+	enableSubagentAutocomplete: true,
+	enableContextCommand: true,
+	enableAgentSummary: true,
+	enableWorkingMessage: true,
+	enableAliases: true,
 };
 
 function pickEnum<T extends string>(value: unknown, allowed: readonly T[], fallback: T): T {
@@ -86,22 +98,6 @@ export function pickPositiveNumber(value: unknown, fallback: number, min = 1): n
 	return Number.isFinite(n) ? Math.max(min, n) : fallback;
 }
 
-export function nearestPreset(value: number, presets: readonly string[]): string {
-	const numeric = presets.map((p) => Number(p));
-	let best = presets[0] ?? String(value);
-	let bestDist = Number.POSITIVE_INFINITY;
-	for (let i = 0; i < numeric.length; i++) {
-		const dist = Math.abs((numeric[i] ?? 0) - value);
-		if (dist < bestDist) {
-			bestDist = dist;
-			best = presets[i] ?? best;
-		}
-	}
-	// Prefer exact match when value is already a preset.
-	const exact = presets.find((p) => Number(p) === value);
-	return exact ?? best;
-}
-
 export function normalizeConfig(input: unknown): Config {
 	const source = (input && typeof input === "object" ? input : {}) as Record<string, unknown>;
 	const mode = source.mode;
@@ -164,6 +160,12 @@ export function normalizeConfig(input: unknown): Config {
 		),
 		showStartupHeader: source.showStartupHeader !== false,
 		scrollStepLines: pickPositiveInt(source.scrollStepLines, DEFAULT_CONFIG.scrollStepLines, 1, 50),
+		enableSessionReference: source.enableSessionReference !== false,
+		enableSubagentAutocomplete: source.enableSubagentAutocomplete !== false,
+		enableContextCommand: source.enableContextCommand !== false,
+		enableAgentSummary: source.enableAgentSummary !== false,
+		enableWorkingMessage: source.enableWorkingMessage !== false,
+		enableAliases: source.enableAliases !== false,
 	};
 }
 
@@ -205,6 +207,12 @@ export function formatConfigStatus(source: Config = config): string {
 		`thinkingAnimation=${source.animationIntervalMs}ms`,
 		`startupHeader=${source.showStartupHeader ? "on" : "off"}`,
 		`scrollStep=${source.scrollStepLines}`,
+		`sessionRef=${source.enableSessionReference ? "on" : "off"}`,
+		`subagentAuto=${source.enableSubagentAutocomplete ? "on" : "off"}`,
+		`context=${source.enableContextCommand ? "on" : "off"}`,
+		`agentSummary=${source.enableAgentSummary ? "on" : "off"}`,
+		`workingMsg=${source.enableWorkingMessage ? "on" : "off"}`,
+		`aliases=${source.enableAliases ? "on" : "off"}`,
 	].join(" · ");
 }
 

package/extensions/config/panel.ts

@@ -7,9 +7,9 @@
 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 { applyStartupHeader } from "../feature/pi-startup-header.ts";
-import type { ToolGroupingHooks } from "../renderer/tool-grouping.ts";
-import type { DiffIndicatorMode, DiffViewMode } from "../renderer/tool-diff/index.ts";
+import { applyStartupHeader } from "../feature/shell/startup-header.ts";
+import type { ToolGroupingHooks } from "../renderer/tool/grouping.ts";
+import type { DiffIndicatorMode, DiffViewMode } from "../renderer/tool/diff/index.ts";
 import {
 	config,
 	DEFAULT_CONFIG,
@@ -64,6 +64,30 @@ function diffIndicatorDescription(mode: DiffIndicatorMode): string {
 	return "Vertical bar indicators on changed lines (default).";
 }
 
+/** 额外功能开关项：on/off 二值，描述随状态切换；切换后需重启生效。 */
+function featureToggleSetting(
+	id: string,
+	label: string,
+	onDescription: string,
+	offDescription: string,
+	current: boolean,
+) {
+	const setting = {
+		id,
+		label,
+		description: current ? onDescription : offDescription,
+		currentValue: current ? "on" : "off",
+		values: ["on", "off"],
+	};
+	return {
+		setting,
+		apply(on: boolean): void {
+			setting.currentValue = on ? "on" : "off";
+			setting.description = on ? onDescription : offDescription;
+		},
+	};
+}
+
 function buildExcludeRenderersSubmenu(
 	onClose: () => void,
 	onLiveChange: () => void,
@@ -334,7 +358,68 @@ export async function showCcstylePanel(
 				buildNumberInputSubmenu(theme, scrollStepSetting, closeSubmenu),
 		};
 
+		// 额外功能开关：注册于扩展加载期，切换后需重启（/reload）生效。
+		const sessionReferenceToggle = featureToggleSetting(
+			"enableSessionReference",
+			"Session reference",
+			"@ session mentions search & inject referenced session context. Next restart applies.",
+			"Session reference disabled.",
+			config.enableSessionReference,
+		);
+		const subagentAutocompleteToggle = featureToggleSetting(
+			"enableSubagentAutocomplete",
+			"Subagent autocomplete",
+			"@ subagent mentions suggest agents and inject delegation instructions. Next restart applies.",
+			"Subagent autocomplete disabled.",
+			config.enableSubagentAutocomplete,
+		);
+		const contextCommandToggle = featureToggleSetting(
+			"enableContextCommand",
+			"Context usage",
+			"/context shows context-window distribution with previews. Next restart applies.",
+			"Context command disabled.",
+			config.enableContextCommand,
+		);
+		const agentSummaryToggle = featureToggleSetting(
+			"enableAgentSummary",
+			"Agent summary",
+			"Append per-round tool stats after each agent turn. Next restart applies.",
+			"Agent summary disabled.",
+			config.enableAgentSummary,
+		);
+		const workingMessageToggle = featureToggleSetting(
+			"enableWorkingMessage",
+			"Working message",
+			"Extend Working... footer with token count and elapsed time. Next restart applies.",
+			"Native Working... footer only.",
+			config.enableWorkingMessage,
+		);
+		const aliasesToggle = featureToggleSetting(
+			"enableAliases",
+			"Aliases",
+			"/clear and /exit aliases enabled. Next restart applies.",
+			"Aliases disabled.",
+			config.enableAliases,
+		);
+		const featureToggles: Record<string, { apply: (on: boolean) => void }> = {
+			enableSessionReference: sessionReferenceToggle,
+			enableSubagentAutocomplete: subagentAutocompleteToggle,
+			enableContextCommand: contextCommandToggle,
+			enableAgentSummary: agentSummaryToggle,
+			enableWorkingMessage: workingMessageToggle,
+			enableAliases: aliasesToggle,
+		};
+
 		const onSettingChange = (id: string, value: string) => {
+			// 额外功能开关：字段名与配置布尔字段一一对应，切换后重启生效。
+			const featureToggle = featureToggles[id];
+			if (featureToggle) {
+				(config as unknown as Record<string, boolean>)[id] = value === "on";
+				featureToggle.apply(value === "on");
+				saveConfig();
+				ctx.ui.notify(`Updated ${id}: ${value} (next restart)`, "info");
+				return;
+			}
 			switch (id) {
 				case "mode": {
 					// 选项值带 Experimental 标记，选择后还原为真实 mode 值。
@@ -450,7 +535,16 @@ export async function showCcstylePanel(
 			{
 				id: "feature",
 				label: "Feature",
-				items: [startupHeaderSetting, scrollStepSetting],
+				items: [
+					startupHeaderSetting,
+					scrollStepSetting,
+					sessionReferenceToggle.setting,
+					subagentAutocompleteToggle.setting,
+					contextCommandToggle.setting,
+					agentSummaryToggle.setting,
+					workingMessageToggle.setting,
+					aliasesToggle.setting,
+				],
 			},
 		];
 
@@ -553,4 +647,6 @@ export async function showCcstylePanel(
 			},
 		};
 	});
+	// 面板卸下后主 transcript 重新挂载；再刷一次，吃掉打开期间扫树失败的切换。
+	hooks.refreshCurrentTranscript(ctx, toolGrouping);
 }