文件智能

wescraft 的文件智能引擎（FileIntelligence）在不移动本地文件的前提下，对文件建立索引和语义理解。

核心原则

文件原地不动（FI-1）

wescraft 不会复制或搬移你的文件：

做什么不做什么
在原地建立索引不复制文件
建立语义理解不移动文件
提供检索能力不修改文件

永远只读（FI-5）

wescraft 永远不会修改用户的本地文件。

关注目录

添加关注目录

将本地目录加入关注列表，wescraft 会自动索引其中的文件：

操作说明
添加目录选择需要索引的文件夹
移除目录取消关注某个文件夹
查看列表查看当前关注的目录

索引方式

关注目录的文件会进入渐进式索引管线：

阶段内容
元数据文件名、大小、修改时间
全文索引FTS5 全文检索
向量索引语义向量（规划中）
理解AI 分析文件内容

检索能力

AI 工具

工具功能
search_files搜索文件
read_local_file读取文件内容
find_related_files查找相关文件
file_overview文件概览
assemble_from_files从文件组装内容

使用示例

"在我的文件中搜索关于预算的内容"
"找到上周修改的 Excel 文件"
"读取那份项目报告"
"把相关文件的内容整理成一页"

AgenticRAG（FI-AP-09）

主动检索

wescraft 使用 AgenticRAG 模式，AI 主动调用工具检索文件：

用户提问 → AI 判断需要查什么 → 调用 search_files → 获取结果 → 回答

而不是预先把所有文件内容塞进上下文。

优势

特性说明
精准只检索相关内容
高效不浪费 token
灵活AI 可以多次检索

后台索引（FI-AP-08）

自动更新

文件变更会自动触发重新索引：

性能

指标说明
初次索引取决于文件数量
增量更新毫秒级
大文件分块处理

安全

路径校验（FI-AP-07）

防护说明
前缀校验确保在关注目录内
符号链接检测防止路径逃逸
权限检查尊重操作系统权限

per-Cell 隔离

个人版

索引数据存储在个人 Cell 目录下：

$DATA_DIR/cells/personal/fileintel/

团队版

索引数据存储在团队 Cell 目录下：

{shared-storage}/wescraft/cells/team-{id}/fileintel/

团队 Cell 不会索引个人的私有文件。

注意事项