workbuddy依赖本地java环境，仅支持jdk 11.0.12+（推荐jdk 17.0.8 lts），禁用jdk 8及以下和jdk 21+非lts版本；需验证java -version与java_home配置，再按系统离线安装并正确设置path。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy作为一款基于Java开发的桌面辅助工具，其运行确实依赖于本地Java运行环境。若系统未安装符合要求的JDK或JRE，程序将无法启动，并可能报出“No Java Runtime Environment found”或“UnsupportedClassVersionError”等错误。以下是针对JDK版本要求与安装的具体说明：
一、JDK版本兼容性要求
WorkBuddy官方明确限定仅支持特定范围内的JDK版本，过高或过低均会导致类加载失败或功能异常。该工具基于Java 11语法特性开发，并使用了部分Java 17中引入的标准API扩展，因此必须满足最低版本门槛且避免使用预发布版。
1、最低支持版本为JDK 11.0.12（含）以上。
2、推荐使用JDK 17.0.8 LTS长期支持版本。
3、禁止使用JDK 21及以上非LTS版本，以及所有JDK 8及更早版本。
二、验证当前JDK安装状态
在执行安装前，需确认系统是否已部署合规JDK并正确配置环境变量。此步骤可避免后续运行时因PATH或JAVA_HOME指向错误而引发的启动失败。
1、打开终端（Windows为命令提示符或PowerShell，macOS/Linux为Terminal）。
2、输入命令：java -version，检查输出是否显示JDK 11.0.12或JDK 17.x.x格式版本号。
3、输入命令：echo %JAVA_HOME%（Windows）或echo $JAVA_HOME（macOS/Linux），确认路径指向JDK根目录而非JRE目录。
三、手动安装JDK 17.0.8（离线方式）
当系统无可用JDK或版本不匹配时，需下载并安装指定版本。采用离线安装可绕过网络策略限制，确保二进制文件完整性。
1、访问Adoptium官网（https://adoptium.net/zh-CN/temurin/releases/）并定位至JDK 17.0.8+7发布页。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、根据操作系统选择对应安装包：Windows x64 MSI、macOS aarch64 PKG或Linux x64 TAR.GZ。
3、运行安装程序（Windows/macOS）或解压至/usr/lib/jvm/（Linux），完成后执行环境变量写入操作。
四、配置JAVA_HOME与PATH（Linux/macOS）
安装完成后，必须将JDK路径注入系统级环境变量，否则WorkBuddy进程无法识别有效运行时。该配置直接影响shell会话及图形界面应用的Java上下文。
1、编辑用户级配置文件：nano ~/.bashrc（bash）或nano ~/.zshrc（zsh）。
2、在文件末尾追加两行：export JAVA_HOME=/usr/lib/jvm/temurin-17-jdk-amd64（路径依实际安装位置调整）；export PATH=$JAVA_HOME/bin:$PATH。
3、执行source ~/.bashrc（或对应shell配置文件）使变量立即生效。
五、配置JAVA_HOME与PATH（Windows）
Windows平台需通过系统属性面板修改环境变量，确保所有用户会话（包括快捷方式启动的WorkBuddy）均可读取到正确JDK路径。
1、右键“此电脑”→“属性”→“高级系统设置”→“环境变量”。
2、在“系统变量”区域点击“新建”，变量名为JAVA_HOME，变量值为C:\Program Files\Eclipse Adoptium\jdk-17.0.8.7-hotspot（路径以实际安装路径为准）。
3、在“系统变量”中找到Path，点击“编辑”，新增一项：%JAVA_HOME%\bin。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
