- 实现SVN日志查询工具,支持版本范围和用户过滤 - 添加DeepSeek API集成,用于AI分析日志内容 - 创建Excel生成器,输出工作量统计报表 - 添加日志实体类和项目配置管理功能 - 集成POI库支持Excel文件操作 - 实现Markdown格式日志导出功能
3.1 KiB
3.1 KiB
SVN日志工作量统计工具(DeepSeek版)
功能说明
这个工具可以根据SVN日志的markdown文件,调用DeepSeek API分析日志内容,并生成符合格式要求的工作量统计Excel文件。
使用步骤
1. 准备SVN日志markdown文件
使用原有的SVN日志工具生成markdown文件:
java -jar svn-log-tool-1.0.0-jar-with-dependencies.jar
按照提示输入SVN仓库地址、账号、密码等信息,生成markdown格式的日志文件。
2. 运行DeepSeek日志处理工具
java -cp target/svn-log-tool-1.0.0-jar-with-dependencies.jar com.svnlog.DeepSeekLogProcessor
或者使用Maven运行:
mvn exec:java -Dexec.mainClass="com.svnlog.DeepSeekLogProcessor"
3. 按照提示输入信息
程序会依次提示输入:
- markdown日志文件路径:可以直接回车使用当前目录下最新的
svn_log_*.md文件 - DeepSeek API Key:请提供有效的DeepSeek API Key(也可以直接在代码中修改
API_KEY常量) - 输出Excel文件名:可以直接回车使用默认文件名(格式:
YYYYMM工作量统计.xlsx)
4. 等待处理完成
程序会自动:
- 读取markdown日志文件
- 调用DeepSeek API分析日志内容
- 根据分析结果生成Excel文件
生成的Excel文件格式与202512工作量统计_刘靖.xlsx保持一致。
Excel文件格式说明
生成的Excel文件包含以下列:
- 序号
- 所属班组
- 技术对接
- 开发人员
- 工作周期
- 开发项目名称
- 具体工作内容
- 空列(4个)
DeepSeek API配置
在DeepSeekLogProcessor.java中,可以修改以下配置:
private static final String DEEPSEEK_API_URL = "https://api.deepseek.com/chat/completions";
private static final String API_KEY = "YOUR_DEEPSEEK_API_KEY"; // 请替换为实际的API Key
提示词说明
工具会向DeepSeek发送以下提示词,要求AI以JSON格式返回工作量统计:
{
"team": "所属班组",
"contact": "技术对接人",
"developer": "开发人员",
"period": "工作周期 (例如: 2025年12月)",
"records": [
{
"sequence": 1,
"project": "项目名称",
"content": "具体工作内容"
}
]
}
注意事项
- API Key安全:请妥善保管您的DeepSeek API Key,不要将其提交到代码仓库中
- 网络连接:需要能够访问DeepSeek API服务器
- 日志格式:markdown文件需要由SVN日志工具生成,包含完整的日志信息
- 成本控制:DeepSeek API可能产生费用,请注意控制使用频率
故障排查
编译错误
mvn clean package -DskipTests
运行时找不到主类
确保使用正确的jar文件:
java -cp target/svn-log-tool-1.0.0-jar-with-dependencies.jar com.svnlog.DeepSeekLogProcessor
API调用失败
- 检查API Key是否正确
- 检查网络连接是否正常
- 检查DeepSeek API服务是否可用
依赖说明
项目使用以下主要依赖:
- SVNKit 1.10.11:SVN操作
- Apache POI 5.2.5:Excel文件读写
- OkHttp 4.12.0:HTTP客户端
- Gson 2.10.1:JSON处理
许可证
本工具仅供内部使用。