dsh-zju-lecture-note 2.2.5 → 2.2.6

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.
package/CHANGELOG.md CHANGED
@@ -3,6 +3,27 @@
3
3
  版本号在 `package.json`、`pyproject.toml`、`mcp_server.SERVER_VERSION`、
4
4
  `.minimax-plugin/plugin.json` 与四个 Skill manifest 八处对齐。
5
5
 
6
+ ## 2.2.6 — 2026-11-06
7
+
8
+ - **修复上下标里的符号名被逐字母拆开**(实地会话 `session-42baa52c` 的讲义截图):
9
+ `$29^{\circ}$` 排成 `29^(c o m p o s e)`,PDF 右上角直接印出单词 `compose`。
10
+ 同一类错误波及**所有**多字母符号名:`x^{\alpha}` → `(a l p h a)`、
11
+ `x_{\theta}` → `(t h e t a)`、`x^{\pi}` → `(p i)`。
12
+ 拆词规则现在只作用于**没转换过**的裸字母串(`a_{ij}` → `a_(i j)` 照旧),
13
+ Typst 自己认得的名字按 `_TYPST_BARE_NAMES` 原样放行。
14
+ - **`\circ` 在上下标里转成 `degree`**:LaTeX 的 `29^\circ` 是角度,不是复合运算
15
+ (`f\circ g` 仍是 `compose`)。不带花括号的写法也补括号——
16
+ `29^\circ`、`\sum_{n=1}^\infty` 现在都能正常排;`x_1` / `a_n` 保持原样。
17
+ - **`\left` / `\right` 不再吞分隔符**:`\left\lvert … \right\rvert`、
18
+ `\left\| … \right\|`、`\left\lVert … \right\rVert` 原先整段消失(绝对值与范数
19
+ 竖线没了),`\left.` 还会把那个点印进正文。顺带补上 `\lVert` / `\rVert` / `\|` 的映射。
20
+ - **尺寸命令静默丢弃**:`\big` / `\Big` / `\bigl` / `\Bigr` … 以前会印出单词 `big`;
21
+ `\%` 也不再被 `note_lint` 误报成「未映射的 LaTeX 命令」。
22
+ - 回归 `tests/test_script_symbols_v226.py`(19 条),其中两条是通则:
23
+ 「符号表里每个多字母值放进上下标都不许被拆」与「转换两遍 == 转换一遍」。
24
+ - 验证:652 tests OK(skipped=2);讲义 PDF 重排 0 error,页面上 `sin 29°`、
25
+ `(1+x)^α`、`|Δx/x₀|` 均正常。
26
+
6
27
  ## 2.2.5 — 2026-11-06
7
28
 
8
29
  - **默认安装即可用**:字幕鉴权改为核心链路的一部分。保留 `classroom.zju.edu.cn`,先匿名;
package/docs/technical.md CHANGED
@@ -404,6 +404,16 @@ v2.0.1 起,「字幕 → 讲义 → PDF」主链路与投影、填空笔记等
404
404
  - 数学转换是**幂等**的:`_plain_word` 认识转换器自己会产出的名字(`frac` / `cal` / `sum` /
405
405
  `quad` / `wide` / `slash` / `"Res"` …),所以 `latex_to_typst(latex_to_typst(x)) == latex_to_typst(x)`,
406
406
  不会被拆成 `s u m` / `f r a c`。引号串(`"Res"`)原样搬运,不再被二次加工。
407
+ - **上下标里的整体记号不拆**:`_typst_script` 只对「还没转换过的裸字母串」逐字母拆
408
+ (`a_{ij}` → `a_(i j)`、`u_{tt}` → `u_(t t)`);转换器自己产出的名字
409
+ (`alpha` / `theta` / `compose` / `degree` …)属于**一个**记号,按 `_TYPST_BARE_NAMES`
410
+ 原样放行。早先不加区分,`29^{\circ}` 排成 `29^(c o m p o s e)`,PDF 右上角直接印出单词
411
+ (实地会话 `session-42baa52c` 的截图);`x^{\alpha}`、`x_{\theta}` 同样中招。
412
+ `\circ` 出现在上下标里转 `degree`(`29^\circ` 是角度),`f\circ g` 仍是 `compose`;
413
+ 不带花括号的 `^\circ` / `^\alpha` 会补成 `^(…)`,`x_1` / `a_n` 保持原样。
414
+ - **`\left` / `\right` 的分隔符必须留下**:`\left\lvert` / `\left\|` / `\lVert` / `\rVert`
415
+ 分别落 `|` 与 `‖`,`\left.` / `\right.` 是不可见分隔符(早先会印出一个点);
416
+ `\big` / `\Big` / `\bigl` / `\Bigr` 这类尺寸命令静默丢弃,不印出单词 `big`。
407
417
  - 间距命令走 Typst 的真实间距:`\quad` → `quad`(1em)、`\qquad` → `wide`(2em)、
408
418
  `\,` → `thin`、`\;` → `med`。早先映射成空格,而 Typst 会折叠连续空格,
409
419
  于是「并排的两条公式」粘成 `0∇×H`(实地会话里 Agent 只能写脚本拆公式块)。
package/mcp_server.py CHANGED
@@ -96,7 +96,7 @@ from zju_lecture.study_notes import (
96
96
  )
97
97
 
98
98
  SERVER_NAME = "zju-lecture-mcp"
99
- SERVER_VERSION = "2.2.5"
99
+ SERVER_VERSION = "2.2.6"
100
100
  DEFAULT_TENANT = "112"
101
101
  DEFAULT_DOMAIN = "classroom.zju.edu.cn"
102
102
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-zju-lecture-note",
3
- "version": "2.2.5",
3
+ "version": "2.2.6",
4
4
  "description": "浙大智云课堂回放讲义插件(DeepSeek Harness 原生插件):以「语音字幕 + 本地课件」为主链路,写完讲义自动排版同名 PDF;可选启用投影 PPT 截图抓取、基于 Typst scholia 模板排版的填空式学习笔记与登录辅助工具;一键登录窗口让用户正常登录后自动安全保存登录态(Windows DPAPI),不回显、不进入对话、不保存密码",
5
5
  "license": "MIT",
6
6
  "author": "chenqianyu486",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "scholia-notes",
3
- "version": "2.2.5",
3
+ "version": "2.2.6",
4
4
  "contentHash": "sha256:a2996a352ec54b35350e9830e3a9063d4ae147324a48ab89efd10fe429e64f3b",
5
5
  "fileCount": 12,
6
6
  "files": [
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "zju-lecture-summarizer-help",
3
- "version": "2.2.5",
3
+ "version": "2.2.6",
4
4
  "contentHash": "sha256:4b240b3eb2e4d5d23947eebc6867cbb0d1f3d64ffcba6c6ce2dc346e7929b86f",
5
5
  "fileCount": 1,
6
6
  "files": [
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "zju-lecture-summarizer-login",
3
- "version": "2.2.5",
3
+ "version": "2.2.6",
4
4
  "contentHash": "sha256:8e077abdc6e0186b1ca253824adad30080a040a5dc2d8eb817fc6269e4f12010",
5
5
  "fileCount": 1,
6
6
  "files": [
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "zju-lecture-summarizer",
3
- "version": "2.2.5",
3
+ "version": "2.2.6",
4
4
  "contentHash": "sha256:7e8b14eee6f9fb3a6e7d73ec14f7a6ac10af865b630911ca1a2264afbadc59d9",
5
5
  "fileCount": 2,
6
6
  "files": [
@@ -387,10 +387,21 @@ _LATEX_SYMBOLS: Dict[str, str] = {
387
387
  "sup": '"sup"', "inf": '"inf"', "Pr": '"Pr"',
388
388
  # 省略号 / 竖排省略号(Typst 的符号名与 LaTeX 不同,这里直接给字符)
389
389
  "cdots": "dots", "vdots": "⋮", "ddots": "⋱",
390
- # 绝对值 / 范数 / 集合分隔
390
+ # 绝对值 / 范数 / 集合分隔。amsmath 的 `\lVert` / `\rVert` 与 `\|` 是范数
391
+ # 竖线,早先漏映射:`\lVert x \rVert` 直接印成 `lVert x rVert`,
392
+ # `\left\lVert … \right\rVert` 更惨,被 `\left` 分支整段吞掉(竖线消失)。
391
393
  "lvert": "|", "rvert": "|", "vert": "|", "mid": "|", "Vert": "‖",
394
+ "lVert": "‖", "rVert": "‖", "|": "‖",
392
395
  # 花括号本身在 Typst 数学里就是字面量,直接放行
393
396
  "{": "{", "}": "}",
397
+ # 定界符尺寸命令只是排版开关,后面的括号由正常流程输出;
398
+ # 不映射的话 `\big(` 会印出单词 `big`。
399
+ "big": "", "Big": "", "bigg": "", "Bigg": "",
400
+ "bigl": "", "bigr": "", "Bigl": "", "Bigr": "",
401
+ "biggl": "", "biggr": "", "Biggl": "", "Biggr": "",
402
+ "middle": "",
403
+ # 百分号:Typst 数学里 `%` 是合法符号,映射一下免得 note_lint 误报「未映射」
404
+ "%": "%",
394
405
  # 反斜杠 + 空格:LaTeX 的显式空格(`0,\ 1,\ 2`)
395
406
  " ": " ",
396
407
  # 长箭头
@@ -470,7 +481,7 @@ _TYPST_BARE_NAMES = (
470
481
  "mat", "cases", "quad", "wide", "thin", "med", "slash",
471
482
  "product", "integral", "sum", "dots",
472
483
  "overbrace", "underbrace", "overline", "underline",
473
- "hat", "tilde", "bar", "vec", "dot", "ddot", "compose",
484
+ "hat", "tilde", "bar", "vec", "dot", "ddot", "compose", "degree",
474
485
  })
475
486
  )
476
487
 
@@ -547,18 +558,41 @@ def _typst_script(content: str) -> str:
547
558
 
548
559
  内容先递归转换一遍:``a_{n=-\\infty}`` 里的 ``\\infty`` 不转换的话,
549
560
  到 Typst 那里就是一个不认识的变量名。
561
+
562
+ **逐字母拆词只针对「还没转换过的裸字母串」。** 转换器自己会产出
563
+ ``alpha`` / ``theta`` / ``compose`` 这类 Typst 名字,它们本身就是**一个**
564
+ 记号;早先不加区分地按 ``[A-Za-z]{2,}`` 拆,于是 ``29^{\\circ}`` 排成
565
+ ``(c o m p o s e)``、``x^{\\alpha}`` 排成 ``(a l p h a)`` —— PDF 的右上角
566
+ 直接印出单词(实地会话 session-42baa52c 的 ``sin 29^{compose}``)。
567
+ 判据就是 :data:`_TYPST_BARE_NAMES`:能裸写的名字不拆,其余照旧拆。
550
568
  """
551
569
  text, _ = latex_to_typst(content)
552
570
  text = text.strip()
553
571
  if not text:
554
572
  return "()"
555
- if re.fullmatch(r"[A-Za-z]{2,}", text):
573
+ if text == "compose":
574
+ # LaTeX 把 ``29^{\\circ}`` 当角度写,``\\circ`` 在上下标里就是度数符号。
575
+ # Typst 的 ``compose`` 是数学轴上的 ∘,``degree`` 才是 °。
576
+ text = "degree"
577
+ if re.fullmatch(r"[A-Za-z]{2,}", text) and text not in _TYPST_BARE_NAMES:
556
578
  return "(" + " ".join(text) + ")"
557
579
  # `=` 在上下标里补空格:Typst 对关系符号更宽容,但补上更稳。
558
580
  text = re.sub(r"\s*=\s*", " = ", text)
559
581
  return "(" + text + ")"
560
582
 
561
583
 
584
+ def _read_script_command(text: str, index: int) -> Tuple[Optional[str], int]:
585
+ """从 ``index`` 处读一个**不带花括号**的上下标记号(只认反斜杠命令)。
586
+
587
+ ``29^\\circ`` / ``\\sum_{n=1}^\\infty`` 里的记号没有花括号,Typst 侧要补一层
588
+ ``(...)`` 才不会被后面紧跟的字母粘住。返回 ``(记号的原文, 结束后的下标)``。
589
+ """
590
+ match = _LATEX_COMMAND_RE.match(text, index)
591
+ if not match:
592
+ return None, index
593
+ return text[index:match.end()], match.end()
594
+
595
+
562
596
  def _read_environment(
563
597
  text: str, index: int, name: str
564
598
  ) -> Tuple[Optional[str], int]:
@@ -805,17 +839,28 @@ def latex_to_typst(expression: str, inline: bool = False) -> Tuple[str, List[str
805
839
  continue
806
840
 
807
841
  if command in ("left", "right"):
808
- # `\left\{` / `\right\}` 是花括号字面量,必须保留转义。
842
+ # `\left⟨分隔符⟩ … \right⟨分隔符⟩` 里**分隔符本身要留下来**。
843
+ # 早先只认 `\{` / `\}`,其余分两种坏法:`\left\lvert`、
844
+ # `\left\|`、`\left\lVert` 被整段吞掉(绝对值 / 范数竖线消失),
845
+ # `\left.` 又把那个点的字面量印进 PDF。这里按符号表落字符,
846
+ # `\left.` / `\right.` 是不可见分隔符,直接跳过。
809
847
  if index < length and expression[index] == "\\":
810
848
  nxt = _LATEX_COMMAND_RE.match(expression, index)
811
849
  if nxt:
812
- if nxt.group(1) == "{":
813
- out.append("\\{")
814
- elif nxt.group(1) == "}":
815
- out.append("\\}")
850
+ name = nxt.group(1)
816
851
  index = nxt.end()
817
- else:
818
- index += 1
852
+ if name == ".":
853
+ continue
854
+ if name in ("{", "}"):
855
+ out.append("\\" + name)
856
+ continue
857
+ _emit(_LATEX_SYMBOLS.get(name, name), index)
858
+ continue
859
+ index += 1
860
+ continue
861
+ if index < length and expression[index] == ".":
862
+ index += 1
863
+ continue
819
864
  continue
820
865
 
821
866
  if command in _LATEX_FRACTIONS:
@@ -1074,6 +1119,19 @@ def latex_to_typst(expression: str, inline: bool = False) -> Tuple[str, List[str
1074
1119
  out.append(char + _typst_script(content))
1075
1120
  index = next_index
1076
1121
  continue
1122
+ # 不带花括号的命令:`29^\circ`、`x^\alpha`、`\sum_{n=1}^\infty`。
1123
+ # 只有反斜杠命令需要补括号;裸字母/数字(`x_1`、`a_n`)在 Typst 里
1124
+ # 本来就是一个记号,动了反而破坏既有输出、也会破坏幂等。
1125
+ if index + 1 < length and expression[index + 1] == "\\":
1126
+ token, after = _read_script_command(expression, index + 1)
1127
+ if token is not None:
1128
+ converted = latex_to_typst(token)[0].strip()
1129
+ if converted:
1130
+ if converted == "compose":
1131
+ converted = "degree"
1132
+ out.append(char + "(" + converted + ")")
1133
+ index = after
1134
+ continue
1077
1135
  out.append(char)
1078
1136
  index += 1
1079
1137
  continue
@@ -1645,7 +1703,7 @@ _TYPST_SAFE_WORDS = (
1645
1703
  "frac", "sqrt", "root", "mat", "cases", "cal", "frak", "bold",
1646
1704
  "upright", "op", "compose", "norm", "abs", "floor", "ceil", "round",
1647
1705
  "diag", "rank", "Res", "tr", "det", "lim", "max", "min", "sup", "inf",
1648
- "wide", "thin", "med", "slash",
1706
+ "wide", "thin", "med", "slash", "degree",
1649
1707
  })
1650
1708
  )
1651
1709