dsh-direct-open:讓 DSH 回覆裏的文件左鍵用系統默認程序打開

前言

在 DeepSeek Harness(DSH)裏看智能體交付的文件時,默認習慣往往是左鍵點進側邊欄預覽。若你更想直接用 VS Code、系統編輯器或文件管理器處理路徑,就要多一步操作。dsh-direct-open 是純客戶端插件:接管回覆裏若干「文件入口」的點擊行爲,左鍵可改爲系統默認打開或定位,並附帶可配置的右鍵菜單;不啓動額外進程,也不改 Host 配置。下面介紹它的定位、能力與安裝方式。

這是什麼

dsh-direct-open(npm 包名同插件倉庫名)由維護者 likaileave 發佈,分類爲客戶端插件,許可證 MIT。它通過 DSH 提供的 remote.session.openWorkspacePath({ path }) 在桌面端調用系統打開能力;Web 端沒有該能力時插件會顯示不可用且不接管點擊。

核心功能

左鍵與放行修飾鍵

默認左鍵動作爲「用系統默認程序打開」,也可在設置裏改爲「在文件管理器中定位」或「在 DSH 側邊欄中查看」(交回 DSH 原有預覽)。默認按住 Shift 時不接管左鍵,仍走 DSH 原邏輯;放行鍵可改爲 Ctrl、Alt 或關閉。

支持的入口

入口 說明
交付文件卡片 回覆末尾 data-presented-file 卡片上的預覽按鈕
改動卡片(單文件) 單文件標題行
改動卡片(多文件) 列表中每一文件行(不接管「已編輯 N 個文件」卡片頭)
正文文件提及 行內代碼提及與顯式文件鏈接

不會接管:多文件卡片整體標題行、review 頁面、普通行內代碼(非文件提及)。

右鍵菜單

啓用自定義菜單後,右鍵上述入口可出現五項操作(可逐項關閉):用默認程序打開、在文件管理器中定位、在 DSH 側邊欄中查看、複製絕對路徑、複製相對路徑。菜單支持方向鍵、Enter、Escape;關閉「啓用自定義右鍵菜單」則右鍵完全交回 DSH。

設置與快捷鍵

設置頁位於 設置 → 打開方式,含總開關、各入口的左鍵/右鍵開關、左鍵動作、放行修飾鍵、菜單項、診斷選項,以及導入/導出 JSON 與恢復默認。配置保存在瀏覽器 localStorage 的 dsh-direct-open:settings:v1,修改後在同瀏覽器多標籤頁同步。

桌面端默認快捷鍵 Ctrl/Cmd + Alt + Shift + O 用於暫停或恢復直接打開;Web 端無默認快捷鍵。

安裝與啓用

需要 DSH 0.2.0-rc.2 或更高,且運行在提供 remote.session.openWorkspacePath 的桌面端。安裝或更新後刷新 Web 頁面。

npm:

dsh plugin --profile desktop add dsh-direct-open

將 desktop 換成你實際使用的 profile。

dsh-market: 在市場中搜索 dsh-direct-open 安裝。

GitHub Release 手動安裝:

  1. 從 Releases 下載 dsh-direct-open.tgz。
  2. 執行:
dsh plugin --profile desktop add ./dsh-direct-open.tgz

典型用法

  1. 安裝並刷新頁面,打開 設置 → 打開方式,確認總開關開啓且環境顯示系統打開能力可用。
  2. 在回覆裏點擊交付文件卡片預覽按鈕或改動卡中的文件行:默認會用系統默認程序打開;需要側邊欄預覽時按住 Shift 再點(默認放行鍵)。
  3. 在文件行上右鍵,選擇「在文件管理器中定位」或「複製相對路徑」等;若與 DSH 原生右鍵衝突,可在設置裏關閉不需要的菜單項或關閉自定義右鍵菜單。
  4. 換瀏覽器或清站點數據前,用設置頁導出 JSON,在新環境導入以免丟失偏好。

左鍵三種動作與 API 對應關係如下(資料原文):

設置 行爲
用系統默認程序打開 openWorkspacePath({ path })
在文件管理器中定位 openWorkspacePath({ path, action: "reveal" })
在 DSH 側邊欄中查看 觸發入口元素原有點擊

適用場景與注意

適合經常在 DSH 桌面端處理智能體產出文件、希望少點一次側邊欄的開發者。插件依賴 DSH DOM 標記(如 data-presented-file、data-changed-files、fileMention),大版本 UI 變更可能需要插件同步更新;正文相對路徑依賴當前會話 cwd,無活動會話時可能不接管並在控制台記錄原因。插件以當前 DSH 客戶端權限運行,安裝前可在 GitHub 查看源碼與 MIT 許可證。不支持指定某一應用打開,只有系統默認打開與文件管理器定位;設置不跨設備同步。

社區插件目錄 SkillHub 上的 dsh-direct-open 頁 與 GitHub 倉庫並列存在,與 DeepSeek / 幻方無官方從屬關係。

結尾

dsh-direct-open 把交付卡、改動行和正文文件提及從「只能側邊欄預覽」擴展爲可配置的左鍵打開與右鍵菜單,改動範圍限於瀏覽器端 Cordis bundle。進一步瞭解實現與限制見倉庫 README。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜