_headers

# Cloudflare Pages 自定义响应头
# 文档：https://developers.cloudflare.com/pages/configuration/headers/

# 静态资源：长缓存 + immutable
# output.css / app.js 的引用现在由 scripts/stamp-assets.mjs 加了内容 hash 查询串
# （href="/output.css?v=<hash>"），改了内容 → hash 变 → URL 变 → 浏览器/CDN 自动拉新版。
# URL 既然带版本号，就能放心用 1 年 immutable：同一版本永远命中缓存，更新走新 URL。
# ⚠️ 不要手动改 HTML 里的 ?v=，它是 npm run build:assets 的产物；详见该脚本顶部注释。
/output.css
  Cache-Control: public, max-age=31536000, immutable
/app.js
  Cache-Control: public, max-age=31536000, immutable

# 字体：文件名稳定（内容不变），可长缓存 + immutable
/fonts/*
  Cache-Control: public, max-age=31536000, immutable

# 图片：内容稳定，1 周缓存
/examples/*
  Cache-Control: public, max-age=604800, must-revalidate
/*.webp
  Cache-Control: public, max-age=604800, must-revalidate
/*.png
  Cache-Control: public, max-age=604800, must-revalidate

# robots.txt / sitemap：1 小时
/robots.txt
  Cache-Control: public, max-age=3600
  Content-Type: text/plain; charset=utf-8
/sitemap.xml
  Cache-Control: public, max-age=3600