Skip to content

v0.9.1

Choose a tag to compare

@github-actions github-actions released this 30 Oct 08:42
· 473 commits to main since this release

这一版的主要内容

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