连接并授权 Runtime target
何时用
当应用需要部署、运行或调试在另一台工控机、边缘设备或 RuntimeHost 上时，先连接对应的 Runtime target。
Runtime target 账户只管理目标机权限；它与编辑器的 Qixin 登录、单个应用的操作员账号彼此独立。
开始前
- 准备目标地址。远程管理建议直接使用完整的
https://地址。 - 确认桌面电脑能访问目标网络和 RuntimeHost。
- 准备已绑定当前 Qixin 登录的目标账户，或准备目标机的本地账号和密码。
- 首次初始化目标时，先明确谁负责保管第一个 Admin 账户。
注意
远端 RuntimeHost 的部署、调试、停止、许可证和账户管理需要安全连接。仅有 HTTP 的远端目标可以检查可达性，但不能完成受保护的管理连接。
步骤
- 在编辑器顶栏点击 Build 按钮旁的运行目标选择器。也可以在系统设置的 Runtime 分组点击当前目标。
- 在管理运行目标中点击新增运行目标。
- 填写名称和访问地址。地址不要带
/api；名称留空时会使用 host。 - 点击保存。
- 在目标行点击检查。确认出现可访问，并核对显示的 RID 是否符合目标机器。
- 点击连接。
- 按目标状态完成授权：
- 目标尚未初始化：选择使用当前登录初始化，或输入目标账户和密码后点击创建管理员。
- 目标已经初始化且当前登录已绑定：选择使用当前登录连接。
- 其他情况：输入目标机上的本地账户和密码，选择使用目标账户登录。
- 授权成功后，Theseus 会把它设为当前目标并重新加载编辑器。
- 回到运行目标选择器，再核对目标名称、地址和登录角色。只有 Admin 才继续从桌面编辑器执行 Build、开始或 Debug。
普通 User 可以进入运行端并启动已经部署好的应用。桌面编辑器的开始和 Debug 会构建并上传当前工程，因此和部署、Materialize、Stop、许可证写入及账户管理一样需要 Admin。
成功表现
- 目标行同时显示已选、可访问和已登录账户。
- 目标行显示正确的
Admin或User角色以及目标 RID。 - 编辑器顶栏的运行目标名称与计划操作的机器一致。
- Admin 从桌面编辑器执行开始或 Debug 时，工程会交付到该目标，状态和在线设备反馈来自目标机。
- User 在运行端启动已经部署的应用时，不会上传桌面端工程。
常见问题
目标显示“不可访问”
检查地址、端口、网络、DNS、防火墙和目标 RuntimeHost 是否正在运行。先解决可达性，再处理账号问题。
目标可访问，但显示“需要 HTTPS”
把目标改为受信任的 HTTPS 地址，或先建立安全隧道。不要通过关闭证书检查来绕过现场安全要求。
当前 Qixin 登录不能连接
当前登录必须已绑定目标账户。改用目标本地账号登录，或请该目标的 Admin 在用户管理中完成绑定。
运行端能启动应用，但桌面编辑器不能开始或 Debug
当前目标账户可能是 User。User 只能启动已经部署的应用；桌面编辑器的开始、Debug、部署和 Stop 需要重新使用 Admin 账户连接。
切换目标后找不到应用
编辑器中的本地工程不会因为切换目标自动出现在远端。首次从桌面编辑器开始、Debug 或部署时需要用 Admin 权限把当前应用交付到目标机。
AI 可以怎么帮
AI 可以检查当前 app 的目标平台构建错误、部署前配置和运行诊断。例如：
当前目标是 Linux ARM64。先检查这个 app 的构建和模块配置是否适合该目标，不要部署。给出需要人工确认的现场条件和验证命令。
AI 不应代替你输入密码、决定目标地址、接受证书风险或选择生产目标。
必须人工确认
- 连接的是测试机还是生产机，目标名称、地址和 RID 是否一致。
- HTTPS 证书和网络链路是否符合现场安全要求。
- 当前账号是否只拥有完成任务所需的最小权限。
- Deploy、Stop、许可证修改或用户管理前，目标机当前生产状态是否允许操作。