Java 工程师超级工具箱 · DeepSeek Harness 插件

给 DeepSeek Harness 的 Java 工程师一站式插件：6 个确定性 Host 工具 + 输入框下方常驻工具条。 装好即用，零第三方运行时依赖；即使本机没有安装 JDK 也能工作——它会把缺什么、怎么装明确告诉你。

适配 dsh@0.2.2-alpha.2（Desktop / Web GUI），MIT 开源。

English summary — A DeepSeek Harness plugin for Java engineers: a read-only JDK/Maven/Gradle probe, an offline build-file audit, a Spring Boot 3 scaffold generator, a JVM flag calculator, a pattern-level Java code review, and a 24-entry curated snippet library, plus a composer toolbar in the Web UI. No runtime dependencies; MIT licensed.

能力一览

工具	做什么	读写
java_env_probe	扫描 JDK / Maven / Gradle：JAVA_HOME、SDKMAN、asdf、jenv、Homebrew、常见安装目录、PATH、项目 wrapper 与版本固定文件，给出安装与配置建议	只读
java_project_audit	离线审计 pom.xml / build.gradle：Spring Boot 与 Java 版本、依赖清单、BOM 版本覆盖、已知安全下限（log4j、snakeyaml、h2、commons-text…）、javax.* / JUnit 4 遗留引用、源码反模式，附文件行号证据	只读
java_scaffold_spring_boot	生成可编译的 Spring Boot 3 Maven 工程骨架（pom、启动类、健康端点、service、application.yml、JUnit 5 测试、.gitignore、README、Dockerfile），支持 10 种 starter 组合与 dryRun 预览	仅写入指定目录
java_jvm_tune	按内存预算 + 负载画像计算 JVM 参数：堆、收集器（G1/ZGC/Parallel）、容器百分比模式、元空间、OOM 落盘、GC 日志、参数取舍说明与 JAVA_TOOL_OPTIONS 一行式	纯计算
java_review_file	Java 源码模式审查：字符串 ==、BigDecimal(double)、Optional.get、吞异常、printStackTrace、无界线程池、SimpleDateFormat、资源泄漏、SQL 拼接、字段注入、private @Transactional 等，并显式声明它无法判定的部分	只读
java_snippet	24 条可抄用的 Java 工程片段：虚拟线程、record 校验、sealed + 模式匹配、Stream 收集器、CompletableFuture、BigDecimal 金额、JPA N+1、JUnit 5、日志规范、时间 API、JDBC 批量、线程池等	只读

输入框工具条

在有会话的输入框下方常驻一行 Java 工程师工具箱：

• 环境体检 / Spring Boot 骨架 / pom 审计 / 代码审查 / 片段速查：把一条写好的请求填进输入框（若当前槽位不提供 composer 动作则复制到剪贴板并提示粘贴），按 Enter 即由 Agent 调用对应工具。
• JVM 调参：展开小面板，选内存（GiB）、负载画像、JDK、是否容器，实时预览要发送的请求，再「填入输入框」。
• 全部文案走 Client locale（中文 / 英文），配色只用 --dsw-alias-* 主题 token，明暗主题自动适配；不引入任何 Harness Client 包。

Host 侧还会注入一段简短的 system prompt 段落，告诉 Agent 这些工具存在、什么时候用，以及"不要声称构建通过，除非真的跑过"。

安装

git clone https://github.com/flynow-harness/dsh-plugin-java-engineer.git

然后在 DeepSeek Harness 中把本仓库目录的绝对路径交给 plugin_manager：

plugin_manager({ action: "install_bundle", target: "/绝对路径/dsh-plugin-java-engineer" })

安装成功的判据是返回 application: "applied" 且 warnings 为空，然后：

• Agent 工具列表出现 6 个以 java_ 开头的工具；
• 打开一个已有会话，输入框下方出现咖啡杯工具条（若未出现刷新页面）；
• 设置 → 插件 中可看到中文/英文标题、描述与图标。

卸载：plugin_manager({ action: "remove_bundle", target: "@local/java-engineer" })。

使用示例

用 java_env_probe 看看我本机缺什么，并给出 macOS 上的安装命令。
用 java_project_audit 审计当前项目，重点看 Boot 版本、BOM 覆盖和 javax 迁移风险。
用 java_jvm_tune 帮我算一下 8 核 / 8GiB 容器里低延迟服务的 JVM 参数。
用 java_scaffold_spring_boot 在 ~/projects/order-api 生成骨架，先 dryRun 给我看文件清单。
用 java_snippet 讲讲虚拟线程在 IO 密集服务里的正确用法和 pinning 坑。

测试

无需安装任何依赖：

npm test          # 8 组冒烟测试：工具定义、体检、片段、JVM 参数、模板、脚手架、审计、审查
npm run check     # 全部模块的 node --check

测试会创建临时工程并在结束时清理，不联网、不修改仓库文件。CI（.github/workflows/ci.yml）在每次 push / PR 时跑同一套检查。

设计说明

• 确定性优先：除脚手架外全部是只读或纯计算，工具结果可复现、可审阅；不替用户跑构建，也不伪造构建结论。
• 零运行时依赖：Host 侧只用 node: 内置模块，Client 侧只用模块表提供的 React，避免依赖解析失败导致整个插件不激活。
• 失败要显式：路径不存在、目录非空（无 overwrite）、artifactId/包名非法等都会返回明确原因，而不是静默写入。
• 脚手架是起点不是答案：生成物可编译、可运行，但依赖选择与安全基线需再用 java_project_audit 复核。
• UI 与 Host 同源：工具条只负责把自然语言请求交给 Agent，真正的计算始终来自 Host 工具，避免 UI 与工具两套逻辑漂移。

已知边界

• java_env_probe 不执行 java -version / mvn -v：版本来自 JDK 的 release 文件与安装路径推断；Maven/Gradle 版本在非 SDKMAN 安装时可能显示"版本未知"。
• java_project_audit 用轻量正则解析构建文件，不解析完整 Maven/Gradle 模型，也不联网校验 CVE；安全下限表是离线基线，最终以官方公告为准。
• java_review_file 是模式匹配审查，无法证明并发、事务、领域语义正确；报告里已显式列出"需要人工/测试确认"的部分。
• Client 端「填入输入框」依赖槽位提供 inputActions；不可用时降级为复制到剪贴板。
• 本仓库未附带 mvnw，生成的骨架依赖本机或 IDE 提供的 Maven。

目录结构

dsh-plugin-java-engineer/
├── package.json              # bundle patch + client 声明 + 导出/打包清单
├── cordis.patch.yml          # 插入 java-engineer 插件行
├── index.js                  # Host apply：注册 6 个工具 + prompt 段落
├── client.js                 # 输入框下方工具条（React，无 JSX）
├── java/
│   ├── env.js                # 工具链体检
│   ├── audit.js              # 构建文件审计
│   ├── scaffold.js           # 脚手架写入与参数校验
│   ├── spring-templates.js   # Spring Boot 工程文件模板
│   ├── jvm.js                # JVM 参数计算
│   ├── review.js             # 源码模式审查
│   ├── snippet.js            # 片段检索
│   ├── knowledge.js          # 24 条 Java 工程片段库
│   └── util.js               # 文件/路径/表格/输出契约工具
├── test/smoke.test.mjs       # 冒烟测试（无外部依赖）
├── .github/workflows/ci.yml  # CI：语法检查 + 冒烟测试
├── locale/{en,zh}.json       # 插件管理页显示元数据
└── icon.svg                  # 原创图标

贡献

欢迎 issue / PR。提交前请确保 npm test 与 npm run check 通过；新增工具时请同时补一条冒烟测试，并保持"只读或显式声明写入范围"的原则。代码风格是零依赖 ESM + 中文注释，新增依赖前请先讨论必要性。

License

MIT © 2026 flynow-harness