Repository navigation
v0.12.0
这一版的主要内容
1.0 前的准备(#193)。依赖有安全修复,建议升级。
- 🔴 依赖安全(#197)
- 网页端:富文本(粘贴 XSS)、文件预览(dompurify)、路由、表单校验等打进浏览器的依赖全部升到修复版;
pnpm audit --prod从 3 严重 / 43 高危降到 0 严重 / 2 高危(剩下两个在移动端的命令行工具链里,没有同大版本的修复,不进网页包) - 后端:13 个有漏洞的包全部升级(含 Pillow 13、aiohttp、pypdf、tornado、urllib3),
pip-audit0 条 - JWT 库从 python-jose 换成 PyJWT:python-jose 的 CVE-2026-85394 没有修复版。解码时只认配置的那一个算法,换算法 / 换密钥 /
alg=none的 token 一律拒绝
- 网页端:富文本(粘贴 XSS)、文件预览(dompurify)、路由、表单校验等打进浏览器的依赖全部升到修复版;
- 移动端可以用手机验证码登录了(#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