前言¶
在 DeepSeek Harness（DSH）裏用 Web 界面管理多個工作區時，常見做法是記下目錄路徑，再切到終端或文件管理器手動打開編輯器。路徑一長、工作區一多，這一步很容易打斷節奏。
下面介紹的 dsh-open-in-vscode 把這一步收進側邊欄：每個工作區行的 … 溢出菜單裏多出一項，點一下就在本機 VS Code（或你配置的編輯器 CLI）裏打開對應目錄。插件由社區維護者 omdsh-dev 發佈，歸類爲客戶端插件，在 GitHub 上約 54 stars、6 forks。
這是什麼¶
dsh-open-in-vscode 是 DSH 的客戶端 + 宿主組合插件：Web 界面負責展示菜單項，DSH 宿主進程負責調用本機編輯器命令。
它解決的是「從 Web GUI 跳轉到本地 IDE」的銜接問題，不新增工具、技能或模型可調用的設置項，也不讀寫工作區文件本身。
核心功能¶
側邊欄菜單入口¶
插件優先使用 DSH 提供的 sidebar.workspaces.row-menu 擴展槽；在公開版 DSH 0.1.0-rc.6 上，若原生槽位不可用，會回退到兼容適配層。兩條路徑渲染的菜單項一致，並跟隨界面語言：
- 中文環境：在 VSCode 中打開
- 英文環境：Open in VSCode
點擊後的調用鏈¶
用戶點擊菜單項後，客戶端關閉菜單，通過 Typert Remote 調用 openInVscode/open，把當前工作區目錄傳給宿主。宿主側以 detached 方式啓動配置的編輯器 CLI（默認 code <path>），編輯器進程獨立於 DSH 服務存活。
能力邊界¶
| 操作 | 運行位置 | 是否需要審批 |
|---|---|---|
| 在用戶點擊後打開工作區目錄 | 宿主（用戶手勢觸發） | 否 |
| 其他 | — | 插件無 tools、無 settings namespace、無面向模型的接口 |
前置條件¶
- 本機安裝 VS Code，或 PATH 上存在可打開目錄的編輯器 CLI。Windows 下默認的
code命令會探測常見安裝路徑；macOS 需先安裝 VS Code shell command，或在配置裏改用其他可執行文件。 - DSH 版本 0.1.0-rc.6 或更新。
0.1.0-rc.6起支持原生工作區行菜單擴展點；更早版本不在插件支持範圍內。
安裝與啓用¶
在 Web profile 中添加插件（會在 profile 內執行 pnpm 並協調 bundle 層）：
dsh plugin --profile web add https://github.com/omdsh-dev/dsh-open-in-vscode/archive/refs/tags/v0.1.6.tar.gz
重啓 Web 服務（向進程發送 kill -TERM <pid> 並等待退出，不要用 kill -9，以免中斷會話 zstd 日誌），然後刷新頁面。宿主插件掛載在 dsh-open-in-vscode 下，客戶端 bundle 由 /plugins/dsh-open-in-vscode/client.js 提供。
確認已安裝版本：
dsh plugin --profile web list dsh-open-in-vscode --depth 0
當前發佈版本爲 v0.1.6，許可證 MIT。
配置¶
可在 cordis.yml 中調整以下字段：
| 鍵 | 默認值 | 含義 |
|---|---|---|
command |
code |
用於打開目錄的可執行文件。默認在 Windows 上會探測標準 VS Code 安裝位置；其他命令通過 PATH 解析。 |
args |
[] |
傳入目錄路徑之前的額外參數。 |
若可執行文件不存在，插件會明確報錯並給出修復提示；相對路徑會被拒絕。
典型用法¶
經過上面的安裝與重啓步驟後，打開 DSH Web 界面，在側邊欄找到目標工作區，點擊該行右側 …，選擇 在 VSCode 中打開（或英文界面下的 Open in VSCode）。本機應彈出 VS Code 並打開該工作區目錄。
若你使用 Cursor、VSCodium 等兼容 CLI，可在 cordis.yml 裏把 command 改成對應的可執行文件名，必要時通過 args 傳入額外參數。
適用場景與注意¶
適合誰
- 經常在 DSH Web 界面切換工作區，又習慣在本機 IDE 裏繼續編輯的開發者。
- 希望減少「複製路徑 → 終端
code」重複操作的團隊。
使用前請留意
- 插件以當前 DSH 宿主進程的用戶權限運行；安裝前建議查看 GitHub 源碼 與 MIT 許可證，確認行爲符合你的部署策略。
- 插件只打開用戶已在 DSH 中可見的工作區目錄，不提供文件讀寫、遠程執行或其他自動化能力。
- DSH 生態遵循「一切皆插件」思路；SkillHub 目錄頁 是社區收錄站點，與 DeepSeek / 幻方無官方從屬關係。
鏈接¶
- 目錄頁：https://www.skillhub.cn/plugins/omdsh-dev/dsh-open-in-vscode
- GitHub：https://github.com/omdsh-dev/dsh-open-in-vscode
