pi-cc-extensions 0.1.1

package/README.md

@@ -0,0 +1,141 @@
+<p align="center">
+  <img src="./assets/readme/hero.svg" width="100%" alt="pi-cc-extensions：为 Pi 提供 Claude Code 风格界面、上下文洞察和历史 Session 引用">
+</p>
+
+<p align="center">
+  <a href="#安装"><img alt="Pi package" src="https://img.shields.io/badge/Pi-package-58B7FF?style=flat-square"></a>
+  <a href="./package.json"><img alt="Version 0.1.1" src="https://img.shields.io/badge/version-0.1.1-66E3C4?style=flat-square"></a>
+  <a href="#兼容性"><img alt="Node.js 22.19 or newer" src="https://img.shields.io/badge/Node.js-%E2%89%A522.19-66E3C4?style=flat-square"></a>
+  <a href="./extensions"><img alt="TypeScript extensions" src="https://img.shields.io/badge/TypeScript-extensions-3178C6?style=flat-square"></a>
+</p>
+
+<p align="center">
+  为 Pi 补充一套更接近 Claude Code 的终端工作流 · 上下文洞察 · 历史 Session 引用
+</p>
+
+---
+
+## 截图
+
+<table>
+  <tr>
+    <td width="50%" align="center">
+      <img src="./assets/readme/showcase.webp" width="100%" alt="Pi 终端中的 Claude Code 风格扩展界面，包含工具调用摘要、Diff 预览和 Powerline 状态栏">
+      <br>
+      <sub><b>Claude Code 风格界面</b><br>工具调用摘要、Diff 预览与 Powerline 状态栏</sub>
+    </td>
+    <td width="50%" align="center">
+      <img src="./assets/readme/session-reference.webp" width="100%" alt="在 Pi 中通过 @ 补全选择历史 Session">
+      <br>
+      <sub><b>历史 Session 引用</b><br>通过 @ 补全快速找到并引用历史会话</sub>
+    </td>
+  </tr>
+  <tr>
+    <td width="50%" align="center">
+      <img src="./assets/readme/context-usage.webp" width="100%" alt="Pi 上下文窗口用量查看器">
+      <br>
+      <sub><b>上下文用量</b><br>查看 System prompt、Tools、Skills 等占用分布</sub>
+    </td>
+    <td width="50%" align="center">
+      <img src="./assets/readme/context-preview.webp" width="100%" alt="Pi 中展开查看 System Prompt 内容">
+      <br>
+      <sub><b>上下文预览</b><br>按类别展开查看实际注入的上下文内容</sub>
+    </td>
+  </tr>
+</table>
+
+## 功能
+
+### Claude Code 风格界面
+
+`extensions/claude-code-style.ts` 提供：
+
+- Claude Code 风格的工具调用行与结果摘要
+- Powerline 状态栏和工作状态提示
+- Edit / Write 的 Diff 预览
+- 工具结果的折叠与展开
+- `/ccstyle` 配置命令和 `Ctrl+Shift+O` 快捷键
+
+常用命令：
+
+```text
+/ccstyle             # 切换开关
+/ccstyle status      # 查看状态
+/ccstyle compact     # 紧凑摘要
+/ccstyle minimal     # 最小化输出
+/ccstyle powerline   # 查看 Powerline 预设
+```
+
+### 上下文窗口查看
+
+`extensions/context.ts` 注册 `/context`，展示当前上下文窗口的使用分布，并可进一步预览：
+
+- System prompt
+- Tools
+- Context files
+- Skills
+- User / assistant messages
+- Tool results
+- Compaction summaries
+
+### 历史 Session 引用
+
+`extensions/session-reference/index.ts` 将历史 Session 接入 `@` 补全：
+
+1. 在提示词中输入 `@`。
+2. 从 `[Session] ...` 或 `[SubAgent] ...` 补全项中选择要引用的上下文。
+3. 提交时以 `@session:<session-id>` 引用其当前有效上下文。
+
+Session 模糊查询默认显示 3 个候选；若已加载 `pi-subagents`，也可直接引用现有 SubAgent。一次提示词可以引用多个 Session；扩展会自动去重，并限制注入规模以避免上下文无限膨胀。更多细节见 [`extensions/session-reference/README.md`](./extensions/session-reference/README.md)。
+
+## 安装
+
+从 Git 安装指定版本：
+
+```bash
+pi install git:github.com/minuque/pi-cc-extensions@v0.1.0
+```
+
+安装后启动 Pi，即可使用上述扩展。更新到主分支版本：
+
+```bash
+pi install git:github.com/minuque/pi-cc-extensions
+```
+
+安装后可以先运行：
+
+```text
+/context
+/ccstyle status
+```
+
+## 本地开发
+
+```bash
+npm test
+pi -e .
+```
+
+也可以把当前仓库作为本地 Pi 包安装：
+
+```bash
+pi install /absolute/path/to/pi-cc-extensions
+```
+
+修改扩展后，在 Pi 中执行：
+
+```text
+/reload
+```
+
+## 兼容性
+
+- Node.js `>=22.19.0`
+- 作为 Pi package 加载，入口由根目录 `package.json` 的 `pi.extensions` 显式声明
+
+## 发布检查
+
+```bash
+npm test
+npm pack --dry-run
+```

package/assets/readme/hero.svg

@@ -0,0 +1,101 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="400" viewBox="0 0 1200 400" role="img" aria-labelledby="title desc">
+  <title id="title">pi-cc-extensions
+  </title>
+  <desc id="desc">Claude 与 Pi 品牌图标组合连接三项扩展能力：Claude Code 风格界面、上下文洞察和历史 Session 引用。
+  </desc>
+  <defs>
+    <linearGradient id="panel" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#0D131B"/>
+      <stop offset="1" stop-color="#090D12"/>
+    </linearGradient>
+  </defs>
+  <rect width="1200" height="400" rx="28" fill="url(#panel)"/>
+  <rect x="1" y="1" width="1198" height="398" rx="27" fill="none" stroke="#263241" stroke-width="2"/>
+  <g id="title-block" transform="translate(64 58)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', sans-serif">
+    <g font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="16" font-weight="600" letter-spacing="1.4">
+      <text x="0" y="0" fill="#66E3C4">PI EXTENSION
+      </text>
+    </g>
+    <text x="0" y="82" fill="#F4F7FA" font-size="54" font-weight="750" letter-spacing="-1.5">pi-cc-extensions
+    </text>
+    <text x="0" y="130" fill="#B8C3CF" font-size="23">让 Pi 工作时表现像 Claude code 🙃
+    </text>
+    <g transform="translate(0 180)" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="17">
+      <rect width="488" height="58" rx="12" fill="#111923" stroke="#2B3948"/>
+      <text x="20" y="36" fill="#66E3C4">›
+      </text>
+      <text x="44" y="36" fill="#F4F7FA">/ccstyle
+      </text>
+      <text x="155" y="36" fill="#536172">·
+      </text>
+      <text x="178" y="36" fill="#7CC7FF">/context
+      </text>
+      <text x="292" y="36" fill="#536172">·
+      </text>
+      <text x="315" y="36" fill="#F2C879">@session:
+      </text>
+      <rect x="411" y="22" width="9" height="20" rx="2" fill="#66E3C4"/>
+    </g>
+    <g transform="translate(0 282)" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15">
+      <circle cx="6" cy="-5" r="6" fill="#66E3C4"/>
+      <text x="22" y="0" fill="#8B9AAD">3 EXTENSIONS
+      </text>
+      <text x="160" y="0" fill="#3B4857">•
+      </text>
+      <text x="183" y="0" fill="#8B9AAD">TYPESCRIPT
+      </text>
+      <text x="303" y="0" fill="#3B4857">•
+      </text>
+      <text x="326" y="0" fill="#8B9AAD">NODE ≥ 22.19
+      </text>
+    </g>
+  </g>
+  <g id="extension-map" transform="translate(662 48)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', sans-serif">
+    <g id="claude-pi-mark" transform="translate(0 0)">
+      <!-- Official Claude starburst vector; source: Anthropic Claude brand mark. -->
+        <path transform="translate(2 2) scale(.34)" fill="#D97757" d="m19.6 66.5 19.7-11 .3-1-.3-.5h-1l-3.3-.2-11.2-.3L14 53l-9.5-.5-2.4-.5L0 49l.2-1.5 2-1.3 2.9.2 6.3.5 9.5.6 6.9.4L38 49.1h1.6l.2-.7-.5-.4-.4-.4L29 41l-10.6-7-5.6-4.1-3-2-1.5-2-.6-4.2 2.7-3 3.7.3.9.2 3.7 2.9 8 6.1L37 36l1.5 1.2.6-.4.1-.3-.7-1.1L33 25l-6-10.4-2.7-4.3-.7-2.6c-.3-1-.4-2-.4-3l3-4.2L28 0l4.2.6L33.8 2l2.6 6 4.1 9.3L47 29.9l2 3.8 1 3.4.3 1h.7v-.5l.5-7.2 1-8.7 1-11.2.3-3.2 1.6-3.8 3-2L61 2.6l2 2.9-.3 1.8-1.1 7.7L59 27.1l-1.5 8.2h.9l1-1.1 4.1-5.4 6.9-8.6 3-3.5L77 13l2.3-1.8h4.3l3.1 4.7-1.4 4.9-4.4 5.6-3.7 4.7-5.3 7.1-3.2 5.7.3.4h.7l12-2.6 6.4-1.1 7.6-1.3 3.5 1.6.4 1.6-1.4 3.4-8.2 2-9.6 2-14.3 3.3-.2.1.2.3 6.4.6 2.8.2h6.8l12.6 1 3.3 2 1.9 2.7-.3 2-5.1 2.6-6.8-1.6-16-3.8-5.4-1.3h-.8v.4l4.6 4.5 8.3 7.5L89 80.1l.5 2.4-1.3 2-1.4-.2-9.2-7-3.6-3-8-6.8h-.5v.7l1.8 2.7 9.8 14.7.5 4.5-.7 1.4-2.6 1-2.7-.6-5.8-8-6-9-4.7-8.2-.5.4-2.9 30.2-1.3 1.5-3 1.2-2.5-2-1.4-3 1.4-6.2 1.6-8 1.3-6.4 1.2-7.9.7-2.6v-.2H49L43 72l-9 12.3-7.2 7.6-1.7.7-3-1.5.3-2.8L24 86l10-12.8 6-7.9 4-4.6-.1-.5h-.3L17.2 77.4l-4.7.6-2-2 .2-3 1-1 8-5.5Z"/>
+        <path d="M50 3V35" stroke="#3A4857" stroke-width="2"/>
+        <!-- Official Pi logo vectors; source: https://pi.dev/logo-auto.svg -->
+          <g transform="translate(52 -5) scale(.06)" fill="#F4F7FA">
+            <path fill-rule="evenodd" d="M165.29 165.29H517.36V400H400V517.36H282.65V634.72H165.29ZM282.65 282.65V400H400V282.65Z"/>
+            <path d="M517.36 400H634.72V634.72H517.36Z"/>
+          </g>
+          <text x="104" y="15" fill="#F4F7FA" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="15" font-weight="700" letter-spacing=".8">CLAUDE CODE UX
+          </text>
+          <text x="104" y="34" fill="#7F8D9C" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="13" letter-spacing="1.2">FOR PI
+          </text>
+        </g>
+        <g transform="translate(0 52)">
+          <rect width="474" height="82" rx="14" fill="#101821" stroke="#2C3A48"/>
+          <rect width="5" height="82" rx="2.5" fill="#66E3C4"/>
+          <text x="26" y="32" fill="#F4F7FA" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="18" font-weight="700">/ccstyle
+          </text>
+          <text x="26" y="59" fill="#8B9AAD" font-size="16">工具摘要 · Diff · 状态栏
+          </text>
+          <circle cx="438" cy="29" r="9" fill="#66E3C4" opacity=".18"/>
+          <path d="M434 29l3 3 6-7" fill="none" stroke="#66E3C4" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+        </g>
+        <g transform="translate(0 144)">
+          <rect width="474" height="82" rx="14" fill="#101821" stroke="#2C3A48"/>
+          <rect width="5" height="82" rx="2.5" fill="#7CC7FF"/>
+          <text x="26" y="32" fill="#F4F7FA" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="18" font-weight="700">/context
+          </text>
+          <text x="26" y="59" fill="#8B9AAD" font-size="16">用量分布 · 注入内容预览
+          </text>
+          <g transform="translate(416 23)">
+            <rect width="42" height="14" rx="7" fill="#1C2B38"/>
+            <rect width="27" height="14" rx="7" fill="#7CC7FF"/>
+          </g>
+        </g>
+        <g transform="translate(0 236)">
+          <rect width="474" height="82" rx="14" fill="#101821" stroke="#2C3A48"/>
+          <rect width="5" height="82" rx="2.5" fill="#F2C879"/>
+          <text x="26" y="32" fill="#F4F7FA" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="18" font-weight="700">@session:
+          </text>
+          <text x="26" y="59" fill="#8B9AAD" font-size="16">历史补全 · 跨会话引用
+          </text>
+          <text x="431" y="40" fill="#F2C879" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="26">@
+          </text>
+        </g>
+      </g>
+    </svg>

package/extensions/README.md

@@ -0,0 +1,3 @@
+# Extensions
+
+扩展入口由根目录 `package.json` 的 `pi.extensions` 显式声明。辅助模块和测试文件不会被 Pi 当作独立扩展加载。