pi-resource-search 0.1.0 → 0.1.2

package/README.md

@@ -1,33 +1,61 @@
 # pi-resource-search
 
-Pi 扩展：在输入 `/关键词` 时搜索当前可用的命令、Skill、Extension 和已配置 Package。
+让 Pi 的 `/` 补全更容易找到资源。
 
-## 使用
+输入 `/关键词` 后，扩展会按名称、描述和资源类型进行模糊匹配，列出当前 Pi 已发现的相关命令、Skill、扩展和已配置包。
 
-安装或通过本地路径加载后，执行 `/reload`，在输入框中输入：
+## 示例
 
-- `/hand`：查找 handoff 等相关资源
+- `/hand`：查找 `handoff` 等相关资源
 - `/cache`：查找缓存相关资源
-- `/review`：查找审查相关资源
+- `/review`：查找代码审查相关资源
 
-选择 Skill 会插入 `/skill:名称`。Package 和 Extension 结果仅用于识别，不会自动安装或执行。
+选中结果后：
+
+- **Command**：插入并执行对应的 Pi 命令；
+- **Skill**：插入 `/skill:名称`，由 Pi 加载该 Skill；
+- **Extension**：仅显示扩展入口和所属包，不会伪装成可执行命令；
+- **Package**：仅显示已配置的 Pi 包，不会自动安装或修改配置。
+
+没有匹配结果时，Pi 会继续使用原生的 `/` 命令和路径补全。
+
+## 安装
+
+```bash
+pi install npm:pi-resource-search
+```
+
+安装后执行 `/reload`。如果扩展刚刚安装或更新，建议重新启动 Pi。
 
 ## 特点
 
-- 使用 Pi 原生 autocomplete provider，不修改 Pi 核心。
-- 仅读取配置、Package 清单和 Skill frontmatter。
-- 支持 Windows、macOS 和 Linux 的用户目录。
-- 不执行被扫描 Package 的代码，不写入 Skill 或 Package 文件。
+- 使用 Pi 原生 autocomplete API；
+- 支持 Windows、macOS 和 Linux；
+- 支持 `PI_CODING_AGENT_DIR` 自定义 Pi 配置目录；
+- 仅读取 Pi 配置、Package 清单和 Skill frontmatter；
+- 不执行被扫描包的代码；
+- 不修改 Skill、Package 或 Pi 配置文件；
+- 不要求安装 `pi-cn`，可独立工作。
 
-## 本地测试
+## 注意事项
+
+扩展搜索的是当前 Pi 已发现或已配置的资源，不是 npm 全网包搜索。新增 Skill 或 Package 后，执行 `/reload` 刷新索引。
+
+如果其他扩展也修改 `/` 补全，结果顺序可能受扩展加载顺序影响；本扩展会尽量保留 Pi 原生结果。
+
+## 本地开发
 
 ```bash
-pi -e .
 npm install
 npm run typecheck
 npm pack --dry-run
+pi -e .
 ```
 
 ## 兼容性
 
 需要 Pi `>=0.85.0`。
+
+## 许可证
+
+MIT

package/extensions/index.ts

@@ -3,7 +3,7 @@ import { homedir } from "node:os";
 import { join, resolve } from "node:path";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import {
-  fuzzyFilter,
+  fuzzyMatch,
   type AutocompleteItem,
   type AutocompleteProvider,
   type AutocompleteSuggestions,
@@ -123,6 +123,36 @@ function queryToken(text: string): string | undefined {
   return text.match(/(?:^|[ \t])\/([^\s/]*)$/)?.[1];
 }
 
+// 命中档位：名称前缀 > 名称子串 > 名称模糊 > 描述/类型模糊
+// 档位差固定 1000 分，保证名称命中永远排在描述命中前面
+const TIER_NAME_PREFIX = 0;
+const TIER_NAME_SUBSTRING = 1;
+const TIER_NAME_FUZZY = 2;
+const TIER_TEXT_FUZZY = 3;
+
+function scoreResource(resource: Resource, query: string): number | undefined {
+  const q = query.toLowerCase();
+  const name = resource.name.toLowerCase();
+  if (name.startsWith(q)) return TIER_NAME_PREFIX * 1000 + (name.length - q.length);
+  const index = name.indexOf(q);
+  if (index >= 0) return TIER_NAME_SUBSTRING * 1000 + index;
+  const nameMatch = fuzzyMatch(q, name);
+  if (nameMatch.matches) return TIER_NAME_FUZZY * 1000 + nameMatch.score;
+  const textMatch = fuzzyMatch(q, `${resource.description} ${resource.kind}`);
+  if (textMatch.matches) return TIER_TEXT_FUZZY * 1000 + textMatch.score;
+  return undefined;
+}
+
+export function rankResources(resources: Resource[], query: string): Resource[] {
+  const scored: { resource: Resource; score: number }[] = [];
+  for (const resource of resources) {
+    const score = scoreResource(resource, query);
+    if (score !== undefined) scored.push({ resource, score });
+  }
+  scored.sort((a, b) => a.score - b.score);
+  return scored.map((entry) => entry.resource);
+}
+
 function toItem(resource: Resource): AutocompleteItem {
   return { value: resource.value, label: `${resource.kind}  ${resource.name}`, description: resource.description };
 }
@@ -145,7 +175,7 @@ function createProvider(pi: ExtensionAPI, current: AutocompleteProvider, resourc
       }
 
       const all = [...commands, ...resources];
-      const matches = fuzzyFilter(all, query, (item) => `${item.name} ${item.description} ${item.kind}`).slice(0, MAX_RESULTS);
+      const matches = rankResources(all, query).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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-resource-search",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Search Pi commands, skills, extensions, and installed packages from /keyword autocomplete.",
   "keywords": [
     "pi-package",
@@ -10,6 +10,14 @@
     "autocomplete"
   ],
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hagertygodoy398-tech/pi-resource-search.git"
+  },
+  "bugs": {
+    "url": "https://github.com/hagertygodoy398-tech/pi-resource-search/issues"
+  },
+  "homepage": "https://github.com/hagertygodoy398-tech/pi-resource-search#readme",
   "type": "module",
   "files": [
     "extensions",