Skip to content

v1.0.1

Choose a tag to compare

@github-actions github-actions released this 06 Nov 05:43
· 281 commits to main since this release

这一版的主要内容

1.0.0 之后的第一个修订版。网页端、后端、桌面端只有修复,没有新功能,也没有破坏兼容承诺;重点是五个安全修复。

安全

  • OAuth2 陌生账号默认不再自动建号(#236,关 #226):原来任何 GitHub / Google 账号走一遍第三方登录就成了系统用户,而且挂到哪个角色取决于数据库行序。现在需要显式开启 OAUTH2_AUTO_REGISTER,并用 OAUTH2_AUTO_REGISTER_ROLE 指定角色编码
  • OAuth2 只按第三方验证过的邮箱关联已有用户(#238,#227)
  • OAuth2 的 state 绑定到发起授权的浏览器,堵住 login CSRF(#248,#227)
  • 任务调度 / 执行记录的读接口、/sys/users/{pk}/roles 补上权限校验(#235,关 #228):原来任何登录用户都能读到所有任务的参数、执行结果和报错堆栈
  • 图形验证码答错一次就作废(#242,关 #229)

修复

  • 第三方登录被拒时回到前端页面显示原因,不再停在一页 JSON 上;移出角色前查不到剩余角色时明确报错(#256,发版前评审)
  • api 镜像不再带进任何 .env;web 镜像补拷 packages/api 清单(#240,#233)
  • 开放接口 Java SDK 的请求签名补上测试向量,verifyWebhook 不再区分请求头大小写(#239,#231)
  • 后端契约 schema.d.ts 加了新鲜度闸门(#241,#234);CI 与供应链加固:Actions 钉 SHA、迁移守卫改走真实升级路径、打 tag 前确认提交在 main 上且 CI 已绿(#237 / #243 / #247 / #256)
  • 查询区与表格的间距统一为 12px(#249)

移动端(预览版,版本号单独算,不在这次的安装包里)这段时间加了绑定手机号和审批(#225 / #244 / #252 / #254)。

升级说明

  • 2 条数据库迁移(aj000000tasklist · ak000000noticehtml),照常 pnpm db:upgrade,或者让 compose 里的 migrate 服务自动跑
  • 迁移会给已经能看到任务调度 / 执行记录页面的角色补上新的「查询」权限,升级前能看的,升级后照样能看。迁移不碰 Redis:部署后清一次 fba:user:*,否则已登录的非超管用户在 token 过期前打开这两页会 403
  • 依赖 OAuth2 自动建号的部署:升级后这个功能默认关闭,要显式开启并配置角色编码

桌面客户端

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

  • fix(security): OAuth2 陌生账号默认不自动建号(#226) by @yilecoding in #236
  • feat(mobile): 绑定手机号 · 「我的」只放入口 · 「应用」改成图标宫格(#224) by @ita201125 in #225
  • fix(security): 任务模块读接口与 /sys/users/{pk}/roles 补权限校验(#228) by @yilecoding in #235
  • fix(security): OAuth2 只按第三方验证过的邮箱关联已有用户(#227 前半) by @yilecoding in #238
  • ci: 「模型 ↔ 迁移一致」守卫改走真实的升级路径(#230) by @yilecoding in #237
  • fix(open-sdk): Java 请求签名补测试向量;verifyWebhook 不分头名大小写(#231) by @yilecoding in #239
  • ci: Actions 钉 SHA · release.yml 不插值 · dev 端口只绑本机(#232) by @yilecoding in #243
  • fix(docker): api 镜像挡住所有 .env;web 镜像补拷 packages/api 清单(#233) by @yilecoding in #240
  • fix(security): 图形验证码答错也作废(#229) by @yilecoding in #242
  • fix(contract): schema.d.ts 新鲜度闸门 · 移动端版本号单一来源(#234) by @yilecoding in #241
  • chore(deps): Bump the actions group across 1 directory with 11 updates by @dependabot[bot] in #245
  • chore(ci): Dependabot 大版本单独开 PR,不和 minor/patch 打包 by @yilecoding in #246
  • feat(mobile): 审批人这一侧 —— 收件箱 · 详情 · 全部动作(#224 2a) by @ita201125 in #244
  • fix(release): 打 tag 出包前确认提交在 main 上、且 CI 已绿(#232) by @yilecoding in #247
  • fix(security): OAuth2 state 绑定到发起授权的浏览器,堵 login CSRF(#227) by @yilecoding in #248
  • style(pages): 查询区与表格间距统一为 12px,收进 ListBody by @yilecoding in #249
  • docs: 项目介绍补上缘起、三端 monorepo 与「为 AI 协作而设计」 by @yilecoding in #250
  • docs(site): 首页改成克制版式 —— 留白、发丝线、线稿图示 by @yilecoding in #251
  • feat(mobile): 发起审批(#224 2b)· 置顶种子公告正文改 HTML by @ita201125 in #252
  • docs: 截图改成 2 倍真彩图并补上拍图脚本,文档站按高分屏出图 by @yilecoding in #253
  • feat(mobile): 样式收成一套共用件 —— 分组翻页行 · 搜索框 · 顶栏 · 头像 by @ita201125 in #254
  • chore(release): v1.0.1 by @yilecoding in #255
  • fix: v1.0.1 发版前评审修掉的四条 by @yilecoding in #256

New Contributors

Full Changelog: v1.0.0...v1.0.1