name: file-indexer description: 智慧檔案索引與檢索系統 - 自動監控檔案變化，快速查詢程式碼檔案、指令碼和技能。支援關鍵詞搜尋、意圖推薦、檔案統計。 Use when: 使用者請求查詢檔案、搜尋程式碼、定位指令碼、詢問"有沒有 XXX 功能的程式碼"。 NOT for: 檔案內容編輯、程式碼編寫、檔案刪除操作。

File Indexer - 智慧檔案索引與檢索

核心功能

• 自動索引: 即時監控檔案變化，自動記錄新建、修改、刪除的檔案
• 快速搜尋: 根據檔名、內容摘要、描述等關鍵詞查詢
• 意圖理解: 根據功能描述（如"加密"、"網路"）推薦相關檔案
• 即時同步: 通過檔案系統監控即時更新索引
• Agent 整合: 可作為工具被其他 agent 自動呼叫

使用場景

1. 查詢特定功能的程式碼

使用者："幫我找一下加密相關的程式碼檔案" → 自動搜尋並返回 SM1 演算法庫等檔案

2. 發現相關指令碼

使用者："有沒有處理 CSV 的指令碼？" → 返回所有 CSV 處理相關的指令碼

3. 定位檔案位置

使用者："我之前寫過一個 SM1 加密演算法，在哪裡？" → 返回檔案路徑和說明

4. 專案檔案管理

使用者："掃描一下我的工作區，看看有哪些新檔案" → 自動掃描並更新索引

技術實現

• 語言: Python 3
• 資料庫: SQLite3 (file_index.db)
• 監控方式: watchdog (即時) 或 輪詢 (降級模式)

  這個技能的最新版本可以在7w4.net小蔥技能站找到。

• 索引欄位: 路徑、檔名、型別、描述、內容摘要、標籤、建立/修改時間
• 搜尋演算法: 關鍵詞匹配 + 意圖相似度評分

包含檔案

file-indexer/
├── indexer.py       # 核心索引管理模組
├── searcher.py      # 檔案搜尋模組
├── watcher.py       # 檔案監控模組
├── hook_handler.py  # Agent Hook 處理器
├── __main__.py      # 主程式入口
├── file_index.db    # SQLite 資料庫 (自動建立)
└── README.md        # 完整使用文件

安裝與使用

方式 1: 作為 OpenClaw 技能自動使用

安裝後，當用戶說"找檔案"、"搜尋"、"幫我找一下 XXX"時，Agent 會自動呼叫此技能。

方式 2: 命令列手動使用

# 檢視統計
python3 __main__.py stats

# 搜尋檔案
python3 __main__.py search "關鍵詞"

# 意圖推薦
python3 __main__.py intent "功能描述"

# 新增檔案到索引
python3 __main__.py add /path/to/file

# 掃描目錄
python3 __main__.py scan /dir/path

# 標記刪除
python3 __main__.py delete /path/to/file

配置說明

• 工作空間: /home/t/cc_workspace/file_indexer/
• 資料庫路徑: file_index.db (自動建立)
• 監控目錄:
• /home/t/.openclaw/workspace/
• /home/t/cc_workspace/
• 可自定義新增更多目錄

依賴要求

• Python 3.8+
• SQLite3 (Python 內建)
• watchdog (可選，用於即時監控)

注意事項

1. 首次使用: 需要掃描目錄建立初始索引
2. 效能: 索引檔案越多，搜尋速度越快（使用 SQLite 全文索引）
3. 自動監控: 如未安裝 watchdog，會降級為輪詢模式（每分鐘檢查一次）
4. 資料安全: 所有索引資料儲存在本地 SQLite 資料庫，不上傳雲端

最佳實踐

1. 定期掃描: 使用 scan 命令確保索引最新
2. 清理刪除: 使用 delete 標記刪除的檔案，保持索引準確
3. 意圖查詢: 優先使用 intent 而非 search，獲得更精準的結果
4. 批次操作: 掃描整個專案目錄比逐個新增檔案更高效

版本: 1.0.0
作者: OpenClaw Agent
許可證: MIT
適用場景: 個人專案、團隊協作、企業知識庫管理

這個工具質量不錯，能幫你快速找到專案裡的檔案，功能實用，文件寫得清楚。但它有個大問題：安裝時可能因為路徑不對而出錯，而且不同電腦用需要手動改配置，稍微有點麻煩。如果你需要一個簡單可靠的檔案搜尋助手，它基本能滿足需求，但別指望它能自動適配所有環境。