使用构建器开发应用
构建器是 PlantPulse Studio 的工作台。在左侧聊天窗口用韩语下达指令，AI 代理就会修改实际应用，中间的预览区域会立即更新，完成后点击一次 [部署] 即可将其发送到现场。
有两种方式打开构建器。
界面构成 — 编号按阅读顺序
| 编号 | 位置 | 功能 |
|---|---|---|
| ① | 最上方左侧 | 应用名称与状态 — 若显示 준비됨，表示会话容器已启动 |
| ② | 代理控制台头部 | 构建 · 查询 切换开关 — 选择是修改应用还是仅查询数据 |
| ③ | 左侧最下方 | 消息输入框 — 用韩语下达指令 (Enter 发送 · Shift+Enter 换行) |
| ④ | 输入框正上方 | 规划 · 自动 · 确认 — 设定代理的自主程度 |
| ⑤ | 预览区域头部 | 实时预览地址 — 表示当前查看的是「开发服务器」 |
| ⑥ | 预览区域右侧 | 视口切换 — 切换为桌面 · 平板 · 移动端视图 |
| ⑦ | 旁边 | 元素选择 — 点击并指定屏幕上要修改的位置 |
| ⑧ | 最上方右侧 | 部署 — 必须点击此按钮，同事看到的内容才会更新 |
预览显示的是 开发服务器的实时状态，因此代理修改后会立即更新。 同事看到的部署版本 仅在点击 ⑧ 后 才会更新 → 术语表
最底部的状态栏显示当前使用的 模型 以及会话容器的 CPU · 内存。
界面构成
构建器垂直分为三个区域。
| 位置 | 名称 | 功能 |
|---|---|---|
| 左侧 | Agent Console | 与代理对话的聊天窗口。在此下达创建或修改的指令 |
| 中间 | Live Preview | 正在开发的应用界面。指令执行完毕后会自动刷新 |
| 右侧 | Context | 显示此应用使用的数据 · 技能 · 状态的窄侧栏。默认关闭 |
拖动左侧与中间之间的垂直线，可以调整聊天窗口的宽度。
顶部工具栏
从左到右依次是 返回(fa-arrow-left, 애플리케이션 목록으로)、应用名称、状态指示灯(세션 준비 중… →
준비됨 → 处理指令期间显示 생성 중…)，右侧有以下按钮。
| 按钮 | 图标 | 说明 |
|---|---|---|
| 部署 | fa-rocket-launch | 将当前状态导出至现场可用 |
| 提取技能 | fa-lightbulb | 将此对话中获得的经验保存为技能 → 现场技能 |
| 保存为模板 | fa-bookmark | 将此应用配置保存为下一个应用的起点 |
| 数据 | fa-database | 打开数据浏览器 |
| 代码 | fa-code | 打开代码查看器 |
| 历史记录 | fa-clock-rotate-left | 打开变更历史 |
| 导出 | fa-download | 将应用文件全部下载为压缩文件 |
| 远程推送 | fa-cloud-arrow-up | 发送至公司 Git 仓库(需管理员设置) |
| 上下文侧栏 | fa-sidebar-flip | 最右侧按钮。打开或关闭右侧栏 |
如果进行过一次部署，[部署] 旁边会出现 v1 앱 열기 ↗ 徽章，通过其旁边的图标可以快速打开链接分享和
部署版本列表。
点击底部状态栏的 应用 项，可以检查应用当前是 실행 중 还是 정지됨、日志内容，并可执行 [重启]。
发送第一条指令
确认聊天窗口头部的 [构建] / [查询] 切换开关中选择了 构建，然后输入您想做的事情。 (查询是仅询问数据而不修改应用的模式 → 通过聊天查询数据)
- 按 Enter 发送，Shift+Enter 换行
- 使用回形针(fa-paperclip)附加照片 · 草图 · CSV，可以照原样创建该画面
- 处理期间，发送按钮会变为红色的 停止 按钮
如果对话为空，会显示类似 사이트 목록을 카드로 보여줘 的示例语句，可以直接点击开始。
一次一件事，具体明确。像 以大字卡片显示3号线的温度·压力，超过90度时用红色显示 这样，
写明 对象 · 表达方式 · 条件，结果会准确得多。
代理工作时，聊天中会累积 도구 호출: …、파일 변경: …、커밋 … 等工作记录。
点击 파일 변경: 行，代码查看器会展开并显示对应文件。
3 种模式
聊天输入框正上方有 规划 · 自动 · 确认 分段选择器。所选模式在下次打开时也会 保持。
| 模式 | 图标 | 行为 | 适用场景 |
|---|---|---|---|
| 规划 | fa-list-check | 不立即创建，而是先展示 界面构成方案。在 빌드 플랜 卡片中确认界面 · 部件 · 所需数据，然后点击 [批准并构建] 才会开始实际工作 | 初次创建的界面、需求较大的任务。可预先防止偏离方向 |
| 自动 | fa-bolt | 下达指令后立即修改并自动保存(默认值) | 小幅修改、快速迭代 |
| 确认 | fa-check-double | 进行修改，但 暂不保存。需在预览中确认后手动接受才生效 | 修改运行中的应用，或想务必亲眼确认结果时 |
在 确认模式 下，如果有变更，输入框上方会出现黄色审核栏。
等待变更审核 — 请在预览中确认后接受或撤销 [撤销] [接受(提交)]
- [接受(提交)] — 确认变更并记录到变更历史中
- [撤销] — 丢弃本次全部更改，恢复至之前状态
点击 빌드 플랜 卡片上的 [关闭]，原始请求语句会返回输入框。修改语句后
重新发送，即可获得新的构成方案。如果生成耗时较长，可用 [取消] 停止。
斜杠命令
在输入框中输入 / 会显示命令列表。仅在构建模式下生效。
| 命令 | 参数 | 功能 |
|---|---|---|
/plan | 必需 | 先获取界面构成方案，批准后构建 |
/build | 必需 | 直接按此内容构建 |
/review | — | 最近变更审核(不修改文件) — 仅告知问题点和改进建议 |
/fix | — | 查找错误并给出修正指令 |
/test | — | 执行类型检查(tsc) — 检查应用是否有语法或类型错误 |
/loop | 可选 | 反复修改直至通过检查(最多 3 次) |
/deploy | — | 打开部署对话框 |
/plan、/build 需在其后附加内容(例如：/plan 보일러 압력 대시보드)。若遗漏，
会显示 이 명령에는 내용이 필요합니다 提示，输入内容会保留。
先用 /test 检查是否有错误，如有，则运行 /loop。处理过程中可通过停止按钮
中断，结束后会用 ✅ /loop 완료 或 ⚠️ /loop 3회 반복 후에도 오류가 남았습니다
告知结果。
使用预览
在预览头部可以切换屏幕尺寸 — 桌面(fa-display) 平板(fa-tablet-screen-button) · 移动端(fa-mobile-screen-button)。如果现场需要手机查看应用， 请保持移动端模式进行开发。旁边的 刷新(fa-rotate-right)·新标签页(fa-arrow-up-right-from-square)也 会经常用到。
直接点击要修改的部分进行指示
当难以用语言描述位置时使用此方法。
- 点击预览头部的 [元素选择](fa-arrow-pointer) → 变为
요소를 클릭하세요…状态 - 在预览中点击要修改的部分
- 聊天输入框上方会显示所选元素名称及快捷指令按钮 — 修改文案 · 更改颜色 · 放大 · 删除，以及 直接输入
点击按钮，会立即发送类似 선택한 요소 [○○] — 색 변경 的语句；选择 直接输入，
则该语句会填入输入框，您可以在其后继续补充内容。
4 个抽屉
点击工具栏图标，右侧会打开抽屉。通过 Esc 关闭。
| 抽屉 | 打开方式 | 内容 |
|---|---|---|
| 变更历史 | fa-clock-rotate-left | 迄今为止的变更列表。点击条目可展开显示具体变更内容 |
| 代码 | fa-code | 构成应用的文件列表与内容(只读) |
| 部署版本 | v1 徽章的 fa-chevron-down | 已部署版本列表 · 回滚 · 公开状态切换 |
| 数据浏览器 | fa-database | 按站点 → 资产 → 标签逐层查看，点击 [插入] 可将所选对象粘贴到聊天输入中 |
数据浏览器的 [插入] 功能尤其实用。由于设备名称和 ID 会被准确输入， 代理误选其他设备的概率会大大降低。
变更历史与撤销
每完成一次指令，该时刻的应用状态会 自动保存。无需手动点击保存按钮， 如果结果不满意，随时可以恢复到过去任意时点。
- 打开工具栏的 历史记录(fa-clock-rotate-left)
- 最上方条目带有
현재徽章。点击各行可展开变更内容 - 在希望恢复的时间点点击 [恢复到此时刻] → 在确认窗口中批准
이후 변경은 사라집니다. 早于恢复时点之后的作业都会丢失。撤销前请先确认预览和
变更内容。
变更历史是每个应用自动留下的记录，您在聊天中输入的文字可能会原样保留在该记录中。
请勿将 API 密钥、密码、令牌粘贴到聊天窗口，而应请求管理员在
环境设置 中注册。
虽然 Studio 会将 sk-…、glpat-…、Bearer … 等 广为人知格式的密钥自动遮盖为 ***，
但无法识别世界上所有形式的密钥。
右侧上下文侧栏
通过工具栏最右侧的 fa-sidebar-flip 打开。可一目了然地查看此应用使用的素材。
- 数据连接 — 预先设定此应用将处理的站点 · 设备 · 标签。点击 [数据连接] 进行选择， 代理就不会猜测 ID，而是基于准确的对象进行开发。创建应用前指定一次，可大幅提升结果质量
- 数据绑定 — 当前界面实际使用的设备 ID · 查询路径
- 应用技能 — 此任务参考的 现场技能
- 状态 — 最后保存点和部署版本
部署
点击工具栏的 [部署]，会出现进度窗口，依次经过 构建准备 → 生产构建 → 切换服务版本 三个阶段。通常需要 20~60 秒，过程中无法关闭窗口。
完成后，会显示 v1 배포됨 和 QR 码。现场手机扫描即可立即打开。
- 每次部署都会 累积一个版本(v1, v2, v3 …)
- 如果出现问题，可在 部署版本 抽屉中点击旧版本的 [恢复到该版本] 进行回滚。
当前正在服务的版本会带有
서빙 중徽章 - 在同一抽屉的上方可切换 公开 / 非公开。关于谁可以查看、如何通过链接 · QR 码分享，请参阅 应用目录与共享
部署只是导出该时刻的副本。部署后仍可在构建器中继续修改，现场 使用的应用在 再次部署前不会改变。
遇到问题时
| 现象 | 解决方法 |
|---|---|
| 预览一直显示准备中 | 稍等片刻后点击 [重试]。若仍无效，请在状态栏的 应用 → [重启] |
| 界面显示为空白 | 用 /test 检查错误 → 用 /loop 自动修复 |
| 指令被错误执行 | 在 变更历史 中恢复到前一时点，然后更具体地重新下达指令 |
| 响应时间过长 | 点击停止按钮中断，将请求拆分成更小的部分后重新发送 |
| 显示连接已断开提示 | 结果可能已生效。请先检查预览和变更历史 |
如需更详细的处理方法，请参阅 故障排除。