v0.4.4

[magisk317]

0.4.4

亮点

• 全面迁移 ESM：main 包声明 type: module，构建切换到 esbuild (via tsx build.ts)，产物为 ESM，修复 GramJS 子路径导入在 Node 22 下的加载问题。
• 网络栈精简：移除 axios/reconnecting-websocket，统一使用 Node 22 原生 fetch（undici）与自研 ReconnectingWebSocket，减少依赖并强化自动重连。
• NapCat 适配强化：WebSocket 支持重连，收消息时自动补齐媒体直链（get_file/get_record/get_image），语音/文件/图片可直接下载。
• 媒体处理更鲁棒：下载支持超时与本地路径兜底，NapCat 录音自动尝试 .amr.wav，失败时抛出明确错误。
• QQ 头像代理接口：新增 /qqAvatar/:userId 代理 QQ 头像并加缓存头，避免前端跨域/证书问题。
• CI/文档：优化路线图同步完成项；CI 拆分与修复（Prisma fake DATABASE_URL、canvas 依赖、重命名发布流程）。

详细变更

• ESM 构建链路
  • package.json 设为 type: module，tsconfig 改为 module: ESNext、moduleResolution: Bundler。
  • 构建脚本仅运行 tsx build.ts（移除重复 tsc），esbuild 输出 ESM 并注入 __dirname/__filename/require banner。
  • GramJS 相关导入统一追加 .js 后缀，避免 Node 22 的模块解析错误。
• 网络/依赖
  • 删除 axios、reconnecting-websocket；新增/升级 undici 用法、file-type@19、fast-xml-parser、fluent-ffmpeg。
  • ReconnectingWebSocket（零依赖）提供指数退避重连，NapCat 适配器直接使用。
  • fetchFile 等工具统一走 undici，允许自签证书（rejectUnauthorized: false）。
• NapCat 客户端
  • WebSocket 断线自动重连；上线/下线事件透传。
  • 收到媒体时调用 get_file/get_record/get_image 填充直链，语音兼容 mp3 转码返回。
  • 日志与错误处理更细，避免解析失败导致崩溃。
• 媒体转发
  • MediaFeature.downloadMedia 使用原生 fetch + AbortController；支持本地路径与 .amr → .wav 兜底。
  • 图片/视频/音频处理在文件不可读时回退到 URL 下载，错误信息更明确。
  • 单测改为 mock undici.fetch，覆盖异常分支。
• Telegram/GramJS
  • 所有 Telegram SDK 子路径改为显式 .js 导入，确保 ESM 解析；运行时不再出现 ERR_MODULE_NOT_FOUND。
• 接口与工具
  • 新增 GET /qqAvatar/:userId，转发 QQ 头像并加一天缓存。
  • URL 工具与头像/大脸获取统一用 undici，减少重复实现。
• CI/流程
  • CI 拆分：check/workflow 调整、fake DATABASE_URL 供 prisma generate，补齐 canvas 依赖；主发布流程重命名为 docker-publish.yml。
  • 优化路线图标记已完成项（启动 chown 移除、HTTP 客户端统一、WebSocket 重连、自研构建链路简化）。

兼容性与升级提示

• Node.js 需 >= 22（保持与 engines 一致）。若有自定义脚本/插件使用 CommonJS require，请按 ESM 规则或使用 createRequire。
• GramJS/Telegram 相关自定义导入需带 .js 后缀；第三方手写扩展如未更新可能报模块解析错误。
• NapCat WebSocket 如需关闭自动重连，可在创建参数中禁用 reconnect。

Full Changelog: v0.4.3...v0.4.4

---

This discussion was created from the release v0.4.4.