系统总览
Theseus 分成工程侧和使用侧。工程人员在 Desktop 中维护 App；运行目标接收并运行已交付版本；操作员通过运行页或 Player 使用 App。本页只建立整体认识，具体操作由对应手册负责。
四个使用入口
| 入口 | 主要任务 | 不负责什么 |
|---|---|---|
| 应用中心 | 新建、打开、从 Git 导入项目，并返回最近项目 | 不编辑具体 App 内容 |
| 编辑器 | 维护 Page、Object、QG、数据和设置，查看 Problems，执行 Preview、Build、Start 和 Debug | 不代替现场运行终端 |
| Runtime target | 接收并运行一个 App 版本 | 不保存工程源码、Git 或 AI 会话 |
| 运行页 / Player | 显示并操作已经交付的 App | 不创建项目，也不提供工程编辑和 Build |
切换 Runtime target 只改变 Preview、Build、Start 和 Debug 作用的位置。当前 App 的项目文件、版本记录、设置和 AI 会话仍留在开发电脑上。
核心工程资源
| 任务 | 主要资源 |
|---|---|
| 设计操作画面 | Page；可复用的视觉部分使用 Component |
| 表达设备或业务能力 | Object |
| 编排顺序、条件、等待和故障路径 | QG |
| 保存少量状态或成套参数 | Variable、Recipe 或 TableStore |
| 调用 MES、ERP 等外部系统 | Query |
| 管理图片、模型和翻译 | Asset 与 i18n |
典型关系是：Page 显示 Object 和 Variable 的状态；用户操作调用 Object、Query 或 QG；QG 负责多个动作之间的顺序、超时和恢复。详细定义见App 与核心资源。
工程如何进入运行端
项目文件 → Build → Runtime target → Start / Debug → 运行页或 Player
- 保存只更新项目文件。
- Build检查已保存项目，并把新版本交付到当前目标。
- Preview在编辑器中检查当前目标上的版本。
- Start / Debug启动已经交付的版本。
- Stop结束当前运行或预览。
动作和状态的含义见从保存到运行；完整操作步骤以Build 与运行验收为准。
按任务继续
| 现在要做什么 | 文档 |
|---|---|
| 第一次在本机创建并运行 App | 本机快速入门 |
| 查找编辑器和工程能力 | 工程手册 |
| Build、Preview、Start、Debug 或 Stop | 构建与调试 |
| 连接现场设备或配置 Player | Runtime 与现场交付 |
| 判断 Qixin、目标或 App user 账号 | 账号与权限边界 |
| 从错误现象开始排查 | 故障排查 |