MJ-Chang/dsh-vscode

dsh-vscode — 适用于 VS Code 的 DeepSeek Harness

GitHub Release
CI
License: MIT
VS Code

在 VS Code 右侧边栏使用 DeepSeek Harness 的聊天 agent——像 Claude Code / Codex / Copilot 一样，直接对话让它读取、编辑你的项目并执行命令。Everything is a plugin：整套东西（扩展功能 + harness bridge 插件）都以插件形式组装在 DeepSeek Harness 之上。

安装

方式一：下载安装包（最简单，推荐）

1. 到 Releases 页面 下载 deepseek-harness-chat-0.2.0.vsix
（直链：deepseek-harness-chat-0.2.0.vsix）
2. 安装（任选一种）：
- VS Code 扩展面板 → ⋯ → Install from VSIX... → 选择刚刚下载的文件；或
- code --install-extension deepseek-harness-chat-0.2.0.vsix
3. 重载窗口（若原本开着）：Ctrl+Shift+P → Developer: Reload Window

之后 VS Code 右侧边栏会出现 DeepSeek Harness 图标，点开 → 输入 API key → 开始使用。

Marketplace 版本上架后也会出现在扩展搜索中。

方式二：自行打包（开发者）

见 CONTRIBUTING.md。

开始使用

1. 打开一个项目文件夹（File → Open Folder）——聊天框需要一个工作区才能操作文件
2. 打开聊天框：点右侧边栏的 DeepSeek Harness 图标；或 Ctrl+Shift+P → DeepSeek Harness: Open Chat（若右侧栏没开，先 View: Toggle Secondary Side Bar）
3. 输入 API key：第一次打开会显示设置界面，粘贴 sk-... → Connect。key 存在 VS Code SecretStorage；也可改用环境变量 DEEPSEEK_API_KEY 或工作区 .env（优先级：SecretStorage → 环境变量 → .env）
4. 开始对话：输入框打字 → 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。