应用目录素材

应用图标素材以真实图片统一预览桌面目录使用的素材，同时展示原项目资源、候选图和来源记录。它使用外链媒体元数据，不改变 packages/icons/svg 的 canonical SVG、IconifyJSON、UnoCSS 图标名或 npm 图标导出。

一份元数据，独立的媒体频道

权威清单是 assets/catalog/app-assets.json，文档构建把同一份文件发布到 /app-assets/manifest.json。构建不下载图片，不读取另一个仓库，不存入 PNG / WebP 二进制，也不将 raster 图片包装成 SVG 或 base64。

{
  "schemaVersion": 1,
  "assets": [
    {
      "slug": "cook",
      "desktopAsset": {
        "kind": "official",
        "version": "v2",
        "usage": "desktop-selected",
        "thumbnail": { "url": "固定公共 HTTPS WebP", "width": 256, "height": 256, "mime": "image/webp", "bytes": 7344, "sha256": "存储对象哈希" },
        "master": { "url": "固定公共 HTTPS PNG", "width": 1024, "height": 1024, "mime": "image/png", "bytes": 0, "sha256": "存储对象哈希" },
        "source": { "repository": "YunYouJun/cook", "path": "public/brand/cook-app-icon.svg", "commit": "源码提交", "sha256": "原文件哈希" }
      },
      "applicationIdentity": { "status": "formal_app_icon", "notes": "已核实的来源说明" },
      "websitePublication": { "status": "verified-resource" },
      "candidates": []
    }
  ]
}

上述是字段说明，完整有效值以下载清单为准。所有资产都有名称、说明和检索标签。desktopAsset.thumbnail 是消费者同步桌面固定 URL 的入口；候选或旧图不能被同步工具当作当前默认。PNG 主图与 WebP 都记录固定对象 URL、尺寸、MIME、字节数与 SHA-256。

明确区分三件事

• 桌面采用：desktopAsset.usage = desktop-selected 表示当前目录选择，kind 区分正式来源和生成素材。当前 28 项默认包含 16 个正式来源与 12 个生成素材；素材来源与维护者是否选用分别记录。
• 应用身份：applicationIdentity 记录正式图标、专属 mark、选用标记、旧图待确认、通用 favicon、框架默认或第三方品牌。空目录 logo 不等于应用原来没有图标。
• 网站发布：websitePublication 的 verified-resource 仅表示指定公开资源已核实；declared-only 表示站点声明可见但图片访问未确认；unverified 表示本目录未核实。Git source commit 不代表线上部署 commit。

16 个生成素材中，4 个未采用版本保留在 candidates 作对照，对应应用的桌面默认继续使用正式来源的 v2 导出。其余 12 个用于当前桌面目录；一般生成变体仍是候选品牌素材，不因目录采用或上传而成为应用的正式身份。

Saier（pixi-painter）是维护者明确选用的例外：2026-10-14 选用历史生成画笔稿 v1 作为应用图标，因此它成为桌面默认，kind 仍为 generated。desktopAsset.adoption 单独记录 status: maintainer-approved、approvedAt: 2026-10-14 与 scope: application-icon。这条采用记录不改写生成来源，网站发布单独核实。同日已确认 Saier 主站 的 favicon 声明指向该画笔稿导出的 32px PNG，公开资源返回 200 image/png，因此 websitePublication 记为 verified-resource；applicationIdentity 中的旧 S 来源保留为历史记录。此项核实不表示原生安装包图标已经更新。

previousIcon 保留 16 个可追溯的原项目图片或站点旧图。Saier 的旧 v2 正式导出完整记录归档到 previousIcon.archivedArtwork，标记 usage: comparison-only、status: superseded，只供历史对照，不能被同步为当前默认。旧图访问失败时页面显示提示和来源链接，不用另一个未知图片代替。Explosions 的框架默认图标和 WC GitHub Corners 的第三方 favicon 可推荐以后建立独立品牌；目录预览不会自动执行网站品牌发布。

维护与验证

新版本使用新 COS 对象路径；不覆盖已声明 immutable 的旧资源。仅在来源和采用状态核实后更新默认 desktopAsset，其余版本作为明确的候选保留。不要记录本机路径、临时下载 token、凭据或签名 URL。

WebP 缩略图按原始存储对象校验。COS 对 PNG 的匿名读取可能经过 imageSlim，导致响应字节与上传对象不同；PNG SHA-256 指向存储对象，不能用经过转换的响应宣称字节一致。

页面提供 32px、56px、128px 和无遮罩 / 圆角预览。显示的是静态缩略图，不代表已完成 Apple Icon Composer 原生分层交付。已有产品的原生原稿归档流程继续独立维护。

本地验收运行 pnpm test、pnpm lint、pnpm typecheck 与 pnpm docs:build。单元检查离线验证 slug、固定公共 HTTPS、版本、尺寸、MIME、哈希、采用 / 候选状态；组件检查搜索、筛选、尺寸和图片失败处理。媒体可达性与实际外观在浏览器中单独检查。