yzsp-studio/mediakit-shared-suite / creative-design
creative-design
Unverified当用户要求从零生成或设计商业、品牌、社交媒体及知识表达类创意图片,编辑、复刻或审查已有视觉成品,或进行系列延展、多比例适配、多资产视觉系统设计时使用。触发任务包括做图、出图、生成图片、设计海报、主视觉/KV、Banner、封面、社媒配图、社媒长图、电商主图、详情页、产品图、Logo、IP 角色、吉祥物、包装、品牌应用物料、活动物料、宣传册、落地页、知识科普海报、信息图、教学图、教材插图、课件配图、思维导图、知识图谱、流程图、数据图表、科学结构图、公式推导图、工程图纸,以及分图层 HTML/CSS 视觉设计。
references/rendering/font-family-library.md
View on GitHub# 字体资源 Library 与执行契约
本文件只负责视觉候选确定后的字体资源来源、状态和执行边界。视觉选型统一从 [字体推荐入口](font-recommendation-list.md) 完成;推荐清单和查询结果不能证明资源可用。正式排版进入本文件后,必须由当前目标渲染环境的字体元数据和真实文案实测核验实际 family、face、weight/style、许可、字形覆盖与加载链路,记录方式遵循第 6 节。pure-image 只借用推荐入口中的字形、角色、气质、搭配与可读性建议,不进入本文件,不因此安装字体、创建 DOM 或独立字体契约,也不承诺图像模型精确采用某个 family。
字体资源层与产物协议解耦:进入本文件前必须已经锁定生产轨道和产物格式。本文件只返回字体资源与可用性结论,不得创建、切换或推断 HTML、分层协议或其他交付格式。字体不可用时按本文件的失败处理执行:用户锁定精确字体或关键字形则请求确认,未锁定时才在原约束内重选;两种情况都不能通过改换产物协议解决。
字体执行分成两个互不冒充的通道,并统一由 `scripts/runtime/resolve_font.py` 解析:Canvas/本地字体通道核验真实文件、许可、family 与字形覆盖;HTML Web 字体通道从白名单选择浏览器可加载的真实 face。HTML 已锁定时优先读取 [Web 字体契约](web-font-contract.md),使用 `scripts/runtime/resolve_font.py --target html --weight <weight>` 从 `assets/fonts/web-font-manifest.json` 解析。下文的本地下载与注册流程不作为 HTML CDN 字体前置条件,Web CDN 可用也不等于本地字体已安装。
## 1. 职责分层
| 文件 | 唯一职责 |
|---|---|
| `references/rendering/font-recommendation-list.md` | 视觉选型统一入口;精选候选、查询诊断与真实文案试排,不负责资源准入 |
| `assets/fonts/font-curated-pool.json` | 推荐候选、主题排序、语种角色、组合映射与平台注册查询镜像 |
| `scripts/runtime/select_fonts.py` | 查询同一 JSON;不下载、不安装、不判定实际字形覆盖 |
| `references/items/fonts.md` | 供明确引用本表的 Canvas Item 字体字段核对精确 family、已注册 normal/italic 字重;不约束 HTML DOM,当前环境仍需验证 |
| `assets/fonts/catalogs/*.json` | 字体名称、语种、来源、许可和预期本地路径的元数据目录 |
| `assets/fonts/font-cdn-manifest.json` | 允许 Canvas/本地通道下载并核对大小、MD5 的已验证 CDN 对象 |
| `assets/fonts/web-font-manifest.json` | 与目标前端对齐、允许 HTML 浏览器直接加载的 Web family/face 白名单 |
| `scripts/runtime/resolve_font.py` | 按目标通道解析精确字体、真实 face、资源状态与对应契约;不改变既定产物格式 |
| `assets/fonts/packages/` | 运行时本地字体缓存;不存在不代表目录损坏 |
不得在本文件重复全部字体名称。目录 JSON 是名称与元数据索引,但目录中的 `local_paths` 只表示预期落盘位置,不证明文件已经存在。
## 2. 当前资源状态
三个目录文件提供:
| 目录 | 语种范围 | 记录数 |
|---|---|---:|
| `assets/fonts/catalogs/chinese.json` | 中文及 CJK | 187 |
| `assets/fonts/catalogs/latin.json` | 拉丁字母 | 874 |
| `assets/fonts/catalogs/multilingual.json` | 日、韩、泰、阿拉伯、越南等 | 500 |
这些记录可用于检索,资源状态分为以下类别;正式字体排版须通过本次目标环境的许可、实际加载、真实 face 和字形覆盖核验。只有实际 Item 字段引用平台字体表时,才额外以该表检查注册资格;HTML DOM 不受该白名单限制,但仍须通过 HTML 协议的目标环境验证:
- `ready`:本次目标渲染环境已实际加载正确 family/face,许可、真实字重和文案覆盖均通过;仅本地文件存在不足以标记 ready;
- `cdn_available`:字体位于已验证 CDN manifest,可按明确操作下载;
- `not_installed`:只有目录元数据,没有可验证本地文件或 CDN 条目;
- `blocked_by_license`:资源存在,但许可不足以支持当前用途。
运行时状态以当前渲染环境实测为准,不读取 catalog 中的历史状态自报。查询器只返回 `local_present`、`cdn_listed_not_rechecked`、`not_installed` 或 `unresolved`;不会生成 `ready`。`listed_not_runtime_verified` 仅表示匹配平台表,不能等同字体实际加载。未安装、待解析或许可阻断的候选可保留检索记录,不能当成正式可用字体。
## 3. CDN 规则
真实 CDN 根地址:
```text
https://lf-flow-web-cdn..com/obj/flow-//infinite-canvas/fonts/v1
```
`*` 只表示对象路径占位,不是可请求 URL,也不能从字体名称任意拼接。Canvas/本地通道只有 `assets/fonts/font-cdn-manifest.json` 中 `verified=true` 的完整 URL 可以自动下载;HTML 直接注入只接受 `assets/fonts/web-font-manifest.json` 中 `verified=true` 的完整 URL。Canvas 下载清单中的 URL 必须是 Web 字体清单 URL 的子集,避免同一字体对象在两种消费路径中漂移;该关系由字体回归测试核对。
当前已验证:
- 思源黑体简体 VF;
- 抖音美好体;
- 优设得意黑。
新增 CDN 字体时必须记录:
- catalog ID;
- 预期本地路径;
- 完整 CDN URL;
- 文件大小;
- MD5;
- Content-Type;
- 实际验证日期。
仅替换 CDN 域名而保留旧 `assets/fonts/packages/...` 对象路径是无效的;已实测该旧路径返回 404。
## 4. 强制选择顺序
1. 进入本文件前,先在 [字体推荐入口](font-recommendation-list.md) 保留用户/参考约束并用真实文案完成视觉候选判断;`scripts/runtime/select_fonts.py` 只用于查询候选、缺口和诊断,不能作为资源准入结论。pure-image 在视觉建议处结束,不进入以下资源执行步骤。
2. 按真实文案核验语种与字形覆盖;用户锁定精确字体或关键字形而覆盖失败时停止并请求确认,未锁定时才排除不覆盖的候选。
3. 先保持字形与阅读任务适配,再检查适用的平台约束、许可和资源;只有未锁定精确字体时,拒绝项才可传 `--exclude` 继续查找,不以资源方便压过用户或参考约束。
4. 使用精确 catalog ID 核对资源及目标环境的 family、真实 face/字重。实际 Item 字段引用字体表时,读取 `references/items/fonts.md` 或当前平台的实际清单;本地安装不能绕过其注册门禁。HTML DOM 按 HTML 协议核验,不因未列该表而拒绝,也不以本地安装替代目标端加载证据。未经证实的别名、CN/SC/VF 或轻量变体不可合并成同一个可用实例。
5. 若状态为 `cdn_available`,仅使用 manifest 中已验证的完整 URL 取得字体,并核对文件大小、MD5 与 Content-Type。
6. 只有通过许可检查,且目标环境确认实际加载的 family/face、真实字重与文案覆盖,才允许由已锁定的 workflow 将字体写入实现源;所选值与核验结论按第 6 节记录,不以独立契约文件作为 HTML 的门禁。可编辑设计中的 Coding 文字均须通过此门禁并保持可编辑;独立艺术标题仅限 Brief 明确准入的首屏/首图主标题或每个独立图片唯一最重要大标题,普通 H1 不自动获得资格,品类限制仍优先。已准入的一体化 Hero 图内文案沿用原 workflow;这些可编辑设计限制不施加给 pure-image,字体门禁不得改变产物格式。
## 5. 字体许可
- 目录记录不等于完成许可核验。
- 默认只自动下载明确标记为开源且许可证属于 OFL、Apache 或 Ubuntu Font License 的条目。
- 非标许可、链接失效、条款不清或禁止再分发时,按现有授权范围确认用途;查询器不下载资源,也没有 `--allow-license-risk` 下载开关。不得调用不存在的参数或把推荐当成许可。
- 系统字体可记录 `origin: system`,但不得复制进 Skill 或交付包。
- 字体子集化、修改字体、收费字体服务和公开再分发需要额外许可判断。
## 6. 协议无关字体契约
字体记录服从已锁定的产物协议。HTML 的字体选择值与实现参数只写入最终 HTML,核验结论写入既有 validation 输出,不默认创建或要求独立 `font-contract.json`,也不新增行内 schema。`html-validation` 的可选 `--font-contract` 可消费已有契约,但不构成创建要求;用户明确要求契约输出时可按要求提供,不取代最终 HTML 的权威性。其他格式仅在已选 workflow 确实要求时使用 `font-contract.json`;pure-image 的视觉参考不要求资源契约。以下 JSON 及其字段说明仅为需要契约的其他 workflow 提供条件性交换格式,记录经目标环境验证的字体事实和角色分配,不包含产物路由、对象类型或实现协议字段,不施加给 HTML:
```json
{
"families": {
"Resolved Family Name": {
"source": "target_environment",
"availability": "verified",
"origin": "local",
"paths": ["/absolute/path/to/font.otf"],
"weights": [400, 700],
"fallback_stack": ["PingFang SC", "Microsoft YaHei", "sans-serif"],
"coverage_status": "complete"
},
"PingFang SC": {
"source": "target_environment",
"availability": "verified",
"origin": "system",
"paths": [],
"weights": [400, 600],
"fallback_stack": ["Microsoft YaHei", "sans-serif"],
"coverage_status": "complete"
}
},
"roles": {
"hero": {"family": "Resolved Family Name", "weight": 700},
"body": {"family": "PingFang SC", "weight": 400}
}
}
```
- family key 必须与当前渲染环境识别到的真实字体家族名完全一致;
- `source` 固定为 `target_environment`,只有目标渲染环境已实测可用才记录 `availability: verified`;未验证候选不能写成已就绪契约;
- `origin: local` 记录本地资源来源,只能使用已实测存在的真实绝对路径;本地安装不代表目标端可用;
- `origin: system` 记录系统来源,仍须在目标渲染环境按精确 family name 验证;
- CDN URL 和本地下载记录不能冒充目标端已就绪;资源核验后还须验证目标渲染环境的真实字体;
- `roles` 只绑定文字职责、字体家族和真实字重,不绑定对象类型或实现协议;
- 实际实现仍由已锁定的生产 workflow 负责,不以生成上述契约为统一前提。HTML 路线按 [HTML 协议](../html/coding-rendering.md) 将 Coding 文字实现为真实 DOM,仅在最终 HTML 对应元素的行内 `style` 写入所选 `font-family`、`font-weight` 与回退栈;HTML Item 内的 DOM 不套用 Canvas Item 字体字段白名单。HTML 远程字体按 [Web 字体契约](web-font-contract.md) 解析,只允许 head 内唯一 `data-web-fonts` 声明块;其他视觉样式仍须行内,字体由 `shot.py`/目标渲染环境验证;
- HTML 路线在 `shot.py` 预览时检查字体加载后的缺字、替换、换行、基线、伪粗体和裁切,核验结论写入既有 validation 输出,但不得把用于测量的 JavaScript 保留为作品尺寸或字体运行时依赖;
- 其他格式仅在已选 workflow 确实要求契约时,由该 workflow 完成上述交换字段的映射;字体文档不提供切换格式的理由。
## 本地字体资源核验
按需使用 [资源解析器](../../scripts/runtime/resolve_font.py) 核验已获取的字体。WOFF/WOFF2 解码依赖 [素材工具依赖](../../scripts/runtime/requirements-assets.txt) 中的 FontTools 与 Brotli;缺少依赖或二进制损坏时必须报告未支持/未就绪,不能据后缀声称字形覆盖通过。
注册目录保留包内相对层级;不同子目录的同名字体互不覆盖。写入前检查全部目标,同内容可重复登记,不同内容的既有文件拒绝覆盖。目录内越界链接拒绝登记;失败撤回本次新增字体。已编码下载路径保持原有转义语义,不把 `%20` 再编码为 `%2520`。
上述检查只证明本地资源和字形覆盖,不能替代目标环境可用性验证,也不要求生成独立契约;记录方式遵循第 6 节,字体推荐与生产流程不变。
## 7. 回退规则
- 用户锁定精确字体或关键字形时,任一资源门禁失败都必须停止该字体定稿并请求用户确认补充资源或采用明确替代,不得自动进入下列回退;
- 未锁定精确字体时,标题字体不可用才可回到同语种、同角色、同关键形态与气质的下一个 `hero/sub` 候选;
- 未锁定精确字体时,正文字体不可用才可在同语种和阅读职责内回退到中性黑体、正文衬线或圆体;
- 回退先保留实际语种、字形与角色;简中思源黑体 VF 仅适用于中性黑体要求,不能代替宋体/书法/手写或韩文;
- 多语种必须按真实文案逐项检查,不通过中文或英文结果推断其他语种;
- 实际字体排版不允许静默浏览器回退;可编辑设计不得因字体不可用把普通文字栅格化为 IMAGE。此禁令不限制已锁定 pure-image 的图内文字生产,其成图可读性仍按原路线检查。
## 8. 维护
新增或修改字体时:
1. 更新对应 catalog 元数据;
2. 若 CDN 已真实部署,向 manifest 添加经过 HEAD、文件头、大小和 MD5 验证的明确条目;
3. 在精选 JSON 更新主题、语种、角色与排序;已有候选保留其来源,未解析名称显式待核验,不根据名字编造字体事实;
4. 平台清单有真实变更时同步 `fonts.md` 与 JSON 查询镜像,保留精确 family 和各 style 的字重集合;
5. 运行 `scripts/test/test_font_union.py`、CSS 查询和引用检查,核对组合 ID、旧候选保留、语言过滤、排除回退与平台表一致性;
6. 真实下载、字体加载、缺字与目标尺寸的视觉适配在生产环境单独验证,静态测试不代替渲染。
最终 HTML 仅允许 [Web 字体契约](web-font-contract.md) 定义的受控字体声明块,禁止其他样式块与外部样式表;字体最终以目标环境可用 face 与真实 DOM 验证为准,推荐结果不等于资源就绪。
本地解析器的 `package_status=local_present` 仅表示本地资源存在;`invalid` 表示字体解析或结构核验失败,`blocked_by_license` 表示许可阻断。`contract_ready=true` 只代表本地许可、family 和字形覆盖检查通过,不证明目标环境加载成功,也不表示必须创建 `font-contract.json`;`target_environment_status=not_checked` 时仍须完成上述环境门禁。登记包内全部字体与预期路径合并核验,下载遇到不同内容的已有文件或晚到冲突会保留原文件并报错。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |