插件编辑器

提示

插件编辑器可能于后续版本(>=2.3.3)做出调整

插件编辑器介绍

插件编辑器是 Nekro Agent 内置的插件开发工具。它集成了 AI 辅助功能，预置了 Nekro Agent 插件开发知识，能够根据自然语言需求描述快速生成或修改插件代码。

对于不熟悉代码的用户，插件编辑器可以直接完成一些简单插件的开发；对于有开发经验的用户，它能显著加速插件原型搭建和迭代。

使用流程

基本操作步骤

1. 在 WebUI 的「插件管理」中点击「插件编辑器」
2. 新建插件或选择已有插件
3. 在编辑器旁的「插件需求」输入框中描述您的需求
4. 点击「AI 生成」，等待 AI 分析需求并生成修改意见
5. 点击「应用到编辑器」，等待 AI 将修改意见应用到代码中
6. 检查代码，确认无误后点击「保存」

新建插件

新建插件时，编辑器会生成基础的插件模板代码。您可以直接在此基础上通过 AI 辅助生成功能来填充业务逻辑，也可以手动编辑。

修改已有插件

选择已有插件后，可以在需求描述中说明要修改的内容。AI 会基于现有代码生成针对性的修改方案。

启用插件

完成插件编辑后，在插件编辑器中点击「启用插件」。如果插件加载正常，可以在「插件管理」列表中看到该插件的信息和状态。

如果加载失败，检查日志中的错误信息，常见原因包括语法错误、缺少依赖或 API 使用不当。

AI 能力模型配置

编辑器的 AI 辅助能力依赖两个独立的模型组，在「系统配置」→「基本配置」中配置：

插件代码生成模型组 - [PLUGIN_GENERATE_MODEL_GROUP]

负责分析需求、理解现有代码并生成修改方案。建议使用编码和推理能力较强的模型，例如：

• claude-opus-4.6
• gpt-5.5
• gemini-3.0-pro

插件代码应用模型组 - [PLUGIN_APPLY_MODEL_GROUP]

负责将修改方案准确地应用到代码中。建议使用速度快、指令遵从性高的模型，例如：

• gemini-3.0-flash
• gpt-5.4-mini

TIP

两个模型组的职责不同：生成模型组侧重理解和推理，应用模型组侧重精确执行。选型时应分别考虑。

使用建议

• 需求描述越具体，生成质量越高。尽量说明插件的触发场景、输入输出和期望行为
• 复杂插件建议分步生成，先完成核心功能，再逐步添加细节
• 生成后务必检查代码逻辑，AI 生成的代码不保证在所有边界情况下都正确
• 如果生成结果不理想，尝试换一种方式描述需求，或提供更多上下文

相关文档

• 插件使用原则
• 插件开发引言
• 插件开发快速上手