前言¶
在 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
