跳转到主要内容

CLAUDE.md — inferEra-docs

AIHubMix / inferEra 官方文档站(Mintlify)。9 个语言cn(简体,主版本/真相源)、enjpkozh-Hantfrdeespt。导航在 docs.json,新页面必须注册到对应语言pages 列表。
  • 更新日志:<lang>/update/News.mdx(实时流水,倒序,最新在上)
  • 博客:<lang>/blogs/*.mdx,封面图 images/blogs/<slug>.webp(跨语言共用同一张)
  • 默认简体中文:所有内容先做 cn/ 定稿,再扇出其它 8 语言。

写作红线(所有文档强制遵守)

写任何文档、更新日志、博客、代码示例前,先过这六条。完整核对清单见 WRITING-CHECKLIST.md
  1. 只陈述事实。 不写推测、不写营销夸张、不写主观评价。能力描述必须可核实。
  2. 专有名词取官方话术。 模型名、参数、协议、功能名一律以官方文档 / 官方页面为准;模型描述必须查官方文档,不得杜撰
  3. 禁止任何比喻。 不用类比、拟人、形象化修辞,直接说清楚是什么。
  4. 禁止「不是……而是……」句式。 以及一切先否定再转折的对比结构,直接正面陈述。
  5. 不暴露内部平台逻辑。 渠道路由、计费实现、白名单、少计费/补计费、运营策略、内部 bug 归因等一律不写进面向用户的文档;计费 / 稳定性变更用中性的能力表述(如「计费覆盖扩展」「稳定性优化」)。
  6. 密钥走环境变量。 AIHUBMIX_API_KEY 等一律走全局环境变量,绝不写进脚本 / 提交 / 示例明文。
代码示例的 prompt 统一用英文(如 "What is the meaning of life?"),不夹带中文长文本或特定文化题材,避免触发下游内容过滤。

月度「发布聚焦 / Release Spotlight」——固定 SOP

每月底从三处来源挑亮点,派生成一篇可分发的博客(栏目名固定 发布聚焦 / Release Spotlight,对标 OpenRouter)。求精不求全;流水留 News.mdx,汇总只挑用户会在意的。淡月可并双月一篇。

第 1 步 · 三处来源(每月固定取这三处)

第 2 步 · 写 cn 汇总

文件 cn/blogs/aihubmix-<年>-<月>-recap.mdx。结构:
口吻 = 官方(不是口语):陈述/规范表述,「现已支持」「无需改动」「可自定义」,不用「挂了/就行/逛逛」。结构「功能在前、模型在后」。

第 3 步 · 封面图

风格规范见 images/blogs/COVER-SPEC.md:浅底单色蓝、扁平/场景插画、无文字无 logo、构图随主题自由发挥、风格色调统一。出图一条龙:
已有图只需处理:python3 scripts/make_cover.py <输入图> <slug>

第 4 步 · 注册 + SEO 自检

  • docs.jsoncn Blog pages 列表最前"cn/blogs/<slug>"
  • python3 scripts/doc_lint.py cn/blogs/ -v,确保 description / img-alt(hero 图) / updated / faq 都过。

第 5 步 · 扇出 8 语言(agent teams 并行)

cn 定稿后,起 8 个 per-language agent(en/jp/ko/zh-Hant/fr/de/es/pt)并行,每个:
  1. 翻译 recap → <lang>/blogs/<slug>.mdx(保留模型ID/代码/价格/URL/图路径,链接 /cn//<lang>/,栏目名「Release Spotlight」保留)。
  2. 同步 <lang>/update/News.mdx 的当月条目对齐 cn(只动当月段,其余月份不碰)。
  3. 同步其它被改的博客(封面/标题/description)。
完成后主流程统一注册各语言到 docs.json、校验 JSON、提交。

SEO / GEO 要点

  • 标题含「<年><月> + 模型数」命中长尾;去 AIHubMix 前缀(站名自动拼)。
  • 新模型用加粗实体名 + 一句能力描述。
  • 首屏 hero 图带语义 alt;正文配 FAQ(AI 搜索爱引用)。
  • description 把当月主要模型/功能名都码进去。

可复用资产索引

样板(2026 年 6 月)

cn/blogs/aihubmix-2026-06-recap.mdx + 9 语言版;5 篇博客封面体系;News.mdx 6 月条目齐。PR #14。