Skip to content

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 时,它会:

  1. 找到并启动你指定的 Neo-MoFox 主程序。
  2. DevBridge 插件和你的目标插件注入到 Neo-MoFox 中。
  3. DevBridge 负责启动文件监控服务 (watchdog)。
  4. 当你修改并保存文件时,DevBridge 会捕捉到这个事件。
  5. 它会先调用插件管理器的 API 卸载你的旧插件,然后再重新加载新版本。
  6. 所有这一切,都在同一个 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 devmpdt 工具链中的“杀手级应用”。一旦你习惯了这种流畅的开发体验,就再也回不去了。

贡献者

The avatar of contributor named as minecraft1024a minecraft1024a

页面历史

Released under the GPL-3.0 License.

新对话
MoFox 助手

下午好。

今天想做点什么?

聊天内容可能会被记录以用于改进服务及其质量,并会遵循我们的隐私政策进行处理。