文件智能
wescraft 能理解你电脑上的本地文件——不需要上传，文件原地不动，只建索引。
核心原则
- FI-1 原地不动 — 文件留在原位，wescraft 只建索引
- FI-4 渐进触发 — 元数据 → 全文索引 → 向量索引 → 语义理解
- FI-5 永远只读 — wescraft 绝不修改你的本地文件
添加关注目录
- 打开 wescraft 设置
- 找到 文件智能 部分
- 点击 添加目录
- 选择你想让 AI 理解的文件夹
添加后，wescraft 在后台自动建立索引。
索引过程
第一步：元数据扫描
↓ 文件名、大小、修改时间
第二步：全文索引（FTS5）
↓ 文件内容可搜索
第三步：变更监控
↓ fsnotify 自动监听文件变化
→ 增量更新受影响的索引
索引完成后，你可以在对话中自然地引用本地文件：
你：帮我总结一下 ~/Documents/Meeting 里上周的会议记录
AI 会搜索你的索引找到相关文件并给出总结。
AI 工具
wescraft 提供以下文件智能工具：
| 工具 | 功能 |
|---|---|
search_files | 在关注目录中搜索文件 |
read_local_file | 读取本地文件内容 |
find_related_files | 找到与当前主题相关的文件 |
file_overview | 获取文件的结构概览 |
assemble_from_files | 从多个文件中组装信息 |
安全边界
- 索引数据存储在本地，不上传
- 路径访问有严格边界检查，防止路径穿越
- 符号链接会被解析为真实路径后验证
- wescraft 只能访问你明确添加的关注目录
支持的文件类型
wescraft 可以索引大多数文本文件：
- 文档：
.md、.txt、.docx、.pdf - 代码：
.py、.js、.go、.rs等 - 数据：
.json、.yaml、.csv - 笔记：各种纯文本格式
二进制文件（图片、视频等）只记录元数据，不做全文索引。