架构和数据流
Screph 是 Windows-first PySide6 工作台。规范项目是核心：Capture 提供源，Selector 拥有标注，CV 生成可审查的结果，下游组件接收选定的上下文。
组件
Desktop shell / Program Mode导航、设置、托盘和工作区选择。
Capture → Canvas / Selector源移动到共享画布；标注通过可撤消命令进行更改。
CV Registry / Pipeline / Presentations方法和图形计算掩模、叠加、候选结果、证据和诊断。
Canonical project元素/特征、注释、关系、组和产物参考。
Downstream adapters自动化运行时、AI Assistant、Screph Code/Pro Agent、IDE 和语音。
Online boundaries设备验证、支持、诊断和工作服务器语音从选定的操作开始。具有存储令牌的配置文件，更新元数据并自动刷新帮助缓存；激活语音设置可能会探测其提供者。模型目录/档案和流使用单独的端点。
本地和在线执行
规范项目、Selector 和本地 CV、语音和 LLM 路径保留在用户的计算机上。用户内容通过选定的功能进行传输：支持发送消息和附件，诊断发送明确确认的 ZIP，服务器语音发送 WAV 音频，云 LLM 接收允许的上下文。日志记录页面提供了审核的清单；启动崩溃提示不显示。另外，具有存储令牌的桌面每 30 秒刷新一次配置文件；安装的版本可以获取更新元数据和六个嵌入式帮助页面。激活 OpenAI/LiteLLM 语音设置会检查目录或发送合成静音探测。模型目录/档案和 URL 流联系其主机，但不上传规范项目。存在 SCREPH_TELEMETRY 配置标志，但当前运行时未初始化自动遥测导出器。
本地进程和环回
单独的进程将生命周期和故障分开，但本身不会创建沙箱。除非下面另有说明，子组件以当前 Windows 用户身份运行，并且可以使用该用户的文件、网络和设备。
| 组件 | 边界 | 对用户来说重要的事情 |
|---|---|---|
| Screph Code / Pro Agent | 独立进程，通过 stdin/stdout 和会话/上下文文件的 JSON-RPC | 相同的操作系统用户权限；审核和 diff 是工作流控件，而不是操作系统沙箱 |
| 支持助手 | screph-support-chat.v1 通过标准输入/标准输出；助手执行 HTTPS | 秘密形状的环境变量被过滤，但所选请求的身份验证上下文被显式传递；没有打开环回端口 |
| Monaco | 127.0.0.1, 临时端口 | 本地静态资产服务器随小部件一起关闭；这不是云 API |
| Codex bridge log | POST /codex-bridge-log 在临时环回端口上 | 未经身份验证的本地端点接受最多 256 KiB 的 JSON 并将其字段写入 Screph 日志 |
| Automation Manager UI / 工作流 | UI 通常位于桌面进程中；选定的工作流作为带有 stdout/EVT 和控制文件的 Python 子项运行 | 子进程继承环境和用户权限； Stop 控制直接子进程，不一定控制其整个进程树 |
| OAuth callback | 127.0.0.1:8443/8765 | 默认情况下禁用旧机制；当前设备流未打开此监听器 |
| Temporal worker | 多处理管道/共享内存 | 内部/原型传输；正常的 CV 执行不得被描述为独立的工作线程 |
信任边界
不会保存自动 live-预览重新计算，并且在没有显式审核/apply 的情况下，候选结果不会成为规范几何或语义。主 CV 面板中的手动应用可能会将视觉结果附加到图像序列，但不接受候选结果作为标注。下游边界不同：Automation Runtime 需要单独的运行操作，同时向当前 Screph Code 发送请求，Builder 授予所选工作空间内的代理模式写入访问权限。此路径没有通用的每个文件确认。
模式准备就绪
- General, GUI Automation: 端到端工作流已准备就绪。
- Industrial, UAV: 可选择的基础/域工作区；不是生产控制/导出路径。
- Ground Robotics: 内部延迟脚手架。
详细工程文档
状态报告、能力矩阵、技术架构和决策与源代码一起存在，并根据实施证据进行更新。
在 GitHub 上打开工程文档 →