跳到正文

xylt369/dsh-browser

51最近提交 2026年8月15日

dsh-browser DSH 插件

dsh-browser 为 DeepSeek Harness 增加真实浏览器(Microsoft Edge),让 AI 代理能与真实网站交互。支持持久化登录会话、反检测补丁和可配置窗口模式。通过 dsh plugin 命令安装,重启 dsh web 即可使用。

如何安装 dsh-browser DSH 插件

dsh plugin --profile web add @yeesy369/dsh-browser-playwright @yeesy369/dsh-tool-browser @yeesy369/dsh-web-permission

复制不会执行命令。安装 dsh-browser DSH 插件前请核对仓库和版本。

dsh-browser DSH 插件数据来源

dsh-browser DSH 插件快照日期:2026年8月16日

discovered

dsh-browser DSH 插件能做什么

  • 访问任意公网 HTTP(S) 地址,经 SSRF 校验
  • 读取页面内容、截图,支持按 ref 或 CSS 选择器点击
  • 输入文字、滚动、返回、填写表单
  • 可选 browser_evaluate 在页面中执行 JavaScript(默认关闭)
  • 持久化登录态保存在 ~/.dsh/edge-profile,重启不丢失
  • 三种窗口模式:可见(默认)、隐藏(最小化)、无头(服务器/CI)
  • 轻量反检测补丁(stealth 模式)绕过机器人识别

dsh-browser DSH 插件适合哪些场景

  • 自动化访问反爬严格的网站(如 Bilibili、知乎)
  • 一次性登录网站,让 AI 在后续对话中保持会话
  • 从需要交互的动态网页中提取数据
  • 通过模拟用户操作测试 Web 应用

dsh-browser DSH 插件适合谁

  • 需要 AI 与真实网页交互的 DSH 用户
  • 构建需要浏览器能力的自动化工作流的开发者

dsh-browser DSH 插件的限制

  • 仅允许公网域名;内网/私有 IP 被拦截(SSRF 安全设计)
  • 反爬极强的站点仍可能识别出自动化行为,尽管有 stealth 补丁
  • browser_evaluate 风险高且默认关闭,需明确启用并谨慎使用
  • 需要系统已安装 Microsoft Edge;无头模式在部分服务器上可能不可用

dsh-browser DSH 插件的仓库 README 摘录

以下文字摘自 dsh-browser DSH 插件的上游仓库 xylt369/dsh-browser 的 README,版权归原作者,仅作引用。

给 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(`dsh`)装上**浏览器能力**:让 AI 能打开真实网页、读内容、点按钮、填表单、截图。 `dsh` 原本只有文件系统、Shell、搜索和抓取工具,**没有浏览器**。本仓库按 `dsh` 的插件模型补上这块能力,默认使用你电脑上的 **Microsoft Edge**(真实浏览器窗口,带反检测),bilibili、知乎这类反爬严格的网站也能正常访问。 ## 快速开始(3 步) **第 0 步 · 检查有没有 dsh**(只需做一次,跳过也没关系) 打开终端(Windows:按 `Win + R`,输入 `cmd` 回车),运行: ```sh dsh --version ``` - ✅ **有输出**(比如 `0.1.0-rc.6`)→ 你已经装好了,直接进入第 1 步 - ❌ **提示"不是内部或外部命令" / "command not found"** → 说明还没装,任选一种方式安装: **方式 A · 命令行安装**(复制这行命令粘贴执行): ```sh npm i -g @deepseek-ai/dsh ``` **方式 B · 打开网页安装**:浏览器访问 https://www.npmjs.com/package/@deepseek-ai/dsh ,按页面上的提示执行安装命令。 装完**重新打开一个终端窗口**,再运行一次 `dsh --version`,确认有输出后继续。 > 💡 不想安装到系统里?也可以不装,直接把后面命令里的 `dsh` 全部换成 `npx @deepseek-ai/dsh`(效果一样,只是每次走临时缓存)。 **第 1 步 · 安装插件**(任意终端执行): ```sh dsh plugin --profile web add @yeesy369/dsh-browser-playwright @yeesy369/dsh-tool-browser @yeesy369/dsh-web-permission ``` > Windows 也可以用一键脚本(效果等价,还会自动写入示例白名单): > ```sh > powershell -ExecutionPolicy Bypass -File scripts/install.ps1 > ``` **第 2 步 · 重启 dsh**:在运行 `dsh web` 的终端按 `Ctrl+C`,然后重新运行 `dsh web`。 **第 3 步 · 开用**:对 AI 说"打开 https://www.bilibili.com"。第一次会弹出 Edge 窗口——**别关它**,那是 AI

阅读完整 README仓库许可: MIT

dsh-browser DSH 插件常见问题

弹出的 Edge 窗口可以关掉吗?

使用期间不要关。如果关掉了,插件会自动重新打开一个新窗口,但页面状态会重置。

登录状态会丢失吗?

不会。登录态保存在 ~/.dsh/edge-profile,重启 DSH 或重启电脑都会保留,只需登录一次。

哪些网站访问不了?

默认放行所有公网域名。localhost、192.168.x、10.x 等内网地址被拦截,这是为了防止 SSRF 攻击。你可以通过配置文件自定义白名单/黑名单。

如何自定义允许/禁止列表?

编辑 $DSH_HOME/settings.yaml 中的 web-permission 节,支持热更新,无需重启 DSH。也可以编辑 ~/.dsh/profiles/web/cordis.patch.yml。

如何卸载 dsh-browser?

在终端中执行:dsh plugin --profile web remove @yeesy369/dsh-browser-playwright @yeesy369/dsh-tool-browser @yeesy369/dsh-web-permission