1. 依赖项选项卡
打开主设置窗口并选择 Dependencies。摘要显示有多少组件已准备就绪、丢失、损坏或禁用。该表显示所选和检测到的全局路径、估计大小和可能的磁盘节省。
- 再次探测 — 重新检查可执行文件、导入、路径和托管资产。
- 本地安装/修复 — 在托管 ScrephData 目录中准备选定的组件并运行安装后烟雾检查。
- 本地删除 — 检查共享安装组后仅删除运行时拥有的路径。
- 使用检测到的全局 — 仅切换全局探测成功的组件。
依赖项和更新
Screph 作为一个产品安装，但不同的任务需要不同的运行时组件。 Dependencies 选项卡显示其实际状态、源和磁盘使用情况 - 没有隐藏安装或静默回退。
2. 正在检查的组件
| ID | 目的 | 何时需要 |
|---|---|---|
python.automation | Managed Python 3.12 | 执行生成的 Python 工作流。 |
script.runtime | 自动化脚本环境 | 使用 Automation Runtime。 |
cv.runtime | OpenCV/CV | 需要经典的 CV 操作和屏幕匹配。 |
ocr.runtime | Tesseract OCR | 读取或检测到文本。 |
video.runtime | FFmpeg | 需要支持的视频操作和帧精确剪切。 |
voice.local | Vosk/PyAudio | 已选择本地语音识别。 |
ml.runtime | PyTorch/vision/transformers | 使用 YOLO、SAM、OmniParser 或其他模型支持的方法。 |
codegen.runtime | Codegen/OpenHands | 使用 Screph Code。 |
模型权重和运行时本身是分开的。成功的 ml.runtime 探针不能保证特定的 YOLO/SAM/OmniParser 权重已下载并与所选方法兼容。 CV 模型和局部权重 中涵盖了存储、主动选择和 SHA 状态。
3. 运行时来源
local— ScrephData 下的托管安装；默认且最可重现的选项。global— 成功探测后的现有系统安装。custom— 在高级模式下选择的显式路径。install_global— 高级策略选项，但还不是有效的系统安装命令。当前安装程序仅为local构建安装目标；该源探测现有的全局运行时，就像global一样。不要选择希望安装到 PATH 或系统目录中的它。skip— 不要安装或使用该组件；其相关能力仍不可用。
如果所选源丢失或损坏，Screph 会报告组件错误。它不会默默地从 PATH 借用另一个 Python、Tesseract 或提供程序。 本地安装/修复跳过所有非本地源；对于 install_global，它报告没有选择本地依赖项。
4. ML 运行时和签名包
ml.runtime 是最大的块。它包括单独的软件包：PyTorch、TorchVision、Ultralytics、timm、Transformers 和 Hugging Face Hub。您可以禁用阻止或不需要的根包；安装程序验证所选子集的依赖项闭包。
网络安装使用发布清单和签名存档。在提取之前，Screph 验证组件/通道、URL 和伴随文件、SHA256、分离的 CMS/PKCS#7 签名、可信链或固定签名者指纹、锁和 SBOM。可以从磁盘中选择离线包并通过相同的有效负载验证。
向导中的两个 ML 层。 QtIFW com.screph.boteye.运行时.ml 组件是可选的应用程序负载，默认情况下不选择。依赖项页面读取该初始选择，并在 ScrephData 下启用单独的托管 ml.runtime 工作流：其默认策略提供经过验证的网络下载约 334 MB，并警告最多安装 6.5 GB，或接受本地包。两层协同工作，用于选定的 ML 工作流；经典 CV 在没有它们的情况下仍然可用。
发布预检仅下载小清单。大档案是通过单独的操作下载的；取消或失败的下载不会成为活动的运行时包。
5. 更新产品
应用程序更新和运行时-依赖项安装是相关但独立的过程。 Screph 检查其 Qt Installer Framework 存储库，并可以提供各个产品组件的更新，包括主 UI 和 Pro Agent。现有安装的维护工具执行更新。
自动运行的内容。 在具有可用维护工具的已安装版本中，启动时自动检查更新 默认情况下处于启用状态。第一次检查安排在启动后约四秒，然后限制为 24 小时间隔。仅从配置的存储库中获取 Updates.xml（最多 5 MB）；其用户代理包含 Screph/<version> update-check。不发送项目、帧和设置。在 General 设置中禁用切换。
A 失败也会启动间隔。 当前启动控制器在解释结果之前记录 last_auto_check_at：成功检查、网络故障和畸形 XML 都推迟了在配置的时间间隔内（默认为 24 小时）自动尝试下一次。关闭和打开复选框不会重置此时间戳。 打开更新管理器启动受控关机和单独的维护工具；它不会在正在运行的 Screph 进程内重复轻量级检查。
当前 Alpha 通道需要验证。 源元数据显示 channel=dev，而配置的存储库 URL 和网站发布者使用stable 路径；新的本地存储库是在 .build/updates/windows/dev 下构建的。这种不匹配本身不会改变已安装的产品，但在通道/URL 对齐且发布发布清单通过之前，当前产物的兼容自动更新不能被视为已验证。设置中的版本、通道和存储库字段保持只读诊断。
- 将当前项目和未完成的更改保存在 Screph Code 中。
- 停止录制并验证设置是否已保存。
- 确认更新。 Screph 尝试安全关闭 Selector 和单独的 Pro Agent 进程。
- 在维护工具中完成更新，然后再次探测依赖项。
准备成功后，Screph 约两秒后调度单独的维护工具并退出主进程。 Screph 并未在此发布中添加显式 runas； Windows 或安装程序可能会根据目录和操作请求提升。如果无法安全关闭活动窗口、录制或未保存状态，更新将停止并显示明确消息。
6. 刷新嵌入式帮助
这与 QtIFW 和产品更新切换是分开的。安装的版本已经包含六个核心 HTML 页面的捆绑快照，因此该部分帮助仍然可以离线使用。当 gui.docs 可用时，启动后约 1.2 秒，Screph 可能会从 screph.com/documentation/ 请求新的设置。仅当六个页面全部成功后才替换本地缓存；如果失败，则保留先前的有效集。请求使用 ScrephDocs/1.0 用户代理，不包含项目、帧、设置或帐户数据。
当前实现没有单独的切换，其防护允许在前一次尝试一小时后再次尝试。因此，它不属于应用程序更新检查的 24 小时限制范围内。仅当每个页面声明的缓存版本至少与本地版本一样新时，才应用远程集；未标记或较旧的部署无法降级捆绑快照。从嵌入式帮助到本地集之外的指南的链接会打开完整的网站并需要网络访问。
7. 读取失败
- 缺少： 所选源缺少所需的可执行文件、导入或资产。
- 损坏： 路径存在，但探测或烟雾失败；使用修复或选择其他显式来源。
- 跳过： 该组件已被用户策略禁用；这不是安装错误。
- 已下载包，未选择： 存档位于托管缓存中，但尚未被选为活动离线包。