SVN/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/ 文件夹下。


五、技术支持
-----------
如有问题，请联系卖家获取支持。
