JetBrains 编程助手 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 工具窗口。插件会发现兼容的本机 dsh，包括官方 DeepSeek Desktop 注册的命令；随插件提供的生命周期助手仍需要 Node.js 24+。插件默认自动启动 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 会将提议路径与 IntelliJ 未保存的编辑器缓冲区比对。若发生重叠，审批会保持待处理，直到你保存或撤销该文档。

把相关代码带入对话

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

输入框支持从剪贴板粘贴、从桌面拖放，或通过文件选择器添加附件。附件会上传到已连接的 Runtime，并在提示中只使用会话范围的 receipt；插件不会把本地文件路径发送给模型。点击用户或助手消息下方的复制按钮，可将消息文本放入系统剪贴板。

使用 /template 斜杠命令，可以从 .dsh/prompts 选择有大小限制的 Markdown 草稿并放入输入框。模板会以可见、可编辑的内容出现，只有手动发送后才会提交。

原生 Conversation Outline 命令可以定位当前会话的指定回合。已完成的助手消息还可以使用 Runtime 提供的可选反馈（评分、备注和整会话反馈）；旧 Runtime 会隐藏这些控件，不影响聊天。对已完成消息可以 Fork 会话、恢复该回合的代码改动，或在宿主重新校验检查点后同时执行两者。

先规划，再执行

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

Activity Dock 还会显示经过校验的活动提醒；Runtime 提供相应能力时，也会显示只读插件清单和动态 Cordis 插件状态。动态插件的停止、移除和拒绝操作都由宿主校验，IDE 不会执行不可信的 Client half 插件代码。

在编辑器中聊天与调试

通过 Find Action 或聊天菜单的 DSH：在编辑器标签页打开聊天，打开工具窗口的镜像。
两个入口共用当前会话、消息、控制项和 Runtime；关闭标签页只释放该视图。问答草稿保存在项目本地 IDE 设置中，可跨 IDE 重启恢复，空闲视图不会覆盖另一视图的输入。

在插件设置开启 允许 Agent 操作此 IDE 调试器 后，重启插件拥有的本地 Runtime。
Agent 可启动已有 Run/Debug 配置、管理源码断点、暂停/继续/单步、选择暂停的线程与栈帧，并通过带凭据的本机 MCP 读取有大小限制的调用栈、当前源码和诊断。诊断使用已有 IDE 高亮。
不自动采集运行时变量值，分析所需的值请手动附加；不会创建任意启动配置，也不提供表达式求值接口。外部 Runtime 的集成由它自身管理。

产品专用调试选项和 2024.3 基线下的终端上下文限制，见附 API 依据的 TODO。

在 IDE 内管理 Runtime

插件管理本地 Runtime 的启动、停止和重启。自动启动会发现兼容的本机 dsh；没有可用命令时，提供官方 DeepSeek Desktop 下载入口。高级配置仍可明确使用 pnpm/npx 启动，并按设置固定 Runtime 版本。也可以连接已有 Runtime，或在浏览器中打开 Web UI。

Runtime 0.1.5 适配包括断线后恢复临时流式回答、V3 历史与压缩记录、附件提交、子代理排队提示，以及重连后显式恢复 Goal。模式选择遵循 Runtime 策略，技能菜单悬停显示来源路径。上下文环形条悬停查看统计，点击模型名称切换模型。

默认 Runtime 已更新到 0.2.1-rc.2。聊天菜单增加原生“管理会话”“管理 DeepSeek 账户”“管理日程”对话框。会话可固定、恢复归档；账户管理使用 Runtime 的浏览器登录流程，并显示资料、余额和赠金提醒；日程可跨会话查看，当前会话的提醒可编辑、删除或查看投递历史。没有项目目录时，首次显式创建会话可初始化 Runtime 默认 Workspace。

插件还内置共享的 Laya/Jev Runtime 集成，并装载到本插件启动的本地 Runtime 中；默认关闭。可在 Settings → Tools → DeepSeek Harness 中开启集成及所需功能，从聊天菜单配置 System One API Key，再重启 Runtime。密钥保存在 IntelliJ Password Safe；服务地址支持 HTTPS，也支持本机 Laya 的 localhost/127.0.0.1 HTTP。插件不会修改外部管理的 Runtime。

插件启动的本地 Runtime 崩溃后会重试，并通过隔离验证、有限次数修复与可撤销的 bundle 隔离尝试恢复。状态栏提供取消恢复、还原修改和导出脱敏诊断。设置中可分别关闭自动恢复和持久化 bundle 隔离。恢复助手随插件打包在本地运行，即使使用独立安装的 dsh，仍需要 Node.js 24+。

自动复用仅针对编辑器发布的兼容 Runtime。插件读取 dsh-ide Runtime 广告，并只发布自己的发现记录；旧编辑器锁只作为只读发现线索，不阻挡启动；短期回环 gate 减少并发启动竞争。包装启动器退出但 Runtime 仍在服务时，撤销进程所有权并保留广告，避免重复启动。升级经过身份核验的本机 npm 安装通过原生对话框确认。手动填写的外部服务地址由外部管理；旧 Runtime 请先升级，0.1.5 的历史迁移不支持通过降级回退。

可选 Agent Team 会在 Activity Dock 显示成员、任务、依赖和写入范围冲突提示，并复用子代理的历史预览、跟进和中断操作。需要在 Runtime 中启用官方 Team profile bundle；插件读取其 Session 投影。

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

限时问题会显示 Host 倒计时，并在重连和视图重建后保留回答草稿；超时后仍可提交延迟回答。Jobs 提供实时输出、取消和按游标重连续读。插件设置提供 Bundle 选择、插件启停、只读原因，以及保存、生效或需重启等结果。Schedule 提醒需要启用可选的 Schedule bundle。

通过 Find Action 的 DSH：浏览 Runtime 工作区文件，或 /ide 入口，浏览当前会话在 Host 上的文件。原生预览只读，支持最大 1 MiB 的 UTF-8 文本、文件变更刷新和手动刷新，并绑定打开时的 Runtime。

会话菜单新增会话中心，支持实时搜索，优先显示待处理请求，并显示 Harness Workspace 分组。聊天区显示当前工作目录；历史文件链接和工具 Diff 按操作发生时的目录定位。可从附件菜单或 @diagnostics 选择当前文件的诊断，Jobs 面板也会保留只读历史记录。

模型、Provider、Preset、插件、日程、Harness Workspace 和模板等原生选择框支持关键词过滤。可用方向键选择结果、回车确认，按 Escape 取消。

通过聊天菜单中的打开 Runtime 终端创建或重新连接 Host PTY。切换会话时保留终端身份，重连时恢复屏幕，关闭视图时请求清理 Host 进程；断线时丢弃未结算输入。它与 IDE 终端上下文功能各自独立。

安装或卸载插件使用 Runtime 官方软件包管理器，支持检查软件包、确认安装或卸载、批准构建脚本、查看进度和取消安装。设置提供网页搜索与抓取配置，自定义提供方可编辑 Runtime schema 定义的模型推理等级。Remote 访问授权会限制聊天操作，读取权限不会自动授予发送消息或回答交互请求的权限。

配置

打开 Settings | Tools | DeepSeek Harness。

| 设置项 | 默认值 | 说明 |
| 命令 / 参数 | auto / 空 | 发现兼容的本机或 Desktop 注册的 dsh；也支持明确配置 pnpm/npx。自动下载独立 Runtime 已弃用。 |
| 服务地址 / 端口 | "" / 0 | 优先连接已运行的 DSH Runtime；本地启动时端口 0 表示自动选择可用端口。 |
| 自动启动 | true | 项目打开时自动启动或连接 Runtime。 |
| 按 Enter 发送消息 | 关闭 | 开启后 Enter 发送、Shift+Enter 换行；两种模式都支持 Ctrl/Cmd+Enter 发送，修改后立即生效。 |
| Runtime 版本 | 0.2.1-rc.2 | 明确配置 pnpm/npx 启动时使用的版本；本机 Runtime 最低支持 0.1.5-rc.1。 |
| 自主调试 | 关闭 | 通过本机 MCP 操作已有 IDE 配置及公共调试能力；开启后需重启插件拥有的 Runtime。 |
| Laya/Jev 集成 | 关闭 | 本地启动 Runtime 随附 System One 集成，可配置地址、模型和可选能力。 |
| npm 镜像 | https://registry.npmmirror.com | 下载后备重试的 Registry 镜像。 |
| 超时 | 启动 30s，请求 600s | 等待启动和单次 RPC 调用的超时时间。 |
| 上下文字节数 | 120000 | 单次请求中 <ide_context> 的最大 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：

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

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

Gradle 从 vendor/dsh-jev-integration 子模块的已编译分发包生成 Jev 打包资源。
父仓库固定子模块 commit，构建前需初始化；打包无需单独安装 npm 依赖或编译 Jev。

数据使用与隐私

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

反馈与贡献

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

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

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