MJ-Chang/dsh-vscode
在 VS Code 右側邊欄使用 DeepSeek Harness 的聊天 agent——像 Claude Code / Codex / Copilot 一樣，直接對話讓它讀取、編輯你的專案並執行指令。Everything is a plugin：整套東西（擴充功能 + harness bridge 插件）都以插件形式組裝在 DeepSeek Harness 之上。
catalog 简介 / catalog descriptioncatalog description：DeepSeek Harness for VS Code: right-side chat agent that reads, edits, and runs your project — like Claude Code / Codex / Copilot.
安装Install
dsh plugin --profile web add github:MJ-Chang/dsh-vscode把 MJ-Chang/dsh-vscode 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
dsh-vscode — DeepSeek Harness for VS Code
在 VS Code 右側邊欄使用 DeepSeek Harness 的聊天 agent——像 Claude Code / Codex / Copilot 一樣，直接對話讓它讀取、編輯你的專案並執行指令。Everything is a plugin：整套東西（擴充功能 + harness bridge 插件）都以插件形式組裝在 DeepSeek Harness 之上。
安裝
方式一：下載安裝檔（最簡單，推薦）
- 到 Releases 頁面 下載
deepseek-harness-chat-0.2.0.vsix（直連：deepseek-harness-chat-0.2.0.vsix） - 安裝（任選一種）：
- VS Code 延伸模組面板 →
⋯→ Install from VSIX... → 選剛剛下載的檔案；或 code --install-extension deepseek-harness-chat-0.2.0.vsix
- VS Code 延伸模組面板 →
- 重載視窗（若原本開著）：
Ctrl+Shift+P→Developer: Reload Window
之後 VS Code 右側邊欄會出現 DeepSeek Harness 圖示，點開 → 輸入 API key → 開始使用。
Marketplace 版本上架後也會出現在延伸模組搜尋中。
方式二：自行打包（開發者）
開始使用
- 開啟一個專案資料夾（
File→Open Folder）——聊天框需要一個工作區才能操作檔案 - 打開聊天框：點右側邊欄的 DeepSeek Harness 圖示；或
Ctrl+Shift+P→DeepSeek Harness: Open Chat（若右側欄沒開，先View: Toggle Secondary Side Bar） - 輸入 API key：第一次開啟會顯示設定畫面，貼上
sk-...→ Connect。key 存在 VS Code SecretStorage；也可改用環境變數DEEPSEEK_API_KEY或工作區.env（優先序：SecretStorage → 環境變數 →.env） - 開始對話：輸入框打字 → Enter 送出；助手回覆串流顯示，工具呼叫以卡片展開
發送列控制項：
| 控制項 | 作用 |
|---|---|
📎 |
附加檔案（VS Code 選檔對話框），內容會隨訊息送給模型 |
model ▾ |
切換模型（deepseek-v4-flash / deepseek-v4-pro…），切換即開新對話 |
Workspace ▾（色標） |
權限模式：Read-only（紅）/ Workspace（藍）/ Full access（橘，需確認） |
0↑ · 0↓ |
本對話 token 用量（輸入/輸出） |
history ▾ |
歷史對話（含標題）——點選續接 |
preset ▾ |
agent preset：default（shell + fs + todo）/ minimal（僅檔案工具） |
Send / Stop |
送出 / 忙碌時變 Stop 可中止 |
其他：頂部工作區名稱——多 root 工作區點擊可切換 agent 操作的資料夾，單資料夾點擊複製路徑；DeepSeek Harness: Set API Key / Clear API Key 指令可事後管理 key。
功能
- 右側邊欄聊天框，使用 VS Code 主題配色
- 串流回覆（每 frame 節流渲染，長回覆不卡頓）；回合失敗直接顯示錯誤訊息（例如沒設 API key 不會看到空白回覆）
- 工具呼叫卡片（bash / read / write / edit / grep / glob…）：預設收合、出錯自動展開
- 模型選擇、歷史續接（含標題）、agent preset、附件
- 權限模式即時切換，切到 Full access 需要確認
- 多 root 工作區切換；切換對話前自動中止進行中的回合（不留背景孤兒）
- harness 插件管理：
Install Plugin（npm / git / 路徑）——「一切皆插件」在嵌入式 runtime 一樣成立 - Windows 上執行指令不會閃 console 視窗
需求
- VS Code ≥ 1.90
- DeepSeek API key（可在聊天框內輸入，或環境變數 /
.env） - Node.js（建議，非必須）：有裝的話 Windows 上執行指令不會閃視窗；沒裝也能用，但 shell 指令可能閃出 console 視窗
- npm / pnpm 不需要：核心功能不碰套件管理器；只有選用的「Install Plugin」功能需要 Node.js 附帶的 npm
設定
| Key | 預設 | 說明 |
|---|---|---|
dshVscode.model |
deepseek-v4-flash |
對話使用的模型 |
dshVscode.apiKeyEnv |
DEEPSEEK_API_KEY |
存放 API key 的環境變數名稱 |
dshVscode.workspaceWriteOnly |
true |
限制 agent 只能動工作區；false = 完整檔案權限（小心） |
它是怎麼運作的
擴充功能背後是一個真正的 DeepSeek Harness runtime 子程序（不是包裝 API 的玩具）：runtime/cordis.yml 組出完整插件樹——sandbox、session persistence、compaction、token-meter、agent presets、stdio JSON-RPC bridge——所以 harness 的插件架構、沙箱政策與持久化在 VS Code 裡全部保留。
VS Code (Webview 聊天框)
│ postMessage
Extension host (spawn + 事件轉譯)
│ stdio JSON-RPC
Harness runtime 子程序（sandbox + 檔案/命令工具 + LLM）
安全
詳見 SECURITY.md。重點：API key 存 SecretStorage；預設 sandbox 只允許動工作區；Webview 嚴格 CSP + 文字全轉義；「Install Plugin」等同執行任意程式碼，只裝你信任的插件。
已知限制（v1）
- 內建 Markdown 渲染支援標題/清單/程式碼塊/粗體/斜體/連結；表格、引用等進階語法尚未支援
- 無
ask權限流程：需要人工批准的動作直接拒絕（由 sandbox 當安全邊界） - 尚未包含 subagent / workflow / MCP 等進階能力（v2 候選）
- 版本跟隨 DeepSeek Harness 的
0.1.0-rc.x（上游為開發者預覽，可能有 breaking changes）
開發與貢獻
開發者請見 CONTRIBUTING.md；打包、發佈 Marketplace 與 GitHub Release 的步驟見 PUBLISHING.md。
License
MIT（LICENSE）。第三方依賴與授權清單見 THIRD_PARTY_NOTICES.md。
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
nexu-io/open-design
🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your…
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
esengine/DeepSeek-Reasonix
DeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…