JayZz210l/deepseek-harness-for-ide
把 DeepSeek Harness 完整搬进 JetBrains IDE：智能体对话、工具审批、目标与计划、子智能体与 Workflow。装插件、配一次 API Key，即可对话。DeepSeek Harness — agent chat, tool approvals, goals, subagents & workflows — embedded in your JetBrains IDE. Install, set your API key once, and chat.
安装Install
dsh plugin --profile web add github:JayZz210l/deepseek-harness-for-ide把 JayZz210l/deepseek-harness-for-ide 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
DeepSeek Harness 是 DeepSeek 的智能体编程工作台——智能体对话、工具审批、目标与计划、 子智能体、Workflow 与 Cordis 工具链。本插件把完整的 Harness 内嵌到 IDE 工具窗口： 装上插件、配置一次 API Key，即可直接在 IDE 里对话。
安装
从本地 zip 安装（硬盘安装）
- 从 Releases 页面下载
deepseek-harness-jetbrains-<version>.zip（或自行构建，见本地构建）； - 打开 IDE：Settings → Plugins（Ctrl+Alt+S，或 File → Settings）；
- 点击 Marketplace 旁的 ⚙ 齿轮，选择 Install Plugin from Disk…；
- 选中下载的 zip，点 OK；
- 按提示重启 IDE；
- 打开任意项目——右侧出现 Deepseek Harness For IDE 工具窗口并自动启动本地服务。
升级：用同样方式安装新版 zip 即可覆盖升级，各项目的会话与设置保持不变。
从 JetBrains Marketplace 安装
在 Settings → Plugins → Marketplace 搜索 Deepseek Harness For IDE 安装即可， 版本号与 GitHub Releases 一致。
核心特性
完整 Harness，原生内嵌
- 内嵌完整 DSH Web 界面——智能体对话、会话管理、工具审批、文件 Diff、目标与计划、 子智能体、Workflow、Cordis 工具面板，全部跑在工具窗口的 JCEF 浏览器里；DSH 升级自动 获得新界面能力；
- 免装 dsh——运行时（整个
node_modules依赖闭包）内置在插件里。仅要求 Node.js 18+， 缺失时插件会检测并弹窗一键跳转 nodejs.org 下载。
IDE 深度集成
- 工作区 = IDE 项目——页面加载前就把项目目录登记为工作区并置顶；重开工程时确定性
落在会话最多的那个工作区，历史对话不散落；启动时自动同步
~/.dsh/.agent-presets并在必要时预置空白会话，兼容新版 DSH「最近活跃」的工作区自动选中策略； - 不弹外部网页——新版
dsh web默认拉起系统浏览器，插件按运行时能力自动传--no-open（外部 dsh 用一次性的web --help探测，旧版 dsh 不受影响）； - 文件跳转到 IDE——界面里的"打开文件"直接落到 IDE 编辑器（DSH 组合层原生网关实现，
启动失败自动回退 TCP 代理；
--patch参数布局兼容新旧 DSH 启动器）； - IDE 原生 Diff——文件有 VCS 改动时，打开的是 IDE 并排 Diff（对比 VCS 基线）， 而不是普通编辑器；
- 编辑器选区直发——右键把选中代码（或当前行）作为消息发给 DSH，自动启动服务、 定位会话并唤起侧边栏。
数据安全与隔离
- 每项目隔离数据——每个项目独立 DSH home，启动时从
~/.dsh单向继承凭据与设置， 绝不触碰外部浏览器中运行的dsh web（DSH 当前版本多实例共用 home 不安全）； - 启动自检——API Key 预检（缺失弹窗引导）、Node.js 18+ 可执行/版本校验（Windows 实时刷新用户/系统环境，安装 Node 晚于 IDE 启动也不会误报）与下载引导、每版本一次的 更新公告（含更新日期与内容）；
- 一键同步插件与预设——在终端用
dsh plugin --profile web add <包名>安装到~/.dsh的插件，以及~/.dsh/.agent-presets下自建的 Agent 预设，可在内嵌界面 设置 → For IDE → 同步插件 / 同步预设 一键复制到当前 IDE 项目的隔离数据目录； 插件同步会自动重启服务（失败自动回滚），预设同步无需重启；恢复默认插件 可一键 清空之前同步的插件，回到出厂默认配置。
开发者体验
- DSH 设置页内的「For IDE」栏目——插件信息与反馈链接，经组合层客户端包注入 （真正的 DSH 客户端插件机制）；
- 内置反馈入口——侧边栏工具栏"反馈"按钮 + 设置页"插件信息"区（一键复制诊断信息）；
- 日志与统计——工具窗口底部 Log / Statistics 标签页（启动次数、异常退出、运行时长）；
- 中英双语——界面文案完整支持英文与简体中文。
环境要求
- JetBrains IDE 2024.3+（
since 243 / until 262.*，已实测 IntelliJ IDEA 2024.3、 JetBrains Rider 2026.1 与 PyCharm 2026.2）； - Node.js 18+（DSH 运行时已内置，Node 未内置——缺失时插件会引导下载）；
- DeepSeek API Key：首次在终端跑一次
npx @deepseek-ai/dsh web，在 Models 页面保存DEEPSEEK_API_KEY，插件启动时自动继承。
平台说明：内置 DSH 运行时含原生模块（node-pty、sharp 等），当前构建面向 Windows x64；其他平台上有 PATH 中的系统
dsh时会优先使用它。
使用
| 操作 | 方式 |
|---|---|
| 对话 / 审批工具 / 管理会话 | 全部在内嵌的 Harness 界面中完成 |
| 打开智能体改动的文件 | 聊天中点文件 → IDE 编辑器；有 VCS 改动时打开 IDE 原生 Diff |
| 发送代码给 DSH | 选中代码 → 右键 Send Selection to DeepSeek Harness |
同步 ~/.dsh 中的插件 / 预设 |
内嵌界面 设置 → For IDE → 同步插件 / 同步预设 |
| 恢复默认插件 | 内嵌界面 设置 → For IDE → 恢复默认插件 |
| 启动 / 停止 / 重启服务 | 工具窗口工具栏按钮 |
| 日志与统计 | 工具栏 Show Details → Log / Statistics 标签页 |
| 报告问题 | 工具栏 反馈 按钮，或 设置 → Deepseek Harness For IDE → 反馈 / 复制诊断信息 |
设置
设置 → 工具 → Deepseek Harness For IDE：
| 设置项 | 默认值 | 说明 |
|---|---|---|
| dsh 命令 | dsh |
默认使用内置运行时；PATH 中的 dsh 优先；也可填完整路径（如 C:\nodejs\node.exe C:\...\dsh\lib\bin.js） |
| 绑定地址 | 127.0.0.1 |
dsh web --host，DSH 不支持 0.0.0.0 |
| 端口 | 0（自动） |
0 = 系统自动分配空闲端口（推荐） |
| 文件跳转方式 | auto |
auto = DSH 组合层原生网关 + TCP 代理回退；proxy = 仅 TCP 代理；off = 关闭 |
| 文件打开方式 | auto |
auto = 文件有 VCS 改动时打开 IDE 原生 Diff，否则直接打开；file = 始终直接打开 |
| DSH_HOME 覆盖 | 空（隔离） | 空 = 按项目隔离（%LOCALAPPDATA%\deepseek-harness-jetbrains\dsh-home\<项目>-<hash>，推荐）；default = 继承 IDE 环境（与外部 dsh web 共用 ~/.dsh，多实例不安全，不推荐）；绝对路径 = 指定目录 |
| 打开项目时自动启动 | ✅ | 每个项目一个独立实例 |
| 进程意外退出后自动重启 | ❌ | 开启后崩溃自动拉起 |
⚠️ 多个
dsh web共用同一 DSH home 时并发写会话/配置可能互相破坏（DSH 当前版本 不保证多实例安全）。默认的按项目隔离让插件与外部实例完全独立。
项目状态
项目正在活跃开发中。版本历史与迭代进展见 CHANGELOG.md。
本地构建
前置：JDK 17+（推荐 21/22）。首次构建会下载 IntelliJ 平台依赖，并从本机 npx 缓存打包
DSH 运行时——请先跑一次 npx --yes @deepseek-ai/dsh@0.1.1-rc.1 --version 保证有可用安装。
.\gradlew.bat buildPlugin # → build/distributions/deepseek-harness-jetbrains-0.1.13.zip
.\gradlew.bat runIde # 带插件的沙箱 IDE 调试
.\gradlew.bat verifyPlugin # 上架前的平台验证
构建选项：
| 参数 | 作用 |
|---|---|
-PdshRuntimePath=<目录> |
指定要打包的 dsh 安装（含 node_modules 的目录） |
-PskipDshRuntime=true |
跳过内置运行时，产出轻量包 |
-PskipNodeRuntime=false |
重新启用内置 Node.js（-PnodeRuntimePath=<目录> 指定来源） |
架构
插件 = 进程托管层（Kotlin）+ 内嵌浏览器（JCEF）+ DSH 官方 Web 前端。
完整设计、组合层补丁逆向要点（网关重建、ctx.provide 谓词陷阱、h2c 升级陷阱、
「For IDE」栏目的客户端模块注入）、按项目数据目录方案见
docs/architecture.md。
路线图
- 多项目共享一个 DSH 实例（可选模式）
- 目录选择器 IDE 化（接入 IDE 原生对话框）
- 基于
dsh --profile headless的单次任务执行 - 上架 JetBrains Marketplace
反馈
- 工具窗口 → 反馈（或 设置 → Deepseek Harness For IDE → 反馈 BUG / 问题）；
- 反馈地址在
DshFeedback.kt的FEEDBACK_URL常量中； - 设置页的 复制诊断信息 会快照版本、构建日期、内置 DSH 版本、数据目录、IDE 与 操作系统——反馈时直接粘贴。
License
MIT —— 见 LICENSE。插件内置了 DeepSeek Harness 运行时（MIT）； Harness 及其商标归各自所有者。
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
nexu-io/open-design
🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your…
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
esengine/DeepSeek-Reasonix
DeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…