前言¶
DSH 的插件生態強調“一切皆插件”，把可安裝、可覆蓋、可移除的能力拆成 bundle；社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不能理解成官方應用商店。
在智能體自動化裏，一個常見痛點是：模型不僅要“懂網頁”，還要能操作用戶當前已登錄、已有上下文的真實瀏覽器。傳統無頭瀏覽器或外部抓取鏈路，往往缺少登錄態，也難以覆蓋本地文件上傳、截圖、PDF 導出等動作。
下面介紹 dsh-kimi-webbridge。它把本地 Kimi WebBridge daemon 暴露給 DeepSeek Harness（dsh）智能體，使智能體可以通過本地 daemon 驅動當前用戶的真實瀏覽器。
這是什麼¶
dsh-kimi-webbridge 是 MicroHEROX 維護的 DeepSeek Harness 插件，許可證爲 MIT。
它做的事情比較具體：
- 智能體側得到一組
kimi_webbridge_*工具。 - 插件通過本地 daemon 與瀏覽器端協作。
- 操作對象是當前用戶的真實瀏覽器。
- 流程保持在本機：
plugin -> 127.0.0.1:10086 daemon -> user's real browser。 - 不依賴第三方服務中轉瀏覽器流量。
- 不需要 API keys。
- 要求 Node.js >= 18。
它解決的不是“再建一個瀏覽器沙箱”，而是讓 dsh 智能體在用戶已登錄的瀏覽器環境中完成頁面導航、讀取、點擊、填寫、截圖、網絡查看、上傳和 PDF 導出等操作。
核心能力¶
該插件提供 15 個工具，名稱如下：
kimi_webbridge_navigate
kimi_webbridge_find_tab
kimi_webbridge_list_tabs
kimi_webbridge_snapshot
kimi_webbridge_click
kimi_webbridge_fill
kimi_webbridge_evaluate
kimi_webbridge_cdp
kimi_webbridge_screenshot
kimi_webbridge_network
kimi_webbridge_upload
kimi_webbridge_save_as_pdf
kimi_webbridge_close_tab
kimi_webbridge_close_session
kimi_webbridge_start_daemon
覆蓋的能力包括：
1、打開頁面。
2、查找或列出標籤頁。
3、讀取頁面快照。
4、點擊元素。
5、填寫表單。
6、在頁面中執行 JavaScript。
7、截圖。
8、查看網絡請求。
9、上傳文件。
10、保存當前頁面爲 PDF。
11、關閉標籤頁。
12、關閉整個會話。
13、在 daemon 不可達時嘗試啓動本地 daemon。
這些工具都以 kimi_webbridge_ 爲前綴，便於在 dsh 工具目錄中識別和篩選。
安裝與啓用¶
先使用官方給出的安裝命令。這裏以 demo profile 爲例：
dsh plugin --profile demo add github:MicroHEROX/dsh-Kimi-WebBridge
安裝完成後，啓動帶 web 能力的 profile：
dsh --profile demo web
啓用後，智能體目錄中會出現 kimi_webbridge_* 工具。
如果需要按一次性 overlay 方式運行，可以使用：
dsh web --patch ./kimi-webbridge.overlay.yml
這個命令只作爲運行入口，具體 overlay 內容應放在本機已有的 kimi-webbridge.overlay.yml 中。
移除插件時使用：
dsh plugin --profile demo remove dsh-kimi-webbridge
典型用法¶
下面是一個可復現的問法示例。
先安裝並啓動：
dsh plugin --profile demo add github:MicroHEROX/dsh-Kimi-WebBridge
dsh --profile demo web
然後給智能體這樣的任務：
Open example.com in the browser, tell me what's on the page, and screenshot it.
經過上面的步驟，智能體預期會完成這幾件事：
1、打開目標頁面。
2、讀取頁面內容。
3、執行截圖。
4、把結果返回給用戶。
如果需要在不改變默認安裝方式的情況下臨時啓用，也可以用 overlay 命令：
dsh web --patch ./kimi-webbridge.overlay.yml
適用場景與注意¶
適合的場景：
- 需要操作用戶當前已登錄的瀏覽器。
- 需要讀取真實頁面、截圖、保存 PDF。
- 需要在本機完成網頁自動化，而不是把頁面流量交給第三方服務。
- 需要把瀏覽器操作納入 dsh 智能體的工具鏈。
需要注意的限制：
1、fill / click 可能會被嚴格檢查 event.isTrusted 的站點忽略，例如部分銀行門戶或驗證碼頁面。這類頁面可能需要人工介入。
2、跨域 iframe 不在當前範圍內；相關工具主要操作頂層 frame。
3、會話是按 profile 維度管理，而不是按 agent 維度隔離；subagents 會共享同一組 tab。
4、Windows 已測試；macOS / Linux 由代碼路徑支持，但尚未驗證。
5、所有配置鍵都是可選的。
6、插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
另有一個 dsh harness 側的已知問題：在罕見的 transient pnpm failure 情況下，dsh-kimi-webbridge 可能殘留在 dsh.profile.bundles 中，導致 profile 啓動失敗。恢復方式是編輯對應 profile 的 package.json，移除相關條目後再啓動。
鏈接¶
GitHub 倉庫：
https://github.com/MicroHEROX/dsh-Kimi-WebBridge
社區目錄：本文所依據的事實未提供具體目錄頁 URL，因此不補充未經覈實的鏈接。
