Files
svn-log-tool/docs/README_DeepSeek.md
liumangmang a6817fd9bf feat(core): 添加SVN日志查询工具和DeepSeek AI处理功能
- 实现SVN日志查询工具,支持版本范围和用户过滤
- 添加DeepSeek API集成,用于AI分析日志内容
- 创建Excel生成器,输出工作量统计报表
- 添加日志实体类和项目配置管理功能
- 集成POI库支持Excel文件操作
- 实现Markdown格式日志导出功能
2026-02-05 09:11:17 +08:00

3.1 KiB
Raw Blame History

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. 等待处理完成

程序会自动:

  1. 读取markdown日志文件
  2. 调用DeepSeek API分析日志内容
  3. 根据分析结果生成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": "具体工作内容"
    }
  ]
}

注意事项

  1. API Key安全请妥善保管您的DeepSeek API Key不要将其提交到代码仓库中
  2. 网络连接需要能够访问DeepSeek API服务器
  3. 日志格式markdown文件需要由SVN日志工具生成包含完整的日志信息
  4. 成本控制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.11SVN操作
  • Apache POI 5.2.5Excel文件读写
  • OkHttp 4.12.0HTTP客户端
  • Gson 2.10.1JSON处理

许可证

本工具仅供内部使用。