前言¶
用 DeepSeek Harness（DSH）做智能體或本地工程開發時，經常要在「資源管理器裏看到的目錄」和「dsh 裏的工作區、會話」之間來回切換：複製路徑、手動新建工作區、再開會話，步驟多且容易打斷思路。社區插件 dsh-explorer-open（維護者 ame-code，分類：客戶端）在 Windows 資源管理器右鍵菜單裏增加 「通過 dsh 打開」，點一下即在 dsh 中打開對應文件夾（無工作區則新建），並打開一個新會話；在文件上右鍵時還會把 @文件名 放進新會話草稿。下面按定位、功能、安裝與排查說明用法。
這是什麼¶
dsh-explorer-open 是發佈在 npm 上的 DSH 插件包（dsh-explorer-open），倉庫見 GitHub：ame-code/dsh-explorer-open，插件目錄頁見 skillhub.cn/plugins/ame-code/dsh-explorer-open。它只做一件事：把 Windows 資源管理器的右鍵操作橋接到 dsh 的工作區與會話創建流程；Win11 的新式簡潔菜單與舊式完整菜單均支持，並帶菜單圖標。許可證爲 MIT；當前 README 標明處於 0.1.x，接口路徑、狀態目錄、環境變量與安裝方式仍可能變化。
核心功能¶
根據 README 中的行爲表，右鍵對象與結果如下：
| 在哪兒右鍵 | 打開的文件夾 | 放進新會話的草稿 |
|---|---|---|
| 文件夾空白處 | 當前文件夾 | 無 |
| 文件夾圖標上 | 這個文件夾 | 無 |
| 任意文件上 | 文件所在的文件夾 | @文件名 引用（工作區之外的路徑不引用） |
補充約定（均來自官方 README）：
- 每次點擊都會新建會話並切換過去；工作區按完整路徑複用，不會重複創建。
- dsh 未啓動時會先拉起 dsh，請求排隊直到頁面連上再執行。
- 插件停用或卸載時會自行拆掉菜單（舊式註冊表鍵 + Win11 新式 MSIX 包），避免殘留。
- 僅在 Windows 上工作（註冊表 + MSIX + 資源管理器）。
安裝與啓用¶
從 npm 安裝（推薦）¶
在 dsh 的插件設置裏安裝包名 dsh-explorer-open，或由 agent 通過 bundle 安裝入口接受 npm 包名完成安裝。README 未給出 dsh plugin add github:... 一類命令，此處以資料原文爲準。
首次啓用時會自動安裝 Win11 新式菜單所需的 MSIX 包。因使用自簽證書，Windows 可能拒絕安裝並提示：
Deployment failed with HRESULT: 0x800B0109
處理方式：以管理員身份運行一次插件目錄下的 native/trust-cert.bat（將自簽證書 dsh-open-with.cer 導入 LocalMachine\TrustedPeople），然後重啓 dsh；通常只需做一次。
若只需要舊式菜單、不想處理證書，可在啓動 dsh 前設置環境變量：
DSH_EXPLORER_OPEN_NO_MSIX=1
插件將不會安裝 MSIX 包。
從本地目錄安裝（開發場景）¶
資料中的示例爲在 dsh 環境裏執行 bundle 安裝（路徑需換成你的本地克隆目錄）：
# 倉庫本身就是插件包（package.json 在根目錄）
plugin_manager install_bundle E:\work\tools\dsh-open-with
修改代碼後需重啓 dsh 以重新加載宿主側插件；客戶端 bundle 需刷新頁面。
典型用法¶
- 確保 dsh 中已啓用 dsh-explorer-open（npm 包名）。
- 在資源管理器中：在目標文件夾空白處、文件夾圖標上或任意文件上右鍵，選擇 「通過 dsh 打開」。
- 等待 dsh 窗口前置；插件會創建或複用該路徑的工作區，並打開新會話。若在文件上右鍵，會話草稿中會帶有
@文件名引用。
整體鏈路（便於理解排錯）可概括爲：右鍵觸發 launch.ps1 → 寫入 ~/.dsh/dsh-explorer-open/pending.json → 宿主側輪詢 API → 頁面側創建 workSpace 與會話 → 必要時初始化帶 @文件 的草稿。
適用場景與注意¶
適合誰：主要在 Windows 上用 dsh 做本地目錄相關開發、希望從資源管理器一鍵進入對應工作區與會話的用戶。
環境與限制（README 已知限制）：
*註冊會使菜單出現在所有文件類型上，包括沒有關聯程序的類型。- 以管理員權限運行的資源管理器不會顯示用戶級（HKCU）菜單項。
- Win11 新式菜單需要證書受信；向第三方分發時宜使用正式代碼簽名證書，而非自籤。
安全與信任：插件會註冊右鍵菜單、可能安裝 MSIX、並通過自定義 HTTP 頭與 dsh 插件 API 通信；安裝前建議在 GitHub 倉庫 查看源碼與 MIT 許可證，並確認與當前 dsh 版本兼容。DSH 社區目錄（skillhub.cn）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；生態理念是「一切皆插件」，本插件爲社區維護的客戶端擴展。
排錯提示：若點擊菜單後只前置 dsh 窗口而未打開工作區，可先查看 ~/.dsh/dsh-explorer-open/trace.log（宿主與頁面 ack 階段）；必要時檢查 pending.json 是否寫入。原生組件調試可設 DSH_EXPLORER_OPEN_DEBUG=1 後查看 LOCALAPPDATA%\dsh-explorer-open-command.log。
結尾¶
dsh-explorer-open 把 Windows 資源管理器的右鍵路徑與 dsh 的工作區、會話創建連在一起，減少手工拷貝路徑和重複建工作區的步驟。更多信息見 插件目錄頁 與 GitHub 倉庫。
