pi-resource-search 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pi-resource-search contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,33 @@
+# pi-resource-search
+
+Pi 扩展：在输入 `/关键词` 时搜索当前可用的命令、Skill、Extension 和已配置 Package。
+
+## 使用
+
+安装或通过本地路径加载后，执行 `/reload`，在输入框中输入：
+
+- `/hand`：查找 handoff 等相关资源
+- `/cache`：查找缓存相关资源
+- `/review`：查找审查相关资源
+
+选择 Skill 会插入 `/skill:名称`。Package 和 Extension 结果仅用于识别，不会自动安装或执行。
+
+## 特点
+
+- 使用 Pi 原生 autocomplete provider，不修改 Pi 核心。
+- 仅读取配置、Package 清单和 Skill frontmatter。
+- 支持 Windows、macOS 和 Linux 的用户目录。
+- 不执行被扫描 Package 的代码，不写入 Skill 或 Package 文件。
+
+## 本地测试
+
+```bash
+pi -e .
+npm install
+npm run typecheck
+npm pack --dry-run
+```
+
+## 兼容性
+
+需要 Pi `>=0.85.0`。

package/extensions/index.ts

@@ -0,0 +1,179 @@
+import { readFileSync, readdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import {
+  fuzzyFilter,
+  type AutocompleteItem,
+  type AutocompleteProvider,
+  type AutocompleteSuggestions,
+} from "@earendil-works/pi-tui";
+
+type Resource = {
+  kind: "Command" | "Skill" | "Extension" | "Package";
+  name: string;
+  description: string;
+  value: string;
+  executable: boolean;
+};
+
+const MAX_RESULTS = 30;
+const INFO_PREFIX = "__pi_resource_info__:";
+const agentDir = process.env.PI_CODING_AGENT_DIR || join(homedir(), ".pi", "agent");
+
+function readJson(path: string): any | undefined {
+  try {
+    return JSON.parse(readFileSync(path, "utf8"));
+  } catch {
+    return undefined;
+  }
+}
+
+function readSkill(path: string): Resource | undefined {
+  try {
+    const text = readFileSync(path, "utf8").replace(/^\uFEFF/, "");
+    const frontmatter = text.match(/^---\s*[\r\n]+([\s\S]*?)[\r\n]+---/m)?.[1];
+    if (!frontmatter) return undefined;
+    const name = frontmatter.match(/^name:\s*["']?([^"'\r\n]+)["']?\s*$/m)?.[1]?.trim();
+    const description = frontmatter.match(/^description:\s*["']?([^"'\r\n]+)["']?\s*$/m)?.[1]?.trim();
+    if (!name || !description) return undefined;
+    return { kind: "Skill", name, description, value: `/skill:${name}`, executable: true };
+  } catch {
+    return undefined;
+  }
+}
+
+function collectSkills(root: string, output: Resource[], seen: Set<string>): void {
+  let entries: Array<{ name: string; isDirectory: () => boolean }>;
+  try {
+    entries = readdirSync(root, { withFileTypes: true, encoding: "utf8" }) as unknown as Array<{
+      name: string;
+      isDirectory: () => boolean;
+    }>;
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    const path = join(root, entry.name);
+    if (entry.isDirectory()) {
+      if (!entry.name.startsWith(".")) collectSkills(path, output, seen);
+      continue;
+    }
+    if (entry.name !== "SKILL.md") continue;
+    const skill = readSkill(path);
+    if (skill && !seen.has(skill.name)) {
+      seen.add(skill.name);
+      output.push(skill);
+    }
+  }
+}
+
+function packageRoot(source: string): string | undefined {
+  if (source.startsWith("npm:")) {
+    const spec = source.slice(4).match(/^(@[^/]+\/[^@]+|[^@]+)/)?.[1];
+    return spec ? join(agentDir, "npm", "node_modules", spec) : undefined;
+  }
+  if (source.startsWith("git:") || source.startsWith("http:")) return undefined;
+  return resolve(agentDir, source.startsWith("file:") ? source.slice(5) : source);
+}
+
+function collectPackage(source: string, output: Resource[], seen: Set<string>): void {
+  const root = packageRoot(source);
+  if (!root) return;
+  const manifest = readJson(join(root, "package.json"));
+  if (!manifest?.name || seen.has(manifest.name)) return;
+  seen.add(manifest.name);
+  output.push({
+    kind: "Package",
+    name: manifest.name,
+    description: manifest.description || "已配置的 Pi 包（仅信息）",
+    value: `${INFO_PREFIX}package:${manifest.name}`,
+    executable: false,
+  });
+  const packageManifest = manifest.pi || manifest;
+  for (const extension of Array.isArray(packageManifest.extensions) ? packageManifest.extensions : []) {
+    const name = String(extension).replace(/^\.\//, "").replace(/\.(ts|js)$/, "");
+    output.push({
+      kind: "Extension",
+      name,
+      description: `${manifest.name} · 扩展资源（仅信息）`,
+      value: `${INFO_PREFIX}extension:${manifest.name}/${name}`,
+      executable: false,
+    });
+  }
+  for (const skillPath of Array.isArray(packageManifest.skills) ? packageManifest.skills : []) {
+    collectSkills(join(root, String(skillPath)), output, new Set<string>());
+  }
+}
+
+function loadResources(): Resource[] {
+  const resources: Resource[] = [];
+  collectSkills(join(agentDir, "skills"), resources, new Set<string>());
+  collectSkills(join(homedir(), ".agents", "skills"), resources, new Set<string>());
+  const settings = readJson(join(agentDir, "settings.json"));
+  const packages = Array.isArray(settings?.packages) ? settings.packages : [];
+  for (const entry of packages) {
+    const source = typeof entry === "string" ? entry : String(entry?.source || "");
+    collectPackage(source, resources, new Set<string>());
+  }
+  return resources;
+}
+
+function queryToken(text: string): string | undefined {
+  return text.match(/(?:^|[ \t])\/([^\s/]*)$/)?.[1];
+}
+
+function toItem(resource: Resource): AutocompleteItem {
+  return { value: resource.value, label: `${resource.kind}  ${resource.name}`, description: resource.description };
+}
+
+function createProvider(pi: ExtensionAPI, current: AutocompleteProvider, resources: Resource[]): AutocompleteProvider {
+  return {
+    triggerCharacters: ["/"],
+    async getSuggestions(lines, cursorLine, cursorCol, options): Promise<AutocompleteSuggestions | null> {
+      const before = (lines[cursorLine] || "").slice(0, cursorCol);
+      const query = queryToken(before);
+      if (query === undefined || query.length === 0) return current.getSuggestions(lines, cursorLine, cursorCol, options);
+
+      const commands: Resource[] = [];
+      try {
+        for (const command of pi.getCommands()) {
+          commands.push({ kind: "Command", name: command.name, description: command.description || "可执行命令", value: `/${command.name}`, executable: true });
+        }
+      } catch {
+        // 某些 Pi 运行模式不提供命令清单，仍保留 Skill/Package 搜索。
+      }
+
+      const all = [...commands, ...resources];
+      const matches = fuzzyFilter(all, query, (item) => `${item.name} ${item.description} ${item.kind}`).slice(0, MAX_RESULTS);
+      if (options.signal.aborted) return null;
+      const native = await current.getSuggestions(lines, cursorLine, cursorCol, options);
+      if (options.signal.aborted) return null;
+      const nativeItems = native?.items || [];
+      const seen = new Set(nativeItems.map((item) => item.value));
+      const extra = matches.filter((item) => !seen.has(item.value)).map(toItem);
+      return extra.length > 0 ? { items: [...extra, ...nativeItems].slice(0, MAX_RESULTS), prefix: `/${query}` } : native;
+    },
+    applyCompletion(lines, cursorLine, cursorCol, item, prefix) {
+      if (item.value.startsWith(INFO_PREFIX)) return { lines, cursorLine, cursorCol };
+      return current.applyCompletion(lines, cursorLine, cursorCol, item, prefix);
+    },
+    shouldTriggerFileCompletion: (lines, cursorLine, cursorCol) => current.shouldTriggerFileCompletion?.(lines, cursorLine, cursorCol) ?? true,
+  };
+}
+
+export default function (pi: ExtensionAPI): void {
+  let resources: Resource[] = [];
+  let providerInstalled = false;
+  pi.on("session_start", async () => {
+    resources = loadResources();
+    providerInstalled = false;
+  });
+  pi.on("resources_discover", async (_event, ctx) => {
+    resources = loadResources();
+    if (!providerInstalled) {
+      ctx.ui.addAutocompleteProvider((current) => createProvider(pi, current, resources));
+      providerInstalled = true;
+    }
+  });
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "pi-resource-search",
+  "version": "0.1.0",
+  "description": "Search Pi commands, skills, extensions, and installed packages from /keyword autocomplete.",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "extension",
+    "skills",
+    "autocomplete"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "extensions",
+    "README.md",
+    "LICENSE",
+    "tsconfig.json"
+  ],
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": ">=0.85.0",
+    "@earendil-works/pi-tui": ">=0.85.0"
+  },
+  "pi": {
+    "extensions": [
+      "./extensions/index.ts"
+    ]
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "install": "^0.13.0",
+    "typescript": "^7.0.2",
+    "typescriptnpm": "^1.0.1"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["extensions/**/*.ts"]
+}