前言¶
在 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 手動安裝:
- 從 Releases 下載
dsh-direct-open.tgz。 - 執行:
dsh plugin --profile desktop add ./dsh-direct-open.tgz
典型用法¶
- 安裝並刷新頁面,打開 設置 → 打開方式,確認總開關開啓且環境顯示系統打開能力可用。
- 在回覆裏點擊交付文件卡片預覽按鈕或改動卡中的文件行:默認會用系統默認程序打開;需要側邊欄預覽時按住
Shift再點(默認放行鍵)。 - 在文件行上右鍵,選擇「在文件管理器中定位」或「複製相對路徑」等;若與 DSH 原生右鍵衝突,可在設置裏關閉不需要的菜單項或關閉自定義右鍵菜單。
- 換瀏覽器或清站點數據前,用設置頁導出 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。