mpdt dev
dev 命令是 mpdt 的灵魂所在,它为你提供了一个现代化的、支持热重载的开发环境。简单来说,就是让你“边开飞机边换引擎”。
命令用途
在传统的插件开发中,每次修改代码后,你都需要“重启大法”才能看到效果。mpdt dev 彻底改变了这一点:
- 文件监控:它会实时监控你插件目录下的文件变动。
- 自动重载:一旦你保存了文件,
mpdt会自动在运行的 Neo-MoFox 实例中重载你的插件。 - 无缝衔接:无需重启整个 Bot,你的改动就能立刻生效。
- 生命周期管理:自动处理插件的卸载和加载逻辑,确保环境干净。
这种“保存即刷新”的体验,能极大地提升你的开发效率和幸福感。
语法格式
bash
mpdt dev [OPTIONS] [PATH]PATH: 要进行热重载开发的插件项目路径。如果省略,默认为当前目录。
选项详解
| 选项 | 缩写 | 描述 | 默认值 |
|---|---|---|---|
--neo-mofox-path | 指定 Neo-MoFox 主程序的根目录路径。 | (从配置读取) | |
--plugin-path | 指定要进行热重载开发的插件路径。 | 当前目录 |
工作原理
mpdt dev 的背后是一个名为 DevBridge 的内置插件。当你运行 mpdt dev 时,它会:
- 找到并启动你指定的 Neo-MoFox 主程序。
- 将
DevBridge插件和你的目标插件注入到 Neo-MoFox 中。 DevBridge负责启动文件监控服务 (watchdog)。- 当你修改并保存文件时,
DevBridge会捕捉到这个事件。 - 它会先调用插件管理器的 API 卸载你的旧插件,然后再重新加载新版本。
- 所有这一切,都在同一个 Bot 进程中完成。
使用示例
基础用法
首先,你需要配置 Neo-MoFox 的路径。如果你是第一次使用,mpdt 会引导你进行配置:
bash
# 第一次运行时,会提示你输入 Neo-MoFox 的路径
mpdt config init
# 配置好后,进入你的插件目录
cd my-awesome-plugin
# 然后启动开发模式
mpdt dev临时指定主程序路径
假设你同时在维护两个不同版本的 Neo-MoFox,你可以临时指定要使用的版本:
bash
mpdt dev --neo-mofox-path /path/to/another/neo-mofox常见场景
场景1:实时调整 Chatter 的对话逻辑
你正在微调 Chatter 组件的对话策略,希望能立刻看到不同提示词或逻辑分支的效果。mpdt dev 能让你像在线编辑一样,实时观察 Bot 对话风格的变化。
mpdt dev 是 mpdt 工具链中的“杀手级应用”。一旦你习惯了这种流畅的开发体验,就再也回不去了。

