MAX API v1.0.3 Preview Release Notes

GitHub地址：

https://github.com/MAX-API-Next/MAX-API/releases/tag/v1.0.3-preview

Highlights

v1.0.3 Preview 聚焦企业部署兼容性、AGI 治理审计、渠道可靠性、日志维护能力与后台管理体验优化。

本版本补齐了 SMTP STARTTLS / NTLM、完整登录与管理操作审计、系统任务式日志清理、被动渠道恢复、用户 Token 数量限制 UI、节点身份信息等能力，并修复了用户 ID 搜索、日志清理权限、批量渠道审计名称等问题。

New Features

SMTP STARTTLS / NTLM 支持

• 新增 SMTP STARTTLS 支持，提升 587 端口企业邮箱兼容性。
• 新增 NTLM 认证支持，适配 Exchange、Outlook 等企业邮件系统。
• 支持无账号 SMTP 场景跳过认证。
• STARTTLS 改为机会式协商，并支持强制 STARTTLS 配置。
• 修复邮件发送中 QUIT 返回异常导致“已投递但被判定失败”的问题。

完整登录与管理操作审计链路

• 新增 LogTypeLogin = 7 登录日志类型。
• 登录成功写入结构化审计日志。
• 管理操作写入 op.action / op.params 结构化字段。
• Admin / Root 写接口增加兜底审计能力。
• 前端使用日志支持 type=7 登录日志展示与筛选。
• 审计内容适配用户可见日志审计逻辑，增强用户知情与管理员行为留痕。

系统任务式日志清理

• 新增 SystemTask 持久化任务模型。
• 日志清理改为异步任务执行，支持进度、状态、失败原因查询。
• 运维日志设置页新增日志清理进度展示。
• 保留旧版 DELETE /api/log/ 同步删除兼容接口。
• 修复 PostgreSQL 下批量删除可能不受 LIMIT 限制的问题。
• 修复日志清理任务启动与状态查询权限不一致的问题。

渠道测试与被动恢复

• 新增渠道测试模式配置。
• 支持 passive_recovery 被动恢复模式，只针对真实失败后被自动禁用的渠道进行恢复探测。
• 新增渠道测试相关环境变量开关。
• 减少全量定时探测对上游和系统资源的压力。

用户 Token 数量限制 UI

• 后台设置页新增 Token Limits 配置入口。
• 对接已有 token_setting.max_user_tokens 后端限制能力。
• 管理员可直接在后台配置单用户可创建令牌数量上限。

节点身份与系统实例信息

• NodeName 未配置时自动回退到主机名。
• 新增系统实例信息暴露能力。
• 改善多实例部署下 system task runner、日志清理和节点识别体验。
• 支持清理无效/离线实例信息。

Improvements

用户管理搜索优化

• 用户管理页搜索框支持按用户 ID 搜索。
• 修复后端已返回 ID 命中用户，但前端表格本地过滤又把结果过滤掉的问题。
• 搜索文案更新为“按用户 ID、用户名、姓名或邮箱筛选”。
• 同步更新 en / zh / fr / ja / ru / vi 翻译。
• 修复 React Query 依赖提示，避免 lint 警告。

使用日志模型图标补全

• 补全 MiniMax、智谱、百度、讯飞、腾讯、百川、InternLM、Stepfun、Yi 等国产模型识别。
• 使用日志列表中的模型徽标展示更完整。

Markdown 渲染器重构

• Markdown 渲染从 react-markdown + rehypeRaw 切换为 marked + DOMPurify。
• 提升富文本渲染安全性。
• 扩展流程图、序列图等语法能力。
• 适用于公告、法律文档、关于页、主页自定义内容等场景。

前端体验修复

• dompurify 升级到 3.4.11。
• 钱包模块关闭时，Profile 下拉菜单隐藏 Wallet 入口。
• 渠道卡片视图同步选中态。
• 计费历史弹窗列表不再遮挡分页。
• 模型定价可视化删除行后立即从列表消失。

Bug Fixes

• 修复异步日志清理启动接口为 AdminAuth，但状态查询接口为 RootAuth 导致非 root 管理员无法查看清理进度的问题。
• 修复日志清理 DeleteOldLogBatch 在 SELECT 与 DELETE 之间 context 取消时仍可能继续删除的问题。
• 修复批量创建渠道开启 key 前缀命名时，审计日志记录原始渠道名而不是实际创建渠道名的问题。
• 修复批量渠道构造时指针复用导致名称前缀可能累加污染的问题。
• 修复旧同步日志删除入口兼容性，继续返回同步删除数量 data: count。
• 修复登录审计中重复顶层 login_method 字段，仅保留结构化 op.params.method。

Compatibility Notes

• SMTP TLS 证书校验默认更安全；如企业邮箱使用自签名证书或证书主机名不匹配，需要显式开启兼容配置。
• 旧版同步日志删除接口仍保留，推荐新前端和新集成使用 system task 日志清理接口。
• 泛用系统任务列表和详情仍保持 Root 权限；日志清理专用状态接口对 Admin 可见。

Verification

本版本已通过后端测试、Go vet、JSON wrapper 检查、前端 typecheck、针对性 ESLint 与 diff 检查。