使用构建器开发应用

构建器是 PlantPulse Studio 的工作台。在左侧聊天窗口用自然语言下达指令，AI 智能体便会实际修改应用，中间的预览随即更新，完成后只需点击一次 [部署] 即可发布到现场。

打开构建器有两种方式。

• 在主页用一句话创建应用后，构建器会立即打开 → 在主页创建应用
• 已创建的应用可在侧边栏的 应用程序(fa-grid-2) 中点击卡片的 [打开] → 应用目录与共享

界面构成

构建器纵向分为三栏。

位置	名称	作用
左侧	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) 也很常用。

直接指定要修改的部分

当难以用语言描述位置时使用。

1. 点击预览标题栏的 [选择元素](fa-arrow-pointer) → 变为 요소를 클릭하세요…
2. 在预览中点击想修改的部分
3. 聊天输入框上方会显示所选元素名称以及快捷指令按钮 — 修改文字 · 更改颜色 · 放大 · 删除，以及 手动输入

点击按钮会立即发送类似 선택한 요소 [○○] — 색 변경 的语句；选择 手动输入 时，该语句会填入输入框，可在后面继续补充内容。

4 个抽屉面板

点击工具栏图标会从右侧展开抽屉面板。用 Esc 关闭。

抽屉	打开方式	内容
变更历史	fa-clock-rotate-left	迄今为止的变更列表。点击某行可展开查看具体改动
代码	fa-code	构成应用的文件列表及内容（只读）
部署版本	v1 标签的 fa-chevron-down	已部署版本列表、回滚、公开状态切换
数据浏览器	fa-database	依次点击站点 → 资产 → 标签进行查看，并用 [插入] 将该对象粘贴到聊天输入框

数据浏览器的 [插入] 尤其实用。由于设备名称与 ID 被准确填入，可减少智能体选错设备的情况。

变更历史与回滚

每完成一次指令，该时刻的应用状态都会自动保存。无需另行点击保存按钮，若不满意随时可以回到过去的状态。

1. 打开工具栏的 历史记录(fa-clock-rotate-left)
2. 最上方的条目带有 현재 徽章。点击各行可展开变更内容
3. 在想恢复的时间点点击 [恢复到此时点] → 在确认窗口中批准

请仔细阅读确认窗口

이후 변경은 사라집니다. 晚于所恢复时点的操作将全部丢失。回滚前请先确认预览与变更内容。

请勿在聊天窗口粘贴密码或 API 密钥

变更历史是每个应用自动留存的记录，您在聊天中输入的语句可能会原样保留在该记录中。请勿将 API 密钥、密码、令牌粘贴到聊天窗口，而应请管理员在 环境配置 中注册。 Studio 虽会将 sk-…、glpat-…、Bearer … 等广为人知的密钥格式自动用 *** 遮蔽，但无法识别世上所有的密钥形式。

右侧上下文栏

通过工具栏最右侧的 fa-sidebar-flip 打开。一目了然地展示该应用正在使用哪些素材。

• 数据连接 — 预先指定该应用要处理的站点、设备与标签。点击 [数据连接] 进行选择后，智能体便不会去猜测 ID，而是针对准确的对象进行构建。在创建应用前先指定一次，结果质量会大幅提升
• 数据绑定 — 当前画面实际使用的设备 ID 与查询路径
• 已应用技能 — 本次作业参考的现场技能
• 状态 — 最后保存点与部署版本

部署

点击工具栏的 [部署] 会弹出进度窗口，依次经过 构建准备 → 生产构建 → 服务版本切换 3 个阶段。通常需要 20~60 秒，进行期间无法关闭窗口。

完成后会显示 v1 배포됨 以及 二维码。用现场手机扫描即可直接打开。

• 每次部署都会累积一个版本（v1、v2、v3 …）
• 出现问题时，可在 部署版本 抽屉中点击旧版本的 [切换到此版本] 进行回滚。 当前正在提供服务的版本会带有 서빙 중 徽章
• 在同一抽屉上方可切换 公开 / 非公开。关于谁可以查看、如何通过链接或二维码分发，请参见 应用目录与共享

部署后仍可继续开发

部署是导出该时刻的一份副本。部署后仍可在构建器中继续修改，而现场使用的应用在再次部署之前不会发生变化。

遇到问题时

症状	请这样处理
预览一直处于准备中	稍等片刻后点击 [重试]。仍不行则点击状态栏的 应用 → [重启]
画面一片空白	用 /test 确认错误 → 用 /loop 自动修复
指令执行结果不符预期	在 变更历史 中回滚到上一时点，然后更具体地重新下达指令
响应耗时过长	用中断按钮停止，将请求拆小后重试
提示连接已断开	结果可能已经生效。请先确认预览与变更历史

更详细的处理方法请参阅故障排查。