vscode-delfiles-by-search 0.0.2

package/CONTRIBUTING.md

@@ -0,0 +1,162 @@
+# VSCode Delete Files By Search Results - Developer Guide
+
+本文档面向项目的开发者和贡献者，详细介绍了 `deletefiles-by-search` 项目的开发、调试、构建及部署流程。
+
+## 1. 项目简介
+
+`deletefiles-by-search` 是一个双模式工具，包含 VSCode 插件和 Node.js CLI 工具。它主要用于解析包含文件搜索结果的长字符串（如 VSCode 全局搜索结果），从中提取文件路径，并对这些文件执行指向性删除操作。
+
+核心特性包括：
+- **智能解析**：自动从复杂的搜索结果字符串中提取文件路径（支持 Windows/Unix 路径）。
+- **安全删除**：默认将文件移动到回收站（支持配置为永久删除）。
+- **双模式**：提供 VSCode 插件界面和命令行接口 (CLI)。
+- **模拟运行**：支持 Dry Run 模式，预览将要删除的文件而不实际执行。
+- **基准路径**：灵活配置基准路径，支持相对路径解析。
+- **忽略规则**：支持通过 glob 模式忽略特定文件或文件夹。
+- **交互式模式**：CLI 支持交互式补充参数，支持剪贴板内容读取，提供文件过滤确认步骤，提升用户体验。
+
+## 2. 环境准备
+
+在开始开发之前，请确保您的开发环境满足以下要求：
+
+- **Node.js**: 建议使用 LTS 版本 (v16.x 或更高)。
+- **npm**: Node.js 自带的包管理器。
+- **IDE**: 推荐使用 **Trae** (完全兼容 VSCode 插件开发) 或 VSCode。
+
+## 3. 本地开发调试步骤
+
+### 3.1 克隆项目与安装依赖
+
+```bash
+git clone <repository-url>
+cd vscode-delfiles-by-search
+npm install
+```
+
+### 3.2 CLI 工具调试
+
+在开发过程中，您不需要安装就可以直接运行 CLI 工具进行调试：
+
+**方式一：直接运行脚本**
+
+```bash
+# 查看帮助信息
+node ./bin/delfiles-cli.js --help
+
+# 运行交互式模式
+node ./bin/delfiles-cli.js
+```
+
+**方式二：本地链接 (npm link)**
+
+您可以将当前正在开发的包链接到全局环境，模拟发布后的使用体验：
+
+```bash
+# 1. 在项目根目录下执行链接命令
+npm link
+
+# 2. 现在可以在任何终端直接使用 delfiles 命令
+delfiles --help
+delfiles -s "path/to/file.js: ..."
+
+# 3. 调试完成后取消链接
+npm unlink -g
+```
+
+### 3.3 插件开发与调试 (Trae / VSCode)
+
+本项目完全兼容 Trae IDE，您可以像在 VSCode 中一样进行开发。
+
+1.  在 Trae 中打开项目根目录。
+2.  确保已安装项目依赖 (`npm install`)。
+3.  点击左侧活动栏的 **"运行和调试" (Run and Debug)** 图标 (或按下 `Shift+Cmd+D`)。
+4.  在顶部的调试配置下拉菜单中选择 **"Run Extension"**。
+5.  点击绿色的播放按钮 (或按下 `F5`) 开始调试。
+6.  Trae 将启动一个新的 **扩展开发主机 (Extension Development Host)** 窗口，在该窗口中插件已自动激活。
+
+**测试插件功能**：
+- **触发命令**：打开命令面板 (`Cmd+Shift+P` / `Ctrl+Shift+P`)，输入并执行 `Delete Files from Search Results`。
+- **选择输入源**：插件会弹出快速选择列表 (QuickPick)，您可以选择：
+    - `使用选中的文本` (仅当编辑器有选中内容时出现)
+    - `使用剪贴板内容` (仅当剪贴板有内容时出现，支持预览)
+    - `手动输入搜索结果` (进入输入框粘贴内容)
+- **文件过滤**：解析成功后，会弹出文件选择列表，您可以取消勾选不想删除的文件。
+- **确认删除**：确认文件列表后，会弹出最终确认框（支持删除或仅模拟运行）。
+
+> **注意**：如果您修改了 `src/extension/extension.js` 中的代码，可以在调试工具栏中点击 **"重启" (Restart)** 按钮 (绿色旋转箭头) 来重新加载扩展主机，无需关闭窗口。
+
+## 4. 构建与打包流程
+
+本项目目前主要作为源码发布。
+
+- **插件打包 (.vsix)**：
+  使用 `vsce` 工具打包成 `.vsix` 文件（需先全局安装 `npm install -g vsce`）。
+  ```bash
+  vsce package
+  ```
+
+- **CLI 发布准备**：
+  确保 `package.json` 中的 `bin` 字段指向正确的入口文件，并且入口文件具有可执行权限。
+
+## 5. 部署上线指南
+
+### 发布到扩展市场
+
+1.  更新 `package.json` 中的版本号。
+2.  确保 `CHANGELOG.md` (如果有) 已更新。
+3.  使用 `vsce publish` 命令发布到 Visual Studio Marketplace 或 Open VSX Registry。
+    - 需提前创建 Publisher 并获取 Personal Access Token。
+
+### 发布到 npm (CLI 工具)
+
+1.  **准备与检查**：
+    - 确保所有本地更改已提交到 Git。
+    - 运行测试和代码检查：`npm test` && `npm run lint`。
+    - 确保当前分支正确（通常是 `main` 或 `master`）。
+
+2.  **登录 npm**：
+    - 运行 `npm login` 并按提示完成登录。
+    - 验证登录状态：`npm whoami`。
+
+3.  **更新版本**：
+    - 推荐使用 `npm version` 命令更新版本号并自动创建 git tag：
+      ```bash
+      # 更新补丁版本 (例如 0.0.1 -> 0.0.2)
+      npm version patch
+      
+      # 或者更新次版本 (例如 0.0.1 -> 0.1.0)
+      # npm version minor
+      ```
+    - 或者手动修改 `package.json` 中的 `version` 字段。
+
+4.  **发布**：
+    - 运行发布命令：
+      ```bash
+      npm publish
+      ```
+    - 如果发布的是 scoped 包（例如 `@scope/package`），初次发布可能需要加上 `--access public`。
+
+5.  **验证**：
+    - 发布成功后，可以尝试全局安装最新版本进行验证：
+      ```bash
+      npm install -g vscode-delfiles-by-search@latest
+      delfiles --version
+      ```
+
+用户安装方式：
+```bash
+npm install -g vscode-delfiles-by-search
+```
+
+## 6. 常见问题排查
+
+**Q: 为什么 CLI 报错 "permission denied"？**
+A: 请检查 `./bin/delfiles-cli.js` 是否具有执行权限。可以运行 `chmod +x ./bin/delfiles-cli.js` 修复。
+
+**Q: 插件无法解析文件路径？**
+A: 请确保输入的文本格式符合预期，通常应包含 `path/to/file.ext:` 格式。您可以在 `src/core/parser.js` 中查看具体的正则匹配逻辑。
+
+**Q: 误删了文件怎么办？**
+A: 默认情况下 (`moveToTrash: true`)，文件会被移动到系统回收站。如果使用了 `--no-trash` 参数或配置，文件将被永久删除，无法恢复。
+
+## 7. 目录结构说明

package/LICENSE

@@ -0,0 +1,20 @@
+Proprietary License
+
+Copyright (c) 2024 guifengxiao
+
+All rights reserved.
+
+1.  **Usage Rights**:
+    You are granted a non-exclusive, non-transferable license to install and use this software extension ("Software") solely for personal or internal business purposes within the Visual Studio Code, Trae, or compatible editor environments.
+
+2.  **Restrictions**:
+    -   You may NOT modify, reverse engineer, decompile, or disassemble the Software.
+    -   You may NOT redistribute, sublicense, rent, lease, or sell the Software or any part of it.
+    -   You may NOT create derivative works based on the Software.
+    -   You may NOT remove or alter any copyright, trademark, or other proprietary notices.
+
+3.  **No Warranty**:
+    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.
+
+4.  **Termination**:
+    This license is effective until terminated. Your rights under this license will terminate automatically without notice if you fail to comply with any of its terms. Upon termination, you must cease all use of the Software and destroy all copies.

package/PUBLISHING.md

@@ -0,0 +1,110 @@
+
+# 多平台插件发布操作指南
+
+本文档提供了将 `deletefiles-by-search` 插件发布到 **Trae**、**VS Code** 和 **Cursor** 插件市场的详细操作步骤。
+
+---
+
+## 1. 发布前准备
+
+在发布到任何平台之前，请确保完成以下检查：npm install -g @vscode/vsce
+
+1.  **更新版本号**：在 `package.json` 中增加版本号（例如从 `0.0.1` 到 `0.0.4`）。
+2.  **更新文档**：确保 `README.md` 和 `USAGE.md` 是最新的。
+3.  **安装打包工具**：
+    ```bash
+    npm install -g @vscode/vsce
+    ```
+4.  **构建并验证**：
+    在本地打包 `.vsix` 文件进行最终测试。
+    ```bash
+    vsce package
+    # 生成文件示例: vscode-delfiles-by-search-0.0.4.vsix
+    ```
+
+---
+
+## 2. 发布到 VS Code Marketplace (Visual Studio Code)
+
+VS Code 插件市场是目前最大的插件分发平台。
+
+### 步骤
+
+1.  **创建账号**：
+    *   访问 [Marketplace Management Portal](https://marketplace.visualstudio.com/manage)。
+    *   使用 Microsoft 账号登录。
+2.  **创建 Publisher (发布者)**：
+    *   如果还没有发布者账号，请创建一个。发布者 ID 需要与 `package.json` 中的 `publisher` 字段一致（当前为 `guifengxiao`）。
+3.  **获取 Access Token**：
+    *   访问 [Azure DevOps](https://dev.azure.com/)。
+    *   进入 User Settings -> Personal Access Tokens。
+    *   创建一个新的 Token，Organization 选择 "All accessible organizations"，Scope 选择 "Marketplace -> Manage"。
+4.  **命令行发布**：
+    ```bash
+    vsce login guifengxiao
+    # 输入上一步获取的 Access Token
+    
+    vsce publish
+    ```
+5.  **手动上传（可选）**：
+    *   如果在命令行遇到网络问题，可以在 Marketplace Portal 页面点击 "New Extension" -> "Visual Studio Code"，上传本地生成的 `.vsix` 文件。
+
+---
+
+## 3. 发布到 Trae 插件市场
+
+Trae 是字节跳动推出的新一代 IDE，完全兼容 VS Code 插件生态。
+
+### 步骤
+
+1.  **准备 .vsix 文件**：
+    使用前文生成的 `.vsix` 文件。Trae 直接支持标准 VS Code 插件格式。
+2.  **提交审核**：
+    *   由于 Trae 市场目前可能尚未完全自助开放，通常有两种方式：
+        *   **官方收录**：Trae 会定期从 Open VSX 或 VS Code Marketplace 同步热门插件。
+        *   **手动提交**：请访问 Trae 开发者中心（或通过 Trae IDE 内的反馈渠道），提交您的 `.vsix` 文件或 Marketplace 链接进行审核。
+3.  **本地安装测试**：
+    *   在 Trae 中，打开扩展面板 -> 点击右上角 "..." -> "从 VSIX 安装..."。
+    *   选择生成的 `.vsix` 文件，验证功能是否正常。
+
+---
+
+## 4. 发布到 Open VSX Registry (Cursor / Gitpod)
+
+Cursor 和 Gitpod 等基于开源 VS Code 的 IDE 通常使用 Open VSX Registry 作为插件源。
+
+### 步骤
+
+1.  **创建账号**：
+    *   访问 [Open VSX Registry](https://open-vsx.org/)。
+    *   使用 GitHub 账号登录。
+2.  **创建 Namespace**：
+    *   进入 Settings -> Namespaces。
+    *   创建一个与 `package.json` 中 `publisher` 一致的 Namespace (`guifengxiao`)。
+    *   *注意：如果该 Namespace 已被占用，您可能需要修改 `package.json` 中的 publisher 并重新打包。*
+3.  **获取 Access Token**：
+    *   在 Settings -> Access Tokens 中生成一个新的 Token。
+4.  **安装发布工具**：
+    ```bash
+    npm install -g ovsx
+    ```
+5.  **发布**：
+    ```bash
+    ovsx publish vscode-delfiles-by-search-0.0.4.vsix -p <YOUR_ACCESS_TOKEN>
+    ```
+6.  **Cursor 验证**：
+    *   发布成功后，Cursor 用户通常可以在几个小时内通过插件市场搜索到该插件。
+    *   您也可以直接将 `.vsix` 文件拖入 Cursor 窗口进行手动安装。
+
+---
+
+## 5. 常见问题 (FAQ)
+
+**Q: `vsce package` 报错 "Make sure to edit the README.md file"？**
+A: `vsce` 会检查 README 是否包含默认模板内容。请确保已移除所有生成的默认文本。
+
+**Q: Cursor 搜不到我的插件？**
+A: Cursor 主要依赖 Open VSX。确保您已成功发布到 Open VSX。如果是刚刚发布，可能需要等待索引更新。
+
+**Q: 发布后发现 Bug 怎么办？**
+A: 修复代码 -> 更新 `package.json` 版本号 -> 重新打包 -> 再次执行发布命令。市场会自动推送更新给用户。

package/README.md

@@ -0,0 +1,183 @@
+
+[English Version](#english-readme) | [中文文档](#chinese-readme)
+
+<a id="english-readme"></a>
+# Delete Files from Search Results
+
+An efficient dual-mode tool (VSCode Extension + CLI) designed for batch file deletion. It intelligently parses various search result texts (e.g., VSCode global search, grep output) to extract file paths and provides safe batch deletion capabilities.
+
+## 📦 Installation
+
+### VS Code Extension
+Search for `Delete Files from Search Results` in the VS Code Marketplace and install it.
+
+### CLI Tool
+You can also use it as a command-line tool via npm:
+```bash
+npm install -g vscode-delfiles-by-search
+```
+
+## 🚀 VS Code Extension Usage
+
+### Quick Start
+1.  **Prepare Data**: Get text containing file paths.
+    *   *Scenario A*: Right-click in VSCode global search results -> "Copy All".
+    *   *Scenario B*: Directly select a text block containing paths in the editor.
+    *   *Scenario C*: Copy any external text containing file paths.
+
+2.  **Execute Command**:
+    *   Open Command Palette (`Cmd+Shift+P` or `Ctrl+Shift+P`).
+    *   Type `Delete Files from Search Results` and press Enter.
+
+3.  **Interaction Flow**:
+    *   **Select Source**: The plugin automatically detects your context and pops up a QuickPick menu.
+        *   `Use Selected Text`: Recommended.
+        *   `Use Clipboard Content`: Supports preview for confirmation.
+        *   `Manual Input`: Paste manually if the above options don't fit.
+        *   `Regex Search` (New): Directly input regex to scan and delete matching files in the project.
+    *   **Filter Files**: After parsing, a list of files to be deleted will be shown. You can **uncheck** files you don't want to delete.
+    *   **Final Confirmation**: Select "Confirm Delete" to execute, or "Dry Run" to preview.
+
+## 💻 CLI Usage
+
+The CLI tool offers a powerful interactive mode for terminal users.
+
+```bash
+# Interactive Mode (Recommended)
+delfiles
+
+# Parse from string
+delfiles -s "path/to/file.js: ..."
+
+# Dry Run (Simulation)
+delfiles --dry-run
+```
+
+### Features
+*   **Interactive Mode**: Guides you through input selection (Clipboard/Manual/Regex).
+*   **Clipboard Support**: Directly read from system clipboard.
+*   **Safety**: Defaults to moving files to trash (configurable).
+
+## ⚙️ Configuration (VS Code)
+
+You can configure `delfiles` in VSCode Settings:
+
+*   `delfiles.basePath`: Base directory for relative paths. Defaults to `${workspaceFolder}`.
+*   `delfiles.moveToTrash`: Deletion method. Defaults to `true` (move to trash), set to `false` for permanent deletion (Use with caution!).
+*   `delfiles.ignorePatterns`: Global ignore rules. Supports Glob pattern arrays, e.g., `["node_modules/**", "*.test.js"]`.
+
+## 🛡️ Safety Features
+
+*   **Default Trash**: Files are moved to the system trash by default to prevent accidental deletion.
+*   **Dry Run**: Supports Dry Run mode to preview before execution.
+*   **Smart Filtering**: Automatically excludes code lines and comments, accurately identifying file paths.
+*   **Interactive Confirmation**: Double assurance via file list confirmation and final popup confirmation.
+
+## 📝 FAQ
+
+**Q: Cannot parse file paths?**
+A: The plugin supports various path formats (e.g., `path/to/file.js` or `path/to/file.js:`). Ensure the text contains clear file path characteristics.
+
+**Q: Files still exist after deletion?**
+A: Check the Output panel (`View -> Output -> Delete Files`) for detailed logs. It might be a permission issue or the file is in use.
+
+## 📄 License
+
+This project is licensed under the [Proprietary License](https://gitee.com/xiaogf/plugin-delfiles/blob/master/LICENSE).
+
+---
+
+<a id="chinese-readme"></a>
+# Delete Files from Search Results - 使用说明
+
+这是一个高效的双模式工具（VSCode 插件 + CLI），专为批量删除文件而设计。它能智能解析各种搜索结果文本（如 VSCode 全局搜索、grep 输出等），从中提取文件路径，并提供安全的批量删除功能。
+
+## 📦 安装指南
+
+### VS Code 插件
+在 VS Code 扩展市场搜索 `Delete Files from Search Results` 并安装。
+
+### CLI 命令行工具
+您也可以通过 npm 安装为全局命令行工具：
+```bash
+npm install -g vscode-delfiles-by-search
+```
+
+## 🚀 VS Code 插件使用
+
+### 快速开始
+1.  **准备数据**：获取包含文件路径的文本。
+    *   *场景 A*：在 VSCode 全局搜索结果中右键 -> "Copy All"。
+    *   *场景 B*：直接选中编辑器中的一段包含路径的文本。
+    *   *场景 C*：复制任何包含文件路径的外部文本。
+
+2.  **执行命令**：
+    *   打开命令面板 (`Cmd+Shift+P` 或 `Ctrl+Shift+P`)。
+    *   输入 `Delete Files from Search Results` 并回车。
+
+3.  **交互流程**：
+    *   **选择来源**：插件会自动检测您的上下文，弹出一个快速选择菜单 (QuickPick)。
+        *   `使用选中的文本`：优先推荐。
+        *   `使用剪贴板内容`：支持预览，方便确认。
+        *   `手动输入`：如果前两者都不符合，可手动粘贴。
+        *   `独立正则搜索` (新增)：直接输入正则表达式，插件会自动扫描项目中内容匹配的文件。
+    *   **过滤文件**：解析成功后，会列出所有待删除文件。您可以**取消勾选**那些不想删除的文件。
+    *   **最终确认**：选择“确定删除”执行操作，或选择“仅模拟运行 (Dry Run)”查看预览。
+
+## 💻 CLI 命令行使用
+
+CLI 工具为终端用户提供了强大的交互式体验。
+
+```bash
+# 进入交互模式 (推荐)
+delfiles
+
+# 直接解析字符串
+delfiles -s "path/to/file.js: ..."
+
+# 模拟运行 (Dry Run)
+delfiles --dry-run
+```
+
+### 核心特性
+*   **交互式模式**：引导式选择输入源（剪贴板/手动输入/正则搜索）。
+*   **剪贴板支持**：直接读取系统剪贴板内容。
+*   **安全删除**：默认将文件移动到回收站（可配置）。
+
+## ⚙️ 配置选项 (VS Code)
+
+您可以在 VSCode 设置中搜索 `delfiles` 进行配置：
+
+*   `delfiles.basePath`: 相对路径的基准目录。默认为 `${workspaceFolder}`（当前工作区根目录）。
+*   `delfiles.moveToTrash`: 删除方式。默认为 `true`（移动到回收站），设为 `false` 则永久删除（慎用！）。
+*   `delfiles.ignorePatterns`: 全局忽略规则。支持 Glob 模式数组，例如 `["node_modules/**", "*.test.js"]`。
+
+## 🛡️ 安全特性
+
+*   **默认回收站**：文件默认被移动到系统回收站，防止误删。
+*   **模拟运行**：支持 Dry Run 模式，先预览后执行。
+*   **智能过滤**：自动排除代码行、注释行，精准识别文件路径。
+*   **交互确认**：必须经过文件列表确认和最终弹窗确认双重保障。
+
+## 📝 常见问题
+
+**Q: 解析不到文件？**
+A: 插件支持多种路径格式（如 `path/to/file.js` 或 `path/to/file.js:`）。请确保文本中包含清晰的文件路径特征。
+
+**Q: 即使我勾选了删除，文件还在？**
+A: 请检查输出面板 (`View -> Output -> Delete Files`) 查看详细日志，可能是权限问题或文件被占用。
+
+## 📄 许可证
+
+本项目采用 [Proprietary License](https://gitee.com/xiaogf/plugin-delfiles/blob/master/LICENSE) 许可证。
+
+- 支持 `.gitignore` 风格的持久化忽略规则。
+- 完善了开发者文档和测试用例。
+
+### v0.0.1 (Initial Release)
+- 实现了核心的字符串解析逻辑。
+- 实现了基于 `trash` 的安全删除功能。
+- 提供了基本的 VSCode 插件命令。
+- 提供了基本的 CLI 工具。
+- 支持 `--dry-run` 模式。
+- 支持 `--ignore` 参数和交互式 CLI 模式。

package/USAGE.md

@@ -0,0 +1,47 @@
+
+# Delete Files from Search Results - 使用说明
+
+这是一个高效的 VSCode 插件，专为批量删除文件而设计。它能智能解析各种搜索结果文本（如 VSCode 全局搜索、grep 输出等），从中提取文件路径，并提供安全的批量删除功能。
+
+## 🚀 快速开始
+
+1.  **准备数据**：获取包含文件路径的文本。
+    *   *场景 A*：在 VSCode 全局搜索结果中右键 -> "Copy All"。
+    *   *场景 B*：直接选中编辑器中的一段包含路径的文本。
+    *   *场景 C*：复制任何包含文件路径的外部文本。
+
+2.  **执行命令**：
+    *   打开命令面板 (`Cmd+Shift+P` 或 `Ctrl+Shift+P`)。
+    *   输入 `Delete Files from Search Results` 并回车。
+
+3.  **交互流程**：
+    *   **选择来源**：插件会自动检测您的上下文，弹出一个快速选择菜单 (QuickPick)。
+        *   `使用选中的文本`：优先推荐。
+        *   `使用剪贴板内容`：支持预览，方便确认。
+        *   `手动输入`：如果前两者都不符合，可手动粘贴。
+        *   `独立正则搜索` (新增)：直接输入正则表达式，插件会自动扫描项目中内容匹配的文件。
+    *   **过滤文件**：解析成功后，会列出所有待删除文件。您可以**取消勾选**那些不想删除的文件。
+    *   **最终确认**：选择“确定删除”执行操作，或选择“仅模拟运行 (Dry Run)”查看预览。
+
+## ⚙️ 配置选项
+
+您可以在 VSCode 设置中搜索 `delfiles` 进行配置：
+
+*   `delfiles.basePath`: 相对路径的基准目录。默认为 `${workspaceFolder}`（当前工作区根目录）。
+*   `delfiles.moveToTrash`: 删除方式。默认为 `true`（移动到回收站），设为 `false` 则永久删除（慎用！）。
+*   `delfiles.ignorePatterns`: 全局忽略规则。支持 Glob 模式数组，例如 `["node_modules/**", "*.test.js"]`。
+
+## 🛡️ 安全特性
+
+*   **默认回收站**：文件默认被移动到系统回收站，防止误删。
+*   **模拟运行**：支持 Dry Run 模式，先预览后执行。
+*   **智能过滤**：自动排除代码行、注释行，精准识别文件路径。
+*   **交互确认**：必须经过文件列表确认和最终弹窗确认双重保障。
+
+## 📝 常见问题
+
+**Q: 解析不到文件？**
+A: 插件支持多种路径格式（如 `path/to/file.js` 或 `path/to/file.js:`）。请确保文本中包含清晰的文件路径特征。
+
+**Q: 即使我勾选了删除，文件还在？**
+A: 请检查输出面板 (`View -> Output -> Delete Files`) 查看详细日志，可能是权限问题或文件被占用。

package/bin/delfiles-cli.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+const { program } = require('../src/cli/index.js');
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "vscode-delfiles-by-search",
+  "displayName": "Delete Files from Search Results",
+  "description": "Parse search results string and delete corresponding files safely.",
+  "license": "MIT",
+  "version": "0.0.2",
+  "publisher": "guifengxiao",
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/xiaogf/plugin-delfiles.git"
+  },
+  "engines": {
+    "vscode": "^1.74.0"
+  },
+  "categories": [
+    "Other"
+  ],
+  "activationEvents": [
+    "onCommand:delfiles.parseAndDelete"
+  ],
+  "main": "./src/extension/extension.js",
+  "contributes": {
+    "commands": [
+      {
+        "command": "delfiles.parseAndDelete",
+        "title": "Delete Files from Search Results"
+      }
+    ],
+    "configuration": {
+      "title": "Delete Files from Search Results",
+      "properties": {
+        "delfiles.basePath": {
+          "type": "string",
+          "default": "${workspaceFolder}",
+          "description": "Base path for relative file paths in search results."
+        },
+        "delfiles.moveToTrash": {
+          "type": "boolean",
+          "default": true,
+          "description": "Move files to trash instead of permanent deletion."
+        },
+        "delfiles.ignorePatterns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [],
+          "description": "Array of glob patterns to ignore during deletion (e.g., ['node_modules/**', '**/*.test.js'])."
+        }
+      }
+    }
+  },
+  "scripts": {
+    "test": "mocha test/**/*.test.js",
+    "lint": "eslint ."
+  },
+  "bin": {
+    "delfiles": "bin/delfiles-cli.js"
+  },
+  "devDependencies": {
+    "@types/glob": "^8.0.0",
+    "@types/mocha": "^10.0.1",
+    "@types/node": "16.x",
+    "@types/vscode": "^1.74.0",
+    "@vscode/test-electron": "^2.2.0",
+    "eslint": "^8.28.0",
+    "glob": "^8.1.0",
+    "mocha": "^10.1.0",
+    "typescript": "^4.9.3"
+  },
+  "dependencies": {
+    "clipboardy": "^2.3.0",
+    "commander": "^10.0.0",
+    "ignore": "^7.0.5",
+    "inquirer": "^8.2.7",
+    "minimatch": "^5.1.6",
+    "sinon": "^21.0.1",
+    "trash": "^8.1.0"
+  }
+}