2026 遠端 Mac CI：pnpm store-dir與 Turborepo Remote Cache 跨境命中率決策矩陣

（一）僅靠本機 node_modules 快取，換到遠端 Mac 仍全量 pnpm install，pnpm store 未固定路徑導致 CI 快取還原錯位。（二）Turborepo remote cache 未綁 lockfile／Node 版，任務指紋變了卻仍命中舊產物。（三）registry 鏡像與 Git 鏡像混用不一致，跨境頻寬抖動時 worker 併發過高，磁碟 I/O 飽和拖垮 pipeline。

每條 pipeline 建議輸出：remote cache hit ratio、pnpm store 重用率、registry 回源比例，並在摘要保留七日移動平均以便對照調參成效。hit ratio 長期低於 40% 且下載字節仍高，先查快取鍵是否缺 pnpm-lock.yaml 雜湊；store 重用高但 turbo 仍 miss，查任務 inputs 是否把隨機 env 或時間戳寫進指紋。

在倉庫根 .npmrc 固定 store，並以 lockfile 納入 CI 快取鍵：

# .npmrc（片段）
store-dir=/var/ci/pnpm-store
prefer-frozen-lockfile=true
fetch-retries=3
fetch-timeout=120000

export CACHE_KEY="pnpm$(pnpm -v)_$(shasum -a 256 pnpm-lock.yaml | cut -c1-12)"
pnpm install --frozen-lockfile

多作業 runner 宜一作業一 store 子目錄，或唯讀掛載預熱 store，避免並發寫壞索引。

{
  "remoteCache": { "enabled": true, "signature": true },
  "tasks": { "build": { "dependsOn": ["^build"], "outputs": ["dist/**"] } }
}

export TURBO_API="https://cache.internal.example.com"
export TURBO_TOKEN="${TURBO_REMOTE_TOKEN}"
export TURBO_TEAM="ci-macpull"
pnpm exec turbo run build --filter=...@origin/main --summarize

生產務必 HTTPS；自簽以 NODE_EXTRA_CA_CERTS 注入。token 僅能經 CI 祕文注入，切勿寫入版控。

registry=https://registry.npmmirror.com
@myorg:registry=https://npm.corp.example/
git config --global url."https://mirror.corp.example/".insteadOf "https://github.com/"

詳見 Git／npm CI 加速 與 拉取穩定性 FAQ。

（一）快取鍵：pnpm{版}_{lock前12位}_{NODE_VERSION}。（二）抖動網路 fetch-timeout=120000、fetch-retries=3 為起點。（三）根分區可用 <20% 時自動降併發並告警。