Repository navigation
v0.9.1
这一版的主要内容
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