跳到主要内容

在现场终端使用 Theseus Player

Theseus Player 是面向操作终端的运行入口。它打开已经交付到 Runtime target 的 Page，并记住这台终端绑定的页面。Player 不包含工程编辑、Build 或 Deploy 能力，也不能替代工程备份。

开始前​

  • App 已经 Build 到正确的 Runtime target，并配置了首页。
  • 目标 Admin 已按现场计划将 App Start 到 Running。使用 User 的终端不能启动 Stopped App。
  • 已取得纯 HTTP/HTTPS 运行目标地址；远程现场使用受信任的 HTTPS。
  • 已准备供终端使用的目标账户；如果页面有业务角色，也准备对应 App user。
  • Player 的版本、来源和安装包签名已经由交付人员核对。

配置 Player​

  1. 启动 Theseus Player。
  2. 输入 Runtime target 的完整地址，例如 https://runtime.example.com。只填写协议、主机和端口，不添加账户、查询参数、API 路径或 Page 路径。
  3. 选择界面语言。
  4. 不需要运行页 AI 时保持该功能关闭。需要时，填写模型服务地址和 API Key，刷新模型列表并选择模型；地址或密钥变化后重新刷新。
  5. 点击保存并连接，等待 Player 完成连接检查并打开运行页。

如果当前终端不能安全保存模型凭据，Player 会拒绝保存 AI 配置。不要把共享密钥写入普通文件或分发给无关终端。

登录并绑定 Page​

  1. 在运行页使用 Runtime target 账户登录。
  2. 确认当前 App 为 Running。如果是 Stopped，由目标 Admin 在确认现场条件后 Start；User 终端不能自行启动。
  3. 打开 App 首页或这台终端应长期显示的 Page。
  4. 如果 App 使用业务角色，再通过 App user 登录或切换为实际操作员。
  5. Page 成功打开后，Player 记住当前绑定。
  6. 退出并重新启动 Player，确认终端直接返回绑定页面。

Runtime target 账户负责进入运行端和查看状态，App user 负责表示实际操作员。两者的详细边界见Runtime target 账户与权限。

现场验收​

  • 终端连接的是批准的 Runtime target，地址和证书正确
  • 使用目标 User 可以查看 Running App，但不能 Start、Debug 或 Stop
  • 首页和终端指定 Page 能正常打开
  • App user 登录、退出和角色限制符合操作员职责
  • Player 重启后返回同一绑定 Page
  • 页面布局、字体、触控、扫码或键盘输入在实机上可用
  • 断网、目标重启和重新连接路径经过测试
  • 正常、边界、故障、恢复和停机场景有验收记录
  • 如启用运行页 AI，模型可用，敏感调用仍要求人工确认
  • 现场账户、证书、许可证、网络、备份和恢复责任人已经确认

更换目标或 Page​

需要把终端交给另一运行目标或另一 Page 时：

  1. 从 Player 打开重新配置。
  2. 核对并保存新的 Runtime target 地址。
  3. 重新登录目标账户。
  4. 打开新的目标 Page，等待 Player 记录新绑定。
  5. 重启 Player，确认旧目标和旧 Page 不再打开。

常见问题​

症状检查和恢复
无法连接检查地址、DNS / IP、端口、网络和证书；地址中不要附加 API 或 Page 路径
能登录但看不到 App确认目标上已经交付 App、首页存在，并且 App 为 Running
User 看到 Stopped，但无法启动这是权限设计；由 Admin 通过受控流程 Start
页面要求再次登录这是 App user 登录，用于操作员和业务角色；它不同于目标账户
重启后没有回到原 Page重新配置目标，打开要绑定的 Page，再重启验证
AI 配置无法保存确认终端支持安全凭据存储；不要改用明文文件绕过
页面在开发电脑正常、终端异常在实机检查分辨率、缩放、字体、触控、网络和外部设备条件

安全要求​

  • 操作终端优先使用目标 User，不长期保存 Admin 凭据。
  • 只连接经过批准的目标地址，不绕过 HTTPS 证书检查。
  • Player 只用于运行和操作，工程源码与恢复备份应由交付流程另行保管。
  • 终端可打开页面不代表设备动作已经安全；联锁、急停和安全控制仍需独立验收。

下一步​