前言¶
在 DeepSeek Harness(DSH)裏,助手回覆裏經常出現本地文件超鏈接、文件引用標籤(Chip)或代碼塊中的路徑。默認瀏覽器式右鍵往往只有複製鏈接,無法用「用某應用打開」「在資源管理器中顯示」這類桌面習慣操作工作區文件。下面介紹社區插件 dsh-file-context-menu(npm 包名 @dengsixue/dsh-file-menu),它在 DSH Desktop 對話區域爲這些元素注入上下文菜單,行爲接近操作系統原生文件菜單。
這是什麼¶
dsh-file-context-menu 由維護者 dengsixue-stack 發佈,分類爲 客戶端 插件:通過 Cordis patch 與客戶端注入(依賴 @deepseek-ai/dsh-client-ui-conversation),在 Web 端對話 UI 中攔截文件相關元素的右鍵事件。項目採用 MIT 許可證,當前 package 版本爲 1.0.1(以倉庫 package.json 爲準)。
社區目錄頁:dsh-file-context-menu。源碼與說明:GitHub - dengsixue-stack/dsh-file-context-menu。SkillHub 爲獨立社區目錄,與 DeepSeek / 幻方無官方從屬關係;DSH 生態遵循「一切皆插件」,可按需從 npm 或本地包安裝。
核心功能¶
以下能力均來自項目 README 與 package.json 描述,按使用場景歸納。
打開與「打開方式」¶
- 菜單頂部會記憶上次用來打開該類型文件的應用,便於一鍵再次用同一應用打開。
- Windows:從註冊表(
HKCU/HKLM)解析關聯應用與OpenWithList,並通過 PowerShell 批量提取應用圖標;README 說明已處理 Electron 環境下外部應用繼承ELECTRON_RUN_AS_NODE導致喚起失敗的問題。 - macOS:通過 LaunchServices 解析與 Finder 一致的應用列表與圖標。
部分 Windows UWP 沙盒應用(如系統簡易照片)不會出現在傳統打開方式列表中,屬平臺限制。
保存、複製與定位¶
- 另存爲…:調用系統原生保存對話框,將工作區文件保存到任意目錄。
- 快速複製:可複製文件名/鏈接文本、絕對路徑、文件內容(文本文件,5MB 以內)。
- 在資源管理器 / Finder 中顯示:打開父目錄並高亮選中該文件。
交互細節¶
- 子菜單採用懸停緩衝與約 280ms 延時,減少斜向移動時子菜單意外關閉。
- 按住 Shift 再右鍵,可穿透到操作系統或瀏覽器原生菜單,不替代原生行爲。
平臺兼容性¶
| 平臺 | 打開方式 | 圖標 | 狀態(README) |
|---|---|---|---|
| Windows | 註冊表關聯應用 | PowerShell 批量提取 | 已適配 |
| macOS | LaunchServices | 系統原生映射 | 支持 |
安裝與啓用¶
推薦通過 npm 包安裝,命令須帶 --profile desktop(客戶端插件面向 DSH Desktop):
dsh plugin --profile desktop add @dengsixue/dsh-file-menu
也可從 GitHub Releases 下載 .tgz,在 DSH Desktop「插件」頁安裝,或:
dsh plugin --profile desktop add .\dengsixue-dsh-file-menu-1.0.0.tgz
本地開發調試時,可將源碼目錄直接加入(路徑按本機修改):
dsh plugin --profile desktop add "C:\Users\Administrator\Documents\dsh-file-context-menu"
安裝、更新或修改客戶端注入代碼後,必須完全退出並重新打開 DSH Desktop(重啓主進程)。僅在界面按 Ctrl + R 刷新無法重新加載底層客戶端擴展。
典型用法¶
- 在 DSH Desktop 中完成上述安裝並重啓應用。
- 在對話裏找到指向工作區本地文件的鏈接、Chip 或代碼塊中的文件路徑。
- 在該元素上右鍵,使用「打開方式」「另存爲」「複製路徑/內容」「在 Finder/Explorer 中顯示」等項。
- 若需要瀏覽器或系統自帶右鍵菜單,按住 Shift 再右鍵。
插件不提供單獨配置文件字段;行爲由注入的客戶端腳本與宿主提供的文件路徑解析能力決定。
適用場景與注意¶
適合誰:經常在 DSH 對話裏點擊、複製、用外部編輯器打開工作區文件的 Desktop 用戶;在 Windows 或 macOS 上希望右鍵菜單與系統習慣一致的場景。
權限與安全:客戶端插件在 當前 DSH 進程權限 下運行,可觸發打開外部程序、讀寫路徑與文件內容(複製內容受 5MB 限制)。安裝前應閱讀 源碼倉庫 與 MIT 許可證,確認符合你的安全策略。
環境:需 DSH Desktop 與 Cordis 插件體系(peerDependencies 含 @deepseek-ai/cordis ^4.0.1)。非 Desktop 或未注入對話 UI 的環境可能不會加載該客戶端擴展。
結尾¶
dsh-file-context-menu 把 DSH 聊天裏的文件鏈接從「只能複製 URL」擴展爲桌面級右鍵操作:打開方式、另存爲、複製路徑與內容、在 Finder/Explorer 中定位,並保留 Shift+右鍵原生菜單穿透。
- 目錄頁:https://www.skillhub.cn/plugins/dengsixue-stack/dsh-file-context-menu
- GitHub:https://github.com/dengsixue-stack/dsh-file-context-menu