gunduziba/dsh-tool-open-in-idea

dsh-tool-open-in-idea

⚡️ DeepSeek Harness (DSH) 官方原生侧边栏与界面专属的 IntelliJ IDEA 直连与文件跳转插件，基于 JetBrains Streamable HTTP MCP 协议。

📋 环境与依赖要求

| 依赖项 | 最低版本要求 | 说明 |
| :--- | :--- | :--- |
| DeepSeek Harness (DSH) | >= 0.1.5-rc.1 | 需要 DSH 0.1.5-rc.1+ 的 settings.section 与 slots 客户端插槽机制 |
| Node.js | >= 18.0.0 | 运行时环境 |
| IntelliJ IDEA / JetBrains IDE | 启用 MCP 插件/服务 | 默认端口 64342（可在 DSH 设置面板中可视化修改） |

🌟 核心特性

- 纯原生设计：深度集成 DSH 官方文件树 (ui-sidebar-files)、文档预览顶栏 (ui-sidebar-documentpreview)、会话产出文件胶囊及交付产物卡片。
- 直连 MCP 通信：基于 JetBrains 官方 Streamable HTTP MCP 协议（默认端口 64342），直接与正在运行的 IntelliJ IDEA 实例进行毫秒级 RPC 交互。
- 代码行号精准定位：支持在点击文件胶囊或文档跳转时携带特定行号与列号，自动在 IDEA 中定位并高亮目标代码行。
- 智能路径解析：自动向上探测 Git 仓库根目录，支持绝对路径与工作区相对路径无缝换算与跳转。
- 平滑全域兜底：当目标文件所在项目未在当前 IDEA 中打开时，自动平滑降级为系统原生命令拉起，保障 100% 打开成功率。
- 可视化设置面板：在 DSH 设置页 (settings.section) 中无缝集成专属配置项，支持实时探测 IDEA MCP 连通状态与动态修改端口。
- 全局快捷键支持：随时按下 Cmd + Shift + O (macOS) 或 Ctrl + Shift + O (Windows/Linux) 即可将当前激活文件在 IDEA 中打开。
- TypeScript 强类型架构：全量采用 TypeScript 编写，严格遵循 Cordis 插件规范与高内聚低耦合架构。

🚀 安装与启用

1. 安装至 DSH Web Profile

在 ~/.dsh/profiles/web/package.json 的 dependencies 中引入：

{
"dependencies": {
"dsh-tool-open-in-idea": "^0.1.0"
}
}

或通过 Git 源码引入：

{
"dependencies": {
"dsh-tool-open-in-idea": "github:gunduziba/dsh-tool-open-in-idea"
}
}

2. 启用插件

在 DSH Web Profile 的插件配置文件（如 dsh.config.yml）中添加：

plugins:
dsh-tool-open-in-idea:
port: 64342

🛠 HTTP API 接口

| 路径 | 方法 | 说明 |
| :--- | :--- | :--- |
| /open-in-idea/open | POST | 打开指定文件 { path: string, line?: number, column?: number, cwd?: string } |
| /open-in-idea/status | GET | 查询 IntelliJ IDEA MCP 连通性、就绪状态与当前打开项目列表 |
| /open-in-idea/settings | POST | 动态修改 MCP 监听端口 |

⌨️ 快捷键

- Cmd + Shift + O (macOS) / Ctrl + Shift + O (Windows/Linux)：在 IntelliJ IDEA 中打开当前激活的文件。

📄 开源许可

MIT License