dsh-browser DSH plugin

dsh-browser adds a full browser (Microsoft Edge) to DSH, enabling AI agents to interact with real websites. It supports persistent login sessions, anti-detection, and configurable window modes. Install via dsh plugin command and restart dsh web to use.

browser-web

How to install the dsh-browser DSH plugin

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

Copying does not run this command. Review the repository and version before installing the dsh-browser DSH plugin.

dsh-browser DSH plugin data source

dsh-browser DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-browser DSH plugin can do

Navigate to any public HTTP(S) URL with SSRF protection
Read page content, take screenshots, and perform clicks (by ref or CSS selector)
Type text, scroll, go back, and fill forms
Optional browser_evaluate for executing JavaScript in pages (disabled by default)
Persistent login profile stored in ~/.dsh/edge-profile, survives restarts
Three window modes: visible (default), hidden (minimized), headless (server/CI)
Lightweight anti-detection patches (stealth mode) to bypass bot detection

Where the dsh-browser DSH plugin fits

Automate browsing of anti-scraping sites like Bilibili, Zhihu
Log into websites once and let AI maintain the session across conversations
Extract data from dynamic web pages that require interaction
Test web applications by simulating user actions

Who the dsh-browser DSH plugin is for

DSH users who need AI to interact with real web pages
Developers building automation workflows that require browser capabilities

dsh-browser DSH plugin limitations

Only public HTTP(S) domains allowed; internal/private IPs blocked (SSRF protection)
Strong anti-bot sites may still detect automation despite stealth patches
browser_evaluate is high-risk and disabled by default; must be explicitly enabled with caution
Requires Microsoft Edge installed on the system; headless mode may not work on all servers

dsh-browser DSH plugin: from the repository README

Quoted from the xylt369/dsh-browser README, the upstream source of the dsh-browser DSH plugin. Copyright remains with the original authors.

给 [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

Read the full READMERepository license: MIT

dsh-browser DSH plugin questions

Can I close the Edge window that pops up?

Do not close it while using the AI. If you close it, the plugin will automatically reopen a new window, but the page state will be reset.

Will my login session be lost?

No. The profile is stored in ~/.dsh/edge-profile and persists across DSH restarts and computer reboots. You only need to log in once.

Which websites can't be accessed?

By default, all public domains are allowed. Internal addresses like localhost, 192.168.x, 10.x are blocked to prevent SSRF attacks. You can customize the whitelist/blacklist in settings.

How to customize the allow/deny list?

Edit the `web-permission` section in $DSH_HOME/settings.yaml. It supports hot-reload, so you don't need to restart DSH. Alternatively, edit ~/.dsh/profiles/web/cordis.patch.yml.

How to uninstall dsh-browser?

Run `dsh plugin --profile web remove @yeesy369/dsh-browser-playwright @yeesy369/dsh-tool-browser @yeesy369/dsh-web-permission` in the terminal.