diff --git a/.cnb.yml b/.cnb.yml
index 72f7ebdb..3fae26e0 100644
--- a/.cnb.yml
+++ b/.cnb.yml
@@ -240,11 +240,15 @@ main:
     - name: 构建并发布（境内外双线路）
       runner:
         cpus: 4                     # 4 核 8G；160 核时/月 → 约 240 次
+      # ★ CNB 的 docker build 上下文「只含 Dockerfile + by 列出的文件」，
+      #   未列入的一律视为不存在（官方原文）。Dockerfile 要 COPY bin/linux/hugo，
+      #   故必须写进 by。漏掉会报：
+      #     failed to compute cache key ... "bin/linux/hugo": not found
       docker:
         build:
           dockerfile: deploy/Dockerfile
-          by: [package.json]
-          versionBy: [package-lock.json]
+          by: [bin/linux/hugo]
+          versionBy: [bin/linux/hugo]
       imports:
         - https://cnb.cool/zqlit/blog-secrets/-/blob/main/secrets.yml
       lock:                          # 对应原 concurrency.cancel-in-progress
@@ -261,11 +265,15 @@ main:
     - name: 定时构建（每天 09:00）
       runner:
         cpus: 4
+      # ★ CNB 的 docker build 上下文「只含 Dockerfile + by 列出的文件」，
+      #   未列入的一律视为不存在（官方原文）。Dockerfile 要 COPY bin/linux/hugo，
+      #   故必须写进 by。漏掉会报：
+      #     failed to compute cache key ... "bin/linux/hugo": not found
       docker:
         build:
           dockerfile: deploy/Dockerfile
-          by: [package.json]
-          versionBy: [package-lock.json]
+          by: [bin/linux/hugo]
+          versionBy: [bin/linux/hugo]
       imports:
         - https://cnb.cool/zqlit/blog-secrets/-/blob/main/secrets.yml
       lock: