SuperAPI AI 工具集

diagnose-mac-live-view

部署与运维

查看项目

更新于 11-03 23:38

技能介绍

用途:该技能用于诊断 Mac 任务 Watch 或 owner 窗口画面冻结、消失或无法重新打开的问题,主要面向 Opensteer 的 Desktop 实时视图链路排查。

主要能力:读取当前与轮转的 Desktop 日志;对 Beta 版本,从 desktop.log 检索 computer.display.client、computer-use.video、computer-use.media-ended,从 personal-host.log 检索 computer.display.viewer-removed、computer.display.lifecycle,从 personal-runner.log 检索 computer.display.relay-ended。技能可将不透明的来源/视图 ID 与 Host 流 ID 及媒体代次关联,先检查可见性与保留/释放原因,再判断是否为捕获问题;识别隐藏需求、零查看器、warming 和 Display demand ended 等可见需求丢失信号;区分 4002 关闭加协议违规的终态(故意不重试)与瞬态关闭(除非最后查看器已离开,否则应安排重试)。

使用方式:按资料给出的 rg 命令在相应安装的数据目录中检索日志;远程 Runner 日志保留在该 Runner 上。针对重开失败,检查 native-start-error 操作、原生 domain/code 与 helper code;针对 producer-stalled,检查在途工作、未完成字节和最旧确认年龄,以区分编码器饱和与下游信用丢失,producer-resumed 表示该阶段结束;检查首个媒体/中继结束原因以判断缓冲区限制、套接字丢失或所有者丢失。报告中保留不含内容的 ID 与类型化原因。

适用场景:Opensteer Mac 实时视图出现冻结、消失、无法重开、生产者停滞或中继/媒体异常结束时。

限制:资料未提供安装方式、价格、支持平台范围或效果保证;修改恢复逻辑前需查阅 docs/computer-use.md 中的权限与抑制规则;不得在诊断中加入像素、窗口标题、输入内容、URL 或原生错误用户信息。