English Version | 中文文档 | Español | العربية | 日本語

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:

npm install -g 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.

# 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).
• Regex Search: In interactive mode, select "Manual Input Keyword" to search for files by regex content.
• 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.

Delete Files From Search Results - 使用说明

这是一个高效的双模式工具（VSCode 插件 + CLI），专为批量删除文件而设计。它能智能解析各种搜索结果文本（如 VSCode 全局搜索、grep 输出等），从中提取文件路径，并提供安全的批量删除功能。

📦 安装指南

VS Code 插件

在 VS Code 扩展市场搜索 Delete Files From Search Results 并安装。

CLI 命令行工具

您也可以通过 npm 安装为全局命令行工具：

npm install -g 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 工具为终端用户提供了强大的交互式体验。

# 进入交互模式 (推荐)
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 许可证。

Delete Files From Search Results - Versión en español

Una herramienta eficiente de modo dual (Extensión VSCode + CLI) diseñada para la eliminación de archivos por lotes. Analiza inteligentemente varios textos de resultados de búsqueda (por ejemplo, búsqueda global de VSCode, salida de grep) para extraer rutas de archivos y proporciona capacidades seguras de eliminación por lotes.

📦 Instalación

Extensión de VS Code

Busque Delete Files From Search Results en el VS Code Marketplace e instálelo.

Herramienta CLI

También puede usarla como una herramienta de línea de comandos a través de npm:

npm install -g delfiles-by-search

🚀 Uso de la Extensión de VS Code

Inicio Rápido

1. Preparar Datos: Obtenga texto que contenga rutas de archivos.

   • Escenario A: Haga clic derecho en los resultados de búsqueda global de VSCode -> "Copy All" (Copiar todo).
   • Escenario B: Seleccione directamente un bloque de texto que contenga rutas en el editor.
   • Escenario C: Copie cualquier texto externo que contenga rutas de archivos.

2. Ejecutar Comando:

   • Abra la Paleta de Comandos (Cmd+Shift+P o Ctrl+Shift+P).
   • Escriba Delete Files From Search Results y presione Enter.

3. Flujo de Interacción:

   • Seleccionar Fuente: El complemento detecta automáticamente su contexto y muestra un menú de selección rápida (QuickPick).
     • Use Selected Text (Usar texto seleccionado): Recomendado.
     • Use Clipboard Content (Usar contenido del portapapeles): Admite vista previa para confirmación.
     • Manual Input (Entrada manual): Pegue manualmente si las opciones anteriores no se ajustan.
     • Regex Search (Búsqueda por Regex) (Nuevo): Ingrese directamente una expresión regular para escanear y eliminar archivos coincidentes en el proyecto.
   • Filtrar Archivos: Después del análisis, se mostrará una lista de archivos para eliminar. Puede desmarcar los archivos que no desea eliminar.
   • Confirmación Final: Seleccione "Confirm Delete" (Confirmar eliminación) para ejecutar, o "Dry Run" (Ejecución simulada) para previsualizar.

💻 Uso de CLI

La herramienta CLI ofrece un potente modo interactivo para usuarios de terminal.

# Modo Interactivo (Recomendado)
delfiles

# Analizar desde cadena
delfiles -s "path/to/file.js: ..."

# Dry Run (Simulación)
delfiles --dry-run

Características

• Modo Interactivo: Lo guía a través de la selección de entrada (Portapapeles/Manual/Regex).
• Búsqueda por Regex: En el modo interactivo, seleccione "Manual Input Keyword" para buscar archivos por contenido regex.
• Soporte de Portapapeles: Lee directamente del portapapeles del sistema.
• Seguridad: Por defecto mueve los archivos a la papelera (configurable).

⚙️ Configuración (VS Code)

Puede configurar delfiles en la configuración de VSCode:

• delfiles.basePath: Directorio base para rutas relativas. Por defecto es ${workspaceFolder}.
• delfiles.moveToTrash: Método de eliminación. Por defecto es true (mover a la papelera), establezca en false para eliminación permanente (¡Úselo con precaución!).
• delfiles.ignorePatterns: Reglas de ignorar globales. Admite matrices de patrones Glob, por ejemplo, ["node_modules/**", "*.test.js"].

🛡️ Características de Seguridad

• Papelera por Defecto: Los archivos se mueven a la papelera del sistema por defecto para evitar la eliminación accidental.
• Dry Run: Admite el modo Dry Run para previsualizar antes de la ejecución.
• Filtrado Inteligente: Excluye automáticamente líneas de código y comentarios, identificando con precisión las rutas de archivos.
• Confirmación Interactiva: Doble garantía a través de la confirmación de la lista de archivos y la confirmación final emergente.

📝 Preguntas Frecuentes (FAQ)

P: ¿No puede analizar las rutas de los archivos? R: El complemento admite varios formatos de ruta (por ejemplo, path/to/file.js o path/to/file.js:). Asegúrese de que el texto contenga características claras de ruta de archivo.

P: ¿Los archivos aún existen después de la eliminación? R: Verifique el panel de Salida (View -> Output -> Delete Files) para ver registros detallados. Podría ser un problema de permisos o que el archivo esté en uso.

📄 Licencia

Este proyecto está licenciado bajo la Licencia Propietaria.

حذف الملفات من نتائج البحث - النسخة العربية

أداة فعالة مزدوجة الوضع (امتداد VSCode + واجهة سطر الأوامر) مصممة لحذف الملفات دفعة واحدة. تقوم بتحليل نصوص نتائج البحث المختلفة بذكاء (مثل نتائج البحث الشامل في VSCode، ومخرجات grep) لاستخراج مسارات الملفات وتوفير إمكانيات حذف آمنة للملفات دفعة واحدة.

📦 التثبيت

امتداد VS Code

ابحث عن Delete Files From Search Results في متجر VS Code وقم بتثبيته.

أداة واجهة سطر الأوامر (CLI)

يمكنك أيضًا استخدامها كأداة سطر أوامر عبر npm:

npm install -g delfiles-by-search

🚀 استخدام امتداد VS Code

البدء السريع

1. تجهيز البيانات: احصل على نص يحتوي على مسارات الملفات.

   • السيناريو أ: انقر بزر الماوس الأيمن في نتائج البحث الشامل في VSCode -> "Copy All" (نسخ الكل).
   • السيناريو ب: حدد مباشرة كتلة نصية تحتوي على مسارات في المحرر.
   • السيناريو ج: انسخ أي نص خارجي يحتوي على مسارات ملفات.

2. تفيذ الأمر:

   • افتح لوحة الأوامر (Cmd+Shift+P أو Ctrl+Shift+P).
   • اكتب Delete Files From Search Results واضغط على Enter.

3. تدفق التفاعل:

   • تحديد المصدر: يكتشف الامتداد سياقك تلقائيًا ويظهر قائمة اختيار سريع (QuickPick).
     • Use Selected Text (استخدام النص المحدد): موصى به.
     • Use Clipboard Content (استخدام محتوى الحافظة): يدعم المعاينة للتأكيد.
     • Manual Input (إدخال يدوي): الصق يدويًا إذا لم تكن الخيارات أعلاه مناسبة.
     • Regex Search (بحث بالتعبير النمطي) (جديد): أدخل تعبيرًا نمطيًا مباشرة لمسح وحذف الملفات المطابقة في المشروع.
   • تصفية الملفات: بعد التحليل، سيتم عرض قائمة بالملفات المراد حذفها. يمكنك إلغاء تحديد الملفات التي لا تريد حذفها.
   • التأكيد النهائي: اختر "Confirm Delete" (تأكيد الحذف) للتنفيذ، أو "Dry Run" (تشغيل تجريبي) للمعاينة.

💻 استخدام واجهة سطر الأوامر (CLI)

توفر أداة CLI وضعًا تفاعليًا قويًا لمستخدمي المحطة الطرفية.

# الوضع التفاعلي (موصى به)
delfiles

# التحليل من سلسلة نصية
delfiles -s "path/to/file.js: ..."

# تشغيل تجريبي (محاكاة)
delfiles --dry-run

الميزات

• الوضع التفاعلي: يوجهك خلال اختيار الإدخال (الحافظة/يدوي/تعبير نمطي).
• بحث Regex: في الوضع التفاعلي، اختر "Manual Input Keyword" للبحث عن الملفات بواسطة محتوى regex.
• دعم الحافظة: قراءة مباشرة من حافظة النظام.
• الأمان: يتم نقل الملفات افتراضيًا إلى سلة المهملات (قابل للتكوين).

⚙️ الإعدادات (VS Code)

يمكنك تكوين delfiles في إعدادات VSCode:

• delfiles.basePath: الدليل الأساسي للمسارات النسبية. الافتراضي هو ${workspaceFolder}.
• delfiles.moveToTrash: طريقة الحذف. الافتراضي هو true (نقل إلى سلة المهملات)، اضبطه على false للحذف الدائم (استخدم بحذر!).
• delfiles.ignorePatterns: قواعد التجاهل العالمية. يدعم مصفوفات أنماط Glob، على سبيل المثال، ["node_modules/**", "*.test.js"].

🛡️ ميزات الأمان

• سلة المهملات الافتراضية: يتم نقل الملفات إلى سلة المهملات بالنظام افتراضيًا لمنع الحذف العرضي.
• تشغيل تجريبي: يدعم وضع التشغيل التجريبي للمعاينة قبل التنفيذ.
• تصفية ذكية: يستبعد تلقائيًا أسطر التعليمات البرمجية والتعليقات، ويحدد بدقة مسارات الملفات.
• تأكيد تفاعلي: ضمان مزدوج عبر تأكيد قائمة الملفات وتأكيد النافذة المنبثقة النهائية.

📝 الأسئلة الشائعة (FAQ)

س: لا يمكن تحليل مسارات الملفات؟ ج: يدعم الامتداد تنسيقات مسار مختلفة (مثل path/to/file.js أو path/to/file.js:). تأكد من أن النص يحتوي على خصائص مسار ملف واضحة.

س: الملفات لا تزال موجودة بعد الحذف؟ ج: تحقق من لوحة الإخراج (View -> Output -> Delete Files) للحصول على سجلات مفصلة. قد تكون مشكلة أذونات أو أن الملف قيد الاستخدام.

📄 الترخيص

هذا المشروع مرخص بموجب ترخيص الملكية.

Delete Files From Search Results - 日本語版説明

本ツールは、VSCode 拡張機能と CLI（コマンドラインインターフェース）の両方で利用可能な、ファイルの一括削除ツールです。検索結果のテキスト（例：VSCode の全体検索結果や grep の出力）を解析し、ファイルパスを抽出して安全に削除する機能を提供します。

📦 インストール方法

VS Code 拡張機能

VS Code マーケットプレイスで「Delete Files From Search Results」を検索し、インストールしてください。

CLI ツール

npm を使用して、グローバルなコマンドラインツールとしてインストールできます：

npm install -g delfiles-by-search

🚀 VS Code 拡張機能の使い方

クイックスタート

1. データの準備: ファイルパスを含むテキストを用意します。

   • シナリオ A: VSCode の全体検索結果で右クリックし、「Copy All（すべてコピー）」を選択。
   • シナリオ B: エディタ内でファイルパスを含むテキストブロックを直接選択。
   • シナリオ C: 外部からファイルパスを含むテキストをコピー。

2. コマンドの実行:

   • コマンドパレットを開きます（Cmd+Shift+P または Ctrl+Shift+P）。
   • Delete Files From Search Results と入力し、Enter キーを押します。

3. 操作の流れ:

   • ソースの選択: プラグインがコンテキストを自動検出し、クイックピックメニューを表示します。
     • Use Selected Text（選択したテキストを使用）: 推奨。
     • Use Clipboard Content（クリップボードの内容を使用）: 確認用のプレビューをサポート。
     • Manual Input（手動入力）: 上記のオプションが適さない場合に手動で貼り付けます。
     • Regex Search（正規表現検索）（新規）: 正規表現を直接入力し、プロジェクト内の一致するファイルをスキャンして削除します。
   • ファイルのフィルタリング: 解析後、削除対象のファイルリストが表示されます。削除したくないファイルのチェックを外すことができます。
   • 最終確認: 「Confirm Delete（削除を確認）」を選択して実行するか、「Dry Run（ドライラン）」を選択してプレビューします。

💻 CLI ツールの使い方

CLI ツールは、ターミナルユーザー向けに強力な対話モードを提供します。

# 対話モード（推奨）
delfiles

# 文字列から解析
delfiles -s "path/to/file.js: ..."

# ドライラン（シミュレーション）
delfiles --dry-run

主な機能

• 対話モード: 入力選択（クリップボード/手動/正規表現）をガイドします。
• 正規表現検索: 対話モードで「Manual Input Keyword」を選択すると、正規表現でファイルを検索できます。
• クリップボードサポート: システムのクリップボードから直接読み取ります。
• 安全性: デフォルトでファイルをゴミ箱に移動します（設定可能）。

⚙️ 設定（VS Code）

VSCode の設定で delfiles を検索して設定できます：

• delfiles.basePath: 相対パスの基準ディレクトリ。デフォルトは ${workspaceFolder} です。
• delfiles.moveToTrash: 削除方法。デフォルトは true（ゴミ箱に移動）です。false に設定すると完全に削除されます（注意して使用してください）。
• delfiles.ignorePatterns: グローバルな除外ルール。Glob パターンの配列をサポートします（例：["node_modules/**", "*.test.js"]）。

🛡️ 安全機能

• デフォルトでゴミ箱へ: 誤削除を防ぐため、ファイルはデフォルトでシステムのゴミ箱に移動されます。
• ドライラン: 実行前にプレビューできるドライランモードをサポートしています。
• スマートフィルタリング: コード行やコメントを自動的に除外し、ファイルパスを正確に識別します。
• 対話的確認: ファイルリストの確認と最終ポップアップ確認による二重の安全対策があります。

📝 よくある質問（FAQ）

Q: ファイルパスを解析できません。 A: プラグインは様々なパス形式（例：path/to/file.js や path/to/file.js:）をサポートしています。テキストに明確なファイルパスの特徴が含まれていることを確認してください。

Q: 削除してもファイルが残っています。 A: 出力パネル（View -> Output -> Delete Files）で詳細なログを確認してください。権限の問題や、ファイルが使用中である可能性があります。

📄 ライセンス

本プロジェクトは Proprietary License の下でライセンスされています。

📅 更新日志 (Changelog)

v0.0.7 (2026-02-24)

• 文档 (Docs): 新增日语版 README 说明。
• 国际化 (i18n): 增加西班牙语和阿拉伯语文档翻译。

v0.0.6 (2026-02-24)

• 文档 (Docs): 统一 VS Code 扩展显示名称为 Title Case 格式。

v0.0.5 (2026-02-24)

• 新功能 (Feat): 增加扩展国际化支持 (i18n)，命令标题和描述支持中英双语。
• 文档 (Docs): 修正 package.json 中的仓库链接和包信息。

v0.0.4 (2026-02-24)

• 新功能 (Feat): CLI 工具新增正则搜索模式，支持扫描项目文件。
• 优化 (Chore): 增强核心解析器逻辑，提升路径识别准确率。
• 文档 (Docs): 更新 License 链接指向。

v0.0.3 (2026-02-24)

• 工程化 (Chore): 优化 NPM 包发布配置，排除非必要文档。
• 工程化 (Chore): 清理和去重忽略规则 (.gitignore / .npmignore)。

v0.0.2 (2026-02-24)

• 新功能 (Feat): 引入独立正则搜索模式。
• 交互 (UX): CLI 交互模式升级，支持剪贴板输入和更友好的提示。
• 文档 (Docs): 添加发布指南 (PUBLISHING.md) 和开源许可证文件。

v0.0.1 (2026-02-24)

• Initial Release: 首个版本发布。
• 核心功能: 支持从文本解析文件路径并批量删除。
• 双模式: 提供 VS Code 插件和 CLI 命令行工具。
• 安全: 默认移动到回收站，支持 --dry-run 模拟运行。