系统总览
这是一张 Theseus 使用地图。第一次使用请从教程开始；当你不确定某项工作应放在哪个资源、在哪个界面完成时，再回到这里查阅。
何时查这页
- 不确定 Page、Object、Graph、Variable 或 Query 各自负责什么；
- 编辑器已经更新，但运行目标仍然表现为旧版本；
- 需要判断一项工作由 AI、工程人员还是现场操作员完成；
- 准备把 App 从开发机交付到 Runtime target 或 Player。
四个工作面
| 工作面 | 主要使用者 | 用来做什么 |
|---|---|---|
| 桌面编辑器 | 实施人员、自动化工程师 | 创建和检查 App，维护页面、对象、Graph、数据和模块设置 |
| AI Command Center | 所有工程使用者 | 基于当前 App 解释、生成、修改和诊断；结果仍回到编辑器检查 |
| Runtime target | 工程人员、管理员 | 接收 runtime package，执行 Run、Debug、设备通信和运行管理 |
| 运行页 / Player | 操作员、现场人员 | 使用已部署 App 的 HMI 页面，不承担工程编辑 |
桌面编辑器始终保留本地设计真相；切换 Runtime target 只会切换当前执行目标，不会把编辑器、Git、Files 或 AI 工作区搬到远端。
核心资源速查
| 目标 | 使用的资源 |
|---|---|
| 设计操作员画面 | Page；重复卡片或列表项使用 Component |
| 表达设备和业务能力 | Object；没有现成能力时用 Script 扩展 |
| 编排顺序、条件、等待和异常 | Graph |
| 保存少量运行状态 | Variable；成套参数用 Recipe，多行本机数据用 RecordStore |
| 调用 MES、ERP 或其他 HTTP 服务 | Query |
| 管理图片、模型和上传文件 | Asset |
| 管理运行页语言和访问角色 | i18n、App user / role |
| 使用运动、工程联锁、PLC 或视觉检测 | Pulsar / Safety、PLC、Vision |
资源之间的典型关系是：Page 展示 Object 和 Variable；操作员动作调用 Object、Query 或 Graph method；Graph 负责多个动作之间的顺序和异常路径。详细定义见 App 与核心资源。
从需求到运行
- 你或 AI 在当前 App 中修改资源。
- 在编辑器中检查 Resources、属性和 Problems。
- Graph、Script 或 PLC 等修改完成后执行 Build；Run 和 Debug 也会按需准备运行产物。
- 桌面端把 runtime package 部署到 Navbar 当前选择的 Runtime target。
- Run 用于正常运行；Debug 用于断点、暂停和定位流程问题。
- 操作员从运行页或 Player 使用已部署版本。
保存、Build、部署和运行是不同阶段。正在运行、调试或暂停时不会替换当前对象树；要让新的运行模型生效，先 Stop，再 Run 或 Debug。参见从编辑到运行。
关键规则
- Page 面向操作员。 页面方法处理界面交互，不直接承载设备协议或无界等待。
- Object 表达设备语义。 Page 和 Graph 应调用“回零”“启动”“读取状态”等能力，而不是重复底层地址逻辑。
- Graph 表达流程。 多步骤、分支、等待、超时和恢复路径放在 Graph 中，并通过 Debug 验证。
- Query 集中维护外部 HTTP 调用。 Page 和 Graph 复用同一份合同。
- AI 加速工程工作，但不替代验收。 设备地址、工艺顺序、权限、外部写入和 Safety 由责任人确认。
- Safety 不是认证安全系统。 工程联锁不能替代硬件急停、安全继电器或安全控制器。
- 三类账号彼此独立。 Editor Qixin、Runtime target 账户和 App user 保护不同入口。
如何验证理解是否正确
- 能在 Resources 中指出需求涉及的 Page、Object、Graph、Script 或 Asset。
- 能说明当前修改只在编辑态，还是已经 Build、部署并进入运行态。
- 能确认 Navbar 当前选择的 Runtime target 和账号权限。
- 能从 Problems 找到设计或构建错误，并从 Console 查看实时运行信息。
- 能说出哪些结果由 AI 完成、哪些必须由工程人员或操作员验收。