chore(sync): merge upstream main (49 commits)

.dev.vars.example

@@ -31,6 +31,18 @@ ADMIN_PASS=
 # 留空表示仅允许同源请求。
 ALLOW_URLS=
 
+# 传输种子元数据/请求体上限（字节），默认 10485760（10 MiB）。
+# 作用于 /seed/parse、/seed/convert、/seed/update、/seed/upload_parse。
+SEED_MAX_METADATA_SIZE=10485760
+
+# 额外允许作为种子 source 的主机白名单，逗号/空格/分号分隔，支持 *.example.com。
+# 同源 OpenList 的 /d/、/sd/、/@s/ 与 /api/p/ 链接始终允许；留空表示只允许同源链接。
+# 兼容旧变量名 ALLOW_SEED（新变量优先）。
+SEED_SOURCE_ALLOWED_HOSTS=
+
+# 说明：seed_single_direct_preview 不是环境变量，而是数据库中的站点设置项
+# （默认 false）。可在管理后台「设置 → 种子」中修改，单文件种子解析时生效。
+
 # 前端静态资源 CDN 地址（可选）。需指向包含完整前端 dist 的目录（含 index.html）。
 # 配置后浏览器直连 CDN 加载 JS/CSS/图片等资源，不再经 Worker 中转。
 # 注入自动在两条路径中选择：
@@ -83,3 +95,8 @@ CF_ACCOUNT=
 CF_KV_UUID=
 # 具有 KV 读写权限的 API Token
 CF_API_KEY=
+
+# ── 持久缓存 / 并发去重均已移除 ─────────────────────────────────────────────
+# 目录列表与下载直链每次都直接回源驱动，既不做跨请求缓存，也不合并并发相同
+# 调用。相关环境变量（CACHE_* / SINGLEFLIGHT*）已全部删除，残留同名变量不会
+# 再被读取。

.env.example

@@ -81,3 +81,8 @@ CF_ACCOUNT=
 CF_KV_UUID=
 # 具有 KV 读写权限的 API Token
 CF_API_KEY=
+
+# ── 持久缓存 / 并发去重均已移除 ─────────────────────────────────────────────
+# 目录列表与下载直链每次都直接回源驱动，既不做跨请求缓存，也不合并并发相同
+# 调用。相关环境变量（CACHE_* / SINGLEFLIGHT*）已全部删除，残留同名变量不会
+# 再被读取。

.github/workflows/build-verify.yml

@@ -0,0 +1,100 @@
+name: Build Verify
+
+# dist/、dist-server/ 是构建产物，一律不入库；cloud-functions/[[default]].js 与
+# node-functions/[[default]].js 是「EdgeOne server-handler 检测占位」（几行的小文件，
+# 入库且基本不变），部署构建时由 scripts/build-edge.mjs 在同一路径生成完整产物覆盖：
+#   - EdgeOne Makers：edgeone.json 的 buildCommand（pnpm run build）在部署时生成
+#     dist/ 与两处完整产物
+#   - Cloudflare Workers：wrangler deploy 从 src/backend/worker.ts 打包，并用 dist/ 作静态资源
+#   - 自托管 Node：node dist-server/api/[...route].js 由 pnpm run build 产出
+#
+# 因此"部署用的后端代码"完全取决于构建链路能否跑通，本工作流就是这条链路的看门人：
+# 按平台一致的顺序安装、拉取前端、构建，并校验产物确实生成；同时断言入库的
+# 两处入口仍是占位文件（防止误提交 2MB 构建产物）。任一步失败即失败。
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "src/**"
+      - "api/**"
+      - "functions/**"
+      - "scripts/**"
+      - "middleware.js"
+      - "edgeone.json"
+      - "wrangler.jsonc"
+      - "package.json"
+      - "pnpm-lock.yaml"
+      - ".github/workflows/build-verify.yml"
+  pull_request:
+    paths:
+      - "src/**"
+      - "api/**"
+      - "functions/**"
+      - "scripts/**"
+      - "middleware.js"
+      - "edgeone.json"
+      - "wrangler.jsonc"
+      - "package.json"
+      - "pnpm-lock.yaml"
+      - ".github/workflows/build-verify.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: build-verify-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    name: Build and verify artifacts
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Fetch official frontend dist
+        run: node scripts/fetch-frontend.mjs
+
+      - name: Build edge/serverless artifacts
+        run: node scripts/build-edge.mjs
+
+      - name: Verify artifacts exist
+        run: |
+          set -e
+          test -f dist/index.html
+          test -f "dist-server/api/[...route].js"
+          test -f "cloud-functions/[[default]].js"
+          echo "OK: dist/index.html、dist-server/api/[...route].js、cloud-functions/[[default]].js 均已生成"
+
+      # 入库的 cloud-functions/[[default]].js 与 node-functions/[[default]].js 是
+      # EdgeOne server-handler 检测占位（见文件头注释）——平台按 Git 仓库内容
+      # 判断项目是否含 Node 后端，真实产物由部署构建在同一路径生成并覆盖。
+      # 这里断言仓库里跟踪的仍是占位文件：若有人把本地构建出的 2MB 完整产物
+      # 提交进来，本检查会失败并提示还原为占位内容。
+      - name: Assert tracked handler entries are the placeholder
+        run: |
+          fail=0
+          for f in "cloud-functions/[[default]].js" "node-functions/[[default]].js"; do
+            if ! git show "HEAD:$f" | head -1 | grep -q "PLACEHOLDER"; then
+              echo "::error::$f 在仓库里不是占位文件 —— 疑似误提交了构建产物。请还原为占位内容（产物由部署构建生成，不入库）。"
+              fail=1
+            fi
+          done
+          if [ "$fail" -ne 0 ]; then exit 1; fi
+          echo "OK: 两处 server-handler 入口均为占位文件"

.gitignore

@@ -17,6 +17,7 @@ public_data
 .idea
 .test
 .codebuddy
+.workbuddy-ai
 .vscode
 .env
 .env.local
@@ -35,6 +36,7 @@ public_data
 # local-only dev config (may contain real secrets; never commit)
 wrangler.d1.toml
 wrangler.local.jsonc
+wrangler.ui.jsonc
 
 # OS files
 Thumbs.db
@@ -49,6 +51,14 @@ pages/dist/
 dist-server/
 *.tsbuildinfo
 
+# EdgeOne server-handler 检测占位：cloud-functions/[[default]].js 与
+# node-functions/[[default]].js 以几行的占位文件入库（平台按 Git 仓库内容判断
+# 项目是否含 Node 后端；PR #93 实测仅靠构建期生成会报「No server-handler
+# detected」退化为纯静态，/api/* 全部落静态）。部署构建时 scripts/build-edge.mjs
+# 会在同一路径生成完整产物（~2MB，不入库）覆盖占位，EdgeOne 运行的是构建产物。
+# 占位内容基本永不变更 —— PR 中若出现这两个文件的大段变更，说明误提交了
+# 构建产物，请还原为占位内容。
+
 # source maps (optional, can be removed)
 *.map
 *.js.map