准备画廊封面

画廊封面是玩家对角色的第一印象。它不是默认等同于 canonical portrait，也不是某条剧情结果图。Creator 可以明确选择同一张 portrait 作为封面，但仍需要单独确认裁切焦点、图片说明、短文案和允许公开的事实边界。

需要提供什么

请提供一张经过审阅的静态图片，以及以下由 Creator 决定的公开展示信息：

一句说明“为什么值得打开这段关系”的短 hook；
只描述图片可见内容的 alt text；
图片裁成 3:4 时必须保留在画面里的焦点；
封面与文案可以公开表达的事实；
discovery presentation 绝不能泄露的事实。

当前机器校验支持 .avif、.jpeg、.jpg、.png 与 .webp；文件后缀必须与图片 signature 一致，文件不能为空，进入 catalog 的单张封面上限为 16 MiB。画廊封面不接受动态 GIF 或 SVG。画廊统一按 3:4 展示；原图可以是其他比例，响应式裁切会以 Creator 提供的焦点为准。

为了让手机卡片也清楚，建议原图至少为 900 × 1200 像素，角色面部与身份锚点在缩小时仍可辨认。请把关键细节留在画面内部，不要把标题、按钮、 “可玩/创作中”等平台 UI 烧进图片。这些属于创作交付建议；当前 compiler 会校验文件类型与 typed crop，但不会把像素尺寸或主观构图质量伪装成已验证项。

`visual.yaml` 的准确格式

在 visual 下加入 discovery：

yaml

visual:
  identity:
    # 现有视觉身份字段。
  portrait:
    # 现有 canonical portrait 素材。
  discovery:
    short_hook: 天亮前她必须作出一个决定，而每个答案都要有人付出代价。
    gallery_cover:
      content_version: 1
      asset:
        id: character_gallery_cover_v1
        source_path: assets/character-gallery-cover-v1.png
        provenance_ref: creator://reviewed-gallery-cover-v1
      alt_text: 年轻药师站在石砌工坊里，手中拿着发出蓝光的水晶。
      crop:
        aspect_ratio: "3:4"
        focal_point:
          x_percent: 50
          y_percent: 34
    public_fact_ids:
      - character_is_an_apothecary
    forbidden_fact_ids:
      - character_hidden_debt
  outcomes:
    # 现有 outcome 图片。

gallery_cover.asset.source_path 可以指向与 portrait 相同的已审图片，但仍应声明独立的封面 asset 和公开展示信息。这样是 Creator 明确选择复用，而不是前端偶然拿 portrait 当 fallback。

Contract 规则

short_hook 是 package 默认语言下的 Creator 公开文案，长度为 1–160 个 Unicode 字符。
content_version 必须是大于等于 1 的严格整数。它只标识创作内容版本，不证明已经批准或发布。
asset.id 在 package 内唯一；source_path 使用与其他 visual asset 相同的 package-local 或已允许的历史素材命名空间。
alt_text 长度为 1–500 个 Unicode 字符，不得比图片与 public_fact_ids 允许的内容披露更多。
aspect_ratio 当前必须准确写成 "3:4"。
x_percent 与 y_percent 必须是 0 到 100 的严格整数，用来指定响应式 object-fit: cover 裁切时最重要的视觉位置。
public_fact_ids 只能包含不重复、且开场时允许向用户披露的 world fact。
forbidden_fact_ids 只能包含 package fact graph 中不重复的事实；两组 ID 不能重叠。
hook、图片和 alt text 可以表达 visual identity 与列出的公开事实。一个事实没有写进 forbidden_fact_ids，不等于它自动可以公开。

provenance_ref 只记录素材来源，不代表权利授予、精确素材批准、发布批准或 release eligibility。这些仍然是相互独立、绑定准确版本的审阅控制。

画廊怎样使用这些内容

Creator package 负责角色呈现与公开文案；platform catalog 负责某项体验是 playable 还是 creator_preview、进入路由和策展顺序；玩家的私有 relationship overlay 以后可以叠加“继续联系”“等待消息”“已有口信”等真实状态。平台状态与私密关系历史都不应写进 visual.yaml。

完整 Creator package 也可以先以 creator_preview 出现：这表示平台尚未开放关系路由，不表示 package 不完整。Consumer 角色目录与 Creator Portal 项目浏览可以读取同一份 discovery presentation，但 Creator Portal 中出现一张卡片不代表该项目已经有完整 Workbench 详情或 Test Lab 证据。

为了兼容旧 package，缺少 visual.discovery 的 package 仍可被读取，但不能进入 package-driven 角色画廊。成功 compile 也不等于已经发布。

审阅清单

图片缩成小卡片后仍能认出角色，并能承受声明的 3:4 裁切。
焦点让角色面部、关键道具或身份轮廓在桌面与手机上都留在画面内。
hook 让人好奇，但不剧透整段剧情，也不承诺当前体验无法交付的玩法。
alt text 准确帮助理解画面，而不是另一句营销文案。
图片和文案不泄露私密动机、未来结果、隐藏关系状态或其他秘密。
精确文件 bytes、来源、允许用途、署名和审阅范围都清楚。
即使平台改变卡片布局、状态文案或排列顺序，封面表达的仍是 Creator 意图。

准备画廊封面 ​

需要提供什么 ​

visual.yaml 的准确格式 ​

Contract 规则 ​