跳到主要内容

在现场终端使用 Theseus Player

Theseus Player 是面向操作终端的运行入口。它连接指定的 Runtime target，每次启动或重新连接时打开当前已交付 App 的首页。Player 不包含工程编辑、Build 或 Deploy 能力，也不能替代工程备份。

单独安装 Player​

从 Theseus 下载页面 选择 Theseus Player，下载 Windows x64 EXE 安装包。下载无需登录。运行安装包后启动 Player，按下文连接控制器提供的运行目标。

安装包不携带运行页面依赖。通常 Windows 已提供所需组件；缺失时 Player 安装器会下载微软引导程序。升级时先关闭 Player，再运行新版安装包；应用配置保留。当前独立 Player 通过下载安装包升级，没有自动更新。

独立运行服务随控制器交付，官网不提供单独 Runtime 安装包。开发电脑安装 Theseus Desktop 即可；操作终端单独安装 Player。

搜索附近 Runtime​

在 Player 连接设置页点击搜索附近 Runtime，等待约五秒，然后选择设备地址。地址会填入表单，点击保存并连接才会连接。结果中的实例标识可用于核对设备，多网卡设备可能显示多个地址。

请允许系统的本地网络访问。目标必须在同一局域网并启用服务发现；未发现设备时可以手动填写地址。发现不跳过 HTTPS 证书校验，也不共享 Theseus 的登录状态。

从 Theseus 直接打开​

Theseus 安装包自带 Player。在 App Hub 选择工程，或打开工程编辑器后，点击运行控件旁的在 Player 中打开。Player 会连接当前选中的运行目标，无需手动填写地址；工程和未保存的编辑内容会保留。

该入口打开的是目标上已交付的应用，不会自动 Build、交付或启动。目标未交付应用或交付的是其他工程时，会提示原因；请先完成对应工程的交付，并按需要启动。应用要求登录时，在 Player 中使用应用账号登录。

重复点击会唤起已有 Player；连接同一目标时保留当前页面，切换目标时进入新目标的应用首页。原有运行入口继续使用 Theseus 内的运行窗口。

更新或卸载 Theseus 前，请先关闭 Player。Theseus 不携带运行页面所需的系统组件。关闭 Theseus 后，如需持续使用 Player，应连接独立运行的目标；由 Theseus 启动的本地目标会随 Theseus 退出。

现场操作终端仍可单独安装 Player，按下文配置。

开始前​

  • 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 配置。不要把共享密钥写入普通文件或分发给无关终端。

登录并打开应用首页​

  1. 在运行页使用 Runtime target 账户登录。
  2. 确认当前 App 为 Running。如果是 Stopped，由目标 Admin 在确认现场条件后 Start；User 终端不能自行启动。
  3. 确认自动打开的是当前 App 配置的首页，再按需要使用应用导航切换 Page。
  4. 如果 App 使用业务角色，再通过 App user 登录或切换为实际操作员。
  5. 退出并重新启动 Player，确认终端返回当前 App 的首页。页面内导航不会改变下次启动的入口。

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

使用应用助手（Alpha）​

运行时应用助手仅在 Player 中提供。配置 AI 后，点击页面右下角的打开应用助手图标，描述操作，例如“把名称填写为测试机，再点击保存”。助手优先读取页面控件并操作；需要检查画面时可以要求“截图检查当前页面”。截图需要所选模型支持图片输入。

助手会将已确定的连续操作合并执行，并在需要新页面信息时重新观察。每批操作显示为一条可展开记录；某一步失败会停止后续步骤，已执行的操作不会自动撤销或重做。回复完成后，操作过程默认折叠，最终回复支持 Markdown 格式和一键复制。

操作可见控件时，黑色箭头带白色轮廓和蓝色光晕，直接出现在第一个目标上，不带文字标签。后续操作会从上一个位置移动到下一个位置：短距离轻快挪动，长距离沿平滑曲线移动，伴随自然转向和轻微形变，到达后再执行操作。任务结束时，鼠标同步缩小、模糊并淡出。鼠标经过助手面板时会被面板遮挡。这个鼠标不影响你的鼠标或触控；点击停止会取消尚未完成的移动和后续操作，截图不包含鼠标。系统启用减少动态效果时省略动画。滚动、拖动和自定义脚本目前不展示对应的移动轨迹。

输入时按 Enter 发送，Shift+Enter 换行；在输入区连续按两次 Esc 可停止当前任务。模型仅在 Player 设置页选择，聊天输入区不提供模型切换。通过历史对话可以搜索、切换、重命名或删除对话。任务完成后，尚未查看的回复会在历史对话列表显示小蓝点；只要还有这样的对话，右下角助手按钮右上方也会显示蓝点。打开对应对话后清除它的标记，仅打开列表不会全部清除；完成时正在查看的对话视为已读。蓝点在下次打开应用后保留。上翻查看消息时，新回复不会强制滚到底部；点击回到最新消息继续跟随。桌面端可使用展开面板加宽阅读区域。

助手面板在操作期间保持原来的展开状态，不改变业务页面尺寸。助手按画面位置操作时，可以点击面板遮住的业务控件，也支持同源嵌入页面；你的手动点击仍正常操作面板。只有实际截图期间会短暂隐藏，截图完成、失败或停止后恢复。可以点击停止中断当前任务，通过历史对话切换对话，通过设置返回 Player 配置。

这是功能验证版本。普通浏览器与编辑器预览不提供该助手。部分自定义控件和跨源嵌入内容可能无法直接操作；整页重新加载会中断当前任务，需要重新发起。请在测试环境核对操作结果。

查看应用文档​

点击右下角的打开应用助手，再点击面板顶部的文档书本按钮。选择文档即可阅读，支持表格、代码块、图片和手册内的文档链接。返回目录可选择其他文档，返回对话恢复原来的对话和输入；切换不会停止正在执行的任务。

查看文档无需配置 AI，内容来自当前已交付的 App。首次打开会下载整份手册及图片，后续只在版本变化时更新；更新完成后才切换内容并清理旧版本。已经打开的页面断网后可继续查阅缓存，顶部会标明离线状态和版本。没有文档时显示空目录提示；加载失败可点击重试。阅读视图支持 Markdown 和 PDF，不提供编辑，也不打开外部链接或其他类型附件。

配置 AI 后，可以直接询问“查一下报警复位步骤，并注明文档出处”。助手在每次任务首次查阅时检查文档版本，后续搜索和读取复用这次同步结果。可按需查看接线图等图片，无需先打开文档面板。回复引用文档路径及 Markdown 行号或 PDF 页码；离线时会说明使用的是缓存版本。查看图片需要所选模型支持图片输入，文字搜索不会自动识别图片里的内容。

在目录上方输入关键词并点击搜索，可查询操作指南和 PDF 参考手册正文。点击结果跳到对应位置；PDF 支持翻页、输入页码和缩放。可按完整参数编号（如 P00.01）搜索。没有可提取文字的 PDF 页会提示需要 OCR；接线图和复杂表格可要求助手查看指定页图片，需模型支持图片输入。

开发者可以把用户操作指南放在 manual/，把电机、驱动器等原厂 PDF 放在 manual/references/。整个目录都会随 App 交付。保存文档后重新 Build 并交付，Player 才能搜索新内容；较早交付的 App 需要重新 Build 才支持新版搜索。开发时遇到无文字页的提示，应补充可搜索文字或先完成 OCR，再交付。

现场验收​

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

更换目标或应用首页​

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

  1. 从 Player 打开重新配置。
  2. 核对并保存新的 Runtime target 地址。
  3. 重新登录目标账户。
  4. 确认打开新目标上当前 App 的首页。
  5. 重启 Player，确认进入新目标的应用首页。

需要更换启动首页时，在 App 中修改首页设置并重新交付，再重新连接 Player。无需重新保存相同的目标地址。

常见问题​

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

安全要求​

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

下一步​

Player 外观设置适用于设置页、助手面板和悬浮按钮，不改变业务页面自己的配色。跟随系统模式会随系统主题变化自动更新。运行页等比适配窗口，至少一组对边贴合窗口、另一方向居中；助手按钮固定在窗口上，不随页面缩放。