插件协议

一个协议，描述智能体拥有的每一种能力。

领域能力——注入的方法论、领域参考资料、评审纪律——都以插件交付：一个遵循同一个小协议的普通文件夹，即开放 Agent Plugins 1.0.0 格式。不需要为不同类型的扩展学习不同的分类法。一个格式、一步安装、一条把领域能力交给工作智能体的路径——而工具面不动：插件注入的是技能与资源，节点执行时用的工具由引擎按角色固定。

插件是什么

插件是 nebflow 插件目录（~/.nebflow/plugins/<name>/）下的一个目录：

my-plugin/
├── plugin.json        # manifest（必需）
└── skills/
    └── my-method/
        ├── SKILL.md   # 全文注入会话
        └── <resources>  # 该技能引用的可选支撑文件
  • 插件必须提供至少一项技能：skills/<name>/SKILL.md。技能引用的支撑文件就放在它旁边
  • 未知字段与未知文件夹忽略并告警，因此插件随协议成长保持向前兼容

manifest

plugin.json 遵循开放的 Agent Plugins 1.0.0 格式：

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "explorer-toolkit",
  "version": "1.0.0",
  "description": "Codebase exploration and solution-planning methodology."
}
  • name 是唯一必填字段；version 与 description 是目录与插件面板展示的内容
  • nebflow 自带真实插件可作范例阅读：explorer-toolkit（探索与方案规划方法论）与 design-spec（UI/UX 设计评审方法论）——两者都是由方法论技能组成的能力包
  • manifest 每个字段详见插件配置参考

插件提供什么

能力如何到达智能体
Skills分到插件的会话，其 skills/<name>/SKILL.md 会被全文注入——智能体把它当作操作指引执行，无需手动查阅
资源技能引用的支撑文件——参考资料、素材、脚本——随插件同行，由技能指引按需读取

这就是全部面。插件给节点加的是知识与资源，不是工具。节点的工具面来自引擎、按角色固定，因此两个技能相同的插件，运行时的工具也完全相同。

安装插件

插件很强大——注入的指令会左右节点做的一切——所以不装就不运行。装什么由你决定，而安装本身就是那个决定：没有额外的关卡要过。

  • 你没安装的插件就是不存在：不能分配给任何节点，技能也不注入
  • 安装插件时摊开给你看的就是你将引进来的东西：元信息、每个 skill 的正文预览、以及随插件交付的每一个文件
  • 安装时记录插件全部内容的 digest。
  • 安装也是运行时属性：已安装插件的内容若在会话使用中与安装时记录的 digest 不再一致，其技能立即撤出，会话收到通知

在应用的插件面板中安装或移除，也可用命令行：nebflow plugin list、nebflow plugin approve <name>、nebflow plugin revoke <name>。

插件目录

已安装的插件进入插件目录——任务分发器规划工作时看到的能力包清单。从没安装过的插件不会出现在那里。目录就是专化被选中的方式：分发器按任务逐名挑选插件。

把插件分配给节点

能力附着在真正干活的地方：

  • 项目里每个节点都带着分配给它的插件运行——按节点指派，不是全局；一组指派可以存成预设（preset）复用
  • 节点启动那一刻，它的会话恰好携带这些能力：技能注入、资源就位。运行中无需安装
  • 把缺失或未安装的插件分配给节点，节点会响亮失败——能力缺口绝不被静默忽略
  • 节点结束时，注入的技能随会话一同结束。没有任何东西留在后台运行

插件在全局中的位置