msgvault

把一辈子的邮件和聊天存进本地，随时离线搜索和提问

开源 🏷️定价信息待确认 ⏳ 访问状态待核验搜索知识 🍴 复刻 169 🐛 待处理 169 👀 关注 13

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 2163

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类搜索知识

开发团队kenn-io

官网地址https://msgvault.io

GitHubhttps://github.com/kenn-io/msgvault

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态⏳ 访问状态待核验

是否开源是

开源协议MIT

主要语言Go

GitHub 星标★ 2163

上线时间2026-01-28 00:00:00

代码更新2026-10-23

仓库体积43.1 MB

本站数据更新2026-10-24

维护状态活跃

收录时间2026-10-24

浏览次数0

项目介绍

msgvault 是一个用 Go 编写的个人消息归档与检索工具，目标是把一个人多年积累的邮件和聊天记录统一保存下来，并在本地建立可离线使用的索引。它解决的核心问题是：邮件和即时通讯数据分散在多个服务中，历史消息难以跨平台检索，长期留存也受服务商策略影响。项目以 SQLite 和 DuckDB 为存储与分析底座，将消息导入后支持全文搜索、时间线浏览、统计分析以及基于本地数据的 AI 查询，让用户对自己的完整沟通历史拥有可掌控的访问方式。核心能力包括多来源消息导入、离线全文检索、按时间与联系人维度的统计洞察，以及用自然语言对历史消息提问。整体定位偏向个人数据自主管理与长期归档，适合重视隐私、希望把消息历史留在本地的用户。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-10-24 · 当前星标 ★ 2163

使用教程

难度：入门约 15 分钟部署方式：命令行工具 8 步

环境要求

macOS 或 Linux 系统（一键脚本安装并自动识别架构）
Windows 需 PowerShell 环境
源码编译需 Go 1.27+、Bun 1.3.14+、Node.js 20.19+/22.13+/24+ 及 C/C++ 编译器
Debian/Ubuntu 源码编译还需安装 libsqlite3-dev（提供 sqlite3.h）
同步 Gmail 需先创建 OAuth 凭据

安装与启动步骤

1安装(macOS/Linux)

运行官方安装脚本，自动下载最新 Release 二进制并校验 SHA-256，可先审阅脚本内容。
```
curl -fsSL https://msgvault.io/install.sh | bash
```
2Windows 安装

在 PowerShell 中执行官方安装脚本，自动识别系统架构并安装到本机。
```
powershell -ExecutionPolicy ByPass -c "irm https://msgvault.io/install.ps1 | iex"
```
3从源码编译

需满足 Go、Bun、Node.js 与 C/C++ 编译器要求，make install 完成编译安装。
```
git clone https://github.com/kenn-io/msgvault.git
cd msgvault
make install
```
4初始化数据库

首次使用先创建本地数据库，SQLite 与 DuckDB 作为存储与分析的底座。
```
msgvault init-db
```
5添加邮箱账号

把要归档的邮箱地址加入配置；Gmail 需先按 OAuth 指南创建凭据。
```
msgvault add-account you@gmail.com
```
6执行首次同步

先用 --limit 100 归档一小批消息，确认流程与权限正常后再做全量同步。
```
msgvault sync-full you@gmail.com --limit 100
```
7启动服务

启动本地 API 服务与内置浏览器应用，按输出的 API server 地址访问界面。
```
msgvault serve
```
8使用终端界面

不想用浏览器时，用内置 TUI 在终端中浏览与检索归档消息。
```
msgvault tui
```