pi-cc-extensions

---

界面预览

功能

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

常用命令：

/ccstyle             # 打开交互式配置面板
/ccstyle on          # Claude Code 风格
/ccstyle off         # Pi 原生输出
/ccstyle compact     # 紧凑 transcript 风格
/ccstyle status      # 查看当前模式

需要保留指定工具的原生或扩展 renderer 时，编辑 ~/.pi/agent/claude-code-style.json：

{
  "mode": "compact",
  "excludeRenderers": ["edit", "write"]
}

mode 可取 on、off 或 compact。旧版 enabled: true/false 会自动迁移为 on/off。排除名单使用精确工具名；手动修改配置后执行 /reload。Agent 的专用 renderer 始终保留。

Compact transcript 行为改编自 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。

该扩展基于 @juicesharp/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 安装（推荐）：

pi install npm:pi-cc-extensions

或从 Git 安装：

pi install git:github.com/minuque/pi-cc-extensions

安装后可以先运行：

/context
/ccstyle on
# ask_user_question 会自动作为工具提供给模型

本地开发

npm test
pi -e .

也可以把当前仓库作为本地 Pi 包安装：

pi install /absolute/path/to/pi-cc-extensions

修改扩展后，在 Pi 中执行：

/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 或暂时停用对应扩展。