dsh-cloak-browser

主要功能

• 为每个 Agent 分配独立的 BrowserContext，在 Agent 销毁或插件卸载时自动关闭，避免会话状态互相泄露。
• 导航与交互后自动生成有界页面快照，返回如 p1:s3:e8 的短期元素引用，Agent 可直接据此继续操作。
• 支持内嵌 iframe 中的元素快照与交互，并识别选中、展开、必填、无效、只读等表单状态。
• 提供导航、点击、填表、选择、键盘、等待、内容提取、截图、标签页与生命周期等完整浏览器工具集。
• 可选启用 CloakBrowser 的拟人化鼠标/输入/滚动，以及代理场景下自动开启的 GeoIP 一致性匹配。
• 自动检测 License 计划：验证通过的 Free Key 无需用户确认即可启动，并对同进程内并发 Free 会话进行排队串行化。

适合什么时候用

• 需要在 DSH 中让 Agent 打开真实网页并进行导航、点击、填表等交互操作。
• 多 Agent 并发运行时，需要各自隔离的浏览器会话，避免状态互相干扰。
• 目标站点存在反自动化检测，希望借助指纹补丁、代理与 GeoIP 匹配降低被识别风险。

安装后会多出什么

使用前需要

• Node.js 20 及以上版本。
• DeepSeek Harness (DSH) 版本 0.1.0-rc.6 及以上。
• 依赖 profile 中已提供的 @deepseek-ai/dsh-llm 与 @deepseek-ai/dsh-tools 运行时实例（peerDependencies）。
• 首次使用会自动下载约 200MB 的 Chromium 包及缓存（存于 ~/.cloakbrowser），无需手动执行 playwright install。
• 可选：设置 CLOAKBROWSER_LICENSE_KEY 环境变量以使用付费计划，未设置则使用免费版。
• 可选：设置 CLOAKBROWSER_PROXY_URL 以启用代理及自动 GeoIP 匹配（首次会额外下载约 70MB GeoLite 数据库）。
• 支持 CloakBrowser 所兼容的 Linux、macOS 或 Windows 平台。