热重载与调试

把加载和行为分开检查

先确认 plugin.json、hooks.json 和模块路径有效，再检查事件和渲染逻辑。相对路径从 hooks 清单所在目录解析，扩展名和导出方式要与当前工具链一致。

使用本机 CLI

claude plugin validate ./your-plugin
claude plugin test --help

命令可用性和测试参数可能随版本变化，请先看 claude plugin --help。本站不自动执行发现到的 mod，验证也不能代替行为测试。

热重载

依照当前官方文档开启开发模式。每次模块重载都要释放定时器、订阅、进程和网络连接，避免事件被重复注册。

一个有效的调试记录

记录 CLI 版本、模组版本、触发事件、预期与实际行为。用一个最小仓库复现；不要在日志中输出 API key、用户代码或完整对话。