前言¶
如果你需要讓 DSH 智能體完成網頁瀏覽、點擊、填表、截圖，常見做法會在 CDP 端點或 MCP 服務上再加一層鏈路。duyefeng/dsh-browser 的說明裏明確：不用配 CDP，也不用跑 MCP。
它底層使用 Playwright，直接驅動本機已安裝的 Microsoft Edge，並把瀏覽器動作封裝成一組 browser_* 工具供智能體調用。
這是什麼¶
dsh-browser 是一個給 DeepSeek Harness（DSH）用的瀏覽器插件。裝上之後，AI 可以直接打開網頁、點擊按鈕、填寫表單、截圖。
倉庫位於 duyefeng 名下：https://github.com/duyefeng/dsh-browser。許可證爲 MIT。
核心能力¶
- 底層是 Playwright，直接驅動電腦上已經安裝好的 Microsoft Edge。
- 頁面行爲與真人瀏覽一致，cookie、JS、登錄態都會保留。
- 不需要單獨配置 CDP，也不需要運行 MCP 服務。
- 向智能體提供以下瀏覽器工具：
| 工具 | 說明 |
|---|---|
browser_navigate(url) |
打開網址 |
browser_snapshot() |
讀取當前頁面，例如標題、正文、可點元素 |
browser_click(selector) |
點擊某個元素 |
browser_type(selector, text) |
往輸入框裏填字 |
browser_press(key) |
按鍵盤，例如 Enter、Tab、Esc |
browser_evaluate(expression) |
在頁面裏執行一段 JavaScript |
browser_screenshot() |
截圖，並返回圖片路徑 |
browser_close() |
關閉本次會話的瀏覽器 |
package.json 聲明依賴 playwright-core ^1.49.0，並聲明 peerDependencies：@deepseek-ai/cordis、@deepseek-ai/dsh-tools。
環境要求¶
使用這個插件前，先確認環境滿足：
- Node.js 22+。
- 安裝了 Microsoft Edge。
- 有
dsh命令行；如果在源碼 checkout 裏運行，可用pnpm dsh。
安裝與啓用¶
先安裝插件：
dsh plugin --profile web add github:duyefeng/dsh-browser
然後啓動：
dsh web
插件是在 profile 啓動時讀取的。安裝後需要重啓一下 profile，否則不會生效。
典型用法¶
裝好之後，可以直接用自然語言讓 AI 做瀏覽器任務，例如：
- “打開
example.com，讀一下正文，告訴我標題。” - “打開百度搜“天氣”，把第一條結果的標題給我。”
- “打開這個登錄頁，填好賬號密碼，截個圖給我看。”
AI 會根據任務調用對應的 browser_* 工具。
覆蓋默認配置¶
如果默認行爲不符合要求，可以在 profile 的 cordis.patch.yml 中覆蓋 browser 配置：
- id: browser
config:
channel: msedge # 使用已安裝的 Microsoft Edge
headless: false # false：有界面；true：無頭運行
timeoutMs: 30000 # 單次操作超時，單位毫秒
適用場景與注意¶
適合需要在 DSH 裏完成網頁瀏覽、點擊、填表、截圖，並且本機已有 Microsoft Edge 的場景。
因爲它會直接操作瀏覽器並讀取頁面內容，屬於敏感能力。安裝前建議檢查源碼和 MIT 許可證；運行時也會以當前 dsh 進程權限執行瀏覽器操作，請確認所連頁面和輸入內容可信。
鏈接¶
- GitHub：
https://github.com/duyefeng/dsh-browser - 目錄頁：按所在 DSH 插件目錄搜索
dsh-browser；社區目錄獨立於 DeepSeek / 幻方，不是官方應用商店。
