Skip to content

MPDT: 你的插件开发启动器

版本说明

本文档对齐 mofox-plugin-toolkit v0.4.10 版本

如果你正准备为 Neo-MoFox 开发插件,却被“第一步该干啥”卡住,那么 mpdt 就是你的救星。

mpdt (mofox-plugin-toolkit) 是一个命令行工具,一个纯粹的脚手架,专为简化 Neo-MoFox 插件开发的全过程而生。它的使命只有一个:让你告别繁琐的手动配置,专注于核心逻辑的实现。忘记那些“该建什么目录”、“manifest 该怎么写”的烦恼吧,有这时间不如多摸会儿鱼。

核心特性

mpdt 把插件开发的生命周期浓缩为几个简单命令:

  • init: 一键生成标准插件结构,自带多种模板,从“能跑就行”到“全家桶”任君选择。
  • generate: 快速生成组件代码,无论是 Action 还是 Tool,告别手写样板代码。
  • check: 8 层静态检查,从目录结构到代码风格,全方位扫描你的插件,还能自动修复,堪称代码洁癖的福音。
  • build: 将你的插件打包成标准的 .mfp 文件,版本号?自动升!
  • dev: 启动热重载开发模式,保存即刷新,让你享受现代前端开发般的丝滑体验。
  • config: 交互式管理工具配置,再也不用满世界找配置文件了。

🤖 AI 助手增强

MPDT 提供了 Skill 文件 (SKILL.md),让 GitHub Copilot、Cursor 等 AI 助手能按照最佳实践自动帮你执行完整的插件开发流程。查看 AI Skill 安装指南 了解详情。

快速开始:三分钟上手

想体验一下?只需三步,从零到拥有一个能跑的插件:

1. 初始化项目

选个你喜欢的目录,然后运行:

bash
mpdt init my-first-plugin --template full

my-first-plugin 就是你的插件目录,--template full 表示使用功能最全的模板。

2. 进入开发模式

bash
cd my-first-plugin
mpdt dev

mpdt 会自动找到你的 Neo-MoFox 主程序,并以热重载模式启动。现在,你可以随便修改插件里的代码,保存一下,看看控制台的变化。

3. 检查与打包

开发得差不多了?是时候让 mpdt 给你“体检”一下了。

bash
# 运行检查,并尝试自动修复问题
mpdt check --fix

# 检查通过,打包发布!
mpdt build --bump patch

dist/ 目录下会生成一个 .mfp 文件,这就是你的插件成品。把它丢进 Neo-MoFox 的 plugins 目录,大功告成!


mpdt 的设计哲学是“约定优于配置”。它提供了一套经过验证的最佳实践,让你在正确的轨道上起步。当然,它也足够灵活,当你成为老司机后,可以完全定制自己的工作流。

💡 想让 AI 帮你开发插件?

MPDT 提供了完整的 Skill 文件支持,让 GitHub Copilot、Cursor 等 AI 助手能够自动按照最佳实践执行开发流程。只需在对话中说"使用 MPDT 创建插件",AI 就会帮你搞定一切。查看 AI Skill 安装指南 了解如何启用。

现在,让我们从 安装 开始,正式进入 mpdt 的世界。

贡献者

The avatar of contributor named as minecraft1024a minecraft1024a

页面历史

Released under the GPL-3.0 License.

新对话
MoFox 助手

下午好。

今天想做点什么?

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