svn-log-tool/docs/README_DeepSeek.md

SVN 日志 AI 分析（Web）

功能说明

通过 Web 工作台上传/选择 Markdown 日志，调用 DeepSeek 或 OpenAI 兼容 API 分析并生成 Excel 工作量统计文件。

启动

# Docker 一键启动（推荐）
make up

备用方式（本机 Java + Maven）：

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 流式接口
• 接口调用可能产生费用，建议控制调用频率