前言¶
在 DeepSeek Harness（DSH）裏，對話區會出現文件鏈接、行內路徑、網頁 URL 和工作區附件；右側 Sidebar 還有文件樹，左側有工作區列表。若只能手動複製路徑、再切到系統資源管理器或瀏覽器操作，步驟多且容易出錯。社區插件 dsh-file-context-menu（維護者 Dusty-Dustin55）在這些位置提供統一的右鍵菜單：引用到輸入框、複製名稱或路徑、內部預覽、用默認或指定應用打開、定位文件夾、另存副本等。下面介紹它的能力邊界、安裝方式與使用注意。
這是什麼¶
dsh-file-context-menu 是發佈在 npm 的 DSH 客戶端插件（當前版本 0.4.0，許可證 MIT）。它在對話區、Sidebar「文件」樹和左側工作區列表上監聽右鍵，根據命中對象彈出對應菜單；路徑解析複用 DSH 的 remote.session、remote.workspaceFiles 和 workspaces 服務，本機打開文件、瀏覽器等動作由宿主提供的 /file-actions/* 路由完成。插件不上傳用戶數據；診斷默認關閉，僅在本機開啓診斷開關時纔會把命中信息寫入本機內存接口。
可在社區目錄頁查看條目：dsh-file-context-menu。源碼與說明見 GitHub 倉庫。
支持的右鍵位置¶
安裝並重啓 DSH 後，下列位置會出現定製菜單（具體項隨對象類型變化）：
| 位置 | 右鍵對象 | 菜單類型 |
|---|---|---|
| 對話區 | 文件鏈接 / 交付卡片 / 行內代碼路徑 | 完整文件菜單 |
| 對話區 | 目錄路徑（如 證據庫/全文/） |
目錄菜單 |
| 對話區 | 無擴展名路徑 | 自動判斷文件或目錄 |
| 對話區 | http(s) 網頁鏈接 | 鏈接菜單 |
| 對話區（自己發送的消息） | 純文本 http(s) 鏈接 | 鏈接菜單 |
| 對話區（自己發送的消息） | 文件附件卡片 | 僅「複製名稱」 |
| 對話區 | 任意文字或選中文字 | 文字菜單 |
| 右側 Sidebar「文件」樹 | 文件夾 | 文件夾菜單 |
| 左側工作區列表 | 工作區分組行 | 工作區菜單 |
識別範圍包括 dsh-resource://file/...、交付卡片上的路徑、路徑式 href、行內代碼中的路徑（如 `工作底稿/設計.md`），以及約 230 種擴展名（含大寫擴展名、UNC、中文與全角符號、含空格文件名等）。普通正文裏未格式化的路徑、不帶斜槓的裸目錄名、代碼表達式不會被當作可右鍵對象；目錄建議寫成 工作底稿/ 形式。
菜單能力概覽¶
文件¶
| 菜單項 | 作用 |
|---|---|
| 引用該文件 | 向輸入框插入 @路徑 文件引用 |
| 複製名稱 | 複製文件名（含擴展名） |
| 複製路徑 | 複製絕對路徑；解析失敗時退回顯示路徑 |
| 打開（內部） | 在右側 Sidebar 預覽 |
| 打開（默認應用） | 用系統默認程序打開 |
| 選擇應用打開… | Windows「打開方式」；macOS 應用選擇器；其他系統退回應用列表 |
| 打開所在文件夾 | 打開父目錄並選中該文件 |
| 另存爲… | 複製到自選位置（優先 showSaveFilePicker，不可用時回退下載） |
目錄 / 文件夾¶
- 複製名稱、複製路徑、打開文件夾（直接打開該目錄；與文件的「打開所在文件夾」不同）。
網頁鏈接¶
- 引用鏈接（URL 插入輸入框）、複製名稱、複製鏈接、打開（內部 Sidebar 瀏覽器頁籤）、打開（默認瀏覽器）、選擇瀏覽器打開…（列出 Edge、Chrome、Firefox、Brave、Vivaldi 等）。
工作區與文字¶
- 工作區：複製名稱、複製路徑、打開所在文件夾（在父目錄定位工作區文件夾）。
- 文字：複製文字；引用到對話框（以 Markdown 引用塊
> ...插入輸入框）。
安裝與啓用¶
在 DSH 插件頁安裝，或在終端執行：
dsh plugin --profile desktop add dsh-file-context-menu
安裝後需要完全退出並重新啓動 DSH，客戶端模塊在啓動時加載。
更新到最新版：
dsh plugin --profile desktop add dsh-file-context-menu@latest
卸載：
dsh plugin --profile desktop remove dsh-file-context-menu
要求 DSH 0.2.1-rc.1 及以上（package.json 中 engines.dsh 已聲明）；README 寫明當前適配 DSH 0.2.1-rc.5。
典型用法¶
- 在對話裏對行內路徑或文件鏈接右鍵，選「引用該文件」，輸入框會出現
@路徑，便於繼續 @ 引用工作區文件。 - 對 http(s) 鏈接右鍵，選「打開（內部）」在 Sidebar 瀏覽器頁籤查看，或選「打開（默認瀏覽器）」交給系統瀏覽器。
- 在 Sidebar 文件樹對文件夾右鍵，用「打開文件夾」在本機資源管理器中打開該目錄。
- 選中一段說明文字右鍵，選「引用到對話框」，以引用塊形式插入輸入框，方便在回覆裏指向原文。
鏈接的「引用鏈接」插入的是 URL 文本；輸入框的 @ 引用僅支持工作區文件，這是 DSH 側能力邊界，不是插件單獨限制。
適用場景與注意¶
適合經常在 DSH 對話裏點路徑、鏈接和工作區、又不想反覆手工複製與切換外部應用的用戶。插件以當前 DSH 進程權限調用本機打開、另存爲等能力，安裝前建議瀏覽 源碼倉庫 與 MIT 許可證，確認符合你的環境策略。
已知限制（來自 README）：
- 鏈接「打開（內部）」依賴 Sidebar Browser 頁籤；Web profile 默認禁用時會提示無法打開。
- 「另存爲」受
/api/file字節上限約束（當前約 10 MB）。 - 相對路徑無法解析爲絕對路徑時，菜單可能只剩「打開（內部）」和「引用」。
- Sidebar 文件樹目前只接管文件夾行右鍵，文件行尚未接管。
- 用戶消息裏的附件卡片只有文件名、無真實路徑，因此只有「複製名稱」。
- 依賴 DSH 0.2.x 的客戶端服務名；DSH 大版本升級後需複覈兼容性。
問題反饋：GitHub Issues；變更見倉庫內 CHANGELOG.md。
結尾¶
dsh-file-context-menu 把 DSH 裏常見的文件、目錄、鏈接與工作區入口收成一套右鍵操作，減少複製路徑和在系統裏找文件的重複勞動。社區目錄：SkillHub 插件頁；源碼與完整說明：github.com/Dusty-Dustin55/dsh-file-context-menu。
