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