Deepseek-Harness VSCode Integration Community Edition

面向 DeepSeek Harness 社区版 VS Code Extension，支持四种模式切换、Trace Vscode内查看等特色功能

English | 简体中文

注意：本项目为独立社区项目，并非 DeepSeek 官方项目，也未获得 DeepSeek 官方维护。

[!NOTE] 亮点

• 快速查看Key余额
• 流式传输、队列、Steer、审批和计划评审支持
• 输入 @ 实时搜索工作区文件，并插入明确的文件引用
• Git Diff集成，长prompt自动转文件发送
• 在内建 Trace 中查看工具调用、结果和 Reasoning
• 支持文件路径与行号跳转
• 查看当前模型、Reasoning effort、计费 Token、缓存用量和估算上下文压力
• i18n支持

功能更全面：会话状态、IDE 上下文、Runtime 活动、审批、Trace、文件变更均集成在插件内。

功能架构

聊天界面使用 React Webview 和类型化全量状态桥。Extension Host 负责 VS Code API、Runtime RPC、凭据、安全 Markdown 和动作校验。

安装

从Extension Market

🔗安装链接

从Github Release

从 GitHub Releases 下载 .vsix，然后运行 Extensions: Install from VSIX...。

从源码构建

npm install
npm run check
npm run package

通过 Extensions: Install from VSIX... 安装生成的 .vsix 文件。

使用方式

1. 打开一个已信任的工作区。
2. 打开 DSH Chat（Ctrl+Shift+Alt+D / Cmd+Shift+Alt+D）。
3. 输入 @ 搜索并引用工作区文件，附加选区、诊断信息或未暂存的 Git diff，也可以输入 / 打开本地命令菜单。
4. 发送 prompt，并直接在聊天视图内处理工具审批、问题和计划评审。

资源管理器右键菜单提供 DSH：询问此资源，会将所选文件或目录及其工作区根目录预填到聊天，不会自动发送。执行 DSH：诊断环境 可在 DSH 输出通道中生成脱敏的 Runtime 与命令发现报告。

如果 dsh 报告 API Key 缺失或无效，点击聊天头部的 Key，或运行 DSH: Configure API Key。密钥会交给 dsh 的凭据服务，并以 VS Code SecretStorage 加密保存一份给余额指示器使用；不会写入 prompt、扩展状态或日志。

配置

{
  "dsh.command": "npx",
  "dsh.commandArgs": ["-y", "@deepseek-ai/dsh", "web"]
}

• dsh.command / dsh.commandArgs：用于启动 dsh web 的命令。
• dsh.serverUrl：连接已有 runtime，而不是启动新进程。
• dsh.serverPort：本地 runtime 端口；0 表示自动选择。
• dsh.maxContextBytes：<ide_context> 区块的最大 UTF-8 字节数。
• dsh.apiKeyEnv：DSH: Configure API Key 使用的凭据引用名，默认为 DEEPSEEK_API_KEY。
• dsh.balanceRefreshIntervalMs：DeepSeek 余额刷新间隔，默认为 30 秒。

余额指示器调用 DeepSeek 官方 /user/balance 接口。聊天凭据仍由 dsh runtime 管理；SecretStorage 中的加密副本仅用于只读余额查询。

开发

npm install
npm run check      # TypeScript 检查
npm run compile    # 构建到 dist/
npm run package    # 编译 + vsce 打包

在 VS Code 中按 F5 启动 Extension Development Host。

更多信息

• 更新日志
• 产品 TODO
• 第三方资产说明

许可证

MIT