v0.0.1

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
  • 正式交付请在有证书的机器上打包（Windows 代码签名证书 / Apple Developer ID + notarize）
• 🔴 macOS 上的自动更新不工作（未签名）。electron-updater 要校验运行中应用的代码签名，
  拿不到就拒绝安装更新。Windows 与 Linux(AppImage) 的自动更新正常
• 读卡器等本地硬件是桩模式：厂商的原生助手不在仓库里（那是现场的东西），
  所以这个包里没有。界面上相关功能会走模拟数据
• 打印：Windows 上是真的静默打印；macOS/Linux 上打印链路能跑，但没有在真机标签机上验过

更新从哪来

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

---

What's Changed

• fix(e2e): list-error 断言不再假设 admin 在默认第一页 by @yilecoding in #20
• docs: 定 GitHub Flow 分支模型，main 上线 ruleset 保护 by @yilecoding in #18
• feat: 命令面板（⌘K）+「发新版了请刷新」提示（#9 / #10） by @yilecoding in #21
• fix(ci): 失败 issue 改成「一个 ref 只留一条」，绿了自动关 by @yilecoding in #26
• chore(brand): 登录页技术栈换成 shadcn/Tailwind，不再突出数据库 by @yilecoding in #25
• chore(ci): 删掉「失败自动开 issue」，红绿信号只留现成的三处 by @yilecoding in #27
• docs(readme): 组件库那节太重,砍掉细节只留验证命令和链接 by @yilecoding in #28
• fix(deploy): celery worker/beat 的健康检查一直是假阴性 by @yilecoding in #31
• fix(deploy): worker 健康检查换成读 /proc，别再靠 inspect ping by @yilecoding in #33
• fix: 换身份清空标签页，别把上一个人的 tab 留给下一个人 by @yilecoding in #32
• fix(seed): 公开演示数据补齐 mysql/postgresql by @yilecoding in #35
• fix: 列表页能刷新了——搜索变成幂等重取、每页一个刷新按钮、重新加载不再是空操作 by @yilecoding in #37
• fix(ui): 刷新按钮挪到「列」前面，主动作保持在最前 by @yilecoding in #38
• feat(desktop): 打 tag 就出安装包 —— 发布这一环接上 GitHub by @yilecoding in #40
• fix(security): 读接口只挂 DependsJwtAuth 等于退出鉴权 by @yilecoding in #41
• fix(release): 试跑产物收窄到安装包本体，并允许预发布 tag by @yilecoding in #42
• fix(desktop): 打包发布收口 —— 两个只在正式包里才炸的更新 bug + per-user 安装 by @yilecoding in #43
• fix(release): 别让 electron-builder 自己传 —— 它会建出两个草稿 by @yilecoding in #44
• feat(release): 三个平台一起出包 —— Windows / macOS / Linux，外加一份像样的发布说明 by @yilecoding in #45

New Contributors

• @yilecoding made their first contribution in #20

Full Changelog: https://github.com/yilecoding/fastapi-react-admin/commits/v0.0.1