File Indexer - 智能文件索引与检索
核心功能
- 自动索引: 实时监控文件变化，自动记录新建、修改、删除的文件
- 快速搜索: 根据文件名、内容摘要、描述等关键词查找
- 意图理解: 根据功能描述（如"加密"、"网络"）推荐相关文件
- 实时同步: 通过文件系统监控实时更新索引
- Agent 集成: 可作为工具被其他 agent 自动调用
使用场景
1. 查找特定功能的代码
用户："帮我找一下加密相关的代码文件" → 自动搜索并返回 SM1 算法库等文件
2. 发现相关脚本
用户："有没有处理 CSV 的脚本？" → 返回所有 CSV 处理相关的脚本
3. 定位文件位置
用户："我之前写过一个 SM1 加密算法，在哪里？" → 返回文件路径和说明
4. 项目文件管理
用户："扫描一下我的工作区，看看有哪些新文件" → 自动扫描并更新索引
技术实现
- 语言: Python 3
- 数据库: SQLite3 (file_index.db)
- 监控方式: watchdog (实时) 或 轮询 (降级模式)
- 索引字段: 路径、文件名、类型、描述、内容摘要、标签、创建/修改时间
- 搜索算法: 关键词匹配 + 意图相似度评分
包含文件
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 (可选，用于实时监控)
注意事项
- 首次使用: 需要扫描目录建立初始索引
- 性能: 索引文件越多，搜索速度越快（使用 SQLite 全文索引）
- 自动监控: 如未安装 watchdog，会降级为轮询模式（每分钟检查一次）
- 数据安全: 所有索引数据存储在本地 SQLite 数据库，不上传云端
最佳实践
- 定期扫描: 使用
scan命令确保索引最新 - 清理删除: 使用
delete标记删除的文件，保持索引准确 - 意图查询: 优先使用
intent而非search，获得更精准的结果 - 批量操作: 扫描整个项目目录比逐个添加文件更高效
版本: 1.0.0
作者: OpenClaw Agent
许可证: MIT
适用场景: 个人项目、团队协作、企业知识库管理