前言¶
在 DSH 裏讓 Agent 改界面或交互時，常見做法是貼幾張截圖再加幾句說明。批註散落在聊天裏時，執行範圍容易含糊：哪些框要改、期望是什麼、怎樣算驗收通過，往往要來回澄清。DeepSeek Harness 社區插件 dsh-screenshot-board（維護者 007350，分類：工作流）提供一塊「截圖任務板」：在截圖上框選、寫任務與討論，再按範圍導出 ZIP，交給新的 Agent 按清單執行與回交。插件不調度 Agent、不自動改項目或 Git，只整理材料與本地持久化。
這是什麼¶
dsh-screenshot-board 當前版本爲 0.2.0（MIT）。簡介爲：Screenshot annotation board for DeepSeek Harness: mark regions, write tasks, hand off to an agent. 數據保存在 DSH 數據目錄下的 resolveDshHome()/dsh-screenshot-board/，不讀寫關聯項目目錄；圖片僅保存在本地 Host，無第三方上傳或 AI 調用。
核心功能¶
任務板與批註¶
- 多任務板、框選/重畫/排序、狀態與討論歷史、修改後截圖對比、明暗主題。
- 圖片支持上傳、拖入、粘貼；完整備份及保存衝突保護。
0.2.0 本輪改進（README 已列）¶
- 可複用的項目背景：用途、啓動方式、訪問地址、頁面入口、操作條件、文件線索、允許修改範圍及未知信息；全部可選。插件只記錄用戶輸入，不運行命令或自動讀取項目。
- 交接範圍預覽：逐任務選擇本次執行、待澄清、僅供參考或不包含。資料齊全且用戶確認的待處理、處理中、需修改任務默認執行；待驗收、已通過默認參考；草稿及信息不足的任務先澄清。
- 交互故障證據：按需填寫復現步驟、實際結果、預期結果、環境條件。交互任務缺少前三項時不能加入執行清單。
- 輕量需求引導：保留原始批註，提供位置、現狀、期望和驗收條件示例；不擅自補尺寸、顏色或行爲。修改期望、驗收或復現後需重新確認；待澄清問題未解決時不能執行。
- 收起與恢復：DSH 中「收起到聊天」隱藏工作臺，保留實例、所選任務、截圖、視圖、縮放、篩選、對話框草稿及未提交討論。關閉工作臺會結束實例，與收起分開。
導出與備份¶
導出 ZIP 時 Host 校驗保存修訂號及任務選擇；執行範圍以 handoff.json 爲準，未選任務不執行。
| 產物 | 作用 |
|---|---|
tasks.md |
項目背景、執行清單、待澄清與參考章節、回交要求 |
handoff.json |
板 ID、修訂號、更新時間、UTC 導出時間，以及執行/澄清/參考/未選任務 ID |
board.json |
完整背景快照與圖片索引 |
images/ |
原圖、編號圖和已有修改後截圖；「截圖號.批註號」對應圖片編號 |
「備份 JSON」始終保留完整板與圖片，恢復爲獨立副本；ZIP 不用於恢復。
在 DSH 中的入口¶
包通過 dsh.bundle.patch 指向 cordis.patch.yml，掛載項 id/name 均爲 dsh-screenshot-board。Host 爲 lib/index.js；運行包無需現場構建。用戶自行安裝後，可從設置頁「截圖任務板」或懸浮入口打開。
安裝與啓用¶
README 寫明：本輪只產出包，不運行安裝命令。資料中未給出統一的 dsh plugin add … 一類官方安裝語句，正文不憑倉庫名拼接命令。安裝方式以 SkillHub 目錄頁 與 GitHub 倉庫 當前說明爲準。
啓用後從 DSH 設置頁「截圖任務板」或懸浮入口打開工作臺。package.json 中 engines 要求 Node >=22.19.0，DSH >=0.2.0-rc.1 <0.3.0；0.2.0 已在 DSH 0.2.x 桌面版 desktop profile 上做過插件入口、工作臺與交接流程等驗證（範圍限於 Windows 與單一 profile，見倉庫 docs/VALIDATION.md）。
典型用法：推薦流程¶
下面步驟來自 README「推薦流程」，可按順序操作。
- 新建或打開任務板，在「項目背景」填寫已知信息。項目路徑可選，通常填真實、完整的項目根目錄；僅寫進交接材料，不檢查目錄。填錯不影響批註，但可能使 Agent 找錯項目。
- 添加截圖並框選，保留原始批註，補充期望修改及可判斷的驗收條件。交互故障再填操作過程與結果。
- 內容仍有歧義時保留草稿或填寫待澄清問題；清楚後勾選「需求已由我確認」。此確認與最終「驗收通過」是不同階段。
- 在「交接與導出」逐項檢查範圍和說明。待驗收默認交給用戶驗證；如需 Agent 再改，可在資料齊全時顯式選擇執行。
- 將 ZIP 交給新的 Agent，並明確實際項目權限。執行者先看
tasks.md，不把背景快照裏的歷史當成追加任務。 - Agent 按編號交回修改文件、驗證結果、修改後截圖和遺留問題；用戶操作驗證並逐項人工驗收。交互問題不能僅憑截圖證明修復。
舊板讀取時會補充可選字段，不刪任務、批註或歷史。
數據限制與保存注意¶
- 單圖最多 8 MiB、16000px 單邊、6400 萬像素；每板最多 12 張原圖、300 個任務，原圖與修改後圖總量最多 48 MiB。
- 未保存內容僅留當前頁面；收起保留頁面，重載、關閉或應用退出不等同收起。保存失敗先備份，再顯式重新載入，不要在沒有備份時退出。
- Host 寫操作另校驗插件會話令牌；本插件不自動判斷驗收通過。
獨立預覽與開發（可選）¶
不在 DSH 內調試 UI 時，可在源碼目錄運行本地預覽（僅監聽本機，數據在 .preview-data/，不加載 DSH）：
node scripts/preview.mjs
瀏覽器打開 http://127.0.0.1:4387/。測試與構建命令見 README，例如：
node --test tests/*.test.mjs
node scripts/build.mjs --esbuild-root D:/NodeGlobal/node_modules/vercel
node scripts/check-package.mjs
npm pack --pack-destination dist
構建需要 esbuild 0.27.0，也可 npm run build。完整驗證記錄見 docs/VALIDATION.md。
適用場景與注意¶
適合：需要把 UI/交互問題拆成編號任務、明確驗收條件，再打包交給 Agent 改代碼並人工驗收的團隊或個人。
注意：
- 插件以當前 DSH 進程權限運行；安裝前應自行查看源碼與 MIT 許可證。
- SkillHub（https://www.skillhub.cn）爲社區插件目錄，與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」。
- 不要期望插件代你跑命令或合併 Git；交接後權限與驗收仍由用戶把控。
結尾¶
dsh-screenshot-board 把截圖批註收斂成可執行、可澄清、可驗收的任務清單，並通過 ZIP 與 tasks.md 規範 Agent 交接。進一步瞭解或獲取包：
- 目錄頁：https://www.skillhub.cn/plugins/007350/dsh-screenshot-board
- GitHub：https://github.com/007350/dsh-screenshot-board
