DeepSeek Harness

DeepSeek Harness for VS Code

Unofficial community extension — not affiliated with DeepSeek.
The DeepSeek Harness runtime is MIT-licensed open source (deepseek-ai/deepseek-harness).

非官方社区扩展，与 DeepSeek 官方无隶属关系。DeepSeek Harness 本体是 MIT 协议的开源项目。

Landing page: https://swording-k.github.io/dsh-vscode/

Install / 安装

From GitHub (available now): download dsh-vscode-<version>.vsix from Releases, then run Extensions: Install from VSIX… from the Command Palette (Cmd+Shift+P on macOS).

From the Marketplace: search DeepSeek Harness in the Extensions view.

What it does / 它做什么

Put DeepSeek Harness in your editor: the left launcher shows your folder's conversations; one click opens the full GUI beside the editor — ready to read and write your source tree.

用 VS Code 管理 DeepSeek Harness 对话：左侧启动器列出当前文件夹的历史对话，一点就在编辑器右侧打开完整 GUI，直接读写你的项目文件。

Entry points / 入口（four places to reach it）

Prerequisites / 先决条件

• Node.js ≥ 22
• DeepSeek Harness: npm i -g @deepseek-ai/dsh
  The extension calls the dsh executable on PATH by default, or a checkout when dshHarness.repoPath is set.
• An API key: set DEEPSEEK_API_KEY in your environment or use ~/.dsh/.credentials.yaml.
  The GUI's built-in Account settings let you enter the key on first launch.

Usage / 使用

1. Click the DeepSeek Harness icon in the left side bar (or use any entry point above).
2. The launcher shows your VS Code folder and its conversations; click + New Conversation or pick a saved one. The full DSH GUI opens on the right, ready to read/write your workspace files.
3. The server starts automatically on first use; the theme follows your VS Code colour scheme (disable dshHarness.syncTheme if you prefer manual control).

Settings / 设置

Publishing / 发布

The extension ships with a companion dsh-plugin-deep-link client plugin under plugin/. On a stock dsh install it is auto-installed into the web profile via dsh plugin --profile web add …. A source checkout already includes the deep-link patch and does not need it.

Before publishing to the Marketplace:

1. Create a publisher: VS Code Marketplace → create publisher.
2. Generate a Personal Access Token (Azure DevOps → Marketplace scope → Manage).
3. Log in: npx @vscode/vsce login <publisher-id>.
4. Replace publisher in package.json with your publisher id.
5. Replace the placeholder repository.url in package.json with your real GitHub repo URL.
6. Run npm run package (produces a .vsix) then npx @vscode/vsce publish.

Known issues / 已知限制

• Session targeting via #session=<id> relies on the dsh-plugin-deep-link plugin. Stock @deepseek-ai/dsh users get it auto-installed; source-checkout users on the custom branch already have it patched. Without either, the GUI opens normally and you select the conversation in the GUI sidebar — one extra click.
• The secondary side bar slot is not shown on VS Code builds older than 1.94.
• Multi-root workspaces are not yet supported (only the first folder is aligned).

Development / 开发

npm install
npm run compile        # tsc → out/
npm run package        # produces .vsix

Server logs appear in the Output panel under DeepSeek Harness Server.