liumangmangSVN/Git 日报周报月报一键生成 - macOS / Linux 使用说明 ==================================================== 一、环境要求 ----------- - macOS 10.12+ 或 Linux（Ubuntu/CentOS/Debian 等） - Java 8 或更高版本（JRE 即可） 安装 Java： macOS (Homebrew): brew install openjdk@8 Ubuntu / Debian: sudo apt install openjdk-8-jre CentOS / RHEL: sudo yum install java-1.8.0-openjdk 二、使用方法 ----------- 1. 打开终端，进入本目录 2. 执行启动脚本： ./start.sh 3. 浏览器打开 http://localhost:18088 4. 在 Web 工作台中操作 三、AI 工作量分析（可选） ----------------------- 如需使用 AI 自动分析功能： 1. 访问 https://platform.deepseek.com 获取 API Key 2. 在 Web 工作台 → 系统设置 → 填入 API Key 3. 生成报表时勾选"启用 AI 摘要" 不配置 API Key 也可正常使用基础报表功能。 四、常见问题 ----------- Q: 提示 Permission denied？ A: 执行 chmod +x start.sh 赋予执行权限。 Q: 端口 18088 被占用？ A: 关闭占用该端口的程序，或在 jar 同目录下创建 application.properties 文件，添加 server.port=8080 Q: 输出文件在哪里？ A: 在 start.sh 同目录的 outputs/ 文件夹下。 五、技术支持 ----------- 如有问题，请联系卖家获取支持。