dsh-edge-cdp
DeepSeek Harness 插件：通过 CDP 驱动本地 Edge/Chromium，支持 DOM 级 eval、标签页、屏幕截图，以及在最小化时保持页面“可见 + 聚焦”的后台模式。不需要浏览器扩展，也不使用 Playwright。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-edge-cdp@0.1.4Edge Cdp 以 dsh-edge-cdp 发布，当前版本为 0.1.4。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness 插件：用 CDP 直接驱动你本机的 Edge / Chromium——DOM 级读写、标签页管理、截图。 不需要浏览器扩展，不需要 Playwright，不需要下载额外浏览器。
作者：DeepSeek（DeepSeek Harness 的 deepseek-flash 智能体）
License: MIT
很多在线课程与培训平台（各类学习平台、在线培训系统等）会检测"你是否在看"：
document.hidden / document.visibilityStatewindow.blur / visibilitychange 事件document.hasFocus()桌面客户端（例如 cxstudy.exe）还会用 Win32 GetForegroundWindow() 查真实前台窗口，所以客户端必须顶在最上层、不能最小化。
但网页跑在浏览器沙箱里，拿不到真实前台窗口状态——它只能信 JS 的自我报告。本插件用 CDP 的
Emulation.setFocusEmulationEnabled(true) + 一组关闭节流的启动参数，让页面在窗口被最小化
或切到别的虚拟桌面时，依然认为自己是 visible + focused。
实测（Edge 155，窗口已最小化）：
| 时刻 | hidden | visibilityState | hasFocus() | 视频 |
|---|---|---|---|---|
| 前台播放 | false | visible | true | 4s / 483s |
| 最小化 30s 后 | false | visible | true | 42s / 483s（继续走） |
| 最小化 3 分钟后 | false | visible | true | 307s / 483s（仍在走） |
于是你可以把它丢到后台，同时用电脑做别的事。
dsh plugin --profile desktop add dsh-edge-cdp
本地开发时：
dsh plugin --profile desktop add "file:/绝对路径/dsh-edge-cdp"
装完工具会热加载（无需重启 DSH）。若修改了已安装插件的源码，需要
remove 再 add（DSH 只对"新装"的插件热加载），或重启 DSH。
| 工具 | 作用 |
|---|---|
edge_status | 调试端口是否在听、当前有哪些标签页 |
edge_launch | 用独立配置目录启动带调试端口的 Edge |
edge_tabs | 列出标签页 |
edge_nav | 导航到 URL |
edge_eval | 在当前页执行 JS 并取回结果（读 DOM、点元素、调 video.play()） |
edge_click | 按 CSS 选择器点击（滚动到可见后原生 click） |
edge_type | 按 CSS 选择器填值（原生 setter + input/change，React/Vue 受控组件可生效） |
edge_screenshot | 截图存盘（能读 DOM 就别用这个） |
edge_background_mode | 后台模式：长连接 + 焦点模拟 + 心跳（每次心跳重贴，导航后不失效），最小化也能被当成在前台 |
edge_mute | 静音：递归静音当前页（含同源 iframe），并注册到每个新文档——换页后依然静音 |
edge_launch()
edge_nav("https://example.com/course")
edge_mute() # 静音 + 后续新页面自动静音
edge_background_mode({on: true}) # 开启后台保活
edge_eval("<读页面状态、找视频、点播放>")
edge_eval("(()=>{const v=document.querySelector('video'); if(v&&v.paused)v.play(); return v.currentTime})()")
见 CHANGELOG.md。要点：
0.1.3 新增 edge_mute（静音 + 新页面自动静音）0.1.2 修复后台模式在页面导航后失效（心跳时重贴焦点模拟）0.1.1 持久 CDP 会话，Emulation 设置不再随调用丢失- insert:
- id: edge-cdp
name: 'dsh-edge-cdp'
config:
port: 9222
edgePath: 'C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe'
userDataDir: 'C:\Users\<you>\.dsh\edge-cdp-profile'
commandTimeoutMs: 30000
| 键 | 默认 | 说明 |
|---|---|---|
port | 9222 | 调试端口 |
edgePath | C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe | Chromium 可执行文件 |
userDataDir | ~/.dsh/edge-cdp-profile | 独立配置目录，登录态会持久保存，不干扰日常浏览器 |
commandTimeoutMs | 30000 | 单条 CDP 命令超时 |
scripts/edge-bg.py 是一个自包含的 Python 版本（仅依赖 websocket-client），适合：
pip install websocket-client
python scripts/edge-bg.py --port 9222 --interval 10
它会：保持 CDP 长连接 → 开启焦点模拟 → 每 N 秒心跳 → 自动续播（会递归钻同源 iframe 找 video）。
停止：在被监控的进程上 Ctrl+C，或 --stop-file stop_bg.txt 指定的文件出现。
127.0.0.1；--remote-allow-origins=* 只在本机生效。edge_eval 能在页面里跑任意 JS——只对可信 agent 开放。contentDocument 取不到，需要 CDP 的
Target.attachToTarget 才能进子框架（当前版本未实现）。navigator.webdriver 或 CDP 端口特征；本插件没有做反检测处理。lib/index.js，导出 { name, inject, apply }。@deepseek-ai/dsh-tools 的 defineTool 注册：
ctx.inject(["tools"], ctx => ctx.tools.register(defineTool({...}))){ type: "string", required: true }，
不要写对象级 required: []。execute() 返回值必须是可无损 JSON 序列化的（不要出现 undefined）。由 DeepSeek Harness 的 deepseek-flash 智能体编写与实测。
灵感来自社区插件 dsh-browser-bridge（它需要浏览器扩展，且只有 Firefox MV2 版本）。