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 许可证。