集成了 NapCat 和 QQ 聊天记录导出插件的开箱即用完整包。所有依赖已安装完毕，配置文件已预配置好，解压后直接运行即可使用。

v5.5.3 更新日志

会话搜索与列表重构

• 将会话列表逻辑提取为独立组件，修复搜索相关问题。感谢 @AstroAir 的贡献。
• 优化分页逻辑：当数据集缩小（如刷新后）且用户处于较大的页码时，系统会自动将页码克制在有效范围内，避免出现空白页。

依赖更新

• 升级 @typescript-eslint/parser 从 8.51.0 至 8.52.0。

下载

如何选择？

• Shell 模式：独立运行，需要单独登录 QQ，适合服务器部署和自动化备份
• Framework 模式：作为 QQNT 插件运行，与正在使用的 QQ 共享登录，适合 Windows 桌面用户

{
  "accessToken": "你的令牌在这里",
  ...
}

本软件完全免费开源，遵循 GPL-3.0 协议。如果有人向你收费，立即申请退款并举报。

使用文档 | 问题反馈 | NapCat 项目

贡献者

集成了 NapCat 和 QQ 聊天记录导出插件的开箱即用完整包。所有依赖已安装完毕，配置文件已预配置好，解压后直接运行即可使用。

🎉 2000 Stars！

感谢你们一路以来的支持！从最初的小工具到现在，QCE 能走到今天离不开每一位用户的反馈和贡献者的付出。

v5.5.2 更新内容

• 修复 Framework 模式启动脚本
• 新增 Umami 统计到落地页 (#265)
• 修复系统消息类型解析错误并补全所有已知元素类型 (#268)
• 新增 Material for MkDocs 文档站点
• 更新文档链接为 GitHub Pages
• 更新 Framework 模式说明和令牌查找方法
• 依赖更新：typescript-eslint, vite-tsconfig-paths, fast-xml-parser
• 批量模式下立即显示全选按钮 (#248, #251)
• 新增便携版 QQ 手动路径选择功能 (#261)

下载

如何选择？

• Shell 模式：独立运行，需要单独登录 QQ，适合服务器部署和自动化备份
• Framework 模式：作为 QQNT 插件运行，与正在使用的 QQ 共享登录，适合 Windows 桌面用户

{
  "accessToken": "你的令牌在这里",
  ...
}

本软件完全免费开源，遵循 GPL-3.0 协议。如果有人向你收费，立即申请退款并举报。

使用文档 | 问题反馈 | NapCat 项目

Contributors

集成了 NapCat 和 QQ 聊天记录导出插件的开箱即用完整包。所有依赖已安装完毕，配置文件已预配置好，解压后直接运行即可使用。

v5.5.1 更新内容

• 修复 Framework 模式使用说明
• 修复 JSONL 下载返回 404 的问题，改为打开文件夹 (#262)
• 修复 Linux/macOS 上打开 JSONL 目录时打开错误位置的问题

下载

如何选择？

• Shell 模式：独立运行，需要单独登录 QQ，适合服务器部署和自动化备份
• Framework 模式：作为 QQNT 插件运行，与正在使用的 QQ 共享登录，适合 Windows 桌面用户

本软件完全免费开源，遵循 GPL-3.0 协议。如果有人向你收费，立即申请退款并举报。

使用文档 | 问题反馈 | NapCat 项目

Contributors

集成了 NapCat 和 QQ 聊天记录导出插件的开箱即用完整包。所有依赖已安装完毕，配置文件已预配置好，解压后直接运行即可使用。

v5.5.0 更新内容

• 新增 NapCat Framework 模式支持 (#247) (#250)
• 新增 Framework 包到发布流程

下载

如何选择？

• Shell 模式：独立运行，需要单独登录 QQ，适合服务器部署和自动化备份
• Framework 模式：作为 QQNT 插件运行，与正在使用的 QQ 共享登录，适合 Windows 桌面用户

本软件完全免费开源，遵循 GPL-3.0 协议。如果有人向你收费，立即申请退款并举报。

使用文档 | 问题反馈 | NapCat 项目

Contributors

集成了 NapCat v4.10.10 和 QQ 聊天记录导出插件 v5.4.1 的开箱即用完整包。所有依赖已安装完毕，配置文件已预配置好，解压后直接运行即可使用。

v5.4.1 更新内容

依赖更新

• @types/node 25.0.2 → 25.0.3
• @typescript-eslint/parser 8.50.1 → 8.51.0
• typescript-eslint 8.50.1 → 8.51.0
• file-type 21.1.0 → 21.3.0
• globals 16.5.0 → 17.0.0

下载

本软件完全免费开源，遵循 GPL-3.0 协议。如果有人向你收费，立即申请退款并举报。

使用文档 | 问题反馈 | NapCat 项目

Contributors

集成了 NapCat v4.10.10 和 QQ 聊天记录导出插件 v5.4.0 的开箱即用完整包。所有依赖已安装完毕，配置文件已预配置好，解压后直接运行即可使用。

v5.4.0 更新内容

新增可配置的默认导出路径 (#242)

• 新增设置页面，支持自定义手动导出和定时备份的默认保存路径
• 支持任意磁盘和文件夹，不再限制必须在用户目录内
• 修复路径遍历安全漏洞，改用异步 I/O 操作
• 定时备份现在也会使用自定义路径

下载

本软件完全免费开源，遵循 GPL-3.0 协议。如果有人向你收费，立即申请退款并举报。

使用文档 | 问题反馈 | NapCat 项目

Contributors

集成了 NapCat v4.10.10 和 QQ 聊天记录导出插件 v5.3.1 的开箱即用完整包。所有依赖已安装完毕，配置文件已预配置好，解压后直接运行即可使用。

v5.3.1 更新内容

Bug 修复

• 修复定时导出任务自定义保存路径不生效的问题 (Issue #234)

下载

本软件完全免费开源，遵循 GPL-3.0 协议。如果有人向你收费，立即申请退款并举报。

使用文档 | 问题反馈 | NapCat 项目

Contributors

集成了 NapCat v4.10.8 和 QQ 聊天记录导出插件 v5.3.0 的开箱即用完整包。所有依赖已安装完毕，配置文件已预配置好，解压后直接运行即可使用。

v5.3.0 版本规范化里程碑

从此版本开始遵循语义化版本规范（SemVer），整合 v5.0.0 ~ v5.0.14 的所有更新。

✨ 新功能

导出功能增强

• 自定义导出路径 - 支持指定导出目录如 D:\exports，不再占用 C 盘空间 (#193)
• 文件名包含聊天名称 - 导出文件名可选包含群名/好友名，便于识别 (#216)
• JSONL 流式导出头像支持 - 分块 JSONL 导出现在支持嵌入头像 Base64 (#210)
• JSONL 导出添加时间范围和统计信息 - manifest.json 包含完整元数据 (#218)
• JSON 导出添加 selfUid/selfUin/selfName - 方便第三方工具判断消息发送者 (#195)

群组功能

• 群精华消息导出 - 支持导出群精华消息为 HTML/JSON/TXT 格式 (#224, #225)
• 好友列表突破 1000 人限制 - 使用分类 API 获取完整好友列表 (#226, #227)
• 手动输入 QQ 号导出 - 支持直接输入 QQ 号导出聊天记录，无需在列表中查找 (#227)

前端体验

• 懒加载好友/群组数据 - 自动递归加载全部数据，支持 1500+ 好友 (#189, #190)
• 错误页面和 404 页面 - 支持一键复制错误信息和提交 GitHub Issue
• 批量导出对话框完善 - 状态重置、快速导出选项、暗黑模式适配 (#211)
• Star 提示优化 - 每个会话只显示一次 Star 提示

版本管理系统

• 统一版本管理 - 创建集中式版本模块，前后端版本同步 (#228)
• Release 产物带版本号 - 文件名格式 NapCat-QCE-Windows-x64-v5.3.0.zip (#229)
• PR/dev 构建命名改进 - 格式 v5.3.0-pr123-abc1234 便于追溯 (#232)

🐛 修复

核心修复

• API 认证问题 - 修复登录后立即跳回认证页面的问题 (#179)
• Token 验证 - 修复独立模式假 Token 持久化到完整模式的问题 (#203)
• loadNapCat.js 路径错误 - 修复 NapCat 官方包中的路径问题
• 临时文件占用 C 盘 - 使用输出目录创建临时文件，自动清理遗留文件 (#192)

平台兼容性

• Linux/macOS QQ 路径检测 - 支持 NAPCAT_QQ_PATH 环境变量和常见路径自动检测 (#212)
• Linux qq_magic.so 预编译 - 打包时预编译，用户无需安装 build-essential (#212)
• FrontendBuilder 路径检测 - 使用 import.meta.url 修复 QQ 注入时的路径问题 (#230)

前端修复

• Edge 浏览器 DOM 错误 - 修复 insertBefore/removeChild 错误 (#197, #198, #200, #201)
• Edge 翻译功能冲突 - 添加 translate=no 禁用翻译，Monkey patch DOM 操作
• 自定义路径 HTML 图片显示 - 修复资源路径问题，使用绝对 API 路径 (#213, #215)

📦 依赖更新

• typescript-eslint 8.49.0 → 8.50.1
• winston 3.18.3 → 3.19.0
• @eslint/compat 1.4.1 → 2.0.0
• vite 7.2.4 → 7.3.0
• vite-tsconfig-paths 5.1.4 → 6.0.3
• esbuild 0.25.11 → 0.27.2
• express 5.1.0 → 5.2.1

下载

本软件完全免费开源，遵循 GPL-3.0 协议。如果有人向你收费，立即申请退款并举报。

使用文档 | 问题反馈 | NapCat 项目

Contributors

集成了 NapCat v4.10.8 和 QQ 聊天记录导出插件 v5.0.14 的开箱即用完整包。所有依赖已安装完毕，配置文件已预配置好，解压后直接运行即可使用。

v5.0.14 更新内容

feat: improve PR/dev build artifact naming with version info (#232)

• PR builds: v5.0.12-pr123-abc1234
• Push builds: v5.0.12-dev-abc1234
• Artifact name now includes full version for easy identification
• fix: correct YAML syntax in build-plugin workflow
• chore: bump version to 5.0.14

下载

本软件完全免费开源，遵循 GPL-3.0 协议。如果有人向你收费，立即申请退款并举报。

使用文档 | 问题反馈 | NapCat 项目

Contributors

集成了 NapCat v4.10.8 和 QQ 聊天记录导出插件 v5.0.13 的开箱即用完整包。所有依赖已安装完毕，配置文件已预配置好，解压后直接运行即可使用。

v5.0.13 更新内容

fix: 修复 build-plugin artifact 路径匹配 (#231)

• fix: use import.meta.url for static path detection in FrontendBuilder
  When NapCat injects into QQ process, process.cwd() returns QQ's
  installation directory instead of NapCat release package root.
  This causes /qce-v4-tool route to return 404 error.
  Solution: Use import.meta.url to get the module's actual path and
  calculate NapCat root directory from there, which is the recommended
  approach for ES modules.
  Fixes: User report via email (hazelhyde)
• fix: update build-plugin artifact path to match versioned filenames

fix: use import.meta.url for static path detection in FrontendBuilder (#230)

When NapCat injects into QQ process, process.cwd() returns QQ's
installation directory instead of NapCat release package root.
This causes /qce-v4-tool route to return 404 error.
Solution: Use import.meta.url to get the module's actual path and
calculate NapCat root directory from there, which is the recommended
approach for ES modules.
Fixes: User report via email (hazelhyde)

• chore: bump version to 5.0.13

下载

本软件完全免费开源，遵循 GPL-3.0 协议。如果有人向你收费，立即申请退款并举报。

使用文档 | 问题反馈 | NapCat 项目

Contributors