dsh-zju-lecture-note 2.1.0 → 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 (47) hide show
  1. package/ATTRIBUTION.md +20 -12
  2. package/CHANGELOG.md +204 -0
  3. package/README.md +299 -274
  4. package/docs/technical.md +118 -57
  5. package/lib/client.js +96 -11
  6. package/lib/index.js +54 -16
  7. package/lib/tools.js +26 -3
  8. package/lib/tools.schema.json +26 -3
  9. package/mcp_server.py +152 -20
  10. package/package.json +2 -2
  11. package/skills/scholia-notes/README.md +2 -1
  12. package/skills/scholia-notes/SKILL.md +62 -48
  13. package/skills/scholia-notes/THIRD_PARTY_NOTICES.md +29 -23
  14. package/skills/scholia-notes/references/api.md +17 -1
  15. package/skills/scholia-notes/references/format-spec.md +116 -106
  16. package/skills/scholia-notes/references/prelude.typ +51 -0
  17. package/skills/scholia-notes/references/starter.typ +3 -0
  18. package/skills/scholia-notes/references/style.md +27 -52
  19. package/skills/scholia-notes/references/troubleshooting.md +16 -69
  20. package/skills/scholia-notes/references/typography-spec.md +340 -0
  21. package/skills/scholia-notes.manifest.json +27 -21
  22. package/skills/zju-lecture-summarizer/SKILL.md +45 -10
  23. package/skills/zju-lecture-summarizer.manifest.json +4 -4
  24. package/zju_lecture/client.py +741 -741
  25. package/zju_lecture/fonts/FONT-NOTICE.md +24 -17
  26. package/zju_lecture/fonts/NotesKaiSC-Subset.ttf +0 -0
  27. package/zju_lecture/fonts/OFL-Kai.txt +94 -0
  28. package/zju_lecture/handout.py +390 -93
  29. package/zju_lecture/handout_prelude.typ +85 -32
  30. package/zju_lecture/note_lint.py +88 -2
  31. package/zju_lecture/prelude.typ +51 -0
  32. package/zju_lecture/study_notes.py +852 -115
  33. package/zju_lecture/typst-packages/VENDORED.md +11 -2
  34. package/zju_lecture/typst-packages/preview/noteworthy/0.4.0/LICENSE +20 -20
  35. package/zju_lecture/typst-packages/preview/noteworthy/0.4.0/lib.typ +128 -128
  36. package/zju_lecture/typst-packages/preview/noteworthy/0.4.0/typst.toml +15 -15
  37. package/zju_lecture/typst-packages/preview/scholia/0.1.0/src/fonts.typ +16 -4
  38. package/zju_lecture/typst-packages/preview/scholia/0.1.0/src/lib.typ +7 -7
  39. package/zju_lecture/typst-packages/preview/scholia/0.1.0/src/theorems.typ +2 -2
  40. package/zju_lecture/typst-packages/preview/showybox/2.0.4/LICENSE +21 -21
  41. package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/func.typ +142 -142
  42. package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/id.typ +11 -11
  43. package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/pre-rendering.typ +50 -50
  44. package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/sections.typ +141 -141
  45. package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/shadows.typ +118 -118
  46. package/zju_lecture/typst-packages/preview/showybox/2.0.4/showy.typ +267 -267
  47. package/zju_lecture/typst-packages/preview/showybox/2.0.4/typst.toml +11 -11
package/ATTRIBUTION.md CHANGED
@@ -77,9 +77,13 @@ Markdown → Typst 直排模板,**不 import 任何 Typst Universe 包**,也
77
77
 
78
78
  ## v1.6.0 新增:填空式学习笔记链路(`skills/scholia-notes/`)
79
79
 
80
+ **口径**:填空式学习笔记是**基于 Typst scholia 模板排版**的产物;配色与段落规范由本项目定义,
81
+ 见 scholia-notes 规范(`skills/scholia-notes/references/typography-spec.md`)。
82
+ 上游包的版权归其作者所有;本项目与上游作者无隶属关系、未获背书。
83
+
80
84
  | 项目 | 许可 | 版权人 | 说明 |
81
85
  | :--- | :--- | :--- | :--- |
82
- | [`@preview/scholia`](https://typst.app/universe/package/scholia) | MIT | [Eric Yang](https://github.com/Eryc123Y)(杨星宇) | 填空式学习笔记的排版引擎(knot / note / 右边栏 / 封面)。**v2.1.0 起随本仓库分发(vendored)**:`zju_lecture/typst-packages/preview/scholia/0.1.0/`,保留 `LICENSE` 与 `typst.toml`,只删除 README 与模板示例。 |
86
+ | [`@preview/scholia`](https://typst.app/universe/package/scholia) | MIT | [Eric Yang](https://github.com/Eryc123Y)(杨星宇) | 基于 Typst scholia 模板排版的填空式学习笔记的排版引擎(knot / note / 右边栏 / 封面)。**v2.1.0 起随本仓库分发(vendored)**:`zju_lecture/typst-packages/preview/scholia/0.1.0/`,保留 `LICENSE` 与 `typst.toml`;删除文档,并对 `src/fonts.typ` / `src/lib.typ` 打补丁(见 `VENDORED.md`)。 |
83
87
  | [`@preview/frame-it`](https://typst.app/universe/package/frame-it) | MIT | Marc Thieme | scholia 的 knot 底层(figure + 原生 label 交叉引用)。随仓库分发,保留 `LICENSE`。 |
84
88
  | [`@preview/marginalia`](https://typst.app/universe/package/marginalia) | UNLICENSE | 公有领域 | scholia 的右边栏边注。随仓库分发,保留 `UNLICENSE`。 |
85
89
  | [`@preview/theoretic`](https://typst.app/universe/package/theoretic) | UNLICENSE | 公有领域 | noteworthy 的定理底层;随仓库分发,保留 `UNLICENSE`。 |
@@ -89,14 +93,18 @@ Markdown → Typst 直排模板,**不 import 任何 Typst Universe 包**,也
89
93
 
90
94
  > **v2.1.0 起,6 个 `@preview` 包已 vendor 进 `zju_lecture/typst-packages/`**,用于离线编译。
91
95
  > MIT 的「保留版权声明与许可全文」义务由此触发,已逐包保留 `LICENSE`;Unlicense 包保留 `UNLICENSE`。
92
- > 修改范围仅限**删除文档**(README / template / tests),代码、`typst.toml` 与许可文件逐字节保持上游原样。
93
- > 逐包版本见 `zju_lecture/typst-packages/VENDORED.md`。
96
+ > 删除范围是文档(README / template / tests);另外 `@preview/scholia` 的
97
+ > `src/fonts.typ` / `src/lib.typ` 由本项目打了补丁(字体表改为可再分发栈、
98
+ > 二/三级标题字号统一、边注段距补 0.4em),补丁在
99
+ > `tools/vendor_typst_packages.py` 里可重放,逐条记录见
100
+ > `zju_lecture/typst-packages/VENDORED.md`。
94
101
 
95
- **随包中文字体**(v2.1.0):
102
+ **随包中文字体**(v2.1.0 起 Serif,v2.2.0 起 Kai):
96
103
 
97
104
  | 项目 | 许可 | 版权人 | 说明 |
98
105
  | :--- | :--- | :--- | :--- |
99
106
  | Noto Serif SC → `Notes Serif SC` | SIL OFL 1.1 | Copyright 2012 Google Inc.;字体内部 © 2017-2023 Adobe | GB2312 + 常用符号子集(约 7.5k 字),保留 `wght` 变量轴。已改名以避免与本机完整字体冲突;`zju_lecture/fonts/OFL.txt` 与 `FONT-NOTICE.md` 必须随包分发。 |
107
+ | LXGW WenKai(霞鹜文楷)→ `Notes Kai SC` | SIL OFL 1.1 | Copyright 2021-2026 LXGW;上游还包含 Copyright 2020 The Klee Project Authors | GB2312 子集(约 3.6 MB),**上游有 Reserved Font Name,因此必须改名**;`zju_lecture/fonts/OFL-Kai.txt` 与 `FONT-NOTICE.md` 必须随包分发。 |
100
108
 
101
109
  **Typst 二进制**(不随仓库分发):
102
110
 
@@ -127,15 +135,15 @@ Typst 编译 PDF 时会内嵌并子集化用到的字体。上游 `scholia` 的
127
135
 
128
136
  - **阅读版讲义**(`handout_prelude.typ`,默认 PDF 链路)**默认就用可再分发的字体栈**:
129
137
  `STIX Two Text` → Typst 内嵌的 `Libertinus Serif`,标题同理,mono 用
130
- `DejaVu Sans Mono`,中文优先 `Noto Serif SC` / `Source Han Serif SC`(皆 OFL)。
131
- 默认产物不内嵌任何商业字体,可以直接对外分享。想在本机还原上游观感,
132
- 模板里留了一份注释掉的 local 字体栈 —— 那种 PDF 不要再分发。
133
- - **填空笔记**走上游包:`fonts:` 覆盖能改 `body` / `math` / `heading` / `sans`,
134
- 但进不去 `note` / `sidenote` / `label-it`(这三个直接读包内 `default-fonts`)。
135
- 所以 `zju_build_study_notes` 的 PDF 里嵌了哪些字体,取决于本机装了什么;
136
- 要彻底可控只能 vendor 上游包并改 `src/fonts.typ`(届时须保留上游 MIT 声明)。
138
+ `DejaVu Sans Mono`,中文优先随包 `Notes Kai SC` / `Notes Serif SC`,再退
139
+ `Noto Serif SC` / `Source Han Serif SC`(皆 OFL)。默认产物不内嵌任何商业字体,
140
+ 可以直接对外分享。想在本机还原上游观感,模板里留了一份注释掉的 local 字体栈 ——
141
+ 那种 PDF 不要再分发。
142
+ - **填空笔记**的 vendored `scholia` 已 patch `src/fonts.typ` 的 `default-fonts`:
143
+ `note` / `sidenote` / `label-it` 不再直接读商业字体,而是跟随同一套可再分发栈;
144
+ 补丁由 `tools/vendor_typst_packages.py` 重放,记录在 `VENDORED.md`。
137
145
  `skills/scholia-notes/SKILL.md` 与 `references/troubleshooting.md` 给出了
138
- 「对外分发前换成 STIX Two」的覆盖写法与 `pdffonts` 核对方法。
146
+ `pdffonts` 核对方法。
139
147
 
140
148
  配色方面:**浅色主题(`soft-palette`)是本项目自定义的**,色值由
141
149
  `zju_lecture/prelude.typ` 定义、`tools/sync_palette.py` 同步到讲义模板与 Python 侧;
package/CHANGELOG.md CHANGED
@@ -3,6 +3,210 @@
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
+
47
+ ## 2.2.3 — 2026-11-04
48
+
49
+ 按又一次真实上课(`session-5415d8a5`,sub_id 1990907)里「工具没错、但 Agent 得替它
50
+ 擦屁股」的地方收口。回归钉在 `tests/test_session_5415d8a5.py`。
51
+
52
+ - **`\qquad` / `\quad` 排成真间距**:以前映射成两个空格,Typst 会把空格折叠掉,
53
+ 四条麦克斯韦方程挤成 `0∇×H` 这种像乘法的东西;Agent 只好自己写
54
+ `.tmp_split_display.py` 把 28 个公式块拆开、再重排两份 PDF。现在
55
+ `\qquad` → `wide`(2em)、`\quad` → `quad`(1em)、`\,` → `thin`、`\;` → `med`,
56
+ 并保持转换幂等。
57
+ - **行内 `$1/r$` 不再顶高行距**:行内数学把 `/` 排成平排的 `slash`
58
+ (`1 slash r`),独占一行的 `$$…$$` 仍排上下分式。此前 Agent 手改 4 处成 `r^{-1}`。
59
+ - **含公式的行不再拥挤**:Typst 的行内数学盒子高度是固定值(11pt 下 ≈0.68em,
60
+ `measure($frac(1,2)$)` 与 `measure($x$)` 都是 7.51pt),分式的分子/分母、根式、
61
+ 大算子的上下限会溢出盒子、压到邻行(实测重叠 1–4pt),`par.leading` 管不到。
62
+ 现在两处显式留白:模板的 `#show math.equation.where(block: false)` 给每个行内
63
+ 公式补上 `0.12em` / 下 `0.10em`;`pad_inline_math()` 再给分式/根式/矩阵/大算子
64
+ 包一层 `#box(inset: (bottom: 0.30em))`。同一份讲义实测:行间 < 2pt 的行对
65
+ 37 → 15,最差一处 −3.74pt(重叠)→ +1.19pt,纯文字行的行距一点没动。
66
+ 数值进 `typography-spec.md` §3.2,两条链路由 `tests/test_typography_unified.py` 绑定。
67
+ - **引用块不再印出字面量 `>`**:Typst 没有 `>` 引用语法,旧实现把 `>` 原样写进
68
+ PDF,还把抬头三个字段粘成「时长:约 01:40:16 上课时间:未提供…」。现在两条链路
69
+ 都渲染成左侧细线 + 灰色小字块,`**字段**:` 之间自动换行(`#quoted[…]`)。
70
+ - **`bare_imaginary_unit` 不再误报电流**:只有出现复数语境(`i^2`、`e^{iθ}`、
71
+ `\pm i`、复数 / 虚部 / 相量等用语)时才报;LC 回路里的 `i = -q_0ω_0 sin(…)`
72
+ 不再逼 Agent 把物理量改成 `\mathrm{i}`。
73
+ - **方框预算按最小小节统计**:`## 二、分章详解` 下挂 7 个 `### 2.x` 时逐 `2.x` 计数,
74
+ 不再把整章 9 个框算成「一节超预算」(Agent 为此纠结过一大段)。
75
+ - **新增 `zju_build_study_notes(mode="patch")`**:`edits=[{old, new}, …]` 一次写回
76
+ 十几处挖空 / 标记,逐条报告命中与未命中;`old` 默认要求唯一命中(重复时加
77
+ `"all": true`)。此前 35 步里有 12 步是一条一条改底稿。
78
+ - 顺带收紧投影抓取的失败文案:`ZJU_COOKIE_FILE` 的建议不再在 5 行报错里出现两次。
79
+ - **列表序号之间留出呼吸**:`-` 与 `1.` 的相邻条目间距 0.3em → **0.7em**
80
+ (两条链路同一组参数,`list.spacing` / `list.indent` 进 `typography-spec.md`
81
+ 的机器可读块);原来相邻条目几乎粘在一起。版式规范与实现由
82
+ `tests/test_typography_unified.py` 绑定。
83
+
84
+ ## 2.2.2 — 2026-11-04
85
+
86
+ 修一次真实上课(sub_id 1990907,大学物理·麦克斯韦方程组)里暴露的**多余手工操作**:
87
+ PDF 因两个没映射的 LaTeX 符号直接跳过,Agent 手改 Markdown;填空底稿的每节空占位
88
+ 要删改近 20 次;`---` 被排成孤立「–」,Agent 写通配脚本清理时误伤旧讲义。
89
+ 回归钉在 `tests/test_session_7402719b.py`。
90
+
91
+ - **补上 `\perp` / `\leftrightarrow` 等关系符号**:`zju_write_note` 首次排版返回
92
+ `PDF 跳过: error: unknown variable: leftrightarrow`,`note_lint` 还对 `\perp`
93
+ 报「没有 Typst 对应写法」。现在两者都映射为 `⊥` / `↔`,并补齐常用双向箭头、
94
+ `\parallel`、`\nparallel`、`\hookrightarrow`、`\doteq` 等;`latex_unmapped`
95
+ 自然消失。
96
+ - **斜杠分式归一化**:`\partial D/\partial t`、`\mathrm{d}i/\mathrm{d}t`、
97
+ `\sqrt{\mu_0/\varepsilon_0}` 在渲染层转成 `\frac{…}{…}`,不再需要 Agent
98
+ 写脚本逐条替换;只处理明确的微分/根式,不动普通 `a/b`。
99
+ - **修 `bare_imaginary_unit` 误报**:`$L\frac{\mathrm{d}i}{\mathrm{d}t}$` 里的
100
+ `i` 是电流,不是虚数单位;负向后行断言把 `}` 也排除,不再逼 Agent 把电流改成
101
+ `\mathrm{i}`(那会把物理量改错)。
102
+ - **填空底稿不再逐节塞空占位**:`build_draft` 以前在每节插
103
+ `[直觉](用一句人话解释…)` / `[练习](留给读者自己重做的一题)` /
104
+ `[边注](一个主动回忆问题)`,实地会话为此花了近 20 次编辑。现在只保留原文,
105
+ 文件头留一条 HTML 注释说明可选装置;加不加、加在哪儿由内容判断。
106
+ - **`---` 水平分隔线不再变成孤立「–」**:`render_typst` 现在把独占一行的
107
+ `---` 映射成 `#divider`(与 `[分隔]` 同款细线)。此前 Agent 只能写
108
+ `知识总结*.md` 通配脚本删分隔线,误伤了另外两份旧讲义;Skill 也补了
109
+ 「不要用通配批量改讲义」。
110
+ - **小节标题后的间距加大**:一级标题下 8pt → 12pt,二级标题下 0.5em → 0.85em,
111
+ 三级标题下 0.4/0.5em → 0.65em;两条 PDF 链路同步(改 vendored scholia 补丁)。
112
+ 规范机器可读块新增 `heading.h{1,2,3}.above/below`,测试逐项比对。
113
+ - **新增主界面左栏入口**:`lib/client.js` 增加 `sidebar.panellist` 一行「智云讲义」
114
+ (`id: zju-lecture`,order 30,排在「插件」「自动化任务」之后),点开在**主区域**
115
+ 渲染与「设置 → 浙大智云课堂讲义」完全相同的页面——同一个 `PipelineSettings`
116
+ 控制器、同一份配置,设置弹窗里的那一栏保留。折叠态只显示 `currentColor` 的 SVG
117
+ 图标,页首按 `--dsh-frame-top-clearance` 让出窗口标题栏。回归钉在
118
+ `tests/test_sidebar_entry_v222.py` 与 `tests/client_settings_smoke.mjs`。
119
+ - 版本 2.2.1 → 2.2.2(六处对齐,两个 Skill 清单重新生成)。**尚未发布**。
120
+
121
+ ## 2.2.1 — 2026-11-04
122
+
123
+ 修一次真实上课(sub_id 1990049,89 步)暴露的**自相矛盾**:工具和文档各说各话,
124
+ Agent 只好拿 50 步去猜;同批把方框标签的字体层次找回来。回归钉在
125
+ `tests/test_session_d0cfd0ac.py` 与 `tests/test_box_style_v221.py`。
126
+
127
+ - **底稿契约统一成「纯 Markdown + LaTeX」**:`zju_build_study_notes(mode=draft)`
128
+ 以前会把公式改写成 Typst(`frac(…)` / `cal(…)`)、把表格写成 `#table(…)`、
129
+ 把有序列表写成 `+`,而工具自己的提示、`SKILL.md`、`format-spec.md` 都说
130
+ 「公式写 LaTeX,工具会转」——模型照着文档补 LaTeX,第二次转换就把已经转好的
131
+ `frac` / `cal` 逐字母拆成 `f r a c` / `c a l`,编译报 `unknown variable`。
132
+ 现在 `draft` 只搬运结构,**转换只在 `compile` 做一次**。
133
+ - **LaTeX → Typst 转换变成幂等的**:`_plain_word` 认识转换器自己会产出的名字
134
+ (`frac` / `cal` / `sum` / `quad` / `cdots`…),引号串(`"Res"`、`"d"`)原样搬运。
135
+ 以前 `latex_to_typst(latex_to_typst(x)) ≠ latex_to_typst(x)`,一次误转就毁一份公式。
136
+ - **补齐 Markdown 结构映射**:`render_typst` 新增 GFM 表格(→ `#table(…)`)、
137
+ 无序/有序列表(→ Typst 列表)、`**粗体**`(→ `*粗体*`)三个分支。
138
+ 此前表格只在 `draft` 转、`render_typst` 不认,底稿里的 `#table(` 会被当正文
139
+ 转义成 `\[…\]`;`**` 会触发 `warning: no text within stars`,加粗失效。
140
+ - **行内代码不再转义**:`` `[00:20]` `` 曾变成 `` `\[00:20\]` `` 印在 PDF 里;
141
+ 反引号在 Typst 是 raw,内容原样输出才对。
142
+ - **补上掉的数学符号**:`\triangleq`(Typst 没有这个符号,曾让整份 PDF 失败)→ `≙`;
143
+ `\not\to` / `\not=` 等前缀否定 → `↛` / `≠`(以前直接印成 "not →")。
144
+ - **「检查通过」和「PDF 能编译」不再打架**:`note_lint` 新增 `latex_unmapped` 规则,
145
+ 命令表取自转换器自己的 `supported_latex_commands()`,行内与块级公式都查。
146
+ `zju_write_note` 返回 `PDF 跳过` 时多给一句可执行下一步(改完再
147
+ `zju_check_note(pdf=true)` 重排一次)。
148
+ - **填空笔记 PDF 落在底稿同目录**:以前只在 `*-typst/out.pdf`,Agent 每次得手动
149
+ `cp` 才交得出来;现在同时写 `<底稿名去掉 -填空底稿>.pdf`,工具直接返回该路径。
150
+ - **方框标签换成无衬线(两条链路一起)**:`Definition 1.1` / `Theorem 2.1` /
151
+ `Example` / `Your turn.` 原先用的是 `heading`(衬线 + 楷体),和正文糊在一起,
152
+ 看不出「这是一个框」。现在标签走 `sans`:`Noto Sans` → `Liberation Sans` →
153
+ `DejaVu Sans`,中文仍回 `Notes Kai SC`。上游用 Optima(也是无衬线),这条是
154
+ 把被字体补丁改丢的层次找回来。**没有**把 `Noto Sans SC` 放进栈里:本机那份是
155
+ 可变字体,Typst 只取到 Thin(`pdffonts` 里是 `NotoSansSC-Thin`),中文会发灰。
156
+ - **「伪方框」检查**:`note_lint` 新增 `pseudo_box`。把例题/定理/证明写成
157
+ `#### 例 1:…` 或 `**证明(…)**` 时,PDF 里只会是小标题/粗体 —— 实测一份
158
+ 3.5 万字的讲义因此整页没有一个框。现在检查器会点名,并给出 `[例] 标题 —— 正文`
159
+ 的改法;讲义 Skill 与系统提示同步补了对照表。
160
+ - **填空笔记不再覆盖阅读版 PDF**:`<讲义名>-填空底稿.md` 编译出的 PDF 曾落到
161
+ `<讲义名>.pdf`,正好把刚排好的阅读版覆盖掉;现在自动底稿输出
162
+ `<讲义名>-填空.pdf`,手写底稿保持同名。
163
+ - 系统提示与 `SKILL.md` / `format-spec.md` / `docs/technical.md` 同步口径:
164
+ 底稿只补占位符、不要重写全文,公式保持 LaTeX。
165
+ - 版本 2.2.0 → 2.2.1(六处对齐,两个 Skill 清单重新生成)。
166
+
167
+ ## 2.2.0 — 2026-11-03
168
+
169
+ - **两条 PDF 链路统一到同一套排版**:阅读版讲义与填空笔记现在共用 30pt 封面标题 /
170
+ 10pt kicker / 13pt 副标题 / 11pt 作者 / 9pt 日期、15 / 12.5 / 11.5pt 三级标题、
171
+ 2.4 / 3.9 / 2.0 / 2.3cm 版心、2.6cm 边注栏(与版心间距 0.7cm)、
172
+ 0.82em / 0.5em 边注;直觉块首行**不缩进**(按参考图口径),正文段首仍空两格。
173
+ 实测两份 PDF 的正文左/右边界与边注左边界一致(误差 ≤ 2pt)。
174
+ - **随包 `Notes Kai SC`(OFL 楷体)**:`zju_lecture/fonts/NotesKaiSC-Subset.ttf`
175
+ 是 LXGW WenKai(霞鹜文楷 v1.530)的 GB2312 子集,约 3.6MB;上游有 Reserved
176
+ Font Name,因此**改名**。两条链路的中文首选都是它,复现参考图的楷体观感,
177
+ 且不再把 Windows 的 KaiTi 子集嵌进 PDF。`OFL-Kai.txt` 与 `FONT-NOTICE.md`
178
+ 随包分发;`tools/build_font_subset.py` 现在可一次生成 Serif / Kai 两个子集。
179
+ - **vendored scholia 打补丁**:`src/fonts.typ` 的 `default-fonts` 改为可再分发栈
180
+ (移除 Optima / Avenir Next / Menlo / Songti SC),`src/lib.typ` 统一二级/三级
181
+ 标题字号与边注段距。补丁在 `tools/vendor_typst_packages.py` 里可重放,
182
+ `VENDORED.md` 如实记录;`--check` 会验证补丁已生效。
183
+ - **规范去重**:重写 `skills/scholia-notes/references/typography-spec.md` 为
184
+ 唯一排版真相源(含机器可读的 `typography-params` 块);`format-spec.md` /
185
+ `style.md` / `api.md` / `docs/technical.md` / `SKILL.md` 的数值改为指向它。
186
+ 新增 `tests/test_typography_unified.py`(规范 ↔ 实现 ↔ 渲染几何 ↔ `pdffonts`),
187
+ `test_palette_sync.py` / `test_deps_v210.py` 扩展到 Kai 字体与 vendored 字体表。
188
+ - **文档口径**:填空式学习笔记统一表述为「基于 Typst scholia 模板排版的填空式学习笔记;
189
+ 配色与段落规范由本项目定义,见 scholia-notes 规范」。README / ATTRIBUTION /
190
+ THIRD_PARTY_NOTICES / docs/technical / SKILL / typography-spec 已同步。
191
+ - 版本 2.1.1 → 2.2.0(六处对齐,两个 Skill 清单重新生成)。
192
+
193
+ ## 2.1.1 — 2026-11-03
194
+
195
+ - **修复「设置全开还是只有字幕」的根因**:dsh 把 `.volatile()` 的 `Config` 字段投影成
196
+ 实时引用(`{ get() }`),插件却直接拿它和 `true` 比较——引用永远不等于 `true`,于是
197
+ `enableSlides` / `enableStudyNotes` / `enableLoginTools` / `embedSlideImages` 无论用户
198
+ 怎么保存都读成 `false`(`renderPdf` 因为写的是 `!== false` 反而一直是开)。新增
199
+ `readSetting()` 统一解包引用,`featureFlags()`、`timeoutMs`、`python`、`registerSkill`
200
+ 都走它;`tests/plugin_apply_smoke.mjs` 增加「ref 形状」用例,防止再退回。
201
+ - **讲义默认按「复习版」写**:系统提示与 Skill 不再把增强内容写成「可选/需要时」——
202
+ 例题按「题目 → 切入点 → 关键步骤 → 易错点」整理(本节没有就写「本节无例题」,
203
+ 不编题),文末给 3–5 道自测题(答案折叠)与 5–10 条考点预测。
204
+ - **开关打开即默认执行**:`enableSlides` → 写讲义前抓一次投影并挑 3–8 页;
205
+ `enableStudyNotes` → 写完讲义再出填空版。MCP 的 `initialize.instructions` 同步。
206
+ - **设置页口径改成真话**:保存只对新建会话生效,当前会话的工具集在开始时已固定;
207
+ 工具数标签从「本次会话注册」改为「当前配置注册」。
208
+ - 版本 2.1.0 → 2.1.1(六处对齐,两个 Skill 清单重新生成)。
209
+
6
210
  ## 2.1.0 — 2026-11-03
7
211
 
8
212
  - **PDF 装完即用(Typst 自举)**:新增 `zju_lecture/deps.py`,把「本机没装 Typst」从静默的