← 返回 Skills 市场
File Indexer
作者
LookUpMark
· GitHub ↗
· v1.2.0
· MIT-0
157
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install lookupmark-file-indexer
功能描述
Fast filesystem catalog for finding files by name, date, type, or size. Indexes metadata only (no content). Uses SQLite for instant lookups. Triggers on "fin...
使用说明 (SKILL.md)
File Indexer
Fast metadata-based file catalog. No content indexed — only filenames, sizes, dates, and extensions.
Usage
# Build/rebuild the index (run once, or periodically)
python3 scripts/indexer.py --rebuild
# Update incrementally (fast — adds new, removes deleted)
python3 scripts/indexer.py --update
# Search by filename
python3 scripts/indexer.py --search "budget"
# Filter by extension
python3 scripts/indexer.py --search "report" --ext .pdf
# Filter by size
python3 scripts/indexer.py --search "" --min-size 10485760 # > 10MB
# Filter by date
python3 scripts/indexer.py --search "" --after 2026-03-01
# Index statistics
python3 scripts/indexer.py --stats
Security
- ALLOWED_ROOTS: Only
~/Documentiand~/Scaricati— same as RAG - BLOCKED_DIRS:
.ssh,.gnupg,.config,credentials,.local,.cache,.Trash - Zero content: Only metadata (name, size, date, extension) — never reads file contents
- No secrets: Paths to sensitive dirs are never indexed
- Local only: SQLite DB at
~/.local/share/file-indexer/catalog.db
What Gets Indexed
| Yes | No |
|---|---|
| Filename | File contents |
| Extension | Full text |
| Size | Embeddings |
| Modified date | Preview |
| Directory path | Thumbnails |
Automation
Add to cron or heartbeat for periodic updates:
python3 scripts/indexer.py --update
Works well alongside local-rag: use this for "where is that file?" and RAG for "what does that file say?"
安全使用建议
This skill appears coherent and local-only, but check these points before installing: (1) It writes a SQLite DB and creates a .bak under ~/.local/share/file-indexer — if you are uncomfortable with that file, don't install. (2) The allowed roots are ~/Documenti and ~/Scaricati (Italian names) — verify these match the directories you want indexed (e.g., ~/Documents/Downloads). (3) Symlinks inside allowed roots may cause metadata about their targets to be indexed even if those targets live outside the allowed roots; avoid symlinks to sensitive locations. (4) The script does not read file contents or send data over network, but you should still review the included script before running it and run it with your normal least-privilege practices (or in a sandbox) if you have sensitive files. If you want stricter guarantees, change ALLOWED_ROOTS, BLOCKED_DIRS, or run the script manually to inspect behavior before enabling automation.
功能分析
Type: OpenClaw Skill
Name: lookupmark-file-indexer
Version: 1.2.0
The file-indexer skill is a legitimate utility for indexing and searching file metadata (names, sizes, dates) within specific user directories (~/Documenti and ~/Scaricati). The script (scripts/indexer.py) includes explicit security measures, such as a blacklist for sensitive directories like .ssh and .gnupg, and it strictly avoids reading file contents, focusing only on filesystem metadata stored in a local SQLite database.
能力评估
Purpose & Capability
The name/description, SKILL.md usage examples, and the included scripts/indexer.py all implement a metadata-only file indexer that writes a local SQLite DB under ~/.local/share/file-indexer. Required capabilities are minimal and aligned with the stated purpose.
Instruction Scope
SKILL.md instructs running the bundled Python script to rebuild/update/search the index; the script only uses os.walk and os.stat to collect filename, size, date, extension and writes to a local DB. Note: the code follows symlinks when calling os.stat on files (os.stat follows symlinks), so a symlink inside an allowed root that points to a sensitive file elsewhere could cause metadata about that target to be indexed. Also the script creates a local .bak backup of the DB when rebuilding.
Install Mechanism
No install spec is provided (instruction-only skill). The runtime relies on the included Python script and the system's python3/sqlite3; nothing is downloaded or written outside the user's home directory except the DB and its backup. This is a low-risk install posture.
Credentials
The skill requires no environment variables or external credentials. The local-only DB path and ALLOWED_ROOTS are declared in the code and SKILL.md, so requested permissions are proportionate to its functionality.
Persistence & Privilege
always:false (default) and no elevated privileges are requested. The skill persists a local SQLite DB and backup under the user's home directory; it does not modify other skills or system-wide configurations.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install lookupmark-file-indexer - 安装完成后，直接呼叫该 Skill 的名称或使用
/lookupmark-file-indexer触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.2.0
FTS5 injection sanitization, backup before rebuild
v1.1.0
FTS5 full-text search for instant filename lookup. Rebuild recreates FTS index cleanly.
v1.0.0
Initial release. SQLite metadata catalog. Search by name/ext/size/date. Same security roots as RAG. Zero content indexing.
元数据
常见问题
File Indexer 是什么？
Fast filesystem catalog for finding files by name, date, type, or size. Indexes metadata only (no content). Uses SQLite for instant lookups. Triggers on "fin... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 157 次。
如何安装 File Indexer？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install lookupmark-file-indexer」即可一键安装，无需额外配置。
File Indexer 是免费的吗？
是的，File Indexer 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
File Indexer 支持哪些平台？
File Indexer 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 File Indexer？
由 LookUpMark（@lookupmark）开发并维护，当前版本 v1.2.0。
推荐 Skills