dsh-idea-launcher

在 DeepSeek Harness 里直接读取 IDEA 的运行配置，启动 Java / Spring Boot / Vue 项目并查看彩色日志 —— 不用再切回 IntelliJ。

作者：静音胡闹 ｜版本：v0.1.0 ｜许可：MIT

为什么

用 Harness 开发已有 IDEA 项目时，启动项目和看日志仍然要开 IDEA，两套工具来回切。这个插件把 IDEA 的「读配置 → 启动 → 看日志」三条链路搬进 Harness，不需要重新配置：直接读项目里已有的 .idea/runConfigurations/*.xml、.run/*.run.xml、.idea/workspace.xml，下拉列表里的名字和 IDEA 里一致。

特性

读 IDEA 配置：Spring Boot / Java Application / npm(Vue) / Compound；Before Launch 的 Make、Run 其他配置、打开浏览器
跟随当前项目：默认用会话的 cwd，切换会话即自动换项目；也可手动指定目录
多实例并行：不同配置可同时运行，各自独立进程与日志；配置下拉里有绿点标记运行中
彩色日志：还原 ANSI 16/256/真彩；吸底跟随、清空、复制、可调高度、可切独立浮动窗口
快速启动（默认开）：缓存依赖 classpath + 按需编译 + java -cp 直启，跳过每次的 Maven 生命周期；失败自动回退 mvn spring-boot:run
按项目 SDK 启动：JDK 取自 .idea/misc.xml 的项目 SDK 名 + IDEA 的 jdk.table.xml（不是 PATH 上碰巧那个），并设置 JAVA_HOME/PATH；解析不到会出诊断而不是静默用错版本
诚实的诊断：解析不出来、命令含假设、模块未解析……都会变成可查看的诊断，而不是静默兜底或假装成功

安装

主仓在 GitHub（jyhn-hunao/dsh-idea-launcher），Gitee 镜像：ydcy_studio/dsh-idea-launcher。npm 包名 dsh-idea-launcher 已确认为空闲，待发布。lib/ 构建产物已随仓库提交，克隆后无需构建。

方式一：让 DSH 自己装（推荐）

把下面这段提示词发给任意一个 DSH 会话即可：

帮我安装 dsh-idea-launcher 插件（在 Harness 里读 IDEA 运行配置、启动项目并看彩色日志）：
1. 把 https://github.com/jyhn-hunao/dsh-idea-launcher.git 克隆到一个固定目录，例如 ~/dsh-plugins/dsh-idea-launcher
2. 用 plugin_manager({ action: "install_bundle", target: "<克隆后的绝对路径>" }) 安装
3. 要求返回 application=applied；失败就把错误原文贴给我，不要自己改插件代码
4. 完成后提醒我刷新页面（Host 半更新需要重载插件，仅 Client 半改动刷新即可）

方式二：手动安装

git clone https://github.com/jyhn-hunao/dsh-idea-launcher.git

plugin_manager({ action: "install_bundle", target: "<本仓库绝对路径>" })

方式三：npm

包已发布到 npm（dsh-idea-launcher，latest 跟随最新版本）：

dsh plugin --profile web add dsh-idea-launcher@latest

版本说明：npm 上的 0.1.0 是最早的可用版本；0.1.1（按项目 SDK 选 JDK）与 0.1.2（中文乱码修复）以仓库 / GitHub 为准，若 npm 版本滞后，请用方式一或方式二装到最新。

装完硬刷新浏览器（Ctrl/Cmd+Shift+R）。Host 半改动需要重载插件；只改 Client 半刷新页面即可。

依赖：Node ≥ 20；被启动的项目自己需要 java / mvn / npm 等工具链，插件不代装。

快速开始

打开一个会话（会话的 cwd 就是被启动的项目根），或手动指定项目根；
点顶栏控件里的「配置名 ▾」，从下拉里选一个 IDEA 运行配置（带类型图标，可搜索）；
点 ▶ 启动，底部/浮动日志窗口会立刻出现并实时输出；
运行中：■ 停止当前、⚡ 强制停止当前、[■—] 停止全部；▤ 开合日志窗口；⋯ 看项目根与将执行的命令。

界面

顶栏： [● Grape-Service ▾] [▶/■] [⚡] [■—] [●2] [▤] [⋯]
         选配置           启停  强停  全停  诊断 日志 详情

日志窗口： ● 配置名  运行中 · 12s  [实例 ▾]      ⤓ 🗑 ⧉ ⛶ ⌃ ✕
           [INFO] Starting Grape-Service ...
           [WARN] ...

日志窗口可拖拽上边缘调高度（120–720px，记忆）、可切成独立浮动窗口（拖标题栏移动、拖底边调高）
配置下拉里：含假设（命令含推断成分）、暂不支持（Compound/未识别类型，M6 支持编排）
诊断徽标只在有内容时出现；点开是只读列表

配置

项目根

默认跟随当前会话：Host 用 ctx.sessions.get(sessionId).header.cwd 解析。切换会话即换项目。需要看别的目录时点「改手动」填路径（会记住），随时可切回「跟随会话」。

覆盖层 `.dsh/idea-launcher.json`（项目内，可选）

按 IDEA 配置名覆盖。绝不回写 IDEA 的 XML。

{
  "Grape-Service-本地Nacos": {
    "commandOverride": "mvn -q spring-boot:run -Dspring-boot.run.jvmArguments=\"-Xms2048m -Xmx2048m\"",
    "cwdOverride": "D:/codeData/workData/workCode/grape/grape-service/grape-server",
    "env": { "SPRING_PROFILES_ACTIVE": "dev" },
    "launchMode": "maven"
  }
}

字段	作用
`commandOverride`	整条命令覆盖（走平台 shell 执行），覆盖后不再使用推导命令
`cwdOverride`	覆盖工作目录
`env`	追加/覆盖环境变量
`launchMode`	`fast`（默认，能快则快）/ `maven`（强制走 `mvn spring-boot:run`）

快速启动的缓存

依赖 classpath：<项目根>/.dsh/idea-launcher/classpath-<hash>.txt
classpath / 编译时间戳：<项目根>/.dsh/idea-launcher/state.json
删除 state.json 可强制重建；pom.xml 变更会自动重建 classpath，src/main/java 或 src/main/resources 更新会自动编译一次

工作原理

Host（Harness 进程）
  /configs?path=|sessionId=   解析 .idea/* + 模块解析 + 映射为「启动计划」
  /run                       起实例：快速启动则先准备（classpath/编译）再 spawn，否则直接 mvn/npm
  /stop /stop-all /clear     停止 / 全部停止 / 清空日志
  /logs?id=&since=           增量日志
  /instances /events         实例快照 / 生命周期事件（spawn/stop-request/exit/plugin-unload）

Client（Web UI 插件）
  conversation.session.header.utilities  → 顶栏运行控件
  shell.bottom                           → 日志窗口（可折叠、可浮动）

进程接缝：ctx.subprocess.spawnTerminal（真 PTY）。不用 ctx.shell —— 它没有 pid、kill() 不能发信号，两段式停止无法实现
客户端与 Host 走同源 HTTP（/idea-launcher/api/*），不依赖任何第三方传输层
更完整的背景与设计取舍见 docs/design.md

限制与已知问题

限制	说明 / 绕过
Windows 无法优雅停止	PTY provider 不提供前台进程组与 pid，`SIGINT` 无法投递；停止即 `terminate`，日志与状态会标注「强制」
日志窗口占底部整宽	用的是 `shell.bottom`（三栏下方），会缩短左右栏高度；没有「仅会话列底部」的宿主槽位
快速启动依赖 mtime 判断	极端情况（时钟异常/产物被外部替换）可能误判，删 `.dsh/idea-launcher/state.json` 强制重建
多模块依赖需先安装	兄弟模块没进本地仓库时，先 `mvn -DskipTests install`；日志里也会给这条提示
Gradle 工程无快路径	仍走 `gradlew bootRun`；可类比扩展
Compound 暂不能一键启动	解析完整（含嵌套展开），执行编排在 M6
文案未接 Client locale	目前是中文硬编码

开发

pnpm install
pnpm build       # 产出 lib/index.js（Host, ESM）+ lib/client.js（Client, loader 包装）
pnpm typecheck   # tsc --noEmit
pnpm test        # node --test 跑解析/映射/进程/UI 纯函数回归

lib/ 是必须提交的构建产物：插件按目录安装，装的时候不会替你构建
Client 半的产物是 window.__ModuleLoader__.load({ id: 包名, factory }) 形态，react / react-dom 由浏览器模块表提供
改 Host 半后需要重载插件（禁用再启用 bundle），改 Client 半刷新页面即可

目录结构

src/
  index.ts              Host 入口：路由、实例注册、快速启动准备
  client.ts             Client 入口：两个槽位注册
  types.ts              共享类型（IdeaConfig / LaunchPlan / Diagnostic ...）
  parser/               扫描 .idea、解析配置、模块解析（.idea + Maven）、Compound、Before Launch、变量
  mapper/               配置 → 启动计划（Spring Boot / npm / Java），覆盖层应用
  runtime/              PTY 进程驱动、实例注册表、日志环、快速启动（classpath 缓存/按需编译）
  config/               覆盖层、项目根解析
  ui/                   顶栏控件、配置下拉、日志窗口、详情、ANSI 解析
test/                   回归用例 + fixtures（真实 IDEA 样本）
scripts/build.mjs       esbuild 构建（Host ESM / Client loader 包装）

FAQ

Q：为什么不用 mvn spring-boot:run 每次都跑？ 慢。实测同一配置热启动：Maven 路径要 ~60s 才起进程，快速启动 1.1s 拉起 java。需要旧行为就把覆盖层设 "launchMode": "maven"。

Q：点了启动没反应？ 看日志窗口第一行：有「启动 …」说明进程已拉起；Maven 首次构建可能几十秒静默（已用 -Dmaven.test.skip=true 缩短）。

Q：为什么停止是「强制」？ 见限制表。Windows 上暂时只能这样，已在 UI 与状态里如实标注。

dsh-idea-launcher

Installation

README