dsh-plugin-lookatstudy 0.16.0 → 0.18.0

package/lib/index.mjs

@@ -41,13 +41,721 @@ const Config = z.object({
 	]).default("auto")
 });
 //#endregion
+//#region src/client/locale.ts
+/** Simplified Chinese dictionary (also the fallback locale). */
+const ZH = {
+	"tab.label": "学习",
+	"col.rail": "课程",
+	"col.tutor": "导师",
+	"col.bb": "黑板",
+	"pane.rail": "课程",
+	"pane.chat": "对话",
+	"pane.note": "黑板",
+	"viewtab.teach": "讲解",
+	"viewtab.cmap": "概念图",
+	"viewtab.cmap.title": "本课概念之间的关系图",
+	"loading": "加载中…",
+	"start.title": "一键准备学习:建立学习工作区、开启会话并让导师就位",
+	"start.go": "开始学习",
+	"start.enter": "进入学习",
+	"start.busy": "正在准备学习区…",
+	"soul.direct": "直讲",
+	"soul.direct.hint": "精讲:先讲清楚,再确认懂没懂",
+	"soul.guide": "引导",
+	"soul.guide.hint": "引导:让你自己往前推一步,导师递台阶",
+	"soul.practice": "实战",
+	"soul.practice.hint": "实战:在真实世界的乱问题里学",
+	"zone.understand": "🧠 理解区 — 知识结构",
+	"zone.record": "📝 记录区 — 我的话",
+	"zone.practice": "✍️ 练习区 — 答题日志",
+	"rail.empty.title": "暂无课程",
+	"rail.empty.hint": "粘贴 markdown → 说「导入为课程」",
+	"rail.empty.hint2": "本地文件夹 → 说「导入 D:/path/to/folder」",
+	"rail.empty.placeholder": "GitHub 仓库链接,如 microsoft/AI-For-Beginners",
+	"rail.empty.button": "导入",
+	"composer.send": "发送",
+	"quiz.card.title": "练习",
+	"quiz.progress": "{cur}/{total}",
+	"quiz.next": "下一题",
+	"quiz.finish": "看成绩单",
+	"quiz.score": "成绩：{correct}/{total}",
+	"quiz.right": "答对了",
+	"quiz.wrong": "答错了",
+	"quiz.youChose": "你选了",
+	"quiz.answer": "正确答案",
+	"quiz.hook": "练习卡完成：{correct}/{total} 正确。请简短点评，针对错题讲讲思路。",
+	"quiz.action.explain-wrong": "讲讲错题",
+	"quiz.action.retry": "再来一组",
+	"quiz.action.go-deeper": "深入原理",
+	"quiz.action.mark-mastered": "标记我掌握了",
+	"quiz.action.markMastered.hint": "会让导师出综合题检验，通过即标记掌握",
+	"quiz.action.next-topic": "下一个知识点",
+	"artifact.lines": "第 {from}-{to} 行：",
+	"artifact.expand": "放大查看",
+	"artifact.guess.title": "猜一猜",
+	"artifact.guess.pick": "我选「{label}」",
+	"artifact.guess.wait": "已记下你的直觉——导师下回合揭晓，看看你想得对不对",
+	"artifact.sedimented": "有新的学习产物沉淀进笔记",
+	"zone.artifacts": "AI 产物",
+	"note.quote.ask": "提问这段",
+	"note.quote.save": "加到笔记",
+	"note.quote.template": "请讲解这段：「{text}」",
+	"note.saved": "已存入记录区笔记",
+	"review.rate.title": "复习自评——这课现在记得多牢？",
+	"review.again": "再来一次",
+	"review.remembered": "记住了",
+	"review.mastered": "完全掌握",
+	"review.done.good": "已安排下次复习",
+	"review.done.again": "明天再来一遍",
+	"review.jump": "点开这一课去复习",
+	"review.nudge": "有 {n} 课到了复习时间，先回来练一遍？",
+	"review.nudge.go": "去复习",
+	"rail.search.jump": "打开这一课",
+	"proposal.banner": "《{lesson}》可以提前毕业了",
+	"proposal.accept": "接受",
+	"proposal.decline": "再练练",
+	"proposal.accept.msg": "我接受《{lesson}》的掌握度提议，帮我标记为掌握。",
+	"proposal.decline.msg": "《{lesson}》我先再练练，暂不接受提前毕业。",
+	"tutor.thinking": "导师思考中…",
+	"header.xp": "经验值 {xp}",
+	"header.streak": "连续学习天数",
+	"header.level": "等级",
+	"map.node.locked": "锁定 — 先完成前面的课时",
+	"map.node.due": "到了复习时间",
+	"map.exam.locked": "考试未解锁 — 本章节全部课时掌握度 ≥50% 后开放",
+	"map.tab.map": "地图",
+	"map.tab.import": "导入",
+	"map.world.study": "学习",
+	"map.world.practice": "实操",
+	"map.empty.practice": "这个课程暂无实操练习内容",
+	"map.streaming.notice": "导师正在回复…",
+	"thread.streamingBadge": "AI 正在输出",
+	"map.search.label": "搜索",
+	"map.review.label": "复习",
+	"map.overlay.close": "关闭",
+	"chat.start": "开始学习",
+	"chat.start.hint": "从当前课时的第一个开场动作开始",
+	"prompt.start": "你好，我们开始学这一课吧：先给我一个两三句话的导览，再从第一个知识点讲起。",
+	"mode.label": "风格：",
+	"rail.deleted": "课程已删除",
+	"review.random": "随机复习一课",
+	"review.random.hint": "随机跳到一门到期课程（交错复习）",
+	"scroll.bottom": "回到底部",
+	"chat.stop": "停止生成",
+	"quiz.submit": "提交",
+	"proposal.applied": "《{lesson}》已采纳提前毕业提议",
+	"proposal.rejected": "《{lesson}》提议已忽略，继续保持练习",
+	"companion.poke": "戳一戳伴学伙伴",
+	"companion.poked": "伴学伙伴向你眨了眨眼",
+	"companion.form.ember": "小焰",
+	"companion.form.frost": "霜绒",
+	"companion.form.moss": "苔芽",
+	"companion.form.star": "星尘",
+	"companion.form.ink": "墨墨",
+	"settings.companion": "伴学伙伴",
+	"settings.companion.hint": "选择学习面板右下角的伴学生物形态。",
+	"quiz.msg.explain-wrong": "我刚才有题答错了，帮我讲讲为什么错、正确的思路是什么。",
+	"quiz.msg.retry": "再来一组类似的题巩固一下。",
+	"quiz.msg.go-deeper": "这组我答得不错，帮我深入讲讲背后的原理和容易混淆的地方。",
+	"quiz.msg.mark-mastered": "这课我觉得掌握了，帮我确认一下——出个综合题检验，通过了就标记为掌握。",
+	"quiz.msg.next-topic": "进入下一个知识点。",
+	"toast.region": "通知",
+	"toast.close": "关闭",
+	"composer.busy": "导师正在回复…",
+	"rail.empty.demo": "导入示例课程",
+	"import.cta": "导入新课程",
+	"import.tab.url": "URL",
+	"import.tab.md": "MD",
+	"import.tab.folder": "文件夹",
+	"import.tab.epub": "电子书",
+	"import.tab.pack": "课程包",
+	"import.url.desc": "GitHub 仓库、arXiv 论文或网页文章的链接",
+	"import.btn.url": "导入",
+	"import.placeholder.name": "课程名(可选)",
+	"import.placeholder.md": "粘贴 Markdown:## 是章节,### 是课时",
+	"import.btn.md": "导入为课程",
+	"import.folder.desc": "本地文件夹路径(内含 Markdown/电子书/代码的仓库)",
+	"import.folder.pathPlaceholder": "D:/path/to/folder",
+	"import.btn.folder": "导入文件夹",
+	"import.epub.desc": "EPUB 电子书文件路径(按其所在文件夹导入,章节拆课)",
+	"import.epub.pathPlaceholder": "D:/books/我的电子书.epub",
+	"import.btn.epub": "导入电子书",
+	"import.pack.desc": "学习包(.md,study_export 导出的课程)——在本机选择文件",
+	"import.btn.pack": "选择课程包文件",
+	"import.progress.title": "正在导入课程…",
+	"import.progress.starting": "正在启动…",
+	"import.progress.note": "导入在导师会话中进行，可继续浏览其他课程",
+	"import.progress.cancel": "取消导入",
+	"import.progress.elapsed": "已 {s}s",
+	"import.step.fetch": "清点内容",
+	"import.step.design": "设计课程结构",
+	"import.step.apply": "落库建课",
+	"import.step.done": "完成",
+	"import.cancelled": "已取消导入",
+	"import.error": "导入失败:{msg}",
+	"import.error.turn": "这一轮结束了,但没有新课程出现——请看对话里的导师反馈",
+	"import.success": "导入成功",
+	"chat.copy": "复制",
+	"chat.copied": "已复制",
+	"error.renderFailed": "这部分内容渲染失败(可能格式有问题)。",
+	"error.retry": "重试",
+	"note.renderFailed": "这段内容渲染失败了。",
+	"note.truncated": "(已截断)",
+	"note.retryRender": "重试渲染",
+	"zoom.in": "放大面板字号",
+	"zoom.out": "缩小面板字号",
+	"palette.label": "命令面板",
+	"palette.placeholder": "搜索课时/课程,或选择动作…",
+	"palette.lessons": "课时",
+	"palette.courses": "课程",
+	"palette.review": "开始复习",
+	"palette.study": "开始学习",
+	"palette.empty": "没有匹配项",
+	"threads.label": "课时线程",
+	"meter.label": "上下文用量",
+	"meter.estimate": "约 {n} tok(按事件字符估算)",
+	"model.unknown": "当前模型",
+	"model.switched": "已切换到 {model}",
+	"model.switchFailed": "切换失败——请看宿主模型设置",
+	"settings.budget": "历史预算",
+	"settings.budget.hint": "开启后导师在长会话中主动概括旧轮次(上游 v0.27 历史预算的导师层执行)",
+	"settings.budget.on": "开启历史预算",
+	"settings.budget.off": "关闭历史预算",
+	"attach.sent": "我发了一个文件:{name}(工作区路径 {path})——请读取它再继续。",
+	"attach.fail": "附件上传失败",
+	"attach.label": "附件(≤20MiB,存入学习工作区)",
+	"rail.mastered": "毕业 {mastered}/{total} 课",
+	"rail.avg": "平均掌握度 {pct}%",
+	"rail.avg.none": "尚无掌握度数据",
+	"rail.search": "搜索课时…(多关键词空格分隔)",
+	"rail.locate.title": "在课程树中定位当前焦点课时(自动展开所在章节)",
+	"rail.locate": "回到当前课时",
+	"rail.due": "待复习 {count}",
+	"rail.due.over": "超{days}天",
+	"rail.due.start": "开始复习",
+	"rail.due.none": "暂时没有到期的复习，保持节奏！",
+	"chat.reasoning": "思考过程（{n} 字）",
+	"msg.speak": "朗读",
+	"note.pin": "置顶笔记",
+	"note.unpin": "取消置顶",
+	"note.locate": "回到原文",
+	"note.edit": "编辑备注",
+	"note.save": "保存",
+	"confirm.cancel": "取消",
+	"rail.due.tag": "这课时的复习今天到期(SM-2)",
+	"rail.delete": "删除本课程",
+	"rail.delete.confirm": "确认删除?",
+	"rail.delete.title.confirm": "再点一次确认删除(含全部进度与笔记)。反悔前可先在设置页备份状态文件",
+	"note.delete": "删除本条笔记",
+	"note.delete.confirm": "确认删除?",
+	"read.play": "朗读本课",
+	"read.stop": "停止朗读",
+	"read.pause": "暂停朗读",
+	"read.resume": "继续朗读",
+	"read.engine.system": "网络合成不可用，已切换为系统语音",
+	"read.unavailable": "朗读不可用",
+	"rail.section.collapse": "折叠本章节",
+	"rail.section.expand": "展开本章节({count} 课时)",
+	"rail.section.count": "{count} 课",
+	"rail.lesson.opening": "正在打开课时会话…",
+	"rail.lesson.openHint": "（点击将打开本课专属会话）",
+	"rail.import.toggle": "导入课程",
+	"rail.import.close": "收起导入",
+	"tag.weak": "{count} 个薄弱知识点,测验会优先考察",
+	"tag.friction": "{count} 次卡点记录(你说\"不懂\"时导师记下的)",
+	"tag.mastery": "课时掌握度 {pct}%(取最薄弱知识点)",
+	"tag.mastery.short": "课时掌握度 = 最薄弱知识点的掌握度",
+	"status.exam": "章节测验:本节全部课时掌握度 ≥50% 后开放",
+	"status.mastered": "已毕业:掌握度 ≥90%(或你接受了掌握提案)",
+	"status.in_progress": "学习中:已开课,掌握度从 50% 起步",
+	"status.available": "可开始:已解锁,尚未学习",
+	"status.locked": "未解锁:先完成前面的课时",
+	"chip.unattributed": "未归因",
+	"chip.correct": "✓ 答对 · {concept}",
+	"chip.wrong": "✗ 答错 · {concept}",
+	"row.thinking": "导师思考中…",
+	"row.thinking.title": "导师正在推理,回复马上就来",
+	"quiz.title": "点击选项作答,也可以直接打字回答",
+	"quiz.answer": "选 {letter}:{text}",
+	"tutor.dormant": "学习模式已关闭 — 点右上「▶ 开始学习」开启导师,按钮恢复可用。",
+	"tutor.empty": "对话会出现在这里",
+	"tutor.empty.hint": "在下方输入框和导师说话",
+	"proposal.text": "导师提议你已掌握「{lesson}」:{rationale}",
+	"proposal.accept": "接受",
+	"proposal.decline": "再练练",
+	"bb.empty": "黑板还空着",
+	"bb.empty.hint": "在左侧课程树选择一课",
+	"bb.mastery": "掌握度 {pct}%",
+	"cmap.legend": "琥珀色 = 薄弱知识点(掌握度 <70%)",
+	"cmap.node.pct": "掌握度 {pct}%",
+	"bb.strategy": "本课学法",
+	"bb.fallback.cmap.empty": "概念图需要先由导师定义本课概念",
+	"bb.fallback.cmap": "概念图渲染不可用(布局引擎加载失败) — 已回退讲解视图",
+	"bb.notes": "笔记",
+	"bb.notes.empty": "这一课还没有笔记",
+	"tv.exam.stars": "本次 {n}★(历史最佳 {best}★)",
+	"tv.exam.fail": "这轮没拿到星——错题就是下一课的地图,从每题的解析看起。",
+	"active.off.title": "注册 study 工具并载入导师人格,之后普通对话和现在一样",
+	"active.on.title": "注销 study 工具与导师人格;学习进度保留,可随时重新开启",
+	"active.off": "▶ 开始学习",
+	"active.on": "⏻ 退出学习模式",
+	"prompt.kickoff": "开始学习:查看我的学习状态并打开当前焦点课时。如果我还没有课程,推荐我导入示例课程(AI-For-Beginners)并说明怎么开始。回复最后请提醒我点上方「学习」页签进入学习界面。",
+	"settings.nav": "学习",
+	"settings.mode": "教学风格",
+	"settings.mode.hint": "导师的讲解风格;也可在学习页随时切换",
+	"settings.studyMode": "学习模式",
+	"settings.voice": "朗读语音",
+	"settings.voice.hint": "「朗读本课」使用的神经网络声音（浏览器本地偏好）",
+	"voice.xiaoxiao": "晓晓 · 中文女声",
+	"voice.yunxi": "云希 · 中文男声",
+	"voice.yunyang": "云扬 · 中文男声（新闻）",
+	"voice.xiaoyi": "晓伊 · 中文女声（轻快）",
+	"voice.aria": "Aria · English female",
+	"voice.guy": "Guy · English male",
+	"settings.studyMode.hint": "开启后注册 study_* 工具并载入导师人格;进度与笔记始终保留",
+	"settings.on": "状态：已开启",
+	"settings.off": "状态：已关闭",
+	"settings.turnOn": "开启",
+	"settings.turnOff": "关闭",
+	"settings.stats": "学习统计",
+	"settings.stats.courses": "课程 {count} 个",
+	"settings.stats.xp": "XP {xp} · Lv{level}({pct}%)",
+	"settings.stats.today": "今日 {xp}/{goal}",
+	"settings.stats.streak": "连续 {days} 天(最长 {best},剩冻结 {freeze})",
+	"settings.about": "关于",
+	"settings.about.hint": "当前运行的构建版本,点击查看该版更新内容。",
+	"settings.stateFile": "状态文件",
+	"settings.stateFile.hint": "学习进度存放于本机 JSON,换机可迁移",
+	"dock.title": "学习状态:待复习 {due} · 连续 {streak} 天 · Lv{level} — 点上方「学习」页签进入",
+	"dock.due": "{count}",
+	"dock.streak": "{days}天",
+	"dock.lv": "Lv{level}",
+	"prompt.import": "导入课程:用 study_import_github 抓取 {url}",
+	"prompt.import.url": "导入课程:用 study_import_url 导入这个链接 {url}(GitHub 仓库会自动走仓库导入)。",
+	"prompt.import.md": "把下面的内容用 study_import_markdown 导入为课程{title}:\n\n{md}",
+	"prompt.import.folder": "导入课程:用 study_import_folder 扫描本地文件夹 {path}{title},按它的设计简报完成课程设计并落库。",
+	"prompt.import.epub": "导入课程:用 study_import_folder 扫描电子书所在的文件夹 {path}(其中有电子书 {file},章节会被拆成课时){title},完成设计并落库。",
+	"prompt.lesson": "学习「{title}」:用 study_lesson 打开这一课开始学习。",
+	"prompt.exam": "开始「{section}」的章节测验:按本节课时出题,答完逐题判分",
+	"artifact.zoomOut": "缩小",
+	"artifact.zoomIn": "放大",
+	"artifact.canvas.fit": "适屏",
+	"viewtab.board": "黑板",
+	"bb.board.empty": "导师产出的大幅内容(对比表/图表/代码走查)会登上这块黑板——可缩放、可拖动、双击适屏。",
+	"exam.generating.title": "正在准备章节测验",
+	"exam.generating.stage": "导师正在按本节知识点出题",
+	"exam.generating.kcProgress": "{done}/{total} 个知识点已出题",
+	"exam.generating.preparing": "正在规划题量…",
+	"exam.generating.canLeave": "生成在后台进行——可以切去别的课,回来接着看。",
+	"exam.errorTitle": "出题失败",
+	"exam.errorEmpty": "没有拿到题库。",
+	"exam.failed.retry": "重新生成",
+	"exam.ready.title": "章节测验就绪",
+	"exam.ready.meta": "{q} 题 · {kc} 个知识点 · 预计 {min} 分钟",
+	"exam.start": "开始考试",
+	"exam.regenerate": "重新出题",
+	"exam.regenerate.confirmMsg": "重新出题会换掉整份题库(历史成绩保留)。",
+	"exam.q.progress": "第 {i}/{n} 题",
+	"exam.q.next": "下一题",
+	"exam.q.submit": "交卷",
+	"exam.submitting": "正在批改…",
+	"exam.result.score": "{correct}/{total} 题",
+	"exam.result.accuracy": "正确率 {pct}%",
+	"exam.result.best": "历史最佳 {stars}★",
+	"exam.result.attempts": "已考 {n} 次",
+	"exam.terminated.banner": "本场考试中途离开——未答的题按错计。",
+	"exam.result.kcBreakdown": "按知识点",
+	"exam.result.weakKc": "薄弱",
+	"exam.result.review": "逐题回顾",
+	"exam.result.unanswered": "未作答",
+	"exam.result.correctLabel": "答对了",
+	"exam.result.yourAnswer": "你的答案",
+	"exam.result.correctAnswer": "正确答案",
+	"exam.retryExam": "重新考试",
+	"exam.leave.title": "离开这场考试?",
+	"exam.leave.message": "考试进行中——现在离开,未答的题将按错计分。",
+	"exam.leave.confirm": "离开并结算",
+	"exam.leave.cancel": "继续答题",
+	"prompt.exam.bank": "请为「{section}」的章节测验出题:先用 study_view 读一遍本节课时,再按各课时的知识点用 study_exam_bank_apply 一次性提交整份题库(单选 5-15 题,kcTitle 必须用本节的概念标题,每题附一句话解析)。题库就绪后告诉我可以开考。",
+	"prompt.review": "开始今天的复习,从最到期的课时开始",
+	"prompt.proposal.accept": "接受提案 {id} —— 确认标记这课为已掌握",
+	"prompt.proposal.decline": "拒绝提案 {id} —— 我想再练练"
+};
+/** English dictionary — key set must equal {@link ZH}'s (test-asserted). */
+const EN = {
+	"tab.label": "Study",
+	"col.rail": "Courses",
+	"col.tutor": "Tutor",
+	"col.bb": "Blackboard",
+	"pane.rail": "Courses",
+	"pane.chat": "Chat",
+	"pane.note": "Board",
+	"viewtab.teach": "Teach",
+	"viewtab.cmap": "Concepts",
+	"viewtab.cmap.title": "The lesson's concepts relate",
+	"loading": "Loading…",
+	"start.title": "One click to study: workspace + session + tutor, all set up",
+	"start.go": "Start learning",
+	"start.enter": "Enter study",
+	"start.busy": "Preparing the study area…",
+	"soul.direct": "Direct",
+	"soul.direct.hint": "Explain first, then check understanding",
+	"soul.guide": "Guide",
+	"soul.guide.hint": "You push one step forward; the tutor hands you the stairs",
+	"soul.practice": "Practice",
+	"soul.practice.hint": "Learn inside real, messy problems",
+	"zone.understand": "🧠 Understand — knowledge structure",
+	"zone.record": "📝 Record — in my own words",
+	"zone.practice": "✍️ Practice — answer log",
+	"rail.empty.title": "No courses yet",
+	"rail.empty.hint": "Paste markdown → say \"import as a course\"",
+	"rail.empty.hint2": "Local folder → say \"import D:/path/to/folder\"",
+	"rail.empty.placeholder": "GitHub repo link, e.g. microsoft/AI-For-Beginners",
+	"rail.empty.button": "Import",
+	"composer.send": "Send",
+	"quiz.card.title": "Practice",
+	"quiz.progress": "{cur}/{total}",
+	"quiz.next": "Next",
+	"quiz.finish": "See score",
+	"quiz.score": "Score: {correct}/{total}",
+	"quiz.right": "Correct",
+	"quiz.wrong": "Wrong",
+	"quiz.youChose": "You chose",
+	"quiz.answer": "Answer",
+	"quiz.hook": "Practice card finished: {correct}/{total} correct. Please comment briefly and walk through the wrong ones.",
+	"quiz.action.explain-wrong": "Explain my wrong answers",
+	"quiz.action.retry": "Another set",
+	"quiz.action.go-deeper": "Go deeper",
+	"quiz.action.mark-mastered": "Mark me as mastered",
+	"quiz.action.markMastered.hint": "Asks the tutor to verify with a final question, then marks mastery",
+	"quiz.action.next-topic": "Next topic",
+	"artifact.lines": "Lines {from}-{to}: ",
+	"artifact.expand": "Expand",
+	"artifact.guess.title": "Take a guess",
+	"artifact.guess.pick": "I pick \"{label}\"",
+	"artifact.guess.wait": "Your instinct is noted — the tutor reveals next turn",
+	"artifact.sedimented": "A new artifact settled into the notebook",
+	"zone.artifacts": "AI artifacts",
+	"note.quote.ask": "Ask about this",
+	"note.quote.save": "Add note",
+	"note.quote.template": "Please explain this passage: \"{text}\"",
+	"note.saved": "Saved to the record zone",
+	"review.rate.title": "Review self-check — how well do you remember?",
+	"review.again": "Again",
+	"review.remembered": "Remembered",
+	"review.mastered": "Mastered",
+	"review.done.good": "Next review scheduled",
+	"review.done.again": "Back again tomorrow",
+	"review.jump": "Open this lesson to review",
+	"review.nudge": "{n} lessons are due for review — come practice first?",
+	"review.nudge.go": "Review now",
+	"rail.search.jump": "Open this lesson",
+	"proposal.banner": "{lesson} is ready to graduate early",
+	"proposal.accept": "Accept",
+	"proposal.decline": "Keep practicing",
+	"proposal.accept.msg": "I accept the mastery proposal for \"{lesson}\" — mark it mastered.",
+	"proposal.decline.msg": "I want more practice on \"{lesson}\" before graduating.",
+	"tutor.thinking": "The tutor is thinking…",
+	"header.xp": "{xp} XP",
+	"header.streak": "Day streak",
+	"header.level": "Level",
+	"map.node.locked": "Locked — finish the previous lessons first",
+	"map.node.due": "Due for review",
+	"map.exam.locked": "Exam locked — every lesson in this section needs ≥50% mastery",
+	"map.tab.map": "Map",
+	"map.tab.import": "Import",
+	"map.world.study": "Learn",
+	"map.world.practice": "Practice",
+	"map.empty.practice": "No practice content in this course yet",
+	"map.streaming.notice": "The tutor is responding…",
+	"thread.streamingBadge": "AI is responding",
+	"map.search.label": "Search",
+	"map.review.label": "Review",
+	"map.overlay.close": "Close",
+	"chat.start": "Start learning",
+	"chat.start.hint": "Begin with this lesson’s first starter move",
+	"prompt.start": "Hi — let’s start this lesson: give me a two-sentence tour, then begin with the first concept.",
+	"mode.label": "Style: ",
+	"rail.deleted": "Course deleted",
+	"review.random": "Random review",
+	"review.random.hint": "Jump to a random due lesson (interleaved review)",
+	"scroll.bottom": "Back to bottom",
+	"chat.stop": "Stop generating",
+	"quiz.submit": "Submit",
+	"proposal.applied": "Graduation proposal for \"{lesson}\" accepted",
+	"proposal.rejected": "Proposal for \"{lesson}\" declined — keep practicing",
+	"companion.poke": "Poke the companion",
+	"companion.poked": "The companion winks at you",
+	"companion.form.ember": "Ember",
+	"companion.form.frost": "Frost",
+	"companion.form.moss": "Moss",
+	"companion.form.star": "Stardust",
+	"companion.form.ink": "Ink",
+	"settings.companion": "Companion",
+	"settings.companion.hint": "Choose the companion creature in the study panel corner.",
+	"quiz.msg.explain-wrong": "I got some questions wrong — walk me through why and the right line of thinking.",
+	"quiz.msg.retry": "Give me another similar set to consolidate.",
+	"quiz.msg.go-deeper": "I did well on this set — go deeper into the principles and common confusions.",
+	"quiz.msg.mark-mastered": "I feel I have mastered this lesson — verify me with a final question and mark it mastered if I pass.",
+	"quiz.msg.next-topic": "Move on to the next topic.",
+	"toast.region": "Notifications",
+	"toast.close": "Close",
+	"composer.busy": "The tutor is replying…",
+	"rail.empty.demo": "Import the demo course",
+	"import.cta": "Import a new course",
+	"import.tab.url": "URL",
+	"import.tab.md": "MD",
+	"import.tab.folder": "Folder",
+	"import.tab.epub": "eBook",
+	"import.tab.pack": "Pack",
+	"import.url.desc": "A GitHub repo, arXiv paper, or web-article link",
+	"import.btn.url": "Import",
+	"import.placeholder.name": "Course title (optional)",
+	"import.placeholder.md": "Paste markdown: ## becomes a section, ### a lesson",
+	"import.btn.md": "Import as course",
+	"import.folder.desc": "A local folder path (a repo of markdown/ebooks/code)",
+	"import.folder.pathPlaceholder": "D:/path/to/folder",
+	"import.btn.folder": "Import folder",
+	"import.epub.desc": "An EPUB file path (imports its folder; chapters split into lessons)",
+	"import.epub.pathPlaceholder": "D:/books/my-book.epub",
+	"import.btn.epub": "Import eBook",
+	"import.pack.desc": "A learning pack (.md exported by study_export) — pick the file",
+	"import.btn.pack": "Pick a course-pack file",
+	"import.progress.title": "Importing course…",
+	"import.progress.starting": "Starting…",
+	"import.progress.note": "The import runs in the tutor conversation — keep browsing other courses",
+	"import.progress.cancel": "Cancel import",
+	"import.progress.elapsed": "{s}s elapsed",
+	"import.step.fetch": "Inventory",
+	"import.step.design": "Design structure",
+	"import.step.apply": "Build course",
+	"import.step.done": "Done",
+	"import.cancelled": "Import cancelled",
+	"import.error": "Import failed: {msg}",
+	"import.error.turn": "The turn ended without a new course — check the tutor reply",
+	"import.success": "Imported",
+	"chat.copy": "Copy",
+	"chat.copied": "Copied",
+	"error.renderFailed": "This content failed to render (possibly malformed).",
+	"error.retry": "Retry",
+	"note.renderFailed": "This content failed to render.",
+	"note.truncated": "(truncated)",
+	"note.retryRender": "Retry render",
+	"zoom.in": "Increase panel font size",
+	"zoom.out": "Decrease panel font size",
+	"palette.label": "Command palette",
+	"palette.placeholder": "Search lessons/courses or pick an action…",
+	"palette.lessons": "Lesson",
+	"palette.courses": "Course",
+	"palette.review": "Start review",
+	"palette.study": "Start studying",
+	"palette.empty": "No matches",
+	"threads.label": "Lesson threads",
+	"meter.label": "Context usage",
+	"meter.estimate": "~{n} tok (char-volume estimate)",
+	"model.unknown": "Current model",
+	"model.switched": "Switched to {model}",
+	"model.switchFailed": "Switch failed — check the host model settings",
+	"settings.budget": "History budget",
+	"settings.budget.hint": "When on, the tutor summarizes older turns in long threads (upstream v0.27 history-budget, tutor-layer execution)",
+	"settings.budget.on": "Enable history budget",
+	"settings.budget.off": "Disable history budget",
+	"attach.sent": "I attached a file: {name} (workspace path {path}) — read it before continuing.",
+	"attach.fail": "Attachment upload failed",
+	"attach.label": "Attach (≤20MiB, lands in the study workspace)",
+	"rail.mastered": "{mastered}/{total} lessons graduated",
+	"rail.avg": "avg mastery {pct}%",
+	"rail.avg.none": "no mastery data yet",
+	"rail.search": "Search lessons… (space-separated keywords)",
+	"rail.locate.title": "Locate the current focus lesson in the tree (auto-expands its section)",
+	"rail.locate": "Back to current lesson",
+	"rail.due": "{count} due",
+	"rail.due.over": "{days}d overdue",
+	"rail.due.start": "Start reviewing",
+	"rail.due.none": "Nothing due right now — keep the streak!",
+	"chat.reasoning": "Thinking ({n} chars)",
+	"msg.speak": "Speak",
+	"note.pin": "Pin note",
+	"note.unpin": "Unpin",
+	"note.locate": "Back to source",
+	"note.edit": "Edit note",
+	"note.save": "Save",
+	"confirm.cancel": "Cancel",
+	"rail.due.tag": "this lesson's review is due today (SM-2)",
+	"rail.delete": "Delete this course",
+	"rail.delete.confirm": "Delete?",
+	"rail.delete.title.confirm": "Click again to confirm (all progress and notes included). Back up via the state file in Settings first",
+	"note.delete": "Delete this note",
+	"note.delete.confirm": "Delete?",
+	"read.play": "Read aloud",
+	"read.stop": "Stop reading",
+	"read.pause": "Pause reading",
+	"read.resume": "Resume reading",
+	"read.engine.system": "Network synthesis unavailable — switched to the system voice",
+	"read.unavailable": "Read-aloud unavailable",
+	"rail.section.collapse": "Collapse this section",
+	"rail.section.expand": "Expand this section ({count} lessons)",
+	"rail.section.count": "{count} lessons",
+	"rail.lesson.opening": "Opening the lesson session…",
+	"rail.lesson.openHint": " (opens this lesson's own session)",
+	"rail.import.toggle": "Import a course",
+	"rail.import.close": "Collapse import",
+	"tag.weak": "{count} weak concepts — quizzes target them first",
+	"tag.friction": "{count} friction marks (logged when you said you were stuck)",
+	"tag.mastery": "lesson mastery {pct}% (the weakest concept)",
+	"tag.mastery.short": "lesson mastery = the weakest concept's mastery",
+	"status.exam": "Section exam: opens when every lesson in the section reaches ≥50% mastery",
+	"status.mastered": "Graduated: mastery ≥90% (or you accepted a mastery proposal)",
+	"status.in_progress": "Learning: opened, mastery starts at 50%",
+	"status.available": "Ready: unlocked, not started",
+	"status.locked": "Locked: finish the preceding lessons first",
+	"chip.unattributed": "unattributed",
+	"chip.correct": "✓ correct · {concept}",
+	"chip.wrong": "✗ wrong · {concept}",
+	"row.thinking": "tutor is thinking…",
+	"row.thinking.title": "The tutor is reasoning; the reply is coming",
+	"quiz.title": "Click an option to answer, or just type",
+	"quiz.answer": "Choose {letter}: {text}",
+	"tutor.dormant": "Study mode is off — click \"▶ Start learning\" above to wake the tutor and re-enable these controls.",
+	"tutor.empty": "The conversation will appear here",
+	"tutor.empty.hint": "Talk to the tutor in the input below",
+	"proposal.text": "The tutor proposes you have mastered \"{lesson}\": {rationale}",
+	"proposal.accept": "Accept",
+	"proposal.decline": "Keep practicing",
+	"bb.empty": "The blackboard is empty",
+	"bb.empty.hint": "Pick a lesson in the course tree on the left",
+	"bb.mastery": "mastery {pct}%",
+	"cmap.legend": "Amber = weak concept (mastery < 70%)",
+	"cmap.node.pct": "mastery {pct}%",
+	"bb.strategy": "Approach",
+	"bb.fallback.cmap.empty": "The concept map needs the tutor to define this lesson's concepts first",
+	"bb.fallback.cmap": "Concept map unavailable (layout engine failed to load) — fell back to the teach view",
+	"bb.notes": "Notes",
+	"bb.notes.empty": "No notes for this lesson yet",
+	"tv.exam.stars": "This attempt {n}★ (best {best}★)",
+	"tv.exam.fail": "No stars this round — the wrong answers are the map for the next one; start with their explanations.",
+	"active.off.title": "Register the study tools and load the tutor persona; plain chats stay as they are",
+	"active.on.title": "Retire the study tools and tutor persona; progress is kept and you can re-enable anytime",
+	"active.off": "▶ Start learning",
+	"active.on": "⏻ Exit study mode",
+	"prompt.kickoff": "Start learning: check my study state and open the current focus lesson. If I have no course yet, suggest importing the demo course (AI-For-Beginners) and explain how to begin. Remind me at the end to open the \"Study\" tab above to enter the study UI.",
+	"settings.nav": "Study",
+	"settings.mode": "Teaching style",
+	"settings.mode.hint": "The tutor's explanation style; switchable anytime in the study tab too",
+	"settings.studyMode": "Study mode",
+	"settings.voice": "Read-aloud voice",
+	"settings.voice.hint": "The neural voice used by 朗读本课 (a browser-local preference)",
+	"voice.xiaoxiao": "Xiaoxiao · Chinese female",
+	"voice.yunxi": "Yunxi · Chinese male",
+	"voice.yunyang": "Yunyang · Chinese male (news)",
+	"voice.xiaoyi": "Xiaoyi · Chinese female (lively)",
+	"voice.aria": "Aria · English female",
+	"voice.guy": "Guy · English male",
+	"settings.studyMode.hint": "On registers the study_* tools and the tutor persona; progress and notes are always kept",
+	"settings.on": "Status: on",
+	"settings.off": "Status: off",
+	"settings.turnOn": "Turn on",
+	"settings.turnOff": "Turn off",
+	"settings.stats": "Study stats",
+	"settings.stats.courses": "{count} courses",
+	"settings.stats.xp": "XP {xp} · Lv{level} ({pct}%)",
+	"settings.stats.today": "Today {xp}/{goal}",
+	"settings.stats.streak": "Streak {days}d (best {best}, {freeze} freeze left)",
+	"settings.about": "About",
+	"settings.about.hint": "The version of the running build — click to see its release notes.",
+	"settings.stateFile": "State file",
+	"settings.stateFile.hint": "Your progress lives in a local JSON file — copy it to migrate machines",
+	"dock.title": "Study status: {due} due · {streak}d streak · Lv{level} — open the Study tab above to continue",
+	"dock.due": "{count}",
+	"dock.streak": "{days}d",
+	"dock.lv": "Lv{level}",
+	"prompt.import": "Import a course: fetch {url} with study_import_github",
+	"prompt.import.url": "Import a course: import this link {url} with study_import_url (GitHub repos route to the repository import).",
+	"prompt.import.md": "Import the content below as a course with study_import_markdown{title}:\n\n{md}",
+	"prompt.import.folder": "Import a course: scan the local folder {path} with study_import_folder{title}, design the course from its brief, and apply it.",
+	"prompt.import.epub": "Import a course: scan the folder containing the eBook with study_import_folder ({path}, which contains {file} — chapters become lessons){title}, design and apply.",
+	"prompt.lesson": "Study \"{title}\": open this lesson with study_lesson and start teaching.",
+	"prompt.exam": "Start the section exam for \"{section}\": quiz me on this section's lessons and grade each answer",
+	"artifact.zoomOut": "Zoom out",
+	"artifact.zoomIn": "Zoom in",
+	"artifact.canvas.fit": "Fit to screen",
+	"viewtab.board": "Board",
+	"bb.board.empty": "Large tutor outputs (tables, diagrams, code walkthroughs) land on this board — zoom, pan, double-click to fit.",
+	"exam.generating.title": "Preparing your exam",
+	"exam.generating.stage": "Your tutor is writing questions by concept",
+	"exam.generating.kcProgress": "{done}/{total} concepts covered",
+	"exam.generating.preparing": "Planning the question set…",
+	"exam.generating.canLeave": "Generation runs in the background — you can leave and come back.",
+	"exam.errorTitle": "Exam generation failed",
+	"exam.errorEmpty": "No question bank arrived.",
+	"exam.failed.retry": "Regenerate",
+	"exam.ready.title": "Exam ready",
+	"exam.ready.meta": "{q} questions · {kc} concepts · ~{min} min",
+	"exam.start": "Start exam",
+	"exam.regenerate": "New questions",
+	"exam.regenerate.confirmMsg": "This replaces the whole bank (past results are kept).",
+	"exam.q.progress": "Question {i}/{n}",
+	"exam.q.next": "Next",
+	"exam.q.submit": "Submit",
+	"exam.submitting": "Grading…",
+	"exam.result.score": "{correct}/{total} correct",
+	"exam.result.accuracy": "{pct}% accuracy",
+	"exam.result.best": "Best {stars}★",
+	"exam.result.attempts": "{n} attempts",
+	"exam.terminated.banner": "You left mid-exam — unanswered questions counted wrong.",
+	"exam.result.kcBreakdown": "By concept",
+	"exam.result.weakKc": "weak",
+	"exam.result.review": "Review",
+	"exam.result.unanswered": "Unanswered",
+	"exam.result.correctLabel": "Correct",
+	"exam.result.yourAnswer": "Your answer",
+	"exam.result.correctAnswer": "Correct answer",
+	"exam.retryExam": "Retry exam",
+	"exam.leave.title": "Leave this exam?",
+	"exam.leave.message": "The exam is in progress — leaving now counts unanswered questions as wrong.",
+	"exam.leave.confirm": "Leave & settle",
+	"exam.leave.cancel": "Keep answering",
+	"prompt.exam.bank": "Author the section exam bank for \"{section}\": read this section's lessons with study_view, then submit the full multiple-choice set in one study_exam_bank_apply call (5-15 single-choice questions, kcTitle must be one of the section's concept titles, one-line explanation each). Tell me when the bank is ready.",
+	"prompt.review": "Start today's review, from the most overdue lesson first",
+	"prompt.proposal.accept": "Accept proposal {id} — confirm marking this lesson as mastered",
+	"prompt.proposal.decline": "Reject proposal {id} — I want to practice more"
+};
+/**
+* Pure translator with the service's semantics: own-locale dict → zh
+* fallback → the key itself, `{name}` interpolation left untouched when the
+* param is missing.
+* @param locale - active locale id ('zh'/'en'; unknown ids fall back to zh).
+* @returns a stable-shaped translate function.
+*/
+function makeT(locale) {
+	const dict = locale === "en" ? EN : ZH;
+	return (key, params) => {
+		const template = dict[key] ?? ZH[key] ?? key;
+		if (params === void 0) return template;
+		return template.replace(/\{(\w+)\}/g, (match, name) => name in params ? String(params[name]) : match);
+	};
+}
+/** The module's active translator — zh until the view factory installs the live bind. */
+let activeT = makeT("zh");
+/**
+* Translate through the active translator — the import every client module
+* uses for user-visible copy. Pure helpers take an optional explicit `t`
+* defaulting to the current active translator, evaluated per call.
+*/
+function tr(key, params) {
+	return activeT(key, params);
+}
+//#endregion
 //#region src/markdown.ts
 /**
 * Server-side markdown → HTML for the study workbench's 讲解 view. Escapes
 * every HTML character first, then renders a pragmatic GFM subset (headings,
 * fenced code, inline code, bold/italic, links, lists, blockquotes, tables,
 * hr, paragraphs). Lesson bodies are imported teaching material, so raw HTML
-* never passes through.
+* never passes through. Fenced code rides the shared CodeBlock card (D8:
+* language chip + copy header — the same structure in the chat stream, the
+* lesson prose, and notebook notes; the copy itself is the client's
+* delegated handler).
 * @module dsh-plugin-lookatstudy/markdown
 */
 /** Escape all HTML-significant characters. */
@@ -117,7 +825,7 @@ function renderMarkdown(md) {
 				i++;
 			}
 			i++;
-			out.push(`<pre><code${lang === "" ? "" : ` class="lang-${lang}"`}>${code.join("\n")}</code></pre>`);
+			out.push(`<div class="lks-codeblock" data-testid="md-codeblock"><div class="lks-codeblock-head"><span class="lks-codeblock-lang">${lang === "" ? "code" : lang}</span><button type="button" class="lks-codeblock-copy" data-testid="md-copy" aria-label="${tr("chat.copy")}">${tr("chat.copy")}</button></div><pre><code${lang === "" ? "" : ` class="lang-${lang}"`}>${code.join("\n")}</code></pre></div>`);
 			continue;
 		}
 		const heading = /^(#{1,6})\s+(.*)$/.exec(line);
@@ -1012,44 +1720,195 @@ function recordExamResult(state, lessonId, correct, total) {
 	};
 }
 /**
-* Record one graded answer against a lesson: attribute it to one knowledge
-* component when named, update BKT (per-KC, aggregated as the weakest),
-* nudge the SM-2 schedule when one exists, and apply mastery-driven
-* progression (early unlock at 0.5, graduation at 0.9). Locked lessons fail
-* loud — open the lesson first (study_lesson does).
-* @param state - state to mutate.
-* @param lessonId - lesson to update.
-* @param correct - whether the learner answered correctly.
-* @param concept - concept title the question tested, when attributable.
-* @param now - current time.
-* @returns mastery transition, KC attribution, and progression effects.
+* ── Exam v2 (P12): the bank + attempt lifecycle, upstream exam-service
+* semantics on state.json instead of SQLite. Generation rides the tutor
+* (the panel asks, study_exam_bank_apply lands the validated bank); grading
+* is pure (unanswered = wrong, terminated attempts keep partial credit).
 */
-function recordAnswer(state, lessonId, correct, concept, now) {
+/** The section's KC-title union (anti-hallucination anchor for bank applies). */
+function sectionKcTitles(ref) {
+	const titles = /* @__PURE__ */ new Set();
+	for (const lesson of ref.section.lessons) {
+		if (lesson.kind === "exam") continue;
+		for (const concept of lesson.concepts ?? []) titles.add(concept.title);
+	}
+	return titles;
+}
+/** Flip the bank to generating (a ready bank stays — regeneration resets it first). */
+function beginExamGeneration(state, lessonId) {
 	const ref = findLesson(state, lessonId);
-	if (ref.lesson.status === "locked") throw new Error(`lookatstudy-plugin: lesson ${JSON.stringify(lessonId)} is locked; open it with study_lesson first`);
-	if (ref.lesson.status === "available") ref.lesson.status = "in_progress";
-	const kcIndex = concept === void 0 ? void 0 : ref.lesson.concepts?.findIndex((c) => c.title === concept);
-	if (concept !== void 0 && (ref.lesson.concepts === null || kcIndex === void 0 || kcIndex < 0)) throw new Error(`lookatstudy-plugin: unknown concept ${JSON.stringify(concept)} on lesson ${JSON.stringify(lessonId)} — define concepts with study_define_concepts first`);
-	const prev = ref.lesson.mastery;
-	if (ref.lesson.concepts !== null && kcIndex !== void 0) {
-		const masteries = ref.lesson.conceptMastery ?? {};
-		masteries[kcIndex] = updateMastery(masteries[kcIndex], correct);
-		ref.lesson.conceptMastery = masteries;
-		aggregateMastery(ref.lesson);
-	} else if (ref.lesson.concepts !== null) {
-		const masteries = ref.lesson.conceptMastery ?? {};
-		ref.lesson.concepts.forEach((_, i) => {
-			masteries[i] = updateMastery(masteries[i], correct);
-		});
-		ref.lesson.conceptMastery = masteries;
-		aggregateMastery(ref.lesson);
-	} else ref.lesson.mastery = updateMastery(prev, correct);
-	ref.lesson.attempts += 1;
-	if (correct) ref.lesson.correctCount += 1;
-	ref.lesson.lastAnsweredAt = now.toISOString();
-	if (ref.lesson.sm2 !== null) {
-		const result = computeSm2(ref.lesson.sm2, correct ? 5 : 2, now);
-		ref.lesson.sm2 = {
+	if (ref.lesson.kind !== "exam") throw new Error(`lookatstudy-plugin: lesson ${JSON.stringify(lessonId)} is not an exam node`);
+	if (ref.lesson.examBank?.status === "ready") return;
+	ref.lesson.examBank = {
+		status: "generating",
+		questions: []
+	};
+}
+/** Validate and land the tutor's question bank (anti-hallucination: KC titles must exist). */
+function applyExamBank(state, lessonId, questions, now) {
+	const ref = findLesson(state, lessonId);
+	if (ref.lesson.kind !== "exam") throw new Error(`lookatstudy-plugin: lesson ${JSON.stringify(lessonId)} is not an exam node`);
+	if (!Array.isArray(questions) || questions.length < 5 || questions.length > 15) throw new Error(`lookatstudy-plugin: exam bank needs ${String(5)}-${String(15)} questions (planExamQuota on the section's KC union), got ${String(Array.isArray(questions) ? questions.length : "non-array")}`);
+	const kcUnion = sectionKcTitles(ref);
+	const bank = questions.map((q, i) => {
+		if (typeof q?.prompt !== "string" || q.prompt.trim() === "") throw new Error(`lookatstudy-plugin: question ${String(i)} has an empty prompt`);
+		if (!Array.isArray(q.options) || q.options.length < 2 || q.options.some((o) => typeof o !== "string" || o.trim() === "")) throw new Error(`lookatstudy-plugin: question ${String(i)} needs 2+ non-empty options`);
+		if (!Number.isInteger(q.answer) || q.answer < 0 || q.answer >= q.options.length) throw new Error(`lookatstudy-plugin: question ${String(i)} answer index ${String(q.answer)} is out of range`);
+		if (q.kcTitle !== void 0 && q.kcTitle !== null && q.kcTitle !== "" && !kcUnion.has(q.kcTitle)) throw new Error(`lookatstudy-plugin: question ${String(i)} kcTitle ${JSON.stringify(q.kcTitle)} is not in the section's concept union ${JSON.stringify([...kcUnion])} — read the section lessons with study_view before authoring`);
+		return {
+			id: `q${String(i)}`,
+			prompt: q.prompt,
+			options: q.options,
+			answer: q.answer,
+			kcTitle: q.kcTitle === void 0 || q.kcTitle === null || q.kcTitle === "" ? null : q.kcTitle,
+			explanation: q.explanation === void 0 || q.explanation === null || q.explanation === "" ? null : q.explanation
+		};
+	});
+	ref.lesson.examBank = {
+		status: "ready",
+		questions: bank,
+		generatedAt: now.toISOString()
+	};
+	return {
+		questionCount: bank.length,
+		kcCount: new Set(bank.map((q) => q.kcTitle).filter((k) => k !== null)).size
+	};
+}
+/** Drop the bank back to idle (regenerate; history snapshots stay self-contained). */
+function regenerateExamBank(state, lessonId) {
+	const ref = findLesson(state, lessonId);
+	if (ref.lesson.kind !== "exam") throw new Error(`lookatstudy-plugin: lesson ${JSON.stringify(lessonId)} is not an exam node`);
+	ref.lesson.examBank = {
+		status: "idle",
+		questions: []
+	};
+}
+/** Settle every dangling attempt of the lesson (grade dead — unanswered = wrong). */
+function settleDanglingAttempts(state, lessonId) {
+	const ref = findLesson(state, lessonId);
+	for (const attempt of ref.lesson.examAttemptLog ?? []) if (attempt.finishedAt === null) submitExamAttempt(state, lessonId, attempt.id, true, /* @__PURE__ */ new Date());
+}
+/** Open a new attempt against the ready bank (dangling ones are graded dead first). */
+function startExamAttempt(state, lessonId, now) {
+	const ref = findLesson(state, lessonId);
+	if (ref.lesson.kind !== "exam") throw new Error(`lookatstudy-plugin: lesson ${JSON.stringify(lessonId)} is not an exam node`);
+	if (ref.lesson.examBank?.status !== "ready") throw new Error(`lookatstudy-plugin: exam bank on ${JSON.stringify(lessonId)} is not ready (${String(ref.lesson.examBank?.status ?? "idle")})`);
+	settleDanglingAttempts(state, lessonId);
+	const log = ref.lesson.examAttemptLog ?? [];
+	let n = log.length;
+	while (log.some((a) => a.id === `${lessonId}:a${String(n)}`)) n++;
+	const attempt = {
+		id: `${lessonId}:a${String(n)}`,
+		startedAt: now.toISOString(),
+		finishedAt: null,
+		answers: {},
+		correctCount: null,
+		totalCount: null,
+		stars: null,
+		terminated: false,
+		perQuestion: null
+	};
+	ref.lesson.examAttemptLog = [...log, attempt];
+	return {
+		attemptId: attempt.id,
+		questions: ref.lesson.examBank.questions
+	};
+}
+/** Persist one answer incrementally (open attempts only; original option index as string). */
+function recordExamAnswer(state, lessonId, attemptId, questionId, answer) {
+	const ref = findLesson(state, lessonId);
+	const attempt = ref.lesson.examAttemptLog?.find((a) => a.id === attemptId);
+	if (attempt === void 0) throw new Error(`lookatstudy-plugin: exam attempt ${JSON.stringify(attemptId)} not found on ${JSON.stringify(lessonId)}`);
+	if (attempt.finishedAt !== null) throw new Error(`lookatstudy-plugin: exam attempt ${JSON.stringify(attemptId)} already finished`);
+	const question = ref.lesson.examBank?.questions.find((q) => q.id === questionId);
+	if (question === void 0) throw new Error(`lookatstudy-plugin: exam question ${JSON.stringify(questionId)} not in the bank`);
+	if (answer !== "" && (!/^\d+$/.test(answer) || Number(answer) >= question.options.length)) throw new Error(`lookatstudy-plugin: exam answer ${JSON.stringify(answer)} is not an option index of ${JSON.stringify(questionId)}`);
+	attempt.answers = {
+		...attempt.answers,
+		[questionId]: answer
+	};
+}
+/** Grade and close an attempt: unanswered = wrong, snapshots self-contained, best-of stars kept. */
+function submitExamAttempt(state, lessonId, attemptId, terminated, now) {
+	const ref = findLesson(state, lessonId);
+	const attempt = ref.lesson.examAttemptLog?.find((a) => a.id === attemptId);
+	if (attempt === void 0) throw new Error(`lookatstudy-plugin: exam attempt ${JSON.stringify(attemptId)} not found on ${JSON.stringify(lessonId)}`);
+	if (attempt.finishedAt !== null) throw new Error(`lookatstudy-plugin: exam attempt ${JSON.stringify(attemptId)} already finished`);
+	const bank = ref.lesson.examBank;
+	const perQuestion = (bank?.status === "ready" ? bank.questions : []).map((q) => {
+		const user = attempt.answers[q.id] ?? "";
+		return {
+			exerciseId: q.id,
+			kcTitle: q.kcTitle,
+			correct: user === String(q.answer),
+			answered: user !== "",
+			userAnswer: user,
+			correctAnswer: String(q.answer),
+			explanation: q.explanation,
+			prompt: q.prompt,
+			options: q.options
+		};
+	});
+	const correctCount = perQuestion.filter((p) => p.correct).length;
+	const totalCount = perQuestion.length;
+	attempt.finishedAt = now.toISOString();
+	attempt.correctCount = correctCount;
+	attempt.totalCount = totalCount;
+	attempt.stars = totalCount > 0 ? accuracyToStars(correctCount / totalCount) : 0;
+	attempt.terminated = terminated;
+	attempt.perQuestion = perQuestion;
+	const prevBest = ref.lesson.examStars ?? -1;
+	ref.lesson.examStars = Math.max(prevBest, attempt.stars);
+	ref.lesson.examAttempts = (ref.lesson.examAttempts ?? 0) + 1;
+	ref.lesson.lastAnsweredAt = now.toISOString();
+	return {
+		correctCount,
+		totalCount,
+		stars: attempt.stars,
+		bestStars: ref.lesson.examStars,
+		terminated,
+		perQuestion
+	};
+}
+/**
+* Record one graded answer against a lesson: attribute it to one knowledge
+* component when named, update BKT (per-KC, aggregated as the weakest),
+* nudge the SM-2 schedule when one exists, and apply mastery-driven
+* progression (early unlock at 0.5, graduation at 0.9). Locked lessons fail
+* loud — open the lesson first (study_lesson does).
+* @param state - state to mutate.
+* @param lessonId - lesson to update.
+* @param correct - whether the learner answered correctly.
+* @param concept - concept title the question tested, when attributable.
+* @param now - current time.
+* @returns mastery transition, KC attribution, and progression effects.
+*/
+function recordAnswer(state, lessonId, correct, concept, now) {
+	const ref = findLesson(state, lessonId);
+	if (ref.lesson.status === "locked") throw new Error(`lookatstudy-plugin: lesson ${JSON.stringify(lessonId)} is locked; open it with study_lesson first`);
+	if (ref.lesson.status === "available") ref.lesson.status = "in_progress";
+	const kcIndex = concept === void 0 ? void 0 : ref.lesson.concepts?.findIndex((c) => c.title === concept);
+	if (concept !== void 0 && (ref.lesson.concepts === null || kcIndex === void 0 || kcIndex < 0)) throw new Error(`lookatstudy-plugin: unknown concept ${JSON.stringify(concept)} on lesson ${JSON.stringify(lessonId)} — define concepts with study_define_concepts first`);
+	const prev = ref.lesson.mastery;
+	if (ref.lesson.concepts !== null && kcIndex !== void 0) {
+		const masteries = ref.lesson.conceptMastery ?? {};
+		masteries[kcIndex] = updateMastery(masteries[kcIndex], correct);
+		ref.lesson.conceptMastery = masteries;
+		aggregateMastery(ref.lesson);
+	} else if (ref.lesson.concepts !== null) {
+		const masteries = ref.lesson.conceptMastery ?? {};
+		ref.lesson.concepts.forEach((_, i) => {
+			masteries[i] = updateMastery(masteries[i], correct);
+		});
+		ref.lesson.conceptMastery = masteries;
+		aggregateMastery(ref.lesson);
+	} else ref.lesson.mastery = updateMastery(prev, correct);
+	ref.lesson.attempts += 1;
+	if (correct) ref.lesson.correctCount += 1;
+	ref.lesson.lastAnsweredAt = now.toISOString();
+	if (ref.lesson.sm2 !== null) {
+		const result = computeSm2(ref.lesson.sm2, correct ? 5 : 2, now);
+		ref.lesson.sm2 = {
 			easeFactor: result.easeFactor,
 			intervalDays: result.intervalDays,
 			repetitions: result.repetitions
@@ -1219,6 +2078,22 @@ function deleteNote(state, lessonId, noteId) {
 	if (index === -1) throw new Error(`lookatstudy-plugin: note ${JSON.stringify(noteId)} not found on lesson ${JSON.stringify(lessonId)}`);
 	ref.lesson.notes.splice(index, 1);
 }
+/** Edit a note's body text in place (C6 learner comment editing). */
+function editNote(state, lessonId, noteId, text) {
+	const note = findLesson(state, lessonId).lesson.notes.find((n) => n.id === noteId);
+	if (note === void 0) throw new Error(`lookatstudy-plugin: note ${JSON.stringify(noteId)} not found on lesson ${JSON.stringify(lessonId)}`);
+	const trimmed = text.trim();
+	if (trimmed === "") throw new Error("lookatstudy-plugin: note text cannot be empty");
+	note.text = trimmed;
+	return note;
+}
+/** Pin or unpin a note (pinned notes sort first within their zone). */
+function pinNote(state, lessonId, noteId, pinned) {
+	const note = findLesson(state, lessonId).lesson.notes.find((n) => n.id === noteId);
+	if (note === void 0) throw new Error(`lookatstudy-plugin: note ${JSON.stringify(noteId)} not found on lesson ${JSON.stringify(lessonId)}`);
+	note.pinned = pinned;
+	return note;
+}
 /**
 * Propose early mastery graduation for the learner to accept or reject in chat.
 * @param state - state to mutate.
@@ -1606,6 +2481,7 @@ function pluginVersion() {
 * @returns the page's data contract.
 */
 function workbenchState(state, now) {
+	const historyBudget = state.historyBudget === true;
 	const focusId = state.focus?.lessonId ?? null;
 	const dueIds = new Set(dueReviews(state, void 0, now).map((d) => d.lessonId));
 	const courses = state.courses.map((course) => {
@@ -1642,11 +2518,19 @@ function workbenchState(state, now) {
 			courseTitle: ref.course.title,
 			sectionTitle: ref.section.title,
 			title: ref.lesson.title,
+			kind: ref.lesson.kind,
 			status: ref.lesson.status,
 			masteryPct: ref.lesson.mastery === null ? null : Math.round(ref.lesson.mastery * 100),
 			strategy: strategyBand(ref.lesson.mastery),
 			concepts: conceptViews(ref.lesson) ?? [],
 			due: dueIds.has(ref.lesson.id),
+			exam: ref.lesson.kind === "exam" ? {
+				status: ref.lesson.examBank?.status ?? "idle",
+				questionCount: ref.lesson.examBank?.status === "ready" ? ref.lesson.examBank.questions.length : 0,
+				kcCount: ref.lesson.examBank?.status === "ready" ? new Set(ref.lesson.examBank.questions.map((q) => q.kcTitle).filter((k) => k !== null)).size : 0,
+				bestStars: ref.lesson.examStars ?? 0,
+				attemptCount: ref.lesson.examAttempts ?? 0
+			} : null,
 			artifacts: (state.artifacts[ref.lesson.id] ?? []).map((a) => ({
 				id: a.id,
 				artifactType: a.artifactType,
@@ -1663,7 +2547,8 @@ function workbenchState(state, now) {
 				title: n.title,
 				text: n.text,
 				source: n.source,
-				quote: n.quote
+				quote: n.quote,
+				pinned: n.pinned === true
 			})),
 			html: renderMarkdown(normalizeMathNotation(ref.lesson.translation === void 0 ? ref.lesson.body : renderBilingual(ref.lesson.body, ref.lesson.translation))),
 			markdown: ref.lesson.body,
@@ -1676,6 +2561,7 @@ function workbenchState(state, now) {
 	return {
 		active: state.active,
 		mode: state.mode,
+		historyBudget,
 		courses,
 		focusLessonId: focusId,
 		lesson,
@@ -1890,6 +2776,50 @@ function registerDashboard(webServer, deps) {
 				}
 				return;
 			}
+			if (req.method === "POST" && pathname === "/lookatstudy/api/note/edit") {
+				const body = await readJsonBodySafe(req, res);
+				if (body === void 0) return;
+				if (typeof body.lessonId !== "string" || typeof body.noteId !== "string" || typeof body.text !== "string") {
+					sendJson(res, 400, {
+						ok: false,
+						error: "lessonId, noteId (strings) and text (string) required"
+					});
+					return;
+				}
+				try {
+					editNote(deps.store.get(), body.lessonId, body.noteId, body.text);
+					deps.store.save();
+					sendJson(res, 200, { ok: true });
+				} catch (error) {
+					sendJson(res, 404, {
+						ok: false,
+						error: error instanceof Error ? error.message : String(error)
+					});
+				}
+				return;
+			}
+			if (req.method === "POST" && pathname === "/lookatstudy/api/note/pin") {
+				const body = await readJsonBodySafe(req, res);
+				if (body === void 0) return;
+				if (typeof body.lessonId !== "string" || typeof body.noteId !== "string" || typeof body.pinned !== "boolean") {
+					sendJson(res, 400, {
+						ok: false,
+						error: "lessonId, noteId (strings) and pinned (boolean) required"
+					});
+					return;
+				}
+				try {
+					pinNote(deps.store.get(), body.lessonId, body.noteId, body.pinned);
+					deps.store.save();
+					sendJson(res, 200, { ok: true });
+				} catch (error) {
+					sendJson(res, 404, {
+						ok: false,
+						error: error instanceof Error ? error.message : String(error)
+					});
+				}
+				return;
+			}
 			if (req.method === "POST" && pathname === "/lookatstudy/api/note/user") {
 				const body = await readJsonBodySafe(req, res);
 				if (body === void 0) return;
@@ -1944,288 +2874,300 @@ function registerDashboard(webServer, deps) {
 				}
 				return;
 			}
-			if (req.method === "POST" && pathname === "/lookatstudy/api/lesson-session") {
-				const body = await readJsonBodySafe(req, res);
-				if (body === void 0) return;
-				if (typeof body.lessonId !== "string" || typeof body.sessionId !== "string") {
+			if (req.method === "GET" && pathname === "/lookatstudy/api/exam") {
+				const lessonId = new URL(req.url ?? "/", "http://x").searchParams.get("lessonId") ?? "";
+				if (lessonId === "") {
 					sendJson(res, 400, {
 						ok: false,
-						error: "lessonId and sessionId (strings) required"
+						error: "lessonId required"
 					});
 					return;
 				}
-				deps.store.get().lessonSessions[body.lessonId] = body.sessionId;
-				deps.store.save();
-				sendJson(res, 200, { ok: true });
+				try {
+					settleDanglingAttempts(deps.store.get(), lessonId);
+					deps.store.save();
+					const ref = findLesson(deps.store.get(), lessonId);
+					if (ref.lesson.kind !== "exam") throw new Error("not an exam node");
+					const bank = ref.lesson.examBank;
+					const ready = bank?.status === "ready";
+					const log = ref.lesson.examAttemptLog ?? [];
+					const latest = log.length > 0 ? log[log.length - 1] : null;
+					sendJson(res, 200, {
+						ok: true,
+						status: bank?.status ?? "idle",
+						error: bank?.error ?? null,
+						questionCount: ready ? bank.questions.length : 0,
+						kcCount: ready ? new Set(bank.questions.map((q) => q.kcTitle).filter((k) => k !== null)).size : 0,
+						questions: ready ? bank.questions : [],
+						bestStars: ref.lesson.examStars ?? 0,
+						attemptCount: ref.lesson.examAttempts ?? 0,
+						latestAttempt: latest === null ? null : {
+							id: latest.id,
+							finishedAt: latest.finishedAt,
+							correctCount: latest.correctCount,
+							totalCount: latest.totalCount,
+							stars: latest.stars,
+							terminated: latest.terminated,
+							perQuestion: latest.perQuestion ?? []
+						}
+					});
+				} catch (error) {
+					sendJson(res, 404, {
+						ok: false,
+						error: error instanceof Error ? error.message : String(error)
+					});
+				}
 				return;
 			}
-			if (req.method === "POST" && pathname === "/lookatstudy/api/tts") {
+			if (req.method === "POST" && pathname === "/lookatstudy/api/exam/prepare") {
 				const body = await readJsonBodySafe(req, res);
 				if (body === void 0) return;
-				const text = typeof body.text === "string" ? body.text.trim() : "";
-				if (text === "") {
-					sendJson(res, 400, {
-						ok: false,
-						error: "text (non-empty string) required"
-					});
-					return;
-				}
-				if (text.length > 4e3) {
+				if (typeof body.lessonId !== "string") {
 					sendJson(res, 400, {
 						ok: false,
-						error: "text exceeds 4000 chars (speak sentence groups, not whole lessons)"
+						error: "lessonId (string) required"
 					});
 					return;
 				}
-				const voice = normalizeVoice(typeof body.voice === "string" ? body.voice : void 0);
-				const cacheDir = join(deps.studyAreaPath, "tts-cache");
 				try {
+					beginExamGeneration(deps.store.get(), body.lessonId);
+					deps.store.save();
 					sendJson(res, 200, {
 						ok: true,
-						mime: "audio/mpeg",
-						dataBase64: (await cachedTtsMp3(cacheDir, text, voice, deps.tts?.synthesize)).toString("base64")
+						status: "generating"
 					});
 				} catch (error) {
-					sendJson(res, 502, {
+					sendJson(res, 404, {
 						ok: false,
 						error: error instanceof Error ? error.message : String(error)
 					});
 				}
 				return;
 			}
-			if (req.method === "POST" && pathname === "/lookatstudy/api/mode") {
+			if (req.method === "POST" && pathname === "/lookatstudy/api/exam/start") {
 				const body = await readJsonBodySafe(req, res);
 				if (body === void 0) return;
-				if (body.mode !== "direct" && body.mode !== "guide" && body.mode !== "practice") {
+				if (typeof body.lessonId !== "string") {
 					sendJson(res, 400, {
 						ok: false,
-						error: "mode must be direct | guide | practice"
+						error: "lessonId (string) required"
 					});
-					return;
-				}
-				deps.store.get().mode = body.mode;
-				deps.store.save();
-				sendJson(res, 200, {
-					ok: true,
-					mode: body.mode
-				});
-				return;
-			}
-			sendJson(res, 404, {
-				ok: false,
-				error: "not found"
-			});
-		}
-	});
-	return () => {
-		disposeRoutes();
-	};
-}
-//#endregion
-//#region src/client/locale.ts
-/** Simplified Chinese dictionary (also the fallback locale). */
-const ZH = {
-	"tab.label": "学习",
-	"col.rail": "课程",
-	"col.tutor": "导师",
-	"col.bb": "黑板",
-	"pane.rail": "课程",
-	"pane.chat": "对话",
-	"pane.note": "黑板",
-	"viewtab.teach": "讲解",
-	"viewtab.cmap": "概念图",
-	"viewtab.cmap.title": "本课概念之间的关系图",
-	"loading": "加载中…",
-	"start.title": "一键准备学习:建立学习工作区、开启会话并让导师就位",
-	"start.go": "开始学习",
-	"start.enter": "进入学习",
-	"start.busy": "正在准备学习区…",
-	"soul.direct": "直讲",
-	"soul.direct.hint": "精讲:先讲清楚,再确认懂没懂",
-	"soul.guide": "引导",
-	"soul.guide.hint": "引导:让你自己往前推一步,导师递台阶",
-	"soul.practice": "实战",
-	"soul.practice.hint": "实战:在真实世界的乱问题里学",
-	"zone.understand": "🧠 理解区 — 知识结构",
-	"zone.record": "📝 记录区 — 我的话",
-	"zone.practice": "✍️ 练习区 — 答题日志",
-	"rail.empty.title": "暂无课程",
-	"rail.empty.hint": "粘贴 markdown → 说「导入为课程」",
-	"rail.empty.hint2": "本地文件夹 → 说「导入 D:/path/to/folder」",
-	"rail.empty.placeholder": "GitHub 仓库链接,如 microsoft/AI-For-Beginners",
-	"rail.empty.button": "导入",
-	"composer.send": "发送",
-	"quiz.card.title": "练习",
-	"quiz.progress": "{cur}/{total}",
-	"quiz.next": "下一题",
-	"quiz.finish": "看成绩单",
-	"quiz.score": "成绩：{correct}/{total}",
-	"quiz.right": "答对了",
-	"quiz.wrong": "答错了",
-	"quiz.youChose": "你选了",
-	"quiz.answer": "正确答案",
-	"quiz.hook": "练习卡完成：{correct}/{total} 正确。请简短点评，针对错题讲讲思路。",
-	"quiz.action.explain-wrong": "讲讲错题",
-	"quiz.action.retry": "再来一组",
-	"quiz.action.go-deeper": "深入原理",
-	"quiz.action.mark-mastered": "标记我掌握了",
-	"quiz.action.markMastered.hint": "会让导师出综合题检验，通过即标记掌握",
-	"quiz.action.next-topic": "下一个知识点",
-	"artifact.lines": "第 {from}-{to} 行：",
-	"artifact.expand": "放大查看",
-	"artifact.guess.title": "猜一猜",
-	"artifact.guess.pick": "我选「{label}」",
-	"artifact.guess.wait": "已记下你的直觉——导师下回合揭晓，看看你想得对不对",
-	"artifact.sedimented": "有新的学习产物沉淀进笔记",
-	"zone.artifacts": "AI 产物",
-	"note.quote.ask": "提问这段",
-	"note.quote.save": "加到笔记",
-	"note.quote.template": "请讲解这段：「{text}」",
-	"note.saved": "已存入记录区笔记",
-	"review.rate.title": "复习自评——这课现在记得多牢？",
-	"review.again": "再来一次",
-	"review.remembered": "记住了",
-	"review.mastered": "完全掌握",
-	"review.done.good": "已安排下次复习",
-	"review.done.again": "明天再来一遍",
-	"review.jump": "点开这一课去复习",
-	"review.nudge": "有 {n} 课到了复习时间，先回来练一遍？",
-	"review.nudge.go": "去复习",
-	"rail.search.jump": "打开这一课",
-	"proposal.banner": "《{lesson}》可以提前毕业了",
-	"proposal.accept": "接受",
-	"proposal.decline": "再练练",
-	"proposal.accept.msg": "我接受《{lesson}》的掌握度提议，帮我标记为掌握。",
-	"proposal.decline.msg": "《{lesson}》我先再练练，暂不接受提前毕业。",
-	"tutor.thinking": "导师思考中…",
-	"header.xp": "经验值 {xp}",
-	"header.streak": "连续学习天数",
-	"header.level": "等级",
-	"map.node.locked": "锁定 — 先完成前面的课时",
-	"map.node.due": "到了复习时间",
-	"map.exam.locked": "考试未解锁 — 本章节全部课时掌握度 ≥50% 后开放",
-	"companion.poke": "戳一戳伴学伙伴",
-	"companion.poked": "伴学伙伴向你眨了眨眼",
-	"companion.form.ember": "小焰",
-	"companion.form.frost": "霜绒",
-	"companion.form.moss": "苔芽",
-	"companion.form.star": "星尘",
-	"companion.form.ink": "墨墨",
-	"settings.companion": "伴学伙伴",
-	"settings.companion.hint": "选择学习面板右下角的伴学生物形态。",
-	"quiz.msg.explain-wrong": "我刚才有题答错了，帮我讲讲为什么错、正确的思路是什么。",
-	"quiz.msg.retry": "再来一组类似的题巩固一下。",
-	"quiz.msg.go-deeper": "这组我答得不错，帮我深入讲讲背后的原理和容易混淆的地方。",
-	"quiz.msg.mark-mastered": "这课我觉得掌握了，帮我确认一下——出个综合题检验，通过了就标记为掌握。",
-	"quiz.msg.next-topic": "进入下一个知识点。",
-	"toast.region": "通知",
-	"toast.close": "关闭",
-	"composer.busy": "导师正在回复…",
-	"rail.empty.demo": "导入示例课程",
-	"rail.mastered": "毕业 {mastered}/{total} 课",
-	"rail.avg": "平均掌握度 {pct}%",
-	"rail.avg.none": "尚无掌握度数据",
-	"rail.search": "搜索课时…(多关键词空格分隔)",
-	"rail.locate.title": "在课程树中定位当前焦点课时(自动展开所在章节)",
-	"rail.locate": "回到当前课时",
-	"rail.due": "待复习 {count}",
-	"rail.due.over": "超{days}天",
-	"rail.due.start": "开始复习",
-	"rail.due.tag": "这课时的复习今天到期(SM-2)",
-	"rail.delete": "删除本课程",
-	"rail.delete.confirm": "确认删除?",
-	"rail.delete.title.confirm": "再点一次确认删除(含全部进度与笔记)。反悔前可先在设置页备份状态文件",
-	"note.delete": "删除本条笔记",
-	"note.delete.confirm": "确认删除?",
-	"read.play": "朗读本课",
-	"read.stop": "停止朗读",
-	"read.pause": "暂停朗读",
-	"read.resume": "继续朗读",
-	"read.engine.system": "网络合成不可用，已切换为系统语音",
-	"read.unavailable": "朗读不可用",
-	"rail.section.collapse": "折叠本章节",
-	"rail.section.expand": "展开本章节({count} 课时)",
-	"rail.section.count": "{count} 课",
-	"rail.lesson.opening": "正在打开课时会话…",
-	"rail.lesson.openHint": "（点击将打开本课专属会话）",
-	"rail.import.toggle": "导入课程",
-	"rail.import.close": "收起导入",
-	"tag.weak": "{count} 个薄弱知识点,测验会优先考察",
-	"tag.friction": "{count} 次卡点记录(你说\"不懂\"时导师记下的)",
-	"tag.mastery": "课时掌握度 {pct}%(取最薄弱知识点)",
-	"tag.mastery.short": "课时掌握度 = 最薄弱知识点的掌握度",
-	"status.exam": "章节测验:本节全部课时掌握度 ≥50% 后开放",
-	"status.mastered": "已毕业:掌握度 ≥90%(或你接受了掌握提案)",
-	"status.in_progress": "学习中:已开课,掌握度从 50% 起步",
-	"status.available": "可开始:已解锁,尚未学习",
-	"status.locked": "未解锁:先完成前面的课时",
-	"chip.unattributed": "未归因",
-	"chip.correct": "✓ 答对 · {concept}",
-	"chip.wrong": "✗ 答错 · {concept}",
-	"row.thinking": "导师思考中…",
-	"row.thinking.title": "导师正在推理,回复马上就来",
-	"quiz.title": "点击选项作答,也可以直接打字回答",
-	"quiz.answer": "选 {letter}:{text}",
-	"tutor.dormant": "学习模式已关闭 — 点右上「▶ 开始学习」开启导师,按钮恢复可用。",
-	"tutor.empty": "对话会出现在这里",
-	"tutor.empty.hint": "在下方输入框和导师说话",
-	"proposal.text": "导师提议你已掌握「{lesson}」:{rationale}",
-	"proposal.accept": "接受",
-	"proposal.decline": "再练练",
-	"bb.empty": "黑板还空着",
-	"bb.empty.hint": "在左侧课程树选择一课",
-	"bb.mastery": "掌握度 {pct}%",
-	"cmap.legend": "琥珀色 = 薄弱知识点(掌握度 <70%)",
-	"cmap.node.pct": "掌握度 {pct}%",
-	"bb.strategy": "本课学法",
-	"bb.fallback.cmap.empty": "概念图需要先由导师定义本课概念",
-	"bb.fallback.cmap": "概念图渲染不可用(布局引擎加载失败) — 已回退讲解视图",
-	"bb.notes": "笔记",
-	"bb.notes.empty": "这一课还没有笔记",
-	"tv.exam.stars": "本次 {n}★(历史最佳 {best}★)",
-	"tv.exam.fail": "这轮没拿到星——错题就是下一课的地图,从每题的解析看起。",
-	"active.off.title": "注册 study 工具并载入导师人格,之后普通对话和现在一样",
-	"active.on.title": "注销 study 工具与导师人格;学习进度保留,可随时重新开启",
-	"active.off": "▶ 开始学习",
-	"active.on": "⏻ 退出学习模式",
-	"prompt.kickoff": "开始学习:查看我的学习状态并打开当前焦点课时。如果我还没有课程,推荐我导入示例课程(AI-For-Beginners)并说明怎么开始。回复最后请提醒我点上方「学习」页签进入学习界面。",
-	"settings.nav": "学习",
-	"settings.mode": "教学风格",
-	"settings.mode.hint": "导师的讲解风格;也可在学习页随时切换",
-	"settings.studyMode": "学习模式",
-	"settings.voice": "朗读语音",
-	"settings.voice.hint": "「朗读本课」使用的神经网络声音（浏览器本地偏好）",
-	"voice.xiaoxiao": "晓晓 · 中文女声",
-	"voice.yunxi": "云希 · 中文男声",
-	"voice.yunyang": "云扬 · 中文男声（新闻）",
-	"voice.xiaoyi": "晓伊 · 中文女声（轻快）",
-	"voice.aria": "Aria · English female",
-	"voice.guy": "Guy · English male",
-	"settings.studyMode.hint": "开启后注册 study_* 工具并载入导师人格;进度与笔记始终保留",
-	"settings.on": "状态：已开启",
-	"settings.off": "状态：已关闭",
-	"settings.turnOn": "开启",
-	"settings.turnOff": "关闭",
-	"settings.stats": "学习统计",
-	"settings.stats.courses": "课程 {count} 个",
-	"settings.stats.xp": "XP {xp} · Lv{level}({pct}%)",
-	"settings.stats.today": "今日 {xp}/{goal}",
-	"settings.stats.streak": "连续 {days} 天(最长 {best},剩冻结 {freeze})",
-	"settings.about": "关于",
-	"settings.about.hint": "当前运行的构建版本,点击查看该版更新内容。",
-	"settings.stateFile": "状态文件",
-	"settings.stateFile.hint": "学习进度存放于本机 JSON,换机可迁移",
-	"dock.title": "学习状态:待复习 {due} · 连续 {streak} 天 · Lv{level} — 点上方「学习」页签进入",
-	"dock.due": "{count}",
-	"dock.streak": "{days}天",
-	"dock.lv": "Lv{level}",
-	"prompt.import": "导入课程:用 study_import_github 抓取 {url}",
-	"prompt.lesson": "学习「{title}」:用 study_lesson 打开这一课开始学习。",
-	"prompt.exam": "开始「{section}」的章节测验:按本节课时出题,答完逐题判分",
-	"prompt.review": "开始今天的复习,从最到期的课时开始",
-	"prompt.proposal.accept": "接受提案 {id} —— 确认标记这课为已掌握",
-	"prompt.proposal.decline": "拒绝提案 {id} —— 我想再练练"
-};
+					return;
+				}
+				try {
+					const r = startExamAttempt(deps.store.get(), body.lessonId, /* @__PURE__ */ new Date());
+					deps.store.save();
+					sendJson(res, 200, {
+						ok: true,
+						attemptId: r.attemptId,
+						questions: r.questions
+					});
+				} catch (error) {
+					sendJson(res, 404, {
+						ok: false,
+						error: error instanceof Error ? error.message : String(error)
+					});
+				}
+				return;
+			}
+			if (req.method === "POST" && pathname === "/lookatstudy/api/exam/record") {
+				const body = await readJsonBodySafe(req, res);
+				if (body === void 0) return;
+				if (typeof body.lessonId !== "string" || typeof body.attemptId !== "string" || typeof body.questionId !== "string" || typeof body.answer !== "string") {
+					sendJson(res, 400, {
+						ok: false,
+						error: "lessonId, attemptId, questionId, answer (strings) required"
+					});
+					return;
+				}
+				try {
+					recordExamAnswer(deps.store.get(), body.lessonId, body.attemptId, body.questionId, body.answer);
+					deps.store.save();
+					sendJson(res, 200, { ok: true });
+				} catch (error) {
+					sendJson(res, 404, {
+						ok: false,
+						error: error instanceof Error ? error.message : String(error)
+					});
+				}
+				return;
+			}
+			if (req.method === "POST" && pathname === "/lookatstudy/api/exam/submit") {
+				const body = await readJsonBodySafe(req, res);
+				if (body === void 0) return;
+				if (typeof body.lessonId !== "string" || typeof body.attemptId !== "string") {
+					sendJson(res, 400, {
+						ok: false,
+						error: "lessonId and attemptId (strings) required"
+					});
+					return;
+				}
+				try {
+					const r = submitExamAttempt(deps.store.get(), body.lessonId, body.attemptId, body.terminated === true, /* @__PURE__ */ new Date());
+					deps.store.save();
+					sendJson(res, 200, {
+						ok: true,
+						...r
+					});
+				} catch (error) {
+					sendJson(res, 404, {
+						ok: false,
+						error: error instanceof Error ? error.message : String(error)
+					});
+				}
+				return;
+			}
+			if (req.method === "POST" && pathname === "/lookatstudy/api/exam/regenerate") {
+				const body = await readJsonBodySafe(req, res);
+				if (body === void 0) return;
+				if (typeof body.lessonId !== "string") {
+					sendJson(res, 400, {
+						ok: false,
+						error: "lessonId (string) required"
+					});
+					return;
+				}
+				try {
+					regenerateExamBank(deps.store.get(), body.lessonId);
+					deps.store.save();
+					sendJson(res, 200, {
+						ok: true,
+						status: "idle"
+					});
+				} catch (error) {
+					sendJson(res, 404, {
+						ok: false,
+						error: error instanceof Error ? error.message : String(error)
+					});
+				}
+				return;
+			}
+			if (req.method === "POST" && pathname === "/lookatstudy/api/lesson-session") {
+				const body = await readJsonBodySafe(req, res);
+				if (body === void 0) return;
+				if (typeof body.lessonId !== "string" || typeof body.sessionId !== "string") {
+					sendJson(res, 400, {
+						ok: false,
+						error: "lessonId and sessionId (strings) required"
+					});
+					return;
+				}
+				deps.store.get().lessonSessions[body.lessonId] = body.sessionId;
+				deps.store.save();
+				sendJson(res, 200, { ok: true });
+				return;
+			}
+			if (req.method === "POST" && pathname === "/lookatstudy/api/tts") {
+				const body = await readJsonBodySafe(req, res);
+				if (body === void 0) return;
+				const text = typeof body.text === "string" ? body.text.trim() : "";
+				if (text === "") {
+					sendJson(res, 400, {
+						ok: false,
+						error: "text (non-empty string) required"
+					});
+					return;
+				}
+				if (text.length > 4e3) {
+					sendJson(res, 400, {
+						ok: false,
+						error: "text exceeds 4000 chars (speak sentence groups, not whole lessons)"
+					});
+					return;
+				}
+				const voice = normalizeVoice(typeof body.voice === "string" ? body.voice : void 0);
+				const cacheDir = join(deps.studyAreaPath, "tts-cache");
+				try {
+					sendJson(res, 200, {
+						ok: true,
+						mime: "audio/mpeg",
+						dataBase64: (await cachedTtsMp3(cacheDir, text, voice, deps.tts?.synthesize)).toString("base64")
+					});
+				} catch (error) {
+					sendJson(res, 502, {
+						ok: false,
+						error: error instanceof Error ? error.message : String(error)
+					});
+				}
+				return;
+			}
+			if (req.method === "POST" && pathname === "/lookatstudy/api/mode") {
+				const body = await readJsonBodySafe(req, res);
+				if (body === void 0) return;
+				if (body.mode !== "direct" && body.mode !== "guide" && body.mode !== "practice") {
+					sendJson(res, 400, {
+						ok: false,
+						error: "mode must be direct | guide | practice"
+					});
+					return;
+				}
+				deps.store.get().mode = body.mode;
+				deps.store.save();
+				sendJson(res, 200, {
+					ok: true,
+					mode: body.mode
+				});
+				return;
+			}
+			if (req.method === "POST" && pathname === "/lookatstudy/api/budget") {
+				const body = await readJsonBodySafe(req, res);
+				if (body === void 0) return;
+				deps.store.get().historyBudget = body.on === true;
+				deps.store.save();
+				sendJson(res, 200, {
+					ok: true,
+					on: body.on === true
+				});
+				return;
+			}
+			if (req.method === "POST" && pathname === "/lookatstudy/api/attachment") {
+				const body = await readJsonBodySafe(req, res);
+				if (body === void 0) return;
+				const name = typeof body.name === "string" ? body.name.trim() : "";
+				const data = typeof body.dataBase64 === "string" ? body.dataBase64 : "";
+				if (name === "" || data === "" || name.length > 200 || /[\/:*?"<>|]/.test(name)) {
+					sendJson(res, 400, {
+						ok: false,
+						error: "name and dataBase64 required (fs-safe name, max 200 chars)"
+					});
+					return;
+				}
+				const buf = Buffer.from(data, "base64");
+				if (buf.length === 0 || buf.length > 20971520) {
+					sendJson(res, 400, {
+						ok: false,
+						error: "attachment must be 1B..20MiB"
+					});
+					return;
+				}
+				try {
+					const dir = join(deps.studyAreaPath, "attachments");
+					mkdirSync(dir, { recursive: true });
+					const safe = `${Date.now().toString(36)}-${name.replaceAll(/[\/:*?"<>|]/g, "_")}`;
+					writeFileSync(join(dir, safe), buf);
+					sendJson(res, 200, {
+						ok: true,
+						path: `attachments/${safe}`,
+						bytes: buf.length
+					});
+				} catch (error) {
+					sendJson(res, 500, {
+						ok: false,
+						error: error instanceof Error ? error.message : String(error)
+					});
+				}
+				return;
+			}
+			sendJson(res, 404, {
+				ok: false,
+				error: "not found"
+			});
+		}
+	});
+	return () => {
+		disposeRoutes();
+	};
+}
 //#endregion
 //#region src/commands.ts
 /**
@@ -6091,6 +7033,100 @@ function studyTools(store, deps = {}) {
 			content: textBlocks(result.meta)
 		})
 	});
+	const examBankApplyTool = defineTool({
+		name: "study_exam_bank_apply",
+		description: "Author the question bank for a section exam node (exam-v2). The exam page asks for a bank when the learner opens it; call this once with the full multiple-choice set. Question count follows planExamQuota on the section's KC union (clamp 5-15); each kcTitle MUST be one of the section lessons' concept titles (anti-hallucination — unknown KC titles are rejected; read the section with study_view first). On a validation error the tutor fixes the bank and simply calls again. The learner answers in the exam page; grading is automatic (unanswered = wrong, best-of stars kept).",
+		parameters: {
+			lessonId: {
+				type: "string",
+				required: true,
+				description: "The exam lesson node id."
+			},
+			questions: {
+				type: "array",
+				required: true,
+				description: "The full question set (5-15; planExamQuota on the KC union).",
+				items: {
+					type: "object",
+					additionalProperties: false,
+					properties: {
+						prompt: {
+							type: "string",
+							required: true,
+							description: "Question text (self-contained)."
+						},
+						options: {
+							type: "array",
+							required: true,
+							items: { type: "string" },
+							description: "Answer options (2+)."
+						},
+						answer: {
+							type: "integer",
+							required: true,
+							description: "Index of the correct option (0-based, original order — the exam page reshuffles)."
+						},
+						kcTitle: {
+							type: "string",
+							description: "Concept title this question tests; must exist in the section's KC union."
+						},
+						explanation: {
+							type: "string",
+							description: "One-line why (shown in the per-question review)."
+						}
+					}
+				}
+			}
+		},
+		output: {
+			schema: {
+				type: "object",
+				additionalProperties: false,
+				properties: {
+					lessonId: {
+						type: "string",
+						required: true
+					},
+					questionCount: {
+						type: "integer",
+						required: true
+					},
+					kcCount: {
+						type: "integer",
+						required: true
+					},
+					status: {
+						type: "string",
+						required: true
+					}
+				}
+			},
+			render: (_args, value) => [{
+				type: "text",
+				text: `Exam bank ready: ${value.questionCount} questions across ${value.kcCount} knowledge components. The exam page settles into its ready state — tell the learner to hit 开始考试.`
+			}]
+		},
+		execute(args) {
+			return mutate((state) => {
+				const r = applyExamBank(state, args.lessonId, args.questions, /* @__PURE__ */ new Date());
+				return {
+					lessonId: args.lessonId,
+					questionCount: r.questionCount,
+					kcCount: r.kcCount,
+					status: "ready"
+				};
+			});
+		},
+		presentCall: (args) => ({
+			card: "generic",
+			title: `Exam bank: ${Array.isArray(args.questions) ? String(args.questions.length) : "?"} questions`
+		}),
+		presentationMeta: (_args, value) => [`${value.questionCount}Q`],
+		presentResult: (_args, result) => ({
+			card: "generic",
+			content: textBlocks(result.meta)
+		})
+	});
 	const completeLessonTool = defineTool({
 		name: "study_complete_lesson",
 		description: "Mark a lesson mastered manually (graduation at 90% mastery is the automatic path — this is the override). Unlocks the next lesson and schedules the first spaced review for tomorrow. Call only when the learner has genuinely worked through the lesson.",
@@ -7250,6 +8286,7 @@ function studyTools(store, deps = {}) {
 		lessonContent,
 		recordAnswerTool,
 		examResultTool,
+		examBankApplyTool,
 		completeLessonTool,
 		dueReviewsTool,
 		recordReviewTool,
@@ -7742,6 +8779,7 @@ function snapshotSectionText(state) {
 	if (memory.length > 0) lines.push(`记忆: ${memory.join(" | ")}`);
 	if (snap.dueCount > 0) lines.push(`今日待复习: ${snap.dueCount} 项`);
 	if (snap.pendingProposal !== null) lines.push(`待决提案 ${snap.pendingProposal.id}: ${snap.pendingProposal.rationale}(等学习者表态)`);
+	if (state.historyBudget === true) lines.push("历史预算已开启:当会话变长时,主动概括旧轮次的要点并基于概要继续,避免逐字复读历史。");
 	return lines.join("\n");
 }
 /**