DeepSeek Harness 截圖插件：將截圖轉爲 Obsidian 筆記

DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。在構建智能體或處理日常工作流時，截圖和剪貼板圖片往往分散在不同軟件中，需要手動歸檔。這個插件通過監聽剪貼板，在鼠標旁彈出系統級懸浮窗，支持即時 OCR 和晚間 AI 整理，將截圖直接轉化爲 Obsidian 筆記條目。

核心功能¶

Windows 系統級懸浮窗：檢測到新截圖（或複製圖片）後，在鼠標旁彈出置頂小窗。
註釋與重點標記：彈窗內置註釋輸入框和「重點」複選框。勾選「重點」後，該條註釋會以 # **重點** 標題寫入筆記。
存文檔 / 存圖片：支持將截圖存入 Obsidian 庫，並生成當天合併筆記；或僅存圖片（帶 #圖片 標籤）。
即時 OCR：默認使用宿主大模型進行識別（零配置），宿主不可用時自動回落通義千問 API。
助手自愈：常駐的剪貼板助手指令意外退出時，會按退避策略（2s→30s，最多 5 次）自動重啓並告警。
同一屏去重：Windows 截圖工具偶爾會將同一屏寫入剪貼板兩次，插件通過灰度指紋比對，在指定窗口期內（默認 6 秒）只彈一次窗。
晚間 AI 整理：對當天收件箱條目，通過指令觸發 AI 整理，包括歸類、生成分類筆記、雙鏈、當日總結和歸檔。
Web 圖形配置界面：DSH 設置 → 「截圖入庫」，改動實時生效。

安裝與啓用¶

該插件以 DSH 插件形式發佈，安裝命令如下：

dsh plugin --profile desktop add github:wangzhanchao883/dsh-screenshot-capture

重啓 DSH 後生效。剪貼板監聽與懸浮窗由插件 host 端自動拉起（需要 DSH 運行中）。

配置¶

首次使用需在 Web 界面配置 Obsidian 庫路徑，否則採集功能會自動停用。

方式一：Web 圖形界面（推薦）¶

DSH Web 界面 → 側欄設置 → 截圖入庫 分區，直接配置：
- 通用：啓用監聽、Obsidian 庫路徑、輪詢間隔、冷卻時間。
- OCR：識別通道（host 宿主大模型，默認；或 off 關閉）、宿主模型（留空則跟隨 DSH 當前默認模型）。
- 懸浮窗：橫向/縱向偏移、預覽最大寬度。

注意：面板裏不再有千問配置項。千問 Key 從環境變量 DASHSCOPE_API_KEY 或配置文件讀取，僅在宿主模型不可用時作爲回落通道。

方式二：配置文件¶

配置文件位置：%USERPROFILE%\.dsh-screenshot-capture\config.json

{
  "enabled": true,
  "vaultPath": "D:\\path\\to\\obsidian-vault",
  "ocr": { "mode": "host", "hostModel": "" },
  "pollIntervalMs": 200,
  "cooldownMs": 2000,
  "dupWindowMs": 6000
}

使用步驟¶

保持 DSH 運行。
使用 Win+Shift+S 框選截圖（或 Ctrl+C 複製任意圖片）。
懸浮窗出現在鼠標旁：在註釋框內輸入內容（可選），需要時勾選「重點」，然後選擇操作【複製截圖 / 存文檔 / 存圖片】。
晚間對 DSH 說「整理今天的截圖」，按提示選擇保留條目。

環境與注意事項¶

依賴環境：依賴 Windows PowerShell 5.1 + WinForms。
DSH 版本：需要 DSH 0.1.7+。
OCR 條件：使用宿主大模型 OCR 時，需要 DSH 加載 llm 和 attachments 服務，且當前模型聲明瞭 inputModalities: [ text, image ]。
採集停用：未配置 vaultPath 時，採集功能會自動停用並告警，不會創建任何目錄。
數據安全：剪貼板圖片僅本地處理，識別時才發送給識別通道。插件不含任何內置密鑰。

總結¶

該插件爲 DSH 用戶提供了從截圖到結構化筆記的完整閉環工作流，利用宿主模型實現零配置 OCR，並支持晚間批量整理。源碼與文檔託管在 GitHub，遵循 MIT 許可證。