[分享] discord-cli — 把 Discord 聊天记录同步到本地 SQLite ，终端搜索 + AI 总结

项目背景

平时泡不少 Discord 社区（ crypto 、开源项目、AI 讨论组），消息量大、翻找困难。Discord 自带搜索不支持正则，也没法离线查看。于是写了 discord-cli——一个 local-first 的 Discord 命令行工具：

• 把频道消息增量同步到本地 SQLite
• 终端里全文检索、统计、导出
• 可选接 Claude 做频道摘要 / 分析

GitHub： https://github.com/jackwener/discord-cli

PyPI： https://pypi.org/project/kabi-discord-cli/

核心功能

1. 一键同步聊天记录

# 提取并保存本地 Discord token
discord auth --save

# 发现所有可见文字频道并同步
discord dc sync-all -n 500

# 增量同步（只拉新消息）
discord dc sync-all

• 自动处理 Discord rate limit （读 retry_after / X-RateLimit-Remaining header ，不会触发封号）
• 消息存入 ~/Library/Application Support/discord-cli/messages.db

2. 本地搜索 & 统计

# 全文搜索
discord search "rust" -c general

# 今天的消息
discord today

# 按小时统计活跃度
discord timeline --by hour

# 谁发言最多
discord top --hours 24

# 各频道消息量
discord stats

3. 结构化输出，方便脚本 / AI Agent

# JSON / YAML 输出
discord search "release" --json
discord today -c general --yaml

# 导出为文件
discord export general -f json -o out.json

• 非 TTY 环境自动输出 YAML
• 所有输出遵循统一的 envelope schema

4. AI 总结 & 分析（可选）

# 安装 AI 依赖
uv tool install 'kabi-discord-cli[ai]'
export ANTHROPIC_API_KEY=...

# 频道 AI 分析
discord analyze general --hours 24

# 全局摘要
discord summary --hours 12

安装

# 推荐
uv tool install kabi-discord-cli

# 或 pipx
pipx install kabi-discord-cli

Python 3.10+ 即可，依赖很少（ httpx + click + rich + PyYAML ）。

典型使用场景

1. 信息归档：把重要 Discord 社区的讨论同步到本地，不怕频道被删或服务器跑路
2. 快速检索：在终端快速搜索历史消息，比 Discord 自带搜索灵活
3. 每日摘要：用 discord summary 生成 AI 摘要，快速了解今天社区讨论了什么
4. 数据分析：timeline / top / stats 了解社区活跃度
5. AI Agent 集成：附带 SKILL.md ，可以被 Claude Code / Antigravity 等 AI agent 直接调用

同系列工具

这是我做的社交平台 CLI 系列的一部分，同样的 local-first 思路：

Apache-2.0 开源，欢迎 Star ⭐ 和反馈 🙏

有什么想法或者需要支持的功能，欢迎在 Issues 里提。