应用管理与运行状态
这是一页日常查阅参考。需要从头完成创建、导入、导出或删除时，使用创建、导入、导出和删除应用。
何时查这页
- 想确认某项应用操作应该在应用中心还是编辑器完成。
- 看不懂 Start、Debug、Paused、Error 等运行状态。
- 需要设置首页、缩略图或当前运行目标的自启动应用。
- 想知道保存后的改动何时进入运行态。
实际入口
| 任务 | 入口 |
|---|---|
| 创建空白项目、Git 导入、注册已有项目 | 应用中心左侧创建 |
| 导入 ZIP | 应用中心左侧导入 |
| 打开编辑器或运行页 | 双击应用卡片，或使用卡片右键菜单 |
| 编辑名称、导出、删除 | 应用卡片右键菜单 |
| 设置首页、缩略图和模块 | 编辑器 Settings → 常规 |
| Build、Start、Debug、Pause、Continue、Stop | 编辑器顶栏 |
| 选择 Runtime target | 编辑器顶栏 Build 左侧的运行目标选择器 |
| 配置自启动 | 系统设置 → Runtime → 自启动应用 |
管理应用
创建和接入工程
- 空白项目：填写名称和一个空的工作区目录。需要托管私有仓库时，可同时启用启心代码管理。
- Git 导入：填写仓库地址、可选分支和空的工作区目录。认证失败后再按提示提供凭据。
- 项目：填写已有 Theseus app 的根目录，只注册，不复制原工程。
- ZIP 导入：适合离线交付和恢复。导入后先在编辑器检查，再运行。
首页和缩略图
- 首页决定打开运行页和 Player 首先打开哪个 Page。可在 Settings → 常规选择，也可在 Resources → Pages 右键页面并设为首页。
- 缩略图在 Settings → 常规上传、替换或移除，用于应用中心卡片。
- 没有首页时，运行入口会要求先配置，不会自行猜测一个页面。
导出和删除
- 导出生成用于交付或备份的 ZIP；Git 历史应通过远程仓库单独保存。
- 删除时可以只解除注册，也可以同时删除磁盘上的工作区。删除工作区前必须确认已有可恢复备份。
运行控制
应用的运行控制在编辑器顶栏，不在应用中心卡片上。
| 状态 | 含义 | 可用操作 |
|---|---|---|
| Stopped | 当前没有运行实例 | Build、Start、Debug |
| Starting | 正在准备并启动 | 等待，必要时 Stop |
| Running | 正常运行 | Stop |
| Debugging | 调试运行 | Pause、Stop |
| Paused | 调试已暂停，仍占用运行实例 | Continue、Stop |
| Stopping | 正在停止 | 等待完成 |
| Error | 加载或运行失败 | 查看错误；已进入运行实例时先 Stop，否则可重新 Build 或 Restart |
Start 和 Debug 会先为当前 Runtime target 准备必要产物并部署，再启动 app。远端目标的构建平台会按目标机自动选择。
保存不等于运行态已更新
Page、Graph、Object、模块或 Safety 等设计态文件保存后，编辑器会显示最新内容；正在运行的实例不会被后台替换。影响运行逻辑或设备配置的修改应按以下顺序验收：
- 保存所有修改。
- Stop 当前 app。
- 需要编译的内容先 Build。
- 重新 Start 或 Debug。
- 在运行页和真实设备状态中验证。
自启动
在系统设置 → Runtime → 自启动应用中，只能选择当前 Runtime target 已有的运行应用。开启目标后保存；该设置属于目标机，不随 ZIP 或 Git 工程自动迁移。
成功表现
- 应用中心能打开正确工程，名称、首页和缩略图符合交付要求。
- 编辑器顶栏显示计划使用的 Runtime target 和预期运行状态。
- Start 或 Debug 完成后进入 Running、Debugging 或命中断点后的 Paused。
- Stop 最终回到 Stopped；修改后重新启动得到新行为。
- 自启动应用在目标 RuntimeHost 下次启动时按配置运行。
常见问题
创建时提示工作区目录无效
空白项目和 Git 导入都要求填写可用的空目录。已有工程应使用项目页签注册，而不是覆盖创建。
打开运行页提示没有首页
在 Settings → 常规选择首页，或从 Pages 资源右键设置。
已保存，但运行页仍是旧行为
先判断 app 是否仍在 Running、Debugging 或 Paused。停止后重新 Build（如需要）并 Start/Debug。
Error 状态不能 Build
如果错误发生在已加载的运行实例中，先 Stop 收敛到 Stopped；如果尚未进入运行实例，可以直接检查 Problems 后重新 Build 或 Restart。
切换远端目标后看不到 app
编辑器工程仍在本机。首次 Start、Debug 或部署会把当前 app 交付到所选目标；切换目标本身不会自动上传。
AI 可以怎么帮
AI 可以检查当前 app 的配置、错误和变更范围，例如：
当前 app 启动失败。先只读检查 Problems、模块设置和最近修改，区分构建失败、目标未部署和运行时错误。不要启动、停止或部署，给我人工排查顺序。
AI 不能代替用户选择生产目标、决定停机窗口或确认删除工作区。
必须人工确认
- 应用名称、工作区、首页和 Runtime target 是否属于正确项目。
- Start、Debug、Stop 或自启动是否符合现场生产状态。
- 运行态变更是否经过正常、异常和恢复测试。
- 删除或覆盖前是否已有 Git 或 ZIP 备份。