CLAUDE.md — inferEra-docs
AIHubMix / inferEra 官方文档站(Mintlify)。9 个语言:cn(简体,主版本/真相源)、en、jp、ko、zh-Hant、fr、de、es、pt。导航在 docs.json,新页面必须注册到对应语言的 pages 列表。
- 更新日志:
<lang>/update/News.mdx(实时流水,倒序,最新在上) - 博客:
<lang>/blogs/*.mdx,封面图images/blogs/<slug>.webp(跨语言共用同一张) - 默认简体中文:所有内容先做
cn/定稿,再扇出其它 8 语言。
写作红线(所有文档强制遵守)
写任何文档、更新日志、博客、代码示例前,先过这六条。完整核对清单见WRITING-CHECKLIST.md。
- 只陈述事实。 不写推测、不写营销夸张、不写主观评价。能力描述必须可核实。
- 专有名词取官方话术。 模型名、参数、协议、功能名一律以官方文档 / 官方页面为准;模型描述必须查官方文档,不得杜撰。
- 禁止任何比喻。 不用类比、拟人、形象化修辞,直接说清楚是什么。
- 禁止「不是……而是……」句式。 以及一切先否定再转折的对比结构,直接正面陈述。
- 不暴露内部平台逻辑。 渠道路由、计费实现、白名单、少计费/补计费、运营策略、内部 bug 归因等一律不写进面向用户的文档;计费 / 稳定性变更用中性的能力表述(如「计费覆盖扩展」「稳定性优化」)。
- 密钥走环境变量。
AIHUBMIX_API_KEY等一律走全局环境变量,绝不写进脚本 / 提交 / 示例明文。
"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.json的cnBlogpages列表最前加"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)并行,每个:- 翻译 recap →
<lang>/blogs/<slug>.mdx(保留模型ID/代码/价格/URL/图路径,链接/cn/→/<lang>/,栏目名「Release Spotlight」保留)。 - 同步
<lang>/update/News.mdx的当月条目对齐 cn(只动当月段,其余月份不碰)。 - 同步其它被改的博客(封面/标题/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。