lookatstudy-mobile 0.22.1 → 0.23.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lookatstudy-mobile",
-  "version": "0.22.1",
+  "version": "0.23.1",
   "description": "LookatStudy Termux portable bundle (server.cjs + web frontend)",
   "repository": {
     "type": "git",

package/seed-course.json

@@ -29,7 +29,7 @@
       "title": "欢迎使用 LookatStudy",
       "sourcePath": "ch1/lesson-1.md",
       "orderIdx": 0,
-      "content": "# 欢迎使用 LookatStudy\n\n**LookatStudy** 是一个本地优先、AI 驱动的桌面学习平台。它能把任意 GitHub 学习仓库或本地文件夹变成一个多邻国式的互动课程——带有技能地图、AI 导师、间隔重复和游戏化激励。\n\n## 它能帮你做什么\n\n- 📚 **把任何仓库变课程**：粘贴 GitHub URL 或选择本地文件夹，10 种文档格式（Markdown / Jupyter / RST / PDF / PPTX / HTML 等）+ 30 多种代码语言自动解析成结构化课程，图片也能带进来\n- 🗺️ **技能地图导航**：多邻国风格的气球节点地图，随滚动从清晨飘到夜晚，逐课解锁，视觉化你的学习进度\n- 🤖 **AI 个人导师**：每个知识点独立追踪掌握度（BKT），AI 根据你的理解程度动态调整教学策略，还能看见你最近的卡点\n- 📝 **康奈尔笔记本**：三区设计（理解 / 笔记 / 练习），AI 生成概念图、对比表、流程图，你画线加笔记\n- 🔁 **间隔重复**：SM-2 算法安排复习，连续打卡 + XP + 皇冠激励持续学习\n\n## 设计理念\n\n- **本地优先**：所有数据存在本地 SQLite，你的学习记录永远在你手里\n- **BYO Key**：自带 LLM API Key，你的对话不经过任何中间服务器\n- **AI 起草、人确认**：AI 永远不直接修改你的学习记录——每次状态变更都通过 Propose → Apply 协议，你审批后才生效\n\n## 从哪里开始\n\n每次启动 LookatStudy 都从「未选课程」状态开始：在左侧「导入课程」面板里选择一门已导入的课程开始学习，或者导入新课程。点开下一课「导入你的第一个课程」了解全部导入方式！",
+      "content": "# 欢迎使用 LookatStudy\n\n**LookatStudy** 是一个本地优先、AI 驱动的桌面学习平台。它能把学习仓库、本地文件夹、网页链接、论文、视频或电子书变成一个多邻国式的互动课程——带有技能地图、AI 导师、间隔重复和游戏化激励。\n\n## 它能帮你做什么\n\n- 📚 **把几乎任何东西变课程**：GitHub 仓库、本地文件夹、网页文章、arXiv 论文、B站/YouTube 视频、EPUB 电子书、粘贴的文本、本地录音录像——12 种文档格式（Markdown / Jupyter / RST / PDF / PPTX / Word / EPUB 等）+ 30 多种代码语言自动解析成结构化课程，图片也能带进来\n- 🗺️ **技能地图导航**：多邻国风格的气球节点地图，随滚动从清晨飘到夜晚，逐课解锁，视觉化你的学习进度\n- 🤖 **AI 个人导师**：每个知识点独立追踪掌握度（BKT），AI 根据你的理解程度动态调整教学策略，还能看见你最近的卡点\n- 📝 **康奈尔笔记本**：三区设计（理解 / 笔记 / 练习），AI 生成概念图、对比表、流程图，你画线加笔记\n- 🔁 **间隔重复**：SM-2 算法安排复习，连续打卡 + XP + 皇冠激励持续学习\n\n## 设计理念\n\n- **本地优先**：所有数据存在本地 SQLite，你的学习记录永远在你手里\n- **BYO Key**：自带 LLM API Key，你的对话不经过任何中间服务器\n- **AI 起草、人确认**：AI 永远不直接修改你的学习记录——每次状态变更都通过 Propose → Apply 协议，你审批后才生效\n\n## 从哪里开始\n\n每次启动 LookatStudy 都从「未选课程」状态开始：在左侧「导入课程」面板里选择一门已导入的课程开始学习，或者导入新课程。点开下一课「导入你的第一个课程」了解全部导入方式！",
       "summary": "了解 LookatStudy 是什么、它能帮你做什么",
       "summaryEn": "What LookatStudy is and what it can do for you"
     },
@@ -40,9 +40,9 @@
       "title": "导入你的第一个课程",
       "sourcePath": "ch1/lesson-2.md",
       "orderIdx": 1,
-      "content": "# 导入你的第一个课程\n\nLookatStudy 支持三种导入方式，覆盖几乎所有学习材料来源。\n\n## 方式一：GitHub URL\n\n在左侧「导入课程」面板粘贴 GitHub 仓库地址。智能导入管线会自动：拉取 README 识别课程大纲、扫描完整文件树（文档 + 代码 + 翻译）、AI 判断每个文件的角色、AI 设计章节结构、图片自动内联。\n\n## 方式二：本地文件夹\n\n点击本地文件夹按钮，选择一个包含学习材料的文件夹。支持递归扫描子目录，自动识别文档、代码、图片、翻译。\n\n适用场景：下载的课程包、本地 clone 的仓库、自己整理的学习笔记文件夹。\n\n## 方式三：粘贴 Markdown\n\n直接粘贴 Markdown 文本。适用场景：私有仓库、网络受限环境、快速把一段笔记变成课程。\n\n## 导入是后台任务\n\n点击导入后任务立即进入后台：进度窗口实时显示每一步和耗时，期间你可以切走继续浏览其他课程，导入完成后会弹通知提醒，不会强制跳转。中途可以随时取消。\n\n## 课程管理\n\n课程列表里悬浮课程行可以删除（就地弹确认卡片，不会跳界面）；正在学习的课程也可以直接删——地图头课程名旁有删除按钮，删除后回到「未选课程」初始状态。删除会清掉该课程的全部学习记录，不可撤销。",
-      "summary": "三种导入方式、后台导入任务、课程删除",
-      "summaryEn": "Three import routes, background import jobs, and course removal"
+      "content": "# 导入你的第一个课程\n\nLookatStudy 支持五种导入方式，覆盖几乎所有学习材料来源。\n\n## 方式一：GitHub URL\n\n在左侧「导入课程」面板粘贴 GitHub 仓库地址。智能导入管线会自动：拉取 README 识别课程大纲、扫描完整文件树（文档 + 代码 + 翻译）、AI 判断每个文件的角色、AI 设计章节结构、图片自动内联。\n\n## 方式二：本地文件夹\n\n点击本地文件夹按钮，选择一个包含学习材料的文件夹。支持递归扫描子目录，自动识别文档、代码、图片、翻译。文件夹里的音频（.mp3/.m4a 等）和视频（.mp4 等）文件会在本地 Whisper 转写成课文，一节录音变成一节课。\n\n适用场景：下载的课程包、本地 clone 的仓库、自己整理的学习笔记文件夹。\n\n## 方式三：智能链接\n\n直接粘贴一个网页地址。文章页抽取正文成课；arXiv 论文下载 PDF 解析；视频链接（B站/YouTube/抖音）拉取音频转写，有字幕的视频优先用字幕、零转写——B站多分P整季导入，一集一课。\n\n## 方式四：粘贴 Markdown\n\n直接粘贴 Markdown 文本。适用场景：私有仓库、网络受限环境、快速把一段笔记变成课程。\n\n## 方式五：EPUB 电子书\n\n选择一个 .epub 文件，每章自动变成一节课，章节结构完整保留。\n\n## 导入是后台任务\n\n点击导入后任务立即进入后台：进度窗口实时显示每一步和耗时，期间你可以切走继续浏览其他课程，导入完成后会弹通知提醒，不会强制跳转。中途可以随时取消。\n\n## 课程管理\n\n课程列表里悬浮课程行可以删除（就地弹确认卡片，不会跳界面）；正在学习的课程也可以直接删——地图头课程名旁有删除按钮，删除后回到「未选课程」初始状态。删除会清掉该课程的全部学习记录，不可撤销。",
+      "summary": "五种导入方式、后台导入任务、课程删除",
+      "summaryEn": "Five import routes, background import jobs, and course removal"
     },
     {
       "id": "guide-les-1-3",
@@ -51,7 +51,7 @@
       "title": "三栏布局导览",
       "sourcePath": "ch1/lesson-3.md",
       "orderIdx": 2,
-      "content": "# 三栏布局导览\n\nLookatStudy 采用三栏布局，每一栏对应学习的不同环节。支持浅色 / 深色 / 跟随系统三种主题。\n\n## 左栏：课程地图与导入\n\n左栏顶部有两个标签：「导入课程」和「课程地图」。地图是多邻国风格的气球节点地图——每个气球代表一个课时，随着你向下学习，背景天空从清晨渐变到夜晚。\n\n地图标题卡显示课程名、整体掌握度百分比、待复习徽章、🌐 语言切换（多语言课程可在此切换原文/翻译）和删除当前课程按钮。\n\n## 中栏：AI 对话\n\n与 AI 导师的交互区域：顶部会话标签页（每个课时可以有多个对话线程）、对话流（AI 回复流式输出，提议卡、概念图等会持久保存）、底部输入区（含教学人设药丸、字号 A-/A+、四个巩固选择按钮）。\n\n按 Ctrl+K 打开命令面板，Ctrl+Tab 循环切换会话，Ctrl+B 折叠/展开左栏。\n\n## 右栏：康奈尔笔记本\n\n三区设计的笔记本：讲解 Tab 显示课时正文（Markdown 渲染），可以选中文字画线加笔记。笔记 Tab 包含三个区域——理解区（AI 产物）、笔记区（你的画线笔记）、练习区（测验 + 答题记录）。\n\n## 焦点锁定\n\n当 AI 正在回复时，切换课时和会话会被临时锁定——确保你不会在 AI 输出到一半时丢失上下文。",
+      "content": "# 三栏布局导览\n\nLookatStudy 采用三栏布局，每一栏对应学习的不同环节。支持浅色 / 深色 / 跟随系统三种主题。\n\n## 左栏：课程地图与导入\n\n左栏顶部有两个标签：「导入课程」和「课程地图」。地图是多邻国风格的气球节点地图——每个气球代表一个课时，随着你向下学习，背景天空从清晨渐变到夜晚。\n\n地图标题卡显示课程名、整体掌握度百分比、待复习徽章、🌐 语言切换（多语言课程可在此切换原文/翻译）和删除当前课程按钮。\n\n## 中栏：AI 对话\n\n与 AI 导师的交互区域：顶部会话标签页（每个课时可以有多个对话线程）、对话流（AI 回复流式输出，提议卡、概念图等会持久保存）、底部输入区（含教学人设药丸、字号 A-/A+、四个巩固选择按钮）。\n\n按 Ctrl+K 打开命令面板，Ctrl+Tab 循环切换会话，Ctrl+B 折叠/展开左栏。\n\n## 右栏：康奈尔笔记本\n\n三区设计的笔记本：讲解 Tab 显示课时正文（Markdown 渲染），可以选中文字画线加笔记。笔记 Tab 包含三个区域——理解区（AI 产物）、笔记区（你的画线笔记）、练习区（测验 + 答题记录）。\n\n## 异步会话\n\nAI 正在回复时也可以随意切换课时和会话。原对话在后台继续输出，会话标签和地图球上会转圈提示；切回来时，回答原样显示。同一段会话在一个回答结束前只接受一条提问，跨会话可以并行提问。",
       "summary": "技能地图 · AI 对话 · 康奈尔笔记本",
       "summaryEn": "Skill map, AI chat, and the Cornell notebook"
     },
@@ -106,7 +106,7 @@
       "title": "章节考试：生成、限时与结算",
       "sourcePath": "ch2/lesson-3.md",
       "orderIdx": 2,
-      "content": "# 章节考试\n\n章节考试是每章的关底 boss：🎯 节点，考过显示 1-3 星。整章所有课时掌握度达标后解锁。\n\n## 后台生成题库\n\n点开考试节点后，AI 按本章知识点分批出题，进度显示「已覆盖 X / Y 个知识点」。生成期间你可以切去看别的课时——任务在后台继续，完成后弹通知提醒。回来后看到就绪页：N 道题、覆盖 M 个知识点、预计时长，点「开始考试」才真正开始。\n\n## 每题限时\n\n每道题独立倒计时：普通题 60 秒，长题干或含代码的题 90 秒。到时自动记录当前选择并进入下一题。\n\n## 离开即终止\n\n考试进行中切换课时或课程会弹出警告：确认离开则本次考试终止，未答的题按答错计分。\n\n## 结算页\n\n提交后看到结算：星数、正确率、**按知识点分组的成绩分解**（薄弱知识点会标注建议复习）、逐题回顾（你的答案 vs 正确答案 + 解析）。切回考试节点默认显示上次成绩，也可以看到历史最好星数和考试次数。\n\n## 重新考试\n\n可以无限次重考。重考使用同一题库，但题目顺序和选项顺序都会重新打乱——考的是理解不是记忆。\n\n## 考试不影响学习模型\n\n考试是独立检验：结果只更新星数和 XP，**不回写**知识点掌握度。你的 BKT 学习记录只由日常答题和自评驱动，不会被一次考试搅动。",
+      "content": "# 章节考试\n\n章节考试是每章的关底 boss：🎯 节点，考过显示 1-3 星。整章所有课时掌握度达标后解锁。\n\n## 后台生成题库\n\n点开考试节点后，AI 按本章知识点分批出题，进度显示「已覆盖 X / Y 个知识点」。生成期间你可以切去看别的课时——任务在后台继续，完成后弹通知提醒。回来后看到就绪页：N 道题、覆盖 M 个知识点、预计时长，点「开始考试」才真正开始。\n\n## 每题限时\n\n每道题独立倒计时，时长按题目本身估算——题干越长、选项越多、含代码或公式，时间越多，下限 60 秒、上限 5 分钟。到时自动记录当前选择并进入下一题。\n\n## 离开即终止\n\n考试进行中切换课时或课程会弹出警告：确认离开则本次考试终止，未答的题按答错计分。\n\n## 结算页\n\n提交后看到结算：星数、正确率、**按知识点分组的成绩分解**（薄弱知识点会标注建议复习）、逐题回顾（你的答案 vs 正确答案 + 解析）。切回考试节点默认显示上次成绩，也可以看到历史最好星数和考试次数。\n\n## 重新考试\n\n可以无限次重考。重考使用同一题库，但题目顺序和选项顺序都会重新打乱——考的是理解不是记忆。\n\n## 考试不影响学习模型\n\n考试是独立检验：结果只更新星数和 XP，**不回写**知识点掌握度。你的 BKT 学习记录只由日常答题和自评驱动，不会被一次考试搅动。",
       "summary": "后台按知识点出题、每题限时、星级结算与重考",
       "summaryEn": "Questions generated per knowledge point in the background, a timer per question, star scoring and retakes"
     },
@@ -194,7 +194,7 @@
       "title": "三区设计：理解 / 笔记 / 练习",
       "sourcePath": "ch4/lesson-1.md",
       "orderIdx": 0,
-      "content": "# 三区设计：理解 / 笔记 / 练习\n\nLookatStudy 的右栏笔记本基于康奈尔笔记法（Cornell Notes），分为三个区域。\n\n## 🗺️ 理解区（AI 产物）\n\nAI 生成的可视化学习辅助：概念图（知识点关系网络）、对比表（相似概念异同对比）、流程图（步骤可视化）、代码讲解（逐行注释）。这些是 AI 在你学习时自动生成的。\n\n## ✏️ 笔记区（你的画线笔记）\n\n你在讲解页面上选中文字画线加笔记的所有标记：每条画线保留原始文字，可以添加批注，点击画线可以溯源跳转回原文对应位置。\n\n## 📝 练习区（测验 + 答题记录）\n\n该课时的练习题和你的答题历史：AI 生成的测验题，每次答题结果都保留，答错的题目会在间隔重复系统中安排复习。\n\n## 两个 Tab\n\n右栏顶部有两个 Tab：讲解 Tab 显示课时正文（Markdown 渲染），笔记 Tab 展示上述三区。讲解和笔记分开，让你在阅读正文时不被笔记干扰。",
+      "content": "# 三区设计：理解 / 笔记 / 练习\n\nLookatStudy 的右栏笔记本基于康奈尔笔记法（Cornell Notes），分为三个区域。\n\n## 🗺️ 理解区（AI 产物）\n\nAI 生成的可视化学习辅助：概念图（知识点关系网络）、对比表（相似概念异同对比）、流程图（步骤可视化）、代码讲解（逐行注释）。这些是 AI 在你学习时自动生成的。\n\n## ✏️ 笔记区（你的画线笔记）\n\n你在讲解页面上选中文字画线加笔记的所有标记：每条画线保留原始文字，可以添加批注，点击画线可以溯源跳转回原文对应位置。\n\n## 📝 练习区（测验 + 答题记录）\n\n该课时的练习题和你的答题历史：AI 生成的测验题，每次答题结果都保留，答错的题目会在间隔重复系统中安排复习。\n\n## 三个 Tab\n\n右栏顶部有三个 Tab：讲解 Tab 显示课时正文（Markdown 渲染，可切脑图总览），笔记 Tab 展示上述三区，黑板 Tab 是对话中最新重产物（概念图/流程图/对比表/代码讲解）的大画布，可缩放平移，AI 生成新图时自动翻过去。讲解和笔记分开，让你在阅读正文时不被笔记干扰。",
       "summary": "康奈尔笔记法在 LookatStudy 的实现",
       "summaryEn": "How the Cornell note-taking method is realized in LookatStudy"
     },
@@ -216,7 +216,7 @@
       "title": "生成式 UI：概念图 / 对比表 / 流程图",
       "sourcePath": "ch4/lesson-3.md",
       "orderIdx": 2,
-      "content": "# 生成式 UI\n\nLookatStudy 的 AI 导师不只会输出文字——它会生成交互式可视化组件。\n\n## 六种生成式组件\n\n| 组件 | 用途 |\n|------|------|\n| 🗺️ 概念图 | 展示知识点之间的关系 |\n| 📊 对比表 | 并列对比多个概念 |\n| 📐 流程图 | 可视化步骤或流程 |\n| 💻 代码讲解 | 逐行解释代码 |\n| 📝 测验 | 即时生成练习题 |\n| 🤔 二选一猜测 | 学习开场的无风险小猜测（不计分）|\n\n## 怎么触发\n\nAI 自动生成（判断知识点适合可视化时调用），你主动请求（在对话中说画个概念图），或点巩固选择按钮（考考我 / 举个例子）。\n\n## 生成式 UI 存在哪\n\n所有 AI 生成的组件出现在中栏对话流和右栏笔记 Tab 的理解区（持久保存）。AI 生成的概念图不是聊完就消失——它们留在你的笔记本里随时回顾。",
+      "content": "# 生成式 UI\n\nLookatStudy 的 AI 导师不只会输出文字——它会生成交互式可视化组件。\n\n## 六种生成式组件\n\n| 组件 | 用途 |\n|------|------|\n| 🗺️ 概念图 | 展示知识点之间的关系 |\n| 📊 对比表 | 并列对比多个概念 |\n| 📐 流程图 | 可视化步骤或流程 |\n| 💻 代码讲解 | 逐行解释代码 |\n| 📝 测验 | 即时生成练习题 |\n| 🤔 二选一猜测 | 学习开场的无风险小猜测（不计分）|\n\n## 怎么触发\n\nAI 自动生成（判断知识点适合可视化时调用），你主动请求（在对话中说画个概念图），或点巩固选择按钮（考考我 / 举个例子）。\n\n## 生成式 UI 存在哪\n\n所有 AI 生成的组件出现在中栏对话流和右栏笔记 Tab 的理解区（持久保存），四类重产物还会登上黑板 Tab 的大画布。AI 生成的概念图不是聊完就消失——它们留在你的笔记本里随时回顾。",
       "summary": "AI 动态生成的可视化学习工具",
       "summaryEn": "Visual learning tools the AI generates on the fly"
     },
@@ -315,7 +315,7 @@
       "title": "多语言翻译支持",
       "sourcePath": "ch6/lesson-2.md",
       "orderIdx": 1,
-      "content": "# 多语言翻译支持\n\nLookatStudy 能自动识别仓库的翻译结构，让你用偏好的语言学习。\n\n## 语言偏好设置\n\n在 Settings 里设置你的偏好语言。首次启动时按系统语言自动检测默认值。\n\n## 自动翻译决策\n\n导入课程时系统自动判断仓库原文语言，检测仓库有哪些翻译版本，按偏好语言 + 原文语言决定导入哪个翻译。严格 fallback：仓库没有你偏好的翻译就用原文。\n\n## 课内语言切换\n\n多语言课程在地图标题卡上有 🌐 切换器，随时在原文和已导入翻译之间切换——讲解正文、标题全部跟随。\n\n## 支持的翻译布局\n\n系统自动检测三种翻译目录约定：translations/语言代码/（微软风格）、语言代码/平行目录（Vue/Docusaurus 风格）、文件名.语言代码.md 后缀风格（博客风格）。\n\n## 翻译图片处理\n\n翻译版正文里的图片不另外下载（机翻图片质量差），而是按出现位置替换成原文对应位置的图片。结果：翻译正文 = 翻译文字 + 原文图片。",
+      "content": "# 多语言翻译支持\n\nLookatStudy 能自动识别仓库的翻译结构，让你用偏好的语言学习。\n\n## 语言偏好设置\n\n在 Settings 里设置你的偏好语言。首次启动时按系统语言自动检测默认值。\n\n## 自动翻译决策\n\n导入课程时系统自动判断仓库原文语言，检测仓库有哪些翻译版本，按偏好语言 + 原文语言决定导入哪个翻译。严格 fallback：仓库没有你偏好的翻译就用原文。\n\n## 课内语言切换\n\n多语言课程在地图标题卡上有 🌐 切换器，随时在原文和已导入翻译之间切换——讲解正文、标题全部跟随。\n\n## 支持的翻译布局\n\n系统自动检测三种翻译目录约定：translations/语言代码/（微软风格）、语言代码/平行目录（Vue/Docusaurus 风格）、文件名.语言代码.md 后缀风格（博客风格）。\n\n## 翻译图片处理\n\n翻译版正文里的图片不另外下载（机翻图片质量差），而是按出现位置替换成原文对应位置的图片。结果：翻译正文 = 翻译文字 + 原文图片。\n顺便一提：你正在读的这篇使用指南本身就是双语的——上文说的 🌐 切换器就在它的地图标题卡上，可以直接试。",
       "summary": "自动检测翻译约定，按偏好语言导入与切换",
       "summaryEn": "Translation conventions auto-detected; import and switch by preferred language"
     },
@@ -505,19 +505,19 @@
       "nodeId": "guide-les-1-1",
       "locale": "en",
       "title": "Welcome to LookatStudy",
-      "content": "# Welcome to LookatStudy\n\n**LookatStudy** is a local-first, AI-driven desktop learning platform. It turns any GitHub learning repo or local folder into a Duolingo-style interactive course — complete with a skill map, an AI tutor, spaced repetition, and playful incentives.\n\n## What it can do for you\n\n- 📚 **Turn any repo into a course**: paste a GitHub URL or pick a local folder; 10 document formats (Markdown / Jupyter / RST / PDF / PPTX / HTML and more) plus 30+ code languages are parsed into a structured course, images included\n- 🗺️ **Skill map navigation**: a Duolingo-style balloon map whose sky drifts from morning to night as you scroll; lessons unlock one by one and visualize your progress\n- 🤖 **A personal AI tutor**: every knowledge point carries its own mastery estimate (BKT); the AI adapts its teaching to your understanding and can see where you recently struggled\n- 📝 **A Cornell notebook**: three zones (understand / notes / practice); the AI generates concept maps, compare tables and flow diagrams while you highlight and annotate\n- 🔁 **Spaced repetition**: SM-2 schedules your reviews; streaks + XP + crowns keep you coming back\n\n## Design philosophy\n\n- **Local first**: all data lives in a local SQLite file — your learning record stays in your hands\n- **BYO Key**: bring your own LLM API key; your conversations never pass through a middleman server\n- **AI drafts, you decide**: the AI never edits your learning record directly — every state change goes through the Propose → Apply protocol and takes effect only after you approve\n\n## Where to start\n\nLookatStudy always opens in the “no course selected” state: pick an imported course in the “Import courses” panel on the left, or import something new. Open the next lesson, “Import Your First Course”, for all the ways in!"
+      "content": "# Welcome to LookatStudy\n\n**LookatStudy** is a local-first, AI-driven desktop learning platform. It turns a repo, a local folder, a web article, a paper, a video, or an e-book into a Duolingo-style interactive course — complete with a skill map, an AI tutor, spaced repetition, and playful incentives.\n\n## What it can do for you\n\n- 📚 **Turn almost anything into a course**: a GitHub repo, a local folder, a web article, an arXiv paper, a Bilibili/YouTube video, an EPUB book, pasted text, or local recordings — 12 document formats (Markdown / Jupyter / RST / PDF / PPTX / Word / EPUB and more) plus 30+ code languages are parsed into a structured course, images included\n- 🗺️ **Skill map navigation**: a Duolingo-style balloon map whose sky drifts from morning to night as you scroll; lessons unlock one by one and visualize your progress\n- 🤖 **A personal AI tutor**: every knowledge point carries its own mastery estimate (BKT); the AI adapts its teaching to your understanding and can see where you recently struggled\n- 📝 **A Cornell notebook**: three zones (understand / notes / practice); the AI generates concept maps, compare tables and flow diagrams while you highlight and annotate\n- 🔁 **Spaced repetition**: SM-2 schedules your reviews; streaks + XP + crowns keep you coming back\n\n## Design philosophy\n\n- **Local first**: all data lives in a local SQLite file — your learning record stays in your hands\n- **BYO Key**: bring your own LLM API key; your conversations never pass through a middleman server\n- **AI drafts, you decide**: the AI never edits your learning record directly — every state change goes through the Propose → Apply protocol and takes effect only after you approve\n\n## Where to start\n\nLookatStudy always opens in the “no course selected” state: pick an imported course in the “Import courses” panel on the left, or import something new. Open the next lesson, “Import Your First Course”, for all the ways in!"
     },
     {
       "nodeId": "guide-les-1-2",
       "locale": "en",
       "title": "Import Your First Course",
-      "content": "# Import Your First Course\n\nLookatStudy supports three import paths that cover nearly every source of learning material.\n\n## Path 1: GitHub URL\n\nPaste a GitHub repo address into the “Import courses” panel on the left. The smart pipeline automatically fetches the README to find the course outline, scans the full file tree (documents + code + translations), has AI classify each file's role, has AI design the chapter structure, and inlines images.\n\n## Path 2: Local folder\n\nClick the local-folder button and pick a folder of learning material. Subdirectories are scanned recursively; documents, code, images and translations are recognized automatically.\n\nGood for: downloaded course bundles, locally cloned repos, or a folder of notes you curated yourself.\n\n## Path 3: Pasted Markdown\n\nPaste Markdown text directly. Good for: private repos, network-restricted environments, or quickly turning a block of notes into a course.\n\n## Imports run in the background\n\nClick import and the job goes to the background immediately: a progress window shows each step and how long it took, you can switch away and keep browsing other courses, and a notification pops when the import finishes — no forced jump. You can cancel at any point.\n\n## Managing courses\n\nHovering a course row in the course list shows a delete button (inline confirm card, no screen change); the course you are studying can be deleted too — the button sits next to the course name on the map title card, and deleting returns you to the “no course selected” state. Deleting wipes every learning record of that course and cannot be undone."
+      "content": "# Import Your First Course\n\nLookatStudy supports five import paths that cover nearly every source of learning material.\n\n## Path 1: GitHub URL\n\nPaste a GitHub repo address into the “Import courses” panel on the left. The smart pipeline automatically fetches the README to find the course outline, scans the full file tree (documents + code + translations), has AI classify each file's role, has AI design the chapter structure, and inlines images.\n\n## Path 2: Local folder\n\nClick the local-folder button and pick a folder of learning material. Subdirectories are scanned recursively; documents, code, images and translations are recognized automatically. Audio files (.mp3, .m4a, and friends) and videos (.mp4, ...) inside the folder are transcribed into lessons by local Whisper — one recording becomes one lesson.\n\nGood for: downloaded course bundles, locally cloned repos, or a folder of notes you curated yourself.\n\n## Path 3: Smart links\n\nPaste any web address. Articles are extracted into lessons, arXiv papers download and parse their PDFs, and video links (Bilibili / YouTube / Douyin) pull the audio for transcription — subtitled videos prefer subtitles, zero transcription. A multi-part Bilibili series imports as a whole season, one part per lesson.\n\n## Path 4: Pasted Markdown\n\nPaste Markdown text directly. Good for: private repos, network-restricted environments, or quickly turning a block of notes into a course.\n\n## Path 5: EPUB books\n\nPick an .epub file; each chapter becomes a lesson, with the book structure preserved.\n\n## Imports run in the background\n\nClick import and the job goes to the background immediately: a progress window shows each step and how long it took, you can switch away and keep browsing other courses, and a notification pops when the import finishes — no forced jump. You can cancel at any point.\n\n## Managing courses\n\nHovering a course row in the course list shows a delete button (inline confirm card, no screen change); the course you are studying can be deleted too — the button sits next to the course name on the map title card, and deleting returns you to the “no course selected” state. Deleting wipes every learning record of that course and cannot be undone."
     },
     {
       "nodeId": "guide-les-1-3",
       "locale": "en",
       "title": "Tour of the Three-Pane Layout",
-      "content": "# Tour of the Three-Pane Layout\n\nLookatStudy uses a three-pane layout; each pane covers a different part of studying. Light / dark / follow-system themes are all supported.\n\n## Left pane: course map and import\n\nThe top of the left pane has two tabs: “Import courses” and “Course map”. The map is a Duolingo-style balloon map — each balloon is a lesson, and as you work your way down, the sky in the background shifts from morning to night.\n\nThe map title card shows the course name, overall mastery percentage, a due-for-review badge, the 🌐 language switch (multilingual courses toggle between original and translated text here), and the delete-course button.\n\n## Middle pane: AI chat\n\nWhere you talk to the AI tutor: thread tabs on top (each lesson can hold several conversation threads), the chat stream in the middle (AI replies stream in; proposal cards and concept maps persist), and the input area at the bottom (with the teaching-persona pill, the A-/A+ font size controls, and four consolidation buttons).\n\nCtrl+K opens the command palette, Ctrl+Tab cycles threads, Ctrl+B collapses the left pane.\n\n## Right pane: the Cornell notebook\n\nA notebook in three zones: the Lesson tab renders the lesson body (Markdown), and you can select text to highlight and annotate. The Notes tab holds the three zones — Understand (AI artifacts), Notes (your highlights), Practice (quizzes + answer history).\n\n## Focus lock\n\nWhile the AI is replying, switching lessons or threads is temporarily locked — so you never lose context mid-answer."
+      "content": "# Tour of the Three-Pane Layout\n\nLookatStudy uses a three-pane layout; each pane covers a different part of studying. Light / dark / follow-system themes are all supported.\n\n## Left pane: course map and import\n\nThe top of the left pane has two tabs: “Import courses” and “Course map”. The map is a Duolingo-style balloon map — each balloon is a lesson, and as you work your way down, the sky in the background shifts from morning to night.\n\nThe map title card shows the course name, overall mastery percentage, a due-for-review badge, the 🌐 language switch (multilingual courses toggle between original and translated text here), and the delete-course button.\n\n## Middle pane: AI chat\n\nWhere you talk to the AI tutor: thread tabs on top (each lesson can hold several conversation threads), the chat stream in the middle (AI replies stream in; proposal cards and concept maps persist), and the input area at the bottom (with the teaching-persona pill, the A-/A+ font size controls, and four consolidation buttons).\n\nCtrl+K opens the command palette, Ctrl+Tab cycles threads, Ctrl+B collapses the left pane.\n\n## Right pane: the Cornell notebook\n\nA notebook in three zones: the Lesson tab renders the lesson body (Markdown), and you can select text to highlight and annotate. The Notes tab holds the three zones — Understand (AI artifacts), Notes (your highlights), Practice (quizzes + answer history).\n\n## Async sessions\n\nWhile the AI is replying you are free to switch lessons or threads. The conversation keeps streaming in the background, with a spinner on its tab and on its map node, and the answer is right there when you come back. Within one thread only one send runs at a time; across threads you can ask in parallel."
     },
     {
       "nodeId": "guide-exam-1",
@@ -547,7 +547,7 @@
       "nodeId": "guide-les-2-3",
       "locale": "en",
       "title": "Chapter Exams: Generation, Timers, and Results",
-      "content": "# Chapter Exams\n\nThe chapter exam is the boss at the end of each chapter: a 🎯 node that shows 1-3 stars once passed. It unlocks when every lesson in the chapter clears the mastery bar.\n\n## The question bank generates in the background\n\nOpen the exam node and the AI writes questions in batches by knowledge point, with progress shown as “X / Y knowledge points covered”. While it generates you can go study something else — the job keeps running in the background and notifies you when it is done. Coming back, you see the ready page: N questions, M knowledge points covered, estimated duration; the exam itself only starts when you click “Start exam”.\n\n## A timer on every question\n\nEach question runs its own countdown: 60 seconds for normal questions, 90 for long stems or questions with code. When time runs out, the current choice is recorded and the exam moves on.\n\n## Leaving terminates the attempt\n\nSwitching lessons or courses mid-exam pops a warning: confirm leaving and the attempt terminates, with unanswered questions scored as wrong.\n\n## The results page\n\nAfter submitting you see: stars, accuracy, **a per-knowledge-point breakdown** (weak points are flagged for review), and a question-by-question review (your answer vs the correct one, plus explanations). Returning to the exam node later shows your latest result by default, along with your best star count and total attempts.\n\n## Retakes\n\nRetake as many times as you like. Retakes reuse the same bank, but question order and option order are reshuffled each time — it tests understanding, not memory.\n\n## Exams never touch the learning model\n\nExams are an independent check: results only update stars and XP and **never write back** into knowledge-point mastery. Your BKT record is driven by everyday answers and self-ratings, never shaken by a single exam."
+      "content": "# Chapter Exams\n\nThe chapter exam is the boss at the end of each chapter: a 🎯 node that shows 1-3 stars once passed. It unlocks when every lesson in the chapter clears the mastery bar.\n\n## The question bank generates in the background\n\nOpen the exam node and the AI writes questions in batches by knowledge point, with progress shown as “X / Y knowledge points covered”. While it generates you can go study something else — the job keeps running in the background and notifies you when it is done. Coming back, you see the ready page: N questions, M knowledge points covered, estimated duration; the exam itself only starts when you click “Start exam”.\n\n## A timer on every question\n\nEach question runs its own countdown, sized to the question itself — a longer stem, more options, code, or formulas each buy more time, clamped between 60 seconds and five minutes. When time runs out, the current choice is recorded and the exam moves on.\n\n## Leaving terminates the attempt\n\nSwitching lessons or courses mid-exam pops a warning: confirm leaving and the attempt terminates, with unanswered questions scored as wrong.\n\n## The results page\n\nAfter submitting you see: stars, accuracy, **a per-knowledge-point breakdown** (weak points are flagged for review), and a question-by-question review (your answer vs the correct one, plus explanations). Returning to the exam node later shows your latest result by default, along with your best star count and total attempts.\n\n## Retakes\n\nRetake as many times as you like. Retakes reuse the same bank, but question order and option order are reshuffled each time — it tests understanding, not memory.\n\n## Exams never touch the learning model\n\nExams are an independent check: results only update stars and XP and **never write back** into knowledge-point mastery. Your BKT record is driven by everyday answers and self-ratings, never shaken by a single exam."
     },
     {
       "nodeId": "guide-exam-2",
@@ -595,7 +595,7 @@
       "nodeId": "guide-les-4-1",
       "locale": "en",
       "title": "Three Zones: Understand / Notes / Practice",
-      "content": "# Three Zones: Understand / Notes / Practice\n\nThe right-pane notebook is built on the Cornell Notes method, in three zones.\n\n## 🗺️ Understand (AI artifacts)\n\nAI-generated visual study aids: concept maps (how ideas relate), compare tables (similar concepts side by side), flow diagrams (steps made visible), code walkthroughs (line-by-line annotation). The AI generates them as you learn.\n\n## ✏️ Notes (your highlights)\n\nEvery highlight you made by selecting text on the lesson page: each entry keeps the original wording, can carry an annotation, and clicking one jumps back to the exact spot in the source.\n\n## 📝 Practice (quizzes + history)\n\nThe lesson's exercises and your answer history: AI-generated quiz questions, every attempt kept, wrong answers scheduled for review by the spaced-repetition system.\n\n## Two tabs\n\nThe top of the right pane has two tabs: the Lesson tab shows the lesson body (rendered Markdown); the Notes tab shows the three zones above. Keeping lesson and notes separate lets you read without clutter."
+      "content": "# Three Zones: Understand / Notes / Practice\n\nThe right-pane notebook is built on the Cornell Notes method, in three zones.\n\n## 🗺️ Understand (AI artifacts)\n\nAI-generated visual study aids: concept maps (how ideas relate), compare tables (similar concepts side by side), flow diagrams (steps made visible), code walkthroughs (line-by-line annotation). The AI generates them as you learn.\n\n## ✏️ Notes (your highlights)\n\nEvery highlight you made by selecting text on the lesson page: each entry keeps the original wording, can carry an annotation, and clicking one jumps back to the exact spot in the source.\n\n## 📝 Practice (quizzes + history)\n\nThe lesson's exercises and your answer history: AI-generated quiz questions, every attempt kept, wrong answers scheduled for review by the spaced-repetition system.\n\n## Three tabs\n\nThe top of the right pane has three tabs: the Lesson tab shows the lesson body (rendered Markdown, with a mind-map overview toggle); the Notes tab shows the three zones above; and the Board tab is a zoomable canvas for the latest heavy artifact from the chat (concept map, flow diagram, compare table, or code walkthrough) — it flips over by itself when the AI produces a new one. Keeping lesson and notes separate lets you read without clutter."
     },
     {
       "nodeId": "guide-les-4-2",
@@ -607,7 +607,7 @@
       "nodeId": "guide-les-4-3",
       "locale": "en",
       "title": "Generative UI: Concept Maps / Compare Tables / Flow Diagrams",
-      "content": "# Generative UI\n\nThe AI tutor does not only output text — it emits interactive visual components.\n\n## Six generative components\n\n| Component | Use |\n|------|------|\n| 🗺️ Concept map | shows how ideas relate |\n| 📊 Compare table | contrasts several concepts |\n| 📐 Flow diagram | visualizes steps or pipelines |\n| 💻 Code walkthrough | explains code line by line |\n| 📝 Quiz | generates practice on the spot |\n| 🤔 Two-option guess | risk-free opener guess (unscored) |\n\n## What triggers them\n\nThe AI generates them on its own (when a concept suits visualization), on your request (“draw a concept map”), or from the consolidation buttons (Quiz me / Give me an example).\n\n## Where they live\n\nGenerated components appear in the middle-pane chat stream and in the Understand zone of the Notes tab (persisted). An AI concept map does not vanish when the chat ends — it stays in your notebook for review."
+      "content": "# Generative UI\n\nThe AI tutor does not only output text — it emits interactive visual components.\n\n## Six generative components\n\n| Component | Use |\n|------|------|\n| 🗺️ Concept map | shows how ideas relate |\n| 📊 Compare table | contrasts several concepts |\n| 📐 Flow diagram | visualizes steps or pipelines |\n| 💻 Code walkthrough | explains code line by line |\n| 📝 Quiz | generates practice on the spot |\n| 🤔 Two-option guess | risk-free opener guess (unscored) |\n\n## What triggers them\n\nThe AI generates them on its own (when a concept suits visualization), on your request (“draw a concept map”), or from the consolidation buttons (Quiz me / Give me an example).\n\n## Where they live\n\nGenerated components appear in the middle-pane chat stream and in the Understand zone of the Notes tab (persisted), and the four heavy artifacts also land on the Board canvas. An AI concept map does not vanish when the chat ends — it stays in your notebook for review."
     },
     {
       "nodeId": "guide-exam-4",