oci-portal/CHANGELOG.md

Changelog

格式遵循 Keep a Changelog，版本号遵循语义化版本。

[0.2.0] - 2026-07-10

Added

• AI 网关模型池自愈：同步与每日探测后自动逐个试调验证模型可用性（maxTokens=1），不可按需调用的模型（微调基座 / 区域未开放按需供给）自动标记并从模型列表、路由与探测候选中剔除；已标记模型每 20 小时复检，OCI 恢复供给后自动解除标记。ai_model_caches 新增 unusable / unusable_reason / checked_at（启动自动迁移），渠道详情接口保留标记行与原因便于排查

Changed

• 后台任务「立即执行」改异步触发：接口立即返回 202，执行结果经任务日志轮询呈现；同一任务在途时重复触发返回 409「任务正在执行中」，与 cron 重叠触发静默跳过（此前同步阻塞数十秒且同一任务可并发重复执行）
• 渠道探测候选跨厂商分散（上限 8，voice 等不可对话形态排除）：单一厂商在区域内全为微调基座时不再拖垮整个渠道的探测结论
• 网关调用（对话 / 流式 / 向量化）遇「模型不可按需调用」类错误（微调基座 400 / 实体不存在 404）自动标记该模型并换渠道重试，且不计入渠道熔断；仅鉴权类错误才判定租户无配额
• 同名模型多条目去重优先保留非微调基座条目，降低缓存到不可调用 OCID 的概率

Fixed

• 渠道「同步模型成功但探测报错不可用」：法兰克福等区域的微调基座模型占满探测候选导致的误报（探测状态与真实可用性不符的根因）
• 租户删除：告警命中清理改子查询，日志事件数万条时不再超出 SQL 绑定变量上限导致删除失败；无法解析的任务 payload 记警告跳过并保留原任务，不再永久阻断租户删除

[0.1.0] - 2026-07-10

Added

• 通知渠道扩展：Webhook（Slack / 飞书 / 钉钉 / 企微预设）、ntfy、Bark、SMTP 邮件与 Telegram 五渠道并存，逐渠道推送互不影响，密钥加密落库
• 审计告警规则：按租户 / 事件 / 资源 / 来源 IP（CIDR in|notin）组合匹配，阈值窗口计数与冷却，命中即推送模板通知
• 撤销全部会话：POST /auth/revoke-sessions 使全部旧令牌立即失效，响应携带操作者的新令牌
• 租户暂停状态识别：测活经账户 capabilities 判定 suspended，独立于存活 / 失效展示
• 抢机成功通知补全实例明细：租户别名、区域别名、类型与配置、镜像、公网 IPv4 与 root 密码

Changed

• 敏感身份操作（修改凭据、TOTP 开关、外部身份绑定 / 解绑、密码登录开关）成功后令牌版本递增：全部旧 JWT 立即失效，响应返回新令牌无感续期（原 204 改为 200 + token）
• 管理员徽标与管理员组识别支持双候选组名（Administrators / OCI_Administrators）
• Release 流程：前端产物版本由 DASH_VERSION 显式固定并做 sha256 校验，二进制附 SHA256SUMS；docker-compose 示例默认只绑定 127.0.0.1
• README 新增「反向代理」小节（Caddy / nginx / Traefik 示例与路由前缀清单）

Fixed

• 删除租户改为单事务清理全部关联本地数据（任务及日志、测活 / 成本快照、回传事件、告警规则、AI 渠道、Webhook 密钥），等待在途任务执行结束，迟到写入不再残留孤儿数据

Security

• 实例 root 密码收敛：实例详情默认掩码、点击查看，串口控制台不再提供「复制 root 密码」
• JWT 令牌版本机制：凭据 / TOTP / 外部身份 / 登录策略变更即失效全部旧令牌
• HTTP 入口加固：显式读写超时与优雅关闭、请求体上限（面板 1MB / AI 网关 10MB）、登录字段长度上限、登录守卫条目数有界
• 出错响应脱敏：内部错误只返回固定文案 + requestId，完整原因写服务端日志；GORM SQL 日志参数化输出，不再记录实参

[0.0.1] - 2026-07-09

首个版本：自托管 OCI 多租户管理面板后端。

Added

• 多租户管理：OCI API Key 配置集中管理（AES-256-GCM 加密落库）、分组、批量测活、账户画像
• 资源管理：实例、网络（VCN/子网/安全列表/IPv6）、块存储、限额与成本，多区域/多区间
• 自动化任务：抢机、测活、成本同步、AI 渠道探测四类 cron 任务，支持熔断与执行日志
• 网页控制台：串行控制台（xterm）与 VNC（noVNC），两跳 SSH 隧道
• AI 网关：OpenAI / Anthropic 兼容端点转发 OCI GenAI，号池负载均衡、熔断探测、密钥与用量日志
• 日志回传：OCI Audit 事件经 Connector Hub → Notifications HTTPS 订阅入库，一键创建链路
• 租户治理：IAM 用户/MFA/API Key、密码策略、SAML 身份提供商、通知收件人
• 登录安全：JWT + bcrypt、TOTP、OIDC/GitHub 外部登录、登录锁定、IP 限速、操作审计；Telegram 模板化通知