HarcoChen/dsh-intellij-integration

DeepSeek Harness for JetBrains IDEs

在 JetBrains IDE 中使用 DeepSeek Harness：围绕代码对话，用原生 Diff 审查改动，通过 Trace 查看执行过程。

安装插件 ·
版本下载 ·
反馈建议 ·
VS Code 版本

面向 IntelliJ IDEA、PyCharm 等 IntelliJ Platform IDE 的独立社区插件。在写代码的地方解释陌生逻辑、排查问题、审查改动。

快速上手

1. 安装插件 — 打开 Settings → Plugins → Marketplace，搜索 DeepSeek Harness Integration，也可以前往 插件商店。按提示重启 IDE。
2. 连接 Runtime — 打开项目和 DSH 工具窗口。本地启动需要 Node.js，以及 pnpm 或 npm/npx；插件默认自动启动 Runtime。启动命令或已有 Runtime 的 Server URL 可在 Settings → Tools → DeepSeek Harness 中配置。
3. 配置凭据 — 通过 Find Action 找到 DSH: Configure API Key。修改密钥后重启本地 Runtime，让新值生效；外部已运行的 Runtime 使用自身配置的凭据。
4. 试一次 — 选中一个函数，右键选择 DSH → Explain Selection，或直接在聊天窗口提问。出现审批请求时，查看工具卡片和待执行改动的 Diff。

运行要求： IntelliJ Platform 2024.3+，且带有 JCEF（内嵌浏览器）。构建配置以 IntelliJ IDEA Community 和 PyCharm Community 2024.3.6 为兼容性验证目标；其他 IntelliJ Platform IDE 需要相同的平台 API 和 JCEF 支持。

从提问到审查改动

| 你想做什么 | DSH 在 IDE 中提供什么 |
| --- | --- |
| 理解或改进代码 | 在编辑器右键菜单中解释、修复、审查选区，或生成文档。 |
| 检查 Agent 改动 | 用 JetBrains 原生并排 Diff 打开支持的工具改动卡片，也能预览待审批的修改。 |
| 跟进任务 | 在 DSH 工具窗口查看聊天历史、切换会话、检查工具卡片和 Runtime 状态。 |
| 了解执行过程 | 内建 Trace 分析，查看会话事件和工具活动。 |
| 关注用量 | 状态栏余额指示器，在数据可用时展示 DeepSeek 价格信息。 |
| 在多个编辑器中继续工作 | 多个 IDE 窗口及配套 VS Code 插件可复用兼容的本地 Harness Runtime。 |

原生 Diff，无需依赖 Git

直接在 IDE 的 Diff 查看器里审查文件改动。对于支持的工具 Diff 卡片，DSH 从会话历史重建修改前后的内容，因此不依赖 Git 仓库，也能在审批前预览提议的修改。如果文件后续变化导致无法可靠重建，插件会说明原因，避免展示失真的对比。

把相关代码带入对话

通过 DSH: Ask About Selection 自由提问，或用 DSH 右键菜单执行解释、修复、审查、生成文档。上下文选择器还支持附加当前未暂存的 Git Diff。编辑器上下文大小受可配置的字节上限约束。

先规划，再执行

通过输入框的 Plan 开关或 /plan 进入计划模式，使用 /plan off 退出。
开关只改变会话模式，不会发送任务或消耗已附加的 IDE 上下文。
代理提交计划后，可以批准计划，也可以填写反馈并选择“继续规划”。
Runtime 提供耗时数据时，子代理树和预览会显示运行中及已完成的执行耗时。

在 IDE 内管理 Runtime

插件管理本地 Runtime 的启动、停止和重启，支持 pnpm、已安装的 dsh 和 npx 启动方式。通过包管理器启动时使用配置的 Runtime 版本，也可以连接已有 Runtime，或在浏览器中打开 Web UI。

API Key 保存在 IntelliJ Password Safe 中，传递给新启动的本地 Runtime。界面提供英文和简体中文资源。

配置

打开 Settings | Tools | DeepSeek Harness。

| 设置项 | 默认值 | 说明 |
| --- | --- | --- |
| 命令 / 参数 | pnpm dlx @deepseek-ai/dsh@0.1.2-rc.1 web --no-open | Runtime 的启动方式，也可以指向已安装的 dsh 或本地源码目录。 |
| 服务地址 / 端口 | "" / 0 | 优先连接已运行的 DSH Runtime；本地启动时端口 0 表示自动选择可用端口。 |
| 自动启动 | true | 项目打开时自动启动或连接 Runtime。 |
| Runtime 版本 | 0.1.2-rc.1 | 托管 Remote 协议的锁定版本。 |
| npm 镜像 | https://registry.npmmirror.com | 下载后备重试的 Registry 镜像。 |
| 超时 | 启动 30s，请求 600s | 等待启动和单次 RPC 调用的超时时间。 |
| 上下文字节数 | 120000 | 单次请求中  的最大 UTF-8 字节数。 |
| API Key 环境变量 | DEEPSEEK_API_KEY | 凭据注入到 Runtime 进程时使用的环境变量名。 |

常见问题

| 现象 | 排查入口 |
| --- | --- |
| Runtime 无法启动 | 通过 Find Action 运行 DSH: Diagnose Environment 和 DSH: Open Runtime Logs，检查设置里的启动命令和包管理器。 |
| 聊天窗口提示 JCEF 不可用 | 使用带 JCEF 的 IDE 运行时；降级面板也提供浏览器入口。 |
| 修改 API Key 后没有生效 | 重启本地 Runtime；如果连接外部 Runtime，请直接更新它的凭据。 |

从 Release 安装或本地构建

在 GitHub Releases 下载插件 .zip，然后打开 Settings → Plugins → ⚙ → Install Plugin from Disk…，选择压缩包，无需解压。

源码构建需要 JDK 21，使用仓库附带的 Gradle wrapper：

./gradlew format         # 应用仓库统一的 Java 格式化规则
./gradlew lint           # 检查格式并运行 Checkstyle
./gradlew verifyPlugin   # 结构与兼容性检查
./gradlew buildPlugin    # 生成可安装的 zip

Windows 使用 gradlew.bat。首次构建会下载 Gradle 和 IntelliJ Platform 依赖。

数据使用与隐私

插件自身不收集遥测数据。提问及附加的上下文经 DSH Runtime 发送给你配置的模型服务商，相应请求受该服务商的条款和隐私政策约束。由插件保存的 API Key 存放在 IntelliJ Password Safe 中，并传递给新启动的本地 Runtime 进程。

反馈与贡献

欢迎 报告问题或提出建议。报告问题时，请附上 IDE 和插件版本、操作系统、Runtime 版本及复现步骤；分享日志前请移除 API Key 和私有代码。也欢迎改进文档、提交范围明确的 PR，参与前请阅读 仓库规则。

如果 DSH 帮到了你，欢迎点一个 Star，让更多人发现它。版本记录见 Releases，致谢与归属见 第三方声明。

本项目由社区独立维护，未经 DeepSeek 或 JetBrains 背书。采用 MIT 许可证。