paicat1/dsh-screenshot

dsh-screenshot

独立截图插件，为 DeepSeek Harness（dsh）提供屏幕捕获能力。不是 modlens 的替代品——它是从 @liustack/modlens 的 dsh 插件中拆分出来的独立包（该功能上游未采纳，见 liustack/modlens#48），目的是让截图功能不随 modlens 更新而被覆盖。

致谢

本插件的截图能力最初是作为 @liustack/modlens（作者 Leon Liu）的 dsh 插件增强实现的。衷心感谢原作者为 DSH 提供了识图能力——modlens 让纯文本模型（DeepSeek/GLM）能够"看见"图片，本插件的 modlens_screenshot 工具正是复用 modlens 的识图管线，把"截屏 + 识图"合成一步。截图功能本身从 modlens 中拆分出来独立维护，但识图能力始终归功于 modlens 项目。

能力

• 浏览器热键（在 dsh 网页中）：
  • Ctrl+Alt+S — 区域截图（弹出选择框，鼠标左键在桌面空白处按下开始，拖拽选框，Esc 取消）
  • Ctrl+Shift+Alt+S — 全屏截图（无交互，直接捕获整个虚拟桌面）
• Agent 工具：modlens_screenshot — AI 可自主截屏并识图（若本机装有 modlens CLI）
• 截图 PNG 保存到 %USERPROFILE%\Downloads\modlens-screenshots\，路径自动插入输入框
• 激活截图后桌面保持 live，可拖动窗口排版，点桌面空白处触发——不依赖 dsh 页面

与 modlens 的关系

层面	依赖 modlens？	说明
截图动作	否	纯 PowerShell CopyFromScreen，零依赖
浏览器热键 / 路径插入	否	独立路由 /dsh-screenshot/screenshot
modlens_screenshot 工具读图	是（可选）	若找不到 modlens CLI，工具不注册，截图照常工作
配合多模态模型	否	截图路径插入后，多模态模型（如 go-mimo）可直接看图，无需 modlens

安装（装配到 dsh profile）

在 dsh profile（如 %USERPROFILE%\.dsh\profiles\web）中：

1. 把本包加入 package.json 的 dependencies（或 pnpm workspace）
2. 在 package.json 的 dsh.profile.bundles 中加入本包名
3. 重启 dsh 服务并刷新页面

配置

可在 cordis 配置中传参（可选，默认全部开启）：

• route: false — 关闭浏览器截图路由
• tool: false — 关闭 modlens_screenshot 工具

环境变量 MODLENS_DSH_CLI 可显式指定 modlens CLI 路径（默认探测 ~/.dsh/profiles/{web,headless}/node_modules/@liustack/modlens/dist/main.js）。

背景

原 modlens 的 dsh 插件集成了截图能力（本仓库 fork 的 feat/dsh-screenshot 分支）， 作者在 issue #48 中标记为 not planned。 为解耦 modlens 更新对截图功能的影响，将其拆分为本独立插件。