Skip to content

Releases

v1.1.2

Choose a tag to compare

@github-actions github-actions released this 18 Nov 10:08

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

  • fix: 角色用户和参数配置读取失败时显示错误与重试 by @ita201125 in #377
  • feat: 线上能看出跑的是哪个版本 —— /health/status 与 version.json 补 version / commit,部署后自检(#378) by @ita201125 in #379
  • ci: E2E 的后端准备抽成共用 action by @yilecoding in #380
  • fix: 修复桌面外链与内嵌菜单地址 (#373) by @ita201125 in #376
  • fix: worker 的雪花节点挪到 AsyncIOPool 的循环里初始化(#369) by @yilecoding in #382
  • fix: AI 遗留三条(#372)—— 数据库异常不回显 SQL · MCP 凭据 update 校验旧值 · 确认流按卡片落气泡 by @yilecoding in #383
  • chore: 版本号 1.1.2 by @yilecoding in #385

Full Changelog: v1.1.1...v1.1.2

v1.1.1

Choose a tag to compare

@github-actions github-actions released this 16 Nov 14:38

⚠️ 升级须知(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

v1.1.0

Choose a tag to compare

@github-actions github-actions released this 10 Nov 09:56

这一版的主要内容

1.0 之后第一个功能版本。主角是数据变更审计:谁、什么时候、从哪来,把哪个对象的哪个字段从什么改成了什么。兼容承诺没有破坏(镜像改名期间新旧两个名字都推)。

数据变更审计(#260 · #281)

  • 字段级前后对比,在会话层统一拦截,不靠各写路径自己记(#262)
  • 接入的对象:用户(含二次验证、第三方账号)· 部门 · 角色 · 菜单 · 参数配置 · 开放应用 / Webhook 端点 · 群机器人 / 通知策略 · 短信配置 · 存储 · 模型密钥 / MCP 凭据 · 数据范围 / 规则 · 定时任务 · 字典 · 流程定义(#262 · #267 · #284 · #286 · #291)
  • 密钥、令牌、Webhook 地址这类只记「改过」,不记值
  • 各页行操作里的「变更记录」抽屉 · 「日志管理 → 数据变更」页(按对象 / 操作人 / 来源 / 字段 / 时间筛)· 单字段历史 · 导出 · 和操作日志按请求互跳(#262 · #271 · #280)
  • 防篡改链:每行带序号和签名,超管可「校验完整性」,配 DATA_CHANGE_CHAIN_KEY 后防得住能改库的人(#271 · #278)
  • AI 助手能查变更记录(「谁改了张伟的部门」)(#272)

安全

  • 操作日志漏打码的凭据(#283):参数配置里像密钥的那几行(如 EMAIL_PASSWORD)、批量保存的请求体、登录 / 刷新响应里的 access_token、模型密钥的 api_key 等原来会原样进操作日志。现在一律打码,并加了守卫扫全部接口的字段名;迁移会清掉已经写进去的旧记录
  • 短信配置的凭据不能再从 options 绕进库,已经存进去的由迁移删掉(#284)
  • 登录日志记下「账号被锁」「IP 被锁」「被强制下线」(#273 · #275)
  • 按上游 FBA 补的四处:连接串密码、操作日志关停丢批、IPv6 属地、热重载锁(#277)
  • 依赖安全告警清零:桌面端 Electron 升到 42.11.18(装进安装包的运行时)· Pillow 13 / tornado 6.6 等 · 前端单测换 vitest 4 · Expo SDK 57 补丁版(#294)

其他

  • 登录 / 操作日志默认保留期 30 天 → 180 天(《网络安全法》六个月下限)(#261 · #282)
  • 写接口的事务在响应发出之前提交(#268)
  • 日期选择:跳年月、草稿、区间重选、时间滚动列、手输、按月按年(#269 · #274)
  • 从抽屉 / 菜单里的链接跳去别的页签,浮层不再残留(#280)
  • AI 对话落库、Redis 重启后限流 500、macOS 开发环境 beat 崩溃等修复(#263 · #279)
  • fba init 在最后提交时报「雪花算法未初始化」、整条回滚 —— 快速开始第一步就失败;pnpm db:reset 的向导里填了别的 Redis 时同样失败。CI 现在对新库补跑一遍 fba init(#292 · #296)
  • 移动端审批:办理失败(别人先办了)时面板和原因不再一起消失 · 服务端没装审批插件时首页不再一直报错 · 发起页的流程预告改成对发起人说话(#258)
  • 文档站:19 个功能页(每页配截图)· 开发者工具页 · 侧边栏按领域分组(#285)

升级说明

  • 数据库迁移:照常 pnpm db:upgrade,或者让 compose 里的 migrate 服务自动跑。其中两条会改写旧数据:清理操作日志里漏打码的凭据(aq000000operalogsecret,逐行提交、可重复跑)、删掉短信配置 options 里混进去的凭据(ar000000smsoptcreds)
  • 🔴 建议升级后更换 SMTP 授权码和模型的 API Key:迁移清得掉表里的记录,清不掉已经导出、备份或被人看过的。访问令牌会自己过期,不用管
  • 日志保留期默认改成 180 天,日志表会比原来大(本机实测操作日志平均每条约 2 KB)。管理员自己调过天数的不受影响
  • 想让防篡改链防得住能改库的人,在 .env 配 DATA_CHANGE_CHAIN_KEY(不配也能用,只防手滑改库)
  • 镜像名改成 fra-api / fra-web,1.1.x 期间旧名字 fba-api / fba-web 照常推送
  • 🔴 后端不再支持 Python 3.10,最低 3.11(官方镜像和 CI 一直是 3.13,不受影响;自己在 3.10 上跑的要先升 Python)。从上游带过来的 apps/api/Dockerfile 基础镜像也换成了 3.13

桌面客户端

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

  • fix(mobile): 审批评审的四条 —— 409 后面板不消失 · 没装插件不报错 · 发起页预告对发起人说话 · 规则两端共用一份(#257) by @ita201125 in #258
  • docs: README 照 vben / Ant Design Pro 的写法 —— 顶部加语言切换行 by @yilecoding in #259
  • fix: AI 对话落库 · Redis 重启后限流 500 · Windows 开发流程 · 删除弹窗 · 审批系统意见多语言 by @ita201125 in #263
  • feat: 数据变更审计 —— 谁、什么时候、从哪来,把哪个字段从什么改成了什么(#260) by @yilecoding in #262
  • fix(ui): 日历能跳年月、能选明年、跟界面语言 —— «‹ 年 月 ›» 表头 + 年/月面板(#264 #265) by @ita201125 in #269
  • chore(gitignore): .claude/ 只放行技能 / 子代理 / 命令,本机配置不进仓库 by @ita201125 in #270
  • feat(audit): 数据变更审计二期 —— 用户的二次验证 · 第三方账号(#260) by @yilecoding in #267
  • fix(db): 写接口的事务在响应发出之前提交 by @yilecoding in #268
  • feat(audit): 数据变更审计二期 —— 单字段历史 · 导出 · 防篡改链(#260) by @yilecoding in #271
  • chore(deploy): 镜像改名 fba-api / fba-web → fra-api / fra-web,1.1.x 期间两个名字都推 by @yilecoding in #276
  • feat(ai): AI 助手查数据变更记录 —— 「谁改了张伟的部门」(#260) by @yilecoding in #272
  • fix(audit): 防篡改链按评审修(#271 合并时这个提交还没进去) by @yilecoding in #278
  • feat(auth): 登录日志记下「账号被锁」「IP 被锁」「被强制下线」(#273) by @yilecoding in #275
  • fix(api): 按上游 FBA 54 个提交审下来要补的 4 处 —— 连接串密码 · 操作日志关停丢批 · IPv6 属地 · 热重载锁 by @yilecoding in #277
  • feat(ui): 日期选择补齐草稿 / 区间重选 / 时间滚动列 / 手输 / 按月按年(#266 的 P2+P3) by @ita201125 in #274
  • fix: 修复 macOS 开发环境 Beat 启动崩溃 by @yilecoding in #279
  • fix(platform): 从抽屉 / 菜单里的链接跳去别的页签,浮层跟着走掉 by @yilecoding in #280
  • fix(task): 登录 / 操作日志默认保留 30 天 → 180 天(网络安全法的六个月下限) by @yilecoding in #282
  • fix(api): 操作日志漏打码的凭据 —— 参数配置的 value · 列表请求体 · access_token / api_key 等 · 迁移清理旧记录 by @yilecoding in #283
  • feat(audit): 数据变更审计接入带密钥的对象 —— 开放应用 · Webhook · 群机器人 · 短信 · 存储 · 模型密钥 · MCP 凭据(#281 第一批) by @yilecoding in #284
  • docs(site): 功能页第一批 —— 登录与安全样板页 · 侧边栏按领域分组 · 总览对齐 README · 源码链接进闸门(#285) by @yilecoding in #287
  • docs(site): 功能页第二批 —— 导入导出 · 用户角色部门菜单 · 日志与审计三个新页 + 五个旧页补界面入口与开关(#285) by @yilecoding in #288
  • docs(site): 功能页第三批 —— 工作台 · 定时任务 · 监控 · 插件 · 参数配置与字典五个新页 + 剩余旧页补全(#285) by @yilecoding in #289
  • docs(site): 开发者工具页 + 更正「接口对不上类型检查就报错」的对外说法(#285) by @yilecoding in #290
  • docs(site): 功能页首图 —— 19 个功能页都配上截图(#285 最后一项) by @yilecoding in #293
  • feat(audit): 数据变更审计接入数据权限 · 通知策略(#281 第二批) by @yilecoding in #286
  • feat(audit): 数据变更审计接入定时任务 · 字典 · 流程定义(#281 第三批) by @yilecoding in #291
  • chore(deps): 依赖安全告警一次清掉 —— Python 下限 3.11 · electron · vitest 4 · Expo 补丁版(#294) by @yilecoding in #295
  • fix(cli): fba init 提交时报「雪花算法未初始化」整条回滚 —— 快速开始第一步失败 · CI 补跑 fba init by @yilecoding in #292
  • fix(cli): #292 评审 —— 雪花节点包在事务外 · --auto 用新填的 Redis · 自增模式不占 · 释放失败不冒 by @yilecoding in #296

Full Changelog: v1.0.1...v1.1.0

v1.0.1

Choose a tag to compare

@github-actions github-actions released this 06 Nov 05:43

这一版的主要内容

1.0.0 之后的第一个修订版。网页端、后端、桌面端只有修复,没有新功能,也没有破坏兼容承诺;重点是五个安全修复。

安全

  • OAuth2 陌生账号默认不再自动建号(#236,关 #226):原来任何 GitHub / Google 账号走一遍第三方登录就成了系统用户,而且挂到哪个角色取决于数据库行序。现在需要显式开启 OAUTH2_AUTO_REGISTER,并用 OAUTH2_AUTO_REGISTER_ROLE 指定角色编码
  • OAuth2 只按第三方验证过的邮箱关联已有用户(#238,#227)
  • OAuth2 的 state 绑定到发起授权的浏览器,堵住 login CSRF(#248,#227)
  • 任务调度 / 执行记录的读接口、/sys/users/{pk}/roles 补上权限校验(#235,关 #228):原来任何登录用户都能读到所有任务的参数、执行结果和报错堆栈
  • 图形验证码答错一次就作废(#242,关 #229)

修复

  • 第三方登录被拒时回到前端页面显示原因,不再停在一页 JSON 上;移出角色前查不到剩余角色时明确报错(#256,发版前评审)
  • api 镜像不再带进任何 .env;web 镜像补拷 packages/api 清单(#240,#233)
  • 开放接口 Java SDK 的请求签名补上测试向量,verifyWebhook 不再区分请求头大小写(#239,#231)
  • 后端契约 schema.d.ts 加了新鲜度闸门(#241,#234);CI 与供应链加固:Actions 钉 SHA、迁移守卫改走真实升级路径、打 tag 前确认提交在 main 上且 CI 已绿(#237 / #243 / #247 / #256)
  • 查询区与表格的间距统一为 12px(#249)

移动端(预览版,版本号单独算,不在这次的安装包里)这段时间加了绑定手机号和审批(#225 / #244 / #252 / #254)。

升级说明

  • 2 条数据库迁移(aj000000tasklist · ak000000noticehtml),照常 pnpm db:upgrade,或者让 compose 里的 migrate 服务自动跑
  • 迁移会给已经能看到任务调度 / 执行记录页面的角色补上新的「查询」权限,升级前能看的,升级后照样能看。迁移不碰 Redis:部署后清一次 fba:user:*,否则已登录的非超管用户在 token 过期前打开这两页会 403
  • 依赖 OAuth2 自动建号的部署:升级后这个功能默认关闭,要显式开启并配置角色编码

桌面客户端

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

  • fix(security): OAuth2 陌生账号默认不自动建号(#226) by @yilecoding in #236
  • feat(mobile): 绑定手机号 · 「我的」只放入口 · 「应用」改成图标宫格(#224) by @ita201125 in #225
  • fix(security): 任务模块读接口与 /sys/users/{pk}/roles 补权限校验(#228) by @yilecoding in #235
  • fix(security): OAuth2 只按第三方验证过的邮箱关联已有用户(#227 前半) by @yilecoding in #238
  • ci: 「模型 ↔ 迁移一致」守卫改走真实的升级路径(#230) by @yilecoding in #237
  • fix(open-sdk): Java 请求签名补测试向量;verifyWebhook 不分头名大小写(#231) by @yilecoding in #239
  • ci: Actions 钉 SHA · release.yml 不插值 · dev 端口只绑本机(#232) by @yilecoding in #243
  • fix(docker): api 镜像挡住所有 .env;web 镜像补拷 packages/api 清单(#233) by @yilecoding in #240
  • fix(security): 图形验证码答错也作废(#229) by @yilecoding in #242
  • fix(contract): schema.d.ts 新鲜度闸门 · 移动端版本号单一来源(#234) by @yilecoding in #241
  • chore(deps): Bump the actions group across 1 directory with 11 updates by @dependabot[bot] in #245
  • chore(ci): Dependabot 大版本单独开 PR,不和 minor/patch 打包 by @yilecoding in #246
  • feat(mobile): 审批人这一侧 —— 收件箱 · 详情 · 全部动作(#224 2a) by @ita201125 in #244
  • fix(release): 打 tag 出包前确认提交在 main 上、且 CI 已绿(#232) by @yilecoding in #247
  • fix(security): OAuth2 state 绑定到发起授权的浏览器,堵 login CSRF(#227) by @yilecoding in #248
  • style(pages): 查询区与表格间距统一为 12px,收进 ListBody by @yilecoding in #249
  • docs: 项目介绍补上缘起、三端 monorepo 与「为 AI 协作而设计」 by @yilecoding in #250
  • docs(site): 首页改成克制版式 —— 留白、发丝线、线稿图示 by @yilecoding in #251
  • feat(mobile): 发起审批(#224 2b)· 置顶种子公告正文改 HTML by @ita201125 in #252
  • docs: 截图改成 2 倍真彩图并补上拍图脚本,文档站按高分屏出图 by @yilecoding in #253
  • feat(mobile): 样式收成一套共用件 —— 分组翻页行 · 搜索框 · 顶栏 · 头像 by @ita201125 in #254
  • chore(release): v1.0.1 by @yilecoding in #255
  • fix: v1.0.1 发版前评审修掉的四条 by @yilecoding in #256

New Contributors

Full Changelog: v1.0.0...v1.0.1

v1.0.0

Choose a tag to compare

@github-actions github-actions released this 03 Nov 03:19

第一个正式版:权限、审批、文件、消息、AI 助手、开放接口一套做齐,三种数据库、三端 🎉

fastapi-react-admin 是一套开箱即用的中后台底座(FastAPI + React 19)。1.0.0 是第一个正式版:功能范围定型,开放接口、Webhook、数据库迁移链、插件接口和配置键从这一版起按 semver 承诺不随手破坏。从 2026 年 8 月第一行代码到今天,经过 147 个 PR、21 个 0.x 版本。

在线演示 https://fra.wubunan.com/sign-in · 文档 https://yilecoding.github.io/fastapi-react-admin/ · 快速开始:docker compose up

简要

  • 权限与组织: 菜单 / 按钮 / 数据范围三层 RBAC,加上对每个查询生效的行级数据权限。
  • 登录与安全: 手机验证码登录、二次验证(TOTP + 恢复码)、OAuth2;会话按端限数、空闲与绝对超时、被踢下线说明原因。
  • 工作区: 可编辑布局的工作台、切换不丢状态的多页签、⌘K 命令面板、深色模式、中英双语、每人自己的时区。
  • 审批流: 表单设计器 + 流程树,同意 / 驳回 / 转交 / 退回 / 加签 / 超时自动处理,还有 AI 预审和帮填表单。
  • AI 助手: 工具调用受当前用户的权限和数据范围约束,写操作先预演再确认,全程审计;MCP 网关对外开放只读能力。
  • 文件、消息与开放: S3 兼容存储与断点续传、公告与通知渠道路由(邮件 / 短信 / 群机器人)、AK/SK 开放接口 + 三语言 SDK + Webhook 事件订阅。
  • 三种数据库、三端: PostgreSQL / SQL Server / MySQL 同一条迁移链;Web、桌面端(三平台安装包 + 自动更新)、移动端(预览版)。
  • 测试兜底: 后端 1492 条测试(PostgreSQL 与 SQL Server 各一整套)、浏览器端到端 160 条、前端单元 175 条,全部是 CI 必过闸门。

兼容与升级说明

  • 从 0.13.0 升级: 没有数据库迁移,不用改配置。这一版的改动只有 README 功能表补齐、移动端标成预览版、夏令时结论写成测试和版本号。
  • 从更早的 0.x 升级: 照常 pnpm db:upgrade,任何已发布版本都能直接升到 1.0.0。
  • 兼容承诺正式生效: 破坏开放接口 / Webhook / 迁移链 / 插件接口 / 配置键任何一条都会升主版本号,细则见下方「兼容承诺」。
  • 移动端是预览版: 不在兼容承诺内;审批和绑定手机号排在 1.0 之后(#224)。

整体功能

权限与组织

  • RBAC:菜单 / 按钮 / 数据范围三层权限,前后端用同一套权限码,没有权限的按钮直接不出现
  • 行级数据权限:数据范围 + 数据规则(按部门、本人、自定义条件),对每个查询生效;41 个测试账号逐一验证过
  • 部门树 · 用户 · 角色 · 权限矩阵(一屏勾完一个角色的全部菜单与按钮)

登录与安全

  • 图形验证码 · 失败锁定 · 密码策略(历史密码、过期)· 手机验证码登录 · 二次验证(TOTP + 恢复码)· OAuth2(GitHub / Google)
  • 会话管理:会话 ID 稳定、空闲超时 + 绝对上限、按端(Web / 桌面 / 移动)限制会话数、被踢下线时说明原因、管理员强制下线
  • access token 只放内存、页面加载静默恢复;日志自动脱敏

工作区

  • 可编辑的工作台:以待办为中心,卡片按权限出现,布局按人存在服务端、换设备也在
  • 多页签:切换不丢状态(筛选、滚动、表单都保留)、固定 / 拖拽 / 重新加载,刷新后恢复
  • 命令面板 ⌘K · 快捷键 · 功能引导 · 主题色 / 圆角 / 页签外观 · 深色模式 · 每人自己的时区 · 中英双语
  • 统一的页面规范(1.0 前做过一轮全站整改):表格单元格、工具栏顺序、行操作 ⋯ 菜单、卡片页、报错与重试、窄屏 / 手机适配

导入导出

  • 服务端导出 xlsx / csv:按当前筛选或勾选的行,大批量转后台、完成发站内消息,防公式注入
  • 通用导入:带下拉的模板 · 预览校验 · 只新增 / 新增并更新 / 只更新 · 错误报告 · 全部成功才落库;一份文件建整棵部门树

文件与存储

  • 文件管理器 + 在线预览(PDF / Word / Excel / PPT / 图片 / 音视频 / 压缩包)
  • 本地磁盘 + S3 兼容存储(Apache OpenDAL)· 预签名直连下载 · 秒传 · 分片上传与断点续传 · 回收站
  • 可以嵌进任何业务页面的附件面板

审批流

  • 表单设计器 · 流程树(审批 / 抄送 / 条件分支)· 发起前预览会走到哪些人
  • 同意 / 驳回 / 转交 / 退回 / 拿回 / 加签 · 超时提醒与自动处理 · 草稿 · 加急 · 离职交接 · 流程监控
  • AI 能力:AI 预审(给出建议与依据)· 上传材料帮填表单 · AI 审批节点 · AI 生成流程

AI 助手

  • 整页对话 + 任意页面的侧滑抽屉,接 OpenAI 兼容的模型供应商
  • 工具调用受权限和数据范围约束:AI 看不到、改不了当前用户本来就没权限的东西
  • 写操作先预演、再由人确认;全部调用留审计日志
  • MCP 网关(只读):外部 AI 客户端(Claude Desktop、Cursor 等)凭 MCP 凭据接入,查询能力同样受该用户的权限与数据范围约束

消息与通知

  • 站内消息(实时推送)· 消息中心
  • 通知公告:富文本 + 附件 · 发布范围 · 定时发布 · 置顶 / 级别 / 有效期 · 登录后弹窗与必须确认 · 顶部横幅 · 登录页公告 · 阅读统计
  • 通知渠道路由:邮件 / 短信 / 飞书·钉钉·企业微信群机器人,按事件配策略,每次投递有记录
  • 短信:阿里云 / 腾讯云

能力开放

  • AK/SK 签名的开放接口 /api/open/v1/*:scope · IP 白名单 · 防重放 · 限流 · 调用日志 · 增量同步
  • Python / Node / Java 三语言 SDK
  • Webhook 事件订阅:Standard Webhooks 签名 · 失败重试 · 投递记录 · 批量重发 · 密钥轮换期间新旧双签

定时任务与运维

  • 在线调度(cron 预览)· 执行记录 · 参数配置 · 数据字典 · 登录 / 操作日志
  • 服务器与 Redis 监控 · 在线用户 · 统一健康检查 /api/health/status(api / 数据库 / Redis / 调度器 / worker)· 发新版提示
  • 插件机制:AI、审批、公告、通知、短信、邮件、开放接口、OAuth2 等都是插件,可以按需装卸

多端

  • 桌面端(Electron):Windows / macOS / Linux 安装包 · 自动更新 · 静默打印 · 本地硬件 · 凭据托管;后端地址是运行期配置,同一个安装包可以连不同环境
  • 移动端(Expo 原生 App,不是 WebView 套壳):1.0 里是预览版,见下方「已知限制」

开发者

  • 组件沙箱:每个组件可调、可抄 · 调色盘
  • 由 OpenAPI 生成的类型安全前后端契约
  • 每个模块一份踩坑记录(AGENTS.md / CLAUDE.md),并有 ctx:check 校验文档不腐烂;arch:check 守住分层方向

技术栈

前端 React 19 · TypeScript · Vite · TanStack Router / Query / Table · Tailwind CSS 4 · shadcn/ui(Base UI)· Tiptap 3 · i18next
后端 FastAPI · Pydantic 2 · SQLAlchemy 2(async)· Alembic · Redis · Celery · Socket.IO · Apache OpenDAL · pydantic-ai
数据库 PostgreSQL(默认)· SQL Server · MySQL:同一套代码、同一条迁移链、三份种子数据
客户端 Electron · Expo / React Native
工程 pnpm + turbo monorepo · uv · ruff · pytest · Playwright · GitHub Actions

后端 fork 自 fastapi-best-architecture(三层结构、插件机制、RBAC 与数据权限模型来自上游),本仓库加了 SQL Server 支持和上面绝大多数业务能力。

质量

1.0.0 这一次提交上的 CI:

  • 后端 1492 条测试,PostgreSQL 和 SQL Server 各跑一整套
  • 浏览器端到端测试(Playwright)160 条,跑在 SQL Server 上
  • 前端单元测试 175 条;typecheck · eslint · ruff · 多语言 · 架构分层 · 文档引用 全部是必过闸门
  • MySQL 不在 CI 里,本地整套跑过;从 v0.0.1 建的库一路迁移到最新,表结构与模型差异为 0

兼容承诺(1.0 起正式执行)

按 semver:破坏下表任何一条都要升主版本号。

对外的面 承诺
开放接口 /api/open/v1/* 和三语言 SDK 路径、参数、响应字段、错误码、签名算法不删、不改语义;只加可选参数和新字段。真要破坏就开 v2,v1 保留
Webhook 事件 事件名不改,载荷字段不删不改名,签名方式不变
数据库迁移链 从任何一个已发布的版本都能 pnpm db:upgrade 升到最新;进过 tag 的迁移不再改
插件接口 plugin.toml 字段、安装流程、扩展点保持可用
配置键 .env 和参数配置的键不改名;真要改,新旧并存一个次版本
内部接口 /api/v1/* 不是公共 API,但照顾已装出去的桌面端 / 移动端:删改前新旧并存一个次版本

页面、组件、packages/* 的内部导出不在承诺范围内。

已知限制

  • 移动端是预览版:已有首页、公告、消息、用户、个人中心、服务器监控、手机验证码登录;还没有审批和绑定手机号(排在 1.0 之后,#224),没有自动化测试(#137)。不在兼容承诺范围内
  • MySQL 秋季回拨那一小时:MySQL 的 DATETIME 不存时区偏移,夏令时地区秋季回拨时重复的那一小时,第二次的记录读回来会早一小时(PostgreSQL / SQL Server 不受影响,已用测试钉住)
  • 桌面端安装包没有代码签名:Windows 会弹 SmartScreen,macOS 要右键打开

明确不在 1.0

写在这里,免得被当成漏做:审批委托 / 评论 / 打印 · 数据变更前后对比 · OIDC / LDAP / 企微钉钉飞书登录 · 代码生成器 · 水印 · Webhook 二期。

刻意不做:多租户 · 通用低代码 · PWA · 扫码登录。


桌面客户端

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

Full Changelog: v0.13.0...v1.0.0

v0.13.0

Choose a tag to compare

@github-actions github-actions released this 03 Nov 01:22

这一版的主要内容

  • 工作台个性化(#202):工作台以待办为中心,系统运行区只给管理员看;可以编辑布局(卡片按权限出现),布局按人存在服务端,换设备也在
  • 页面美观度统一整改(#210,共 10 个 PR)
    • 报错块原文折叠、任何宽度都看得到「重试」;主按钮禁用态改成中性灰;深色模式下主色文字提亮
    • 去掉 7 个页面顶部固定的说明文字,需要知道的那半句挪到用得着的地方(弹窗 / 空状态 / 表单)
    • 表格里的时间、耗时、空值、行操作统一成一套写法:蓝色 = 能点;行操作一律收进 ⋯,危险项在最后
    • 工具栏按钮顺序统一:主动作 → 次要 → 刷新 / 列设置 → 危险操作
    • 卡片页(模型供应商 / MCP 凭据 / 短信配置 / 群机器人 / 存储)统一键值区与「新增」卡,并补上刷新按钮;插件卡片去掉满屏的红色卸载按钮
    • 深色模式:卡片和背景分得开、边框看得见;头像不再是写死的浅色亮斑;监控数字只在真正异常时上色
    • 窄屏 / 手机:表格横向滚动有渐隐提示、主从页左栏不再铺满第一屏、查询区「搜索」和「重置」不拆开、监控统计卡两列
    • 数据少的表格不再撑满到页面底部;审批中心等处的短时间对往年的记录补上年份;开放接口日志 / AI 确认页有了面包屑父级和页签图标
  • 页面四边边距只在外壳给一次(#209),有 arch:check 闸门防止回退

升级

  • 有两条数据库迁移,部署时照常 alembic upgrade head(pnpm db:upgrade):
    • ah000000userpref:新建 sys_user_preference 表(个人偏好 / 工作台布局)
    • ai000000mcpicon:「MCP 凭据」菜单图标换成图形图标;只改还是旧图标的那一行,在菜单管理里自己改过的不覆盖
  • 不用改配置

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(dashboard): 工作台个性化 —— 以待办为中心 · 系统运行区只给管理员 · 布局按人存服务端(#202) by @yilecoding in #203
  • feat(docs): 公开文档站 —— Astro Starlight 中英双语,发到 Pages 根路径 by @yilecoding in #205
  • feat(docs): 文档站默认中文、英文挪到 /en/;可同时发到自己的服务器(/docs) by @yilecoding in #206
  • docs: 文档站补内容 —— 从零加业务模块 · 常见问题 · 版本升级 · 每步验收与上线清单 by @yilecoding in #207
  • chore(docs): Google Search Console 站点验证文件 by @yilecoding in #208
  • fix(shell): 页面四边 16px 只在外壳给一次 —— PageShell + arch:check 闸门(#209) by @yilecoding in #211
  • fix(dashboard): 按代码评审修工作台 —— 步骤条不漏隐藏字段的人名 · 超时结论认对 · 数字用全量(#202) by @yilecoding in #204
  • fix(ui): 去掉顶部说明文字 · 报错块 / 禁用态 / 深色主色 / 窄屏溢出(#210) by @yilecoding in #212
  • feat(ui): 表格单元格收成一套 —— 时间 / 耗时 / 空值 / 行操作(#210) by @yilecoding in #213
  • feat(ui): 工具栏按钮顺序统一 —— 主动作 → 次要 → 刷新 / 列 → 危险(#210) by @yilecoding in #214
  • feat(ui): 卡片页键值区 / 新增格收成组件,主从页详情标题统一(#210) by @yilecoding in #215
  • fix(ui): 窄屏专项 —— 顶栏残影、表格横向滚动提示、监控统计卡两列(#210) by @yilecoding in #216
  • fix(ui): 手机上的主从页和查询区 —— 左栏列表封顶、搜索与重置不拆开(#210) by @yilecoding in #218
  • feat(ui): 深色层次与颜色语义 —— 卡片底色、边框、头像、监控数字(#210) by @yilecoding in #217
  • feat(ui): 插件卡片去掉满屏红点、卡片页补刷新(#210) by @yilecoding in #219
  • feat(ui): P2 零散项 —— 短表格不撑满、单点平线、开放接口日志面包屑(#210) by @yilecoding in #220
  • fix(ui): #210 漏掉的四处 —— ⋯ 菜单统一、短时间补年份、MCP 页签图标 by @yilecoding in #221
  • chore(release): v0.13.0 by @yilecoding in #222

Full Changelog: v0.12.0...v0.13.0

v0.12.0

Choose a tag to compare

@github-actions github-actions released this 31 Oct 10:19

这一版的主要内容

1.0 前的准备(#193)。依赖有安全修复,建议升级。

  • 🔴 依赖安全(#197)
    • 网页端:富文本(粘贴 XSS)、文件预览(dompurify)、路由、表单校验等打进浏览器的依赖全部升到修复版;pnpm audit --prod 从 3 严重 / 43 高危降到 0 严重 / 2 高危(剩下两个在移动端的命令行工具链里,没有同大版本的修复,不进网页包)
    • 后端:13 个有漏洞的包全部升级(含 Pillow 13、aiohttp、pypdf、tornado、urllib3),pip-audit 0 条
    • JWT 库从 python-jose 换成 PyJWT:python-jose 的 CVE-2026-85394 没有修复版。解码时只认配置的那一个算法,换算法 / 换密钥 / alg=none 的 token 一律拒绝
  • 移动端可以用手机验证码登录了(#196),和网页端同一套规则(发码冷却、限流、二次验证照常);网页端和移动端的登录页去掉了「扫码登录」占位
  • 英文 README 成为仓库首页,中文版在 README.zh-CN.md(#195)
  • 新增「1.0 起的兼容约定」(#194):开放接口 / SDK、Webhook 事件、迁移链、插件接口、配置键的兼容承诺

升级

  • 没有数据库迁移,不用改配置
  • ⚠️ 生产环境(ENVIRONMENT=prod)如果把 TOKEN_ALGORITHM 改成了 HS384 / HS512,启动时会检查 TOKEN_SECRET_KEY 的长度(HS384 ≥ 48、HS512 ≥ 64 位),不够长拒绝启动;默认的 HS256 不受影响
  • MySQL 上实测过从 v0.0.1 一路升到这一版:全套测试 0 失败,表结构与模型一致

桌面客户端

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

  • docs(readme): 致谢补上几个底座依赖的开源项目 by @yilecoding in #192
  • docs(claude): 「还没发版 —— 可以自由重构」改写成「1.0 起的兼容约定」(#193) by @yilecoding in #194
  • docs(readme): 英文版做默认首页 · MySQL 全套 1.0 前重跑(#193) by @yilecoding in #195
  • fix(ctx-check): 跳过 .claude/worktrees —— 子代理的整仓拷贝会让死链「解析成功」 by @yilecoding in #198
  • fix(login): 登录页不再有「还没接入」的占位 —— 两端删掉扫码页签,移动端接上手机验证码登录(#193) by @yilecoding in #196
  • fix(deps): 1.0 前依赖审计 —— npm 0 严重 · Python 0 已知漏洞 · python-jose 换成 PyJWT(#193) by @yilecoding in #197
  • chore(release): 版本号 0.12.0 by @yilecoding in #201

Full Changelog: v0.11.0...v0.12.0

v0.11.0

Choose a tag to compare

@github-actions github-actions released this 31 Oct 06:29

这一版的主要内容

公告二期(#190 / #191)。

  • 发布范围:按部门(含下级)/ 角色 / 指定人发;后来进部门的人自动在范围内。铃铛、详情、附件下载三处看的是同一份范围
  • 定时发布 / 到期自动撤回
  • 登录后弹窗,可以设成「必须确认」—— 只能点「我已阅读」关掉,「全部已读」不能替人确认
  • 顶部横幅:置顶 + 紧急 + 还没读的公告;关掉就算已读
  • 登录页公告:勾了「公开」的公告在登录页显示纯文本摘要(匿名接口,每个 IP 每分钟 30 次);有发布范围的公告不能公开
  • 阅读统计:在管理列表里看谁读了、谁没读
  • 新建的账号不再一登录就几十个红点(建号之前的广播算已读,还在发的「必须确认」公告除外)
  • 有发布范围的公告不推群机器人(群里是所有人)
  • 移动端:登录屏公告、登录后弹窗、首页横幅、详情页「我已阅读」;退出登录会清缓存,换账号不会看到上一个人的定向公告

升级

  • 有数据库迁移 ag000000noticephase2:pnpm db:upgrade,镜像部署时 migrate 服务会自动跑
  • 新增调度任务 notice.sync_inbox(每 60 秒)。定时发布和到期撤回都靠它,beat 和 worker 都要在跑
  • 要回滚的话,降级会先把「有发布范围的」和「还没到发布时间的」公告改成隐藏 —— 旧版本不认识这两样,不这么做就会当成全员公告立刻放出去

桌面客户端

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(notice): 公告二期 —— 发布范围 · 定时发布 · 登录后弹窗 / 必须确认 · 顶部横幅 · 登录页公告 · 阅读统计(#190) by @yilecoding in #191

Full Changelog: v0.10.0...v0.11.0

v0.10.0

Choose a tag to compare

@github-actions github-actions released this 31 Oct 06:29

这一版的主要内容

公告一期(#189)。以前普通用户在任何地方都读不到公告正文 —— 点铃铛里的公告会跳进管理页,然后 403。这一版把「读公告」和「管公告」分开了。

  • 人人能读:铃铛 / 消息中心 / 工作台点公告,就地打开阅读抽屉,正文 + 附件(预览 / 下载);/notification?notice=<id> 可以直接发给别人
  • 置顶 / 级别 / 过期时间;附件随表单一起提交,不用先保存再去传
  • 移动端:首页「公告」组 + 详情屏,附件交给系统分享面板
  • 🔴 权限收紧(升级后行为会变):
    • 隐藏的公告和挂在上面的附件,以前任何登录用户都拿得到、下得到,现在一律 404
    • 管理列表和详情要 sys:notice:add 权限
    • 往公告上挂附件要公告自己的权限 —— 以前有上传权限就能把任意文件挂到任意公告上,等于公开给所有人
  • 公告隐藏 / 删除时,已经发进收件箱的那一行跟着撤回;推送改在数据库提交之后发(以前偶尔拉到旧的未读数)

升级

有数据库迁移 af000000noticereach:pnpm db:upgrade,镜像部署时 migrate 服务会自动跑。旧收件箱里的公告行按标题恰好对上一条才关联,对不上的保持原样。

桌面客户端

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(notice): 公告触达面 —— 人人能看的公告详情 · 附件可预览 / 下载 · 工作台 / 铃铛 / 移动端入口 · 置顶 / 级别 / 有效期(#186 一期) by @yilecoding in #189

Full Changelog: v0.9.1...v0.10.0

v0.9.1

Choose a tag to compare

@github-actions github-actions released this 30 Oct 08:42

这一版的主要内容

v0.9.0 群机器人发版后补的评审修复(#187)。用了群机器人的实例建议尽快升级。

  • 🔴 Webhook 地址不再写进日志:v0.9.0 里,每次往群里发消息,httpx 都会把带 token 的完整地址记进 API 和 worker 的日志。拿到这个地址就能往你的群里发消息
    • 升级后建议在飞书 / 钉钉 / 企业微信里重置机器人的 Webhook 地址(有加签的话一起换密钥),再到「消息推送 → 群机器人」里更新;旧日志里的地址按凭据泄露处理
  • 🔴 地址校验不能再用 ../ 绕过:v0.9.0 里 …/hook/../../../其他路径 能通过官方地址前缀校验,配了 NOTIFICATION_BOT_EXTRA_URL_PREFIXES 的部署可以借服务器访问那台主机上的任意路径
  • 飞书 ↔ 钉钉换平台、密钥框留空时,不再沿用上一家的加签密钥(之前会导致每条都签名失败、不重试)
  • 消息已经进群时,投递记录不会再被误记成「结果未知」;限流计数出错时照常发送,不再把这条消息丢掉
  • 轮换 NOTIFICATION_ENCRYPT_SECRET_KEY 后点「发测试消息」,显示「配置错误」而不是 500
  • 「Webhook 端点已停用」的通知里,端点地址去掉查询串和用户名密码,订阅到群里时不会把对接方的 token 推出去
  • 编辑群机器人时,已经不能订阅的通知类型会列出来,取消勾选就能保存(之前保存一直报错)
  • 英文界面群机器人卡片上的签名状态显示正确(之前误显示成 "Approver added")
  • 新增接入指南 docs/guides/notify-bot.md:从建飞书机器人到发测试消息、报错对照,外加设计方法和两道练习

升级不需要改配置、没有数据库迁移。

桌面客户端

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

  • fix(task): 页面上停用 / 改 / 删即时生效 · 一条不到期的调度不再堵死 beat · PostgreSQL 下 crontab 不再按 UTC 钟点(#183) by @yilecoding in #185
  • fix(notification): 群机器人补评审 —— Webhook 地址不进日志(API + worker)· 路径点段绕过前缀 · 换平台丢旧密钥 · 投递终态不被卡片更新回滚 by @yilecoding in #187
  • chore(release): v0.9.1 —— 群机器人评审修复 by @yilecoding in #188

Full Changelog: v0.9.0...v0.9.1