liumangmang
48 lines
1.5 KiB
Markdown
48 lines
1.5 KiB
Markdown
# SVN 日志 AI 分析（Web）
|
||
|
||
## 功能说明
|
||
|
||
通过 Web 工作台上传/选择 Markdown 日志，调用 DeepSeek 或 OpenAI 兼容 API 分析并生成 Excel 工作量统计文件。
|
||
|
||
## 启动
|
||
|
||
```bash
|
||
# Docker 一键启动（推荐）
|
||
make up
|
||
```
|
||
|
||
备用方式（本机 Java + Maven）：
|
||
|
||
```bash
|
||
mvn spring-boot:run -Dspring-boot.run.mainClass=com.svnlog.web.WebApplication
|
||
```
|
||
|
||
访问：`http://localhost:18088`
|
||
|
||
## 使用步骤
|
||
|
||
1. 在「SVN 日志抓取」先生成 `.md` 文件
|
||
2. 在「系统设置」选择 AI 提供商：
|
||
- `DeepSeek`：配置 DeepSeek API Key（或使用环境变量 `DEEPSEEK_API_KEY`）
|
||
- `OpenAI兼容`：配置 `Base URL`、`API Key`、第一阶段模型、第二阶段模型
|
||
3. 在「AI 工作量分析」选择 `.md` 文件并发起分析
|
||
4. 在「任务历史」或「产物列表」下载 `.xlsx`
|
||
|
||
## DeepSeek API Key 读取优先级
|
||
|
||
1. 请求中的 `apiKey`（临时传入，优先级最高）
|
||
2. 设置页保存的运行时 `apiKey`
|
||
3. 环境变量 `DEEPSEEK_API_KEY`
|
||
|
||
> **首次启动未配置 API Key 是正常状态。**
|
||
> `/api/settings` 会返回 `apiKeyConfigured: false`，
|
||
> 请前往「系统设置」页面填写 API Key 后保存，或通过环境变量注入。
|
||
|
||
## 注意事项
|
||
|
||
- 不要在源码和日志中写入真实密钥
|
||
- 使用环境变量注入密钥是更安全的做法（尤其在 Docker/CI 环境中）
|
||
- DeepSeek 模式需要可访问 DeepSeek API 的网络环境
|
||
- OpenAI 兼容模式要求兼容服务提供 `/chat/completions` 流式接口
|
||
- 接口调用可能产生费用，建议控制调用频率
|