创建、导入、导出和删除应用
何时用
当你要开始一个新工程、接手同事的工程、制作离线交付包，或清理不再使用的应用时，使用本指南。
开始前
- 这些操作在桌面版的应用中心完成，不能在运行页完成。
- 导入本地工程或 Git 仓库前，确认工程根目录是一个有效的 Theseus app。
- 删除前先完成一次 Git 推送或 ZIP 导出。
- 如果创建时要启用启心代码管理，先登录 Qixin 账号，并确认账号已设置名称。
步骤
创建空白项目
- 在应用中心左侧点击创建。
- 选择空白项目。
- 输入应用名称，并在工作区路径中填写一个空目录。
- 需要由启心托管私有仓库时，开启启心代码管理。
- 点击保存。创建完成后会进入该应用的编辑器。
导入 ZIP
- 在应用中心左侧点击导入。
- 选择一个
.zip应用包。 - 等待导入完成，在应用列表中找到新应用。
- 双击应用卡片进入编辑器，先检查页面、对象和 Settings，再执行 Run 或 Debug。
ZIP 导入适合离线交付和备份恢复，不包含原仓库的 Git 历史。
从 Git 导入
- 点击创建，切换到 Git 导入。
- 输入仓库地址；需要固定分支时填写分支。
- 在工作区路径中填写一个空的本地目录。
- 点击从 Git 导入并等待任务完成。
- 如果认证失败，按提示输入仓库账号和访问令牌后重试。不要把令牌写进仓库地址。
注册已有项目
- 点击创建，切换到项目。
- 在工作区路径中填写已有应用的根目录。
- 点击注册项目。
注册不会复制工程。以后移动或删除原目录前，应先在应用中心解除注册。
导出应用
- 在应用卡片上打开右键菜单。
- 选择导出，再选择保存位置。
- 将生成的 ZIP 交给接收方，并说明所需 Theseus 版本、运行目标和现场配置。
删除或解除注册
- 在应用卡片上打开右键菜单，选择删除。
- 只想从应用中心移除记录时，取消勾选从磁盘删除工作区文件。
- 确实要删除工程目录时，保持勾选并确认删除。
成功表现
- 创建或导入后，应用出现在应用中心，并能正常进入编辑器。
- Git 导入后的 Git 面板能看到当前分支和远程仓库。
- 导出的 ZIP 可在另一台桌面端重新导入。
- 解除注册后，应用从列表消失，但原目录仍存在；删除工作区后，目录也被移除。
常见问题
导入后提示“需要修复”
应用已经注册，但其中存在当前版本无法加载的内容。先进入编辑器查看 Problems 和相关配置，不要直接上现场运行。
“打开运行页”提示没有首页
进入编辑器的 Settings → 常规选择首页，或在 Resources → Pages 中右键目标页面并设为首页。
Git 导入一直认证失败
确认仓库地址可访问、令牌有读取权限，并使用认证提示重试。不要把用户名或令牌嵌入 URL。
误选了“删除工作区文件”
删除没有撤销功能。只能从远程仓库、ZIP 备份或其他备份恢复。
AI 可以怎么帮
AI Command Center 只处理当前已经打开的 app，不能代替应用中心创建、导入、导出或删除应用。进入编辑器后，可以这样问：
检查当前导入的 app 是否完整。不要修改文件。列出阻止 Build、Run 或 Debug 的问题，并给出验证顺序。
修复前用 @ 引用报错文件，让 AI 说明计划和影响范围；修复后要求它列出修改文件和已执行的检查。
必须人工确认
- 应用名称和工作区路径是否属于正确的客户或项目。
- Git 仓库和分支是否正确，是否含有不应上传的现场信息。
- ZIP 是否能在目标环境导入，交付版本和依赖是否已说明。
- 删除前是否已有可恢复的远程提交或 ZIP 备份。