dsh-spring-boot-launcher

DSH Spring Boot Launcher 是面向 Maven Spring Boot 项目的专用启动器。它提供 Agent 工具和 Web 管理面板，用同一套进程管理逻辑完成项目检查、Profile 选择、启停、状态查询和日志查看。

当前版本为 0.1.2 / Alpha，支持从 GitHub 安装，尚未发布 npm 公共包，也不承诺稳定 API。真实项目启停和日志能力已在 Windows 11、PowerShell 7 环境验证；官方 DSH 桌面版的连接适配已加入，仍需真实工程端到端验收。

功能

• 发现项目：识别 Maven 工程及多模块结构中的 Spring Boot 应用。
• 检查运行条件：解析入口类、Spring Profile、端口、JDK 和构建产物状态。
• 集中启停：在管理面板中选择 Profile，启动或停止由插件托管的服务。
• 实时日志：通过 WebSocket 查看日志，并写入项目的 logs/dsh-spring-boot-launcher.log。
• 运行模式决策：根据源码和构建产物的新旧程度选择 jar-run、direct-classpath 或编译后启动。
• 多模块处理：优先复用工作区兄弟模块产物，并处理常见 classpath 冲突。
• 原生认证：复用 DSH 登录状态和同源 HTTP/WS 通道，不建立第二套令牌系统。

兼容性

“尚未验证”不代表确定无法运行，但在完成真实环境验证前不会宣传为受支持平台。

DSH 接口兼容

进程执行优先使用新版 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 与面板同时加载新代码。

示例：

检查 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 不开放额外监听端口。

安全边界

• 只启动可信工程。Maven 构建脚本和 Spring Boot 进程以当前用户权限运行，不是隔离沙箱。
• 控制通道只允许 DSH 本机回环、同源且已登录的请求。
• 日志可能包含应用输出的凭据或业务数据，公开 Issue 前必须脱敏。
• 插件不会主动终止未确认归属的端口占用进程。

完整说明和报告方式见 SECURITY.md。

开发与测试

在仓库根目录运行：

npm ci --ignore-scripts --no-audit --no-fund
npm test

测试使用临时 Maven 工程和宿主替身，不要求本机安装 DSH、Maven 或 JDK，也不会执行 Java 或前端 build。Windows CI 配置位于 .github/workflows/test.yml。

已知限制

• 端口占用只能说明存在监听进程，不能证明它属于当前项目。
• 跨 DSH 会话的进程恢复、复杂 Maven 属性继承和更多配置格式仍需完善。
• Gradle 与 Linux/macOS 尚未进入当前支持范围。
• 现阶段通过 GitHub 源码安装根 bundle，尚未发布 npm 公共包。

参与贡献

欢迎提交脱敏的最小复现、问题说明和回归测试。请先阅读 CONTRIBUTING.md，不要提交真实业务工程、访问凭据或未经审查的日志和截图。

许可证

Apache License 2.0。项目名称中的 DSH / DeepSeek Harness 仅用于说明集成对象，不表示官方背书。