Skip to content

v0.0.6

Choose a tag to compare

@github-actions github-actions released this 03 Oct 08:59
· 108 commits to main since this release

安装运行

Docker(推荐)

docker run -d --name agnes-platform -p 8080:8000 -v agnes-data:/app/data ghcr.io/wingkysky/agnes-ai-platform:v0.0.6

免 Docker 便携包(Windows / macOS Apple Silicon)

从下方 Assets 下载对应平台的 zip,解压后双击 start-windows.bat(或 macOS 的 start-macos.command)。
macOS 首次运行先在终端执行 xattr -cr <解压目录> 去除下载标记;详见包内 README-PORTABLE.txt。

打开 http://localhost:8080 (便携包为 8000),按首启向导完成管理员密码与 AI 服务配置即可使用。
更多方式(docker compose / 公网服务器反代与 HTTPS / 数据备份)见 docs/deployment.md。


首启引导重设计:免登录创建管理员 + 模型配置闭环

  • 免登录创建管理员:不再预置默认 admin/admin123 账号——实例无管理员时打开任意页面直接进入「初始化管理员」向导(自选用户名+密码,创建即登录),全程无需知道/手输默认凭据、无需再"改默认密码";新增免登录端点 GET/POST /api/setup/bootstrap(仅管理员数为 0 时可创建,409 拒绝重复初始化,窗口同时是管理员被全删后的恢复路径;竞态下 409 自动转登录页)
  • 模型配置闭环:向导 Provider 步提交后自动调用模型同步并展示「已同步 N 个模型(图片/视频/对话)」——修复旧向导只建 Provider 不拉模型、生成页无模型可用的断链;同步失败展示后端透出的中文错误并支持「重试同步」(Provider 已建,仅重拉);接入方式收敛为两张预设卡(Agnes AI 官方默认 / OpenAI 协议兼容),其余厂商适配器仍在管理后台完整选择器中
  • 未配置兜底指引:跳过或同步失败时完成页明确警示"生成功能不可用",图片/视频生成页在模型列表为空时显示引导横幅(管理员可一键跳转模型配置页)
  • 自动化部署兼容:ADMIN_USERNAME + ADMIN_PASSWORD 同时显式设置时仍走超管种子(不再强制改密),向导自动跳过创建步骤;.env.example 补 ADMIN_* 变量说明
  • 移除 must_change_password:新流程无"默认密码"概念,字段与强制改密拦截整体移除(存量库升级需手动 ALTER TABLE users DROP COLUMN must_change_password,见模型文件升级注释)
  • 依赖安全:PyJWT 下限抬至 2.15.0(2.13 存在多项 PYSEC 告警,JWT 为令牌签发核心;anyio/urllib3 随解析自动升级),pip-audit 复扫清零
  • 测试:pytest 首启初始化 18 例(bootstrap 三态/种子条件化)+ vitest setup store 12 例(bootstrap 判定/缓存/重置)全绿 + 临时库 uvicorn 三环境冒烟;README/API.md 同步更新;Mimosa 深度复扫 35 条 business-logic 候选逐条人工核对全为已知盲区误报(new=0,结论入基线台账)