Repository navigation
v0.13.0
这一版的主要内容
- 工作台个性化(#202):工作台以待办为中心,系统运行区只给管理员看;可以编辑布局(卡片按权限出现),布局按人存在服务端,换设备也在
- 页面美观度统一整改(#210,共 10 个 PR)
- 报错块原文折叠、任何宽度都看得到「重试」;主按钮禁用态改成中性灰;深色模式下主色文字提亮
- 去掉 7 个页面顶部固定的说明文字,需要知道的那半句挪到用得着的地方(弹窗 / 空状态 / 表单)
- 表格里的时间、耗时、空值、行操作统一成一套写法:蓝色 = 能点;行操作一律收进 ⋯,危险项在最后
- 工具栏按钮顺序统一:主动作 → 次要 → 刷新 / 列设置 → 危险操作
- 卡片页(模型供应商 / MCP 凭据 / 短信配置 / 群机器人 / 存储)统一键值区与「新增」卡,并补上刷新按钮;插件卡片去掉满屏的红色卸载按钮
- 深色模式:卡片和背景分得开、边框看得见;头像不再是写死的浅色亮斑;监控数字只在真正异常时上色
- 窄屏 / 手机:表格横向滚动有渐隐提示、主从页左栏不再铺满第一屏、查询区「搜索」和「重置」不拆开、监控统计卡两列
- 数据少的表格不再撑满到页面底部;审批中心等处的短时间对往年的记录补上年份;开放接口日志 / AI 确认页有了面包屑父级和页签图标
- 页面四边边距只在外壳给一次(#209),有
arch:check闸门防止回退
升级
- 有两条数据库迁移,部署时照常
alembic upgrade head(pnpm db:upgrade):ah000000userpref:新建sys_user_preference表(个人偏好 / 工作台布局)ai000000mcpicon:「MCP 凭据」菜单图标换成图形图标;只改还是旧图标的那一行,在菜单管理里自己改过的不覆盖
- 不用改配置
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(dashboard): 工作台个性化 —— 以待办为中心 · 系统运行区只给管理员 · 布局按人存服务端(#202) by @yilecoding in #203
- feat(docs): 公开文档站 —— Astro Starlight 中英双语,发到 Pages 根路径 by @yilecoding in #205
- feat(docs): 文档站默认中文、英文挪到 /en/;可同时发到自己的服务器(/docs) by @yilecoding in #206
- docs: 文档站补内容 —— 从零加业务模块 · 常见问题 · 版本升级 · 每步验收与上线清单 by @yilecoding in #207
- chore(docs): Google Search Console 站点验证文件 by @yilecoding in #208
- fix(shell): 页面四边 16px 只在外壳给一次 —— PageShell + arch:check 闸门(#209) by @yilecoding in #211
- fix(dashboard): 按代码评审修工作台 —— 步骤条不漏隐藏字段的人名 · 超时结论认对 · 数字用全量(#202) by @yilecoding in #204
- fix(ui): 去掉顶部说明文字 · 报错块 / 禁用态 / 深色主色 / 窄屏溢出(#210) by @yilecoding in #212
- feat(ui): 表格单元格收成一套 —— 时间 / 耗时 / 空值 / 行操作(#210) by @yilecoding in #213
- feat(ui): 工具栏按钮顺序统一 —— 主动作 → 次要 → 刷新 / 列 → 危险(#210) by @yilecoding in #214
- feat(ui): 卡片页键值区 / 新增格收成组件,主从页详情标题统一(#210) by @yilecoding in #215
- fix(ui): 窄屏专项 —— 顶栏残影、表格横向滚动提示、监控统计卡两列(#210) by @yilecoding in #216
- fix(ui): 手机上的主从页和查询区 —— 左栏列表封顶、搜索与重置不拆开(#210) by @yilecoding in #218
- feat(ui): 深色层次与颜色语义 —— 卡片底色、边框、头像、监控数字(#210) by @yilecoding in #217
- feat(ui): 插件卡片去掉满屏红点、卡片页补刷新(#210) by @yilecoding in #219
- feat(ui): P2 零散项 —— 短表格不撑满、单点平线、开放接口日志面包屑(#210) by @yilecoding in #220
- fix(ui): #210 漏掉的四处 —— ⋯ 菜单统一、短时间补年份、MCP 页签图标 by @yilecoding in #221
- chore(release): v0.13.0 by @yilecoding in #222
Full Changelog: v0.12.0...v0.13.0