# SVN日志工作量统计工具（DeepSeek版）

## 功能说明

这个工具可以根据SVN日志的markdown文件，调用DeepSeek API分析日志内容，并生成符合格式要求的工作量统计Excel文件。

## 使用步骤

### 1. 准备SVN日志markdown文件

使用原有的SVN日志工具生成markdown文件：
```bash
java -jar svn-log-tool-1.0.0-jar-with-dependencies.jar
```

按照提示输入SVN仓库地址、账号、密码等信息，生成markdown格式的日志文件。

### 2. 运行DeepSeek日志处理工具

```bash
java -cp target/svn-log-tool-1.0.0-jar-with-dependencies.jar com.svnlog.DeepSeekLogProcessor
```

或者使用Maven运行：
```bash
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`中，可以修改以下配置：

```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格式返回工作量统计：

```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可能产生费用，请注意控制使用频率

## 故障排查

### 编译错误
```bash
mvn clean package -DskipTests
```

### 运行时找不到主类
确保使用正确的jar文件：
```bash
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处理

## 许可证

本工具仅供内部使用。