汉仪字体推荐

概述

在汉仪字体目录中检索，并产出一套可审计、多角色的字体推荐。优先复用已通过人工审核的预设组合；没有合适预设时，基于目录事实构建受约束的动态组合。

需求理解

只推断明确信息，仅在缺失信息会实质改变结果时才向用户追问：

• 媒介：document / presentation / web / product-ui / dashboard / campaign / brand / packaging / editorial / event；
• 任务与行业、受众与调性；
• 信息密度与语种/字符需求；
• 所需角色：display、heading、subheading、body、label、data、accent 等；
• 固定字体、排除字体、输出格式。

无法推断媒介时，返回澄清请求，而不是臆造预设。把嵌入示例与否定性短语当作上下文，而不是主任务。

决策规则

按以下顺序应用约束：

1. 依据 references/font-catalog.json 解析固定字体与排除字体。
2. 拒绝违反角色硬约束的固定字体。body 字体必须是「正文高可读」且 GB2312 覆盖 ≥ 95%。缺少可靠等宽元数据时，不得为 code 角色自动选择汉仪字体。
3. 用 references/recommendation-taxonomy.json 解析请求。
4. 仅当评分达到路由阈值、且其审核状态可用时，才路由到 references/recommendation-presets.json。
5. 没有可用预设时，按角色、可读性、使用场景标签、调性、上下文、覆盖率、资源完整度与热度对目录字体打分。合理复用同一字族，组合内最多四款汉仪字体。

内置的 36 组预设是设计草稿，直到有人在 references/preset-review.json 中修改其记录。草稿可在审核模式下展示，但不得被描述为「已批准」。

推荐输出

返回以下内容：

• 归一化后的解释与假设；
• 来源、适用的 preset ID、置信度与审核状态；
• 每个角色一条已解析的字体记录，含 font_id、字族、名称、可读性、选择理由、使用边界，以及一条字由（HelloFont）预览链接；
• 需要时的候选评分列表；
• 搭配理由、备选方案、设计说明与澄清状态；
• 需要时为 HTML/CSS、PDF Python 或 PPTX Python 生成仅含字族名称的代码片段；这些片段不得下载或内嵌字体文件。

对话输出中，把预览链接紧跟在每款推荐字体之后，使用如下 Markdown 结构，让用户可点击打开而不会自动跳转：

- 标题：汉仪旗黑 70S（font_id 835） · [在字由预览](https://www.hellofont.cn/font-detail?fontid=835)

除非用户明确要求打开或预览某款字体，否则不要主动打开该页面。

不得暴露 OSS URL、可下载的字体文件 URL、@font-face 源 URL 或静态预览资源 URL。检索与推荐基于本地元数据索引运行，对外输出只包含元数据和字由 font-detail URL。审核板不得加载字体文件；它是一个结构性审核索引，把视觉检查引导到字由。

普通字体查询使用搜索模式，返回目录事实，不强制给出搭配推荐。

命令行

# 遍历 36 组草稿预设，供人工审核
python3 scripts/recommend.py --content "AI 医疗融资路演" --review-mode --output json

# 带排除项与 HTML 应用代码的动态推荐
python3 scripts/recommend.py --content "冷静专业的后台系统" 
  --exclude-font 992 --format html --output json

# 把某角色固定到目录中的已知字体
python3 scripts/recommend.py --content "技术白皮书" 
  --fixed-font body=831 --review-mode --output json

# 全目录搜索
python3 scripts/recommend.py --search --base-type "黑体/无衬线" 
  --readability "正文高可读" --output json

# 生成 36 卡片人工审核板
python3 scripts/render_review.py

资源

• 读取 references/font-catalog.json 获取完整字体事实。
• 解析请求或调试路由时读取 references/recommendation-taxonomy.json。
• 读取 references/recommendation-presets.json 获取 36 组多角色方案与真实样张。
• 判断预设是否可用、或记录人工审核结果时读取 references/preset-review.json。
• 使用 scripts/recommend.py 做确定性搜索、路由、约束、动态评分与应用代码片段。
• 使用 scripts/render_review.py（或兼容包装 scripts/preview.py）重新生成 assets/review/preset-review.html 及其 JSON 快照。
• 使用 scripts/validate_data.py 校验参考数据完整性。

人工审核应使用字由链接检查真实渲染字形，再核对层级、长文可读性、中西文混排、数字、覆盖率、路由契合度与声明的使用边界，之后才能把预设从 draft 改为已批准。

单款字体交互预览可打开 https://www.hellofont.cn/font-detail?fontid={font_id}。推荐结果中以 hellofont_preview_url 字段暴露该链接。本地审核板比较的是推荐元数据与角色分配；实际字形需通过各字体的字由详情页检查。