静态资源与 CDN

Vext 有两个静态资源位置，它们行为不同。

资源位置

位置	行为
`src/frontend/assets/**`	被 TSX/CSS import，进入前端 asset graph。
`public/**`	按 public 文件复制，并通过 URL 访问。

组件拥有的图片、字体、媒体文件建议放在 import 型 assets 中。固定 URL 文件，如 favicon.svg、robots.txt 或外部引用文件，放在 public/**。

import logoUrl from "@assets/logo.png";

export function Logo() {
  return <img src={logoUrl} alt="Logo" />;
}

生产构建会输出内容哈希文件，方便浏览器和 CDN 长缓存。

public/favicon.svg -> /favicon.svg
public/docs/openapi.json -> /docs/openapi.json

Public 文件会进入 deploy manifest，可以和其它前端资源一起上传。

生产资源由 CDN 服务时设置 frontend.deploy.assetBaseUrl：

frontend: {
  deploy: {
    assetBaseUrl: "https://cdn.example.com/my-app/",
  },
}

这会改变生成的资源 URL。上传仍由 frontend.deploy.upload、vext build --upload-assets 或 vext deploy assets 控制。

deploy-manifest.json 加 sha256 state 让 Vext 跳过未变化的图片、字体、JS、CSS 和 public 文件。这是企业发布中避免大文件重复上传的默认路径。