Skip to content

v0.13.0

Choose a tag to compare

@github-actions github-actions released this 03 Nov 01:22
· 385 commits to main since this release

这一版的主要内容

  • 工作台个性化(#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