dsh-aha-tutor 1.10.0 → 1.11.0

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 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

package/README.en.md

@@ -30,7 +30,7 @@
 | **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. 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.10.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

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

package/docs/guide.zh-CN.md

@@ -177,11 +177,13 @@
 
 每份资料都可以一键**用它建课**，或者生成**速查表、闪卡、笔记、测验**，以及**消化**成概要、结构、核心观点、论点与论据、术语表和值得思考的问题。
 
+闪卡和测验会读完整份资料：长资料按约 2 万字一段来读，每段各出一批再合在一起，等待时显示读完了几段、已经写好多少，可以取消。闪卡每个知识点 2–4 张，一份资料最多 300 张，同一个问题只留一张；复习时每轮最多 40 张，页面上显示一共多少张。测验按资料长短出 5–30 题，短讲义大约 5–10 题，长资料的题目平均分到各段。个别段没读成时，闪卡和测验页面上会写明是哪一部分（页码或章节）。
+
 **找资料**：资料多了，在资料列表上方的搜索框里输入，会按标题和主题即时筛选；按回车（或点**搜正文**）会在所有资料的正文里搜，列出最相关的段落，带资料名、页码和高亮的上下文，点一条就跳到那份资料。搜索在本机进行，不调用模型。
 
 ## 学习工具、即时答疑与讲解短片
 
-- **学习工具**：先**选择资料**，再生成速查表、笔记、闪卡组或测验。可以在**重点**里写上范围，例如「期中考试范围第 3–6 章」。速查表可以调**列数、字号**，开关**高亮重点**，隐藏某些部分，然后**打印**。
+- **学习工具**：先**选择资料**，再生成速查表、笔记、闪卡组或测验。可以在**重点**里写上范围，例如「期中考试范围第 3–6 章」：速查表、笔记、闪卡和测验都只覆盖重点范围，和重点无关的部分会跳过，生成的内容以「资料名 · 重点」命名；资料里找不到相关内容时会提示你换个写法。速查表可以调**列数、字号**，开关**高亮重点**，隐藏某些部分，然后**打印**。
 - **即时答疑**：不用建课，直接提问，老师在白板上讲给你听。可以**继续追问**，以前问过的问题都在**历史记录**里。问题也可以点麦克风说出来（见[黑板课堂](#黑板课堂)里的「语音提问」）。
 - **讲解短片**：输入一个主题，或者贴一个网址，点**生成短片**，得到一段约两分钟的白板讲解。
 

package/lib/agent.js

@@ -1,4 +1,4 @@
-import { Dt as normalizePractice, F as generateJson, K as readProfile, Mt as text, Rt as newId, t as getRuntime, u as detectLanguage, w as quizPrompt } from "./runtime-DkuLvkuv.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";