Deepseek Harness For IDE

在 JetBrains IDE 中使用完整的 DeepSeek Harness

English · 简体中文

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

当前版本：插件 0.1.22 · 内置 DeepSeek Harness v0.2.0-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.2.0-rc.2，构建时校验实际运行时版本，避免误打包旧缓存；
• 按运行时能力使用 --no-open，启动服务时不会额外弹出系统浏览器；
• 工具栏提供启动、停止、重启、恢复默认插件、安装 DSH 插件、反馈和详情入口。

IDE 原生文件体验

• DSH 的 Read、Write、Edit 文件名，变更文件、交付卡片、回答内文件引用和文件侧栏树， 均优先在 IDE 中打开，不使用 DSH 的右侧文档预览器；
• 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 并发写同一目录；
• 界面语言可在「设置 → DeepSeek Harness → 界面语言」中选择 自动（默认，中文系统用中文、 其他系统用英文）/ 中文 / 英文；「自动」只决定首次语言，你在 DeepSeek Harness 设置里手动 选择的语言会被保留并在重启 IDE 后继续生效，选择中文或英文则每次启动都强制生效；
• 设置 → For IDE 提供同步 Agent 预设、同步 DSH 插件和恢复默认插件；插件同步经过 兼容过滤、启动验证与失败回滚，完成后自动重启项目服务；
• 工具栏可直接安装 npm 包、Git 地址或受限的 dsh plugin --profile web add <包名> 命令，无需全局安装 DSH CLI；
• 重新设计的 For IDE 页面显示插件版本、内置 DSH 版本和构建日期。

运行诊断

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

常用操作

IDE 设置

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

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

常见问题

• 重启 IDE 后界面语言变了：DSH 的界面语言保存在设置项 locale.preference 中。0.1.7 起 用户设置位于 profiles/web/cordis.patch.yml（旧的 settings.yaml 只导入一次）。插件启动时 会按「界面语言」设置写入该设置项；「自动」只负责首次语言，不会覆盖你在 DeepSeek Harness 设置里选择的语言。需要固定语言时，把「界面语言」改为 中文 或 英文。

当前限制

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

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

本地构建

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

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

架构

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

反馈

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

License

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