3.11、Agent协同开发
Agent协同开发是把 Agent客户端（WorkBuddy / Codex）与 CMS 工程通过 MCP 打通，让开发者用一句自然语言描述需求，就能在 CMS 里自动生成页面、落地组件与配置，并对着生成结果持续对话迭代。
3.11.1、功能说明
- MCP 打通 CMS 工程：Agent客户端以技能（Skill / 插件）的形式接入 CMS 服务，直接读写当前打开的 CMS 工程，无需手工导出导入工程文件。
- 自然语言页面开发：在 WorkBuddy 新建任务、描述页面需求，AI 自动生成页面并直接写入 CMS 工程，生成的看板/监控页可在 CMS 编辑器中继续调整。
- 实时预览与对话式迭代：任务完成后 WorkBuddy 会返回页面预览地址，可直接在浏览器查看，也可打开 CMS 查看；效果不符合要求时，在同一个任务对话框里继续提要求即可。
3.11.2、核心优势
1. 从"拖拽组态"到"一句话描述"
传统组态开发需要在编辑器里逐层搭建页面骨架、逐个放置组件、再逐个绑定变量。Agent协同开发把这一步交给 Agent工具："生成锂电叠片机监控看板并转为CMS页面" 这样一句话，就能直接产出可用的 CMS 页面初稿，人力从"搭页面"转向"审页面"。
2. 生成即落地，预览即可见
页面不是停留在聊天窗口里的代码片段，而是直接成为 CMS 工程里的真实页面。同时 WorkBuddy 返回预览地址，形成"描述 → 生成 → 预览 → 反馈 → 调整"的闭环，不需要来回切换工具。
3. 一次配置，长期复用
插件安装与 MCP 配置由 CMS 托盘自动完成，AIgent客户端侧的技能（Skill）也可被后续任务反复调用。相比手工配置 MCP 服务地址、端口与鉴权，这种方式把协同开发的初始化成本降到接近零。
3.11.3、典型使用场景
场景一：桌面端一句话生成监控看板
背景：现场有一台装了 CMS 的工程师电脑，需要快速做一张锂电叠片机监控看板。
AI方式：
- 工程师打开 CMS 托盘的「主页 → Agent协同开发」，确认 WorkBuddy 状态为「已安装」。
- 在 CMS 工程管理界面新建一个空白工程并打开。
- 回到 WorkBuddy 新建任务，输入："生成锂电叠片机监控看板并转为CMS页面"。
- 任务完成后，通过 WorkBuddy 返回的预览地址查看页面；也可直接打开 CMS 查看生成结果。
- 若效果不符合要求，在 WorkBuddy 任务对话框继续输入，让它调整。
场景二：Web 端远程协同开发异地 CMS 工程
背景：工程师在办公网通过 Web 端访问另一台设备上的 CMS 工程，本地并没有那台机器的桌面环境。
AI方式：
- 在 Web 端打开 CMS 工程界面，点击右上角的「Agent协同开发」图标。
- 以 WorkBuddy 为例，点击复制任务指令（指令中已包含插件包地址、CMS 服务地址、插件版本等信息）。
- 在 WorkBuddy 新建任务，粘贴指令并发送，等待任务完成。
- 完成后即可在 WorkBuddy 上发送页面需求，进行远程 CMS 页面开发。
3.11.4、5 分钟快速上手
步骤1：安装 WorkBuddy（或 Codex）
打开官网 https://www.workbuddy.cn 下载安装，安 装时选择 "仅为我安装"，然后一直点击"下一步"，按默认选项直到安装完成。
步骤2：安装 CMS
安装 CMS，最低版本为 CMS Editor 26H1-V2.40.5。安装步骤参考官方文档：
https://cms-docs.shengyc.com/cms/tutorial/快速入门/软件安装
步骤3：确认 Agent 协同开发插件已就绪
以上都安装完成后，运行 CMS，然后在桌面右下角找到 CMS 的托盘程序，打开托盘。
弹出托盘后，进入「主页 → Agent协同开发」，检查是否已成功自动安装插件：
-
WorkBuddy 显示 "已安装" → 就绪，可点击「检查更新」保持为最新版本。
-
如果显示未安装，请点击「重试」，或检查 WorkBuddy 是否安装成功：
步骤4：在 CMS 中创建并打开空白工程
在 CMS 工程管理界面创建空白工程并打开：
- 打开工程管理界面；
- 点击「新建空白工程」；
- 双击鼠标左键进入工程。
步骤5：回到 WorkBuddy，新建任务并描述页面需求
在 WorkBuddy 中点击「新建任务」，在输入框中描述你的 CMS 页面需求，等待任务完成。任务完成后，可以通过 WorkBuddy 返回的预览地址查看 CMS 页面，也可以打开 CMS 进行查看。如果效果不符合要求，可以在 WorkBuddy 任务对话框继续输入，让它调整。
需求描述示例如下（三种粒度，任选其一）：
生成锂电叠片机监控看板并转为CMS页面
生成符合CMS规范的锂电叠片机监控看板页面
生成锂电叠片机监控看板html页面
第三种方式下 WorkBuddy 只会生成 HTML。可以先看 HTML 是否符合需求，与 WorkBuddy 对话直到调整到符合要求为止，然后再输入"转为CMS页面"，即可将页面自动生成到 CMS。
步骤6（可选）：Web 端远程工程的协同配置
如果是通过 Web 端访问 CMS 进行工程开发（即通过局域网访问另一台设备的 CMS），要实现使用 WorkBuddy 或 Codex 进行页面开发，需要进行以下配置：
1. 在 CMS 侧复制任务指令
通过 Web 端打开 CMS 工程界面，点击右上角的「Agent协同开发」图标（以 WorkBuddy 为例），复制任务指令。
弹窗中会分别给出 WorkBuddy 与 Codex 的指令。
2. 在 WorkBuddy 侧粘贴执行
在 WorkBuddy 新建任务，粘贴复制的指令并发送，等待任务完成。完成后即可在 WorkBuddy 上发送需求进行 CMS 页面开发。
3.11.6、提问与操作技巧
技巧一：按"三步走"选择指令粒度
| 指令写法 | AI 行为 | 适用时机 |
|---|---|---|
生成符合CMS规范的锂电叠片机监控看板页面 | 按 CMS 规范生成页面并落地 | 需求明确、想一步到位 |
生成锂电叠片机监控看板html页面，确认后再输入 转为CMS页面 | 先只产出 HTML，确认无误后再转 CMS | 需求还在探索、想先看效果 |
技巧二：把工程约 束一次讲清
在首次描述需求时一并说明，可以减少反复调整：
- 页面主题与用途（如"锂电叠片机监控看板"）
- 屏幕分辨率与主题（如 1920×1080、浅色主题）
- 需要展示的模块（总览 / 设备监控 / 报警中心 / 生产报表）
- 是否复用工程中已导入的变量、变量命名前缀
- 布局风格偏好（卡片式 / 大屏 KPI / 表格为主）
3.11.7、常见问题
Q1：托盘里提示"未检测到 WorkBuddy，请先安装或升级 WorkBuddy"怎么办？
A：先在 WorkBuddy 官网下载并安装最新版本桌面端，安装完成并确保 WorkBuddy 处于可用状态后，回到「主页 → Agent协同开发」点击「重试」。如果仍然检测不到，建议先重启 CMS 托盘程序或 CMS 客户端。
Q2：一定 要用 WorkBuddy 吗？Codex 可以吗？
A：WorkBuddy 与 Codex 都支持，托盘会分别显示两者的状态。Codex 需要安装 Codex 桌面应用（提示为"请先安装或打开最新版本"）。Agent协同开发的弹窗也会同时给出两条指令，按你实际使用的客户端复制对应那条即可。
Q3：对 CMS 版本有要求吗？
A：有。CMS 最低版本为 CMS Editor 26H1-V2.40.5。版本过低导致托盘里没有「Agent协同开发」入口，或插件无法正常工作。
Q4：生成出来的页面不符合要求怎么办？
A：直接在 WorkBuddy 的任务对话框里继续描述你的修改要求（例如"把报警中心的表格改成卡片列表""整体字号放大、压缩留白"），Agent会在原页面上迭代。建议一次性说清所有修改点，减少来回次数。
Q5：为什么提示的插件版本和我本地 CMS 版本看起来无关？
A：弹窗里给出的"插件版本"（示例如 0.2.3）指的是 CMS View Agent 技能/插件的版本，它随 CMS 服务发布并可能独立更新，与 CMS Editor 客户端的版本号不是同一个编号体系。按弹窗提示原样复制即可，不要手工改动。
Q6：Web 端远程协同开发，需要本地也装 CMS 吗？
A：不需要本地装完整 CMS 客户端。Web 端访问的是另一台设备上的 CMS，靠「复制任务指令」把该 CMS 的插件与服务地址注入到你的 WorkBuddy，即可实现远程页面开发。