dsh-zju-lecture-note 2.2.3 → 2.2.5

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 (43) hide show
  1. package/CHANGELOG.md +102 -1
  2. package/README.md +98 -150
  3. package/SECURITY.md +136 -44
  4. package/docs/technical.md +175 -45
  5. package/lib/client.js +14 -13
  6. package/lib/index.js +53 -19
  7. package/lib/tools.js +28 -3
  8. package/lib/tools.schema.json +28 -3
  9. package/mcp_server.py +285 -34
  10. package/package.json +6 -2
  11. package/skills/scholia-notes/SKILL.md +8 -1
  12. package/skills/scholia-notes/references/format-spec.md +57 -6
  13. package/skills/scholia-notes/references/prelude.typ +55 -0
  14. package/skills/scholia-notes/references/typography-spec.md +4 -4
  15. package/skills/scholia-notes.manifest.json +9 -9
  16. package/skills/zju-lecture-summarizer/SKILL.md +56 -11
  17. package/skills/zju-lecture-summarizer-help/SKILL.md +95 -0
  18. package/skills/zju-lecture-summarizer-help.manifest.json +14 -0
  19. package/skills/zju-lecture-summarizer-login/SKILL.md +40 -0
  20. package/skills/zju-lecture-summarizer-login.manifest.json +14 -0
  21. package/skills/zju-lecture-summarizer.manifest.json +4 -4
  22. package/zju_lecture/__init__.py +16 -0
  23. package/zju_lecture/browser_login.py +923 -0
  24. package/zju_lecture/cli.py +98 -3
  25. package/zju_lecture/client.py +808 -741
  26. package/zju_lecture/handout.py +390 -60
  27. package/zju_lecture/handout_prelude.typ +47 -2
  28. package/zju_lecture/note_lint.py +12 -0
  29. package/zju_lecture/prelude.typ +55 -0
  30. package/zju_lecture/study_notes.py +415 -4
  31. package/zju_lecture/typst-packages/VENDORED.md +1 -1
  32. package/zju_lecture/typst-packages/preview/noteworthy/0.4.0/LICENSE +20 -20
  33. package/zju_lecture/typst-packages/preview/noteworthy/0.4.0/lib.typ +128 -128
  34. package/zju_lecture/typst-packages/preview/noteworthy/0.4.0/typst.toml +15 -15
  35. package/zju_lecture/typst-packages/preview/scholia/0.1.0/src/lib.typ +2 -2
  36. package/zju_lecture/typst-packages/preview/showybox/2.0.4/LICENSE +21 -21
  37. package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/func.typ +142 -142
  38. package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/id.typ +11 -11
  39. package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/pre-rendering.typ +50 -50
  40. package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/sections.typ +141 -141
  41. package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/shadows.typ +118 -118
  42. package/zju_lecture/typst-packages/preview/showybox/2.0.4/showy.typ +267 -267
  43. package/zju_lecture/typst-packages/preview/showybox/2.0.4/typst.toml +11 -11
package/mcp_server.py CHANGED
@@ -32,7 +32,16 @@ CURRENT_DIR = os.path.dirname(os.path.abspath(__file__))
32
32
  if CURRENT_DIR not in sys.path:
33
33
  sys.path.insert(0, CURRENT_DIR)
34
34
 
35
+ from zju_lecture.browser_login import (
36
+ LoginError,
37
+ clear_session,
38
+ load_session_cookie,
39
+ login_available,
40
+ open_login_window,
41
+ session_summary,
42
+ )
35
43
  from zju_lecture.client import (
44
+ TranscriptAuthError,
36
45
  ZJUAPIError,
37
46
  extract_classroom_token,
38
47
  fetch_slides,
@@ -87,7 +96,7 @@ from zju_lecture.study_notes import (
87
96
  )
88
97
 
89
98
  SERVER_NAME = "zju-lecture-mcp"
90
- SERVER_VERSION = "2.2.3"
99
+ SERVER_VERSION = "2.2.5"
91
100
  DEFAULT_TENANT = "112"
92
101
  DEFAULT_DOMAIN = "classroom.zju.edu.cn"
93
102
 
@@ -229,7 +238,12 @@ def server_instructions() -> str:
229
238
  """MCP initialize instructions, reflecting the current feature gates."""
230
239
  parts = [
231
240
  "提供浙大智云课堂(classroom.zju.edu.cn)回放的语音字幕与课件文本提取。"
232
- "字幕接口公开免登录。",
241
+ "字幕先匿名请求;401/403 时自动使用本机登录态重试一次,无需开启登录辅助工具。"
242
+ "本机没有可用登录态、或登录态已失效时,调用 zju_login(url=<这节课链接>) "
243
+ "打开独立登录窗口:用户只需在窗口里正常登录,窗口会自动关闭并把登录态安全保存在本机;"
244
+ "不要让用户打开开发者工具复制 Cookie,也不要索要 Cookie / 密码。",
245
+ "登录态来源顺序:进程缓存 → ZJU_COOKIE → ZJU_COOKIE_FILE → zju_login 保存的本机登录态 → 本机 Edge。"
246
+ "ZJU_COOKIE / ZJU_COOKIE_FILE 是高级兜底,存在且损坏时会挡住 zju_login。",
233
247
  "主链路:把链接或 sub_id 直接交给 zju_fetch_transcript(默认 per_minute;"
234
248
  "长课用 chunked;同一节课只抓一次,per_segment 仅在确实需要秒级时间戳时用)"
235
249
  "→ 可选 zju_extract_courseware → zju_write_note(自动命名、拒绝静默覆盖、"
@@ -247,7 +261,7 @@ def server_instructions() -> str:
247
261
  )
248
262
  else:
249
263
  parts.append(
250
- "投影抓取已关闭(ZJU_ENABLE_SLIDES=0):不读取登录态、不下载投影截图,"
264
+ "投影抓取已关闭(ZJU_ENABLE_SLIDES=0):不为投影读取登录态、不下载投影截图,"
251
265
  "zju_fetch_slides 不在工具列表里。需要时在 dsh 插件设置里打开"
252
266
  "「启用 PPT 投影抓取」(enableSlides),或设置 ZJU_ENABLE_SLIDES=1 后重启。"
253
267
  )
@@ -262,14 +276,18 @@ def server_instructions() -> str:
262
276
  "普通讲义 PDF 不受影响。"
263
277
  )
264
278
  if login_tools_enabled():
265
- parts.append("视频直链与浏览器登录态工具已注册;登录 Cookie 只在服务端内存,不回显。")
279
+ parts.append(
280
+ "登录辅助工具已开启:视频直链与浏览器登录态工具已注册;"
281
+ "字幕鉴权属于核心链路,匿名被拒时会自行读取本机登录态,不依赖本开关。"
282
+ )
266
283
  else:
267
284
  parts.append(
268
285
  "登录辅助工具已关闭(ZJU_ENABLE_LOGIN_TOOLS=0):视频直链与浏览器登录态工具不注册;"
269
- "投影抓取仍会自行解析登录态。"
286
+ "字幕鉴权仍由核心链路自动完成,投影抓取也自行解析登录态。"
270
287
  )
271
288
  parts.append(
272
- "任何工具都不接受也不回显 Cookie 明文;登录态只能来自本地配置或本机 Edge。"
289
+ "任何工具都不接受也不回显 Cookie 明文;登录态只来自本机配置、zju_login 保存的"
290
+ "本机登录态或本机 Edge,绝不进入对话与工具参数。"
273
291
  + slide_image_mode_text()
274
292
  )
275
293
  return "".join(parts)
@@ -314,10 +332,14 @@ def _resolve_cookie() -> Tuple[Optional[str], Optional[str], Optional[str], Opti
314
332
  """Return ``(cookie, error_message, source, reason)``.
315
333
 
316
334
  Source order: in-memory cache → ``ZJU_COOKIE`` → ``ZJU_COOKIE_FILE`` →
317
- local Edge. The error text is actionable and never contains a cookie
318
- value. ``reason`` is a machine-readable code (``abe`` / ``locked`` /
319
- ``no_rows`` / ``env_invalid`` …) so a caller can print exactly one
320
- conclusion instead of a list of maybes.
335
+ the session saved by ``zju_login`` → local Edge. Explicit host
336
+ configuration wins; otherwise the one-click login window is preferred over
337
+ the browser database because ABE can make Edge unreadable.
338
+
339
+ The error text is actionable and never contains a cookie value. ``reason``
340
+ is a machine-readable code (``abe`` / ``locked`` / ``no_rows`` /
341
+ ``env_invalid`` …) so a caller can print exactly one conclusion instead of
342
+ a list of maybes.
321
343
  """
322
344
  cached = _COOKIE_CACHE.get(DEFAULT_DOMAIN)
323
345
  if cached:
@@ -340,6 +362,10 @@ def _resolve_cookie() -> Tuple[Optional[str], Optional[str], Optional[str], Opti
340
362
  "只含一行 name=value 形式的 Cookie)。"
341
363
  ), None, "file_unreadable"
342
364
 
365
+ session_cookie = load_session_cookie()
366
+ if session_cookie:
367
+ return _remember_cookie(session_cookie), None, "session", None
368
+
343
369
  cookie, error = read_edge_cookies(DEFAULT_DOMAIN)
344
370
  if cookie:
345
371
  return _remember_cookie(cookie), None, "edge", None
@@ -358,24 +384,45 @@ def _resolve_cookie() -> Tuple[Optional[str], Optional[str], Optional[str], Opti
358
384
  #: The old code pasted every possibility into one paragraph, which produced
359
385
  #: messages like "请完全退出 Edge 后重试;本机已启用 ABE,退出 Edge 也无法解密"
360
386
  #: — advice that contradicts itself and tells the agent nothing about which
361
- #: path to take. Each reason now maps to exactly one action.
387
+ #: path to take. Each reason now maps to exactly one action. The default is
388
+ #: the one-click login window; `ZJU_COOKIE_FILE` stays as the advanced
389
+ #: fallback for headless hosts, not as the first thing a normal user sees.
362
390
  COOKIE_FAILURE_ACTIONS: Dict[str, str] = {
363
- "abe": "退出 Edge 无效(ABE 的密钥与浏览器进程绑定):请在宿主配置里设置 ZJU_COOKIE_FILE"
364
- " 环境变量(文件内只放一行 Cookie 头,不要粘贴到对话里),然后重试。",
365
- "locked": "完全退出 Edge(含后台驻留进程)后重试;或在宿主配置里设置 ZJU_COOKIE_FILE。",
366
- "no_rows": "先在 Edge 里登录智云课堂,或在宿主配置里设置 ZJU_COOKIE_FILE,然后重试。",
367
- "decrypt_failed": "Edge 的新版 Cookie 无法在浏览器外解密:改用 ZJU_COOKIE_FILE 环境变量。",
368
- "not_found": "确认本机 Edge 至少登录过一次智云课堂,或改用 ZJU_COOKIE_FILE。",
369
- "db_error": "完全退出 Edge 后重试,或改用 ZJU_COOKIE_FILE。",
370
- "unsupported_platform": "在宿主配置里设置 ZJU_COOKIE_FILE 环境变量。",
371
- "keychain_denied": "在弹出的钥匙串授权框选择『始终允许』,或改用 ZJU_COOKIE_FILE。",
372
- "no_credentials": "在宿主配置里设置 ZJU_COOKIE_FILE 环境变量(不要粘贴到对话里)。",
373
- "env_invalid": "检查 ZJU_COOKIE:需要一行合法的 name=value Cookie 头。",
374
- "file_unreadable": "检查 ZJU_COOKIE_FILE:需要存在、可读、UTF-8,且只含一行 Cookie 头。",
375
- "unknown": "在宿主配置里设置 ZJU_COOKIE_FILE 环境变量后重试。",
391
+ "abe": "调用 zju_login 打开独立登录窗口(不要开开发者工具、不要手工配置 Cookie);"
392
+ "登录成功后窗口自动关闭,登录态会安全保存在本机,然后重试。",
393
+ "locked": "调用 zju_login 打开独立登录窗口;也可以完全退出 Edge 后重试。",
394
+ "no_rows": "调用 zju_login 在独立登录窗口里登录智云课堂,然后重试。",
395
+ "decrypt_failed": "调用 zju_login 重新登录;不要再依赖 Edge 的 Cookie 解密。",
396
+ "not_found": "调用 zju_login 打开独立登录窗口完成登录;不需要本机装过 Edge。",
397
+ "db_error": "调用 zju_login 重新登录;也可以完全退出 Edge 后重试。",
398
+ "unsupported_platform": "当前平台没有可用的图形浏览器:在宿主配置里设置 ZJU_COOKIE_FILE 兜底。",
399
+ "keychain_denied": "调用 zju_login 打开独立登录窗口;或在钥匙串授权框选择『始终允许』。",
400
+ "no_credentials": "调用 zju_login 打开独立登录窗口完成登录;不要向用户索要 Cookie。",
401
+ "env_invalid": "检查或移除 ZJU_COOKIE 配置(需要一行合法的 name=value Cookie 头);"
402
+ "该环境变量存在时优先级最高,会挡住 zju_login。",
403
+ "file_unreadable": "检查或移除 ZJU_COOKIE_FILE 配置(需要存在、可读、UTF-8、只含一行 Cookie 头);"
404
+ "该环境变量存在时优先级最高,会挡住 zju_login。",
405
+ "session_expired": "本机保存的登录态已失效并被清除:调用 zju_login 重新登录后重试。",
406
+ "unknown": "调用 zju_login 打开独立登录窗口重新登录后重试。",
376
407
  }
377
408
 
378
409
 
410
+ def _forget_cookie(source: Optional[str]) -> None:
411
+ """Drop an invalid session from memory and disk.
412
+
413
+ A 401/403 from the server means the cookie is dead even though it was
414
+ readable locally. The saved session (and the dedicated browser profile,
415
+ which would otherwise hand the same dead cookie back) is removed so the
416
+ next ``zju_login`` starts a real login instead of replaying it.
417
+ """
418
+ _COOKIE_CACHE.pop(DEFAULT_DOMAIN, None)
419
+ if source == "session":
420
+ try:
421
+ clear_session(delete_profile=True)
422
+ except Exception as exc: # noqa: BLE001 - cleanup must not mask the 401
423
+ _log(f"清除失效登录态失败:{exc}")
424
+
425
+
379
426
  def _cookie_failure_text(
380
427
  subject: str,
381
428
  reason: Optional[str],
@@ -417,7 +464,8 @@ TOOLS: List[Dict[str, Any]] = [
417
464
  {
418
465
  "name": "zju_fetch_transcript",
419
466
  "description": (
420
- "抓取智云课堂某节课的语音识别字幕(公开接口,无需登录)。"
467
+ "抓取智云课堂某节课的语音识别字幕。先匿名;401/403 时自动用本机登录态重试一次。"
468
+ "登录态只能来自本机 Edge 或 ZJU_COOKIE_FILE,不要传 Cookie。"
421
469
  "默认 per_minute 带时间戳;长课用 chunked;同一节课只抓一次,"
422
470
  "per_segment 仅在确实需要秒级时间戳时用。"
423
471
  ),
@@ -667,11 +715,44 @@ TOOLS: List[Dict[str, Any]] = [
667
715
  "required": ["sub_id", "content"],
668
716
  },
669
717
  },
718
+ {
719
+ "name": "zju_login",
720
+ "description": (
721
+ "打开一个独立的浏览器登录窗口完成浙大登录(不接收密码,也不接收 Cookie)。"
722
+ "用户在该窗口里正常登录后,窗口自动关闭,登录态安全保存在本机,后续字幕与投影自动复用。"
723
+ "字幕/投影 401/403、ABE 导致 Edge Cookie 读不了、用户说「登录智云课堂」时调用。"
724
+ "clear=true 清除本机登录态与独立登录窗口配置。"
725
+ ),
726
+ "inputSchema": {
727
+ "type": "object",
728
+ "additionalProperties": False,
729
+ "properties": {
730
+ "url": {
731
+ "type": "string",
732
+ "description": (
733
+ "登录后要打开的课堂链接(可选,仅接受 https 的 *.zju.edu.cn;"
734
+ "建议传用户给的这节课链接)"
735
+ ),
736
+ },
737
+ "timeout_seconds": {
738
+ "type": "integer",
739
+ "description": "等待用户完成登录的最长秒数(默认 300,范围 30–540)",
740
+ "default": 300,
741
+ },
742
+ "clear": {
743
+ "type": "boolean",
744
+ "description": "只清除本机保存的登录态与独立登录窗口配置,不打开窗口(默认 false)",
745
+ "default": False,
746
+ },
747
+ },
748
+ },
749
+ },
670
750
  {
671
751
  "name": "zju_read_browser_cookie",
672
752
  "description": (
673
753
  "读取本机 Edge 的 classroom.zju.edu.cn 登录态(含父域 .zju.edu.cn 的 _token)"
674
754
  "到服务端内存;只返回名称与长度,绝不回显明文,无参数。"
755
+ "Edge 启用 ABE 时会失败;这种情况改用 zju_login。"
675
756
  ),
676
757
  "inputSchema": {
677
758
  "type": "object",
@@ -782,9 +863,11 @@ TOOLS: List[Dict[str, Any]] = [
782
863
  "name": "zju_doctor",
783
864
  "description": (
784
865
  "检查本机依赖并给出可执行结论:Python、Typst(版本 / 路径 / 来源 / 是否满足 ≥0.13)、"
785
- "随包中文字体与离线 Typst 包、缓存目录。install=true 时下载并校验安装 Typst"
866
+ "随包中文字体与离线 Typst 包、缓存目录、登录窗口是否可用、本机是否保存了登录态;"
867
+ "login=true 时额外验证登录态是否真的可用。"
868
+ "install=true 时下载并校验安装 Typst"
786
869
  "(SHA256 固定,仅官方 Release;可用 ZJU_TYPST_AUTO_INSTALL=0 关闭自动安装)。"
787
- "PDF 失败或用户问「为什么没有 PDF」时先跑它。"
870
+ "PDF 失败或用户问「为什么没有 PDF」时先跑它;没有任何输出时先跑它,再调用一次 zju_login。"
788
871
  ),
789
872
  "inputSchema": {
790
873
  "type": "object",
@@ -795,6 +878,11 @@ TOOLS: List[Dict[str, Any]] = [
795
878
  "description": "缺少 Typst 时是否立即下载安装(默认否;安装约 20 MB)",
796
879
  "default": False,
797
880
  },
881
+ "login": {
882
+ "type": "boolean",
883
+ "description": "是否读取本机登录态检查可用性(默认否;不会回显凭据)",
884
+ "default": False,
885
+ },
798
886
  },
799
887
  },
800
888
  },
@@ -970,8 +1058,53 @@ def _note_cover_meta(note_path: str, note_text: str) -> Tuple[str, str]:
970
1058
  return title, date_match.group(1) if date_match else ""
971
1059
 
972
1060
 
973
- def _doctor_report(install: bool) -> str:
974
- """``zju_doctor``:依赖快照;``install`` 为真时先自举 Typst。"""
1061
+ _LOGIN_SOURCE_LABELS = {
1062
+ "cache": "进程内缓存",
1063
+ "env": "ZJU_COOKIE",
1064
+ "file": "ZJU_COOKIE_FILE",
1065
+ "session": "zju_login 安全保存",
1066
+ "edge": "本机 Edge",
1067
+ }
1068
+
1069
+
1070
+ def _login_status_text() -> List[str]:
1071
+ """One concise login-status block for ``zju_doctor`` (never prints credential values)."""
1072
+ try:
1073
+ cookie, error, source, reason = _resolve_cookie()
1074
+ except Exception: # noqa: BLE001 - diagnostics must never fail the doctor
1075
+ return ["登录态: 检查失败(内部错误)"]
1076
+ if cookie:
1077
+ token = extract_classroom_token(cookie)
1078
+ label = _LOGIN_SOURCE_LABELS.get(source or "", source or "未知")
1079
+ lines = [
1080
+ f"登录态: 可用(来源 {source}({label});Bearer {'可用' if token else '缺失'})",
1081
+ " 字幕匿名被拒时会自动使用;无需开启登录辅助。",
1082
+ ]
1083
+ summary = session_summary()
1084
+ if summary.get("available"):
1085
+ lines.append(
1086
+ " 本机保存的登录态: 存在"
1087
+ f"({summary.get('cookie_count', 0)} 条 Cookie,"
1088
+ f"浏览器 {summary.get('browser') or '未知'})"
1089
+ )
1090
+ return lines
1091
+ action = COOKIE_FAILURE_ACTIONS.get(reason or "unknown", COOKIE_FAILURE_ACTIONS["unknown"])
1092
+ lines = [f"登录态: 不可用(原因 {reason or 'unknown'})"]
1093
+ if error:
1094
+ lines.append(f" 说明: {REDACTOR.redact(error)}")
1095
+ lines.append(f" 修复: {action}")
1096
+ available, detail = login_available()
1097
+ lines.append(
1098
+ " 登录窗口: " + ("可用(" + detail + ")" if available else "不可用(" + detail + ")")
1099
+ )
1100
+ return lines
1101
+
1102
+
1103
+ def _doctor_report(install: bool, check_login: bool = False) -> str:
1104
+ """``zju_doctor``:依赖快照;``install`` 为真时先自举 Typst。
1105
+
1106
+ ``check_login`` 默认关闭:诊断依赖不应顺带读取浏览器登录态。
1107
+ """
975
1108
  from zju_lecture import deps
976
1109
 
977
1110
  auto = deps.auto_install_enabled()
@@ -1006,6 +1139,28 @@ def _doctor_report(install: bool) -> str:
1006
1139
  )
1007
1140
  lines.append(f"汇编缓存: {info['compile_cache'] or '(未指定工作区)'}")
1008
1141
  lines.append(f"自动安装: {'开' if auto else '关'}(ZJU_TYPST_AUTO_INSTALL)")
1142
+ summary = session_summary()
1143
+ if summary.get("available"):
1144
+ saved_at = summary.get("saved_at")
1145
+ stamp = ""
1146
+ if isinstance(saved_at, (int, float)):
1147
+ stamp = time.strftime("%Y-%m-%d %H:%M", time.localtime(saved_at))
1148
+ lines.append(
1149
+ "本机登录态: 已保存"
1150
+ f"({summary.get('cookie_count', 0)} 条 Cookie,浏览器 {summary.get('browser') or '未知'}"
1151
+ + (f",保存于 {stamp}" if stamp else "")
1152
+ + ";不含账号密码)"
1153
+ )
1154
+ else:
1155
+ lines.append("本机登录态: 未保存(需要时调用 zju_login 打开独立登录窗口)")
1156
+ login_ok, login_detail = login_available()
1157
+ lines.append(
1158
+ "登录窗口: " + ("可用(" + login_detail + ")" if login_ok else "不可用(" + login_detail + ")")
1159
+ )
1160
+ if check_login:
1161
+ lines.extend(_login_status_text())
1162
+ else:
1163
+ lines.append("登录态: 未检查(字幕 401/403 时自动读取;需要时用 zju_doctor(login=true))")
1009
1164
  lines.append(
1010
1165
  "模块: 投影=%s / 填空=%s / 登录=%s / PDF=%s(本进程启动时的设置)"
1011
1166
  % (
@@ -1317,12 +1472,61 @@ def _dispatch_tool(name: str, arguments: Dict[str, Any]) -> Any:
1317
1472
  _ensure_tool_enabled(name)
1318
1473
 
1319
1474
  if name == "zju_doctor":
1320
- return _doctor_report(bool(arguments.get("install")))
1475
+ return _doctor_report(bool(arguments.get("install")), bool(arguments.get("login")))
1321
1476
 
1322
1477
  if name == "zju_parse_url":
1323
1478
  parsed = parse_lecture_url(str(arguments.get("url", "")))
1324
1479
  return json.dumps(parsed, ensure_ascii=False, indent=2)
1325
1480
 
1481
+ if name == "zju_login":
1482
+ if arguments.get("clear"):
1483
+ result = clear_session(delete_profile=True)
1484
+ _COOKIE_CACHE.pop(DEFAULT_DOMAIN, None)
1485
+ lines = [
1486
+ "已清除本机保存的登录态。"
1487
+ if result.get("session_removed")
1488
+ else "本机没有保存的登录态。"
1489
+ ]
1490
+ if result.get("profile_removed"):
1491
+ lines.append("独立登录窗口的浏览器配置也已删除。")
1492
+ if result.get("profile_error"):
1493
+ lines.append(
1494
+ "独立登录窗口配置未能删除:"
1495
+ f"{REDACTOR.redact(result['profile_error'])}。"
1496
+ "请先关闭该登录窗口,再重试清除。"
1497
+ )
1498
+ return "\n".join(lines)
1499
+
1500
+ timeout = arguments.get("timeout_seconds") or 300
1501
+ try:
1502
+ result = open_login_window(str(arguments.get("url") or ""), timeout)
1503
+ except LoginError as exc:
1504
+ raise ZJUAPIError(
1505
+ f"登录未完成(原因: {exc.reason})。\n"
1506
+ f"说明: {REDACTOR.redact(exc.message)}\n"
1507
+ f"下一步: {exc.hint or '请重试一次。'}"
1508
+ ) from exc
1509
+ _remember_cookie(result["cookie"])
1510
+ lines = [
1511
+ "登录成功,已读取本机登录态。",
1512
+ f"- 浏览器: {result['browser']}",
1513
+ f"- Cookie: {len(result['names'])} 条(含 _token,值不回显)",
1514
+ f"- 用时: {result['elapsed']} 秒",
1515
+ ]
1516
+ if result.get("saved"):
1517
+ lines.append(
1518
+ f"- 保存: 已安全保存到 {result['saved_path']}"
1519
+ "(仅当前系统用户可解密;不包含账号密码)"
1520
+ )
1521
+ else:
1522
+ lines.append(
1523
+ "- 保存: 未落盘("
1524
+ f"{REDACTOR.redact(result.get('save_error') or '未知原因')});"
1525
+ "本次会话仍可用,但重启后需要重新登录"
1526
+ )
1527
+ lines.append("现在可以重试字幕或投影抓取,不需要再操作浏览器。")
1528
+ return "\n".join(lines)
1529
+
1326
1530
  if name == "zju_fetch_transcript":
1327
1531
  parsed = parse_lecture_url(str(arguments.get("url_or_sub_id", "")))
1328
1532
  sub_id = parsed["sub_id"]
@@ -1335,7 +1539,41 @@ def _dispatch_tool(name: str, arguments: Dict[str, Any]) -> Any:
1335
1539
  start_sec = start_min * 60 if start_min is not None else None
1336
1540
  end_sec = (end_min * 60 + 59) if end_min is not None else None
1337
1541
 
1338
- raw_segments = fetch_transcript(sub_id, tenant)
1542
+ try:
1543
+ raw_segments = fetch_transcript(sub_id, tenant)
1544
+ except TranscriptAuthError as exc:
1545
+ # 字幕鉴权属于核心链路,不依赖「登录辅助」工具开关:用户默认安装
1546
+ # 即可使用。只有匿名请求确实被拒绝时才读取本机登录态。
1547
+ cookie, cookie_error, source, reason = _resolve_cookie()
1548
+ if not cookie:
1549
+ raise ZJUAPIError(
1550
+ f"{exc}\n"
1551
+ + _cookie_failure_text(
1552
+ "语音字幕",
1553
+ reason,
1554
+ cookie_error,
1555
+ degrade_hint=(
1556
+ "字幕匿名请求被拒绝;插件只在这一步读取本机登录态。"
1557
+ "需要登录时调用 zju_login(url=<这节课链接>) 打开独立登录窗口,"
1558
+ "不要让用户开开发者工具、手工配置 Cookie,也不要把 Cookie 贴进对话。"
1559
+ ),
1560
+ )
1561
+ ) from exc
1562
+ try:
1563
+ raw_segments = fetch_transcript(sub_id, tenant, cookie=cookie)
1564
+ except TranscriptAuthError as auth_exc:
1565
+ _forget_cookie(source)
1566
+ session_note = (
1567
+ "已清除本机保存的登录态;请调用 zju_login 重新登录后重试。"
1568
+ if source == "session"
1569
+ else "请调用 zju_login 重新登录后重试。"
1570
+ )
1571
+ raise ZJUAPIError(
1572
+ f"字幕携带本机登录态(来源 {source})后仍返回 HTTP {auth_exc.status},"
1573
+ f"已停止重试。{session_note}"
1574
+ "若登录后仍失败,请确认该账号在官网能查看同一节课;"
1575
+ "不能仅凭此错误断定是校园网限制。"
1576
+ ) from auth_exc
1339
1577
  full_duration = (
1340
1578
  format_timestamp(raw_segments[-1]["begin_sec"]) if raw_segments else "00:00:00"
1341
1579
  )
@@ -1373,8 +1611,8 @@ def _dispatch_tool(name: str, arguments: Dict[str, Any]) -> Any:
1373
1611
  if name == "zju_fetch_slides":
1374
1612
  if not slides_enabled():
1375
1613
  raise SlidesDisabledError(
1376
- "PPT 投影抓取未启用(ZJU_ENABLE_SLIDES=0):本进程只提供「语音字幕 + "
1377
- "本地课件」链路,不读取登录态、不下载投影截图。\n"
1614
+ "PPT 投影抓取未启用(ZJU_ENABLE_SLIDES=0):本进程不为投影读取登录态、"
1615
+ "不下载投影截图。\n"
1378
1616
  "需要投影截图时:dsh 插件设置里打开「启用 PPT 投影抓取」(enableSlides),"
1379
1617
  "或给 MCP server 设置环境变量 ZJU_ENABLE_SLIDES=1 后重启;"
1380
1618
  "不需要时直接继续用 zju_fetch_transcript 的字幕生成讲义即可。"
@@ -1394,7 +1632,7 @@ def _dispatch_tool(name: str, arguments: Dict[str, Any]) -> Any:
1394
1632
  dedup = True if dedup_arg is None else bool(dedup_arg)
1395
1633
  output_dir = str(arguments.get("output_dir") or "").strip()
1396
1634
 
1397
- cookie, cookie_error, _source, reason = _resolve_cookie()
1635
+ cookie, cookie_error, source, reason = _resolve_cookie()
1398
1636
  if not cookie:
1399
1637
  return _cookie_failure_text(
1400
1638
  "PPT 记录",
@@ -1413,6 +1651,19 @@ def _dispatch_tool(name: str, arguments: Dict[str, Any]) -> Any:
1413
1651
  )
1414
1652
  if not slides_data:
1415
1653
  reason_text = "\n".join(f"- {item}" for item in diagnostics) or "- 未获得具体原因"
1654
+ auth_failed = any(
1655
+ marker in item
1656
+ for item in diagnostics
1657
+ for marker in ("HTTP 401", "HTTP 403", "未解析到 _token", "缺少 _token")
1658
+ )
1659
+ if auth_failed:
1660
+ _forget_cookie(source)
1661
+ return _cookie_failure_text(
1662
+ "PPT 记录",
1663
+ "session_expired" if source == "session" else "no_credentials",
1664
+ "投影接口拒绝了当前登录态,或 Cookie 中没有可用的 _token。",
1665
+ degrade_hint="(流水线可平滑降级:没有 PPT 也能仅凭语音字幕生成讲义。)",
1666
+ )
1416
1667
  return (
1417
1668
  "未抓取到 PPT 记录(原因: no_slides)。\n"
1418
1669
  "登录态可用,但接口没有返回截图列表。\n"
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "dsh-zju-lecture-note",
3
- "version": "2.2.3",
4
- "description": "浙大智云课堂回放讲义插件(DeepSeek Harness 原生插件):以「语音字幕 + 本地课件」为主链路,写完讲义自动排版同名 PDF;可选启用投影 PPT 截图抓取、基于 Typst scholia 模板排版的填空式学习笔记与登录辅助工具;Cookie 只在本地内存中使用,不回显、不落盘",
3
+ "version": "2.2.5",
4
+ "description": "浙大智云课堂回放讲义插件(DeepSeek Harness 原生插件):以「语音字幕 + 本地课件」为主链路,写完讲义自动排版同名 PDF;可选启用投影 PPT 截图抓取、基于 Typst scholia 模板排版的填空式学习笔记与登录辅助工具;一键登录窗口让用户正常登录后自动安全保存登录态(Windows DPAPI),不回显、不进入对话、不保存密码",
5
5
  "license": "MIT",
6
6
  "author": "chenqianyu486",
7
7
  "icon": "icon.png",
@@ -47,6 +47,10 @@
47
47
  "zju_lecture/typst-packages",
48
48
  "skills/zju-lecture-summarizer",
49
49
  "skills/zju-lecture-summarizer.manifest.json",
50
+ "skills/zju-lecture-summarizer-help",
51
+ "skills/zju-lecture-summarizer-help.manifest.json",
52
+ "skills/zju-lecture-summarizer-login",
53
+ "skills/zju-lecture-summarizer-login.manifest.json",
50
54
  "skills/scholia-notes",
51
55
  "skills/scholia-notes.manifest.json",
52
56
  "icon.png",
@@ -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
  | 不要 | 为什么 | 改写成 |