hub / github.com/shuakami/qq-chat-exporter
github.com/shuakami/qq-chat-exporter @v5.5.77 sqlite
2,019 symbols
5,635 edges
249 files
661 documented · 33%
README
QQ Chat Exporter
将 QQ 聊天记录导出为 HTML、JSON、TXT 格式。支持定时备份、批量导出、表情包导出。
文档
访问 https://shuakami.github.io/qq-chat-exporter/ 查看使用文档。
快速开始
- 从 Releases 下载
- 运行
launcher-user.bat(Windows) 或./launcher-user.sh(Linux) - 用 QQ 扫码登录
- 复制控制台的 Token
- 打开
http://localhost:40653/qce-v4-tool
Docker 一键部署
适用于 macOS（含 Apple Silicon）、Linux、Windows，无需安装 QQ 客户端。
- 克隆仓库：
git clone https://github.com/shuakami/qq-chat-exporter.git - 启动：
cd qq-chat-exporter/docker && docker compose up -d - 查看 Token：
docker logs napcat-qce 2>&1 | grep -i token - 访问：
http://localhost:40653/qce-v4-tool
Apple Silicon (M1/M2/M3/M4) 通过 Rosetta 模拟运行，首次启动可能稍慢。
详见 Docker 部署指南。
相关项目
如果导出聊天记录后，想深入分析聊天内容可以试试 ChatLab
也可以试试 QQChatAnalyzer - 支持个人分析、群聊分析、社交网络可视化和 AI 摘要
还可以试试 QQ-Chat-AI-Analyzer - 基于 AI 的群聊消息总结分析工具，可生成年度报告
如果需要 Python API 封装，可以使用 napcat-qce-python
致谢
感谢 NapCatQQ 团队提供的框架支持。
许可证
Extension points exported contracts — how you extend this code
PrivateFetcher (Interface)* Issue #305 / #316：QQ NT 端在大批量条数下偶发慢，BatchMessageFetcher 的 * Promise.race 会在 timeout 触发 TIMEOUT_ERROR。原本下次重试还用同样的 batc [1 …
plugins/qq-chat-exporter/__tests__/unit/BatchMessageFetcher.adaptiveBatch.test.ts
ManualTask (Interface)
* Issue #163: 手动导出任务的备份组。形状和 ScheduledTask 几乎一致，多了 * groupKey / chatType / peerUid 用于在 UI 上区分会话；taskName 在 API 层 * 已经选
qce-v4-tool/components/ui/scheduled-backup-merge-dialog.tsx
APIResponse (Interface)
(no doc)
qce-v4-tool/types/api.ts
SortableSessionItem (Interface)
(no doc)
qce-v4-tool/lib/session-sort.ts
UseExportTasksProps (Interface)
(no doc)
qce-v4-tool/hooks/use-export-tasks.ts
ErrnoLike (Interface)
* 服务器启动失败时的可读诊断信息。 * * Issue #450：当 API 端口（默认 40653）被占用、或被 Windows 系统保留（WinNAT）时， * server.listen 会抛出 EADDRINUSE / EA
plugins/qq-chat-exporter/lib/utils/serverStartupError.ts
LoadingContextType (Interface)
(no doc)
qce-v4-tool/components/loading-provider.tsx
SystemInfo (Interface)
(no doc)
qce-v4-tool/types/api.ts
Core symbols most depended-on inside this repo
logcalled by 330
plugins/qq-chat-exporter/__tests__/helpers/MockNapCatCore.ts
push
called by 317
plugins/qq-chat-exporter/lib/core/parser/MessageParser.ts
get
called by 315
plugins/qq-chat-exporter/lib/core/parser/MessageParser.ts
cn
called by 226
qce-v4-tool/lib/utils.ts
error
called by 210
plugins/qq-chat-exporter/lib/utils/Logger.ts
set
called by 125
plugins/qq-chat-exporter/lib/core/parser/MessageParser.ts
warn
called by 88
plugins/qq-chat-exporter/lib/utils/Logger.ts
toString
called by 80
plugins/qq-chat-exporter/lib/core/parser/MessageParser.ts
Shape
Languages
TypeScript97%
Python3%
Modules by API surface
plugins/qq-chat-exporter/lib/core/exporter/ModernHtmlExporter.ts76 symbols
plugins/qq-chat-exporter/lib/api/ApiServer.ts76 symbols
plugins/qq-chat-exporter/lib/core/storage/DatabaseManager.ts75 symbols
plugins/qq-chat-exporter/lib/core/parser/MessageParser.ts68 symbols
plugins/qq-chat-exporter/lib/core/parser/SimpleMessageParser.ts65 symbols
plugins/qq-chat-exporter/__tests__/helpers/MockNapCatCore.ts56 symbols
plugins/qq-chat-exporter/lib/core/resource/ResourceHandler.ts52 symbols
qce-v4-tool/types/api.ts44 symbols
plugins/qq-chat-exporter/lib/core/exporter/JsonExporter.ts42 symbols
qce-v4-tool/app/page.tsx41 symbols
plugins/qq-chat-exporter/lib/security/SecurityManager.ts37 symbols
plugins/qq-chat-exporter/__tests__/fixtures/builders.ts34 symbols
Dependencies from manifests, versioned
@babel/core7.28.0 · 1×
@babel/generator7.28.0 · 1×
@babel/parser7.29.7 · 1×
@babel/preset-typescript7.24.7 · 1×
@babel/traverse7.28.5 · 1×
@babel/types7.28.2 · 1×
@breezystack/lamejs1.2.7 · 1×
@eslint/compat2.0.1 · 1×
@eslint/eslintrc3.3.3 · 1×
@eslint/js9.39.1 · 1×
@homebridge/node-pty-prebuilt-multiarch0.13.1 · 1×
@hookform/resolvers3.10.0 · 1×
For agents
$ claude mcp add qq-chat-exporter \
-- python -m otcore.mcp_server <graph>