Deepseek Harness For IDE 将 DeepSeek Harness 的对话、会话、工具审批、目标与计划、 子智能体、Workflow 和 Cordis 工具面板嵌入 JetBrains IDE，并把文件打开、代码 Diff、 编辑器选区与项目工作区交给 IDE 原生能力处理。

当前版本：插件 0.1.20 · 内置 DeepSeek Harness v0.1.5-rc.2 · Windows x64

---

安装

JetBrains Marketplace（推荐）

在 IDE 的 Settings → Plugins → Marketplace 中搜索 Deepseek Harness For IDE， 或打开插件商店页面安装。 安装完成后按提示重启 IDE。

从本地 ZIP 安装

1. 从 GitHub Releases 下载 deepseek-harness-jetbrains-<version>.zip，或按本地构建生成安装包；
2. 打开 Settings → Plugins，点击齿轮菜单并选择 Install Plugin from Disk…；
3. 直接选择 ZIP（无需解压），按提示重启 IDE。

打开项目后，右侧的 Deepseek Harness For IDE 工具窗口会启动项目专属服务。 升级插件不会清除项目隔离目录中的会话与设置。

环境要求

• JetBrains IDE 2024.3–2026.2（since-build 243 / until-build 262.*）；
• Node.js 22.19.x 或 24+；插件内置 DSH，但不默认内置 Node.js；
• DeepSeek API Key：可直接在内嵌界面的 设置 → 模型 中配置；已有 ~/.dsh 配置时，项目隔离环境会单向继承凭据与基础设置。

内置 DSH 包含 node-pty、sharp 等原生依赖，当前安装包面向 Windows x64。 默认命令 dsh 优先解析插件内置、经过兼容验证的固定版本；只有在 IDE 设置中明确填写 外部路径或命令时，才会使用外部 DSH。

已实现功能

完整 DSH 界面

• 在 JCEF 工具窗口中运行 DSH Web，支持对话、会话管理、工具审批、目标、计划、 子智能体、Workflow、插件与 Agent 预设；
• 固定内置 DSH v0.1.5-rc.2，构建时校验实际运行时版本，避免误打包旧缓存；
• 按运行时能力使用 --no-open，启动服务时不会额外弹出系统浏览器；
• 工具栏提供启动、停止、重启、恢复默认插件、安装 DSH 插件、反馈和详情入口。

IDE 原生文件体验

• DSH 的 Read、Write、Edit 文件名，变更文件、交付卡片、回答内文件引用和文件侧栏树， 均优先在 IDE 中打开，不使用 DSH 0.1.5 的右侧文档预览器；
• Read 等带行号入口会定位到 IDE 中对应行；目录会定位到 Project 视图；
• Edit 工具行直接使用 DSH 携带的修改前后内容打开 IDE 原生 Diff，不依赖 Git 时序；
• Diff 两侧继承目标文件的语言类型，支持 C#、Java、Kotlin 等 IDE 已识别语言的语法高亮；
• 普通文件在 auto 模式下优先显示 VCS 基线 Diff，无改动时直接进入编辑器；
• AI 从进程外修改已打开文件后，插件会刷新磁盘内容，同时保护未保存的用户编辑。

编辑器与会话联动

• 选中代码或当前行后，通过编辑器右键菜单附加到当前可见 DSH 对话，补充问题后再发送；
• @ 菜单优先展示当前文件和 IDE 已打开标签，并维护可跨页面重连的编辑器快照；
• IDE 项目自动注册为 DSH 工作区，重开项目时恢复对应工作区与历史会话。

项目隔离、插件与预设

• 每个项目默认使用独立 DSH home： %LOCALAPPDATA%\deepseek-harness-jetbrains\dsh-home\<项目>-<hash>；
• 从主 ~/.dsh 单向继承凭据和基础设置，不与外部 dsh web 并发写同一目录；
• 设置 → For IDE 提供同步 Agent 预设、同步 DSH 插件和恢复默认插件；插件同步经过 兼容过滤、启动验证与失败回滚，完成后自动重启项目服务；
• 工具栏可直接安装 npm 包、Git 地址或受限的 dsh plugin --profile web add <包名> 命令，无需全局安装 DSH CLI；
• 重新设计的 For IDE 页面显示插件版本、内置 DSH 版本和构建日期。

运行诊断

• 启动前检查 API Key、Node.js 路径及版本；Windows 下会重新读取用户/系统 PATH；
• 记录服务日志、启动次数、异常退出和运行时长；
• 每个版本显示一次更新公告；反馈入口支持复制插件、DSH、IDE、系统和数据目录诊断信息。

常用操作

操作	位置
对话、审批工具、管理会话	内嵌 DSH 界面
打开 Read / Write 文件	点击工具行文件名 → IDE 编辑器并定位行号
查看 Edit 修改	点击 Edit 文件名 → 带语言高亮的 IDE 原生 Diff
附加编辑器代码	选中代码 → 右键 附加选区到 DeepSeek Harness 对话
安装 DSH 插件	工具窗口顶部的插件安装按钮
同步插件或 Agent 预设	DSH 设置 → For IDE
恢复项目默认插件	工具栏恢复按钮，或 设置 → For IDE → 恢复默认
查看日志和统计	工具栏 Show Details
反馈问题	工具栏反馈按钮，或 设置 → For IDE → 反馈问题

IDE 设置

路径：Settings → Tools → Deepseek Harness For IDE。

设置项	默认值	说明
dsh 命令	dsh	默认优先内置运行时；填写完整路径或明确命令可改用外部 DSH
绑定地址	127.0.0.1	传给 dsh web --host，保持回环地址最安全
端口	0	自动分配空闲端口，避免多项目冲突
文件跳转方式	auto	原生组合层网关优先，TCP 代理回退；也可选 proxy 或 off
文件打开方式	auto	修改文件显示 IDE Diff，否则打开编辑器；file 始终打开编辑器
DSH_HOME 覆盖	空	空表示按项目隔离；default 共用 ~/.dsh；也可填写绝对路径
打开项目时自动启动	开	每个项目启动独立实例
意外退出后自动重启	关	DSH 进程异常退出后自动重新启动

不建议多个 dsh web 实例共用一个 DSH home。默认隔离模式可以避免会话和配置被并发写坏。

当前限制

• DSH v0.1.5-rc.2 新增的 Session 日志导出使用浏览器下载管理器；当前插件尚未为 JCEF 注册 ZIP 下载处理器，因此界面可能显示“已开始下载”但不弹出保存位置；
• 当前内置运行时安装包仅面向 Windows x64。

项目正在活跃开发。已完成改动和兼容性修复见 CHANGELOG.md。

本地构建

需要 JDK 21+。首次构建前先准备固定版本的 DSH npm 缓存：

npx --yes @deepseek-ai/dsh@0.1.5-rc.2 --version
.\gradlew.bat buildPlugin      # build/distributions/deepseek-harness-jetbrains-0.1.20.zip
.\gradlew.bat runIde           # 启动带插件的沙箱 IDE
.\gradlew.bat verifyPlugin     # 验证支持的 IntelliJ Platform 版本

构建参数	作用
-PdshRuntimePath=<目录>	指定包含 node_modules 的 DSH 安装目录
-PskipDshRuntime=true	构建不带内置 DSH 的轻量安装包
-PskipNodeRuntime=false	额外打包 Node.js，可用 -PnodeRuntimePath=<目录> 指定来源

架构

插件由 Kotlin 进程托管层、JCEF 内嵌界面、项目级 HTTP/TCP 代理、JavaScript→IDE 原生桥接 以及固定版本的 DSH Web 运行时组成。详细设计与兼容性说明见 docs/architecture.md。

反馈

• 在工具窗口点击反馈按钮，或前往 GitHub Issues；
• IDE 设置页的 复制诊断信息 会复制插件版本、构建日期、内置 DSH 版本、数据目录、 IDE 与操作系统信息，提交问题时可直接粘贴。

License

MIT，见 LICENSE。插件内置 DeepSeek Harness 运行时（MIT）； Harness 及其商标归各自所有者。