DeepSeek Harness 插件

dsh-cloudflare-browser-run

DeepSeek Harness plugin: web browsing tools (markdown / screenshot / pdf) powered by Cloudflare Browser Run — real headless Chrome with JS rendering, login sessions and WebMCP support.(英文原文)

跳到安装方式

来源信息

GitHub 仓库
RealAlexandreAI/dsh-cloudflare-browser-run
最近更新
2026年8月19日
分类
工具与能力
GitHub stars
1
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/RealAlexandreAI/dsh-cloudflare-browser-run
插件名:dsh-cloudflare-browser-run
作者:RealAlexandreAI

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器4 个文件
README.zh.md来源说明 · 只读预览
README 语言

<p align="center"> <img src="assets/readme/hero.zh.svg" alt="dsh-cloudflare-browser-run —— 给 DeepSeek Harness 的真浏览器能力" width="100%"> </p>

dsh-cloudflare-browser-run

给 DeepSeek Harness 的 agent 真正的浏览器访问能力:headless Chrome 跑在 Cloudflare 网络上,JS 渲染页面、截图、PDF 都能处理。

> 由 pi-cloudflare-browser-run 移植,完全符合 dsh 的 Cordis 插件规范。

English · 中文

为什么需要它

dsh 内置的 web_fetch 只是普通 HTTP fetch——JS 页面拿回来是空壳,官方也标注 SSRF 防护待补。本插件补上:

  • 任意公开页面的干净 markdown(SPA/JS 页面也能读)
  • 截图(PNG)和 PDF
  • 登录态会话、WebMCP 站点

快速开始

dsh plugin --profile web add dsh-cloudflare-browser-run

在 profile/settings 层配置凭据:

- id: cloudflare-browser-run
  name: dsh-cloudflare-browser-run
  config:
    cf_api_token: <你的 token>
    cf_account_id: <你的 account id>

Token:Cloudflare 控制台 → API Tokens → 模板选 Browser Rendering: Edit。 Account id:dash.cloudflare.com/<ACCOUNT_ID>/...

工具

工具说明
browse抓取公开 URL → 干净 markdown(默认);action 可选 screenshot / pdf
screenshot页面截图存为 PNG,返回本地路径
pdf页面渲染为 PDF,返回本地路径

配置

必填说明
cf_api_token你的 API token(Browser Rendering:Edit)
cf_account_id你的 Cloudflare 账号 ID
cf_api_baseAPI 地址覆盖
output_dir截图/PDF 输出目录(默认系统临时目录)

隐私

  • 只访问公网:所有 URL 先过 SSRF 防护(localhost/内网 IP/IPv6/userinfo 一律拒绝)
  • token 只存在于你的配置文件——不写日志、不落盘
  • Browser Run 以合规 bot 身份访问,是正规的抓取方式

开发

npm install
npm run typecheck
npm test          # SSRF 防护 / 配置 / API 调用形状
npm run build

真实 API 集成测试(不参与 npm test):

DSH_TEST_CF_TOKEN=<token> DSH_TEST_CF_ACCOUNT=<account> node --import tsx tests/real/real-cf.mjs

License

MIT