企业官网建设流程全解析

msgvault文档索引与视觉搜索：让PDF附件和图片内容也能被瞬间搜到

【免费下载链接】msgvaultArchive a lifetime of email and chat. Offline search, analytics, and AI query over your full message history. Powered by SQLite and DuckDB项目地址: https://gitcode.com/gh_mirrors/ms/msgvault

msgvault 是一个把邮箱、聊天记录、会议与日历全部归档到你自己设备上的开源工具，支持离线搜索、分析和 AI 查询。它的文档索引功能能把 PDF、PPT、CSV 等附件里的文字抽出来建索引，视觉搜索则能靠一句描述或一张相似图片找到归档里的照片和视频——两者都能让你在几秒内瞬间搜到往年附件里的内容。本文带你快速看懂文档导航与这两项功能的上手流程。

📚 msgvault 文档中心：一张索引表看懂去哪查

msgvault 的官方文档以 docs/index.md 为入口，按"找消息 → 管联系人 → 运维归档"三层组织。新手建议按下面这张表直接跳转：

一个好消息：关键词搜索开箱即用，不需要任何云端服务；文档索引和视觉搜索属于可选增强，只在明确授权后才会把内容发给对应服务。

📄 文档索引：让 PDF 附件里的文字也能被搜到

工作原理

文档索引把归档中的合格附件（PDF、PPTX，以及可选的 CSV）发送给 Mistral OCR 提取文字，把提取结果保存在本地并建立关键词索引。之后你用：

msgvault documents search "shipping damage"

就能命中附件正文，并直接返回包含该附件的原始邮件、标题路径与出处信息。还能按发件人、来源、日期等过滤：

msgvault documents search "shipping damage" --person 123 --direction from_person

三步开启：探测 → 同意 → 构建

文档索引设计了三道独立安全闸门，确保你完全掌握"什么会离开你的归档"：

1. 认证探测：运行msgvault documents probe-mistral验证你的端点和模型能处理哪些格式，生成能力清单（manifest）；
2. 记录同意：运行msgvault documents consent-mistral --capabilities <manifest>，先不带--yes阅读完整披露，确认后重跑；
3. 分批构建：msgvault documents build --capabilities <manifest> --limit 100 --yes，可随时用documents resume续建。

所有上传都是手动触发的——开启功能不会自动上传任何附件，msgvault serve守护进程也绝不会自行启动提取。

进阶：语义与混合文档搜索

配好 docs/usage/vector-search.md 中的消息嵌入并开启文档向量后，可以用--mode semantic按"意思"搜文档、--mode hybrid融合关键词与语义排名。注意语义模式有单独的同意记录，缺少前置条件时会明确报错，而不是悄悄降级为关键词搜索。

🖼️ 视觉搜索：一句话或一张图，找到照片和视频

能搜什么

视觉搜索（多模态搜索）面向归档中的图片与视频，支持两种查询方式：

• 文字描述：msgvault multimodal search "a whiteboard with a project timeline"
• 以图搜图：msgvault multimodal search --image ./reference.png

默认支持 JPEG、PNG、WebP 与 MP4 直传，动图 GIF 需单独开启。结果返回附件本身及其所在的原始消息，还支持--person、--source、--after等过滤。

最快开启方法

msgvault multimodal probe --seeds <私有种子目录> --out ~/.msgvault/voyage-capabilities.json --yes msgvault setup providers msgvault multimodal build --yes

第一条命令生成能力清单，证明你的 Voyage 端点能处理哪些格式；setup providers写入配置；multimodal build记录同意并构建索引。构建可随时multimodal resume续跑，multimodal status --json查看覆盖率与失败项。

🎯 搜索模式速查：我该用哪一个？

✅ 小结与延伸阅读

• 文档索引与视觉搜索都遵循"探测 → 同意 → 手动构建"的隐私流程，原始附件始终保留在本地归档；
• 关键词搜索零门槛，语义/视觉能力按需在 docs/usage/recommended-configuration.md 里按你的提供商密钥做引导配置；
• 完整配置项见 docs/configuration.md，功能演进看 docs/changelog.md；
• 想让 AI 助手来查？MCP 工具search_document_attachments与search_visual_attachments可分别覆盖文档与视觉检索，详见 docs/usage/chat.md。

【免费下载链接】msgvaultArchive a lifetime of email and chat. Offline search, analytics, and AI query over your full message history. Powered by SQLite and DuckDB项目地址: https://gitcode.com/gh_mirrors/ms/msgvault