插件开发概览
Neo-MoFox 插件系统为开发者提供了一套灵活、类型安全的组件模型,支持从目录、ZIP 压缩包或 .mfp 格式加载插件。
源码对齐说明
本章 API 与行为说明按当前 Neo-MoFox 实现对齐(CORE_VERSION = 1.0.0)。
前置知识
如果你还不了解 Neo-MoFox 插件系统的工作原理,建议先阅读 插件机制原理。
开发前准备
环境依赖
bash
# 安装项目依赖
uv sync
# 运行测试确认环境正常
pytest
# 运行代码检查
ruff check src/插件放置位置
插件应放置在项目根目录的 plugins/ 文件夹中:
Neo-MoFox/
└── plugins/
└── your_plugin/ # 目录形式
├── manifest.json
└── plugin.py框架也支持:
- ZIP 压缩包:
plugins/your_plugin.zip - MFP 包:
plugins/your_plugin.mfp(本质上是特殊后缀的 ZIP)
开始开发
插件结构
了解规范的插件目录组织。
manifest.json 格式
声明插件元数据与依赖。
组件总览
了解所有组件类型的作用与选择。
组件 API
各组件的基类方法与属性详解。
进阶开发
跨插件通信、热重载、LLM 高级用法。
