前言¶
在 DSH 桌面版里和模型对话时,经常要把界面片段、报错或窗口内容塞进附件。切到系统截图工具再回来粘贴,窗口来回切,草稿框还要自己找粘贴入口。系统剪贴板能兜底,但多一步操作。下面介绍社区插件 dsh-desktop-shot:在输入框旁加截图按钮,点一下宿主窗口收起、框选区域,裁剪图尽量自动进草稿框(仅 Windows)。
这是什么¶
dsh-desktop-shot 由维护者 jianuoli664 发布,归类为客户端插件。它集成在 DSH 桌面版输入区:一键收起窗口、矩形框选、把图投递到 composer 草稿附件。当前版本 0.4.4,许可证 MIT。源码与说明见 GitHub,社区目录页见 SkillHub。
核心功能¶
依据仓库 README,已核实能力如下:
- 输入框右侧截图按钮;点击后 DSH 窗口收起。
- 全屏拖矩形框选;Esc 或右键取消;默认 300 秒超时自动取消。
- 裁剪图自动进入草稿框;若未投递成功,图仍在剪贴板,可用
Ctrl+V粘贴。 - 插件通过 Cordis patch 注入客户端逻辑;改
lib/client.js时宿主按 mtime/size 轮询热替换,改lib/index.mjs需重启进程。
安装与启用¶
安装分四步:把仓库放到插件目录、用 CLI 登记依赖、核对 profile 装载清单、重启桌面应用。
1. 放置插件目录
没有 git 时可下载 main 分支 ZIP 解压到目标路径;有 git 时可用 README 中的克隆命令放到 %USERPROFILE%\.dsh\plugins\dsh-desktop-shot:
git clone https://github.com/jianuoli664/dsh-desktop-shot.git "$env:USERPROFILE\.dsh\plugins\dsh-desktop-shot"
2. 在 profile 里登记插件
将 --profile 换成实际使用的 profile(一般为 desktop),<DSH 安装目录>、<你> 换成本机路径:
& "<DSH 安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "file:C:/Users/<你>/.dsh/plugins/dsh-desktop-shot"
3. 确认 bundles 清单
打开 %USERPROFILE%\.dsh\profiles\<profile>\package.json,确认 dsh.profile.bundles 中包含 "dsh-desktop-shot"。README 说明:pnpm add 只写 dependencies,装载清单需自行补上该项。
4. 重启 DSH 桌面应用
重启后输入框右侧应出现截图按钮。
典型用法¶
- 点输入框右侧截图按钮,窗口收起。
- 拖一个矩形框;需要放弃时用 Esc 或右键。
- 等待裁剪图进入草稿框;若未出现,用
Ctrl+V从剪贴板粘贴。
卸载可用 CLI:
& "<DSH 安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop remove dsh-desktop-shot
或从 profile 的 package.json 中同时删除 dependencies 与 dsh.profile.bundles 里的 dsh-desktop-shot,再重启应用。
适用场景与注意¶
适合谁:仅在 Windows 上使用 DSH 桌面版、希望对话里快速附图、能接受框选交互的开发者。
平台与实现:仅 Windows(Win32 + PowerShell + WinForms)。自动投递依赖 composer 的隐藏 input[type=file];若上游改掉该控件,只能退回剪贴板粘贴。
回合状态:回合处于 adjudicating 或 submitting 时核心会拒收附件,长回合重试也无法写入;截图宜在可编辑草稿时进行。
安全与许可:插件随当前 DSH 进程权限运行,安装前建议阅读源码与 MIT 许可。技术背景与踩坑记录在仓库 docs/notes.md。
DSH 生态强调「一切皆插件」;SkillHub 等为社区目录,与 DeepSeek / 幻方无官方从属关系,本文仅作插件用法说明。
结尾¶
dsh-desktop-shot 把「收起窗口 → 框选 → 进草稿」收成输入框旁一步。Windows 桌面用户若常附图对话,可按 README 安装并核对 dsh.profile.bundles。目录页:SkillHub;源码:GitHub。