Discord历史记录神器discrawl:告别刷屏,SQLite本地归档完全指南
Discord历史记录神器discrawl:告别刷屏,SQLite本地归档完全指南
Discord 历史记录归档工具 discrawl 是一款基于 SQLite 的开源 CLI 工具,能把服务器聊天记录、线程、成员和直连消息(DM)完整镜像到本地数据库,支持离线全文检索、SQL 查询和终端浏览器。无论你是想找回被刷屏淹没的旧消息,还是需要一份可长期保存的服务器档案,它都能做到"下载即用、数据在自己手里"。
💬 为什么你需要把 Discord 历史存到本地?
Discord 网页端和客户端的搜索功能有几个常见痛点:
- 📜 刷屏即消失:热门频道一天上万条消息,想翻旧账只能疯狂向上滚;
- 🔍 搜索能力弱:无法按作者 + 频道 + 时间组合过滤,更不支持 SQL 统计;
- 🔒 直连消息无处可查:机器人 Token 读不了个人 DM,普通工具对私聊无能为力;
- 🏠 数据不在本地:搜索依赖服务器,离线、审计、备份都做不了。
discrawl 的思路很直接:把整个服务器变成一个本地 SQLite 数据库。所有消息、附件元数据、FTS5 全文索引都落在一个文件里,搜索、统计、浏览全部离线完成。
🚀 一键安装:三种方式任选
方式一:Homebrew(macOS / Linux 最快路径)
brew install openclaw/tap/discrawl
discrawl --version
方式二:源码构建(需要 Go 1.27.0+)
git clone https://gitcode.com/gh_mirrors/di/discrawl
cd discrawl
go build -o bin/discrawl ./cmd/discrawl
./bin/discrawl --version
方式三:Windows / 其他平台
官方 Release 提供各平台的 Windows 二进制与签名归档包,下载即用。
详细步骤(含 Docker、运行时路径、更新检查)见 docs/install.md。
📥 三种归档来源:按需选择
| 来源 | 命令 | 提供什么 | 需要 Token? |
|---|---|---|---|
| Discord 机器人 | discrawl sync |
服务器、频道、线程、成员及机器人可见的完整历史 | 是 |
| 桌面版本地缓存 | discrawl wiretap |
本机缓存的频道消息 + 可识别的 DM | 否 |
| Git 快照 | discrawl subscribe |
别人发布好的离线档案 | 否 |
1️⃣ 机器人全量归档(最完整)
export DISCORD_BOT_TOKEN="your-bot-token"
discrawl init # 发现可访问的服务器并生成默认配置
discrawl doctor # 自检:配置、Token、Gateway、数据库、FTS 索引
discrawl sync # 例行同步(增量)
discrawl sync --full # 历史回填,大型服务器会受速率限制,耐心等待
之后用 discrawl tail 通过 Gateway 事件持续保持档案最新,详见 docs/commands/tail.md。
2️⃣ wiretap:零 Token 导入桌面版缓存(DM 唯一解)
wiretap 只读取 Discord Desktop 本地缓存文件,不提取用户 Token、不调用用户身份接口:
discrawl wiretap --dry-run --json # 先预览能导入多少条,不写库
discrawl wiretap # 正式导入
discrawl search --dm "launch checklist"
被证实的 DM 会存到合成的 @me 空间,且永远只保留在本地,不会出现在任何共享快照里。命令细节见 docs/commands/wiretap.md。
3️⃣ 只读订阅别人的档案
discrawl subscribe <快照仓库地址>
discrawl search "launch checklist"
完全无需 Discord 凭据,本地快照超过 15 分钟后读取命令会自动刷新。快照机制见 docs/guides/git-snapshots.md。
🔎 搜索:FTS5 开箱即用,语义搜索可升级
discrawl search 默认走 SQLite FTS5 全文索引,零外部依赖,按最新优先返回:
discrawl search "panic: nil pointer"
discrawl search --channel general --author steipete "release"
还支持 semantic(纯语义)与 hybrid(混合)两种模式:配置 embedding 提供者并建索引后,就能用"意思相近"的表述搜到消息,混合模式会在语义不可用时自动回退到 FTS。多语言服务器也能处理——韩语(Kiwi)、日语(Kagome)、中文(GSE)、阿拉伯语各有独立分词索引。模式全解见 docs/guides/search-modes.md。
🖥️ 浏览与统计:不只是搜索
discrawl tui:终端里的三栏档案浏览器——左侧频道/成员/线程分组,中间消息列表,右侧消息详情、附件与线程上下文,还支持--dm浏览直连消息。用法见 docs/commands/tui.md;discrawl sql:只读 SQL 查询,想统计"谁最活跃""每周消息量趋势"直接写 SELECT;discrawl messages --channel general --hours 24:按频道 + 时间窗快速取数;discrawl status --json/discrawl diagnostics --json:输出稳定 JSON,方便接入 CI 和自动化脚本。
📤 publish:把档案分享给队友(可选)
discrawl publish --check # 只读预检,先看导出范围
discrawl publish # 生成分片压缩的 Git 快照
快照支持按频道过滤、--public-only 只导出公共频道,DM 和本地失败记录一律不导出;接收方用 subscribe 拉取,全程不需要任何 Discord 凭据。隐私与布局细节见 docs/commands/publish.md。
🗄️ 数据存在哪?
一切都在一个 SQLite 文件里(Linux 默认 ~/.local/share/discrawl/discrawl.db,macOS 在 ~/Library/Application Support/discrawl/),内含服务器元数据、频道/线程、成员快照、规范消息行、事件流水和 FTS 索引。附件二进制不进库,discrawl sync --with-media 会把媒体下载到本地缓存目录并记录 SHA-256 校验。备份档案 = 备份这一个文件,简单到极意。完整布局见 docs/guides/data-storage.md。
✅ 小结
| 需求 | 用哪个命令 |
|---|---|
| 零门槛试用 | discrawl wiretap --dry-run |
| 服务器完整存档 | discrawl sync --full |
| 找回旧消息 | discrawl search "关键词" |
| 像翻网页一样浏览 | discrawl tui |
| 分享只读档案 | discrawl publish + discrawl subscribe |
如果你受够了在 Discord 里"刷屏找消息",discrawl 就是那个把历史变成本地 SQLite 档案的神器:安装一行、搜索离线、数据可控。从 docs/README.md 的完整命令参考和 docs/configuration.md 配置文档出发,开始你的第一次归档吧 🛰️

