性能优化
WesCraft 在保持丰富功能的同时注重性能表现。本文介绍文件索引、全文搜索、大文件处理等方面的优化策略。
文件智能索引的渐进触发
文件智能引擎采用渐进式索引策略（FI-4），按需逐步深入：
| 阶段 | 触发条件 | 处理内容 | 开销 |
|---|---|---|---|
| 元数据索引 | 添加关注目录时 | 文件名、大小、修改时间、类型 | 极低 |
| 全文索引（FTS） | 用户搜索时 | 文件内容分词、建立 FTS5 索引 | 中等 |
| 向量索引 | 语义搜索时 | 生成 Embedding 向量 | 较高 |
| 深度理解 | AI 主动分析时 | 内容摘要、标签、关联关系 | 高 |
添加关注目录后几乎即时可用，只有实际被搜索或分析的文件才会消耗计算资源。
FTS5 全文搜索优化
- 增量索引：文件变更时只更新变更部分，不重建整个索引
- 触发器同步：通过 INSERT/UPDATE/DELETE 触发器保持 FTS 索引与数据表同步
- 延迟索引：保存页面时短延迟后批量处理，不立即重建
- 启动健康检查：每次启动自动执行
RebuildFTS，确保索引一致性
搜索技巧：用引号包裹精确词组（"项目计划"），使用 AND/OR 逻辑（预算 AND 2024），支持前缀搜索（perf*）。
大文件处理策略
| 场景 | 策略 |
|---|---|
| 编辑器 | 大文件（>1MB）不自动加载预览，Buffer 同步跳过 |
| 文件智能 | 分块处理，每块独立索引；超大文件（>10MB）仅做全文索引 |
| 知识库 | 上传大文件自动分段，搜索结果精确到段落级别 |
索引重建
当索引出现异常时可手动重建：
- 文件索引：「设置 → 文件智能 → 重建索引」，清除现有索引并从头扫描
- 搜索索引：「设置 → 高级 → 重建搜索索引」，启动时也会自动检查修复
- 知识库索引：支持单个文件或全量重建
缓存管理
| 缓存类型 | 位置 | 用途 | 清理方式 |
|---|---|---|---|
| 文件元数据缓存 | 内存 | 加速文件列表展示 | 重启应用 |
| 搜索结果缓存 | 内存 | 加速重复搜索 | 自动失效 |
| AI 响应缓存 | SQLite | 避免重复调用 | 设置中手动清理 |
| 图片缩略图 | 磁盘 | 加速图片预览 | 设置中手动清理 |
在「设置 → 存储」中可查看各类缓存占用空间并选择性清理。
相关文档
- 文件智能 →
file-intelligence.md - 搜索 →
search.md - 知识库 →
knowledge.md - 数据备份 →
data-backup.md