Repository navigation
Release v1.0.0
v1.0.0
本次更新标志着 napcat-plugin-debug 迈向了更加成熟的阶段。我们对 CLI 工具进行了重构与独立化,新增了远程部署功能,并提供了更完善的 Vite 集成支持,旨在为 NapCat 插件开发者提供极致的热重载与远程调试体验。
✨ 新特性
- CLI 工具独立化:将 CLI 拆分为独立的 npm 包
napcat-plugin-debug-cli,支持更灵活的安装与使用。 - 远程部署功能:CLI 新增
--deploy(-d) 参数及deploy命令。支持将本地编译后的dist目录一键同步至远程 NapCat 插件目录并自动触发重载。 - Vite 插件支持:新增内置 Vite 插件
src/vite-plugin.ts。在开发模式下,支持 watch 模式自动推送变更,实现“保存即生效”的开发体验。 - 配置 UI 升级:优化了插件在 NapCat 面板中的配置界面,增强了安全提示(Token 相关)并提升了视觉交互效果。
- 自动化工作流:引入了 GitHub Actions 自动化发布流程,支持自动更新插件索引及生成 Release Note。
🐛 缺陷修复
- 构建兼容性修复:禁用了
bufferutil和utf-8-validate可选依赖,解决了在某些环境下打包失败或运行时的警告问题。 - 类型定义修复:锁定
@types/ws版本,修复了因类型不匹配导致的构建中断。
📝 文档更新
- 全新 README:编写了详尽的项目文档,涵盖:
- 插件核心架构说明。
- 详细的安装与配置步骤。
- CLI 工具与 Vite 插件的使用示例。
- 安全建议。
⚙️ 其他变更
- 日志格式优化:改进了服务端与 CLI 的日志输出格式,调试信息更加清晰易读。
- 代码重构:优化了
src/cli.ts的内部逻辑,采用更健壮的 RPC 调用机制和文件监听策略。
文件变更统计:
- 17 个文件被修改,新增 7910 行代码,删除 39 行。
- 核心逻辑集中在
src/cli.ts(部署逻辑) 和src/vite-plugin.ts(Vite 集成)。