搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

johnlindquist/pi-emphasis

开发工具

这是一个 Pi 扩展,把助手回复中的状态词渲染成带图标的彩色胶囊、标题图标和高亮粗体,方便快速扫读。

243
7
TypeScript
MIT
创建于 2 天前

项目介绍

Pi Emphasis 是 Pi 编程终端的扩展,只改变回复的绘制方式:[[Done]]、[[Failed]] 这类方括号词会变成带图标的彩色胶囊,常见标题和行首标签会加上图标,粗体、箭头和树形连线也会着色。存储的消息、复制的文本和 HTML 导出仍保留原始 Markdown,效果只出现在终端界面里。

扩展会向 Pi 的系统提示词注入自己的 reply_style 规则,告诉模型该用哪些胶囊词,以及如何标注后果和归属。这段内容约增加 1,500 token,且只在 Pi 终端界面中生效;print、JSON 和 RPC 运行不会收到。整个过程不调用模型,也不依赖网络服务。

快速使用

需要 Pi 1.5 或更新版本,以及 git,因为 pi install 会克隆仓库。按照安装步骤 执行:

pi install git:github.com/johnlindquist/pi-emphasis

然后在 Pi 中运行 /reload 或重新启动。想先不安装试用:

pi -e git:github.com/johnlindquist/pi-emphasis

验证方式是让 Pi 输出一行包含 [[Done]]、[[Needs you]]、[[Failed]] 和 [[Costs money]] 的回复,应看到四个不同颜色、带圆角的胶囊。如果终端缺少所需字形,终端设置提供了检测命令,以及通过 Homebrew 或 Nerd Fonts 下载安装字体的方法。

胶囊与标签

[[...]] 中的词决定颜色和图标。红色表示出问题,黄色提示注意,绿色表示已确定状态,实心红标注 [[Costs money]] 这类后果。青色描述工作类型,蓝色则覆盖归属和上下文。标签可附带细节,如 [[Passed 12/12]] 或 [[Failed: 3 tests]],多个同义词会映射到同一胶囊。单个标签最长 32 个字符。

预定义列表中的标题和加粗行首标签,例如 Finding、Risk、Plan、Next,会自动获得图标。Check:、Next: 这类动作引导词在行内任意位置都会加图标。你自己的消息、行内代码、围栏代码和转义星号不会被改动。

使用约束

终端需要能绘制 Nerd Font 符号,否则图标和圆角胶囊端会显示异常;此时可设置 PI_EMPHASIS_PILL_ICONS=0 和 PI_EMPHASIS_ROUND_CAPS=0 改用普通标签。终端还需要支持颜色,否则胶囊会以反色单色显示。README 说明仅在 macOS 的 Ghostty 和 Herdr 应用上验证过。部分胶囊颜色取自终端自身调色板,具体色调会随主题变化。

如果希望自定义写作规则,可设置 PI_EMPHASIS_GUIDANCE=0,绘制效果保留,但不再注入内置的 reply_style 提示词。要增加词条、图标或同义词,可编辑 index.ts 顶部的表。开发需要 Bun,使用 bun install 和 bun run check。

HotRepo 点评

这是一个依赖 Pi 才能使用的小型专注扩展,而非独立工具。2026-11-17 的新项目快照显示,它在约一小时内新增 16 Star,累计达到 119 Star 和 3 Fork;这只是一个很短的窗口,不足以说明持续增长。实现是单个 TypeScript 文件加演示素材,采用 MIT 许可,范围清晰,想要调整词汇的用户可以直接修改源码。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. ZiChuanLan/pi-purge一个 pi 扩展,用你自己的提示词文件替换编程 agent 的系统提示词,方便做受控的提示词实验。JavaScript301
  2. Xpropel/Pi-Remote把运行中的 pi 编程智能体会话实时镜像到浏览器,通过自托管中继在手机上查看和下发指令。TypeScript212
  3. nicobailon/pi-subagents让 Pi 会话把评审、侦察和实现分派给专注的子代理,支持并行与后台运行。TypeScript4,071
  4. nicobailon/pi-better一个 Pi 扩展,用你仓库里的真实代码和文件把提示词改写成专业级任务说明。TypeScript103
  5. ZiChuanLan/agent-purge用一份本地 persona 替换或追加多个 coding agent 的系统提示词,并提供可逆的开关。JavaScript163