- 修复 registry 测试 ai mock 缺失 createProviderRegistry 导出 - 新增 POST /api/providers/test 支持未保存供应商配置连通性测试 - 供应商表单新增测试连接按钮,新建默认 openai-compatible - 连通性测试按 ok 展示成功/失败,不再统一 success 样式 - 模型表单新建时也可测试供应商连接 - 模型页使用独立 provider 列表避免分页/搜索影响 - 移除模型管理组件内联 style - 新增 ProviderTestResultResponse 共享响应类型 - 新增 bun run format:check 脚本 - 补充关键测试覆盖(删除关联、连通性、默认类型、表单测试) - 更新 docs/user/usage.md、docs/development/*、design.md、tasks.md - 归档 change 至 openspec/changes/archive/2026-05-29-add-model-management
用户文档
本文档是 Alfred·阿福 的用户使用入口,说明如何安装、配置、部署和排查问题。
适用场景:首次安装、编写配置、生产部署、排查运行问题。
文档索引
| 文档 | 内容 |
|---|---|
| usage.md | 快速开始、安装配置 |
| config.md | YAML 结构、变量语法、server/storage/logging |
| deploy.md | 生产构建、可执行文件运行、运行时配置 |
| troubleshoot.md | 常见问题:配置校验、变量解析、构建失败 |
按任务阅读
| 任务 | 建议阅读 |
|---|---|
| 首次使用 | 项目快速开始、安装配置 |
| 编写配置 | 配置文件 |
| 生产部署 | 部署、故障排查 |
| 排查问题 | 故障排查 |
用户文档更新规则
- 安装、配置、快速开始流程变化时,更新 usage.md。
- 配置结构、变量语法、server/storage/logging 字段变化时,更新 config.md。
- 生产构建、可执行文件运行、运行时依赖变化时,更新 deploy.md。
- 常见错误、配置校验、构建失败排查方式变化时,更新 troubleshoot.md。
- 用户文档只解释"如何使用"和"用户能观察到什么",实现细节放入
../development/。