类 Claude Code TUI 输出风格，并融入了一些个人喜好，和一些实用小功能。
简体中文 · English
--- ## 界面预览 https://github.com/user-attachments/assets/6c858000-fdad-43f9-957f-4d0278648498 ## 快速开始 ```bash pi install npm:pi-cc-extensions # GitHub pi install git:github.com/minuque/pi-cc-extensions ``` 安装后执行 `/reload` ## 功能 | 功能 | 说明 | 入口 | | --------------------- | ------------------------------------------------------------------------------- | ----------------------------------------------- | | Claude Code UI | 工具摘要、折叠展开、rich edit/write diff，以及`on` / `compact` / `off` 三种模式 | `/ccstyle` | | Markdown 增强 | Mermaid 图、提示框、URL 链接化等 | 自动生效 | | Fullscreen mode | 工具卡/group 单击展开、双击收起、预览、hover 高亮、回到底部按钮 | `TUIMODE=fullscreen` 或 `--tui-mode fullscreen` | | 配置面板 | `Style / Diff / Thinking / UI / Feature` 五页签 | `/ccstyle` | | 上下文检查 | 查看上下文占用，并预览 System prompt、Memory、Skills、Tools definition 和消息内容 | `/context` | | Session/Subagent 引用 | 搜索并注入历史 Session 或现有 SubAgent 的有效上下文 | `@` | | 主题 | 随包提供内置 CC Dark、CC Light 主题 | `/theme` | ## 配置 `/ccstyle` 的行为由 `~/.pi/agent/claude-code-style.json` 配置： ```js { "mode": "on", // on / compact / off "excludeRenderers": [], // 走原生渲染的工具名；Agent 始终保留专用渲染器 // diff "diffViewMode": "auto", // 布局：auto / split / unified "diffIndicatorMode": "bars", // 变更指示：bars / classic / none "diffSplitMinWidth": 120, // 左右分栏的最小终端宽度 "editDiffCollapsedLines": 24, // Edit 折叠行数，超出显示展开提示 "writeDiffCollapsedLines": 0, // write 折叠行数，0 仅显示创建摘要 "diffWordWrap": true, // 长 diff 行换行 "expandedPreviewMaxLines": 40, // 展开正文最大行数 "toolInputNameLength": 100, // 工具摘要 path/command 折叠字符数 // thinking "useSummaryTitlesAsThinkingTitle": true, // 用最新摘要作思考标题 "previewLines": 3, // 预览行数，0 隐藏 "animationIntervalMs": 90, // 标题动画间隔（毫秒） "dimThinkingText": false, // thinking 正文用 dim 色 // ui "showStartupHeader": true, // 启动头（logo + tips）开关 "scrollStepLines": 3, // fullscreen 滚轮步进 // features "enableSessionReference": true, // @ session 引用 "enableSubagentAutocomplete": true, // @ subagent 补全与委派提示 "enableContextCommand": true, // /context 上下文检查 "enableAgentSummary": true, // 每回合工具摘要 "enableWorkingMessage": true, // Working... 底部 token/耗时 "enableAliases": true // /clear、/exit 别名 } ``` > **Fullscreen**：单击 `click to show more` 展开工具卡、思考、Skill 和 compact 摘要，双击展开面板收起。 > > **建议**：`markdown.mermaid` 设为 `final`（`~/.pi/agent/settings.json` 或 `/settings` 面板的 Mermaid diagrams 选项）。默认 `streaming` 逐帧重绘，`final` 渲染最终版更稳定。 ## 本地开发 ```bash npm test npm run typecheck ./test.bat # or pi -e . ``` ## 兼容性 - 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:@narumitw/pi-usage` | 查看当前账号用量（Codex / Copilot / OpenRouter） | | `git:github.com/DietrichGebert/ponytail` | 极简编码：强制最懒但有效的方案 | ## 致谢 - 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)。