16 Commits
Author SHA1 Message Date
sloray 4794bed2cf ci: npm 装 pnpm 前先清掉残留影子文件(EEXIST),并去掉 npm 不认的 store-dir
构建客户端 / 检查(类型 + 单元测试) (push) Successful in 1m10s
构建客户端 / macOS 通用(.app + .dmg) (push) Skipped
构建客户端 / Windows x64(NSIS 安装包) (push) Failing after 32s
构建客户端 / Linux x64(deb + AppImage) (push) Successful in 6m20s
2026-10-15 23:29:39 +08:00
sloray e6070f91ee ci: Windows 改用 npm 装的 JS 版 pnpm(standalone 二进制在低完整性沙箱里必崩)
构建客户端 / 检查(类型 + 单元测试) (push) Successful in 1m9s
构建客户端 / macOS 通用(.app + .dmg) (push) Skipped
构建客户端 / Windows x64(NSIS 安装包) (push) Failing after 22s
构建客户端 / Linux x64(deb + AppImage) (push) Canceled after 1m14s
2026-10-15 23:27:06 +08:00
sloray 26731958ea ci: Windows 的 pnpm install 加 corepack 退路(standalone 在低完整性沙箱里栈溢出)
构建客户端 / 检查(类型 + 单元测试) (push) Successful in 1m10s
构建客户端 / macOS 通用(.app + .dmg) (push) Skipped
构建客户端 / Windows x64(NSIS 安装包) (push) Failing after 40s
构建客户端 / Linux x64(deb + AppImage) (push) Canceled after 1m37s
2026-10-15 23:24:13 +08:00
sloray de7263569c ci: Windows 的 pnpm 安装目录改成每次运行都干净的路径
构建客户端 / 检查(类型 + 单元测试) (push) Successful in 1m11s
构建客户端 / macOS 通用(.app + .dmg) (push) Skipped
构建客户端 / Windows x64(NSIS 安装包) (push) Failing after 28s
构建客户端 / Linux x64(deb + AppImage) (push) Canceled after 1m36s
run 13 里 装 Rust 这次是好的(上次那个 panic 是两轮运行重叠、同时写 ci-rustup 造成的),
但 装 pnpm 挂了:

    [Error: ENOTEMPTY: directory not empty, rmdir
      'C:\Users\admin\runner\windows\cache\ci-pnpm\node_modules\.bin\store\v11\projects']

原因是这个 dest 是固定路径:pnpm 把自己算出来的 store 建在 dest 里面(就是之前日志里
那个很怪的 <dest>\node_modules\.bin\store\v11),下一轮 action 的自安装器要清掉旧目录
时,嵌套的 store\v11\projects 非空,rmdir 就失败了。

改成 ${{ github.workspace }}\..\ci-pnpm —— 落在本次运行的 work 目录里,每次都是干净的,
同时也还满足"低完整性只能写 runner 自己的工作目录"。机器上那个被污染的
cache\ci-pnpm 已经删掉。
2026-10-15 23:21:16 +08:00
sloray c9ce7b64ef ci: 删掉两段临时诊断(Windows 的坑已经查清并写进文件头第 5 条)
构建客户端 / 检查(类型 + 单元测试) (push) Successful in 1m13s
构建客户端 / macOS 通用(.app + .dmg) (push) Skipped
构建客户端 / Windows x64(NSIS 安装包) (push) Failing after 17s
构建客户端 / Linux x64(deb + AppImage) (push) Canceled after 1m1s
2026-10-15 23:18:53 +08:00
sloray f3b09ca9a6 ci: Windows 的 pnpm 那步写死 shell: pwsh(免得 actionlint 拿 bash 规则挑反斜杠路径)
构建客户端 / 检查(类型 + 单元测试) (push) Successful in 1m9s
构建客户端 / macOS 通用(.app + .dmg) (push) Skipped
构建客户端 / Windows x64(NSIS 安装包) (push) Failing after 19s
构建客户端 / Linux x64(deb + AppImage) (push) Canceled after 2m1s
2026-10-15 23:15:36 +08:00
sloray 1cccc1aa00 ci: Windows job 给 pnpm install 明确指定 store 与导入方式
构建客户端 / 检查(类型 + 单元测试) (push) Canceled after 6s
构建客户端 / Linux x64(deb + AppImage) (push) Canceled after 0s
构建客户端 / Windows x64(NSIS 安装包) (push) Canceled after 0s
构建客户端 / macOS 通用(.app + .dmg) (push) Canceled after 0s
run 10 已经过了 store 操作锁那一关(pnpm 开始下载包了),但接着崩了:

    Downloading @tauri-apps/cli-win32-x64-msvc@2.12.2: 0.00 B/7.98 MB
    Content-addressable store is at:
      C:\Users\admin\runner\windows\cache\ci-pnpm\node_modules\.bin\store\v11
    thread '<unknown>' (6500) has overflowed its stack
    ##[error]Process completed with exit code 1.

两个可疑点:一是 pnpm 自己算出来的 store 路径很怪(挂在 pnpm 安装目录的
node_modules\.bin 下面,而且我在 env 里设的 npm_config_store_dir 它压根没用);
二是硬链接导入。所以这一步直接给 CLI 参数:显式短路径 store、copy 导入(不走硬链接)、
append-only 输出(默认 reporter 在 CI 日志里全是重画)。
2026-10-15 23:15:20 +08:00
sloray f0538fa233 ci: Windows job 加 USERPROFILE 重定向 —— pnpm 的操作锁按它算路径
构建客户端 / 检查(类型 + 单元测试) (push) Successful in 1m9s
构建客户端 / macOS 通用(.app + .dmg) (push) Skipped
构建客户端 / Windows x64(NSIS 安装包) (push) Failing after 33s
构建客户端 / Linux x64(deb + AppImage) (push) Successful in 6m4s
run 9 的诊断2 已经把话说死了:

    LOCALAPPDATA = C:\Users\admin\runner\windows\cache\ci-localappdata   <- 重定向生效
    OK   ...\ci-localappdata\pnpm-store-operation-locks                  <- 目录能建
    Error: ERR_PNPM_STORE_DIR_OPEN_OPERATION_LOCK
      Failed to open the store operation lock at
      "C:\Users\admin\AppData\Local\pnpm-store-operation-locks\all-stores.lock"

也就是说 LOCALAPPDATA 指走了,pnpm 还是去开原来那个路径。本机复现出真正的规则:
只改 USERPROFILE(LOCALAPPDATA 不动)、store 换成一个全新的空目录时,
    <新 USERPROFILE>\AppData\Local\pnpm-store-operation-locks\all-stores.lock
    <新 USERPROFILE>\AppData\Local\pnpm-store-operation-locks\<hash>.lock
立刻出现 —— pnpm 是按 <USERPROFILE>\AppData\Local 算的,跟 LOCALAPPDATA 无关。

所以在那一步里再建一个 ci-profile,把 AppData\Local / AppData\Roaming 先建好,然后
把 USERPROFILE 写进 GITHUB_ENV。文件头第 5 条同步更新。
2026-10-15 23:06:35 +08:00
sloray 47ef7c63dd ci(diag): 再探一次 —— pnpm 眼里的目录到底是哪个
构建客户端 / 检查(类型 + 单元测试) (push) Successful in 1m15s
构建客户端 / macOS 通用(.app + .dmg) (push) Skipped
构建客户端 / Windows x64(NSIS 安装包) (push) Failing after 23s
构建客户端 / Linux x64(deb + AppImage) (push) Canceled after 2m38s
run 8 里 LOCALAPPDATA 已经在 job env 里指向 ci-localappdata,但 pnpm 仍然去开
C:\Users\admin\AppData\Local\pnpm-store-operation-locks\all-stores.lock(拒绝访问)。
所以要么这个变量没进到那一步,要么 pnpm 不是从环境变量推这个路径。加一步(在装完
pnpm 之后、装依赖之前)把它问清楚:LOCALAPPDATA/APPDATA 的实际值、pnpm 的路径与版本、
pnpm config list 的输出,以及"两个候选锁目录能不能建"。查完删。
2026-10-15 23:02:12 +08:00
sloray b74c6654e5 ci: Windows job 再加 LOCALAPPDATA/APPDATA 重定向(pnpm 的 store 锁挂在这里)
构建客户端 / 检查(类型 + 单元测试) (push) Successful in 1m7s
构建客户端 / macOS 通用(.app + .dmg) (push) Skipped
构建客户端 / Windows x64(NSIS 安装包) (push) Failing after 22s
构建客户端 / Linux x64(deb + AppImage) (push) Successful in 5m54s
run 7 的 Windows job 已经过了 rustup / pnpm / node 三步 —— 低完整性那套重定向起效了
(诊断输出确认:RUSTUP_HOME / CARGO_HOME / RUNNER_TOOL_CACHE / npm_config_* 都指到了
runner 自己的工作目录)。新的失败在"前端依赖":

    pnpm install --frozen-lockfile
    ... pnpm-store-operation-locks\all-stores.lock": 拒绝访问。(os error 5)

pnpm 12 的 store 操作锁与 cache/state 不在 store-dir 下面,而是挂在 %LOCALAPPDATA%
(本机实测:把 LOCALAPPDATA 指到别的目录后,pnpm 会在那里建 pnpm-cache / pnpm-state,
install 正常退出)。所以 job env 里再加两条:

    LOCALAPPDATA: C:\Users\admin\runner\windows\cache\ci-localappdata
    APPDATA:      C:\Users\admin\runner\windows\cache\ci-appdata

顺带覆盖到 tauri 打包时下载 NSIS 的缓存目录(它也在 LOCALAPPDATA 下)。
2026-10-15 22:52:46 +08:00
sloray ac3d639d6b ci: Windows job 低完整性适配 —— 把 CI 的"家目录"挪到 runner 自己的工作目录
构建客户端 / 检查(类型 + 单元测试) (push) Successful in 1m12s
构建客户端 / macOS 通用(.app + .dmg) (push) Skipped
构建客户端 / Windows x64(NSIS 安装包) (push) Failing after 57s
构建客户端 / Linux x64(deb + AppImage) (push) Successful in 6m5s
诊断步骤(在 job 里跑的写探测)给出了确定答案:

    whoami    = timi\admin
    integrity = Mandatory Label\Low Mandatory Level  S-1-16-4096     <-- 低完整性
    FAIL: C:\Users\admin\.rustup\tmp\probe.txt      Access denied
    FAIL: C:\Users\admin\.cargo\probe.txt           Access denied
    FAIL: C:\Users\admin\.cargo\registry\probe.txt  Access denied
    OK  : C:\Users\admin\runner\windows
    OK  : C:\Users\admin\runner\windows\cache
    OK  : <work>\ci-probe

不是 ACL 问题(SYSTEM / Administrators / timi\admin 全 F,没有 Deny),是 Windows 的
"低完整性不能写中完整性"。同一个账户在交互式会话(Medium,实测 S-1-16-8192)里往
~/.rustup、~/.cargo 写得进去,job 里就全被拒。于是前面几个看起来毫不相干的错误都是
同一个原因:Git Bash /tmp 被拒(TEMP 不可写时它退回 <Git>\tmp)、rustup 建不了临时
文件。%TEMP%、%LOCALAPPDATA% 也一样中招。

处置(Windows job 内):
  * env 增加 RUSTUP_HOME / CARGO_HOME / npm_config_cache / npm_config_store_dir /
    RUNNER_TOOL_CACHE,全部指向 C:\Users\admin\runner\windows\cache\ci-*(探测过可写)
  * pnpm/action-setup 的 dest 从默认 ~/setup-pnpm 改到同一个 cache 下
  * TEMP/TMP/TMPDIR 上一版已经指到 workspace 同级的 ci-tmp
文件头第 5 条写清了这个坑、表现、以及从根上的解法(让 gitea-runner 以中完整性启动)。
临时诊断步骤暂时保留,等 Windows 真编出包来再删。
2026-10-15 22:44:05 +08:00
sloray 2ed16ff88d ci(diag): 在 Windows job 里加一段临时诊断(查完删)
构建客户端 / 检查(类型 + 单元测试) (push) Successful in 1m8s
构建客户端 / macOS 通用(.app + .dmg) (push) Skipped
构建客户端 / Windows x64(NSIS 安装包) (push) Failing after 13s
构建客户端 / Linux x64(deb + AppImage) (push) Successful in 6m7s
run 5 里 bash 那两个坑都过去了,卡在第三处:rustup 建临时文件被拒

    error: could not create temp file C:\Users\admin\.rustup\tmp\ajq4dt9h0_e7oonj_file
    拒绝访问。 (os error 5)

同一个账户在这个交互式会话里能往那个目录写、ACL 也是正常的(SYSTEM/Administrators/
TIMI\admin 全 F,没有 Deny)。runner 进程属主是 TIMI\admin,计划任务 GiteaRunner-Windows
是 admin / Limited(非提权)。所以差异只在 job 内部的令牌/完整性级别上 —— 让 job 自己
报:whoami、Mandatory Label、TEMP/TMP、RUSTUP_HOME/CARGO_HOME,并对 6 个候选目录逐个
做"建目录 + 写文件 + 删文件"探测。这是临时步骤,拿到结论就删。
2026-10-15 22:31:56 +08:00
sloray 6f83ebbe3c ci: 修 Windows job 第二个坑 —— TEMP/TMP 为空,Git Bash 的 mktemp 写不进 <Git>\tmp
构建客户端 / 检查(类型 + 单元测试) (push) Successful in 1m27s
构建客户端 / macOS 通用(.app + .dmg) (push) Skipped
构建客户端 / Windows x64(NSIS 安装包) (push) Failing after 12s
构建客户端 / Linux x64(deb + AppImage) (push) Successful in 6m4s
run 4 里 bash 已经换成 Git for Windows(那一步本身就成功了),但 dtolnay/rust-toolchain
还是挂在它的脚本里:

    log=$(mktemp)
    mktemp: failed to create file via template '/tmp/tmp.XXXXXXXXXX': Permission denied

原因:这个 job 的环境里 TEMP/TMP 是空的,而 Git Bash 的 /tmp 是从 TEMP 推出来的;
没有 TEMP,MSYS 就退回 <Git 安装目录>\tmp(C:\Program Files\Git\tmp,实测存在),
那个目录普通权限写不进去 —— mktemp 于是 Permission denied,不是"没目录"也不是
"没权限建文件"那么直白。

本机(就是这台 runner)复现 + 验证:
    清空 TEMP/TMP                -> mktemp: ... Permission denied(与 CI 一字不差)
    TEMP/TMP 指向可写目录        -> mount 显示 "... on /tmp",mktemp 正常
                                    rustup toolchain install / target add 也全过

修法:把 Windows job 里"改 PATH 那一步"扩成同时安排临时目录 —— 在 workspace 的同级
建 ci-tmp,把 TEMP/TMP/TMPDIR 写进 GITHUB_ENV,后续步骤(包括 composite action 内部
的 bash)都用它。
2026-10-15 22:21:36 +08:00
sloray 4667d94c45 ci: 修 Windows job 0 秒失败 —— 宿主 runner 上的 bash 是 WSL,不是 Git Bash
构建客户端 / 检查(类型 + 单元测试) (push) Successful in 1m7s
构建客户端 / macOS 通用(.app + .dmg) (push) Skipped
构建客户端 / Windows x64(NSIS 安装包) (push) Failing after 13s
构建客户端 / Linux x64(deb + AppImage) (push) Successful in 6m51s
run 3 里 Windows job 挂在第二步、耗时 0 秒:
    装 Rust(stable)  [failure]  14:01:42 → 14:01:42
    装 pnpm / 装 Node / 前端依赖 / 打包 / 上传产物  [skipped]
日志里是一串被当 UTF-8 解码的 GBK:
    ?b?~? 0   ?Nx?  B a s h / E _ A C C E S S D E N I E D
    ... https://github.com/microsoft/WSL/issues
就是 WSL 的 E_ACCESSDENIED:这台 runner 是宿主直跑,PATH 上的 `bash` 指向
C:\Windows\System32\bash.exe(WSL 启动器),而 WSL 在 runner 账户下起不来。于是
所有 shell: bash 的步骤、以及用 bash 写的 composite action(dtolnay/rust-toolchain
就是),都会在 0 秒内失败。

修法:Windows job 的 checkout 之后插一步(shell: pwsh),把
"C:\Program Files\Git\bin" 写进 GITHUB_PATH —— 它的语义是前置插入,会盖过 System32
那个 WSL 版 bash。本机(就是这台 runner)实测通过:
    bash -> C:\Program Files\Git\bin\bash.exe
    rustup toolchain install stable --profile minimal      exit=0
    rustup target add --toolchain stable x86_64-pc-windows-msvc  exit=0
    rustup run stable rustc --version / cargo --version    exit=0
在仓库根目录跑也一样:根 rust-toolchain.toml 的 `esp` override 不影响这几条命令,
只有裸 rustc/cargo 才会撞上它,而 workflow 里没有这种步骤。

顺带:run 3 里 Linux 那条是好的(检查 2m42s、Linux 9m14s 全绿)。
2026-10-15 22:10:57 +08:00
sloray 76b96cc374 ci: Windows 产物默认就编(平台开关从 vars 换成 inputs)
构建客户端 / 检查(类型 + 单元测试) (push) Successful in 2m42s
构建客户端 / macOS 通用(.app + .dmg) (push) Skipped
构建客户端 / Windows x64(NSIS 安装包) (push) Failing after 27s
构建客户端 / Linux x64(deb + AppImage) (push) Successful in 9m14s
现象:Windows runner 明明在线、job 也确实派给了 windows-runner-01(它自己的日志:
"Runner labels: windows-latest, windows-2025, windows-2022"),但每次运行里
Windows 产物都是 skipped。

原因在 job 级 if 上:
    (github.event_name != 'workflow_dispatch' && vars.ENABLE_WINDOWS == 'true')
Gitea 的 runner 在 job 级 if 里拿不到(或拿不对)vars 上下文,条件恒为假 —— 而这个
条件写反的代价是"静悄悄不编",不看 runner 日志根本看不出来。同一份文件里
`github.event.inputs.linux != 'false'` 这个形式在 runner 日志里能看到正常求值
(evaluating expression '...' evaluated to 'true'),所以三个平台统一成这种形式:

  Linux / Windows : github.event.inputs.<平台> != 'false'   → 默认跑
  macOS           : github.event.inputs.macos == 'true'     → 默认不跑(还没有机器)

同时把 workflow_dispatch 里 windows 的默认值改成 true,并更新文件头:写清三台
runner 各自声明的标签、为什么不能拿 Linux 交叉编 Windows/macOS、以及第 4 条——
平台开关不要用仓库变量(附上这次的证据)。

runs-on 里的 vars.RUNNER_* 保持不变(标签不匹配时用它们覆盖)。
2026-10-15 21:58:02 +08:00
sloray 03f7279b53 ci: 修两处 Gitea 上跑不了的东西(upload-artifact v4 → v3、去掉缓存)
构建客户端 / 检查(类型 + 单元测试) (push) Successful in 1m22s
构建客户端 / Linux x64(deb + AppImage) (push) Successful in 7m2s
构建客户端 / macOS 通用(.app + .dmg) (push) Skipped
构建客户端 / Windows x64(NSIS 安装包) (push) Skipped
第一次真实运行的日志(job 14)钉出来的两件事:

1. 上传产物那一步一直是失败的:
     GHESNotSupportedError: @actions/artifact v2.0.0+, upload-artifact@v4+
     and download-artifact@v4+ are not currently supported on GHES
   v4 里的 @actions/artifact 会拒绝非 github.com 的服务器。Gitea 实现的是 v3 那套
   接口(ACTIONS_RUNTIME_URL),所以三个平台都换成 upload-artifact@v3,并加一个
   .github/actionlint.yaml 把"v3 太旧"这条 GitHub 规则的误报关掉(原因写在里面)。

   产物路径本身没问题:日志里 tauri build 已经产出 deb/AppImage,v4 在报错之前也
   认出了那批文件("The least common ancestor is .../release/bundle")。

2. 缓存服务在 job 容器里连不上:
     Failed to restore: getCacheEntry failed: connect ETIMEDOUT 172.18.0.2:37315
   setup-node 的 cache: pnpm 每次要干等 4 分 39 秒才放弃,cargo 缓存那步也白等 26 秒。
   先全部去掉(两个 job 每轮省约 10 分钟),文件头第 3 条写明了等缓存修好怎么加回来。

其余在真机上都是绿的:rustup 兜底、pnpm 12.11.2、Node 24.22.0、tsc、vite、
protocol 15 / cam-core 80 / src-tauri 30 个测试、tauri build(deb + AppImage)全过。
2026-10-15 20:49:25 +08:00
2 changed files with 207 additions and 108 deletions
+16
View File
@@ -0,0 +1,16 @@
# actionlint 配置。
#
# 这个仓库的 CI 跑在 Gitea 上,但 actionlint 用的是 GitHub 的规则,所以有一条
# 政策性的误报要忽略掉:
#
# the runner of "actions/upload-artifact@v3" action is too old to run on GitHub Actions
#
# 它对 GitHub 是成立的(v3 声明的 node16 运行时 GitHub 已经不再执行),但我们是
# Gitea:Gitea 的 runner 用自己的 node 跑 JS action,v3 能正常把产物传上去;反过来
# v4 在 Gitea 上**根本跑不了** —— v4 里的 @actions/artifact 会拒绝非 github.com
# 的服务器(GHESNotSupportedError,原文见 .github/workflows/build-client.yml 文件头
# 第 3 条,那是 2026-10-15 第一次真实运行的日志里抄下来的)。
paths:
.github/workflows/*.yml:
ignore:
- 'the runner of "actions/upload-artifact@v3" action is too old to run on GitHub Actions'
+191 -108
View File
@@ -2,41 +2,94 @@
#
# 产物都挂在这次运行下面(Actions 页面直接下载),保留 14 天:
# Linux x64 deb + AppImage cam-desktop_<版本>_amd64.deb / .AppImage ← 默认每次编
# Windows x64 NSIS 安装包 cam-desktop_<版本>_x64-setup.exe ← 有 runner 才编
# macOS 通用 .app + .dmg arm64 与 x86_64 合成一个包 ← 有 runner 才编
# Windows x64 NSIS 安装包 cam-desktop_<版本>_x64-setup.exe ← 默认每次编
# macOS 通用 .app + .dmg arm64 与 x86_64 合成一个包 ← 还没有机器,手动勾选才编
#
# ── 触发 ─────────────────────────────────────────────────────────────────────
# * push 到 main/master —— 只认 desktop/、protocol/ 与本文件的改动,改固件不会
# 白占 runner
# * 打 v* tag、开 PR
# * 手动 Run workflow:逐个平台勾选,不进 paths 过滤("就想编一次"走它)
# Windows 与 macOS 两个 job 目前默认不跑,原因与打开方式见下面第 1 条。
# 平台开关一律看勾选框(理由见下面第 4 条)。
#
# ── 跑在 Gitea 上要先对上的两件事 ────────────────────────────────────────────
# 1. runner 标签是注册 runner 时自己起的名字,猜不到,所以三个 job 都写成
# "仓库变量优先、常见标签兜底":
# runs-on: ${{ vars.RUNNER_LINUX || 'ubuntu-latest' }}
# 标签对不上时 job 是**排队**而不是报错 —— 排队会一直占着这次运行不结束,
# 所以第一次跑之前先看一眼 runner 页面上那几行标签。
# 所以上线新平台前先看一眼 runner 页面上那几行标签。
#
# 本仓库目前只有 Linux 的两个 runner 标签(ubuntu-latest / ubuntu-24.04 /
# ubuntu-22.04),所以**默认只跑 Linux**:Windows 与 macOS 两个 job 要等
# 仓库变量 ENABLE_WINDOWS / ENABLE_MACOS 设成 true 才会跑(手动 Run workflow
# 时另看勾选框),机器的标签则用 RUNNER_WINDOWS / RUNNER_MACOS 指过去。
# 等那两台机器上的 runner 注册好再打开,否则每次 push 都会多出两个永远排队的
# job。
# 2026-10-15 实测在线的(括号里是它们自己声明的标签):
# * simba-runner-01 (ubuntu-latest / ubuntu-24.04 / ubuntu-22.04)
# * windows-runner-01 (windows-latest / windows-2025 / windows-2022)
# * macOS:还没有
# 所以 Windows 默认就跑;macOS 的 job 写成"手动勾选才跑"。
#
# 为什么不能拿 Linux runner 交叉编出来:
# * Windows:Rust 侧用 mingw 交叉编还能出个裸 exe,但 tauri 的 NSIS 打包器
# 本身只能在 Windows 上跑,出不了安装包;
# * macOS:要 Apple SDK 与 codesign/lipo,只能在 macOS 上编。
# 所以这两个平台的 job 留着是为了"机器到位那天直接开",不是摆设。
# 那两台机器上要预装好:Windows 的 MSVC Build Tools(link.exe)、macOS 的
# Xcode Command Line Tools,以及 rustup(dtolnay/rust-toolchain 靠它装工具链)。
# Linux 的 job 通常跑在容器里,所以没装 rustup 也没关系 —— 见下面那步兜底。
# Windows runner 上要预装好 MSVC Build Tools(link.exe)、WebView2 运行时与
# rustup(dtolnay/rust-toolchain 靠它装工具链);macOS 上要 Xcode Command Line
# Tools + rustup。Linux 的 job 通常跑在容器里,没装 rustup 也没关系 —— 见兜底那步。
# 2. 这个文件放在 .github/workflows/ 下就够:Gitea 的 [actions] WORKFLOW_DIRS
# 默认值就是 [".gitea/workflows", ".github/workflows"](源码里的默认值,且
# .yml 与 .yaml 都认),所以两个目录都是原生支持的,不用挪。
# 3. 两处"GitHub 能跑、Gitea 上不行"的地方,都是 2026-10-15 第一次真实运行的
# 日志里钉出来的:
# * 传产物用 upload-artifact@v3,**不能用 v4**。v4 里的 @actions/artifact 会
# 拒绝非 github.com 的服务器,日志原文:
# GHESNotSupportedError: @actions/artifact v2.0.0+, upload-artifact@v4+
# and download-artifact@v4+ are not currently supported on GHES
# Gitea 实现的是 v3 那套接口(ACTIONS_RUNTIME_URL),所以 v3 能传上去。
# * 一个缓存都没开。这台实例的缓存服务在 job 容器里连不上,日志原文:
# Failed to restore: getCacheEntry failed: connect ETIMEDOUT 172.18.0.2:37315
# setup-node 的 cache 每次要干等 4 分 39 秒才放弃(两个 job 各一次)。
# 等缓存能从容器访问到了再加回来,写法就是:
# setup-node 的 with 里加:cache: pnpm / cache-dependency-path: desktop/pnpm-lock.yaml
# 各 job 里加:
# - uses: actions/cache@v4
# with:
# path: |
# ~/.cargo/registry/index
# ~/.cargo/registry/cache
# ~/.cargo/git/db
# key: ${{ runner.os }}-cargo-registry-${{ hashFiles('protocol/Cargo.lock', 'desktop/core/Cargo.lock', 'desktop/src-tauri/Cargo.lock') }}
# restore-keys: ${{ runner.os }}-cargo-registry-
# 4. 平台开关只用 github.event.inputs,**不用仓库变量**。2026-10-15 那次 Windows# runner 明明在线、job 也确实派给了它(它自己的日志里写着
# "Runner labels: windows-latest, windows-2025, windows-2022"),产物却一直是
# skipped —— 卡在 job 级 if 的 `vars.ENABLE_WINDOWS == 'true'` 上:Gitea 的
# runner 在 job 级 if 里拿不到(或拿不对)vars 上下文,而这个条件写反的代价是
# "静悄悄不编",最难发现。同一份文件里 `github.event.inputs.linux != 'false'`
# 这个形式在 runner 日志里能看到正常求值(evaluating expression '...' evaluated
# to 'true'),所以平台开关统一成这种:
# * Linux / Windows:`github.event.inputs.<平台> != 'false'` → 默认跑,
# 手动触发时取消勾选就不跑
# * macOS:`github.event.inputs.macos == 'true'` → 默认不跑,等有机器了改成
# 上一种形式即可
# runs-on 里的 vars(RUNNER_*)不受影响,标签不匹配时用那个覆盖。
# 5. Windows runner 的 job 跑在**低完整性**上(实测 Mandatory Label\Low Mandatory
# Level, S-1-16-4096),而 Windows 不允许低完整性往中完整性写:用户目录
# (~/.rustup、~/.cargo、%TEMP%、%LOCALAPPDATA%)统统 Access denied (os error 5)
# —— ACL 是干净的(SYSTEM / Administrators / 本人 全 F,没有任何 Deny),拦它的是
# 完整性级别,所以"放宽权限"一点用都没有。表现是一串看着毫不相干的错误:
# * Git Bash 的 mktemp 写 /tmp 被拒(它的 /tmp 跟着 TEMP 走;TEMP 不可写时退回
# <Git 安装目录>\tmp,那个目录普通权限进不去);
# * rustup: could not create temp file C:\Users\admin\.rustup\tmp\xxx_file
# 处置:Windows job 把能重定向的都指到 runner 自己的工作目录
# (C:\Users\admin\runner\windows\cache,job 内写探测实测可写)——
# RUSTUP_HOME / CARGO_HOME / npm_config_cache / npm_config_store_dir /
# RUNNER_TOOL_CACHE / LOCALAPPDATA / APPDATA,加上 TEMP/TMP/TMPDIR、
# pnpm/action-setup 的 dest,以及 **USERPROFILE**。
# 最后这个是被 pnpm 逼出来的:它的 store 操作锁不在 store-dir 下面,也不看
# LOCALAPPDATA,而是按 <USERPROFILE>\AppData\Local\pnpm-store-operation-locks
# 算 —— 只把 LOCALAPPDATA 指走它照样去开原来的路径(报错原文见 run 8 的日志),
# 把 USERPROFILE 指走它才跟着走(本机实测:探针 profile 下立刻出现
# all-stores.lock)。
# 想从根上解决:让 gitea-runner 以**中完整性**启动(在普通终端里跑
# run-runner.ps1,而不是从被沙箱化的低完整性 shell 里拉起来),那样这些重定向
# 就都可以撤掉。这台机器上 runner 由计划任务 GiteaRunner-Windows(admin /
# Limited)拉起,但进程链上的完整性已经落到了 Low。
#
# ── 三个平台都显式写 --target,这不是啰嗦 ────────────────────────────────────
# desktop/.cargo/config.toml 里钉着 `target = "aarch64-apple-darwin"`(本机开发用;
@@ -80,18 +133,18 @@ on:
- ".github/workflows/build-client.yml"
workflow_dispatch:
inputs:
# Linux 的 runner 有,默认勾上;另两个平台目前没有 runner,默认不勾 ——
# 勾了而没有对应 runner,那个 job 会一直排队。
# Linux 与 Windows 的 runner 都在线,默认勾上;macOS 还没有机器,默认不勾
# (勾了会一直排队)。开关为什么不用仓库变量见文件头第 4 条。
linux:
description: "构建 Linux(deb + AppImage)"
type: boolean
default: true
windows:
description: "构建 Windows(NSIS 安装包)——需要 Windows runner"
description: "构建 Windows(NSIS 安装包)"
type: boolean
default: false
default: true
macos:
description: "构建 macOS(通用 dmg)——需要 macOS runner"
description: "构建 macOS(通用 dmg)——还没有 macOS runner,勾了会排队"
type: boolean
default: false
@@ -148,7 +201,8 @@ jobs:
echo "$HOME/.cargo/bin" >> "$GITHUB_PATH"
fi
# pnpm 必须在 setup-node 之前:setup-node 的 cache: pnpm 要用它算 store 路径。
# pnpm 装在 setup-node 之前:这一步只靠 runner 镜像里自带的 node(实测
# /opt/hostedtoolcache 里有 24.x),而下面的 pnpm install 要用它。
- name: 装 pnpm
uses: pnpm/action-setup@v4
with:
@@ -158,8 +212,6 @@ jobs:
uses: actions/setup-node@v4
with:
node-version: ${{ env.NODE_VERSION }}
cache: pnpm
cache-dependency-path: desktop/pnpm-lock.yaml
- name: 前端依赖(严格按 lock 装)
working-directory: desktop
@@ -178,21 +230,6 @@ jobs:
with:
targets: x86_64-unknown-linux-gnu
# 只缓存 registry(crate 源码),不缓存 target/:自建 runner 的容器每次都是
# 干净的,几 GB 的 target 缓存拉下来的时间常常比重新编译还长,磁盘也扛不住。
# 缓存服务在不同 Gitea 版本上差异较大,所以失败不让它拖垮构建。
- name: cargo 缓存
uses: actions/cache@v4
continue-on-error: true
with:
path: |
~/.cargo/registry/index
~/.cargo/registry/cache
~/.cargo/git/db
key: ${{ runner.os }}-cargo-registry-${{ hashFiles('protocol/Cargo.lock', 'desktop/core/Cargo.lock', 'desktop/src-tauri/Cargo.lock') }}
restore-keys: |
${{ runner.os }}-cargo-registry-
# protocol 没有自己的 rust-toolchain.toml,会被根目录那个 `esp` 接住,
# 所以这里必须 +stable 显式指定。
- name: protocol 单元测试(15)
@@ -272,25 +309,11 @@ jobs:
uses: actions/setup-node@v4
with:
node-version: ${{ env.NODE_VERSION }}
cache: pnpm
cache-dependency-path: desktop/pnpm-lock.yaml
- name: 前端依赖(严格按 lock 装)
working-directory: desktop
run: pnpm install --frozen-lockfile
- name: cargo 缓存
uses: actions/cache@v4
continue-on-error: true
with:
path: |
~/.cargo/registry/index
~/.cargo/registry/cache
~/.cargo/git/db
key: ${{ runner.os }}-cargo-registry-${{ hashFiles('protocol/Cargo.lock', 'desktop/core/Cargo.lock', 'desktop/src-tauri/Cargo.lock') }}
restore-keys: |
${{ runner.os }}-cargo-registry-
# 上面 apt 装了 ffmpeg,所以 recording.rs 里那几条"真的起 ffmpeg 并读回帧数"
# 的测试不会走 has_ffmpeg() 的跳过分支,是真的在验。
# 如果这台 runner 上它们长期不稳定,删掉这一步即可 —— 它们不在守门 job 里,
@@ -305,7 +328,7 @@ jobs:
run: pnpm tauri build --target ${{ env.TARGET }} --bundles deb,appimage
- name: 上传产物
uses: actions/upload-artifact@v4
uses: actions/upload-artifact@v3
with:
name: cam-desktop-linux-x64
# 一个都没找到就报错:产物路径写错却"构建成功"是最难发现的一种失败。
@@ -321,65 +344,143 @@ jobs:
windows:
name: Windows x64(NSIS 安装包)
needs: checks
# 默认不跑:本仓库目前没有 Windows runner,跑了只会一直排队。有了机器之后
# 在仓库变量里加 ENABLE_WINDOWS=true 就会跟着每次 push 自动跑;手动触发时
# 勾 "构建 Windows" 也能单独跑一次。标签用 RUNNER_WINDOWS 指。
if: >-
${{
(github.event_name == 'workflow_dispatch' && github.event.inputs.windows == 'true')
|| (github.event_name != 'workflow_dispatch' && vars.ENABLE_WINDOWS == 'true')
}}
# 自建 Windows runner 上要有 MSVC Build Tools(tauri 的 Rust 侧要 link.exe)、
# WebView2 运行时(装了包的应用要它才能起窗口;打包本身不需要)与 rustup。
# 默认就跑:windows-runner-01 在线(自报标签 windows-latest)。
# 开关用 inputs 而不是仓库变量的原因见文件头第 4 条 —— 这个坑正是它踩出来的。
if: ${{ github.event.inputs.windows != 'false' }}
# 这台机器上要预装:MSVC Build Tools(tauri 的 Rust 侧要 link.exe)、WebView2
# 运行时(装了包的应用要它才能起窗口;打包本身不需要)与 rustup。
runs-on: ${{ vars.RUNNER_WINDOWS || 'windows-latest' }}
timeout-minutes: 120
env:
TARGET: x86_64-pc-windows-msvc
CARGO_BUILD_TARGET: x86_64-pc-windows-msvc
# 见文件头第 5 条:这台 runner 的 job 跑在**低完整性**(Low Mandatory Level,
# S-1-16-4096)上,而 Windows 不允许低完整性往中完整性写 —— 用户目录全中招:
# ~/.rustup、~/.cargo、%TEMP%、%LOCALAPPDATA% 下新建任何东西都是
# "Access denied (os error 5)",ACL 再宽松也没用(没有 Deny ACE,是完整性
# 级别拦的)。所以 CI 用到的每个"家目录"都挪到 runner 自己的工作目录下,
# 那几处在 job 内的写探测里实测可写。换一台 Windows runner 时改这几行。
RUSTUP_HOME: C:\Users\admin\runner\windows\cache\ci-rustup
CARGO_HOME: C:\Users\admin\runner\windows\cache\ci-cargo
# LOCALAPPDATA/APPDATA 也得改:pnpm 12 的 store 锁与 cache/state 都挂在
# %LOCALAPPDATA% 下(报错原文:pnpm-store-operation-locks\all-stores.lock:
# 拒绝访问),tauri 打包时下载的 NSIS 也放这儿。本机实测:把 LOCALAPPDATA
# 指到可写目录后,pnpm 会在那里建 pnpm-cache / pnpm-state,install 正常。
LOCALAPPDATA: C:\Users\admin\runner\windows\cache\ci-localappdata
APPDATA: C:\Users\admin\runner\windows\cache\ci-appdata
npm_config_cache: C:\Users\admin\runner\windows\cache\ci-npm
RUNNER_TOOL_CACHE: C:\Users\admin\runner\windows\cache\ci-toolcache
steps:
- uses: actions/checkout@v4
# 宿主模式的 Windows runner 上,PATH 里的 `bash` 是 C:\Windows\System32\bash.exe
# —— WSL 的启动器,而 WSL 在 runner 账户下起不来,报 E_ACCESSDENIED(日志里是
# 一串 GBK 被当 UTF-8 解出来的乱码 + https://github.com/microsoft/WSL/issues)。
# 于是任何 `shell: bash` 的步骤、以及用 bash 写的 composite action
# (dtolnay/rust-toolchain 就是),都会在 0 秒内失败。
# Git for Windows 自带 bash,把它的 bin 前置到 PATH —— GITHUB_PATH 的语义就是
# **前置**插入,所以它会盖过 System32 那个 —— 后面这些步骤才跑得起来。
#
# 换掉 bash 之后还有第二个坑:这个 job 的环境里 TEMP/TMP 是空的,而 Git Bash 的
# /tmp 是从 TEMP 推出来的;没有 TEMP 它会退回 <Git 安装目录>\tmp
# (C:\Program Files\Git\tmp),那个目录普通权限写不进去,于是 dtolnay 里那句
# log=$(mktemp) 直接挂掉:
# mktemp: failed to create file via template '/tmp/tmp.XXXXXXXXXX': Permission denied
# 所以顺手给 job 指定一个自己建的可写目录(workspace 的同级 ci-tmp)。
# 两个坑都是 2026-10-15 真跑 Windows job 时踩出来的,本地按这样改完后
# mktemp、rustup toolchain install、rustup target add 全部正常。
- name: 让 bash 指向 Git for Windows,并给 job 一个可写的临时目录
shell: pwsh
run: |
if (-not $env:GITHUB_PATH) { throw '这个 runner 没提供 GITHUB_PATH,没法给后续步骤改 PATH' }
if (-not $env:GITHUB_ENV) { throw '这个 runner 没提供 GITHUB_ENV,没法给后续步骤加变量' }
if (-not $env:GITHUB_WORKSPACE) { throw '这个 runner 没提供 GITHUB_WORKSPACE' }
$gitBash = 'C:\Program Files\Git\bin'
if (-not (Test-Path (Join-Path $gitBash 'bash.exe'))) {
throw "找不到 $gitBash\bash.exe:这台机器上没装 Git for Windows,bash 会落到 WSL 上"
}
Add-Content -Path $env:GITHUB_PATH -Value $gitBash -Encoding ascii
$tmpRoot = Join-Path (Split-Path -Parent $env:GITHUB_WORKSPACE) 'ci-tmp'
New-Item -ItemType Directory -Force -Path $tmpRoot | Out-Null
Add-Content -Path $env:GITHUB_ENV -Value "TEMP=$tmpRoot" -Encoding ascii
Add-Content -Path $env:GITHUB_ENV -Value "TMP=$tmpRoot" -Encoding ascii
Add-Content -Path $env:GITHUB_ENV -Value "TMPDIR=$($tmpRoot -replace '\\', '/')" -Encoding ascii
# 第三个坑:pnpm 的 store 操作锁是按 <USERPROFILE>\AppData\Local\
# pnpm-store-operation-locks 算的 —— 实测只把 LOCALAPPDATA 指走它不跟,
# 只把 USERPROFILE 指走它就跟着走(换完 USERPROFILE 后探针目录里立刻出现
# all-stores.lock)。所以 USERPROFILE 也得指到能写的地方,并且先把
# AppData\Local、AppData\Roaming 建好。
$profileRoot = Join-Path (Split-Path -Parent $env:GITHUB_WORKSPACE) 'ci-profile'
New-Item -ItemType Directory -Force -Path (Join-Path $profileRoot 'AppData\Local'), (Join-Path $profileRoot 'AppData\Roaming') | Out-Null
Add-Content -Path $env:GITHUB_ENV -Value "USERPROFILE=$profileRoot" -Encoding ascii
"bash = $(Join-Path $gitBash 'bash.exe')"
"TEMP/TMP/TMPDIR = $tmpRoot"
"USERPROFILE = $profileRoot"
- name: 装 Rust(stable)
uses: dtolnay/rust-toolchain@stable
with:
targets: x86_64-pc-windows-msvc
- name: 装 pnpm
uses: pnpm/action-setup@v4
with:
version: ${{ env.PNPM_VERSION }}
- name: 装 Node
uses: actions/setup-node@v4
with:
node-version: ${{ env.NODE_VERSION }}
cache: pnpm
cache-dependency-path: desktop/pnpm-lock.yaml
# 这里**不用** pnpm/action-setup:它装的是 standalone 的 pnpm 二进制,而那个
# 二进制在这台 runner 的低完整性沙箱里走到"把包装进 virtual store"时必崩:
# thread '<unknown>' (6716) has overflowed its stack
# corepack 拉下来的是同一个二进制(也崩),所以改成用 npm 装 JS 版 pnpm ——
# 它跑在 node 上,是另一条代码路径。装到 node 自己的目录里(RUNNER_TOOL_CACHE
# 已经指到可写位置,见 job env)。
- name: 装 pnpm(npm 装 JS 版,绕开 standalone 二进制)
shell: pwsh
run: |
# 前面几次尝试在 node 目录里留下过 pnpm/pnpx 的影子文件,npm 会以
# EEXIST 拒绝覆盖,先清掉(node 目录在 RUNNER_TOOL_CACHE 下,可写)。
$nodeDir = Split-Path (Get-Command node).Source
foreach ($n in 'pnpm', 'pnpx', 'pnpm.cmd', 'pnpx.cmd', 'pnpm.ps1', 'pnpx.ps1') {
Remove-Item (Join-Path $nodeDir $n) -Force -ErrorAction SilentlyContinue
}
npm install -g pnpm@12.8.1
if ($LASTEXITCODE -ne 0) { throw "npm 装 pnpm 失败(exit $LASTEXITCODE)" }
"pnpm = $((Get-Command pnpm).Source)"
pnpm --version
- name: 前端依赖(严格按 lock 装)
working-directory: desktop
run: pnpm install --frozen-lockfile
shell: pwsh
# 这台 runner 的 job 跑在低完整性沙箱里(见文件头第 5 条),standalone 的
# pnpm 到"把包装进 virtual store"那一步会直接栈溢出:
# thread '<unknown>' (6716) has overflowed its stack
# (store 已经在可写目录、也改成 copy 导入了,仍然复现;同样的命令在普通
# Medium 会话里跑得好好的。)所以先试 standalone,崩了就退回 corepack:
# 让 node 去跑 pnpm 的 JS 实现,绕开那个二进制。
run: |
$pnpmArgs = @('install', '--frozen-lockfile',
'--store-dir', 'C:\Users\admin\runner\windows\cache\ps',
'--package-import-method=copy', '--reporter=append-only')
pnpm @pnpmArgs
if ($LASTEXITCODE -eq 0) { exit 0 }
"::warning::standalone pnpm 失败(exit $LASTEXITCODE),改用 corepack + node 跑 pnpm"
corepack enable
corepack prepare pnpm@12.8.1 --activate
pnpm @pnpmArgs
exit $LASTEXITCODE
- name: cargo 缓存
uses: actions/cache@v4
continue-on-error: true
with:
path: |
~/.cargo/registry/index
~/.cargo/registry/cache
~/.cargo/git/db
key: ${{ runner.os }}-cargo-registry-${{ hashFiles('protocol/Cargo.lock', 'desktop/core/Cargo.lock', 'desktop/src-tauri/Cargo.lock') }}
restore-keys: |
${{ runner.os }}-cargo-registry-
# nsis 是纯安装包,不需要 WiX;tauri 会自己把 NSIS 下到用户缓存里,所以
# 这台 runner 要能访问 GitHub(离线环境改成 --bundles msi 也一样要下 WiX)。
# nsis 是纯安装包,不需要 WiX;tauri 会自己把 NSIS 下到用户缓存里(这个缓存
# 也跟着 LOCALAPPDATA 走,见上面 job env),所以这台 runner 要能访问 GitHub
# (离线环境改成 --bundles msi 也一样要下 WiX)。
- name: 打包(tauri build)
working-directory: desktop
run: pnpm tauri build --target ${{ env.TARGET }} --bundles nsis
- name: 上传产物
uses: actions/upload-artifact@v4
uses: actions/upload-artifact@v3
with:
name: cam-desktop-windows-x64
if-no-files-found: error
@@ -393,14 +494,10 @@ jobs:
macos:
name: macOS 通用(.app + .dmg)
needs: checks
# 同 Windows:默认不跑,有机器之后设仓库变量 ENABLE_MACOS=true,标签用
# RUNNER_MACOS 指。
if: >-
${{
(github.event_name == 'workflow_dispatch' && github.event.inputs.macos == 'true')
|| (github.event_name != 'workflow_dispatch' && vars.ENABLE_MACOS == 'true')
}}
# 自建 macOS runner 上要有 Xcode Command Line Tools(链接要它)与 rustup。
# 还没有 macOS runner,所以只有"手动触发 + 勾上"才跑;等机器注册好,把这一行
# 换成 `github.event.inputs.macos != 'false'` 就变成默认跑(同 Windows)。
if: ${{ github.event.inputs.macos == 'true' }}
# 那台机器上要有 Xcode Command Line Tools(链接要它)与 rustup。
runs-on: ${{ vars.RUNNER_MACOS || 'macos-latest' }}
timeout-minutes: 150
env:
@@ -426,25 +523,11 @@ jobs:
uses: actions/setup-node@v4
with:
node-version: ${{ env.NODE_VERSION }}
cache: pnpm
cache-dependency-path: desktop/pnpm-lock.yaml
- name: 前端依赖(严格按 lock 装)
working-directory: desktop
run: pnpm install --frozen-lockfile
- name: cargo 缓存
uses: actions/cache@v4
continue-on-error: true
with:
path: |
~/.cargo/registry/index
~/.cargo/registry/cache
~/.cargo/git/db
key: ${{ runner.os }}-cargo-registry-${{ hashFiles('protocol/Cargo.lock', 'desktop/core/Cargo.lock', 'desktop/src-tauri/Cargo.lock') }}
restore-keys: |
${{ runner.os }}-cargo-registry-
# 只想要当前架构、想省一半编译时间的话,把 --target 换成 aarch64-apple-darwin
# (Apple Silicon 的 runner)并去掉上面 targets 里的 x86_64 即可。
- name: 打包(tauri build)
@@ -454,7 +537,7 @@ jobs:
# 第二行是兜底:不同 tauri-cli 版本给通用包放的目录略有差异,宁可多写一行,
# 也不要上传时静默少东西。(注意 path 是块标量,里面写 # 是路径不是注释。)
- name: 上传产物
uses: actions/upload-artifact@v4
uses: actions/upload-artifact@v3
with:
name: cam-desktop-macos-universal
if-no-files-found: error