NapCat v4.13.5

V4.13.5

使用文档

Windows 一键包

我们提供了轻量化的一键部署方案
相对于普通需要安装QQ的方案,下面已内置QQ和Napcat 阅读使用文档参考

你可以下载

NapCat.Shell.Windows.OneKey.zip (无头)

启动后可自动化部署一键包,教程参考使用文档安装部分

警告

注意QQ版本推荐使用 40768+ 版本 最低可以使用40768版本
默认WebUi密钥为随机密码 控制台查看

9.9.26-44343 X64 Win
LinuxX64 DEB 44343
LinuxX64 RPM 44343
LinuxArm64 DEB 44343
LinuxArm64 RPM 44343
MAC DMG 40990

如果WinX64缺少运行库或者xxx.dll？

安装运行库

更新

✨ 新增

1. OneBot 支持图片下载代理配置 (4bec3aa)
2. Shell 启动器新增进程崩溃保护机制，防止短时间内频繁异常重启 (76cbd8a)
3. WebUI 插件配置支持响应式 UI 与 SSE 实时更新，允许动态控制配置项显示 (34ca919)

🔧 优化

1. 移除 undici 依赖，改用内置实现处理代理下载逻辑 (6ea4c9e)
2. 优化插件配置 Schema 处理与后端接口响应逻辑 (34ca919)

---

完整更新日志: v4.13.3...v4.13.5

NapCat v4.13.3

V4.13.3

使用文档

Windows 一键包

我们提供了轻量化的一键部署方案
相对于普通需要安装QQ的方案,下面已内置QQ和Napcat 阅读使用文档参考

你可以下载

NapCat.Shell.Windows.OneKey.zip (无头)

启动后可自动化部署一键包,教程参考使用文档安装部分

警告

注意QQ版本推荐使用 40768+ 版本 最低可以使用40768版本
默认WebUi密钥为随机密码 控制台查看

9.9.26-44343 X64 Win
LinuxX64 DEB 44343
LinuxX64 RPM 44343
LinuxArm64 DEB 44343
LinuxArm64 RPM 44343
MAC DMG 40990

如果WinX64缺少运行库或者xxx.dll？

安装运行库

更新

🐛 修复

1. 修复 OpenAPI 导出接口缺失 stream 字段的问题 (b958e9e)
2. 修复下载插件后插件列表状态显示不正确的问题 (73fcfb5)

✨ 新增

1. 新增镜像管理与选择界面，支持测试镜像延迟 (129d63f)
2. 支持手动注册插件管理器到网络管理器 (7f05aee)

🔧 优化

1. 优化插件状态处理逻辑与目录查找机制 (699b46a)
2. 重构类型构建流程，简化构建脚本并内联外部类型 (542036f)
3. 优化 WebUI 插件商店组件，移除冗余属性 (b1b3573)

---

完整更新日志: v4.13.1...v4.13.3

NapCat v4.13.1

V4.13.1

使用文档

Windows 一键包

我们提供了轻量化的一键部署方案
相对于普通需要安装QQ的方案,下面已内置QQ和Napcat 阅读使用文档参考

你可以下载

NapCat.Shell.Windows.OneKey.zip (无头)

启动后可自动化部署一键包,教程参考使用文档安装部分

警告

注意QQ版本推荐使用 40768+ 版本 最低可以使用40768版本
默认WebUi密钥为随机密码 控制台查看

9.9.26-44343 X64 Win
LinuxX64 DEB 44343
LinuxX64 RPM 44343
LinuxArm64 DEB 44343
LinuxArm64 RPM 44343
MAC DMG 40990

如果WinX64缺少运行库或者xxx.dll？

安装运行库

更新

🔧 优化

1. 优化 WebUI API 调试工具的 Schema 解析与错误处理 (adabc4d)
2. 优化 TypeBox Schema 解析逻辑，支持循环引用检测并限制解析深度 (bf073b5, a712190)
3. 优化 WebUI 字体资源文件体积以提升加载速度 (AaCute.woff)

---

完整更新日志: v4.13.0...V4.13.1

NapCat v4.13.0

V4.13.0

使用文档

Windows 一键包

我们提供了轻量化的一键部署方案
相对于普通需要安装QQ的方案,下面已内置QQ和Napcat 阅读使用文档参考

你可以下载

NapCat.Shell.Windows.OneKey.zip (无头)

启动后可自动化部署一键包,教程参考使用文档安装部分

警告

注意QQ版本推荐使用 40768+ 版本 最低可以使用40768版本
默认WebUi密钥为随机密码 控制台查看

9.9.26-44343 X64 Win
LinuxX64 DEB 44343
LinuxX64 RPM 44343
LinuxArm64 DEB 44343
LinuxArm64 RPM 44343
MAC DMG 40990

如果WinX64缺少运行库或者xxx.dll？

安装运行库

更新

🐛 修复

1. 修复 Windows 部署说明文档中的文字错误 (a5e705e)

✨ 新增

1. 插件系统支持可视化配置界面（Config UI）与配置持久化 (d680328)
2. WebUI 新增插件配置管理弹窗，支持动态调整插件参数 (d711cde)
3. 新增插件日志接口（Logger Interface）及插件数据管理 API (001fe01, c5f1792)

🔧 优化

1. 重构插件管理器，仅支持目录形式插件以提升识别稳定性 (4b693bf, 574c257)
2. 优化插件系统类型安全，引入上下文操作（Context Actions）支持 (93126e5, 1ae10ae)
3. 调整 WebSocket 最大负载（maxPayload）为 50MB，优化内存占用 (008fb39)
4. 统一“闪照”相关接口描述为“闪传”，更符合当前功能定义 (001fe01)
5. 更新 Release 工作流，优化 OpenAPI 架构文件的发布路径 (007f1db)

---

完整更新日志: v4.12.8...v4.13.0

NapCat v4.12.8

V4.12.8

使用文档

Windows 一键包

我们为提供了轻量化一键部署方案
相对于普通需要安装QQ的方案,下面已内置QQ和Napcat 阅读使用文档参考

你可以下载

NapCat.Shell.Windows.OneKey.zip (无头)

启动后可自动化部署一键包,教程参考使用文档安装部分

警告

注意QQ版本推荐使用 40768+ 版本 最低可以使用40768版本
默认WebUi密钥为随机密码 控制台查看

9.9.26-44343 X64 Win
LinuxX64 DEB 44343
LinuxX64 RPM 44343
LinuxArm64 DEB 44343
LinuxArm64 RPM 44343
MAC DMG 40990

如果WinX64缺少运行库或者xxx.dll？

安装运行库

更新

✨ 新增

1. 实现插件商店后端真实安装逻辑，支持从远程仓库下载并部署插件 (24623f1)
2. 新增插件安装 SSE API，支持在 WebUI 实时查看插件安装进度状态 (6b8cc67)
3. WebUI 插件商店支持镜像源选择与切换界面 (6b8cc67)

🐛 修复

1. 修复 OpenAPI 构建脚本执行顺序问题，确保构建流程正确 (613690f)

🔧 优化

1. 重构插件商店数据类型定义，优化插件分类展示逻辑 (8b676ed)
2. 优化依赖管理，引入 TypeBox 并移除冗余的类型定义 (2998e04)

---

完整更新日志: v4.12.5...v4.12.8

NapCat v4.12.5

V4.12.5

使用文档

Windows 一键包

我们为提供了轻量化一键部署方案
相对于普通需要安装QQ的方案,下面已内置QQ和Napcat 阅读使用文档参考

你可以下载

NapCat.Shell.Windows.OneKey.zip (无头)

启动后可自动化部署一键包,教程参考使用文档安装部分

警告

注意QQ版本推荐使用 40768+ 版本 最低可以使用40768版本
默认WebUi密钥为随机密码 控制台查看

9.9.26-44343 X64 Win
LinuxX64 DEB 44343
LinuxX64 RPM 44343
LinuxArm64 DEB 44343
LinuxArm64 RPM 44343
MAC DMG 40990

如果WinX64缺少运行库或者xxx.dll？

安装运行库

更新

🐛 修复

1. 修复内置插件 Vite 编译钩子异常 (28c9761)
2. 修复在线文件发送逻辑中缺少文件大小字段的问题 (a60d8d1)

✨ 新增

1. 为 OneBot Action 增加 Payload 和 Return Schema 校验支持 (de9d518)
2. 核心库导出更多 API 与 Helper 工具类，增强开发者扩展性 (cc7ff526)

🔧 优化

1. 优化 napcat-types 依赖配置并升级至 0.0.2 (805cc32)
2. 更新项目文档链接与 README 说明 (791e359)

---

完整更新日志: v4.12.1...v4.12.5

NapCat v4.12.1

V4.12.1

使用文档

Windows 一键包

我们为提供了轻量化一键部署方案
相对于普通需要安装QQ的方案,下面已内置QQ和Napcat 阅读使用文档参考

你可以下载

NapCat.Shell.Windows.OneKey.zip (无头)

启动后可自动化部署一键包,教程参考使用文档安装部分

警告

注意QQ版本推荐使用 40768+ 版本 最低可以使用40768版本
默认WebUi密钥为随机密码 控制台查看

9.9.26-44343 X64 Win
LinuxX64 DEB 44343
LinuxX64 RPM 44343
LinuxArm64 DEB 44343
LinuxArm64 RPM 44343
MAC DMG 40990

如果WinX64缺少运行库或者xxx.dll？

安装运行库

更新

🐛 修复

1. 修复 delBuddy 方法名拼写错误及相关好友删除问题 (59d4b08)

✨ 新增

1. WebUI 配置支持灵活的 IP 访问控制列表 (63a9d57)
2. 新增 fetch_emoji_likes_all 接口支持获取全部表情回应 (b75b733)
3. 闪传功能支持自定义文件名与封面图 (246269b)

🔧 优化

1. 优化表情回应（Emoji Likes）的获取逻辑 (81e4e54)

---

完整更新日志: v4.12.0...v4.12.1

NapCat v4.12.0

V4.12.0

使用文档

Windows 一键包

我们为提供了轻量化一键部署方案
相对于普通需要安装QQ的方案,下面已内置QQ和Napcat 阅读使用文档参考

你可以下载

NapCat.Shell.Windows.OneKey.zip (无头)

启动后可自动化部署一键包,教程参考使用文档安装部分

警告

注意QQ版本推荐使用 40768+ 版本 最低可以使用40768版本
默认WebUi密钥为随机密码 控制台查看

9.9.26-44343 X64 Win
LinuxX64 DEB 44343
LinuxX64 RPM 44343
LinuxArm64 DEB 44343
LinuxArm64 RPM 44343
MAC DMG 40990

如果WinX64缺少运行库或者xxx.dll？

安装运行库

更新

🐛 修复

1. 修复表情点赞列表获取的相关问题 #1515 (58220d3)

✨ 新增

1. WebUI 新增插件市场功能，支持浏览和管理插件 (c2d3a80)
2. getMsgEmojiLikesList API 支持传入 cookie 参数以获取更多数据 (58220d3)
3. WebUI 网络配置支持为本地服务器 (localhost) 设置 Token 检查例外 (1976600)

🔧 优化

1. 优化 Markdown 消息解析逻辑，改进闪传消息的识别 (3c24d6b)
2. 优化 WebUI 插件管理器的错误提示与状态处理 (c2d3a80)
3. 改进消息解析中对 Markdown 元素的处理细节 (679c980)

---

完整更新日志: v4.10.47...v4.12.0

NapCat v4.10.47

V4.10.47

使用文档

Windows 一键包

我们为提供了的轻量化一键部署方案
相对于普通需要安装QQ的方案,下面已内置QQ和Napcat 阅读使用文档参考

你可以下载

NapCat.Shell.Windows.OneKey.zip (无头)

启动后可自动化部署一键包,教程参考使用文档安装部分

警告

注意QQ版本推荐使用 40768+ 版本 最低可以使用40768版本
默认WebUi密钥为随机密码 控制台查看

9.9.26-44343 X64 Win
LinuxX64 DEB 44343
LinuxX64 RPM 44343
LinuxArm64 DEB 44343
LinuxArm64 RPM 44343
MAC DMG 40990

如果WinX64缺少运行库或者xxx.dll？

安装运行库

更新

🐛 修复

1. 修复 macOS 平台已知兼容性问题 (d43c6b1)

✨ 新增

1. 支持 QQ 在线文件、文件夹发送及闪传功能 (75236dd)
2. 版本信息中新增运行时间 (Uptime) 展示 (857be5e)

🔧 优化

1. 重构消息 API 类型并为文件元素添加 elementId (2daddbb)
2. 优化类型注解与路由初始化逻辑 (01958d4)
3. 重构 DebugAdapter 以继承 IOB11NetworkAdapter (772f07c)
4. 更新 macOS (Apple Silicon) 平台的 ffmpegAddon 二进制文件 (0f9647b)
5. 优化 QQWrapper 加载逻辑，支持自定义路径参数 (d0519fe)
6. 新增内置插件包的构建脚本 (8197ebc)

---

完整更新日志: v4.10.46...v4.10.47

NapCat v4.10.46

V4.10.46

使用文档

Windows 一键包

我们为提供了的轻量化一键部署方案
相对于普通需要安装QQ的方案,下面已内置QQ和Napcat 阅读使用文档参考

你可以下载

NapCat.Shell.Windows.OneKey.zip (无头)

启动后可自动化部署一键包,教程参考使用文档安装部分

警告

注意QQ版本推荐使用 40768+ 版本 最低可以使用40768版本
默认WebUi密钥为随机密码 控制台查看

9.9.26-44343 X64 Win
LinuxX64 DEB 44343
LinuxX64 RPM 44343
LinuxArm64 DEB 44343
LinuxArm64 RPM 44343
MAC DMG 40990

如果WinX64缺少运行库或者xxx.dll？

安装运行库

更新

✨ 新增

1. 支持在回复消息构造中使用 msg_seq 参数 (37f40a2)
2. 新增 wavf32le 音频格式支持 (af8005d)

🔧 优化

1. 优化新版本提示组件的布局与样式 (6e8adad)
2. 改进更新检查逻辑及 WebUI 样式细节 (0f8584b)
3. 优化 Shell 启动器命名管道连接逻辑判断 (343行变化)

---

完整更新日志: v4.10.44...v4.10.46