返回目錄

dsh-vscode

維護狀態: 活躍

fengze233/dsh-vscode

在 VS Code 中整合 DeepSeek Harness,提供嵌入式 Web 介面、自動啟動、鑑權中繼和橋接功能。

前往 GitHub專案首頁
$ dsh web

51

星數

16

Fork

TypeScript

語言

MIT

授權條款

2026-08-15

建立於

2026-11-08

最近推送

MIT 授權的 VS Code 擴充套件:把 DSH web UI 嵌進編輯器,託管 `dsh web` 生命週期,在 loopback 上中繼 DSH 的 token 驗證,並把編輯器動作橋接進面板。

DSH 整合

原生執行環境

作者聲明

安全稽核

未稽核

最後核實

2026-11-20

授權條款

MIT

01它能幫你完成什麼?

  • 在程式碼旁邊直接和 DeepSeek Harness 對話,不必切到終端機或瀏覽器分頁

    完整的 DSH web UI 嵌在左側邊欄或右側次側邊欄,服務由擴充套件自動沿用或啟動

    整天待在編輯器裡、不想再為 agent 多開一個視窗的 VS Code 使用者

  • 讓 DSH 強制的瀏覽器登入在跨站 webview 裡照樣成立

    一次性啟動 URL 換成 30 天工作階段 cookie,再經 loopback 中繼餵給面板,iframe 不會卡在登入頁或 401

    用 DSH 0.1.2 以上、否則嵌進編輯器的面板會一直要求登入的人

  • 讓嵌進來的 DSH 頁面像編輯器裡的一頁,而不是被關住的 iframe

    可點的檔案路徑、走系統瀏覽器開的外連、能用的複製鈕、還原的復原/重做,以及給無視覺模型的圖片備援

    每天都在 agent 面板裡點檔案路徑、複製程式碼區塊、貼截圖的開發者

02如何將外掛接入 DeepSeek Harness?

先決條件

  • PATH 上有 `dsh` CLI —— 從 DeepSeek Harness 安裝;Windows 上也可用 DSH Desktop
  • VS Code ≥ 1.91(README 的開發需求);Node.js ≥ 22 只在從原始碼建置擴充套件時才需要

安裝步驟

  1. 01

    從 Marketplace 安裝:`code --install-extension Fengze233.dsh-vscode-panel`

  2. 02

    或從 Releases 下載最新的 `dsh-vscode.vsix`,在 VS Code 執行 `Extensions: Install from VSIX...`,再重新載入視窗

  3. 03

    點左側活動列或右側次側邊欄的 DSH 鯨魚圖示 —— 擴充套件會啟動(或沿用)`dsh web` 並替面板完成登入

    $ dsh web

驗證整合成功

  • 狀態列會顯示即時服務狀態:running / starting / stopping / failed / stopped
  • `DSH: Show Logs` 會印出偵測到的 `dsh` 路徑、來源與版本
  • 橋接自檢:DSH 面板的 DevTools 主控台應出現 `[dsh-vscode-bridge] handshake ok, v0.4.4, imageFallback=true`

復原

  • 移除擴充套件:VS Code 會執行 `uninstall` 勾子,清掉 `cordis.patch.yml` 裡被標記的項目與橋接目錄
  • 或執行 `DSH: Uninstall Bridge`,只移除橋接套件並還原 `cordis.patch.yml`,擴充套件本身保留

03DSH 整合程度與能力邊界

DSH 整合原生執行環境

把官方 `dsh web` 服務包進 VS Code 的 webview:接手服務生命週期、在 loopback 上代理 DSH 的一次性 token 驗證,並把 `dsh-vscode-bridge` 用戶端外掛裝進 DSH profile

  • 服務生命週期管理

    `dsh.profile`、`dsh.port`、`dsh.launchPreference`(`auto` / `npm` / `desktop`)與 `dsh.autoStart`→沿用或新起一個 `dsh web`;設定的埠被佔用時暫時改用第一個空閒埠

    關掉最後一個視窗只會停掉擴充套件自己啟動的那個服務
  • 驗證中繼(auth relay)

    `dsh web` 印出的一次性啟動 URL→工作階段 cookie 存進擴充套件私有儲存,再由監聽 `127.0.0.1` 隨機埠的 loopback 中繼提供給 iframe

    中繼握著 30 天工作階段,本機任何行程只要掃到那個隨機埠就能驅動該工作階段不是擴充套件啟動的 DSH 服務,需要貼一次啟動 URL
  • 橋接進 DSH 頁面

    `$DSH_HOME/profiles/<dsh.profile>`(預設 `~/.dsh/profiles/web`)下的 DSH 使用者目錄→面板內的檔案跳轉、外連走系統瀏覽器、剪貼簿複製、復原/重做與圖片備援

    在 `cordis.patch.yml` 寫入帶 `# dsh-vscode-bridge: begin/end` 標記的區塊,並在使用者 profile 下建立橋接目錄 —— 絕不寫入 DSH 安裝目錄內建版本或其 `client.js` 內容有差異時會強制重裝
  • 無視覺模型的圖片備援

    貼上的圖片,加上一個已開啟的工作區資料夾→圖片快取到工作區根目錄,並以檔案路徑引用的形式送給模型,由模型用圖片工具讀取

    暫存圖片用完即刪,殘留由 `DSH: Clean Up Image Cache` 清理
  • 遠端情境

    `dsh.remote.enabled`,並在遠端主機上裝好擴充套件→SSH Remote、Dev Containers、Codespaces 在遠端跑 `dsh` 並透過通道開面板;WSL 不需要通道

04適合誰?何時不該用?

適合

  • 整天待在編輯器裡、不想再為 agent 多開一個視窗的 VS Code 使用者
  • 用 DSH 0.1.2 以上、否則嵌進編輯器的面板會一直要求登入的人
  • 每天都在 agent 面板裡點檔案路徑、複製程式碼區塊、貼截圖的開發者

不適合

  • loopback 中繼只監聽 `127.0.0.1`,但它握著一個 30 天工作階段:本機任何行程(含本機其他使用者)只要掃到那個隨機埠就能驅動該 DSH 工作階段。README 明白寫出這個暴露面,並拿它和「0.1.1 及更早、在 `127.0.0.1:3080` 上沒有驗證的服務」相比。
  • DSH Desktop 用的是 `desktop` profile,VS Code 預設用 `web`:工作階段與設定都在 `~/.dsh` 下共用,但外掛是依 profile 安裝,所以要在 VS Code 面板裡看到 DSH 外掛,得裝進 `web` profile。
  • 如果模型 API 只能透過 HTTP/HTTPS 代理存取,代理變數必須傳進 `dsh web` 子行程 —— 打開 `dsh.useEnvProxy: true`,或用 `dsh.env` 注入 `NODE_OPTIONS=--use-env-proxy` 並提供 `HTTPS_PROXY` / `HTTP_PROXY`。

05相容性、維護與安全提醒

  • loopback 中繼只監聽 `127.0.0.1`,但它握著一個 30 天工作階段:本機任何行程(含本機其他使用者)只要掃到那個隨機埠就能驅動該 DSH 工作階段。README 明白寫出這個暴露面,並拿它和「0.1.1 及更早、在 `127.0.0.1:3080` 上沒有驗證的服務」相比。
  • DSH Desktop 用的是 `desktop` profile,VS Code 預設用 `web`:工作階段與設定都在 `~/.dsh` 下共用,但外掛是依 profile 安裝,所以要在 VS Code 面板裡看到 DSH 外掛,得裝進 `web` profile。
  • 如果模型 API 只能透過 HTTP/HTTPS 代理存取,代理變數必須傳進 `dsh web` 子行程 —— 打開 `dsh.useEnvProxy: true`,或用 `dsh.env` 注入 `NODE_OPTIONS=--use-env-proxy` 並提供 `HTTPS_PROXY` / `HTTP_PROXY`。
  • README 記了三處已知限制:VS Code 1.140 起從檔案總管拖曳資源進 webview 不再生效(上游回歸,修正仍開著),圖片備援需要已開啟的工作區資料夾(快取寫在根目錄下),而 SSH Remote / Dev Containers / Codespaces 在開啟 `dsh.remote.enabled` 前不可用。
2026-08-152026-11-08V0.4.4

MIT · 活躍維護(最新 release V0.4.4,2026-11-08)

06常見問題

要怎麼把 DSH 裝進 VS Code?

從 Marketplace 安裝 `Fengze233.dsh-vscode-panel`,或執行 `code --install-extension Fengze233.dsh-vscode-panel`;也可以從 Releases 下載 `.vsix` 後用 `Extensions: Install from VSIX...` 安裝。前提是 PATH 上有 `dsh` CLI,Windows 上也可用 DSH Desktop。之後點活動列的鯨魚圖示,擴充套件會啟動或沿用 `dsh web` 並自動登入。

面板出現登入頁或 401 是什麼情況?

DSH 0.1.2 起強制瀏覽器驗證。擴充套件自己啟動的服務是自動登入的;如果 DSH 是你在 VS Code 外面起的(systemd、終端機),擴充套件讀不到那個行程的日誌,就會給一個一次性登入頁:把服務日誌裡的啟動 URL 貼一次,工作階段最長 30 天,重啟服務也不用再貼。

顯示 dsh not found 怎麼辦?

先裝 `dsh` CLI(`npm i -g @deepseek-ai/dsh`)或 DSH Desktop,並確認指令在 PATH 上。`dsh.launchPreference: auto` 時擴充套件優先 npm、失敗才退回 Desktop;Desktop 裝在自訂目錄就設 `dsh.desktopCommandPath`,用包裝腳本就設 `dsh.executablePath`。`DSH: Copy Logs` 會印出偵測到的路徑、來源與版本。

我裝的 DSH 外掛在 VS Code 面板裡看不到?

DSH Desktop 用 `desktop` profile,VS Code 預設用 `web`。工作階段與設定都在 `~/.dsh` 下共用,但外掛依 profile 安裝,所以要裝進 `web` profile(或用 `dsh.profile` 指向你想用的 profile)。

這會把我的 DSH 工作階段暴露到網路上嗎?

不會。擴充套件只接受 loopback 位址(`127.0.0.1` / `localhost` / `[::1]`),中繼不對網路暴露。不過 README 也寫明中繼握著 30 天工作階段,本機行程掃到那個隨機埠就能驅動該工作階段 —— 暴露面和 0.1.1 及更早、在 loopback 上沒有驗證的服務相同。

08資料與來源

  • 作者聲明github.comb1243baf6cda…

    Click the whale and get the full DSH web UI beside your code — the extension starts or reuses `dsh web`, handles DSH's o…

  • 作者聲明github.comb1243baf6cda…

    Works with **DSH 0.1.2 and newer**, including its browser authentication (auto sign-in, no manual step).

  • 作者聲明github.comb1243baf6cda…

    **Install / uninstall transparency.** The bridge is installed into `$DSH_HOME/profiles/<dsh.profile>` (default `~/.dsh/p…

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-20。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。