@herbertgao/pi-cc-extensions1.0.8-local.1
A Pi productivity suite with Claude Code-style UI, context inspection, and agent/session references
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
简体中文 · English
pi-cc-extensions
类 Claude Code TUI 输出风格,并融入了一些个人喜好,和一些实用小功能。
界面预览
点击封面播放演示视频
快速开始
pi install npm:@herbertgao/pi-cc-extensions
# GitHub(本 monorepo)
pi install git:github.com/HerbertGao/pi-extensions
安装后执行 /reload
功能
| 功能 | 说明 | 入口 |
|---|---|---|
| Claude Code UI | 工具摘要、折叠展开、rich edit/write diff,以及on / compact / off 三种模式 |
/ccstyle |
| Markdown 增强 | Mermaid 方言渲染、圈数字转半角括号 | 自动生效;enableMarkdownEnhance: false 关闭 |
| Fullscreen mode | 工具卡/group 单击展开与收起、预览、hover 高亮、回到底部按钮 | TUIMODE=fullscreen 或 --tui-mode fullscreen |
| 配置面板 | Style / Features / UI / Diff / Thinking / Footer 六页签 |
/ccstyle |
| 上下文检查 | 查看上下文占用,并预览 System prompt、Memory、Skills、Tools definition 和消息内容 | /context |
| Session/Subagent 引用 | 搜索并注入历史 Session 或现有 SubAgent 的有效上下文 | @ |
| 状态栏 | 显示:模型、上下文、缓存、费用、git并适配 @narumitw/pi-usage 实时显示额度;git/缓存图标可关 Nerd Font | /ccstyle |
| 主题 | 随包提供内置 CC Dark、CC Light 主题 | /theme |
on / compact 两种模式的渲染样例:默认模式 · 紧凑模式
配置
/ccstyle 的行为由 ~/.pi/agent/pi-cc-extensions.json 配置:
{
// style
"mode": "on", // on / compact / off
"excludeRenderers": [], // 走原生渲染的工具名;Agent 始终保留专用渲染器
// features
"enableSessionReference": true, // @ session 引用
"enableSubagentAutocomplete": true, // @subagent:[name] 补全与委派提示
"enableContextCommand": true, // /context 上下文检查
"enableAgentSummary": true, // 每回合工具摘要
"enableWorkingMessage": true, // Working... 底部 token/耗时
"enableAliases": true, // /clear、/exit 别名
"enableMarkdownEnhance": true, // markdown 转换:Mermaid 方言渲染、圈数字转半角括号;false 让位给其他扩展
"enableEditorPrefix": true, // 输入框 ❯ 前缀
// ui
"expandedInputMaxLines": 5, // 展开工具卡 Input 可见行数,超出在末行显示展开提示
"expandedOutputMaxLines": 10, // 展开工具卡 Output 可见行数,超出在末行显示展开提示
"expandedPreviewMaxLines": 40, // 展开 TaskList 正文最大行数(展开 diff 始终全量)
"toolLabelClip": 0, // 工具摘要 path/command 折叠字符数;0 = 按可用宽度
"showStartupHeader": true, // 启动头(logo + tips)开关
"stickyUserMessage": true, // fullscreen:userMessage 正文首行滚出视口上沿后钉住,直到下一条指令接手
"scrollButtonMode": "dock", // fullscreen:dock 独占行 / native Pi 原生浮层
// diff
"diffViewMode": "auto", // 布局:auto / split / unified
"diffIndicatorMode": "bars", // 变更指示:bars / classic / none
"diffSplitMinWidth": 120, // 左右分栏的最小终端宽度
"editDiffCollapsedLines": 24, // edit 折叠行数;0 仅显示变更统计摘要
"writeDiffCollapsedLines": 0, // write 折叠行数,0 仅显示创建摘要
"diffWordWrap": true, // 长 diff 行换行
// thinking
"useSummaryTitlesAsThinkingTitle": true, // 用最新摘要作思考标题
"previewLines": 3, // 预览行数,0 隐藏
"animationIntervalMs": 90, // 标题动画间隔(毫秒)
// footer
"enableCustomFooter": true, // 自定义状态栏
"footerTokenRate": true, // 输出速率芯片;false 隐藏
"footerTokenRateMode": "average", // average:整段指令平均(avg);live:最近 1 秒瞬时(live)
"footerCurrency": "USD", // 底栏费用的显示币种
"footerCurrencyRate": null, // 1 单位费用换成多少显示币种;null 只换符号、不乘倍率
"footerNerdIcons": true, // git/缓存用 Nerd Font 图标;false 为纯文本
"footerGitStatsMode": "working", // working(默认):未提交改动;branch:分支累计净改动
"footerHiddenKeys": [], // 隐藏的芯片 key
"footerLine1Keys": ["model", "context", "cache", "rate", "cost", "pi-usage"], // 每行芯片顺序;内置项与插件同一套排布
"footerLine2Keys": ["cwd", "git"], // cwd:目录和会话名;git:分支和改动。可换到任意行
"footerLine3Keys": [] // 有可见芯片才占行
}
[!TIP] 全屏模式:单击
click to show more展开工具卡、思考、Skill 和 compact 摘要;工具卡展开态 diff 全量显示,Input/Output 超行时末行… +N more lines · click to show more打开全量预览,单击收起。
scrollButtonMode两种模式文案相同(Back to bottom/N new message(s)):dock画在独占行,native画在 Pi 原生浮层。
[!NOTE] Mermaid 渲染:建议把
markdown.mermaid设为final(~/.pi/agent/settings.json或/settings面板的 Mermaid diagrams 选项)。默认streaming逐帧重绘,final渲染最终版更稳定。
本地开发
npm test
npm run typecheck
./test.sh # macOS/Linux:临时加载本地检出,退出后还原
./test.bat # Windows:经 Git Bash 运行 test.sh
pi -e . # 只跑一次,不改 settings.json
兼容性
- Node.js
>=22.19.0;monorepo 使用 Pi1.2.0,发布包的 Pi peer 版本保持*。
推荐搭配
| 扩展 | 用途 |
|---|---|
npm:pi-web-access |
网页搜索、URL 抓取、GitHub 克隆、PDF/视频解析 |
npm:@narumitw/pi-usage |
查看当前账号用量(Codex / Copilot / OpenRouter) |
npm:@juicesharp/rpiv-ask-user-question |
模型拿不准时向你提问的选择题面板 |
致谢
- 基于
minuque/pi-cc-extensions1.0.8(MIT),上游基线2cb2c1e;保留本仓库的配置迁移与兼容性补丁。 - Rich diff 改编自
MasuRii/pi-tool-display(MIT);详见extensions/renderer/tool/diff/ATTRIBUTION.md。
许可证
MIT © 2026 minuque;衍生维护:HerbertGao/pi-extensions
