dsh-zju-lecture-note 2.2.3 → 2.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (30) hide show
  1. package/CHANGELOG.md +41 -0
  2. package/README.md +8 -7
  3. package/docs/technical.md +26 -4
  4. package/mcp_server.py +1 -1
  5. package/package.json +1 -1
  6. package/skills/scholia-notes/SKILL.md +8 -1
  7. package/skills/scholia-notes/references/format-spec.md +57 -6
  8. package/skills/scholia-notes/references/prelude.typ +42 -0
  9. package/skills/scholia-notes/references/typography-spec.md +4 -4
  10. package/skills/scholia-notes.manifest.json +9 -9
  11. package/skills/zju-lecture-summarizer/SKILL.md +13 -1
  12. package/skills/zju-lecture-summarizer.manifest.json +4 -4
  13. package/zju_lecture/client.py +741 -741
  14. package/zju_lecture/handout.py +353 -57
  15. package/zju_lecture/handout_prelude.typ +35 -2
  16. package/zju_lecture/prelude.typ +42 -0
  17. package/zju_lecture/study_notes.py +296 -1
  18. package/zju_lecture/typst-packages/VENDORED.md +1 -1
  19. package/zju_lecture/typst-packages/preview/noteworthy/0.4.0/LICENSE +20 -20
  20. package/zju_lecture/typst-packages/preview/noteworthy/0.4.0/lib.typ +128 -128
  21. package/zju_lecture/typst-packages/preview/noteworthy/0.4.0/typst.toml +15 -15
  22. package/zju_lecture/typst-packages/preview/scholia/0.1.0/src/lib.typ +2 -2
  23. package/zju_lecture/typst-packages/preview/showybox/2.0.4/LICENSE +21 -21
  24. package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/func.typ +142 -142
  25. package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/id.typ +11 -11
  26. package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/pre-rendering.typ +50 -50
  27. package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/sections.typ +141 -141
  28. package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/shadows.typ +118 -118
  29. package/zju_lecture/typst-packages/preview/showybox/2.0.4/showy.typ +267 -267
  30. package/zju_lecture/typst-packages/preview/showybox/2.0.4/typst.toml +11 -11
package/CHANGELOG.md CHANGED
@@ -3,6 +3,47 @@
3
3
  版本号在 `package.json`、`pyproject.toml`、`mcp_server.SERVER_VERSION`、
4
4
  `.minimax-plugin/plugin.json` 与两个 Skill manifest 六处对齐。
5
5
 
6
+ ## 2.2.4 — 2026-11-05
7
+
8
+ 修一个会误导读者的排版细节:**证明的 qed 方块停在第一行**。
9
+
10
+ - **框与证明改成「跨段」,qed 落在真正的结尾**:旧实现一次只读标记行那一行,
11
+ 遇到空行或 `$$` 就收尾 —— 定理陈述里的块级公式被甩到框外,`[证明]` 的 qed
12
+ 方块停在「Proof. —— 直接用定义,把积分区间拆开:」那一行末尾,读者会以为
13
+ 证明到这儿就结束了(实测讲义截图报的就是这个)。现在 `[定义]` / `[定理]` /
14
+ `[例]` / `[证明]` 从标记行一直收到下一个标记、标题或整行粗体的伪标题,
15
+ 块内的空行是段落分隔,`$$…$$`、列表、表格都留在装置里;`[直觉]` / `[练习]` /
16
+ `[边注]` / `[强调]` 仍只吃标记行那一句。阅读版(`handout.py`)与填空笔记
17
+ (`study_notes.py`)两条链路同一套口径。
18
+ - **`<label>` 三种位置都认**:标记行末尾、独占一行、最后一段末尾。跨段之后
19
+ 回指编号不会悬空,`_collect_refs` 与渲染共用同一个收集器。
20
+ - **四段式例题自动断段**:`题目 / 切入点 / 关键步骤 / 易错点` 紧跟句末标点
21
+ (`。!?;`)时在标签前断段(`study_notes.split_review_labels()`,两条链路共用)。
22
+ 模型常把这四段写进同一个 `[例]` 行,不断段的话框里就是一大坨,读起来很费力;
23
+ 现在一条一行,正文一个字都不改。
24
+ - **节标题上方留白加大**:二级标题(绿色小节标题)`above` 12pt → **22pt**,
25
+ 一级标题 20pt → **24pt**(保持章 > 节的层次)。只改上方,行距与段距不动;
26
+ 阅读版 `handout_prelude.typ` 与填空版 vendored `src/lib.typ` 同步,
27
+ 数值仍以 `typography-spec.md` 的 `typography-params` 为准。
28
+ - **块内段落计入「方框:正文」分母**:内容搬进装置后分母不能凭空变小,否则
29
+ 比例检查会把正常讲义误判成「框框滥用」。
30
+ - **自测题:题干进琥珀框,答案排在框外**:`**1.** 题干` + `<details><summary>答案</summary>…`
31
+ 现在排成 `#selftest`(与「例」同款的棕色方框,标签「自测题 *n*」)与 `#answer`
32
+ (框外、淡灰左线 + 「答案」标签),题目与答案之间有一道清楚的边界;手写的
33
+ `**1.**` 编号交给标签,`<summary>` 的文字当答案标签。填空链路顺带修掉了
34
+ `<details>` / `<summary>` 被转义后印成字面量的问题。
35
+ - **规范与 Skill**:`format-spec.md` 新增 §2.4「标记块到哪里结束(跨段规则)」与
36
+ §2.5「自测题」;两个 Skill 与 README 同步口径;`tests/test_marker_span_v224.py`
37
+ 22 条 + `tests/test_selftest_v224.py` 9 条回归,含像素 + `pdftotext -bbox` 的
38
+ qed 几何校验(方块必须落在证明最后一行;缺 poppler / Pillow 时跳过)。
39
+ - **市场条目描述收成一行的三句**(`market-submission/*.yml`):按市场实际分布
40
+ (en 中位数 212 / p90 445,zh 中位数 84 / p90 178)从 1226 / 561 字符压到
41
+ 326 / 165,只留「做什么 / 权限边界 / 来源」。`8eoyw` 参考实现、scholia 的作者
42
+ 与 Typst Universe 链接仍由 `ATTRIBUTION.md` / `README.md` 常设致谢承担;
43
+ 同时删掉会被站点当字面量印出的 `**`,以及「离线也能出 PDF」这类经不起对照
44
+ `zju_lecture/deps.py` 的夸大(Typst 二进制是缺失时联网下载的)。
45
+ `tests/test_docs_split.py` 增加长度与「纯文本」闸门,挡住再长回去。
46
+
6
47
  ## 2.2.3 — 2026-11-04
7
48
 
8
49
  按又一次真实上课(`session-5415d8a5`,sub_id 1990907)里「工具没错、但 Agent 得替它
package/README.md CHANGED
@@ -12,7 +12,7 @@
12
12
  ## 开始使用
13
13
 
14
14
  - 安装 DeepSeek Harness
15
- - 进入插件→添加插件,复制仓库链接 https://github.com/chenqianyu486-sys/dsh-zju-lecture-note
15
+ - 进入插件→添加插件,复制 npm 包名 dsh-zju-lecture-note 或仓库链接 https://github.com/chenqianyu486-sys/dsh-zju-lecture-note
16
16
  - 安装并启用插件
17
17
  - 在新会话中键入 /zju-lecture-summarizer 即可使用插件总结课堂内容,例:
18
18
  ```text
@@ -121,18 +121,19 @@ Agent 只多收到一行 `PDF: <路径>(N 页)`。失败时 Markdown 照常
121
121
  | 你写 | 得到 |
122
122
  | :--- | :--- |
123
123
  | `[直觉]` / `[定义] 标题 —— 正文` / `[定理]` / `[例]` | 淡彩方框(青绿 / 蓝 / 琥珀) |
124
- | `[证明]` | 斜体 `Proof.` + 行末 qed |
124
+ | `[证明]` | 斜体 `Proof.` + **块末** qed |
125
125
  | `[练习]` | 带 3 行书写横线的练习块 |
126
126
  | `[边注]` / `[边注!]` | 右侧留白栏的边注 |
127
127
  | `[强调]` / `[易错]` / `[弱注]` / `[分隔]` | 行内高亮 / 提示 / 弱化 / 分隔 |
128
128
  | `____` / `[缺口: …]` | 灰色填空线 / 留白 |
129
129
  | `<def:x>` + `@def:x` | 编号与回指(原生交叉引用) |
130
130
 
131
+ 方框与 `[证明]` 是「块」不是「一行」:从标记行排到下一个标记 / 标题 / 整行粗体的小标题,
132
+ 块里的空行是段落分隔,`$$…$$`、列表、表格都留在装置里 —— 证明的 qed 因此落在真正的结尾。
131
133
  语义、预算(每节方框 ≤ 2 个)与数学写法由
132
- [格式规范](skills/scholia-notes/references/format-spec.md) 统一规定;
133
- 字体、字号、版心、边注等排版数值以
134
- [排版规范](skills/scholia-notes/references/typography-spec.md) 为唯一真相源。
135
- 填空笔记与阅读版讲义两条链路共用同一套参数。
134
+ [格式规范](skills/scholia-notes/references/format-spec.md) 统一规定;字体、字号、版心、
135
+ 边注等排版数值以[排版规范](skills/scholia-notes/references/typography-spec.md) 为唯一真相源;
136
+ 两条链路共用同一套参数。
136
137
 
137
138
  ### 填空式学习笔记(可选)
138
139
 
@@ -290,7 +291,7 @@ MCP 宿主的对应环境变量:`ZJU_RENDER_PDF`、`ZJU_TYPST_AUTO_INSTALL`、
290
291
  | 文档 | 内容 |
291
292
  | :--- | :--- |
292
293
  | [docs/technical.md](docs/technical.md) | 技术细节:目录结构、隐私实现、PDF 排版、标记语法、开发测试、发布流程 |
293
- | [CHANGELOG.md](CHANGELOG.md) | 版本历史(2.1.0 → 1.4.0) |
294
+ | [CHANGELOG.md](CHANGELOG.md) | 版本历史 |
294
295
  | [SECURITY.md](SECURITY.md) | 威胁模型、Cookie 生命周期、已知边界 |
295
296
  | [ATTRIBUTION.md](ATTRIBUTION.md) | 逐文件来源、第三方许可、参考实现边界 |
296
297
  | [format-spec.md](skills/scholia-notes/references/format-spec.md) | 规范性文件:Markdown → PDF 装置的语义对应、预算、配色与字体 |
package/docs/technical.md CHANGED
@@ -222,9 +222,10 @@ Skill 附录和系统提示;关掉就**不存在**,不占工具列表、不
222
222
  [`typography-spec.md`](../skills/scholia-notes/references/typography-spec.md);
223
223
  本节只保留机制。
224
224
  - 一级标题:灰蓝编号 + 蓝色标题 + 细线;方框淡彩底 + 左侧竖线、无圆角;
225
- 证明以斜体 `Proof.` + 行末 qed。
225
+ 证明以斜体 `Proof.` + **块末** qed(方块落在证明最后一行,不是第一行)。
226
226
  - 各级标题后的间距自 2.2.2 起加大(用户在实地会话里要求「小节标题后的行间距
227
- 适当大一些」),具体值见规范 §2;两条链路同步改。
227
+ 适当大一些」);2.2.4 又把**上方**留白拉开(节标题 12pt → 22pt、章标题 20pt → 24pt),
228
+ 否则绿色小节标题紧贴上一段、看不出新节从哪里开始。具体值见规范 §2;两条链路同步改。
228
229
  - `par.first-line-indent` **不可靠**:它只在「前一个兄弟元素是段落」时生效,
229
230
  标题 / 块 / 图 / 公式后的段落一律不缩进 ⇒ 正文改用行内 `#h(2em)` 顶首行;
230
231
  直觉块不缩进(块自身的左内边距已经分开)。
@@ -246,8 +247,8 @@ Skill 附录和系统提示;关掉就**不存在**,不占工具列表、不
246
247
  | 标记 | 装置 |
247
248
  | :--- | :--- |
248
249
  | `[直觉]` | `#note`(青绿淡底) |
249
- | `[定义] 标题 —— 正文` / `[定理]` / `[命题]` / `[例]` | 带标签的方框 |
250
- | `[证明]` | 斜体 `Proof.` + qed |
250
+ | `[定义] 标题 —— 正文` / `[定理]` / `[命题]` / `[例]` | 带标签的方框(**跨段**) |
251
+ | `[证明]` | 斜体 `Proof.` + **块末** qed(**跨段**) |
251
252
  | `[练习]` | `#yourturn` + 3 行 `#workspace(n: 3)`(练习块里的短 `____` 一律丢弃) |
252
253
  | `[边注]` / `[边注!]` | 右侧留白边注(`[边注!]` 带强调) |
253
254
  | `[强调]` / `[易错]` / `[弱注]` / `[分隔]` | 行内高亮 / 提示 / 弱化 / 分隔线 |
@@ -256,6 +257,27 @@ Skill 附录和系统提示;关掉就**不存在**,不占工具列表、不
256
257
  | `[缺口: …]` | `#gap` 留白 |
257
258
  | `<label>` / `@label` | 两遍扫描后生成原生交叉引用 |
258
259
 
260
+ **标记块的边界**:框类装置与 `[证明]` 是「块」而不是「一行」——从标记行一直收到
261
+ 下一个标记行 / 标题 / 整行粗体的伪标题(`**周期函数的处理** \`[00:22]\``)。
262
+ 块内的空行是段落分隔,`$$…$$`、列表、表格都留在装置里;`_render_block_sequence()`
263
+ 负责把它们排成装置内容(块内段落不加 `#h(2em)`)。单段装置(`[直觉]` / `[练习]` /
264
+ `[边注]` / `[强调]` …)仍只吃标记行那一句。
265
+ 这条规则同时修掉两个实地问题:定理陈述里的块级公式被甩到框外;`[证明]` 遇到空行就
266
+ 收尾,qed 方块停在一两行之后,读起来像「证明到这就结束了」。两条链路(
267
+ `handout.py` 与 `study_notes.py`)用同一套口径;块内段落仍计入「方框:正文」的分母,
268
+ 避免比例检查误报。
269
+
270
+ 块内正文在「题目 / 切入点 / 关键步骤 / 易错点」四个标签紧跟句末标点
271
+ (`。!?;`)时自动断段(`study_notes.split_review_labels()`):模型常把复习版例题的
272
+ 四段写进同一行,不断段的话框里就是一大坨(实地讲义实测)。
273
+
274
+ **自测题**(`**1.** 题干` + `<details><summary>答案</summary>…</details>`)在两条链路里
275
+ 分别排成 `#selftest`(琥珀框,标签「自测题 n」,手写的 `**1.**` 编号交给标签)与
276
+ `#answer`(框外,淡灰左线 + 「答案」标签)。题干是紧挨 `<details>` 的那一段;
277
+ `<summary>` 的文字当标签。这样题目与答案之间有一道清楚的边界,也不会再把
278
+ `<details>` 印成字面量(填空链路以前会)。两个装置分别定义在 `handout_prelude.typ`
279
+ 与 `zju_lecture/prelude.typ`。
280
+
259
281
  标题手写的编号(`1.` / `1.2` / `一、` / `(三)`)**一律剥掉**,编号只由 Typst 生成。
260
282
  - **数学**:与填空笔记共用 `study_notes.latex_to_typst`:`pmatrix` / `bmatrix` / `cases` / `aligned`
261
283
  机械转成 `mat` / `cases` / 对齐换行;多字母标识符(`AC`、`e^{-st}`、`BVP`)按规则转成
package/mcp_server.py CHANGED
@@ -87,7 +87,7 @@ from zju_lecture.study_notes import (
87
87
  )
88
88
 
89
89
  SERVER_NAME = "zju-lecture-mcp"
90
- SERVER_VERSION = "2.2.3"
90
+ SERVER_VERSION = "2.2.4"
91
91
  DEFAULT_TENANT = "112"
92
92
  DEFAULT_DOMAIN = "classroom.zju.edu.cn"
93
93
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-zju-lecture-note",
3
- "version": "2.2.3",
3
+ "version": "2.2.4",
4
4
  "description": "浙大智云课堂回放讲义插件(DeepSeek Harness 原生插件):以「语音字幕 + 本地课件」为主链路,写完讲义自动排版同名 PDF;可选启用投影 PPT 截图抓取、基于 Typst scholia 模板排版的填空式学习笔记与登录辅助工具;Cookie 只在本地内存中使用,不回显、不落盘",
5
5
  "license": "MIT",
6
6
  "author": "chenqianyu486",
@@ -218,7 +218,7 @@ LaTeX → Typst 的数学转换**只在 compile 这一步做一次**:底稿里
218
218
  | `[直觉]` | `#note[…]` | 带底色,每节≤1 |
219
219
  | `[定义]` | `#definition[术语][…] <def:x>` | 方框(≤2/节) |
220
220
  | `[定理]/[引理]/[推论]` | `#theorem[标题][来源标签][…] <thm:x>` | 方框(≤2/节) |
221
- | `[证明]` | `#proof[… #TODO[缺口] …]` | 无框 + qed |
221
+ | `[证明]` | `#proof[… #TODO[缺口] …]` | 无框 + **块末** qed |
222
222
  | `[例]` | `#example[标题][…]` | 方框(≤2/节) |
223
223
  | `[练习]` | `#yourturn[…] #workspace(n: 3)` | 方框 + 留白 |
224
224
  | `[边注]` | `#recall[…]` | 右栏,最省空间 |
@@ -227,6 +227,13 @@ LaTeX → Typst 的数学转换**只在 compile 这一步做一次**:底稿里
227
227
  | `____` 填空 | `#fillin(width: 2.2cm)`(灰色;**练习块里不画**,那里已有书写横线) | — |
228
228
  | `@def:xxx` 回指 | 原生 `@def:xxx`,label 写在 knot 后 | — |
229
229
 
230
+ > **框与证明是「块」,不是「一行」**:`[定义]` / `[定理]` / `[例]` / `[证明]` 从标记行开始,
231
+ > 一直排到下一个标记、标题或整行粗体的伪标题为止。块里的空行是段落分隔,
232
+ > `$$…$$`、列表、表格都留在装置里。`[证明]` 的 qed 方块因此排在**块内最后一行** ——
233
+ > 证明要一直写到最后一段,不要把结论另起一段写在标记外面(方块会停在半路,误导读者的
234
+ > 正是这个)。`[直觉]` / `[练习]` / `[边注]` / `[强调]` 只吃标记行那一句。
235
+ > 完整规则见 [`references/format-spec.md`](references/format-spec.md) §2.4。
236
+
230
237
  ## 内容出处:自己的话 + 可核对的来源
231
238
 
232
239
  模板只管排版,**内容归属是你要负责的事**:
@@ -65,13 +65,14 @@
65
65
  | `> 引用` | 引用块(左侧细线 + 灰色小字;多个 `> **字段**:…` 逐条换行) | 讲义抬头的来源 / ASR 说明 | 轻 |
66
66
  | `$…$` / `$$…$$` | 行内 / 块级公式 | 数学 | 中 |
67
67
  | `[直觉] …` | 淡蓝底色块 | 每节一次,讲「人话版」 | 中 |
68
- | `[定义] 术语 —— 正文` | 定义框(青绿,编号 Definition *n*) | **需要被回指时** | 重 |
69
- | `[定理] 标题 —— 正文` | 定理框(蓝,编号 Theorem *n*) | **需要被回指时** | 重 |
70
- | `[引理] …` / `[推论] …` | 引理框 / 推论框(蓝) | 同上 | 重 |
71
- | `[公理] …` / `[假设] …` / `[记号] …` | 公理 / 假设 / 记号框(青绿) | 同上 | 重 |
72
- | `[例] 标题 —— 正文` | 例框(琥珀) | 值得完整展示的例题 | 重 |
73
- | `[证明] …` | 证明段(斜体 `Proof.` + qed 方块) | 有证明 | 轻 |
68
+ | `[定义] 术语 —— 正文` | 定义框(青绿,编号 Definition *n*,跨段) | **需要被回指时** | 重 |
69
+ | `[定理] 标题 —— 正文` | 定理框(蓝,编号 Theorem *n*,跨段) | **需要被回指时** | 重 |
70
+ | `[引理] …` / `[推论] …` | 引理框 / 推论框(蓝,跨段) | 同上 | 重 |
71
+ | `[公理] …` / `[假设] …` / `[记号] …` | 公理 / 假设 / 记号框(青绿,跨段) | 同上 | 重 |
72
+ | `[例] 标题 —— 正文` | 例框(琥珀,跨段;四段式标签自动断段) | 值得完整展示的例题 | 重 |
73
+ | `[证明] …` | 证明段(斜体 `Proof.` + **块末** qed 方块,跨段) | 有证明 | 轻 |
74
74
  | `[练习] …` | 练习块(琥珀 + 3 行书写位) | 每节 ≤ 1 | 中 |
75
+ | `**1.** 题干` + `<details><summary>答案</summary>…` | 自测题:题干进琥珀框(标签「自测题 *n*」),答案排在框外(淡灰左线 + 标签) | 文末 3–5 道 | 中 |
75
76
  | `[边注] …` | 右栏主动回忆问题(`?`) | 每节 ≤ 1 | 不占版面 |
76
77
  | `[边注!] …` | 右栏提醒(`!`) | 需要强调的提醒 | 不占版面 |
77
78
  | `[强调] …` | 行内淡色加粗 | 重点句子 | 轻 |
@@ -125,6 +126,56 @@
125
126
  - 比值 **≤ 1 : 8** 比较稳(大约每八段话最多一个框)。
126
127
  - 超过 **1 : 4** 基本可以判定「框框滥用」:把非关键的那个降级成普通段落 + `[强调]`。
127
128
 
129
+ ### 2.4 标记块到哪里结束(跨段规则)
130
+
131
+ 标记行不是「一行」,而是一个**块的开头**。块到哪里结束,由装置类型决定:
132
+
133
+ | 装置 | 块的边界 | 块里能放什么 |
134
+ | :--- | :--- | :--- |
135
+ | 框(`[定义]` `[定理]` `[引理]` `[命题]` `[推论]` `[公理]` `[假设]` `[记号]` `[例]`)与 `[证明]` | 下一个标记行 / 下一个标题 / 整行粗体的伪标题 | 段落、`$$…$$` 块级公式、列表、表格;空行是段落分隔 |
136
+ | 单段装置(`[直觉]` `[练习]` `[旁注]` `[边注]` `[边注!]` `[强调]` `[易错]` `[弱注]`) | 只吃标记行那一句 | 不要在这些标记下面另起段落,工具不会把它们收进装置 |
137
+
138
+ 三个直接后果:
139
+
140
+ - 定理陈述里的块级公式、例题的「题目 → 切入点 → 关键步骤 → 易错点」、证明的整段推导,
141
+ **直接写在标记下面**,不要再补 `[强调]` 之类的替身。
142
+ - **四段式例题会按「题目 / 切入点 / 关键步骤 / 易错点」自动断段**:这四个标签紧跟
143
+ 句末标点(`。!?;`)时,渲染器在标签前另起一段,所以写在同一个 `[例]` 行里也读得开
144
+ (`…跳起来。切入点:…` → 三段)。想加更多分层就照常用空行分段,效果一样。
145
+ - `[证明]` 的 qed 方块排在**块内最后一行**。所以证明要一直写到最后一段;
146
+ 不要把结论另起一段写在标记外面,否则方块会停在半路,读者以为证明已经结束。
147
+ 证明结束的标志就是「下一个标记 / 标题」,不需要也不存在 `[证明完]`。
148
+ - 装置之后的普通叙述会**并入装置**。要让它回到正文,先结束装置:加一个标题、
149
+ 下一个标记,或 `[分隔]`。
150
+
151
+ > 伪标题指「整行只有一段粗体(可带 `` `[mm:ss]` `` 时间码)」的写法,例如
152
+ > `**周期函数的处理** \`[00:22]\``。讲义里拿它当小标题,所以会被当作**块的边界**;
153
+ > 不要指望它被并进上一个框。
154
+
155
+ ### 2.5 自测题:题干进框,答案在框外
156
+
157
+ 复习版讲义文末的 3–5 道自测题按这个结构写:
158
+
159
+ ````markdown
160
+ **1.** 题干(可以带行内公式)。
161
+
162
+ <details>
163
+ <summary>答案</summary>
164
+
165
+ 解答正文,可以含块级公式、要点、易错点。
166
+
167
+ </details>
168
+ ````
169
+
170
+ PDF 里:**题干**排成与 `[例]` 同款的**琥珀方框**,标签是「自测题 1」;
171
+ **答案**排在框外,左侧一条淡灰细线 + 「答案」标签。题目与答案因此有一道清楚的边界,
172
+ 不会像以前那样连成一整篇。
173
+
174
+ - `<summary>` 的文字会当成答案标签(写「解析」「参考答案」也认)。
175
+ - 题干必须**紧挨着** `<details>`(中间只允许空行);否则那一段按普通正文排。
176
+ - 题干开头的 `**1.**` / `1.` 编号会被剥掉、交给方框标签;没写编号就用顺序号。
177
+ - 答案里可以放段落、块级公式、列表,它们都留在答案块里。
178
+
128
179
  ## 3. 禁止事项
129
180
 
130
181
  | 不要 | 为什么 | 改写成 |
@@ -91,6 +91,48 @@
91
91
  stroke: (bottom: 0.6pt + active.get().fillin),
92
92
  )
93
93
 
94
+ // ── 5b. 自测题:题干琥珀框,答案排在框外 ──
95
+ // Markdown 里的 `<details><summary>答案</summary>…</details>` 由渲染器映射成
96
+ // 这两个装置:题干进 #selftest(与「例」同款的琥珀方框),答案进 #answer
97
+ // (左侧一条淡灰细线 + 「答案」小标签)。题目与答案因此有一道清楚的边界,
98
+ // 不会像以前那样连成一篇。
99
+ #let selftest(number, body) = context {
100
+ let p = active.get()
101
+ block(
102
+ width: 100%,
103
+ breakable: true,
104
+ fill: tint(p, p.eg),
105
+ stroke: (left: 2pt + p.eg),
106
+ inset: (left: 11pt, right: 10pt, top: 7pt, bottom: 7pt),
107
+ above: 14pt,
108
+ below: 2pt,
109
+ {
110
+ set align(left)
111
+ text(font: default-fonts.sans, weight: "bold", size: 0.92em, fill: p.eg)[自测题 #number]
112
+ h(0.4em)
113
+ body
114
+ },
115
+ )
116
+ }
117
+
118
+ #let answer(label, body) = context {
119
+ let p = active.get()
120
+ block(
121
+ width: 100%,
122
+ breakable: true,
123
+ inset: (left: 12pt, right: 10pt),
124
+ stroke: (left: 1.2pt + p.hairline),
125
+ above: 4pt,
126
+ below: 16pt,
127
+ {
128
+ set align(left)
129
+ text(font: default-fonts.sans, weight: "bold", size: 0.9em, fill: p.muted)[#label]
130
+ v(0.25em)
131
+ body
132
+ },
133
+ )
134
+ }
135
+
94
136
  // ── 6. 类型速查(写正文时照着选色相) ──
95
137
  // 结论/定理/证明/回指 → thm 蓝
96
138
  // 定义/公理/术语/标签 → def 青绿
@@ -49,9 +49,9 @@ cover.date = 9pt
49
49
  heading.h1 = 15pt
50
50
  heading.h2 = 12.5pt
51
51
  heading.h3 = 11.5pt
52
- heading.h1.above = 20pt
52
+ heading.h1.above = 24pt
53
53
  heading.h1.below = 12pt
54
- heading.h2.above = 12pt
54
+ heading.h2.above = 22pt
55
55
  heading.h2.below = 0.85em
56
56
  heading.h3.above = 9pt
57
57
  heading.h3.below = 0.65em
@@ -122,8 +122,8 @@ divider.stroke = 0.4pt
122
122
  | 装置 | 字号 | 其它 | 实现位置 |
123
123
  | :--- | :--- | :--- | :--- |
124
124
  | 正文 | 11pt | `ink` 色 | 两条链路的 `set text` |
125
- | 一级标题(章) | 15pt | 粗体;编号 `muted`、标题 `thm`;下方 1.1pt `rule`;上 20pt / 下 12pt | 阅读版 `handout_prelude.typ`;填空版 vendored `lib.typ` |
126
- | 二级标题(节) | 12.5pt | 粗体,`def` 色;上 12pt / 下 0.85em | 同上 |
125
+ | 一级标题(章) | 15pt | 粗体;编号 `muted`、标题 `thm`;下方 1.1pt `rule`;上 24pt / 下 12pt | 阅读版 `handout_prelude.typ`;填空版 vendored `lib.typ` |
126
+ | 二级标题(节) | 12.5pt | 粗体,`def` 色;上 22pt / 下 0.85em | 同上 |
127
127
  | 三级标题 | 11.5pt | 粗体,`thm` 色;上 9pt / 下 0.65em | 同上 |
128
128
  | 封面 kicker | 10pt | 全大写,字距 3pt,`muted` | 同上 |
129
129
  | 封面标题 | 30pt | 粗体,字距 1.5pt,`thm` | 同上 |
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "scholia-notes",
3
- "version": "2.2.3",
4
- "contentHash": "sha256:a4387f0a1ff4b05d6fc288d81bfebfa67cba13981b123ddcf29712243d7a13c7",
3
+ "version": "2.2.4",
4
+ "contentHash": "sha256:a2996a352ec54b35350e9830e3a9063d4ae147324a48ab89efd10fe429e64f3b",
5
5
  "fileCount": 12,
6
6
  "files": [
7
7
  {
@@ -18,8 +18,8 @@
18
18
  },
19
19
  {
20
20
  "path": "SKILL.md",
21
- "sha256": "a4387f0a1ff4b05d6fc288d81bfebfa67cba13981b123ddcf29712243d7a13c7",
22
- "size": 19515,
21
+ "sha256": "a2996a352ec54b35350e9830e3a9063d4ae147324a48ab89efd10fe429e64f3b",
22
+ "size": 20183,
23
23
  "mode": "0644"
24
24
  },
25
25
  {
@@ -36,8 +36,8 @@
36
36
  },
37
37
  {
38
38
  "path": "references/format-spec.md",
39
- "sha256": "f03c8b21ad4232584e9ba1acefc17d2a9570b85355c7c22daa6e4d0b689832d0",
40
- "size": 16151,
39
+ "sha256": "3469f655d3380757d285d332c509e7e6d03efa409d41bde2e3854a0a4e089fcd",
40
+ "size": 19405,
41
41
  "mode": "0644"
42
42
  },
43
43
  {
@@ -48,8 +48,8 @@
48
48
  },
49
49
  {
50
50
  "path": "references/prelude.typ",
51
- "sha256": "15c6ae717654e431cf27432abd38f218266be2b3d8a9f2210b90c264f4d7b908",
52
- "size": 5014,
51
+ "sha256": "6228e56d184d2ab79f126d599d25a897bdff33ea1ab2116796aea0a9a4f0cceb",
52
+ "size": 6227,
53
53
  "mode": "0644"
54
54
  },
55
55
  {
@@ -72,7 +72,7 @@
72
72
  },
73
73
  {
74
74
  "path": "references/typography-spec.md",
75
- "sha256": "847219f6f8e8012a538fc9960c2ce0f3fa52aed15d0ee59efc6c3ef7149f9a43",
75
+ "sha256": "1151b53bab4520b6d1cef55eb0338150ca3fda1901b22a4a6dc083f50b2d4dc5",
76
76
  "size": 18006,
77
77
  "mode": "0644"
78
78
  }
@@ -236,7 +236,16 @@ zju_check_note(file_path="<讲义文件的路径>", fix=true)
236
236
  | :--- | :--- | :--- |
237
237
  | 例题 | `[例] 例 1:题目 —— 正文` | `#### 例 1:…`、`**例 1:**…` |
238
238
  | 定理 / 定义 | `[定理] 留数定理 —— …`、`[定义] 留数 —— …` | `**定理**:…`、`**定义**:…` |
239
- | 证明 | `[证明] …`(斜体 Proof. + 行末小方块) | `**证明(…)**` |
239
+ | 证明 | `[证明] …`(斜体 Proof. + **块末**小方块) | `**证明(…)**` |
240
+
241
+ **标记是「块」的开头,不是一行**:`[定理]` / `[定义]` / `[例]` / `[证明]` 会一直排版到
242
+ 下一个标记、下一个标题或整行粗体的伪标题为止 —— 定理里的块级公式、例题的解法段落、
243
+ 证明的整段推导,直接写在标记下面(空行就是段落分隔),不用另起标记。
244
+ `[证明]` 的小方块因此落在**块内最后一行**:证明要写到真正的结尾,
245
+ 不要把结论另起一段写在标记外面(否则方块停在半路,读者会以为证明已经结束)。
246
+ `[直觉]` / `[练习]` / `[边注]` / `[强调]` 只吃标记行那一句。
247
+ 复习版例题的「题目 / 切入点 / 关键步骤 / 易错点」即使写在同一段里,排版时也会各自
248
+ 断段(标签紧跟句末标点即可),不必为了分行多敲空行。
240
249
 
241
250
  其余标记(都用得上才写,别滥用):
242
251
 
@@ -288,6 +297,9 @@ zju_check_note(file_path="<讲义文件的路径>", fix=true)
288
297
  - 题干 + 答案;答案用多行 `<details>` 折叠,方便先做后看
289
298
  ```
290
299
 
300
+ - 自测题的 PDF 版式:**题干会排成琥珀方框**(标签「自测题 n」,`**1.**` 这类手写编号
301
+ 由方框接管),`<details>` 里的答案排在**框外**(淡灰左线 + 「答案」标签)——
302
+ 所以题干与 `<details>` 之间只留一个空行,不要把答案写进题干同一段。
291
303
  - 结构服务于复习,**不是八股**:某节没有例题就写「本节无例题」,不要硬编题;内容少时合并。
292
304
  - 模板里的 `一、二、` 是给人读的;PDF 会自动编号并把这类手写前缀剥掉。
293
305
  - 不要把公式规范再抄一遍到讲义末尾——规范是写给生成过程的,不是交付物。
@@ -1,13 +1,13 @@
1
1
  {
2
2
  "name": "zju-lecture-summarizer",
3
- "version": "2.2.3",
4
- "contentHash": "sha256:27a6de1833a9c9f07c24638d8f203b97f375650e3f9eb2da8ce81b6dbb8938ff",
3
+ "version": "2.2.4",
4
+ "contentHash": "sha256:1a0bfd803ef9ecd27932b8de1a8fb23c1ff48cc991c346c0d5de43aa2741184b",
5
5
  "fileCount": 2,
6
6
  "files": [
7
7
  {
8
8
  "path": "SKILL.md",
9
- "sha256": "27a6de1833a9c9f07c24638d8f203b97f375650e3f9eb2da8ce81b6dbb8938ff",
10
- "size": 20889,
9
+ "sha256": "1a0bfd803ef9ecd27932b8de1a8fb23c1ff48cc991c346c0d5de43aa2741184b",
10
+ "size": 22044,
11
11
  "mode": "0644"
12
12
  },
13
13
  {