Discord历史记录神器discrawl:告别刷屏,SQLite本地归档完全指南

原创2026-10-25 23:40:251,443 阅读

Discord历史记录神器discrawl:告别刷屏,SQLite本地归档完全指南

Discord 历史记录归档工具 discrawl 是一款基于 SQLite 的开源 CLI 工具,能把服务器聊天记录、线程、成员和直连消息(DM)完整镜像到本地数据库,支持离线全文检索、SQL 查询和终端浏览器。无论你是想找回被刷屏淹没的旧消息,还是需要一份可长期保存的服务器档案,它都能做到"下载即用、数据在自己手里"。

discrawl:将 Discord 镜像到 SQLite 并本地搜索的历史归档工具

💬 为什么你需要把 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 本地搜索:wiretap 导入后直接 SQL 查询 312k 条消息

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 配置文档出发,开始你的第一次归档吧 🛰️

登录后查看全文
discrawl