docs: v1.5.7 动态API提供商管理,OpenCode Go集成,Bug修复

This commit is contained in:
hmo
2026-05-05 15:53:24 +08:00
parent ea29c77fe3
commit 30fbe92b9a
11 changed files with 594 additions and 231 deletions
+44 -4
View File
@@ -1,11 +1,50 @@
# 钢琴练习方案系统 - 部署 SOP
> 版本:v1.5.6
> 日期:2026-04-30
> 版本:v1.5.7
> 日期:2026-05-05
> 核心原则:**不删除,只备份后新增/替换**
---
## 重要更新(v1.5.7
### 🔧 动态API提供商管理
新增 API 提供商的新增、编辑、删除功能,替代原有的硬编码列表:
**功能特点:**
- 新增提供商:填写ID/名称/Endpoint/模型列表
- 编辑提供商:修改名称/Endpoint/模型列表(ID不可改)
- 删除提供商:移除不再使用的提供商
- 多模型支持:每个提供商可配置多个模型(>1个显示下拉框)
**OpenCode Go 预置配置:**
- Endpoint`https://opencode.ai/zen/go/v1`
- 模型:`deepseek-v4-pro``deepseek-v4-flash``qwen3.6-plus`
**API 接口:**
- `GET /api/config/providers` - 列出所有提供商
- `POST /api/config/providers` - 新增提供商
- `PUT /api/config/providers/<id>` - 编辑提供商
- `DELETE /api/config/providers/<id>` - 删除提供商
### 🐛 Bug 修复
- 问题删除字段名错误(`problem_db_id``problem_id`
- 学员模型回退属性不存在(`problem_name` → "未知问题"
- 删除问题提示文案过时
- API Key 留空时保存报错(已有 key 则复用)
- AI 失败时仍弹"方案生成成功"
- API 超时 60s → 180smax_tokens 2000 → 4096
### 📊 调试增强
- AI 生成日志显示 finish_reason、输入/输出 token 数
- API 返回非 JSON 时显示原始内容和请求 URL
- API 返回空内容时显示详细诊断信息
---
## 重要更新(v1.5.6
### 🔒 安全防护:Nginx 限流配置
@@ -655,6 +694,7 @@ A: 检查是否执行了 migrate_goals_v3.py 迁移脚本,该脚本创建 stud
| 版本 | 日期 | 变更 |
|------|------|------|
| v1.5.7 | 2026-05-05 | 动态API提供商管理(新增/编辑/删除/多模型);OpenCode Go集成;Bug修复(问题删除、空key保存、AI失败弹窗);调试增强 |
| v1.5.6 | 2026-04-30 | Nginx限流配置(防爬虫/恶意请求);每日自动备份(30天保留) |
| v1.5.5 | 2026-04-28 | 修复容器时区(TZ=Asia/Shanghai);学员列表"x个方案"可点击跳转最新方案详情 |
| v1.5.4 | 2026-04-28 | PDF正文字体12pt、表格11pt |
@@ -725,5 +765,5 @@ docker start piano-plan
---
> **最后更新**2026-04-30
> **更新原因**v1.5.6 - Nginx限流配置;每日自动备份
> **最后更新**2026-05-05
> **更新原因**v1.5.7 - 动态API提供商管理;OpenCode Go集成;Bug修复