npm - pi-cc-extensions - Versions diffs - 0.8.11 → 0.8.12 - Mend

pi-cc-extensions 0.8.11 → 0.8.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/README.en.md ADDED Viewed

@@ -0,0 +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:`         |
+| Agent completion          | Complete and delegate custom Agents from`~/.pi/agent/agents/*.md`                                | `@agent-name`       |
+| 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                 |
+| `npm:pi-startup-header`       | Theme-aware startup header                                   |
+## 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).

package/README.md CHANGED Viewed

@@ -1,204 +1,174 @@
-<p align="center">
-  <img src="./assets/readme/hero.svg" width="100%" alt="pi-cc-extensions：集成 Claude Code 风格界面、结构化问卷、上下文检查及 Agent 与 Session 引用的 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">
-  面向 Pi 的终端效率扩展套件 · Claude Code 风格界面 · 结构化问卷 · 上下文检查 · Agent 与 Session 引用
-</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>
-## 功能
-### Claude Code 风格界面
-`extensions/claude-code-style.ts` 提供：
-- `on`：Claude Code 风格的工具调用行与结果摘要（默认覆盖普通工具 renderer）
-- `off`：使用 Pi 原生输出
-- `compact`：单行工具预览、运行状态与耗时、连续同名工具合并、失败独立行、运行总结，以及隐藏 thinking 时的标题 ticker
-- Pi 默认输入栏
-- 通过 `excludeRenderers` 保留指定工具的原生或扩展 renderer；`Agent` 始终保留专用 renderer
-- 工具结果的折叠与展开；切换模式会立即重绘已有 transcript
-- 类 Claude Code 滚动到底部 button
-常用命令：
-```text
-/ccstyle             # 打开交互式配置面板
-/ccstyle on          # Claude Code 风格
-/ccstyle off         # Pi 原生输出
-/ccstyle compact     # 紧凑 transcript 风格
-/ccstyle status      # 查看当前模式
-```
-需要保留指定工具的原生或扩展 renderer 时，编辑 `~/.pi/agent/claude-code-style.json`：
-```json
-{
-  "mode": "compact",
-  "excludeRenderers": ["edit", "write"],
-  "fixedEditorFeatures": true
-}
-```
-`mode` 可取 `on`、`off` 或 `compact`。`fixedEditorFeatures` 默认为 `true`，启用 fixed editor 的每刻度 5 行滚动、工具鼠标点击、收起位置补偿、滚动到底部按钮、消息计数和专用 viewport 映射；设为 `false` 后关闭终端鼠标上报及上述功能，让非 fixed editor 恢复终端原生滚轮滚动（工具仍可通过键盘展开）。`Ctrl+End` 在两种模式下均保留。旧版 `enabled: true/false` 会自动迁移为 `on/off`。排除名单使用精确工具名；手动修改配置后执行 `/reload`。`Agent` 的专用 renderer 始终保留。
-Compact transcript 行为改编自 [avhagedorn/pi-compact-transcript](https://github.com/avhagedorn/pi-compact-transcript) v0.6.2（MIT，Alan Hagedorn）。
-### 结构化问卷
-`extensions/ask-user-question/index.ts` 内置 `ask_user_question` 工具，支持：
-- 单选、多选、2–4 个选项及最多 4 个问题的标签页问卷
-- `Type something.` 自定义回答、备注和 Markdown 预览
-- RPC / ACP 原生对话框降级；无 UI 时自动移除工具
-- TUI 使用 Pi 原生临时 editor component，不替换 editor factory：兼容默认滚动编辑器，也兼容 `pi-zentui` fixed-editor
-- 响应式高度预算：常规终端为历史 transcript 至少保留 6 行、约 30% 高度；`Ctrl+]` 可折叠为单行并保留答案
-- UI 固定使用英文，不加载国际化套件或语言包
-配置文件为 `~/.config/rpiv-ask-user-question/config.json`。可通过 `collapseKey` 修改折叠快捷键，详见 [`extensions/ask-user-question/README.md`](./extensions/ask-user-question/README.md)。
-该扩展基于 [`@juicesharp/rpiv-ask-user-question`](https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-ask-user-question) v2.1.0（MIT）内置，并包含本项目针对默认滚动编辑器、固定编辑器与历史消息视口的兼容优化。
-### 上下文窗口查看
-`extensions/context.ts` 注册 `/context`，展示当前上下文窗口的使用分布，并可进一步预览：
-- System prompt
-- Tools
-- Context files
-- Skills
-- User / assistant messages
-- Tool results
-- Compaction summaries
-### 历史 Session 引用
-`extensions/session-reference.ts` 将历史 Session 接入 `@` 补全：
-1. 在提示词中输入 `@`。
-2. 从 `[Session] ...` 或 `[SubAgent] ...` 补全项中选择要引用的上下文。
-3. 提交时以 `@session:<session-id>` 引用其当前有效上下文。
-Session 模糊查询默认显示 3 个候选，并与文件候选按 1:2 交错排列；路径型查询优先显示文件。若已加载 `pi-subagents`，也可直接引用现有 SubAgent。一次提示词可以引用多个 Session；扩展会自动去重，并限制注入规模以避免上下文无限膨胀。
-### SubAgent `@` 补全
-`extensions/agent-autocomplete.ts` 将 `~/.pi/agent/agents/*.md` 中定义的 SubAgent 接入 `@` 补全：
-1. 在提示词中输入 `@agent-name`。
-2. 从补全列表中选择 SubAgent。
-3. 提交后自动注入委托指令；提示词中提到的每个 SubAgent 都会分别交由 Agent 工具处理。
-该补全不会占用 `@session:` 的历史 Session 引用语法；与 `@bacnh85/pi-fff` 同时启用时，SubAgent、Session 和 FFF 文件候选会合并显示。修改 SubAgent 定义后执行 `/reload` 即可重新加载。
-## 安装
-从 npm 安装（推荐）：
-```bash
-pi install npm:pi-cc-extensions
-```
-或从 Git 安装：
-```bash
-pi install git:github.com/minuque/pi-cc-extensions
-```
-安装后可以先运行：
-```text
-/context
-/ccstyle on
-# ask_user_question 会自动作为工具提供给模型
-```
-## 本地开发
-```bash
-npm test
-pi -e .
-```
-也可以把当前仓库作为本地 Pi 包安装：
-```bash
-pi install /absolute/path/to/pi-cc-extensions
-```
-修改扩展后，在 Pi 中执行：
-```text
-/reload
-```
-`ask-user-question` 的 TUI 模块会被进程缓存；修改该目录或重装依赖后需完整退出并重启 Pi，不能只执行 `/reload`。
-## 兼容性
-- Node.js `>=22.19.0`
-- 作为 Pi package 加载，入口由根目录 `package.json` 的 `pi.extensions` 显式声明
-## 扩展推荐
-| 扩展                                     | 作用                                                                          |
-| ------------------------------------------ | ------------------------------------------------------------------------------- |
-| `npm:pi-theme-picker`                    | 通过`/theme` 交互式切换 Pi 主题，支持模糊搜索和实时预览                       |
-| `npm:pi-mcp-adapter`                     | 将 MCP 服务接入 Pi，并通过代理工具按需发现，减少上下文占用                    |
-| `npm:@tintinweb/pi-subagents`            | Claude Code 风格的并行 SubAgent、后台任务、任务编排、工作树隔离和自定义 Agent |
-| `npm:@ayulab/pi-rewind`                  | 基于 checkpoint 的`/rewind` 回退，支持分别恢复代码、对话或两者                |
-| `npm:pi-compact-thinking`                | 将隐藏的思考块渲染为紧凑、带动画的推理预览                                    |
-| `npm:pi-startup-header`                  | 用跟随当前主题配色的渐变 ASCII 标题替换默认启动头                             |
-| `npm:pi-zentui`                          | Starship 风格状态栏与 Opencode 风格编辑器，支持固定编辑器和 Git 状态          |
-### 使用注意
-- 内置问卷采用非 overlay 的临时 editor component，兼容 `pi-zentui` 固定编辑器；常规终端会保留历史消息视口。
-- `pi-mcp-adapter` 默认延迟连接 MCP 服务，有助于节省上下文；包含凭据的 MCP 配置不要提交到仓库。
-- `pi-compact-thinking` 和 `pi-zentui` 都涉及 Pi 内部 UI 行为，升级 Pi 后若出现异常，优先执行 `/reload` 或暂时停用对应扩展。
+<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
+```
+安装后执行 `/reload`，然后可以使用：
+```text
+/ccstyle       # 配置输出与 fixed editor 交互
+/context       # 查看上下文占用
+@              # 补全 Agent、Session 与文件
+```
+`ask_user_question` 会自动注册为模型工具。
+## 功能
+| 功能                         | 说明                                                                            | 入口                |
+| ------------------------------ | --------------------------------------------------------------------------------- | --------------------- |
+| 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:`         |
+| Agent 补全                   | 从`~/.pi/agent/agents/*.md` 补全并委托自定义 Agent                              | `@agent-name`       |
+| 主题                         | 随包提供 GitHub Dark Default 主题                                               | `/theme`            |
+### 输出模式
+| 模式      | 行为                                                      |
+| ----------- | ----------------------------------------------------------- |
+| `on`      | Claude Code 风格工具输出；`edit` / `write` 使用 rich diff |
+| `off`     | 使用 Pi 原生 renderer                                     |
+| `compact` | 单行工具预览、同名调用合并、运行耗时与总结                |
+```text
+/ccstyle on
+/ccstyle off
+/ccstyle compact
+/ccstyle status
+```
+配置保存在 `~/.pi/agent/claude-code-style.json`：
+```json
+{
+  "mode": "on",
+  "excludeRenderers": [],
+  "fixedEditorFeatures": true
+}
+```
+- `excludeRenderers` 使用精确工具名；`Agent` 始终保留专用 renderer。
+- `fixedEditorFeatures: true` 启用 fixed editor 鼠标滚动、点击、viewport 映射和回到底部提示。
+- 设为 `false` 会关闭终端鼠标上报，恢复终端原生滚轮；`Ctrl+End` 仍可用。
+- 手动修改配置后执行 `/reload`。
+### 结构化问卷
+支持 1–4 个问题、每题 2–4 个选项、单选、多选、自定义回答和可选 Markdown 预览。TUI 会保留部分 transcript 空间；RPC / ACP 环境自动降级为原生对话框。
+问卷配置位于 `~/.config/rpiv-ask-user-question/config.json`。快捷键与完整行为见 [`extensions/ask-user-question/README.md`](./extensions/ask-user-question/README.md)。
+### `@` 引用
+- 输入 `@session:` 引用历史 Session。
+- 输入 `@agent-name` 委托自定义 Agent。
+- 可与 `@bacnh85/pi-fff` 和 `@tintinweb/pi-subagents` 共存。
+- Session 内容会去重并限制注入规模。
+## 其他安装方式
+```bash
+# GitHub
+pi install git:github.com/minuque/pi-cc-extensions
+# 本地仓库
+pi install /absolute/path/to/pi-cc-extensions
+```
+## 本地开发
+```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 块          |
+| `npm:pi-startup-header`       | 主题自适应启动标题                  |
+## 致谢
+- 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)。

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
 	"name": "pi-cc-extensions",
-	"version": "0.8.11",
+	"version": "0.8.12",
 	"description": "A Pi productivity suite with Claude Code-style UI, structured questionnaires, context inspection, and agent/session references",
 	"type": "module",
 	"keywords": [
@@ -22,7 +22,8 @@
 		"extensions",
 		"assets/readme",
 		"themes",
-		"README.md"
+		"README.md",
+		"README.en.md"
 	],
 	"pi": {
 		"extensions": [