屏幕感知唤醒 win10ogod/dsh-fount-reality

dsh-fount-reality

参考理華角色包的私有 Reality Channel，为 DeepSeek Harness 提供背景屏幕观察与自主唤醒。针对 DSH 0.1.7-rc.2 开发。

插件持续采样画面，但采样计时器不直接启动 Agent loop。它先以低 FPS 巡看；检测到明显变化后，短暂提高 FPS，确认新画面连续稳定才唤醒独立的背景 Agent。视频等持续动态画面会在采样上限后退回低 FPS，并进入明示的冷却时间。背景 Agent 才会分析完整画面、检视其预设中可用的工具与记忆，只有决定有具体价值时才调用 reality_notify 发出桌面通知。日常内部分析留在独立的持久会话，不插入原本的聊天回合。

屏幕捕获使用不同于 Fount node-screenshots 的路径。Windows／macOS 共用 @screen-capture/node 的接口；Linux 后端也交付相同的 PNG 采样数据给唤醒算法：

| 桌面 | 捕获方式 | 重启后状态 |
| Windows 10 1903+ | @screen-capture/node 的 Windows Graphics Capture | 有桌面会话时自动重连 |
| macOS 12.3+ | 同一套 API，底层 ScreenCaptureKit | 已授予 Screen Recording 权限时自动重连 |
| Linux Wayland | wayland-screenshot 常驻 CLI，底层 XDG ScreenCast Portal／PipeWire | 初次运行一次 cast enroll --monitor；支持 restore token 的 Portal 可在重启后无窗口恢复，授权失效时显示 permission-required |
| Linux X11 | gnome-screenshot 后台截图，接到同一采样接口 | 可读取 DISPLAY 且已安装命令时自动重试 |

Wayland 需先安装 wayland-screenshot 与其 PipeWire／Portal 系统依赖，再以与 DSH 相同的 DSH_HOME 运行一次授权：

WAYLAND_SCREENSHOT_STATE_DIR="${DSH_HOME:-$HOME/.dsh}/storages/fount-reality/wayland" wayland-screenshot cast enroll --monitor

插件将 restore token 存在此本机目录，重启时交还 Portal 以尝试免选择器恢复；是否接受由桌面 Portal 决定。其余平台仍需登录的桌面会话与系统授权。插件只捕获主屏幕。默认只在内存保留当前画面；唤醒时才用 DSH 的附件服务保存该张画面，并交给背景 Agent。选用的模型必须接受图像输入，否则 reality_status 会显示错误，不改用无图像判断。

安装与启用

安装到所需的 DSH profile，例如 web：

dsh plugin --profile web add github:win10ogod/dsh-fount-reality
dsh --profile web --dump-config

插件默认 enabled: false；用户在 profile 的 cordis.patch.yml 启用，例如：

- id: fount-reality
name: dsh-fount-reality
config:
enabled: true
workspacePath: 'C:\Users\you\project'
idleFps: 0.2
burstFps: 2
noveltyThreshold: 0.06
stableThreshold: 0.025
stableSamples: 3
maxBurstSamples: 24
minWakeGapMs: 300000
motionCooldownMs: 60000

workspacePath 可省略；此时插件在看到有工作区的普通 Agent 会话后开始。agentPreset 可指定背景 Agent 使用的预设，省略时沿用所选会话的预设或 DSH 预设。背景 Agent 使用当前 DSH 预设模型，继承其工具与模型能力；插件没有替它降低输出、上下文或工具上限。idleFps 与 burstFps 只决定捕获频率，唤醒仍取决于画面变化与稳定性。reality_status 查看运作、最近背景活动与错误；reality_control 可暂停或恢复本次 DSH 进程中的监看，暂停时也会取消正在运行的背景回合。

npm run check 验证抽样唤醒与 DSH v4 消息来源。npm run smoke:capture 在当前登录的桌面捕获一张画面，只输出尺寸与字节数，不保存图片；Wayland 须先完成上述授权，不会由此诊断命令打开选择器。诊断命令的图像缓冲上限为 64 MiB，不影响插件使用 DSH 附件服务限额的正式路径。

验证范围：Windows 10/11 原生 API 已捕获 PNG；Linux X11 gnome-screenshot 已在原生桌面捕获 PNG；macOS arm64 套件可安装，但 SSH 会话无 Screen Recording 权限，尚未完成原生桌面捕获；Wayland restore-token 流程目前通过模拟测试，尚未在 Wayland 桌面实测。