pi-resource-search 0.1.0 → 0.1.1

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-resource-search",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Search Pi commands, skills, extensions, and installed packages from /keyword autocomplete.",
   "keywords": [
     "pi-package",