前言¶
給 DeepSeek Harness（DSH）代理接瀏覽器能力時，常見路線是 Playwright：無頭環境、獨立的自動化 profile，登錄態和 cookies 與用戶日常瀏覽器完全分離，安裝時還要先跑一遍 npx playwright install。如果任務需要複用已登錄的站點，這條路要額外做很多事。
dsh-jiey-browser 換了一種做法：它通過 MCP 把真實的 Jiey Chromium（也就是用戶自己的瀏覽器）交給代理使用，而不是另起一個無頭環境。下面介紹這個插件能做什麼、怎麼裝、怎麼用。
這是什麼¶
dsh-jiey-browser 是由 jiewaigongxing 維護的 DSH 插件，定位一句話：通過 MCP 爲 DSH 代理提供真實的 Jiey Browser 工具。當前版本 0.1.4，MIT 許可證，依賴 @modelcontextprotocol/sdk ^1.30.0 與 @deepseek-ai/schemastery ^3.18.1，@deepseek-ai/cordis（>=4.0.1 <5）爲可選 peer 依賴。
需要注意的背景：DSH 目前處於 developer preview，本插件面向 Cordis / tools + systemPrompt 接口，DSH 破壞 API 時插件可能需要隨之更新。
核心功能¶
插件提供 7 個工具，各自映射到 Jiey MCP 的對應接口：
| 工具 | 對應 Jiey MCP | 作用 |
|---|---|---|
browser_open |
tabs 新建 + snapshot |
打開頁面 |
browser_navigate |
navigate |
頁面跳轉 |
browser_snapshot |
snapshot |
生成供 browser_act 使用的 refs |
browser_read |
read |
抓取 Markdown / 純文本 |
browser_act |
act |
click / fill / press 等操作 |
browser_screenshot |
screenshot |
返回內聯圖片，不寫臨時文件 |
browser_tabs |
tabs list/close |
列出 / 關閉標籤頁 |
除工具本身，還有幾個值得說明的設計：
1、自動發現 Jiey MCP 服務，順序爲：插件 serverUrl → BROWSEROS_URL / JIEY_URL → ~/.browseros/server.json → http://127.0.0.1:9100。
2、健康檢查：GET /system/health 須返回 { status: "ok" }。
3、通過 scopeId 請求頭實現標籤頁隔離，Cordis dispose 時會關閉插件自己打開的標籤頁。
4、Jiey 缺失或離線時，工具會失敗並附官方下載頁鏈接，而不是靜默回退到其他瀏覽器。
安裝與啓用¶
先確認三件事：Node.js 版本滿足 ^22.19 || >=24；已有一個 DSH profile；已安裝並打開 Jiey Browser，使其 MCP 服務可用（默認 http://127.0.0.1:9100）。Jiey 只能從官網下載：https://www.gongxingglobal.com/browser，macOS / Windows / Linux 安裝包在官網列出，倉庫本身不提供 CDN 鏈接。
從 npm 安裝：
dsh plugin --profile web add dsh-jiey-browser
# 或
npm install dsh-jiey-browser
如果是本地 checkout，先構建再安裝：
dsh plugin --profile web add /absolute/path/to/packages/dsh-jiey-browser
然後在 profile 的 cordis.patch.yml（或 DSH 設置界面）裏配置：
- id: jiey-browser
config:
serverUrl: "" # 留空 = 自動發現
scopeId: dsh-jiey-browser # 標籤頁隔離請求頭
allowCookies: false # 默認不復用登錄態
downloadUrl: https://www.gongxingglobal.com/browser
maxSnapshotChars: 40000
serverUrl 留空即走上面的自動發現鏈路；allowCookies 默認 false，不要複用登錄態和用戶標籤頁，只有用戶明確要求代理使用已登錄站點時纔打開。
典型用法¶
不裝 DSH 也能本地驗證插件與 Jiey 的鏈路。先啓動 Jiey，再執行：
npm install
npm run build
npm run smoke
Jiey 運行時，冒煙測試會打開 https://example.com、做一次快照，然後關閉標籤頁。
實際給代理用時，典型流程是：browser_open 打開頁面 → browser_snapshot 拿到 refs → browser_act 執行點擊、填表等操作；需要文本內容用 browser_read，需要確認頁面狀態用 browser_screenshot。
適用場景與注意¶
適合的場景：需要代理在真實瀏覽器裏打開、讀取、操作網頁；希望隔離各自的標籤頁、結束時自動清理；在用戶明確同意的前提下複用已登錄站點。
使用時注意：
1、安全上，allowCookies 默認 false，僅在用戶明確要求代理使用已登錄站點時開啓。
2、Jiey 離線時工具會失敗並附官方下載頁鏈接（默認 https://www.gongxingglobal.com/browser），不會靜默換瀏覽器。
3、插件以當前 dsh 進程的權限運行，安裝前建議先檢查源碼與許可證（本項目爲 MIT）。
4、DSH 處於 developer preview，插件面向 Cordis / tools + systemPrompt 接口，後續 DSH 破壞 API 時可能需要更新插件。
結尾¶
dsh-jiey-browser 做的事情很集中：把用戶真實的 Jiey 瀏覽器以 7 個 MCP 工具的形式接進 DSH，登錄態、標籤頁隔離、清理策略都有明確默認值。如果你在給 DSH 代理配聯網能力，可以看看：
- 社區目錄頁（獨立站點，與 DeepSeek / 幻方無官方從屬關係）：
https://www.skillhub.cn/plugins/jiewaigongxing/dsh-jiey-browser - GitHub 倉庫：
https://github.com/jiewaigongxing/dsh-jiey-browser
