Files
svn-log-tool/release/windows

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 工作量统计


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