
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