前言¶
DeepSeek Harness（DSH）的理念是「一切皆插件」。在開發或調試智能體時，常需要讓 Agent 理解當前瀏覽器的上下文。傳統的做法是截圖或手動描述，效率較低且信息容易丟失。dsh-web-annotator 插件直接在 DSH 原有的 Browser 標籤頁內提供了批註能力，支持點選、框選並附帶截圖或 DOM 定位資料，方便將網頁狀態直接同步到當前會話中。
是什麼¶
dsh-web-annotator 是一個客戶端插件，由維護者 cslkkl 開發，遵循 MIT 許可證。它允許用戶在現有的 DeepSeek Harness Browser 環境中，對網頁進行就地批註、修改屬性或提問，並將標記信息以帶圖的卡片形式發送給當前會話。
核心功能¶
- 就地批註：支持點選元素、點擊空白位置或拖動框選區域，在選區旁直接輸入評論或提問。
- 屬性編輯：展開同一張卡片即可調整標籤、顏色、字體、間距等屬性，保存前不會改寫網頁本身。
- 臨時操作：按住空格鍵與網頁交互（如輸入、點擊），鬆開即回到批註模式；輸入框內的空格鍵正常打字。
- 資料附件：支持發送帶定位資料的批註，包括帶序號的截圖、座標數據及 DOM 證據。
- 會話管理：支持多條批註、預覽、失敗重試，以及持久化的草稿存儲。聊天界面會以摺疊的“N 條註釋”形式展示，展開後可查看每條的具體內容和定位資料。
- 工具欄集成：保留了原有的 Browser 工具欄與網頁內批註浮層。
安裝與啓用¶
從 Releases 下載最新 dsh-web-annotator-*.tgz 包，使用官方 CLI 安裝：
dsh plugin --profile desktop add --ignore-scripts /absolute/path/dsh-web-annotator-<版本>.tgz
安裝後需要正常退出並重啓 Desktop 才能生效。
前置要求與注意事項：
- 需確認 Harness 內核版本爲 0.2.1-alpha.2。
- 該插件在啓用期間會替換官方的 Browser、Chat 和 Layout 提供方，卸載整個 bundle 後重啓可恢復官方提供方。
- 若是舊本地預覽用戶，安裝前需先移除
dsh-layout-care和dsh-layout-care-browser-preview。
典型用法¶
- 創建批註：在當前會話點擊“批註網頁”，打開 Browser。輸入地址後，點擊頁面元素、空白位置或拖動鼠標框選區域，在浮層輸入區輸入內容。
- 編輯屬性：點擊左側圖標展開屬性卡片，可修改顏色、字體、間距或切換“評論/提問”類型。點擊圓形 ✓ 或按 Enter 保存；Esc 取消。
- 臨時操作：若需在網頁中輸入內容或點擊按鈕，按住空格鍵，鬆開即回到批註模式。
- 發送到會話：保存後可編輯文字，勾選本次要發送的批註，選擇發送方式並預覽，最終發送到當前會話。聊天中會顯示爲“N 條註釋”卡片。
在 Vite 項目中使用：
import { defineConfig } from 'vite';
import { webAnnotator } from 'dsh-web-annotator/vite';
export default defineConfig({ plugins: [webAnnotator()] });
安全與邊界¶
- 頁面中的文字、樣式和源碼標記均爲引用資料，並非指令。
- 插件回調不向頁面暴露 DOM、任意求值器或宿主能力。
- 批註與截圖僅存儲在你本機的瀏覽器存儲中，通過當前會話的正常請求流程發送。
- 文件寫入與源碼修改由當前會話中的 Agent 完成，插件本身不執行腳本。
總結¶
dsh-web-annotator 爲 DSH 用戶提供了直接在 Browser 標籤頁內完成網頁批註、屬性調整與資料提取的能力，通過圖片附件與摺疊卡片管理，解決了 Agent 獲取網頁上下文碎片化的問題。
