pi-cc-extensions 0.7.5 → 0.7.7

package/README.md

@@ -3,8 +3,8 @@
 </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.5.6" src="https://img.shields.io/badge/version-0.5.6-66E3C4?style=flat-square"></a>
+  <a href="https://pi.dev/packages?name=pi-cc-extensions"><img alt="Pi package catalog" src="https://img.shields.io/badge/Pi-package-58B7FF?style=flat-square"></a>
+  <a href="https://www.npmjs.com/package/pi-cc-extensions"><img alt="npm version" src="https://img.shields.io/npm/v/pi-cc-extensions?style=flat-square&color=66E3C4"></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>
@@ -54,7 +54,7 @@
 - Pi 默认输入栏
 - Edit / Write 的 Diff 预览
 - 工具结果的折叠与展开
-- `/ccstyle` 配置命令和 `Ctrl+Shift+O` 快捷键
+- 类 claude code 滚动到底部 button
 
 常用命令：
 
@@ -79,13 +79,13 @@
 
 ### 历史 Session 引用
 
-`extensions/session-reference/index.ts` 将历史 Session 接入 `@` 补全：
+`extensions/session-reference.ts` 将历史 Session 接入 `@` 补全：
 
 1. 在提示词中输入 `@`。
 2. 从 `[Session] ...` 或 `[SubAgent] ...` 补全项中选择要引用的上下文。
 3. 提交时以 `@session:<session-id>` 引用其当前有效上下文。
 
-Session 模糊查询默认显示 3 个候选，并与文件候选按 1:2 交错排列；路径型查询优先显示文件。若已加载 `pi-subagents`，也可直接引用现有 SubAgent。一次提示词可以引用多个 Session；扩展会自动去重，并限制注入规模以避免上下文无限膨胀。更多细节见 [`extensions/session-reference/README.md`](./extensions/session-reference/README.md)。
+Session 模糊查询默认显示 3 个候选，并与文件候选按 1:2 交错排列；路径型查询优先显示文件。若已加载 `pi-subagents`，也可直接引用现有 SubAgent。一次提示词可以引用多个 Session；扩展会自动去重，并限制注入规模以避免上下文无限膨胀。
 
 ### SubAgent `@` 补全
 

package/extensions/context.ts

@@ -46,7 +46,7 @@ export function createWrappedTextCache(content: string): {
 
 export async function showTextPreview(ctx: Pick<ExtensionCommandContext, "ui">, title: string, rawContent: string): Promise<void> {
   const content = normalizePreviewText(rawContent);
-  await ctx.ui.custom<void>((tui, theme, _keybindings, done) => {
+  await ctx.ui.custom((tui, theme, _keybindings, done) => {
     let scrollOffset = 0;
     let pageSize = 1;
     let totalLines = 1;
@@ -63,7 +63,7 @@ export async function showTextPreview(ctx: Pick<ExtensionCommandContext, "ui">,
       },
       handleInput(data: string) {
         if (matchesKey(data, Key.escape) || matchesKey(data, Key.ctrl("c"))) {
-          done();
+          done(undefined);
           return;
         }
         if (matchesKey(data, Key.up)) scrollTo(scrollOffset - 1);
@@ -161,6 +161,12 @@ const tokenEstimate = (value: unknown): number => {
   return Math.max(0, Math.ceil(text.length / 4));
 };
 
+type ToolPreviewInfo = {
+  name: string;
+  description?: string;
+  promptGuidelines?: string[];
+};
+
 export function scaleParts(parts: ContextPart[], target: number): ContextPart[] {
   const estimated = parts.reduce((sum, part) => sum + part.tokens, 0);
   if (estimated === 0 || target <= 0) return parts;
@@ -233,7 +239,9 @@ export default function contextUsageExtension(pi: ExtensionAPI) {
       }
 
       const options = ctx.getSystemPromptOptions();
-      const toolByName = new Map(pi.getAllTools().map((tool) => [tool.name, tool]));
+      const toolByName = new Map<string, ToolPreviewInfo>(
+        (pi.getAllTools() as ToolPreviewInfo[]).map((tool) => [tool.name, tool] as const),
+      );
       const toolContent = (options.selectedTools ?? []).map((name) => {
         const tool = toolByName.get(name);
         const lines = [`## ${name}`];
@@ -273,7 +281,7 @@ export default function contextUsageExtension(pi: ExtensionAPI) {
       let selectedPreviewIndex = 0;
 
       while (true) {
-        const action = await ctx.ui.custom<PreviewKey | undefined>((tui, theme, _keybindings, done) => {
+        const action = await ctx.ui.custom((tui, theme, _keybindings, done) => {
           let previewHitboxes: Array<{ key: PreviewKey; row: number; startCol: number; endCol: number }> = [];
 
           const padLine = (text: string, width: number): string => {

package/extensions/{session-reference/index.ts → session-reference.ts}

@@ -20,7 +20,7 @@ import {
 	sessionTitle,
 	type ReferenceSessionInfo,
 	type ReferenceSource,
-} from "./core.ts";
+} from "./session-reference-core.ts";
 
 const MAX_SESSION_SUGGESTIONS = 3;
 const MAX_FILE_SUGGESTIONS = 7;

package/package.json

@@ -1,12 +1,22 @@
 {
   "name": "pi-cc-extensions",
-  "version": "0.7.5",
-  "description": "Personal extensions for the Pi coding agent",
+  "version": "0.7.7",
+  "description": "Claude Code-style UI, context insights, and session references for the Pi coding agent",
   "type": "module",
   "keywords": [
     "pi-package",
-    "pi-extension"
+    "pi-extension",
+    "pi-coding-agent",
+    "claude-code"
   ],
+  "homepage": "https://github.com/minuque/pi-cc-extensions#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/minuque/pi-cc-extensions.git"
+  },
+  "bugs": {
+    "url": "https://github.com/minuque/pi-cc-extensions/issues"
+  },
   "files": [
     "extensions",
     "assets/readme",
@@ -16,9 +26,10 @@
     "extensions": [
       "./extensions/claude-code-style.ts",
       "./extensions/context.ts",
-      "./extensions/session-reference/index.ts",
+      "./extensions/session-reference.ts",
       "./extensions/agent-autocomplete.ts"
-    ]
+    ],
+    "image": "https://raw.githubusercontent.com/minuque/pi-cc-extensions/main/assets/readme/fixed-editor-navigation.webp"
   },
   "scripts": {
     "test": "node --test tests/**/*.test.ts",

package/extensions/README.md

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

package/extensions/session-reference/README.md

@@ -1,28 +0,0 @@
-# Session Reference
-
-在 pi 编辑器中输入 `@`，从统一补全列表选择 `[Session] ...`，即可把历史 Session 绑定为：
-
-```text
-@session:<session-id>
-```
-
-提交 prompt 时，扩展读取该 Session 当前有效分支（遵循分支与 compaction），以自定义上下文消息注入当前 Session。历史内容被标记为不可信背景上下文，不会切换或合并 Session。
-
-## 行为
-
-- 搜索全部 pi 历史 Session；当前 Workspace 的 Session 优先。
-- Session 模糊查询默认最多显示 3 个候选。
-- 与 pi 原有 `@` 文件补全并存：普通查询按 1:2 交错排列 Session 与文件，路径型查询优先显示文件。
-- 若已加载 `pi-subagents`，`@` 补全会同时显示现有 SubAgent，并引用其当前有效上下文。
-- 支持一个 prompt 引用多个 Session，并自动去重；单次最多注入前 5 个。
-- 跳过历史 Session 中嵌套的 Session 引用，避免递归膨胀。
-- 上下文限制：单条消息 8 KB、单 Session 24 KB、总计 48 KB；超限保留开头和结尾。
-- 选择后仅插入引用标记；真正读取和注入发生在提交 prompt 时。
-
-项目扩展可通过 `/reload` 热重载。
-
-## 验证
-
-```bash
-node --test .pi/extensions/session-reference/core.test.ts
-```