Codex 多任务监督屏 — SDK Application

此目录仅包含这个功能。通过 WatcheRobot SDK / Daemon 的 Application Device channel 同步圆屏；没有独立串口服务、第二条设备连接、桌面安装器、Node 运行时或 Codex 执行权限。

运行条件

• Windows、Python 3.10–3.12，以及 watcherobot>=0.1.9,<0.2（应用商店负责 SDK 运行环境）。
• 本机安装并使用 Codex，存在 sessions/ 生命周期日志。读取 CODEX_HOME，未设置时读取当前用户的 .codex。
• 圆屏设备必须安装声明 display.task_dial.v1 的配套固件。普通 SDK 0.1.10 所支持的旧固件不包含该功能。 缺少能力时应用会明确提示升级，不伪装为连接成功。
• 2026-10-08 已通过配套固件的 SDK 真机验收：0/1/3/4 任务、三任务连续三轮、完成与下一轮复位、应用/Daemon 重启重连，以及真实 Codex 元数据同步。另已验证两种商店格式的本地快照在独立 Python 环境中安装并连接真机。这不等于远端下载验证或商店上架；后两项需在公开发布后分别核验。

启动

使用设备屏幕上当前的六位配对码，在同一局域网通过 SDK 配对；不需要重新配置已有 Wi-Fi。

watcherobot robot pair <屏幕上的当前六位码>
watcherobot app check .
watcherobot app run .

通过应用商店安装时，在桌面端选择本应用后启动即可。不要直接运行 python app.py，因为设备通道及安全运行身份由 Daemon 注入。启动后会打开仅本机可访问的预览页面。电脑页面上的模拟模式只改变网页演示，不向设备发送模拟任务。

状态规则

• 只提醒，不执行、确认、取消或中断 Codex 任务。
• 本轮开始：中等饱和度绿色活动刻度。本轮真实完成：该任务所属刻度全部亮为 #A5F339。下一轮开始立即复位。不估算完成百分比。
• 一次显示最多四个等分任务区域，保留曲线中文名称及中间时间。更多会话在电脑列表查看。
• 当天多轮会话保留；首次运行即显示；只有一轮的完成提示保留四秒。往日会话不占用圆屏。
• SDK 每秒发送一个完整状态快照并核对设备实际绘制的任务数、标题数、刻度数和完成掩码。离线不标记为已连接；停止应用时释放显示。没有心跳时先冻结、显示 LINK，八秒后释放界面。
• 每次独立运行和序号均可在设备回执核验。设备没有公布所需能力、拒绝消息或绘制不匹配时停止报告“已连接”。

隐私与边界

只在本机读取会话 ID、用户已有会话标题、轮次和开始/完成时间；不把提示词、回复和工具输出作为标题或发送给设备。SQLite 以只读方式打开，不写 Codex 文件。不发送任何 Codex 数据到应用商店或第三方服务器。网页只绑定回环地址并拒绝外部 Origin/Host。

上传应用会公开此目录的源码，但不能上传会话日志、数据库、凭据、运行缓存、固件备份或测试运行产物。.watcherignore 排除这些类别。

测试

python -m unittest discover -s tests -v
watcherobot app check .

设置 WATCHER_CODEX_RUN_INTEGRATION=1 后，test_managed_runtime.py 还会创建独立 SDK Daemon 和临时合成会话，检查三个任务连续三轮、重新启动和优雅退出；它不连接硬件，不能替代真机测试。测试环境可用 WATCHER_CODEX_DATA_HOME 指向合成数据目录，绝不能为测试修改用户真实 Codex 会话。

源码结构：monitor.py 负责只读数据采集，selection.py 保留既有筛选规则，display_sdk.py 是基于 SDK 公共通道的圆屏扩展，http_service.py 提供只读本机预览，app.py 处理 Daemon 生命周期，web/ 是原有批准的圆屏 UI。

发布

仅在完整真机和安装测试通过后，按 check → publish → 固定快照下载/安装复验 → submit 顺序分别提交 Gitee 和 Hugging Face。两个平台使用相同版本和相同源码；提交审核成功不代表维护者已经批准上架。登录需由账号持有人在本机完成，不要在聊天中发送令牌。