Repository navigation
v0.10.0
这一版的主要内容
公告一期(#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