Merge pull request #2131 from Websoft9/feature/appstore-publish-migration

update

Author: zhaojing1987

.github/workflows/appstore-publish.yml

@@ -139,6 +139,7 @@ jobs:
           aws s3 sync \
             dist/appstore-publish/appstore/${{ steps.resolve_channel.outputs.channel }}/catalog \
             s3://artifact/appstore/${{ steps.resolve_channel.outputs.channel }}/catalog \
+            --cache-control "public, max-age=60" \
             --endpoint-url "$AWS_ENDPOINT_URL"
 
       - name: Upload v2 library metadata to Cloudflare R2
@@ -151,6 +152,7 @@ jobs:
             dist/appstore-publish/appstore/${{ steps.resolve_channel.outputs.channel }}/library \
             s3://artifact/appstore/${{ steps.resolve_channel.outputs.channel }}/library \
             --exclude "apps/*" \
+            --cache-control "public, max-age=60" \
             --endpoint-url "$AWS_ENDPOINT_URL"
 
       - name: Upload v2 per-app packages to Cloudflare R2 (additive only)
@@ -163,6 +165,7 @@ jobs:
             aws s3 cp --recursive \
               dist/appstore-publish/appstore/${{ steps.resolve_channel.outputs.channel }}/library/apps \
               s3://artifact/appstore/${{ steps.resolve_channel.outputs.channel }}/library/apps \
+              --cache-control "public, max-age=60" \
               --endpoint-url "$AWS_ENDPOINT_URL"
           fi
 
@@ -175,6 +178,7 @@ jobs:
           aws s3 sync \
             dist/appstore-publish/appstore/${{ steps.resolve_channel.outputs.channel }}/manifests \
             s3://artifact/appstore/${{ steps.resolve_channel.outputs.channel }}/manifests \
+            --cache-control "public, max-age=60" \
             --endpoint-url "$AWS_ENDPOINT_URL"
 
       # ── legacy uploads (old R2 paths, kept for backward compatibility) ──
@@ -207,7 +211,7 @@ jobs:
           if [[ "${{ steps.resolve_channel.outputs.channel }}" == "dev" ]]; then
             echo "urls=[\"https://artifact.websoft9.com/dev/websoft9/plugin/library/library-dev.zip\",\"https://artifact.websoft9.com/dev/websoft9/plugin/media/media-dev.zip\"]" >> "$GITHUB_OUTPUT"
           else
-            echo "urls=[\"https://artifact.websoft9.com/release/websoft9/plugin/library/library-latest.zip\",\"https://artifact.websoft9.com/release/websoft9/plugin/media/media.zip\"]" >> "$GITHUB_OUTPUT"
+            echo "urls=[\"https://artifact.websoft9.com/release/websoft9/plugin/library/library-latest.zip\",\"https://artifact.websoft9.com/release/websoft9/plugin/media/media-latest.zip\"]" >> "$GITHUB_OUTPUT"
           fi
 
       - name: Purge legacy Cloudflare Cache

build/library_publish.py

@@ -492,7 +492,7 @@ def build_legacy_library_artifacts(output_dir: Path, package_name: str, packaged
 
 def build_legacy_media_artifacts(output_dir: Path, catalog_source_dir: Path, channel: str) -> dict:
     output_dir.mkdir(parents=True, exist_ok=True)
-    archive_name = "media-dev.zip" if channel == "dev" else "media.zip"
+    archive_name = "media-dev.zip" if channel == "dev" else "media-latest.zip"
     distribution_map = build_distribution_map() if channel == "dev" else {}
 
     with tempfile.TemporaryDirectory() as tmp_dir_name:

docs/appstore-release-spec.md

@@ -400,7 +400,7 @@ schemaVersion 不在本地支持列表中：
 | `appstore-manifest.json` | Cache-Control: 60s | 入口文件，需及时感知更新 |
 | `catalog/manifest.json` | Cache-Control: 60s | 体积极小，变更频率低 |
 | `apps-delta-*.json` | Cache-Control: 60s | 体积极小 |
-| `apps/{app}/latest.zip` | Cache-Control: 86400 | 未变更时 hash 不变，可大胆缓存 |
+| `apps/{app}/latest.zip` | Cache-Control: 60s | 模板文件体积极小，变更后需立即生效 |
 | `full/library-{dsv}.zip` | immutable | 文件名含内容版本，永不变 |
 | `*.sha256` | 跟随对应文件 | 校验与被校验文件同步缓存 |
 | `catalog_*.json / product_*.json` | Cache-Control: 3600 | 描述数据，变更频率中等 |