从一个可运行的 App 开始
这套文档按客户要完成的任务组织。第一次使用时，先在本机走通创建、检查和运行；需要某项功能时查工程手册；准备上线时再进入 Runtime 与现场交付。账号、在线服务和运行目标各有自己的章节，不需要在入门阶段一次理解完。
按你现在的任务进入
| 现在要做什么 | 从这里开始 |
|---|---|
| 安装或更新 Theseus | 安装与更新 |
| 认识应用中心和编辑器 | 应用中心与编辑器导览 |
| 尽快完成第一个可运行 App | 本机快速入门 |
| 跟随一个连续案例学习 Page、QG、调试与交付 | 教程 |
| 新建、打开或从 Git 导入项目 | 管理项目 |
| 创建 Page、流程、Object 或数据能力 | 工程手册 |
| Build、Start、Debug 或排查运行状态 | 构建与调试 |
| 连接工控机、边缘设备或 Player | Runtime 与现场交付 |
| 使用 Qixin AI、Portal、在线许可证或组织服务 | 账号与在线服务 |
| 按现象处理错误 | 故障排查 |
文档分成什么
| 分区 | 适合什么时候读 |
|---|---|
| 开始使用 | 第一次安装、认识界面并在本机完成最短闭环 |
| 教程 | 希望跟随连续步骤做出一个完整结果 |
| 工程手册 | 已经知道要修改哪类工程内容，需要完成一个具体任务 |
| 构建与调试 | 要理解保存、Build、Preview、Start、Debug、Stop 和运行状态 |
| Runtime 与现场交付 | 要连接远程目标、管理目标权限、配置 Player 或完成现场验收 |
| 账号与在线服务 | 要登录 Qixin，使用 AI、Portal、在线许可证或组织能力 |
| 高级 | 要进行页面源码开发等高级扩展；普通页面设计不需要先读 |
| 概念与参考 | 需要查术语、项目边界、数据选择或版本管理规则 |
一次可靠的工程闭环
- 明确结果和边界：说明要改变什么，以及不能触碰的设备、工艺或 Safety 范围。
- 检查当前项目：确认已有 Page、Object、QG、配置、版本状态和 Problems。
- 完成并保存修改：在编辑器中检查实际资源、属性和诊断，不只看 AI 的总结。
- 在本机验证：先用本机运行目标完成 Build、Preview、Start 或 Debug，覆盖正常、异常和恢复路径。
- 单独完成现场交付：核对远程目标、权限、许可证、停机窗口和真实设备条件后，再部署并记录验收结果。
保存工程、Build 和运行是不同阶段。保存不会更新目标上的版本；Build 不会自动开始运行；切换运行目标也不会自动上传项目。
AI 协作的边界
AI Command Center 可以读取当前 App、创建或修改工程内容并解释诊断。任务应明确结果、允许范围、禁止改动项、已确认的设备事实和验收方法。AI 显示“已完成”只表示本轮任务结束，不代表工程已经安全交付。
注意
AI 不能替代设备物理确认、安全回路设计或现场验收。轴、IO、相机和其他真实设备的用途必须由工程人员确认；急停、硬限位和安全控制必须由合适的硬件与工程流程保证。