@herbertgao/pi-extensions 2026.9.18 → 2026.9.20

package/README.md

@@ -18,29 +18,27 @@ When migrating from `pi-mcp-adapter`, remove any standalone adapter install as w
 
 ## Bundled extensions
 
-The package bundles 6 active `@herbertgao/*` child packages—`pi-bark`, `pi-cc-extensions`, `resume-from`, `pi-subagents`, `sol-pi`, and the maintained Antigravity provider mirror—plus the following upstream packages under their original names:
-
-- `pi-antigravity@0.7.2`
-- `@dietrichgebert/ponytail@4.9.0`
-- `@juicesharp/rpiv-ask-user-question@2.8.0`
-- `@narumitw/pi-btw@0.61.0`
-
-- `@narumitw/pi-caffeinate@0.49.7`
-- `@pi-plugins/fast-mode@0.1.10`
-- `@tifan/pi-copy-response@0.2.6`
+The package bundles 5 active `@herbertgao/*` child packages—`pi-bark`, `pi-cc-extensions`, `resume-from`, `pi-subagents`, and `sol-pi`—plus the following upstream packages under their original names:
+
+- `pi-antigravity@0.8.1`
+- `@dietrichgebert/ponytail@4.10.0`
+- `@juicesharp/rpiv-ask-user-question@2.11.0`
+- `@narumitw/pi-btw@0.61.1`
+- `@narumitw/pi-caffeinate@0.49.8`
+- `@pi-plugins/fast-mode@0.1.12`
+- `@tifan/pi-copy-response@0.2.7`
 - `@tifan/pi-handoff@2.2.2`
-- `@tifan/pi-inline-skills@1.0.5`
-- `@tifan/pi-mermaid-open@0.2.0`
-- `@tifan/pi-preferred-thinking@1.0.1`
-- `@tifan/pi-recap@0.4.6`
+- `@tifan/pi-inline-skills@1.0.6`
+- `@tifan/pi-mermaid-open@0.2.1`
+- `@tifan/pi-preferred-thinking@1.0.2`
+- `@tifan/pi-recap@0.4.7`
 - `@tifan/pi-rename@0.6.0`
-- `pi-typesafe@0.8.0`
+- `pi-typesafe@0.8.1`
 - `pi-multi-account@1.23.2`
 - `pi-next-cue@1.0.7`
-- `pi-footer@0.5.1`
 - `pi-jev-auto-mode@0.5.0`
-- `pi-lens@4.2.1`
-- `pi-web-access@0.27.0`
+- `pi-lens@4.3.0`
+- `pi-web-access@0.34.0`
 - `remote-pi@0.7.0`
 
 Pi loads their extensions and skills through `node_modules/` paths inside one package root. The upstream companions are pinned and bundled, not forked or renamed.
@@ -49,11 +47,11 @@ Pi loads their extensions and skills through `node_modules/` paths inside one pa
 
 `@herbertgao/pi-bark` sends localized Bark pushes when a user-facing Pi run fully settles or `@juicesharp/rpiv-ask-user-question` needs an answer. Notifications include emoji-labeled machine/path metadata and support the bundled official Pi badge through Bark's `icon` parameter. Configure it in `$PI_CODING_AGENT_DIR/bark.json` (normally `~/.pi/agent/bark.json`); see the [package README](../pi-bark/README.md). Without a valid endpoint it stays inactive.
 
-`@narumitw/pi-caffeinate@0.49.7` uses the host platform's sleep inhibitor during each Pi agent run. On macOS, `/caffeinate sleep` keeps the system awake while allowing the display to sleep; `/caffeinate display` also keeps the display awake. It releases the inhibitor when the run or session ends.
+`@narumitw/pi-caffeinate@0.49.8` uses the host platform's sleep inhibitor during each Pi agent run. On macOS, `/caffeinate sleep` keeps the system awake while allowing the display to sleep; `/caffeinate display` also keeps the display awake. It releases the inhibitor when the run or session ends.
 
-`pi-jev-auto-mode@0.5.0` adds fail-closed Jev safety gates for shell commands and file changes. `pi-typesafe@0.8.0` adds the `/typesafe` command and `typesafe_evaluate` tool for explicit structured decisions; both use the TypeSafe API after login.
+`pi-jev-auto-mode@0.5.0` adds fail-closed Jev safety gates for shell commands and file changes. `pi-typesafe@0.8.1` adds the `/typesafe` command and `typesafe_evaluate` tool for explicit structured decisions; both use the TypeSafe API after login.
 
-`@herbertgao/resume-from@0.2.0` keeps Claude Code sessions associated with their original repository when the active transcript later moves into a nested cwd. `@herbertgao/sol-pi@0.1.0` adds opt-in Action Fusion, ObservationPack, Evidence-Preserving Reducer, and Online Context Compact; see its [configuration guide](../sol-pi/docs/configuration.md). `pi-lens@4.2.1` expands language routing and bounds retained diagnostic facts across multi-root sessions. `pi-web-access@0.27.0` adds configurable fetch deadlines and answer models plus isolated GitHub clone runtimes. Preferred Thinking 1.0.1 preserves an explicit subagent `--thinking` choice. Deprecated `@tifan/pi-titlebar-spinner` is no longer bundled; Rename remains the single owner of Herdr tab naming.
+`@herbertgao/resume-from@0.2.0` keeps Claude Code sessions associated with their original repository when the active transcript later moves into a nested cwd. `@herbertgao/sol-pi@0.1.0` adds opt-in Action Fusion, ObservationPack, Evidence-Preserving Reducer, and Online Context Compact; see its [configuration guide](../sol-pi/docs/configuration.md). `pi-lens@4.3.0` expands language routing and bounds retained diagnostic facts across multi-root sessions. `pi-web-access@0.34.0` provides configurable web search and fetch tools; its `toolActivation` defaults to `auto`, choosing eager or dynamic tool activation per model. `pi-antigravity@0.8.1` reads Pi 0.86+ transcript system messages, so Antigravity requests carry Pi's system prompt and tools; it also registers `google_search` and `generate_image` tools that use the signed-in Antigravity account. Preferred Thinking 1.0.2 preserves an explicit subagent `--thinking` choice. Deprecated `@tifan/pi-titlebar-spinner` is no longer bundled; Rename remains the single owner of Herdr tab naming.
 
 `pi-stash` is no longer bundled: `/btw` already preserves the main editor draft while handling side questions outside the main conversation. Prior `@herbertgao/pi-stash` releases remain available but are no longer maintained here.
 
@@ -61,15 +59,9 @@ Pi loads their extensions and skills through `node_modules/` paths inside one pa
 
 `pi-next-cue@1.0.7` predicts a short next prompt after each completed agent turn. In the empty editor, `Tab` fills the suggestion and `Enter` sends it. Each settled turn can make one extra model request using recent conversation text, recent tool names/results, and the configured active or explicitly selected model. It is TUI-only and wraps the prompt editor, so do not enable another custom-editor extension that also owns the editor slot.
 
-If `pi-footer` was installed separately before upgrading to an aggregate release that includes it, remove the standalone source shown by `pi list` so only the bundled copy loads. For the pinned standalone install used while preparing this integration:
-
-```bash
-pi remove npm:pi-footer@0.5.1
-```
-
 ### Footer
 
-`pi-footer` is enabled by the aggregate. It preserves the native path, Git branch, session, token/context, model, and thinking information. Configure it in `$PI_CODING_AGENT_DIR/extensions/pi-footer.json`; use `/footer` for interactive changes. Only one footer-replacement extension should be enabled at a time.
+The configurable status bar is provided by `@herbertgao/pi-cc-extensions` and enabled by default (`/ccstyle` → Footer page: chips, lines, ordering, plain-text icons). `pi-footer` is no longer bundled. If `pi-footer` was installed separately, remove it so only one footer extension owns the status bar; a leftover `$PI_CODING_AGENT_DIR/extensions/pi-footer.json` can be deleted.
 
 For the intended compact status text, merge the optional pi-lens widget setting into its existing file rather than replacing the file:
 

package/THIRD_PARTY_NOTICES.md

@@ -86,7 +86,7 @@ THE SOFTWARE.
 
 ## `pi-antigravity`
 
-The aggregate bundles the MIT-licensed [`pi-antigravity`](https://github.com/Rahularya01/pi-antigravity) package version 0.7.2 under its original attribution:
+The aggregate bundles the MIT-licensed [`pi-antigravity`](https://github.com/Rahularya01/pi-antigravity) package version 0.8.1 under its original attribution:
 
 MIT License
 

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

@@ -1,109 +1,126 @@
-<p align="center">
-  <img src="./assets/readme/hero.en.svg" width="100%" alt="pi-cc-extensions: a productivity extension suite for Pi">
-</p>
-
-<p align="center">
-  <a href="https://pi.dev/packages?name=%40herbertgao%2Fpi-cc-extensions"><img alt="Pi package catalog" src="https://img.shields.io/badge/Pi-package-58B7FF?style=flat-square"></a>
-  <a href="https://www.npmjs.com/package/@herbertgao/pi-cc-extensions"><img alt="npm version" src="https://img.shields.io/npm/v/%40herbertgao%2Fpi-cc-extensions?style=flat-square&color=66E3C4"></a>
-  <a href="#compatibility"><img alt="Node.js 24 or newer" src="https://img.shields.io/badge/Node.js-%E2%89%A524-66E3C4?style=flat-square"></a>
-  <a href="./extensions"><img alt="TypeScript extensions" src="https://img.shields.io/badge/TypeScript-extensions-3178C6?style=flat-square"></a>
-</p>
-
-<p align="center">
-  Claude Code-style TUI output with some personal touches and handy utilities.
-</p>
-
 <p align="center">
   <a href="./README.md">简体中文</a> · <strong>English</strong>
 </p>
 
----
+# pi-cc-extensions
+
+> Claude Code-style TUI output with some personal touches and handy utilities.
 
 ## Preview
 
-<table>
-  <img width="100%" alt="demo_new" src="https://github.com/user-attachments/assets/d4f9bb51-a49a-4a34-aa60-006514d37b09" />
-</table>
+<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>
+
+Click the cover to play the demo video
 
 ## Quick start
 
 ```bash
 pi install npm:@herbertgao/pi-cc-extensions
+
+# GitHub (this monorepo)
+pi install git:github.com/HerbertGao/pi-extensions
 ```
 
 Run `/reload` after installation.
 
 ## Features
 
-| 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 / UI / Feature` tabs with startup, wheel, and optional feature toggles                                                        | `/ccstyle`  |
-| Context inspection           | Usage breakdown and previews for the system prompt, memory, tools, tool results, 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`    |
+| 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`                                        |
+
+Renderer snapshots for `on` / `compact` modes: [default](./docs/tool-render-examples-default.md) · [compact](./docs/tool-render-examples-compact.md)
 
 ## Configuration
 
-`/ccstyle` behavior is configured through `~/.pi/agent/claude-code-style.json`:
+`/ccstyle` behavior is configured through `~/.pi/agent/pi-cc-extensions.json`:
 
-```js
+```jsonc
 {
-  "mode": "on",                            // on: Claude Code style; compact: one-line summaries; off: Pi native rendering
-  "excludeRenderers": [],                  // exact tool names that keep their native renderer; Agent always keeps its dedicated renderer
-  "diffViewMode": "auto",                  // diff layout: auto / split / unified
-  "diffIndicatorMode": "bars",             // diff change indicators: bars / classic / none
-  "diffSplitMinWidth": 120,                // min terminal width before auto layout uses side-by-side columns
-  "editDiffCollapsedLines": 24,                // diff body lines shown when collapsed; beyond that shows the expand hint (Ctrl+O / click)
-  "diffWordWrap": true,                    // whether long diff lines wrap (otherwise truncated)
-  "expandedPreviewMaxLines": 40,           // max body lines for expanded output/diff
-  "useSummaryTitlesAsThinkingTitle": true, // use the latest provider summary as the active thinking title
-  "previewLines": 3,                       // thinking preview lines; 0 hides the preview body
-  "animationIntervalMs": 90,               // thinking title animation interval in ms
-  "dimThinkingText": false,                // dim thinking body text
-  "showStartupHeader": true,               // custom startup header (logo + tips) toggle
-  "scrollStepLines": 3,                    // fullscreen mouse wheel scroll lines
+  // 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 autocomplete
-  "enableContextCommand": true,            // /context inspection
+  "enableSubagentAutocomplete": true,      // @subagent:[name] completion and delegation hints
+  "enableContextCommand": true,            // /context usage check
   "enableAgentSummary": true,              // per-turn tool summary
-  "enableWorkingMessage": true,            // Working... token/time details
-  "enableAliases": true                    // /clear and /exit aliases
+  "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
+
+  // 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
+
+  // 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
+
+  // 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
 }
 ```
 
-> **Tip**: set Mermaid diagrams to `final` in `/settings` to avoid redrawing streaming content frame by frame.
+> [!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).
+
+> [!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.
 
 ## Local development
 
 ```bash
-bun run test
-bun run typecheck
+npm test
+npm run typecheck
 ./test.bat # or pi -e .
 ```
 
 ## Compatibility
 
-- Node.js `>=24`, Pi `^0.84.0 || ^0.85.0` (loaded through `pi.extensions` and `pi.themes` in the root `package.json`)
-
-## Built-in capabilities
-
-Pi 0.99+ provides native MCP tools and `/mcp` management; do not install another MCP extension that registers `/mcp`.
+- Node.js `>=22.19.0`, Pi `^0.84.0`
 
 ## 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
 
-- Derived from [`minuque/pi-cc-extensions` v0.8.68](https://github.com/minuque/pi-cc-extensions/releases/tag/v0.8.68) (`1ca144c`) under the MIT license.
 - 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).
+
+## License
+
+[MIT](./LICENSE) © 2026 minuque; derivative maintained in [HerbertGao/pi-extensions](https://github.com/HerbertGao/pi-extensions/tree/master/packages/pi-cc-extensions)

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

@@ -1,109 +1,126 @@
-<p align="center">
-  <img src="./assets/readme/hero.svg" width="100%" alt="pi-cc-extensions：Pi 终端效率扩展套件">
-</p>
-
-<p align="center">
-  <a href="https://pi.dev/packages?name=%40herbertgao%2Fpi-cc-extensions"><img alt="Pi package catalog" src="https://img.shields.io/badge/Pi-package-58B7FF?style=flat-square"></a>
-  <a href="https://www.npmjs.com/package/@herbertgao/pi-cc-extensions"><img alt="npm version" src="https://img.shields.io/npm/v/%40herbertgao%2Fpi-cc-extensions?style=flat-square&color=66E3C4"></a>
-  <a href="#兼容性"><img alt="Node.js 24 or newer" src="https://img.shields.io/badge/Node.js-%E2%89%A524-66E3C4?style=flat-square"></a>
-  <a href="./extensions"><img alt="TypeScript extensions" src="https://img.shields.io/badge/TypeScript-extensions-3178C6?style=flat-square"></a>
-</p>
-
-<p align="center">
-  类 Claude Code TUI 输出风格，并融入了一些个人喜好，和一些实用小功能。
-</p>
-
 <p align="center">
   <strong>简体中文</strong> · <a href="./README.en.md">English</a>
 </p>
 
----
+# pi-cc-extensions
+
+> 类 Claude Code TUI 输出风格，并融入了一些个人喜好，和一些实用小功能。
 
 ## 界面预览
 
-<table>
-  <img width="100%" alt="demo_new" src="https://github.com/user-attachments/assets/d4f9bb51-a49a-4a34-aa60-006514d37b09" />
-</table>
+<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>
+
+点击封面播放演示视频
 
 ## 快速开始
 
 ```bash
 pi install npm:@herbertgao/pi-cc-extensions
+
+# GitHub（本 monorepo）
+pi install git:github.com/HerbertGao/pi-extensions
 ```
 
 安装后执行 `/reload`
 
 ## 功能
 
-| 功能                 | 说明                                                                                                     | 入口        |
-| ---------------------- | ---------------------------------------------------------------------------------------------------------- | ------------- |
-| Claude Code UI | 工具摘要、折叠展开、rich edit/write diff，以及 `on` / `compact` / `off` 三种模式                          | `/ccstyle`  |
-| Fullscreen mode  | 工具卡/group 点击展开与收起、预览、hover 高亮、回到底部按钮 | `TUIMODE=fullscreen` 或 `--tui-mode fullscreen` |
-| 配置面板             | `Style / Diff / Thinking / UI / Feature` 五页签，含启动头、滚轮步进及可选功能开关                              | `/ccstyle`  |
-| 上下文检查           | 查看上下文占用，并预览 System prompt、Memory、Tools、Tool results、Skills 和消息内容                              | `/context`  |
-| Session/Subagent 引用         | 搜索并注入历史 Session 或现有 SubAgent 的有效上下文                                                      | `@` |
-| 主题                 | 随包提供内置 CC Dark、CC Light 主题                                                                      | `/theme`    |
+| 功能                  | 说明                                                                            | 入口                                            |
+| --------------------- | ------------------------------------------------------------------------------- | ----------------------------------------------- |
+| Claude Code UI        | 工具摘要、折叠展开、rich edit/write diff，以及`on` / `compact` / `off` 三种模式 | `/ccstyle`                                      |
+| Markdown 增强         | Mermaid 图、提示框、URL 链接化等                                                        | 自动生效                                        |
+| Fullscreen mode       | 工具卡/group 单击展开与收起、预览、hover 高亮、回到底部按钮                 | `TUIMODE=fullscreen` 或 `--tui-mode fullscreen` |
+| 配置面板              | `Style / Features / UI / Diff / Thinking / Footer` 六页签                       | `/ccstyle`                                      |
+| 上下文检查            | 查看上下文占用，并预览 System prompt、Memory、Skills、Tools definition 和消息内容 | `/context`                                      |
+| Session/Subagent 引用 | 搜索并注入历史 Session 或现有 SubAgent 的有效上下文                             | `@`                                             |
+| 状态栏                | 显示：模型、上下文、缓存、费用、git并适配 @narumitw/pi-usage 实时显示额度；git/缓存图标可关 Nerd Font | `/ccstyle`                              |
+| 主题                  | 随包提供内置 CC Dark、CC Light 主题                                             | `/theme`                                        |
+
+`on` / `compact` 两种模式的渲染样例：[默认模式](./docs/tool-render-examples-default.md) · [紧凑模式](./docs/tool-render-examples-compact.md)
 
 ## 配置
 
-`/ccstyle` 的行为由 `~/.pi/agent/claude-code-style.json` 配置：
+`/ccstyle` 的行为由 `~/.pi/agent/pi-cc-extensions.json` 配置：
 
-```js
+```jsonc
 {
-  "mode": "on",                            // on：Claude Code 风格；compact：单行摘要；off：Pi 原生渲染
-  "excludeRenderers": [],                  // 走原生渲染的工具名列表（精确匹配），Agent 始终保留专用渲染器
-  "diffViewMode": "auto",                  // diff 布局：auto / split / unified
-  "diffIndicatorMode": "bars",             // diff 变更指示：bars / classic / none
-  "diffSplitMinWidth": 120,                // 自动布局下使用左右分栏的最小终端宽度
-  "editDiffCollapsedLines": 24,                // 折叠时展示的 diff 行数，超出显示展开提示（Ctrl+O / 点击）
-  "diffWordWrap": true,                    // 长 diff 行是否换行（否则截断）
-  "expandedPreviewMaxLines": 40,           // 展开后输出/diff 正文的最大行数
-  "useSummaryTitlesAsThinkingTitle": true, // 用最新 provider 摘要作为思考标题
-  "previewLines": 3,                       // thinking 预览行数，0 隐藏预览正文
-  "animationIntervalMs": 90,               // thinking 标题动画间隔（毫秒）
-  "dimThinkingText": false,                // thinking 正文使用 dim 色
-  "showStartupHeader": true,               // 自定义启动头（logo + tips）开关
-  "scrollStepLines": 3,                    // fullscreen 滚轮滚动步进行数
+  // style
+  "mode": "on",                            // on / compact / off
+  "excludeRenderers": [],                  // 走原生渲染的工具名；Agent 始终保留专用渲染器
+
+  // features
   "enableSessionReference": true,          // @ session 引用
-  "enableSubagentAutocomplete": true,      // @ subagent 自动补全
+  "enableSubagentAutocomplete": true,      // @subagent:[name] 补全与委派提示
   "enableContextCommand": true,            // /context 上下文检查
-  "enableAgentSummary": true,              // 每回合工具统计摘要
-  "enableWorkingMessage": true,            // Working... token/耗时展示
-  "enableAliases": true                    // /clear、/exit 别名
+  "enableAgentSummary": true,              // 每回合工具摘要
+  "enableWorkingMessage": true,            // Working... 底部 token/耗时
+  "enableAliases": true,                   // /clear、/exit 别名
+
+  // ui
+  "expandedInputMaxLines": 5,              // 展开工具卡 Input 可见行数，超出在末行显示展开提示
+  "expandedOutputMaxLines": 10,            // 展开工具卡 Output 可见行数，超出在末行显示展开提示
+  "expandedPreviewMaxLines": 40,           // 展开 TaskList 正文最大行数（展开 diff 始终全量）
+  "inputClip": 0,                          // 工具摘要 path/command 折叠字符数；0 = 按可用宽度
+  "showStartupHeader": true,               // 启动头（logo + tips）开关
+  "scrollStepLines": 3,                    // fullscreen 滚轮步进
+
+  // diff
+  "diffViewMode": "auto",                  // 布局：auto / split / unified
+  "diffIndicatorMode": "bars",             // 变更指示：bars / classic / none
+  "diffSplitMinWidth": 120,                // 左右分栏的最小终端宽度
+  "editDiffCollapsedLines": 24,            // Edit 折叠行数，超出显示展开提示
+  "writeDiffCollapsedLines": 0,            // write 折叠行数，0 仅显示创建摘要
+  "diffWordWrap": true,                    // 长 diff 行换行
+
+  // thinking
+  "useSummaryTitlesAsThinkingTitle": true, // 用最新摘要作思考标题
+  "previewLines": 3,                       // 预览行数，0 隐藏
+  "animationIntervalMs": 90,               // 标题动画间隔（毫秒）
+  "dimThinkingText": false,                // thinking 正文用 dim 色
+
+  // 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 备用槽，有可见芯片才占行
 }
 ```
 
-> **建议**：在 `/settings` 中将 Mermaid diagrams 设为 `final`，避免流式内容逐帧重绘。
+> [!TIP]
+> **全屏模式**：单击 `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` 渲染最终版更稳定。
 
 ## 本地开发
 
 ```bash
-bun run test
-bun run typecheck
+npm test
+npm run typecheck
 ./test.bat # or pi -e .
 ```
 
 ## 兼容性
 
-- Node.js `>=24`，Pi `^0.84.0 || ^0.85.0`（通过根目录 `package.json` 的 `pi.extensions` 和 `pi.themes` 加载）
-
-## 内置能力
-
-Pi 0.99+ 的内置 MCP 负责 MCP 工具与 `/mcp` 管理；不要再安装会注册 `/mcp` 的第三方 MCP 扩展。
+- Node.js `>=22.19.0`，Pi `^0.84.0`
 
 ## 推荐搭配
 
 | 扩展                                     | 用途                                             |
-| ------------------------------------------ | -------------------------------------------------- |
+| ---------------------------------------- | ------------------------------------------------ |
 | `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` | 极简编码：强制最懒但有效的方案                   |
 
 ## 致谢
 
-- 基于 MIT 许可的 [`minuque/pi-cc-extensions` v0.8.68](https://github.com/minuque/pi-cc-extensions/releases/tag/v0.8.68)（`1ca144c`）衍生维护。
 - 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)。
+
+## 许可证
+
+[MIT](./LICENSE) © 2026 minuque；衍生维护：[HerbertGao/pi-extensions](https://github.com/HerbertGao/pi-extensions/tree/master/packages/pi-cc-extensions)