58 lines
4.1 KiB
Markdown
58 lines
4.1 KiB
Markdown
# 项目验收记录
|
|
|
|
验收日期：2026-11-04。
|
|
|
|
## 结论与依据
|
|
|
|
六个页面均已实现，具备真实 REST 后端、SQLite 持久化、两种供应商适配器及 MCP 接口。
|
|
本次修复后，隔离环境中的 27 项自动化测试通过，包括 24 项后端回归和 3 项浏览器/MCP 集成测试。
|
|
|
|
按项目说明验收，供应商配置、模型管理、文生图、文件落盘、画廊、生成记录、文档和 MCP
|
|
构成的核心使用流程已完整落地。图生图通过 REST/MCP 提供；Web 端目前定位为文生图控制台。
|
|
|
|
仓库中的 `.trae-html-share-packages/web/` 有六份页面分享包，每份都包含相同的九个前端文件。
|
|
检查时，这些文件与当前实现完全一致。它们可能是实现快照，不能据此认定为独立原型。
|
|
用户确认原型可能已误删，并要求改按项目功能完整性验收。分享包本地保留，加入忽略规则。
|
|
|
|
## 测试范围
|
|
|
|
| 范围 | 验证内容 | 结果 |
|
|
|---|---|---|
|
|
| 页面与接口 | 六个页面、静态资源、列表、文档、健康检查 | 通过 |
|
|
| 供应商 | 页面创建/删除/启停、密钥加密和掩码、空密钥更新保留原密钥 | 通过 |
|
|
| 模型 | 发现过滤、勾选保存、批量启停、带斜杠模型 ID、发现保留停用状态 | 通过 |
|
|
| 出图 | 模拟 OpenAI 上游、两张图片落盘、浏览器图片解码、最近产出 | 通过 |
|
|
| Agnes | 模拟上游请求、尺寸/比例换算、参考图参数、能力元数据 | 通过 |
|
|
| 失败处理 | 上游错误、下载失败、无效 Base64、空结果、部分文件失败回滚 | 通过 |
|
|
| 输入限制 | 数量、空提示词、尺寸、无效路径、停用配置、未知模型、参考图能力、异常上游 JSON | 通过 |
|
|
| 默认模型 | 优先选择配置模型，不可用时回退至已启用模型 | 通过 |
|
|
| 预览提示词 | 读取生成记录中的提示词，保留换行、安全显示特殊字符，无记录的旧图片隐藏提示词 | 通过 |
|
|
| 画廊与记录 | 浏览、详情、删除、同名文件跨画廊隔离、成功/失败筛选 | 通过 |
|
|
| MCP | HTTP 与 stdio 初始化、工具枚举、文档调用 | 通过 |
|
|
| 布局与脚本 | 1440px/390px 六页面无横向溢出，操作流程无未捕获脚本错误 | 通过 |
|
|
|
|
## 修复与整理
|
|
|
|
- 模型发现保留用户设置的停用状态；MCP 仅返回已启用模型。
|
|
- 出图服务统一校验 REST/MCP 参数、供应商/模型启用状态与参考图能力。
|
|
- 修复模型 ID 含 `/` 时无法修改、保存不存在供应商的模型触发数据库错误。
|
|
- 拒绝无效 Base64、空图片/空结果，失败写入记录，部分保存失败时回滚已写文件。
|
|
- 删除图片仅更新当前画廊的生成记录，校验画廊与文件路径。
|
|
- 修复出图页发现模型后列表不刷新、供应商停用后编辑被重新启用、失败后按钮未恢复等问题。
|
|
- 补齐画廊删除入口及确认步骤；修复移动端文档页面横向溢出。
|
|
- 合并六页面图标渲染、请求错误提示和按钮加载状态处理；提示消息转义后渲染。
|
|
- 合并适配器模型解析，移除无用导入、未使用常量和重复删除操作。
|
|
- 添加 Docker 构建排除规则，忽略本地图片及截图；保留原有数据与未提交改动。
|
|
- 补齐供应商启停入口与默认模型选择，清除页面中硬编码的供应商命令示例及“待补充”提示。
|
|
- MCP 示例配置改用 PATH 中的 Python，修复指向本机不存在的 Python 解释器路径。
|
|
- 异常上游 JSON 结构返回明确错误并记录失败，避免未捕获异常。
|
|
|
|
## 验收边界
|
|
|
|
- 测试使用模拟上游，未验证真实供应商的可用性、额度、模型特性和生成画质，也未产生付费请求。
|
|
- Web 出图页没有参考图上传入口，图生图调用方式及请求示例已写入 SKILL.md。
|
|
- MCP 的流程顺序由工具说明约定；服务端校验模型已保存且启用，不维护每个客户端是否先执行发现的会话状态。
|
|
- 已验证本机运行及 MCP；本机未提供 Docker 命令，未执行镜像构建或容器部署验收。
|
|
|
|
复现命令见 README 的“测试”章节。
|