dsh-spring-boot-launcher
在 DSH 中发现、启动和管理 Maven Spring Boot 服务，支持 Profile 选择、服务启停和实时日志。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:simplifyOurLife/dsh-spring-boot-launcher#ff5862a38086a726c637e967ef0adf8ec8cd37a1Spring Boot Launcher 以 dsh-spring-boot-launcher 发布，当前版本为 0.1.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
让 DeepSeek Harness 像 IDE 一样发现、启动和管理 Maven Spring Boot 服务
DSH Spring Boot Launcher 是面向 Maven Spring Boot 项目的专用启动器。它提供 Agent 工具和 Web 管理面板，用同一套进程管理逻辑完成项目检查、Profile 选择、启停、状态查询和日志查看。
当前版本为
0.1.2/ Alpha，支持从 GitHub 安装，尚未发布 npm 公共包，也不承诺稳定 API。真实项目启停和日志能力已在 Windows 11、PowerShell 7 环境验证；官方 DSH 桌面版的连接适配已加入，仍需真实工程端到端验收。
logs/dsh-spring-boot-launcher.log。jar-run、direct-classpath 或编译后启动。| 能力 | 当前状态 |
|---|---|
| Windows 11 + PowerShell 7 | 已验证 |
| Maven + Spring Boot | 已验证 |
| Maven 多模块 Spring Boot | 已验证 |
| Gradle Spring Boot | 当前不支持 |
| Linux / macOS | 尚未验证，不属于当前支持范围 |
| 其他服务类型 | 不属于本项目定位 |
“尚未验证”不代表确定无法运行，但在完成真实环境验证前不会宣传为受支持平台。
进程执行优先使用新版 shell.execute()，并保留旧版 shell.run() / shell.start() 回退。短命令等待 result()；Spring Boot 长期进程设置 onExpiry: 'none'，不会因宿主默认执行期限到期而被终止。
已依据 DSH 0.1.7-rc.2 的已发布接口增加自动回归测试，但这不等同于该版本的真实工程端到端验收。升级后仍需在可信工程中验证检查、启动、日志和停止流程。
新版宿主未公开 PID 时，面板不展示 PID，停止操作仅调用插件保存的托管进程句柄，不根据端口猜测进程归属。此路径使用宿主的终止语义，不保证 JVM 执行优雅退出钩子；旧宿主公开 PID 时保留原有的先尝试优雅停止、再强制停止流程。
在已安装 DSH CLI 的环境中执行：
dsh plugin --profile web add github:simplifyOurLife/dsh-spring-boot-launcher
完整重启 DSH，再刷新已登录的本机页面。已有 Agent 会话可能保留旧工具列表；如未看到 spring_boot_* 工具，请新建会话。
仓库只发行一个 dsh-spring-boot-launcher bundle；下面两个目录是内部实现：
dsh-spring-boot-launcher/ Host：项目检查、启动决策、进程与日志
dsh-spring-boot-launcher-ui/ Client：Spring Boot Services 管理面板
源码开发所需的单一 Junction 和 DSH 加载配置见 插件使用说明。
侧栏出现 Spring Boot 后，可以在面板中扫描工作区、选择 Profile 并启动服务，也可以让 Agent 调用以下工具：
在 DSH 插件列表中，本插件显示为 Spring Boot 启动器。打开插件详情，可以查看用途、主要能力、环境要求和日志说明，并通过 打开服务管理面板 按钮进入现有服务面板。详情卡片使用 DSH 的 plugins.bundle.config 插槽；未提供此插槽的旧宿主仍可使用侧栏入口。
日志工具栏的 ↓ 末尾 是跟随开关，默认关闭。点击后按钮高亮并持续滚动到最新日志；再次点击、搜索日志、向上滚动阅读或切换服务会关闭跟随。关闭跟随只停止自动滚动，不停止接收日志。更新插件后请重启 DSH Host / Web 服务或桌面应用，让 Host 与面板同时加载新代码。
| 工具 | 用途 |
|---|---|
spring_boot_inspect | 检查入口类、JDK、Profile 和启动模式 |
spring_boot_start | 准备并启动 Spring Boot 服务 |
spring_boot_status | 查询已托管服务状态 |
spring_boot_logs | 读取服务日志 |
spring_boot_stop | 停止已托管服务 |
示例：
检查 D:\workspace\demo-service，说明推荐的启动模式。
使用 dev profile 启动这个 Spring Boot 服务，端口设为 8081。
查看最近 100 行日志。
停止刚才启动的服务。
Agent 工具 ─────┐
├─> Spring Boot 进程引擎 ─> ctx.shell ─> Maven / JVM
Web 管理面板 ───┘ │
└─> 内存日志缓冲 + 项目日志文件
管理面板通过 DSH 已认证的 /spring-boot-launcher HTTP 路径和 /spring-boot-launcher/ws WebSocket 获取状态及日志。Host 与 UI 不开放额外监听端口。
完整说明和报告方式见 SECURITY.md。
在仓库根目录运行：
npm ci --ignore-scripts --no-audit --no-fund
npm test
测试使用临时 Maven 工程和宿主替身，不要求本机安装 DSH、Maven 或 JDK，也不会执行 Java 或前端 build。Windows CI 配置位于 .github/workflows/test.yml。
欢迎提交脱敏的最小复现、问题说明和回归测试。请先阅读 CONTRIBUTING.md，不要提交真实业务工程、访问凭据或未经审查的日志和截图。
Apache License 2.0。项目名称中的 DSH / DeepSeek Harness 仅用于说明集成对象，不表示官方背书。