Skip to content

v1.1.1

Choose a tag to compare

@github-actions github-actions released this 16 Nov 14:38
· 40 commits to main since this release

⚠️ 升级须知(1.1.0 → 1.1.1)

  1. 升级前先配 CONFIG_ENCRYPT_SECRET_KEY(16/24/32 字节十六进制),api、migrate、worker 用同一份。界面上配过 SMTP 授权码的部署不配的话,迁移会中止、新版 api 起不来(#370)。
  2. 带两条新迁移:as000000whsecrets、at000000configsecret。
  3. HTTPS 部署在 .env.server 补 COOKIE_SECURE=true(#322)。
  4. 外链 / 内嵌菜单地址现在必须是完整的 http(s) 地址(#318);库里已有的相对地址照常显示,但编辑保存会被拒。
  5. 建议轮换 SMTP 授权码 —— 它此前经读接口明文下发过。

🔴 已知问题 #369

默认生产配置(DATABASE_PK_MODE='snowflake'、不配固定节点号)下,Celery worker 启动 60 秒后,写入雪花主键行的任务会失败。
绕过办法:给每个 worker 进程配固定且互不相同的 SNOWFLAKE_DATACENTER_ID / SNOWFLAKE_WORKER_ID。1.1.2 修复。


fastapi-react-admin 的桌面客户端 —— 把 web 后台装进 Electron 外壳,
提供浏览器给不了的四件事:静默打印、本地硬件、凭据托管、自动更新。
后台本身(页面、权限、多页签)和浏览器版是同一份代码。

下哪个

平台 文件 说明
Windows 10/11 x64 admin-desktop-<版本>-setup.exe NSIS 安装向导,装到当前用户(%LOCALAPPDATA%\Programs),不需要管理员
macOS Apple Silicon ...-arm64.dmg M1 及以后
macOS Intel ...-x64.dmg(文件名不带 arm64)
Linux x64 ...-x86_64.AppImage chmod +x 后直接运行,不用装

.blockmap 与 latest*.yml 是自动更新用的,人不需要下载。

装完第一件事:填后端地址

首次启动会让你填服务器地址(如 https://admin.example.com)。它是运行期配置,
存在用户目录里 —— 所以同一个安装包可以连不同环境,不用为每个环境各打一版。

已知限制(都是刻意的取舍,不是漏做)

  • 🔴 所有平台的包都没有代码签名。
    • Windows:SmartScreen 会拦一次 →「更多信息」→「仍要运行」
    • macOS:Gatekeeper 会说**「已损坏,应移到废纸篓」**。这不是包坏了,是没有公证:
      右键 →「打开」,或者 xattr -dr com.apple.quarantine /Applications/Admin\ Desktop.app
    • Linux:AppImage 不需要签名
    • 想去掉这些提示:Windows 侧有面向开源项目的免费证书方案(SignPath Foundation),
      macOS 侧没有免费路,需要 Apple Developer Program($99/年)
  • 🔴 macOS 上的自动更新不工作(未签名)。electron-updater 要校验运行中应用的代码签名,
    拿不到就拒绝安装更新。Windows 与 Linux(AppImage) 的自动更新正常
  • 读卡器等本地硬件是桩模式:厂商的原生助手不在仓库里(那是现场的东西),
    所以这个包里没有。界面上相关功能会走模拟数据
  • 打印:Windows 上是真的静默打印;macOS/Linux 上打印链路能跑,但没有在真机标签机上验过

更新从哪来

默认读这个仓库的 Release。内网部署(客户出不去公网)可以在客户机的 config.json 里
填 updateUrl,指向自己的静态目录 —— 不用为内网单独打一版。


What's Changed

  • feat(docs): 重做首页展示与内页分类导航 by @yilecoding in #297
  • feat(docs): 文档站首页轮播与动效 · 内页 AI 入口 · llms.txt · 技术架构页 by @ita201125 in #298
  • ci: 纯文档 PR 跳过 E2E 和两个 pytest by @yilecoding in #299
  • docs(readme): 加 zread 徽章 by @yilecoding in #302
  • feat(shell): 功能引导不再自动弹出,只从「帮助」/ ⌘K 手动打开 by @yilecoding in #335
  • fix: 修复验证码、跨账号刷新、授权覆盖与 AI 事务问题 by @ita201125 in #336
  • fix: 开放应用失效时间遵循个人显示时区 by @ita201125 in #337
  • fix: 补齐日期时间草稿确认与三个日期 issue 验收 by @ita201125 in #338
  • docs: 整理入门与登录安全指南,改善阅读体验 by @yilecoding in #339
  • feat: 添加 DeepWiki 项目导览入口 by @yilecoding in #342
  • fix: 防止公告图片同步期间重复提交 by @yilecoding in #340
  • fix: 列表末页删空或办完后自动回到有效页 by @ita201125 in #341
  • fix: 修复只读角色访问管理页面被拒绝的问题 by @yilecoding in #343
  • fix: 短信重发失败时保留原验证码 by @ita201125 in #344
  • fix: 防止用户关联查询退化为全表 join by @ita201125 in #345
  • fix: 连续重置 Webhook 密钥时保留完整宽限期 by @ita201125 in #346
  • fix: HTTPS 反代部署正确保留协议并保护登录 Cookie by @ita201125 in #348
  • fix: 防止雪花节点租约丢失后继续发号 by @ita201125 in #347
  • fix: 完善用户删除的账号保护和会话清理 by @yilecoding in #350
  • fix(open): 非 ASCII X-Sign 返回签名不匹配 by @ita201125 in #349
  • fix: 同步审批草稿缓存避免重开覆盖内容 by @yilecoding in #351
  • fix(workflow): 或签拿回恢复其他审批人的待办 by @ita201125 in #354
  • fix: 修复受限用户刷新误踢和用户快照清理竞态 by @ita201125 in #352
  • fix: 修复分片上传失败收尾和跨账号状态残留 by @ita201125 in #353
  • fix: 修复移动端构建钩子和旧 CI 发布覆盖 by @ita201125 in #355
  • fix: 插件下载与卸载拒绝越界目录 by @ita201125 in #356
  • fix: MFA 并发尝试不再绕过次数上限(#311) by @ita201125 in #358
  • fix: 加密参数配置密钥并阻止接口回显 by @yilecoding in #357
  • fix: 过期令牌被拒后恢复实时连接 by @ita201125 in #359
  • fix: 桌面外链仅允许 HTTP(S) 协议(#318) by @ita201125 in #360
  • fix(open): Webhook 出站加总时长、限制响应体读取(#307) by @yilecoding in #361
  • fix: AI 对话流式途中切会话串台、连接断开时气泡永远「思考中」 (#329) by @ita201125 in #362
  • fix(open): Webhook 出站评审修正 —— 不解压压缩响应、DNS 计入总时长、回收的 ping 直接放弃(#307 后续) by @yilecoding in #364
  • fix(auth): 登出失败不再当成登出成功(#319) by @yilecoding in #363
  • fix(ai): MCP 写操作永远要本人确认、发凭据要够格;模型报错不带上游响应体和地址(#314 #317) by @yilecoding in #366
  • fix(ai): #366 评审修正 —— 异常链按类型认、删除也查够不够格、前端置灰超管选项 by @yilecoding in #367
  • chore(release): 版本号 1.1.1 by @yilecoding in #375
  • ci(mobile): Android 模拟器里跑 Maestro 冒烟链(#137) by @yilecoding in #365

Full Changelog: v1.1.0...v1.1.1