Skip to content

Release v1.0.3

Choose a tag to compare

@github-actions github-actions released this 08 Feb 16:46
· 5 commits to master since this release

v1.0.3 (2026-02-08)

本次更新重点增强了对包含前端界面(WebUI)的插件开发支持,扩展了文件监视范围,并优化了开发过程中的热重载体验。

✨ 新特性

  • 支持 WebUI 自动化构建与部署
    • 在 napcatHmrPlugin 中新增 webui 配置项。
    • 支持在主插件构建完成后,自动触发前端子项目(如 Vite + React/Vue 或纯 HTML 项目)的构建。
    • 支持自动将 WebUI 产物(dist)同步至远程 NapCat 插件目录的指定子目录。
  • 扩展文件监视(Watch)类型
    • 大幅增加了 CLI 和 Vite 插件支持的文件后缀,现在可以监视并触发更新的文件包括:
      • 脚本/组件:.jsx, .tsx, .vue, .svelte, .cts
      • 样式/模板:.html, .css, .scss, .sass, .less, .styl
      • 资源文件:.svg, .png, .jpg, .jpeg, .gif, .webp, .ico

⚙️ 其他变更

  • 优化文件过滤逻辑
    • 改进了 Watcher 的忽略规则,现在会自动跳过 node_modules、.git、dist、build、.vite 等构建产物和隐藏目录,显著降低 CPU 占用并减少无效的热重载触发。
  • CLI 增强
    • 同步更新了 CLI 工具的内部逻辑,以匹配核心库的文件处理能力。

💡 WebUI 配置示例

现在你可以在 vite.config.ts 中轻松配置前端同步:

napcatHmrPlugin({
  // ... 其他配置
  webui: {
    root: './webui',           // 前端项目根目录
    buildCommand: 'npm run build', // 构建命令
    distDir: './webui/dist',   // 产物目录
    targetDir: 'webui',        // 部署到插件目录下的 webui 文件夹
  }
})

感谢使用 NapCat Plugin Debugger!如有问题欢迎提交 Issue。