SVN/Git 日报周报月报一键生成 - Windows 使用说明
================================================

一、环境要求
-----------
- Windows 7 / 10 / 11
- Java 8 或更高版本（JRE 即可）

如果尚未安装 Java，请访问以下地址下载：
  https://adoptium.net/
  选择 "JRE 8 (LTS)" → Windows x64 → 下载安装

安装后在命令行输入 java -version 确认安装成功。


二、使用方法
-----------
1. 双击 start.bat 启动服务
2. 浏览器打开 http://localhost:18088
3. 在 Web 工作台中操作：
   - 选择仓库类型（SVN 或 Git）
   - 选择报表周期（日报/周报/月报）
   - 填写仓库信息，点击"生成"
4. 生成的报表在 outputs/ 目录下


三、AI 工作量分析（可选）
-----------------------
如需使用 AI 自动分析功能：
1. 访问 https://platform.deepseek.com 注册并获取 API Key
2. 在 Web 工作台 → 系统设置 → 填入 API Key
3. 生成报表时勾选"启用 AI 摘要"

不配置 API Key 也可正常使用基础报表功能。


四、常见问题
-----------
Q: 双击 start.bat 闪退？
A: 右键 start.bat → 以管理员身份运行，查看错误信息。
   通常是 Java 未安装或未加入 PATH。

Q: 端口 18088 被占用？
A: 关闭占用该端口的程序，或修改 jar 同目录下的
   application.properties 中的 server.port。

Q: SVN 连接失败？
A: 检查 SVN 地址、用户名、密码是否正确。
   确认网络可以访问 SVN 服务器。

Q: 输出文件在哪里？
A: 在 start.bat 同目录的 outputs/ 文件夹下。
   - outputs/md/     Markdown 报表
   - outputs/excel/  Excel 工作量统计


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