前言¶
在 DeepSeek Harness（DSH）裏用右側欄內置瀏覽器對照網頁改需求時，常見做法是截圖、口述位置，或自己複製 DOM 信息貼進輸入框。信息容易散，截圖和文字也常對不齊。dsh-web-pick 面向 DSH Desktop 的內置瀏覽器：在頁面裏點選元素或框選區域，配上簡短說明，再一次性寫入對話輸入框（文字 + 截圖附件），由你檢查後再按回車發送，不向被訪問站點注入業務代碼。
這是什麼¶
dsh-web-pick 是社區插件（維護者 Chenghui-Liang，分類：聯網工具），當前 GitHub 星標爲 0。它解決的是「在 Harness 內置瀏覽器裏把網頁上的具體位置結構化地送進當前對話草稿」——裝完即用，不修改你所瀏覽項目的源碼。
插件只適用於桌面版：內置瀏覽器由 Electron <webview> 承載，插件 Client 半與 <webview> 同處一個文檔，才能注入選取層；Web 版瀏覽器爲 iframe，插件無法觸及頁面 DOM，因此不生效。
核心功能¶
下面能力均來自插件 README 與倉庫說明。
- 元素點選：進入選取模式後，鼠標懸停高亮目標，並顯示標籤名、尺寸、顏色、字號等信息；單擊元素可保存並可選填說明。
- 區域框選：按住拖動框選矩形區域，鬆手後同樣可保存與備註；選區虛線框留在頁面上便於對照。
- 批量管理：頁面右下角「選取」膠囊旁數字爲已存條數；可打開列表做定位、編輯說明、刪除或清空。
- 寫入輸入框：點「放入輸入框」將批次格式化爲一段文字（
insertText，不覆蓋已有輸入），截圖經輸入框原生文件 intake 進入附件欄；不會自動發送。 - 按頁隔離存儲：使用
sessionStorage，key 爲 origin + pathname；刷新同頁仍保留，換頁各存各的。
單批最多附帶 6 張截圖，超出部分僅保留文字。Esc 可退出選取模式或關閉卡片。
安裝與啓用¶
使用 DSH Desktop 配置下的官方安裝命令：
dsh plugin --profile desktop add github:Chenghui-Liang/dsh-web-pick
安裝後需完整退出並重啓一次 DSH（Client 半在 host 啓動時組裝）。隨後在右側欄打開內置瀏覽器，訪問任意頁面即可使用。倉庫 package.json 標明當前版本爲 1.3.1，許可證爲 MIT。
安裝前建議自行閱讀 GitHub 倉庫 源碼與許可證；插件以當前 DSH 進程權限運行，並向 <webview> 內頁面注入腳本層。
典型用法¶
- 打開內置瀏覽器並加載目標頁面。
- 點擊頁面右下角 「選取」 進入選取模式。
- 單擊元素或拖動框選區域，在彈出卡片中補充說明（也可直接保存）。
- 重複直至條目足夠；需要時用膠囊旁列表編輯或刪除。
- 點 「放入輸入框」，在對話輸入框中核對文字與截圖附件，確認後自行回車發送。
寫入輸入框的文字形態大致如下（示例結構來自 README）：
【網頁選取】2 條 · GitHub - Chenghui-Liang
頁面：https://github.com/Chenghui-Liang
截圖：2 張（已附在下面）
1. 元素 div `#id` · 字號大一點
源碼：src/pages/Budget.tsx:42
2. 區域 320×180 · 這塊留白太大
實現要點（便於判斷是否適合自己）¶
Host 半提供 overlay 腳本路由與上報接口；Client 半掃描 <webview>、注入 web/overlay.js（Shadow DOM 隔離的 IIFE），約每 700ms 同步選取結果，並用 webview.capturePage() 爲每條裁剪截圖。寫草稿走 slot 自帶的 inputActions，不調用 session.prompt，因此消息不會直接發出。無需反向代理、CDP 或向站點加 <script>，任意 URL 均可作爲瀏覽對象。
適用場景與已知限制¶
適合：在 DSH Desktop 裏邊看本地或遠程預覽頁，邊把 UI 問題、區域留白、元素樣式等標進同一條對話，交給智能體或同事改代碼/改稿。
限制（README 已列）：
- 無法標註跨域 iframe 內元素。
- 關閉或切走內置瀏覽器面板後選取層暫停，返回會重新注入。
- SPA 路由切換後，舊條目「定位」可能失效。
- 輸入框正在發送等導致無法插入時會報錯，條目仍留在列表可重試。
- 修改
client.js需刷新 DSH 窗口；修改web/overlay.js僅需重新加載被瀏覽頁面。
結尾¶
dsh-web-pick 把內置瀏覽器裏的點選、框選與說明收成一批結構化草稿，減少截圖與描述脫節。社區目錄頁：SkillHub - dsh-web-pick；源碼與詳細說明：GitHub - Chenghui-Liang/dsh-web-pick。DSH 插件生態由社區目錄與各自倉庫維護，與 DeepSeek / 幻方無官方從屬關係。
