如何以 unread_dot 为例在 Agent Zero 中创建、测试并审查一个本地 Web UI 插件【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero如果你的目标是理解 Agent Zero 的插件机制官方给的最短路径不是先读架构文档而是亲手做一个足够小、能装进脑子里的插件unread_dot。它在一个未选中的会话收到新的 agent 活动时在聊天列表中给该会话旁边显示一个脉冲小圆点当你重新打开那个会话圆点消失。这个例子刻意保持最小不添加服务端点、不添加工具、不安装包、不发网络请求只改动 Web UI 和一个浏览器localStorage键。因此你不需要一次学会插件的所有能力就能看完整体形态。本文按「创建 → 测试 → 审查」三步走完这个插件全部操作在运行中的 Agent Zero 实例的 Web UI 中完成。让 Agent Zero 按明确约束生成插件打开一个新会话把插件任务以非常具体的形式交给 Agent Zero。官方给出的提示词如下注意关键部分是给出插件名、位置、可见行为和边界而不是措辞本身Use the a0-create-plugin skill. Create a local-only plugin named unread_dot in /a0/usr/plugins/unread_dot. The plugin should show a pulsing dot in the chat list whenever a non-selected chat receives new agent activity. Keep it minimal and frontend-only: - no external dependencies; - no backend API; - no tools; - no network calls. If the plugin already exists, improve it instead of creating a duplicate. When finished, run the a0-review-plugin skill on unread_dot and summarize PASS/WARN/FAIL. Do not run CodeRabbit.这条提示词同时指定了创建用a0-create-plugin技能、插件位置、前端限定边界并要求完成后用a0-review-plugin技能做审查。本地插件必须放在/a0/usr/plugins/plugin_name/下——/a0/plugins/目录预留给核心系统插件不要占用。生成出来的文件长什么样创建完成后插件在运行实例中的最终结构是/a0/usr/plugins/unread_dot/ ├── plugin.yaml ├── README.md ├── extensions/ │ └── webui/ │ ├── apply_snapshot_before/ │ │ └── track-unread.js │ └── initFw_end/ │ └── bootstrap-unread-dot.js └── webui/ ├── unread-dot.css └── unread-dot-store.js各文件的分工plugin.yaml是插件的名称标签。本例的内容为name: unread_dot title: Unread Dot description: Shows a pulsing dot beside chats that received new activity while you were elsewhere. version: 1.0.0 settings_sections: [] per_project_config: false per_agent_config: falsesettings_sections: []表示不在设置标签页中显示本插件的子节。initFw_end/bootstrap-unread-dot.js在 Web UI 启动后加载 store 和样式表是插件进入运行界面的「小门」之一。apply_snapshot_before/track-unread.js观察状态快照让插件能注意到另一个会话发生变化。unread-dot-store.js保存未读状态unread-dot.css绘制圆点本身。重启后按步骤实测行为创建或修改插件后重启 Agent Zero让 Web UI 扩展列表重新构建。然后按以下顺序测试打开一个新会话。发送一条简短提示例如Please reply with one short sentence: unread dot live test complete.立刻切换到另一个会话。等待 Agent Zero 在第一个会话中继续工作。查看聊天列表。判断标准当第一个会话处于未选中状态时收到新活动圆点出现再次打开该会话时圆点清除。这两点都成立说明插件真正工作。一个边界说明这个例子观察的是「会话活动」在正常使用中意味着「agent 在你没看的会话里做了事」它不会读取其他每个会话里的每条消息。用 a0-review-plugin 做四阶段审查把插件当作完成品之前运行审查技能Use the a0-review-plugin skill to review /a0/usr/plugins/unread_dot. Report PASS/WARN/FAIL by phase.审查覆盖四个阶段manifest 校验、目录结构、代码模式Store Gating、通知系统、导入路径、安全与社区索引查重。文档给出的unread_dot审查结果如下作为文档示例参考PhaseResultNotesManifestPASSplugin.yaml有效命名正确使用简单本地设置。StructurePASS with WARN布局标准。缺少LICENSE本地无妨但会阻塞 Plugin Index 提交。Code patternsPASS with WARNstore 使用了 Agent Zero 的createStore模式未读信号是会话活动而非解析消息作者。Security and indexPASS with WARN无密钥、子进程、依赖或外呼社区索引已有相关的Chat Status Marklet插件除非做出明显差异否则本例应视为学习示例。示例结论是作为本地演示插件已就绪在补上许可证、并与同类插件形成明确区分之前尚不适合作为新的社区提交。审查阶段的检查点可以对照 a0-review-plugin 技能定义 逐项核对插件规范则参考 a0-create-plugin 技能定义。在最小可用之后改一处、测一次等小版本真正工作后再扩展并且一次只改一处例如把圆点移到列表行的其他位置用 badge 代替圆点为颜色或动画增加一个插件设置项对运行中的会话和已完成的会话显示不同状态把它变成可发布项目补LICENSE、截图和更清晰的 README。相关文档Create A Small Plugin本文的完整来源包含提示词、文件结构与审查示例。Usage Guide插件在 Web UI 中的出现位置Plugins 对话框、Plugin Hub。Plugins And Development Workflow插件开发工作流与验证方式。【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考