pi-cc-extensions 0.8.16 → 0.8.18

package/README.en.md

@@ -1,174 +1,174 @@
-<p align="center">
-  <img src="./assets/readme/hero.svg" width="100%" alt="pi-cc-extensions: a productivity extension suite for Pi">
-</p>
-
-<p align="center">
-  <a href="https://pi.dev/packages?name=pi-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/pi-cc-extensions"><img alt="npm version" src="https://img.shields.io/npm/v/pi-cc-extensions?style=flat-square&color=66E3C4"></a>
-  <a href="#compatibility"><img alt="Node.js 22.19 or newer" src="https://img.shields.io/badge/Node.js-%E2%89%A522.19-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 output, structured questionnaires, context inspection, and Agent / Session references.
-</p>
-
-<p align="center">
-  <a href="./README.md">简体中文</a> · <strong>English</strong>
-</p>
-
----
-
-## Preview
-
-<table>
-  <tr>
-    <td colspan="2" align="center">
-      <img src="./assets/readme/welcome.webp" width="100%" alt="Pi welcome screen">
-      <br>
-      <sub><b>Welcome screen</b><br><code>npm:pi-startup-header</code> with <code>npm:pi-zentui</code></sub>
-    </td>
-  </tr>
-  <tr>
-    <td width="50%" align="center">
-      <img src="./assets/readme/fixed-editor-navigation.webp" width="100%" alt="Tool results, back-to-bottom control, and Ctrl+End in the fixed editor">
-      <br>
-      <sub><b>Fixed-editor workflow</b><br>Tool summaries, expand/collapse, and keyboard navigation</sub>
-    </td>
-    <td width="50%" align="center">
-      <img src="./assets/readme/session-reference.webp" width="100%" alt="Selecting a previous Session through at-sign completion">
-      <br>
-      <sub><b>Session references</b><br>Find and inject previous context through completion</sub>
-    </td>
-  </tr>
-  <tr>
-    <td width="50%" align="center">
-      <img src="./assets/readme/context-usage.webp" width="100%" alt="Context window usage breakdown">
-      <br>
-      <sub><b>Context usage</b><br>Inspect usage by category</sub>
-    </td>
-    <td width="50%" align="center">
-      <img src="./assets/readme/context-preview.webp" width="100%" alt="Previewing injected context">
-      <br>
-      <sub><b>Context preview</b><br>Inspect the content injected into the model</sub>
-    </td>
-  </tr>
-</table>
-
-## Quick start
-
-```bash
-pi install npm:pi-cc-extensions
-```
-
-Run `/reload` after installation, then try:
-
-```text
-/ccstyle       # Configure output and fixed-editor interaction
-/context       # Inspect context usage
-@              # Complete Agents, Sessions, and files
-```
-
-The `ask_user_question` tool is registered automatically.
-
-## Features
-
-
-| Feature                   | Description                                                                                      | Entry point         |
-| --------------------------- | -------------------------------------------------------------------------------------------------- | --------------------- |
-| Claude Code-style output  | Tool summaries, expand/collapse, rich edit/write diffs, and`on` / `off` / `compact` modes        | `/ccstyle`          |
-| Fixed-editor interaction  | Five-row wheel scrolling, tool clicks, collapse anchoring, back-to-bottom control, and`Ctrl+End` | `/ccstyle`          |
-| Structured questionnaires | Single choice, multiple choice, custom answers, Markdown previews, and RPC / ACP fallback        | `ask_user_question` |
-| 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                     | Includes the GitHub Dark Default theme                                                           | `/theme`            |
-
-### Output modes
-
-
-| Mode      | Behavior                                                              |
-| ----------- | ----------------------------------------------------------------------- |
-| `on`      | Claude Code-style tool output with rich diffs for`edit` and `write`   |
-| `off`     | Native Pi renderers                                                   |
-| `compact` | One-line previews, merged repeated calls, duration, and run summaries |
-
-```text
-/ccstyle on
-/ccstyle off
-/ccstyle compact
-/ccstyle status
-```
-
-Configuration is stored in `~/.pi/agent/claude-code-style.json`:
-
-```json
-{
-  "mode": "on",
-  "excludeRenderers": [],
-  "fixedEditorFeatures": true
-}
-```
-
-- `excludeRenderers` uses exact tool names. `Agent` always keeps its dedicated renderer.
-- `fixedEditorFeatures: true` enables fixed-editor mouse scrolling, clicks, viewport mapping, and the back-to-bottom indicator.
-- Set it to `false` to disable terminal mouse reporting and restore native terminal wheel scrolling. `Ctrl+End` remains available.
-- Run `/reload` after editing the file manually.
-
-### Structured questionnaires
-
-Supports 1–4 questions, 2–4 options per question, single and multiple selection, custom answers, and optional Markdown previews. The TUI preserves transcript space; RPC / ACP environments fall back to native dialogs.
-
-Questionnaire configuration is stored at `~/.config/rpiv-ask-user-question/config.json`. See [`extensions/ask-user-question/README.md`](./extensions/ask-user-question/README.md) for shortcuts and detailed behavior.
-
-### `@` references
-
-- Enter `@session:` to reference a previous Session.
-- Enter `@agent-name` to delegate to a custom Agent.
-- Compatible with `@bacnh85/pi-fff` and `@tintinweb/pi-subagents`.
-- Session context is deduplicated and size-limited before injection.
-
-## Other installation methods
-
-```bash
-# GitHub
-pi install git:github.com/minuque/pi-cc-extensions
-
-# Local repository
-pi install /absolute/path/to/pi-cc-extensions
-```
-
-## Local development
-
-```bash
-npm test
-npm run typecheck
-pi -e .
-```
-
-Run `/reload` after changing extensions. Changes under `extensions/ask-user-question/`, or reinstalling its dependencies, require a full Pi restart.
-
-## Compatibility
-
-- Node.js `>=22.19.0`
-- Loaded through `pi.extensions` and `pi.themes` in the root `package.json`
-- If a Pi, TUI, or `pi-zentui` update causes display issues, try `/reload` first
-
-## Recommended companions
-
-
-| Extension                     | Purpose                                                      |
-| ------------------------------- | -------------------------------------------------------------- |
-| `npm:pi-zentui`               | Fixed editor, status line, and Git status                    |
-| `npm:@tintinweb/pi-subagents` | Parallel SubAgents, background tasks, and worktree isolation |
-| `npm:pi-mcp-adapter`          | On-demand MCP tool discovery with lower context usage        |
-| `npm:pi-theme-picker`         | Theme search and live preview                                |
-| `npm:@ayulab/pi-rewind`       | Checkpoint-based code or conversation rollback               |
-| `npm:pi-compact-thinking`     | Compact rendering for hidden thinking blocks                 |
-
-## Credits
-
-- Compact transcript behavior is based on [`avhagedorn/pi-compact-transcript`](https://github.com/avhagedorn/pi-compact-transcript) v0.6.2 (MIT).
-- Structured questionnaires are based on [`@juicesharp/rpiv-ask-user-question`](https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-ask-user-question) v2.1.0 (MIT).
-- 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).
-- Startup header based on [`EnderLiquid/pi-startup-header`](https://github.com/EnderLiquid/pi-startup-header) (MIT).
-- Command aliases based on [`xRyul/pi-aliases`](https://github.com/xRyul/pi-aliases) (MIT).
+<p align="center">
+  <img src="./assets/readme/hero.svg" width="100%" alt="pi-cc-extensions: a productivity extension suite for Pi">
+</p>
+
+<p align="center">
+  <a href="https://pi.dev/packages?name=pi-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/pi-cc-extensions"><img alt="npm version" src="https://img.shields.io/npm/v/pi-cc-extensions?style=flat-square&color=66E3C4"></a>
+  <a href="#compatibility"><img alt="Node.js 22.19 or newer" src="https://img.shields.io/badge/Node.js-%E2%89%A522.19-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 output, structured questionnaires, context inspection, and Agent / Session references.
+</p>
+
+<p align="center">
+  <a href="./README.md">简体中文</a> · <strong>English</strong>
+</p>
+
+---
+
+## Preview
+
+<table>
+  <tr>
+    <td colspan="2" align="center">
+      <img src="./assets/readme/welcome.webp" width="100%" alt="Pi welcome screen">
+      <br>
+      <sub><b>Welcome screen</b><br><code>npm:pi-startup-header</code> with <code>npm:pi-zentui</code></sub>
+    </td>
+  </tr>
+  <tr>
+    <td width="50%" align="center">
+      <img src="./assets/readme/fixed-editor-navigation.webp" width="100%" alt="Tool results, back-to-bottom control, and Ctrl+End in the fixed editor">
+      <br>
+      <sub><b>Fixed-editor workflow</b><br>Tool summaries, expand/collapse, and keyboard navigation</sub>
+    </td>
+    <td width="50%" align="center">
+      <img src="./assets/readme/session-reference.webp" width="100%" alt="Selecting a previous Session through at-sign completion">
+      <br>
+      <sub><b>Session references</b><br>Find and inject previous context through completion</sub>
+    </td>
+  </tr>
+  <tr>
+    <td width="50%" align="center">
+      <img src="./assets/readme/context-usage.webp" width="100%" alt="Context window usage breakdown">
+      <br>
+      <sub><b>Context usage</b><br>Inspect usage by category</sub>
+    </td>
+    <td width="50%" align="center">
+      <img src="./assets/readme/context-preview.webp" width="100%" alt="Previewing injected context">
+      <br>
+      <sub><b>Context preview</b><br>Inspect the content injected into the model</sub>
+    </td>
+  </tr>
+</table>
+
+## Quick start
+
+```bash
+pi install npm:pi-cc-extensions
+```
+
+Run `/reload` after installation, then try:
+
+```text
+/ccstyle       # Configure output and fixed-editor interaction
+/context       # Inspect context usage
+@              # Complete Agents, Sessions, and files
+```
+
+The `ask_user_question` tool is registered automatically.
+
+## Features
+
+
+| Feature                   | Description                                                                                      | Entry point         |
+| --------------------------- | -------------------------------------------------------------------------------------------------- | --------------------- |
+| Claude Code-style output  | Tool summaries, expand/collapse, rich edit/write diffs, and`on` / `off` / `compact` modes        | `/ccstyle`          |
+| Fixed-editor interaction  | Five-row wheel scrolling, tool clicks, collapse anchoring, back-to-bottom control, and`Ctrl+End` | `/ccstyle`          |
+| Structured questionnaires | Single choice, multiple choice, custom answers, Markdown previews, and RPC / ACP fallback        | `ask_user_question` |
+| 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                     | Includes the GitHub Dark Default theme                                                           | `/theme`            |
+
+### Output modes
+
+
+| Mode      | Behavior                                                              |
+| ----------- | ----------------------------------------------------------------------- |
+| `on`      | Claude Code-style tool output with rich diffs for`edit` and `write`   |
+| `off`     | Native Pi renderers                                                   |
+| `compact` | One-line previews, merged repeated calls, duration, and run summaries |
+
+```text
+/ccstyle on
+/ccstyle off
+/ccstyle compact
+/ccstyle status
+```
+
+Configuration is stored in `~/.pi/agent/claude-code-style.json`:
+
+```json
+{
+  "mode": "on",
+  "excludeRenderers": [],
+  "fixedEditorFeatures": true
+}
+```
+
+- `excludeRenderers` uses exact tool names. `Agent` always keeps its dedicated renderer.
+- `fixedEditorFeatures: true` enables fixed-editor mouse scrolling, clicks, viewport mapping, and the back-to-bottom indicator.
+- Set it to `false` to disable terminal mouse reporting and restore native terminal wheel scrolling. `Ctrl+End` remains available.
+- Run `/reload` after editing the file manually.
+
+### Structured questionnaires
+
+Supports 1–4 questions, 2–4 options per question, single and multiple selection, custom answers, and optional Markdown previews. The TUI preserves transcript space; RPC / ACP environments fall back to native dialogs.
+
+Questionnaire configuration is stored at `~/.config/rpiv-ask-user-question/config.json`. See [`extensions/ask-user-question/README.md`](./extensions/ask-user-question/README.md) for shortcuts and detailed behavior.
+
+### `@` references
+
+- Enter `@session:` to reference a previous Session.
+- Enter `@agent-name` to delegate to a custom Agent.
+- Compatible with `@bacnh85/pi-fff` and `@tintinweb/pi-subagents`.
+- Session context is deduplicated and size-limited before injection.
+
+## Other installation methods
+
+```bash
+# GitHub
+pi install git:github.com/minuque/pi-cc-extensions
+
+# Local repository
+pi install /absolute/path/to/pi-cc-extensions
+```
+
+## Local development
+
+```bash
+npm test
+npm run typecheck
+pi -e .
+```
+
+Run `/reload` after changing extensions. Changes under `extensions/ask-user-question/`, or reinstalling its dependencies, require a full Pi restart.
+
+## Compatibility
+
+- Node.js `>=22.19.0`
+- Loaded through `pi.extensions` and `pi.themes` in the root `package.json`
+- If a Pi, TUI, or `pi-zentui` update causes display issues, try `/reload` first
+
+## Recommended companions
+
+
+| Extension                     | Purpose                                                      |
+| ------------------------------- | -------------------------------------------------------------- |
+| `npm:pi-zentui`               | Fixed editor, status line, and Git status                    |
+| `npm:@tintinweb/pi-subagents` | Parallel SubAgents, background tasks, and worktree isolation |
+| `npm:pi-mcp-adapter`          | On-demand MCP tool discovery with lower context usage        |
+| `npm:pi-theme-picker`         | Theme search and live preview                                |
+| `npm:@ayulab/pi-rewind`       | Checkpoint-based code or conversation rollback               |
+| `npm:pi-compact-thinking`     | Compact rendering for hidden thinking blocks                 |
+
+## Credits
+
+- Compact transcript behavior is based on [`avhagedorn/pi-compact-transcript`](https://github.com/avhagedorn/pi-compact-transcript) v0.6.2 (MIT).
+- Structured questionnaires are based on [`@juicesharp/rpiv-ask-user-question`](https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-ask-user-question) v2.1.0 (MIT).
+- 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).
+- Startup header based on [`EnderLiquid/pi-startup-header`](https://github.com/EnderLiquid/pi-startup-header) (MIT).
+- Command aliases based on [`xRyul/pi-aliases`](https://github.com/xRyul/pi-aliases) (MIT).

package/README.md

@@ -1,115 +1,115 @@
-<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=pi-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/pi-cc-extensions"><img alt="npm version" src="https://img.shields.io/npm/v/pi-cc-extensions?style=flat-square&color=66E3C4"></a>
-  <a href="#兼容性"><img alt="Node.js 22.19 or newer" src="https://img.shields.io/badge/Node.js-%E2%89%A522.19-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 风格界面、结构化问卷、上下文检查，以及 Agent / Session 引用。
-</p>
-
-<p align="center">
-  <strong>简体中文</strong> · <a href="./README.en.md">English</a>
-</p>
-
----
-
-## 界面预览
-
-<table>
-  <tr>
-    <td colspan="2" align="center">
-      <img src="./assets/readme/welcome.webp" width="100%" alt="Pi 启动后的欢迎界面">
-      <br>
-      <sub><b>欢迎界面</b><br> @ <code>npm:pi-startup-header</code> 与 <code>npm:pi-zentui</code></sub>
-    </td>
-  </tr>
-  <tr>
-    <td width="50%" align="center">
-      <img src="./assets/readme/fixed-editor-navigation.webp" width="100%" alt="Pi fixed-editor 中的工具结果、回到底部按钮与 Ctrl+End 快捷键">
-      <br>
-      <sub><b>固定编辑器工作流</b><br>工具结果摘要、折叠展开与键盘导航</sub>
-    </td>
-    <td width="50%" align="center">
-      <img src="./assets/readme/session-reference.webp" width="100%" alt="在 Pi 中通过 @ 补全选择历史 Session">
-      <br>
-      <sub><b>历史 Session 引用</b><br>通过 @ 补全快速找到并引用历史会话</sub>
-    </td>
-  </tr>
-  <tr>
-    <td width="50%" align="center">
-      <img src="./assets/readme/context-usage.webp" width="100%" alt="Pi 上下文窗口用量查看器">
-      <br>
-      <sub><b>上下文用量</b><br>查看 System prompt、Tools、Skills 等占用分布</sub>
-    </td>
-    <td width="50%" align="center">
-      <img src="./assets/readme/context-preview.webp" width="100%" alt="Pi 中展开查看 System Prompt 内容">
-      <br>
-      <sub><b>上下文预览</b><br>按类别展开查看实际注入的上下文内容</sub>
-    </td>
-  </tr>
-</table>
-
-## 快速开始
-
-```bash
-pi install npm:pi-cc-extensions
-
-# GitHub
-pi install git:github.com/minuque/pi-cc-extensions
-```
-
-安装后执行 `/reload`
-
-## 功能
-
-
-| 功能                         | 说明                                                                            | 入口                |
-| ------------------------------ | --------------------------------------------------------------------------------- | --------------------- |
-| Claude Code 风格输出         | 工具摘要、折叠展开、rich edit/write diff，以及`on` / `off` / `compact` 三种模式 | `/ccstyle`          |
-| Fixed editor 交互            | 每刻度 5 行滚动、工具点击、收起位置补偿、回到底部按钮与`Ctrl+End`               | `/ccstyle`          |
-| Ask User Question 结构化问卷 | 单选、多选、自定义回答、Markdown 预览及 RPC / ACP 降级                          | `ask_user_question` |
-| 上下文检查                   | 查看上下文占用，并预览 System prompt、Tools、Skills 和消息内容                  | `/context`          |
-| Session 引用                 | 搜索并注入历史 Session 或现有 SubAgent 的有效上下文                             | `@session:`         |
-| 主题                         | 随包提供内置 GitHub Dark Default 主题                                           | `/theme`            |
-
-## 本地开发
-
-```bash
-npm test
-npm run typecheck
-pi -e .
-```
-
-修改扩展后执行 `/reload`。修改 `extensions/ask-user-question/` 或重装其依赖后，需要完整重启 Pi。
-
-## 兼容性
-
-- Node.js `>=22.19.0`
-- 通过根目录 `package.json` 的 `pi.extensions` 和 `pi.themes` 加载
-- `pi-zentui`、Pi 或 TUI 内部实现升级后若显示异常，先执行 `/reload`
-
-## 推荐搭配
-
-
-| 扩展                          | 用途                                |
-| ------------------------------- | ------------------------------------- |
-| `npm:pi-zentui`               | Fixed editor、状态栏和 Git 状态     |
-| `npm:@tintinweb/pi-subagents` | 并行 SubAgent、后台任务与工作树隔离 |
-| `npm:pi-mcp-adapter`          | 按需发现 MCP 工具，减少上下文占用   |
-| `npm:pi-theme-picker`         | 主题搜索和实时预览                  |
-| `npm:@ayulab/pi-rewind`       | 基于 checkpoint 回退代码或对话      |
-| `npm:pi-compact-thinking`     | 紧凑显示隐藏的 thinking 块          |
-
-## 致谢
-
-- Compact transcript 基于 [`avhagedorn/pi-compact-transcript`](https://github.com/avhagedorn/pi-compact-transcript) v0.6.2（MIT）。
-- 结构化问卷基于 [`@juicesharp/rpiv-ask-user-question`](https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-ask-user-question) v2.1.0（MIT）。
-- Rich diff 改编自 [`MasuRii/pi-tool-display`](https://github.com/MasuRii/pi-tool-display)（MIT）；详见 [`extensions/tool-diff/ATTRIBUTION.md`](./extensions/tool-diff/ATTRIBUTION.md)。
-- 启动头基于 [`EnderLiquid/pi-startup-header`](https://github.com/EnderLiquid/pi-startup-header)（MIT）。
-- 命令别名基于 [`xRyul/pi-aliases`](https://github.com/xRyul/pi-aliases)（MIT）。
+<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=pi-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/pi-cc-extensions"><img alt="npm version" src="https://img.shields.io/npm/v/pi-cc-extensions?style=flat-square&color=66E3C4"></a>
+  <a href="#兼容性"><img alt="Node.js 22.19 or newer" src="https://img.shields.io/badge/Node.js-%E2%89%A522.19-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 风格界面、结构化问卷、上下文检查，以及 Agent / Session 引用。
+</p>
+
+<p align="center">
+  <strong>简体中文</strong> · <a href="./README.en.md">English</a>
+</p>
+
+---
+
+## 界面预览
+
+<table>
+  <tr>
+    <td colspan="2" align="center">
+      <img src="./assets/readme/welcome.webp" width="100%" alt="Pi 启动后的欢迎界面">
+      <br>
+      <sub><b>欢迎界面</b><br> @ <code>npm:pi-startup-header</code> 与 <code>npm:pi-zentui</code></sub>
+    </td>
+  </tr>
+  <tr>
+    <td width="50%" align="center">
+      <img src="./assets/readme/fixed-editor-navigation.webp" width="100%" alt="Pi fixed-editor 中的工具结果、回到底部按钮与 Ctrl+End 快捷键">
+      <br>
+      <sub><b>固定编辑器工作流</b><br>工具结果摘要、折叠展开与键盘导航</sub>
+    </td>
+    <td width="50%" align="center">
+      <img src="./assets/readme/session-reference.webp" width="100%" alt="在 Pi 中通过 @ 补全选择历史 Session">
+      <br>
+      <sub><b>历史 Session 引用</b><br>通过 @ 补全快速找到并引用历史会话</sub>
+    </td>
+  </tr>
+  <tr>
+    <td width="50%" align="center">
+      <img src="./assets/readme/context-usage.webp" width="100%" alt="Pi 上下文窗口用量查看器">
+      <br>
+      <sub><b>上下文用量</b><br>查看 System prompt、Tools、Skills 等占用分布</sub>
+    </td>
+    <td width="50%" align="center">
+      <img src="./assets/readme/context-preview.webp" width="100%" alt="Pi 中展开查看 System Prompt 内容">
+      <br>
+      <sub><b>上下文预览</b><br>按类别展开查看实际注入的上下文内容</sub>
+    </td>
+  </tr>
+</table>
+
+## 快速开始
+
+```bash
+pi install npm:pi-cc-extensions
+
+# GitHub
+pi install git:github.com/minuque/pi-cc-extensions
+```
+
+安装后执行 `/reload`
+
+## 功能
+
+
+| 功能                         | 说明                                                                            | 入口                |
+| ------------------------------ | --------------------------------------------------------------------------------- | --------------------- |
+| Claude Code 风格输出         | 工具摘要、折叠展开、rich edit/write diff，以及`on` / `off` / `compact` 三种模式 | `/ccstyle`          |
+| Fixed editor 交互            | 每刻度 5 行滚动、工具点击、收起位置补偿、回到底部按钮与`Ctrl+End`               | `/ccstyle`          |
+| Ask User Question 结构化问卷 | 单选、多选、自定义回答、Markdown 预览及 RPC / ACP 降级                          | `ask_user_question` |
+| 上下文检查                   | 查看上下文占用，并预览 System prompt、Tools、Skills 和消息内容                  | `/context`          |
+| Session 引用                 | 搜索并注入历史 Session 或现有 SubAgent 的有效上下文                             | `@session:`         |
+| 主题                         | 随包提供内置 GitHub Dark Default 主题                                           | `/theme`            |
+
+## 本地开发
+
+```bash
+npm test
+npm run typecheck
+pi -e .
+```
+
+修改扩展后执行 `/reload`。修改 `extensions/ask-user-question/` 或重装其依赖后，需要完整重启 Pi。
+
+## 兼容性
+
+- Node.js `>=22.19.0`
+- 通过根目录 `package.json` 的 `pi.extensions` 和 `pi.themes` 加载
+- `pi-zentui`、Pi 或 TUI 内部实现升级后若显示异常，先执行 `/reload`
+
+## 推荐搭配
+
+
+| 扩展                          | 用途                                |
+| ------------------------------- | ------------------------------------- |
+| `npm:pi-zentui`               | Fixed editor、状态栏和 Git 状态     |
+| `npm:@tintinweb/pi-subagents` | 并行 SubAgent、后台任务与工作树隔离 |
+| `npm:pi-mcp-adapter`          | 按需发现 MCP 工具，减少上下文占用   |
+| `npm:pi-theme-picker`         | 主题搜索和实时预览                  |
+| `npm:@ayulab/pi-rewind`       | 基于 checkpoint 回退代码或对话      |
+| `npm:pi-compact-thinking`     | 紧凑显示隐藏的 thinking 块          |
+
+## 致谢
+
+- Compact transcript 基于 [`avhagedorn/pi-compact-transcript`](https://github.com/avhagedorn/pi-compact-transcript) v0.6.2（MIT）。
+- 结构化问卷基于 [`@juicesharp/rpiv-ask-user-question`](https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-ask-user-question) v2.1.0（MIT）。
+- Rich diff 改编自 [`MasuRii/pi-tool-display`](https://github.com/MasuRii/pi-tool-display)（MIT）；详见 [`extensions/tool-diff/ATTRIBUTION.md`](./extensions/tool-diff/ATTRIBUTION.md)。
+- 启动头基于 [`EnderLiquid/pi-startup-header`](https://github.com/EnderLiquid/pi-startup-header)（MIT）。
+- 命令别名基于 [`xRyul/pi-aliases`](https://github.com/xRyul/pi-aliases)（MIT）。

package/extensions/ask-user-question/state/questionnaire-session.ts

@@ -1,4 +1,5 @@
 import type { Theme } from "@earendil-works/pi-coding-agent";
+import { bottomDialogBounds, isDialogCloseClick } from "../../closable-dialog.ts";
 import { getKeybindings, type Input } from "@earendil-works/pi-tui";
 import type { QuestionData, QuestionnaireResult, QuestionParams } from "../tool/types.js";
 import type { WrappingSelectItem } from "../view/components/wrapping-select.js";
@@ -93,10 +94,26 @@ export class QuestionnaireSession {
 		// so the transcript regains space while Ctrl+] can still expand the questionnaire.
 		const collapsedRender = (_width: number): string[] => [theme.fg("dim", ` ${COLLAPSED_HINT} `)];
 
+		let lastWidth = 0;
+		let lastHeight = 0;
 		this.component = {
-			render: (width) => (this.state.collapsed ? collapsedRender(width) : built.render(width)),
+			render: (width) => {
+				const lines = this.state.collapsed ? collapsedRender(width) : built.render(width);
+				lastWidth = width;
+				lastHeight = lines.length;
+				return lines;
+			},
 			invalidate: built.invalidate,
-			handleInput: (data) => this.dispatch(data),
+			handleInput: (data) => {
+				if (
+					!this.state.collapsed &&
+					isDialogCloseClick(data, bottomDialogBounds(this.tui.terminal, lastWidth, lastHeight))
+				) {
+					this.dispatch("\x1b");
+					return;
+				}
+				this.dispatch(data);
+			},
 		};
 
 		this.viewAdapter.apply(this.state);

package/extensions/ask-user-question/view/dialog-builder.ts

@@ -1,4 +1,5 @@
 import { DynamicBorder, type Theme } from "@earendil-works/pi-coding-agent";
+import { renderDialogHeader, renderDialogTopBorder } from "../../closable-dialog.ts";
 import { type Component, Container, type Input, Spacer } from "@earendil-works/pi-tui";
 import type { QuestionnaireState } from "../state/state.js";
 import type { QuestionData } from "../tool/types.js";
@@ -133,10 +134,24 @@ export class DialogView implements StatefulView<DialogProps> {
 		// Render only the active tab's natural content; blank height equalization would
 		// unnecessarily consume transcript rows above this full-width editor component.
 		const natural = this.buildContainerFromStrategy(strategy, headingRowCache).render(width);
+		if (natural.length > 0) {
+			natural[0] = renderDialogTopBorder(width, (text) => this.config.theme.fg("accent", text));
+			natural.splice(
+				1,
+				0,
+				renderDialogHeader(
+					" Questions",
+					width,
+					(text) => this.config.theme.fg("accent", text),
+					(text) => this.config.theme.fg("toolTitle", text),
+					(text) => this.config.theme.fg("muted", text),
+				),
+			);
+		}
 
 		// Fixed region sizes (deterministic from structure).
 		// TabBar.render() returns [tabLine, ""] — always 2 rows.
-		const topFixed = 1 + (this.config.isMulti && this.config.tabBar ? 2 : 0) + 1;
+		const topFixed = 2 + (this.config.isMulti && this.config.tabBar ? 2 : 0) + 1;
 		const bottomFixed = 1 + strategy.footerRowCount;
 		const middleRows = natural.length - topFixed - bottomFixed;
 

package/extensions/claude-code-style.ts

@@ -29,6 +29,12 @@ import {
 	wrapTextWithAnsi,
 } from "@earendil-works/pi-tui";
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import {
+	bottomDialogBounds,
+	isDialogCloseClick,
+	renderDialogHeader,
+	renderDialogTopBorder,
+} from "./closable-dialog.ts";
 import { homedir } from "node:os";
 import { join } from "node:path";
 
@@ -1974,6 +1980,8 @@ async function showCcstylePanel(ctx: any, compactStyle: CompactStyleHooks): Prom
 		];
 
 		let activeSection = 0;
+		let lastWidth = 0;
+		let lastHeight = 0;
 		const settingsTheme = getSettingsListTheme();
 		const lists = sections.map(
 			(section) =>
@@ -2010,8 +2018,15 @@ async function showCcstylePanel(ctx: any, compactStyle: CompactStyleHooks): Prom
 				while (listBody.length > 0 && listBody[listBody.length - 1] === "") listBody.pop();
 
 				// Frame: top rule · tabs · mid rule · settings · mid rule · footer · bottom rule
-				return [
-					rule,
+				const lines = [
+					renderDialogTopBorder(safeWidth, (text) => theme.fg("border", text)),
+					renderDialogHeader(
+						" CC Style",
+						safeWidth,
+						(text) => theme.fg("border", text),
+						(text) => theme.fg("toolTitle", text),
+						(text) => theme.fg("muted", text),
+					),
 					renderSectionTabBar(theme, sections, activeSection, safeWidth),
 					rule,
 					...listBody,
@@ -2025,11 +2040,22 @@ async function showCcstylePanel(ctx: any, compactStyle: CompactStyleHooks): Prom
 					),
 					rule,
 				];
+				lastWidth = safeWidth;
+				lastHeight = lines.length;
+				return lines;
 			},
 			invalidate() {
 				for (const list of lists) list.invalidate();
 			},
 			handleInput(data: string) {
+				if (
+					!excludeSubmenuOpen &&
+					tui.terminal &&
+					isDialogCloseClick(data, bottomDialogBounds(tui.terminal, lastWidth, lastHeight))
+				) {
+					done();
+					return;
+				}
 				if (!excludeSubmenuOpen && isForwardTabKey(data)) {
 					switchSection(1);
 					tui.requestRender();
@@ -2056,28 +2082,39 @@ function renderDefault(tool: any, slot: "renderCall" | "renderResult", args: any
 	return new Text(fallback, 0, 0);
 }
 
-/**
- * Generate a descriptive label for an unknown tool from its args.
- * Uses the tool label + first stringable arg value.
- */
-function toolCallLabel(toolName: string, toolLabel: string, args: any): string {
-	if (!args) return toolLabel;
+function singleLine(text: string) {
+	return {
+		render: (width: number) => [truncateToWidth(text, width, "…")],
+		invalidate() {},
+	};
+}
+
+/** Return the most useful scalar argument without semantically truncating it. */
+function toolCallArgument(args: any): { key: string; value: string } | undefined {
+	if (!args) return undefined;
 	const keys = Object.keys(args);
-	if (keys.length === 0) return toolLabel;
-	// Prefer "query" or "question" args, then fall back to the first stringable value
+	if (keys.length === 0) return undefined;
 	const preferred = ["query", "question", "command", "pattern", "name", "path", "url", "message"];
-	for (const key of preferred) {
-		const val = args[key];
-		if (val !== undefined && val !== null && typeof val !== "object") {
-			return `${toolLabel}(${oneLine(val, 60)})`;
-		}
-	}
-	const firstKey = keys[0];
-	const firstVal = args[firstKey];
-	if (firstVal !== undefined && firstVal !== null && typeof firstVal !== "object") {
-		return `${toolLabel}(${oneLine(firstVal, 60)})`;
+	const key = preferred.find((candidate) => {
+		const val = args[candidate];
+		return val !== undefined && val !== null && typeof val !== "object";
+	});
+	const selected = key ?? keys[0];
+	const value = args[selected];
+	return value !== undefined && value !== null && typeof value !== "object"
+		? { key: selected, value: oneLine(value, Infinity) }
+		: undefined;
+}
+
+function tailToWidth(text: string, width: number): string {
+	if (visibleWidth(text) <= width) return text;
+	if (width <= 1) return "…";
+	let tail = "";
+	for (const char of Array.from(text).reverse()) {
+		if (visibleWidth(`…${char}${tail}`) > width) break;
+		tail = char + tail;
 	}
-	return toolLabel;
+	return `…${tail}`;
 }
 
 export function shouldRenderRichDiff(
@@ -2117,8 +2154,21 @@ function createCcstyleTool(
 					? `${BRIGHT_GREEN}${rawIcon}${ANSI_RESET}`
 					: theme.fg(toolIconColor(context), rawIcon);
 
-			const title = `${icon} ${theme.fg("toolTitle", toolCallLabel(toolName, label, args))}`;
-			return new Text(title, 0, 0);
+			const argument = toolCallArgument(args);
+			return {
+				render(width: number) {
+					const argumentWidth = Math.max(1, width - visibleWidth(`${rawIcon} ${label}()`));
+					const shown = argument
+						? argument.key === "path"
+							? tailToWidth(argument.value, argumentWidth)
+							: truncateToWidth(argument.value, argumentWidth, "…")
+						: undefined;
+					const call = shown === undefined ? label : `${label}(${shown})`;
+					const callWidth = Math.max(0, width - visibleWidth(icon) - 1);
+					return [`${icon} ${theme.fg("toolTitle", truncateToWidth(call, callWidth, "…"))}`];
+				},
+				invalidate() {},
+			};
 		},
 		renderResult(result: any, options: any, theme: any, context: any) {
 			if (config.mode !== "on") {
@@ -2168,10 +2218,8 @@ function createCcstyleTool(
 				);
 			}
 			if (context?.state) context.state.ccstyleIoView = undefined;
-			return new Text(
+			return singleLine(
 				theme.fg(isError ? "error" : "muted", renderCollapsedToolResult(rendered, hint)),
-				0,
-				0,
 			);
 		},
 	};

package/extensions/closable-dialog.ts

@@ -0,0 +1,57 @@
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+
+export type DialogBounds = { left: number; top: number; width: number };
+
+export function renderDialogTopBorder(width: number, color: (text: string) => string): string {
+	const safeWidth = Math.max(4, Math.floor(width));
+	return color(`╭${"─".repeat(safeWidth - 2)}╮`);
+}
+
+/** Render title and a larger [ × ] target on the row below the top border. */
+export function renderDialogHeader(
+	title: string,
+	width: number,
+	color: (text: string) => string,
+	titleColor: (text: string) => string,
+	closeColor: (text: string) => string,
+): string {
+	const safeWidth = Math.max(8, Math.floor(width));
+	const innerWidth = safeWidth - 2;
+	const button = "[ × ]";
+	const titleWidth = Math.max(0, innerWidth - visibleWidth(button) - 2);
+	const shownTitle = truncateToWidth(title, titleWidth, "…");
+	const gap = " ".repeat(Math.max(1, innerWidth - visibleWidth(shownTitle) - visibleWidth(button)));
+	return `${color("│")}${titleColor(shownTitle)}${gap}${closeColor(button)}${color("│")}`;
+}
+
+/** Match a left-button press anywhere on the [ × ] target. */
+export function isDialogCloseClick(data: string, bounds: DialogBounds): boolean {
+	const match = data.match(/^\x1b\[<(\d+);(\d+);(\d+)([Mm])$/);
+	if (!match || match[4] !== "M") return false;
+	const code = Number(match[1]);
+	if ((code & 3) !== 0 || (code & 32) !== 0) return false;
+	const col = Number(match[2]);
+	const firstButtonCol = bounds.left + bounds.width - 7;
+	const lastButtonCol = bounds.left + bounds.width - 3;
+	return col >= firstButtonCol && col <= lastButtonCol && Number(match[3]) === bounds.top + 1;
+}
+
+export function centeredDialogBounds(
+	terminal: { columns: number; rows: number },
+	width: number,
+	height: number,
+): DialogBounds {
+	return {
+		left: Math.floor((terminal.columns - width) / 2) + 1,
+		top: Math.floor((terminal.rows - height) / 2) + 1,
+		width,
+	};
+}
+
+export function bottomDialogBounds(
+	terminal: { rows: number },
+	width: number,
+	height: number,
+): DialogBounds {
+	return { left: 1, top: Math.max(1, terminal.rows - height + 1), width };
+}

package/extensions/context.ts

@@ -10,6 +10,12 @@ import {
 	visibleWidth,
 	wrapTextWithAnsi,
 } from "@earendil-works/pi-tui";
+import {
+	centeredDialogBounds,
+	isDialogCloseClick,
+	renderDialogHeader,
+	renderDialogTopBorder,
+} from "./closable-dialog.ts";
 
 export type ContextPart = {
 	label: string;
@@ -65,6 +71,8 @@ export async function showTextPreview(
 			let scrollOffset = 0;
 			let pageSize = 1;
 			let totalLines = 1;
+			let lastWidth = 0;
+			let lastHeight = 0;
 			const wrappedContent = createWrappedTextCache(content);
 
 			const scrollTo = (nextOffset: number): void => {
@@ -77,6 +85,10 @@ export async function showTextPreview(
 					wrappedContent.invalidate();
 				},
 				handleInput(data: string) {
+					if (isDialogCloseClick(data, centeredDialogBounds(tui.terminal, lastWidth, lastHeight))) {
+						done(undefined);
+						return;
+					}
 					if (matchesKey(data, Key.escape) || matchesKey(data, Key.ctrl("c"))) {
 						done(undefined);
 						return;
@@ -138,15 +150,24 @@ export async function showTextPreview(
 					const end = Math.min(totalLines, scrollOffset + pageSize);
 					const status = `${start}-${end} / ${totalLines} lines · ↑↓ PgUp/PgDn Home/End · Esc close`;
 
-					return [
-						border(`╭${"─".repeat(inner)}╮`),
-						`${border("│")}${padLine(` ${theme.bold(theme.fg("accent", title))}`)}${border("│")}`,
+					const lines = [
+						renderDialogTopBorder(width, border),
+						renderDialogHeader(
+							` ${title}`,
+							width,
+							border,
+							(text) => theme.bold(theme.fg("accent", text)),
+							(text) => theme.fg("muted", text),
+						),
 						`${border("├")}${border("─".repeat(inner))}${border("┤")}`,
 						...bodyRows,
 						`${border("├")}${border("─".repeat(inner))}${border("┤")}`,
 						`${border("│")}${padLine(theme.fg("dim", ` ${status}`))}${border("│")}`,
 						border(`╰${"─".repeat(inner)}╯`),
 					];
+					lastWidth = width;
+					lastHeight = lines.length;
+					return lines;
 				},
 			};
 		},

package/package.json

@@ -1,69 +1,69 @@
-{
-	"name": "pi-cc-extensions",
-	"version": "0.8.16",
-	"description": "A Pi productivity suite with Claude Code-style UI, structured questionnaires, context inspection, and agent/session references",
-	"type": "module",
-	"keywords": [
-		"pi-package",
-		"pi-extension",
-		"pi-coding-agent",
-		"claude-code",
-		"questionnaire"
-	],
-	"homepage": "https://github.com/minuque/pi-cc-extensions#readme",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/minuque/pi-cc-extensions.git"
-	},
-	"bugs": {
-		"url": "https://github.com/minuque/pi-cc-extensions/issues"
-	},
-	"files": [
-		"extensions",
-		"assets/readme",
-		"themes",
-		"README.md",
-		"README.en.md"
-	],
-	"pi": {
-		"extensions": [
-			"./extensions/pi-aliases.ts",
-			"./extensions/pi-startup-header.ts",
-			"./extensions/claude-code-style.ts",
-			"./extensions/context.ts",
-			"./extensions/session-reference.ts",
-			"./extensions/agent-autocomplete.ts",
-			"./extensions/ask-user-question/index.ts"
-		],
-		"themes": [
-			"./themes/github-dark-default.json"
-		],
-		"image": "https://raw.githubusercontent.com/minuque/pi-cc-extensions/main/assets/readme/welcome.webp"
-	},
-	"scripts": {
-		"test": "node --test tests/**/*.test.ts",
-		"typecheck": "node scripts/typecheck.mjs",
-		"format": "biome format --write .",
-		"format:check": "biome format .",
-		"preversion": "npm run format:check && npm run typecheck && npm test",
-		"release": "npm version patch && npm publish",
-		"release:minor": "npm version minor && npm publish",
-		"release:major": "npm version major && npm publish"
-	},
-	"dependencies": {
-		"@juicesharp/rpiv-config": "^2.1.0",
-		"typebox": "^1.1.24"
-	},
-	"peerDependencies": {
-		"@earendil-works/pi-ai": "*",
-		"@earendil-works/pi-coding-agent": "*",
-		"@earendil-works/pi-tui": "*"
-	},
-	"engines": {
-		"node": ">=22.19.0"
-	},
-	"devDependencies": {
-		"@biomejs/biome": "2.5.5",
-		"@types/node": "^26.1.1"
-	}
-}
+{
+	"name": "pi-cc-extensions",
+	"version": "0.8.18",
+	"description": "A Pi productivity suite with Claude Code-style UI, structured questionnaires, context inspection, and agent/session references",
+	"type": "module",
+	"keywords": [
+		"pi-package",
+		"pi-extension",
+		"pi-coding-agent",
+		"claude-code",
+		"questionnaire"
+	],
+	"homepage": "https://github.com/minuque/pi-cc-extensions#readme",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/minuque/pi-cc-extensions.git"
+	},
+	"bugs": {
+		"url": "https://github.com/minuque/pi-cc-extensions/issues"
+	},
+	"files": [
+		"extensions",
+		"assets/readme",
+		"themes",
+		"README.md",
+		"README.en.md"
+	],
+	"pi": {
+		"extensions": [
+			"./extensions/pi-aliases.ts",
+			"./extensions/pi-startup-header.ts",
+			"./extensions/claude-code-style.ts",
+			"./extensions/context.ts",
+			"./extensions/session-reference.ts",
+			"./extensions/agent-autocomplete.ts",
+			"./extensions/ask-user-question/index.ts"
+		],
+		"themes": [
+			"./themes/github-dark-default.json"
+		],
+		"image": "https://raw.githubusercontent.com/minuque/pi-cc-extensions/main/assets/readme/welcome.webp"
+	},
+	"scripts": {
+		"test": "node --test tests/**/*.test.ts",
+		"typecheck": "node scripts/typecheck.mjs",
+		"format": "biome format --write .",
+		"format:check": "biome format .",
+		"preversion": "npm run format:check && npm run typecheck && npm test",
+		"release": "npm version patch && npm publish",
+		"release:minor": "npm version minor && npm publish",
+		"release:major": "npm version major && npm publish"
+	},
+	"dependencies": {
+		"@juicesharp/rpiv-config": "^2.1.0",
+		"typebox": "^1.1.24"
+	},
+	"peerDependencies": {
+		"@earendil-works/pi-ai": "*",
+		"@earendil-works/pi-coding-agent": "*",
+		"@earendil-works/pi-tui": "*"
+	},
+	"engines": {
+		"node": ">=22.19.0"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.5.5",
+		"@types/node": "^26.1.1"
+	}
+}