类 Claude Code TUI 输出风格，并融入了一些个人喜好，和一些实用小功能。
简体中文 · English
---
## 界面预览
## 快速开始
```bash
pi install npm:@herbertgao/pi-cc-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` |
## 配置
`/ccstyle` 的行为由 `~/.pi/agent/claude-code-style.json` 配置：
```js
{
"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 滚轮滚动步进行数
"enableSessionReference": true, // @ session 引用
"enableSubagentAutocomplete": true, // @ subagent 自动补全
"enableContextCommand": true, // /context 上下文检查
"enableAgentSummary": true, // 每回合工具统计摘要
"enableWorkingMessage": true, // Working... token/耗时展示
"enableAliases": true // /clear、/exit 别名
}
```
> **建议**：在 `/settings` 中将 Mermaid diagrams 设为 `final`，避免流式内容逐帧重绘。
## 本地开发
```bash
bun run test
bun run typecheck
./test.bat # or pi -e .
```
## 兼容性
- Node.js `>=22.19.0`，Pi `^0.84.0 || ^0.85.0`（通过根目录 `package.json` 的 `pi.extensions` 和 `pi.themes` 加载）
## 推荐搭配
| 扩展 | 用途 |
| ------------------------------------------ | -------------------------------------------------- |
| `npm:@tintinweb/pi-subagents` | 并行 SubAgent、后台任务与工作树隔离 |
| `npm:@tintinweb/pi-tasks` | Claude Code 风格任务跟踪与协调 |
| `npm:pi-mcp-adapter` | 按需发现 MCP 工具，减少上下文占用 |
| `npm:@ff-labs/pi-fff` | 模糊文件与内容检索（fffind / ffgrep） |
| `npm:pi-web-access` | 网页搜索、URL 抓取、GitHub 克隆、PDF/视频解析 |
| `npm:pi-theme-picker` | 主题搜索和实时预览 |
| `npm:@narumitw/pi-usage` | 查看当前账号用量（Codex / Copilot / OpenRouter） |
| `git:github.com/DietrichGebert/ponytail` | 极简编码：强制最懒但有效的方案 |
## 致谢
- 基于 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)。