WongYuYe/dsh-appshots

dsh-appshots

Awesome DSH Plugin

简体中文 | English

给 DSH Desktop 用的窗口截图，支持 macOS 和 Windows。

macOS 同时按两边 Command，Windows 同时按两边 Ctrl，或点输入框旁的相机，捕获当前前台窗口，附加到会话草稿，并读取窗口文字作为隐藏上下文。

- 只捕获最前面的窗口，不截整个屏幕
- 截图附加到输入框草稿，不会自动发送
- 读取可用的窗口文字（macOS 辅助功能 / Windows UI Automation），作为隐藏的模型上下文注入
- 跳过 DSH Desktop 自身，避免截到插件自己的窗口
- 截图后自动把 DSH Desktop 调到前台

安装

dsh plugin --profile desktop add dsh-appshots

安装后重启 DSH Desktop。

从源码安装：

git clone https://github.com/WongYuYe/dsh-appshots.git
cd dsh-appshots
dsh plugin --profile desktop add .

Windows 会在第一次截图时用系统自带的 csc.exe（.NET Framework 4.x）编译助手，不需要安装 Visual Studio。

发布：把 package.json 版本改成 X.Y.Z 后推 vX.Y.Z tag。GitHub Actions 会打 GitHub Release 并用 Trusted Publisher（OIDC）发到 npm。

权限

macOS

系统设置 → 隐私与安全性：

- 屏幕录制：捕获最前面窗口所必需
- 辅助功能：监听两个 Command 键、读取窗口文字所必需

把这两项授予 DSH Desktop。如果热键不触发，同时允许 appshot-capture。

Windows

- 截图走 CopyFromScreen，系统可能弹一次屏幕访问授权
- 窗口文字走 UI Automation，部分提权或受保护的应用几乎读不到文字
- 默认热键是同时按两边 Ctrl。如果不触发，可改成 hotkeyMode: win-hotkey

使用

1. 聚焦你想分享的窗口。
2. macOS 同时按两个 Command，Windows 同时按两边 Ctrl，或点击输入框里的相机按钮。
3. DSH Desktop 来到前台，截图已附加。
4. 输入提示词并发送。

如果当前有打开的会话，Appshot 会附加到那里；如果没有，会新建一个会话。连续截图会进入同一个会话。

设置

命名空间 dsh-appshots，位于 ~/.dsh/settings.yaml：

| 字段 | 默认值 | 含义 |
|---|---|---|
| skipSelf | true | 跳过 DSH Desktop 自身 |
| attachText | true | 发送时把辅助功能树作为隐藏模型上下文注入 |
| recentWindowMs | 60000 | 没有打开会话时，复用这个时间窗口内截图过的会话 |
| hotkeyMode | auto | auto / both-command / both-control / carbon / win-hotkey / off |
| carbonKeyCode | 0 | hotkeyMode 为 carbon 时的 Carbon 键码 |
| carbonModifiers | 256 | Carbon 修饰键；256 是 Command |
| winVk | 44 | hotkeyMode 为 win-hotkey 时的虚拟键码（44 是 PrintScreen） |
| winModifiers | 3 | win-hotkey 的 Win32 修饰键；3 是 Ctrl+Alt |

auto 在 macOS 上是两边 Command，在 Windows 上是两边 Ctrl。

限制

- 仅支持 macOS 和 Windows
- 窗口文字来自系统辅助功能树，部分应用只暴露可见文本
- 隐藏文本按 VoiceOver / UI Automation 树输出（角色、缩进、Description / Value / URL），不再做成扁平行
- 点击已附加的 Appshot 预览时，右上角可「查看文本」，展示当前窗口读到的辅助功能文字
- 终端像素（如 VS Code xterm）默认不进辅助功能树，编译日志仍以截图为准
- Windows 截的是窗口矩形的屏幕像素，被挡住的窗口会带上挡住它的内容

License

MIT