dsh-aha-tutor 1.9.0 → 1.11.0

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 All notable changes to this plugin are recorded here. Versions follow [SemVer](https://semver.org/); GitHub Release notes for each version live in `docs/releases/`.
 
+## 1.11.0 - 2026-10-29
+
+### Changed
+
+- **Library flashcards and quizzes cover the whole material**: they were written from about 18,000 or 16,000 characters picked from the materials, always 24 cards or 10 questions. A long material is now read in parts of about 20,000 characters, three at a time, each part writing its own cards or questions: two to four cards per key point, at most 300 a deck, each question kept once; a quiz of 5 to 30 questions by length (a short handout 5–10), shared out over the parts. Cards are written without thinking, quizzes with it. **Study tools** and **Library** show how many parts are read and how many cards or questions are written, with Cancel. A part that could not be read is named on the deck or quiz; a model that refuses (sign-in, quota) stops the whole job at once. A large deck is studied in rounds of at most 40 cards, and the page shows the total.
+- **The focus counts for flashcards, quizzes and notes**: the **Focus** box of Study tools only reached cheat sheets. Every part of a deck or quiz now covers only what falls within it, and parts outside it are skipped; notes are written from the passages on it. What is made with a focus is named after it, and a focus nothing matches says so.
+
+### Fixed
+
+- **Unit flashcards and quizzes keep their last lessons**: a unit deck or quiz the model wrote longer than it may be was cut at its end, dropping the cards or questions of the unit's last lessons; it is now thinned out evenly.
+- **Library at phone width**: a long topic under a material pushed the page sideways; topics are clipped, with the whole topic on hover.
+
+## 1.10.0 - 2026-10-29
+
+### Added
+
+- **Flashcards for each unit**: every unit has **Unit flashcards** beside **Unit quiz**, in the outline and in the practice tab. A unit's deck is written the first time it is opened, from its lessons and concepts and from the course materials' pages on them: two to four cards per concept, at most 60. The deck keeps its review schedule, and the button shows how many of its cards are due. Course packs carry the unit decks.
+- **Flashcard review**: at the top of the practice tab, beside **Start review**, it brings the due cards of every unit together, oldest first.
+- **New set of questions**: the end of a unit quiz offers **New set of questions**, which writes the quiz again; **Retry** still repeats the same questions. A new set's questions get new ids, so answers to the old set are never graded again against them. Leaving while the new set is written and coming back waits for it instead of showing the old one.
+
+### Changed
+
+- **Unit quizzes as long as the unit**: a unit quiz always had 10 questions. It now has at least one per concept of the unit and more for the central ones, usually 10 to 30, the model choosing inside that range, and it follows the course materials' pages on the unit: their exercises, notation and units. While it is written, the page counts the questions done.
+- **One tab for practice, quizzes and flashcards**: the practice tab is now 「练习、测验与闪卡」 (Practice, quizzes & flashcards), and the Flashcards tab, which only held a button, is gone; links to it open the practice tab. The whole-course deck of earlier versions (30 cards from the outline and 6,000 characters of the materials) is no longer written. A deck already made joins **Flashcard review** with its schedule kept, its unseen cards included.
+- **Uploads up to 200 MB**: the limit was 60 MB, too small for a textbook full of pictures. 200 MB is DSH's own budget for attachments and fits both upload routes; the host no longer keeps a second copy of the file while reading it.
+
+### Fixed
+
+- **Navigation**: a course's flashcards and cheat sheets highlighted **Study tools** instead of **My courses**.
+- **Narrow pages**: the course title no longer pushes the course page sideways at phone width.
+
 ## 1.9.0 - 2026-10-27
 
 ### Added

package/README.en.md

@@ -28,9 +28,9 @@
 | **Handwriting chalkboard lessons** | Narration (voice + captions) while the board fills up in a handwriting font with points, formulas, diagrams, charts and, when it helps, a small animation; each item is written as its sentence is spoken and highlighted while it is discussed; curves given by a formula are computed point by point, with sliders for their parameters; the lesson's pages sit on one canvas you can drag and zoom while the view follows the teacher, and a side panel shows the lesson's goals and a transcript; pause, rewind and change speed any time |
 | **Quick checks that adapt** | At key moments the lesson stops for a question and asks how sure you are. Lucky guesses, hesitation and confident mistakes count differently; a lesson with a calculation asks you to write out your working and corrects it on the board. A revisit lesson is added automatically for concepts that did not stick |
 | **Raise your hand, hear it again** | Ask anything mid-lesson, typed or spoken (recognized on your computer by DSH's Voice input), and the tutor answers on the board, then picks up where it left off; or have a step re-explained with an analogy, a drawing, an example, more simply or in more depth. Think a step is wrong? Ask the teacher to check it: a real mistake is corrected at the board and fixed in the lesson, and a step that is right is explained |
-| **Practice, flashcards, reviews** | Every lesson has practice, with figures where they help, open answers graded by the model and keyboard answering; think a question or its grading is wrong, and the teacher checks it, fixes a wrong question, grades your answers to it again (earlier ones too) and corrects your mastery; a round ends with stars, how your mastery moved and a next step. Flashcards and concepts come back on a spaced-repetition schedule, and the study plan leaves time for them |
+| **Practice, flashcards, reviews** | Every lesson has practice, with figures where they help, open answers graded by the model and keyboard answering; think a question or its grading is wrong, and the teacher checks it, fixes a wrong question, grades your answers to it again (earlier ones too) and corrects your mastery; a round ends with stars, how your mastery moved and a next step. Each unit has a quiz and a flashcard deck, as long as its concepts call for. Flashcards and concepts come back on a spaced-repetition schedule, and the study plan leaves time for them |
 | **Your materials become courses** | PDF, Word, PowerPoint, Markdown, web links and images; a model that can see images reads scanned PDFs, documents made of pictures and photos. Lessons and cheat sheets cite pages; long readings can be digested into structure, claims and a glossary |
-| **Cheat sheets, notes, quizzes** | Printable cheat sheets organized by theme (columns, font size and highlighting adjustable), plus notes, flashcard decks and quizzes |
+| **Cheat sheets, notes, quizzes** | Printable cheat sheets organized by theme (columns, font size and highlighting adjustable), plus notes, flashcard decks and quizzes; decks and quizzes read the whole material part by part, size themselves by its length, and can keep to a focus |
 | **Explainer shorts and exports** | A two-minute whiteboard explainer from a topic or a link; any lesson exports to a video with the handwriting, captions and a watermark, or its board to a PDF (one board page per page, handwriting and formulas included) or a PNG picture per page |
 | **Hands-on projects** | Code projects get a folder with starter files and a DSH session where a coding agent helps you build; submit it back for a rubric-based review |
 | **Study plan and learner profile** | Lessons are scheduled around your weekly time, study days and deadlines, with warnings when a deadline is at risk; a month calendar ticks what you finish, takes ticks by hand and replans the days ahead; the tutor remembers your background and weak spots, which you can view, edit or clear |
@@ -42,7 +42,7 @@ Two sample courses ship with the plugin (harmonic motion and Bayesian thinking,
 
 You need the **DeepSeek Harness** desktop app (0.2.x, from 0.2.1) with at least one working model. See the [DSH instructions](https://github.com/deepseek-ai/deepseek-harness#run) if you do not have it yet.
 
-1. Open **Plugins** in the desktop app, click **Add plugin** and enter `dsh-aha-tutor` as the package, with the official registry as the source. Within 24 hours of a new release DSH's pnpm holds new versions back; enter an exact version such as `dsh-aha-tutor@1.9.0` then.
+1. Open **Plugins** in the desktop app, click **Add plugin** and enter `dsh-aha-tutor` as the package, with the official registry as the source. Within 24 hours of a new release DSH's pnpm holds new versions back; enter an exact version such as `dsh-aha-tutor@1.11.0` then.
 2. **Quit and reopen** the desktop app. Refreshing the page does not load the plugin's host side.
 3. Open **Aha · AI tutor** in the left sidebar (shown as 「开窍 · AI 私人老师」 in Chinese).
 

package/README.md

@@ -28,9 +28,9 @@
 | **手写黑板课堂** | 老师一边讲（语音 + 字幕），一边用手写体在黑板上逐字写下要点、公式、示意图和图表，讲到哪句写哪句，正在讲的内容用荧光笔划出；由公式画的曲线按公式逐点算出，带参数的还能拖动滑块看它怎么变；整讲的板书排在一张能拖动、缩放的画布上，镜头跟着老师走；侧栏显示课堂要点进度和讲解记录；随时暂停、回放、变速 |
 | **随堂小测与自适应** | 讲到关键处会停下来考你一题，并问你「有多确定」。猜对、犹豫、自信地答错，会被区别对待；有计算的一讲会请你写出过程，写错了老师就在黑板上订正。学完一讲后，薄弱的知识点会自动加一节巩固课 |
 | **举手提问、换个讲法** | 没听懂就举手，老师在黑板上专门回答你，讲完回到原来的进度；问题可以打字，也可以直接说出来（用 DSH 的语音输入在本机识别）；也可以让它用打比方、画图、举例、讲简单点或讲深一点的方式重讲这一步。觉得讲错了就点「这一步不对？」：老师先仔细核对，真错了就在黑板上更正，并把这一讲改好；没错就讲清为什么 |
-| **练习、闪卡与复习** | 每讲都有练习，题目可以带示意图，简答题由 AI 批改，支持键盘作答；觉得题目或判分有问题就点「这题有问题？」，老师先仔细核对，题错了就改好、重新判分（以前答过的也一起重判）并修正掌握度；做完一组给出星级、掌握程度变化和下一步建议。闪卡和知识点按间隔重复安排复习，学习计划会自动给复习留出时间 |
+| **练习、闪卡与复习** | 每讲都有练习，题目可以带示意图，简答题由 AI 批改，支持键盘作答；觉得题目或判分有问题就点「这题有问题？」，老师先仔细核对，题错了就改好、重新判分（以前答过的也一起重判）并修正掌握度；做完一组给出星级、掌握程度变化和下一步建议。每个单元有单元测验和单元闪卡，题量和张数按这个单元的知识点来定。闪卡和知识点按间隔重复安排复习，学习计划会自动给复习留出时间 |
 | **资料变课程** | 支持 PDF、Word、PPT、Markdown、网页链接和图片；扫描版 PDF、全是图片的文档和拍的照片，由能看图的模型识别出文字。讲课和速查表会引用原文页码；长文档可以一键「消化」成结构、论点和术语表 |
-| **速查表、笔记、测验** | 按主题整理的可打印速查表（列数、字号、高亮可调），以及笔记、闪卡组和测验 |
+| **速查表、笔记、测验** | 按主题整理的可打印速查表（列数、字号、高亮可调），以及笔记、闪卡组和测验；闪卡和测验会分段读完整份资料，数量按资料长短来定，也可以只出「重点」范围 |
 | **讲解短片 + 导出** | 输入一个主题或网址，得到一段约两分钟的白板讲解；任何一讲都能导出成带板书动画、字幕和水印的视频，也能把板书导出成 PDF（一页一张板书，带手写字体和公式）或每页一张的 PNG 图片 |
 | **实战项目** | 代码类项目一键生成项目文件夹和起始文件，并在 DSH 里打开一个会话，让编程 Agent 陪你做；做完回来提交，老师按评分标准逐项点评 |
 | **学习计划与画像** | 按每周时间、学习日和截止日期自动排课并提示进度风险；月历里学完自动打勾，也能手动勾选，计划随之重排；老师会记住你的背景和薄弱点，你可以随时查看、修改或清空 |
@@ -48,7 +48,7 @@
    dsh-aha-tutor
    ```
 
-   安装源选择**官方源**，点击**安装**。新版本刚发布的 24 小时内，DSH 的 pnpm 会因为发布冷却期暂缓安装，这时请填入精确版本，例如 `dsh-aha-tutor@1.9.0`。
+   安装源选择**官方源**，点击**安装**。新版本刚发布的 24 小时内，DSH 的 pnpm 会因为发布冷却期暂缓安装，这时请填入精确版本，例如 `dsh-aha-tutor@1.11.0`。
 
 2. **完全退出并重新打开** DSH 桌面应用。只刷新页面不会加载 Host 端的新插件。
 

package/docs/guide.zh-CN.md

@@ -135,10 +135,9 @@
 
 | 标签 | 内容 |
 | --- | --- |
-| **大纲** | 全部单元、章和讲，带学习状态和讲法（直观理解、定义概念等）；自动加入的巩固课标有「巩固」。每个单元都有**单元速查表**和**单元测验** |
-| **练习与测验** | 每讲的练习、单元测验和**开始复习**（只复习这门课） |
+| **大纲** | 全部单元、章和讲，带学习状态和讲法（直观理解、定义概念等）；自动加入的巩固课标有「巩固」。每个单元都有**单元速查表**、**单元测验**和**单元闪卡** |
+| **练习、测验与闪卡** | 每讲的练习，每个单元的**单元测验**和**单元闪卡**；顶部的**开始复习**复习这门课该复习的知识点，**闪卡复习**把各单元到期的闪卡放在一起复习 |
 | **速查表** | 单元速查表，按主题整理公式、定义和要点 |
-| **闪卡** | 这门课的闪卡，按复习计划出现 |
 | **项目** | 实战项目，见[实战项目](#实战项目) |
 | **进度** | 每个知识点的掌握程度（未开始、薄弱、学习中、熟练、掌握五级），以及老师发现的误解（⚠） |
 
@@ -158,7 +157,8 @@
     重新判分后，掌握度和复习时间会按新的分数重新算，就像当初判对了一样：这次作答留下的「误解」标记也会去掉，这一轮的星级、正确率和连对也按新结果算。每讲的练习、单元测验、学习工具里的测验和复习里的题都可以这样核对。
 
     题目改好后，你以前对同一道题的作答（上一轮练习、复习里，或课上的小测）也会按改好的题重新判，结果框里会说重判了几次。题目确实有错时，按改好的答案判，分数可能升也可能降；题目没说清楚时，只会往上调，因为你当时按另一种理解答的可能也对。简答题和写过程的题由 AI 重新批改最近 3 次。只有最近 50 次作答留有记录，更早的不再重判。
-- **闪卡**：点击翻面，然后按记忆情况选**忘了 / 困难 / 记得 / 简单**。开窍用间隔重复安排下次复习的时间，记得越牢，间隔越长。
+- **单元测验**：题量按这个单元的知识点来定，每个知识点至少一题，重点多出几题，一般 10–30 题；课程有资料时，题目按资料里这个单元的内容和题型来出。题多时要等一两分钟，等待时会显示已经出了几题。做完可以**重试**同一套题，也可以点**换一套新题**重新出一套。
+- **闪卡**：在课程页的**练习、测验与闪卡**里点某个单元的**单元闪卡**，第一次打开时按这个单元的知识点生成，每个知识点 2–4 张，一个单元最多 60 张。点击翻面，然后按记忆情况选**忘了 / 困难 / 记得 / 简单**。开窍用间隔重复安排下次复习的时间，记得越牢，间隔越长；有到期的卡片时，按钮上会显示张数。顶部的**闪卡复习**把各单元到期的闪卡放在一起复习；1.10.0 之前生成的整门课闪卡也在这里，原来的复习记录照旧保留。
 - **复习**：学过的知识点也会按遗忘曲线回来。学习计划会提醒你**有 N 个知识点该复习了**，点**开始复习**即可。
 
 ## 资料库
@@ -173,13 +173,17 @@
 | 网页 | 点**添加网页**，填入公开网址，开窍会提取正文 |
 | 图片 | 能看图的模型会识别图里的字，之后和其他资料一样能建课、做速查表和测验；图片本身也会交给能看图的模型 |
 
+单个文件最大 200 MB，图片最大 10 MB；更大的文件可以拆成几份上传。
+
 每份资料都可以一键**用它建课**，或者生成**速查表、闪卡、笔记、测验**，以及**消化**成概要、结构、核心观点、论点与论据、术语表和值得思考的问题。
 
+闪卡和测验会读完整份资料：长资料按约 2 万字一段来读，每段各出一批再合在一起，等待时显示读完了几段、已经写好多少，可以取消。闪卡每个知识点 2–4 张，一份资料最多 300 张，同一个问题只留一张；复习时每轮最多 40 张，页面上显示一共多少张。测验按资料长短出 5–30 题，短讲义大约 5–10 题，长资料的题目平均分到各段。个别段没读成时，闪卡和测验页面上会写明是哪一部分（页码或章节）。
+
 **找资料**：资料多了，在资料列表上方的搜索框里输入，会按标题和主题即时筛选；按回车（或点**搜正文**）会在所有资料的正文里搜，列出最相关的段落，带资料名、页码和高亮的上下文，点一条就跳到那份资料。搜索在本机进行，不调用模型。
 
 ## 学习工具、即时答疑与讲解短片
 
-- **学习工具**：先**选择资料**，再生成速查表、笔记、闪卡组或测验。可以在**重点**里写上范围，例如「期中考试范围第 3–6 章」。速查表可以调**列数、字号**，开关**高亮重点**，隐藏某些部分，然后**打印**。
+- **学习工具**：先**选择资料**，再生成速查表、笔记、闪卡组或测验。可以在**重点**里写上范围，例如「期中考试范围第 3–6 章」：速查表、笔记、闪卡和测验都只覆盖重点范围，和重点无关的部分会跳过，生成的内容以「资料名 · 重点」命名；资料里找不到相关内容时会提示你换个写法。速查表可以调**列数、字号**，开关**高亮重点**，隐藏某些部分，然后**打印**。
 - **即时答疑**：不用建课，直接提问，老师在白板上讲给你听。可以**继续追问**，以前问过的问题都在**历史记录**里。问题也可以点麦克风说出来（见[黑板课堂](#黑板课堂)里的「语音提问」）。
 - **讲解短片**：输入一个主题，或者贴一个网址，点**生成短片**，得到一段约两分钟的白板讲解。
 

package/lib/agent.js

@@ -1,4 +1,4 @@
-import { Et as normalizePractice, F as generateJson, K as readProfile, Pt as newId, jt as text, t as getRuntime, u as detectLanguage, w as quizPrompt } from "./runtime-C3yJfJTT.js";
+import { At as normalizePractice, I as generateJson, Kt as newId, Rt as text, q as readProfile, t as getRuntime, u as detectLanguage, w as quizPrompt } from "./runtime-DL1sWVKI.js";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 //#region src/agent.js
 const name = "aha-tutor-agent";