它如何决定用中文还是英文回答:learn-from-materials 学习网页的语言路由机制完整指南

原创2026-10-16 17:57:381,668 阅读
文章标签:AI 技能AI 应用人工智能知识库知识管理教育文档CLI

它如何决定用中文还是英文回答:learn-from-materials 学习网页的语言路由机制完整指南

learn-from-materials 是一个把 PDF、书籍、论文变成可追溯、可测验、可做笔记的交互式学习网页的开源项目。它内置的语言路由机制会在第一次回答之前,按「用户明确偏好 → 当前请求语言 → 会话历史语言」的三级顺序,决定用中文还是英文输出讲解、界面和可复制口令——而不是看材料本身是什么语言。

learn-from-materials 中文学习网页新手引导界面

为什么语言要"先回答前就决定"

打开项目入口文件 SKILL.md,你会发现一条写得很靠前的规则:

Language routing — before your first reply(语言路由——在你的第一次回复之前)

也就是说,语言决策是整条流水线(提取材料 → 建知识库 → 生成学习页)的第 0 步。它一次决定四类产出:

产出物 受语言路由影响
AI 的讲解与追问回答 ✅ 全部按路由语言输出
生成的知识库文字(单元、术语、审计说明) ✅ 按路由语言生成
学习网页的固定界面(按钮、标签、提示) ✅ 自动切换
可复制口令(自检口令、详解口令、追问口令) ✅ 口令正文也按语言生成

同一份材料,路由到中文还是英文,得到的是两套完整的产出——比如同一个新手引导页:

learn-from-materials 英文学习网页新手引导界面

中文版与英文版界面逐句对应,这正是路由结果落到 meta.language 后的渲染效果。

语言路由的三级决策链

第一级:用户明确偏好优先

只要你在请求里明说"请用英文回答""Please output in English",这条偏好无条件覆盖其他一切信号——哪怕整个对话此前都是中文。这是唯一能让语言"瞬间反转"的入口。

第二级:看"当前实质性请求"的语言

没有明确偏好时,路由只盯着你当前这句话:

  • 忽略附带的材料、引用原文、代码和文件路径的语言;
  • 中文提问 → 中文回答,英文提问 → 英文回答;
  • 特别注意:粘贴英文材料 ≠ 英文请求。你贴进来一篇英文论文让"帮我总结",如果指令是中文,产出仍是中文。

第三级:沿用已建立的会话语言

前两级都判不出时,跟随对话已经确立的语言继续,避免来回跳语言。

兜底:真判不出就问一句

如果确实模棱两可,协议要求 AI 只问一个简短的语言问题(可同时附上学习深度选择),而不是猜。

这套规则完整定义在 SKILL.md 的 "Language routing" 一节,并延伸到共享参考文档 language-relationships-application.md。

四个最容易踩的误区 ❌

误区 实际规则
"材料是英文论文,所以回答也该是英文" 回答语言跟请求走:英文请求 + 中文 PDF → 英文讲解(保留原文引用);中文请求 + 英文论文 → 中文讲解
"看你浏览器设置/文件名猜语言" 明确禁止依据国籍、浏览器语言、文件名或材料语言推断
"界面切到英文,旧内容就自动翻译了" 渲染器只翻译固定控件,从不翻译你提供的内容
"换个语言重新生成,pageId 会变" 重新生成语言时保留稳定的 pageId、方法 ID 和出处证据,笔记和错题不丢失

第三条值得展开:meta.language 只影响固定 UI 文案(如"核心框架 → Core frameworks"),正文、材料原话、来源标题和文件名永远原样保留。想要英文正文,必须重新生成解释性字段,而不是指望一键翻译。

决策结果落盘:meta.language 字段

路由得出的结论会写入页面 JSON 的 meta.language,只允许两个取值:zh-CN 或 en。

"meta": {
  "language": "zh-CN",
  "pageId": "stable-material-id"
}

这个字段背后有一套完整约束(详见 content-contract.md):

  • 门禁校验:page_extensions.py 在 schema 4.3 下强制要求 meta.language 必须是 zh-CN 或 en,出现 fr 之类的值会直接报错阻断渲染;
  • 旧版兼容:4.2 页面缺失 language 字段时默认按中文处理;
  • 渲染翻译:localization.py 通过 ContextVar 把当前语言传入渲染流程,只对照固定词表 en.txt 替换模板自带的 UI 短语,绝不触碰材料内容;
  • 回归测试:test_features.py 会断言英文页面的静态 UI 不含任何中文字符,且材料原话(如"材料依据")不被翻译。

下面是一张按中文路由生成的系统学习页,"核心框架"模块中的讲解、卡片与出处标注均为中文,而原始英文术语与引用保持原样:

learn-from-materials 中文核心框架卡片学习页

常见场景速查表

你的操作 输出语言
中文提问"帮我学习这本书"(材料是英文书) 中文讲解 + 中文界面,原文引用保留
英文提问 "Summarize this PDF"(材料是中文书) 英文讲解 + 英文界面,原文引用保留
中文对话中追加一句"Please answer in English" 立即切换为英文
粘贴英文论文 + 中文指令 中文
用日语提问 说明当前 beta 仅支持 en / zh-CN,并请你选一种

幕后一瞥:路由在源码里的位置 🧭

想深入看实现,按这条链路读即可:

常见问题

Q:切换语言后,旧的 HTML 会被自动翻译吗? 不会。meta.language 只作用于固定控件;已有正文需要重新生成解释性字段,且 pageId、方法 ID 和出处证据保持稳定。

Q:英文页面的术语表还需要中文含义吗? 不需要。英文词条的 zhMeaning 可省略,但英文缩写仍必须给出 fullName(全称)。

Q:路由错了怎么办? 直接在对话里用明确偏好纠正("请用中文继续"),之后重新生成对应语言的页面即可,本地笔记与错题不受影响。

一句话总结:语言跟着"你说的话"走,不跟着材料、浏览器或国籍走;决策一次生效于讲解、界面、Markdown 和所有可复制口令——这就是 learn-from-materials 语言路由的完整逻辑。

登录后查看全文
learn-from-materials