SJF-ECNU/dsh-cloakbrowser

dsh-cloakbrowser

English

dsh-cloakbrowser 是一个 DeepSeek Harness 插件，让智能体能够使用本机已安装的 CloakBrowser。

CloakBrowser 说明与许可

本插件将 CloakBrowser 接入 DeepSeek Harness。CloakBrowser 由 CloakHQ 开发和维护；本项目不是 CloakBrowser 官方插件。

请通过 CloakHQ 的官方流程单独安装 CloakBrowser。本仓库只包含 DSH 集成，不包含或分发 CloakBrowser 浏览器二进制。Python wrapper 使用 MIT 许可证；浏览器二进制适用其单独的 Binary License。

从 GitHub 安装

前提条件：Node.js 22.19 或更新版本、Python 3.11 或更新版本，以及 Git。

快速安装（macOS/Linux）

使用默认配置时，按顺序执行以下命令即可：它会创建插件自动识别的 Python 环境，安装 CloakBrowser 及浏览器二进制，从 GitHub 加入插件，然后启动 DSH：

bash
npm install --global @deepseek-ai/dsh pnpm
python3 -m venv ~/.dsh/venvs/cloakbrowser
~/.dsh/venvs/cloakbrowser/bin/python -m pip install 'cloakbrowser>=0.4,=0.4,=0.4,。插件始终将 CDP 绑定到回环地址，因此本机 Playwright/CDP 客户端可以接入，而不会把浏览器控制权限暴露到网络。

在 Linux 上，传入 virtual_display: { width, height } 会在私有 Xvfb 显示器上以有头模式运行浏览器。Xvfb 必须已安装并在 PATH 中；插件不会安装系统软件包，并会在会话关闭时停止它启动的 Xvfb 子进程。

启动会话时设置 humanize: true，并可选传 human_preset: "careful" 或原生 human_config。browser_click 和 browser_type 也接受单次操作的 human_config 覆盖；未以 humanize: true 启动的会话会明确拒绝该覆盖。

视觉理解

可选模型的配置步骤见 从 GitHub 安装 → 完成首次配置。Base URL、模型和 API 形式作为普通 DSH 设置保存；API Key 通过 DSH 的只写凭据存储保存，之后不会再次显示。

browser_understand 是显式工具：只有智能体判断确实需要视觉理解时才调用。它会把所选标签页的当前视口截图发送给你配置的端点，返回摘要、页面内容与布局描述，以及相关可见图片或图形的观察结果。请求定位或操作元素时，它还会返回 CSS 视口坐标；用这些坐标调用 browser_click_point。普通 DOM 操作仍应优先使用选择器。该工具不会解答 CAPTCHA 或绕过人机验证，只会报告需要用户操作。

安全提示

浏览器工具可以访问目标网站的登录状态、Cookie，以及传给 CloakBrowser 的本地 profile。请只安装可信插件，在批准浏览器操作前审查请求；除非操作确有需要，不要把凭据放进工具参数。

视觉理解只会在显式调用 browser_understand 时，向用户配置的第三方端点发送截图。若页面包含敏感信息，请先确认这种披露是预期的。

已知限制

- CDP 仅暴露由本插件启动的会话；暂不支持让 bridge 附着到任意既有 CDP endpoint。
- 虚拟显示需要 Linux 和预先安装的 Xvfb；它不是自动依赖安装器，也不是远程桌面服务。
- 插件依赖本地 Python CloakBrowser 安装，不会自动安装 Python 包或浏览器二进制。