前言¶
在 DeepSeek Harness（DSH）里向模型说明界面问题、报错弹窗或设计稿时，往往需要把屏幕某一块放进对话。常见做法是系统截图工具截全屏再裁切，或先存文件再拖进输入框，步骤多且容易打断思路。下面介绍社区插件 dsh-scissors（维护者 Lion2c，GitHub：Lion2c/dsh-scissors）：在 composer 输入框旁增加剪刀按钮，框选区域后 PNG 以与普通粘贴图片相同的方式出现在草稿附件里。
这是什么¶
dsh-scissors 是 DSH 生态下的 dsh-plugin，分类为工作流。它在输入框 + 按钮右侧注入一个与 DSH 16×16 线性图标风格一致的剪刀按钮；点击后在本机完成区域截图，结果写入当前会话的草稿图片附件，不经过第三方上传或缓存。
插件 Host 侧为 Node 模块（index.js），浏览器侧为客户端注入（client.js），通过 cordis.patch.yml 安装时打入 bundle。package.json 声明 DSH 引擎范围：>=0.2.2-rc.1 <0.3.0-0，许可证 MIT，当前 npm 版本 0.1.0。
核心功能¶
剪刀按钮点开锚定菜单，提供两种模式：
- 截图：主窗口保持可见，直接框选屏幕区域。
- 截图（隐藏主窗口）：先隐藏 DSH 主窗口，截完后自动恢复并聚焦；取消、失败或超时也会恢复窗口。
截图以标准草稿图片附件出现在输入框上方，行为与粘贴图片一致：可预览、可删除、可随消息发送。菜单支持鼠标与键盘（↑ / ↓ / Home / End、Enter、Esc）；界面中英文跟随 DSH 语言设置。
平台与依赖¶
| 平台 | 区域选择 | 隐藏主窗口 | 依赖要点 |
|---|---|---|---|
| Windows | 内置 WinForms 选择器 | 支持 | 发布包附带 scissors.exe；Windows 10/11 已做完整真机验证 |
| macOS | screencapture -i |
System Events | 需屏幕录制权限；隐藏窗口需自动化权限 |
| Linux | 自动选择可用后端 | X11 下 xdotool |
grim+slurp、gnome-screenshot、spectacle、scrot 或 maim 等其一 |
README 注明：macOS 与 Linux 按系统工具实现，发布前未在真机上做完整验证；Wayland 下隐藏任意窗口通常不可用，插件会回退为普通截图或提示不支持。
隐私与本地处理¶
截图经当前 DSH Web 服务传输，不经第三方服务器。服务端路由在 /.dsh-scissors，只接受同源请求，并要求请求头 x-dsh-scissors: capture。插件不记录截图内容、不做遥测（服务端出错时仅写 DSH 错误日志）。隐藏窗口由用户每次在菜单中显式选择。
安装与启用¶
从插件市场或 npm 安装时，将 desktop 换成你实际使用的 profile（Web 版常见为 web）：
dsh plugin --profile desktop add dsh-scissors
安装后需重启 DSH：桌面版重新打开应用，命令行版重新启动 dsh web。成功后，输入框 + 右侧应出现剪刀按钮。
卸载：
dsh plugin --profile desktop remove dsh-scissors
本地开发可将目录以 link: 形式链入 profile（README 示例）；生产环境以市场/npm 安装为准。
典型用法¶
- 点击剪刀按钮。
- 在菜单中选择「截图」或「截图（隐藏主窗口）」。
- 按住鼠标左键拖出矩形，松开即完成；
Esc取消（Windows 选择器亦支持右键取消）。 - 确认输入框上方出现图片附件后，按平时方式发送消息。
菜单打开时可用 ↑ / ↓ 选择、Enter 确认、Esc 关闭并把焦点还给按钮。
按钮不出现 时，可执行 dsh plugin --profile web why dsh-scissors 确认是否装入当前 profile，并重启或刷新窗口。截图成功但无附件 时，可能是输入框正忙（发送/上传中），可先清空再截。重装后仍像旧版时，需完全退出再启动 dsh web（客户端模块会被缓存）。
适用场景与注意¶
适合需要在 DSH 对话里快速附上局部屏幕的开发者：排障截图、UI 对照、临时标注区域等。与全屏截图再裁剪相比，操作集中在 composer 内完成。
插件以当前 DSH 进程权限调用系统截图与（可选）窗口隐藏能力；Linux 需自行安装对应后端工具，macOS 需在系统隐私设置中授权。安装前可在 GitHub 仓库 查看源码（含 Windows 选择器 native/win/selector.cs）与 MIT 许可证。社区插件目录站 skillhub.cn 与 DeepSeek / 幻方无官方从属关系，安装决策以你本机环境与审计结果为准。
结尾¶
dsh-scissors 把区域截图收成输入框旁的一步操作，并与 DSH 草稿附件模型对齐。进一步了解实现与故障排查见仓库 README；目录条目见 SkillHub 插件页，源码与 issue 见 https://github.com/Lion2c/dsh-scissors。
