dsh-spring-widget

DSH（DeepSeek Harness）插件：顶栏 IDEA 式 Spring Boot 后端服务管理器

在 DSH 顶栏一键管理你的 Spring Boot 后端：源码直启 / Jar 打包启动 / 停止 / 重启，带实时三页签日志控制台（服务日志 · 请求日志 · 编译输出），无需离开对话即可观察与操作后端进程。

---

📷 界面预览

服务日志	请求日志

配置面板

---

✨ 功能特性

🚀 启动模式

模式	说明
▶ 源码直启	mvn compile 增量编译 + java @argfile 直启主类，无需打包即可运行调试（生成 target/sbsv-args.txt 绕开 Windows 命令行长度限制）
📦 打包并启动	先 mvn clean package -DskipTests（先清理上次打包残余再全新打包），再 java -jar 启动
Jar 启动	直接启动已存在的打包产物（不重复打包）

📺 三页签实时日志控制台

页签	内容
服务日志	应用 stdout/stderr 输出（UTF-8 编码修正，中文不乱码）
请求日志	Tomcat access log —— 每个 HTTP 请求一行：时间 IP 方法 路径 状态:xxx 字节:xxx 耗时:xxxµs
编译输出	Maven 编译/打包进程输出（stdout+stderr 合并）

• 增量拉取：每秒轮询只取新增内容，日志实时滚动
• 跟随滚动：默认自动滚到底部，向上翻页自动暂停跟随
• 清屏：只清当前激活页签的日志内容，保留读取偏移（历史不闪回）
• 复制：一键复制当前页签全部日志

🗂 分组配置面板

• 路径配置：项目目录 / JDK / Maven（留空自动从 PATH 探测）
• 启动配置：主类入口 / 端口 / Jar 名（留空自动识别）
• 自绘目录选择器：面包屑导航 + 子目录列表 + 手动输入路径，支持 JDK 根目录 → 自动补 bin\java.exe
• 配置持久化到 ~/.dsh/spring-widget.json，重启后依然生效

🌙 深浅色主题适配

完整适配 DSH 浅色/深色主题，页签、按钮、标题在深色下清晰可读。

---

📦 安装

从 GitHub Release 安装

dsh plugin add dsh-spring-widget --source github:wrw-dev/dsh-spring-widget

本地开发安装（link 模式，改代码即时生效）

# 在你的 profile package.json 的 dependencies 加入：
#   "dsh-spring-widget": "link:C:/<你的用户名>/.dsh/plugins/dsh-spring-widget"
# 并在 dsh.profile.bundles 数组加入 "dsh-spring-widget"

宿主改动（index.js）需重启 DSH；客户端改动（client/client.js）刷新页面即可生效（webserver 实时下发）。

---

🎮 使用

1. 顶栏右侧出现 后端服务 微件（⚙ 按钮 + 状态点 + 日志入口）
2. 点击微件打开控制台
3. 点击「▶ 源码启动」或「📦 打包并启动」
4. 在「服务日志 / 请求日志 / 编译输出」页签实时观察输出
5. 需要时点「■ 停止」/「⟳ 重启」

💡 首次启动会自动探测项目结构（JDK、Maven、主类、端口），也可在「⚙ 配置」里手动指定。

---

⚙️ 配置项

字段	说明	自动探测
cwd	项目目录（server 目录）	✅ pom.xml / yml 所在
javaPath	JDK 的 java.exe 路径	✅ PATH 中的 java
mavenHome	Maven 根目录	✅ PATH 中的 mvn
mainClass	主类入口	✅ 扫描 @SpringBootApplication
port	服务端口	✅ bootstrap.yml / application.yml
jarName	Jar 文件名	✅ pom.xml finalName / artifactId

配置保存在 ~/.dsh/spring-widget.json：

{
  "cwd": "E:/path/to/project/server",
  "javaPath": "E:/JAVA/JDK/JDK25/bin/java.exe",
  "mavenHome": "F:/Software/Maven/apache-maven-3.9.15",
  "mainClass": "com.example.AppApplication",
  "port": "16110",
  "jarName": ""
}

---

📁 项目结构

dsh-spring-widget/
├── index.js            # 宿主半区：服务管理、子进程、RPC、模型工具 springboot_service
├── client/
│   └── client.js       # 浏览器半区：顶栏微件、控制台 UI、配置面板
├── docs/               # README 截图
│   ├── shot-console.png
│   ├── shot-access.png
│   └── shot-config.png
├── README.md           # 说明（简体中文）
├── README_EN.md        # README（英文 English）
├── cordis.patch.yml    # 插件装配声明
└── package.json        # 插件元数据

---

🔌 模型工具

安装后自动注册工具 springboot_service，通过对话即可操作后端：

springboot_service action=start mode=src                    # 源码直启
springboot_service action=start mode=jar rebuild=true       # 打包并启动
springboot_service action=stop                              # 停止
springboot_service action=status                            # 状态 + 日志尾部

---

🧱 技术实现要点

• RPC 通道：宿主 ctx.connection.rpc.handle('/spring-widget', ...) ↔ 客户端 connection.rpc.call('/spring-widget', ...)（独立频道，不干扰官方 /api）
• 子进程采集：SubprocessCollect 内存尾窗 + spill 完整落盘（重扇区可恢复全量）
• 编码修正：JDK18+ 默认 native 编码 → JVM 参数 -Dstdout.encoding=UTF-8 / -Dstderr.encoding=UTF-8 / -Dlogging.charset.console=UTF-8
• 请求日志：JVM 参数开启 Tomcat access log（-Dserver.tomcat.accesslog.enabled=true），写入 ~/.dsh/spring-widget-access/，由宿主增量读取展示
• Maven 执行：cmd.exe /c <mvn.cmd>（绕开 Node 24 禁止直接 spawn .cmd 的限制）

---

© License

UNLICENSED —— 内部使用。

---

🔗 相关

• DeepSeek Harness
• DSH 插件生态 dsh-plugin