前言¶

DSH 的插件生態裏，瀏覽器調試類能力可以放在插件中擴展。瀏覽器 UI 問題如果只用文字描述，通常缺少具體元素上下文。dsh-annotate 讓使用者在 Chrome 或 Chromium 中直接選擇元素，把 selectors、DOM facts、computed-style highlights、accessibility data、comments 和可選 viewport screenshots 一起交給 Agent。

這是什麼¶

dsh-annotate 是 BrambleXu 維護的 DeepSeek Harness 插件，定位爲：

Browser element annotation bridge for DeepSeek Harness

它通過 local loopback WebSocket bridge，把瀏覽器中的元素標註結果發送到 Agent。

已覈實信息：

• 許可證：MIT
• Node.js：^22.19 或 >=24
• 0.1 目標：一個本地 Chrome/Chromium 瀏覽器、一個活動標籤頁、可見視口截圖

核心功能¶

下面介紹已覈實的能力。

• 通過 /annotate 在 Chrome 或 Chromium 中直接選擇元素。
• 捕獲 selectors、DOM facts、computed-style highlights、accessibility data、comments，以及可選 viewport screenshots。
• 通過 local loopback WebSocket bridge 將 structured annotations 發送給 Agent。
• 對瀏覽器連接做限制：loopback host、extension origin、optional extension ID。

連接限制的具體規則：

• 服務器拒絕非 loopback host。
• 服務器拒絕 origin 不是 chrome-extension:// 的瀏覽器連接。
• allowedExtensionId 爲空時，接受任意本地已安裝 Chrome 擴展。
• 如需更嚴格隔離，應配置精確的擴展 ID。

安裝與啓用¶

資料給出的本地安裝命令如下：

dsh plugin --profile demo add ./dsh-annotate

這是資料中的本地路徑示例；遠程安裝命令未確認。

安裝前應檢查插件源碼與 MIT 許可證。dsh-annotate 會以當前 dsh 進程權限運行，因此不建議直接安裝來源不明的修改版。

典型用法¶

可以從 DSH 側發出標註命令：

/annotate
/annotate http://localhost:3000

接着按頁面操作：

1、點擊一個元素。
2、輸入該元素的 comment。
3、如需要，重複選擇其他元素。
4、Submit 後，所有已捕獲事實與可見標籤頁截圖會發送到 Agent。
5、Escape 取消當前標註。

適用場景與邊界¶

適合需要把本地瀏覽器元素上下文交給 DeepSeek Harness Agent 的調試、檢查或開發場景，尤其是元素定位、樣式觀察、accessibility 信息整理這類工作。

需要注意以下邊界：

• 0.1 面向本地 Chrome/Chromium 瀏覽器、一個活動標籤頁和可見視口截圖。
• 遠程瀏覽器、full-page capture、edit recording、inline draggable note cards 被明確 defer。
• allowedExtensionId 爲空會接受任意本地已安裝 Chrome 擴展，建議按需配置精確 ID。
• 插件以當前 dsh 進程權限運行，使用前應確認源碼與許可證。

鏈接¶

GitHub 倉庫：

https://github.com/BrambleXu/dsh-annotate

目錄頁線索，未確認：

https://www.skillhub.cn/plugins/BrambleXu/dsh-annotate