dsh-zju-lecture-note 2.2.8 → 2.2.9

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/mcp_server.py CHANGED
@@ -27,6 +27,7 @@ import sys
27
27
  import time
28
28
  import traceback
29
29
  from typing import Any, Dict, List, Optional, Tuple
30
+ from urllib.parse import unquote
30
31
 
31
32
  CURRENT_DIR = os.path.dirname(os.path.abspath(__file__))
32
33
  if CURRENT_DIR not in sys.path:
@@ -98,7 +99,7 @@ from zju_lecture.study_notes import (
98
99
  )
99
100
 
100
101
  SERVER_NAME = "zju-lecture-mcp"
101
- SERVER_VERSION = "2.2.8"
102
+ SERVER_VERSION = "2.2.9"
102
103
  DEFAULT_TENANT = "112"
103
104
  DEFAULT_DOMAIN = "classroom.zju.edu.cn"
104
105
 
@@ -259,8 +260,11 @@ def _pdf_mode_text() -> str:
259
260
  def server_instructions() -> str:
260
261
  """MCP initialize instructions, reflecting the current feature gates."""
261
262
  parts = [
262
- "提供浙大智云课堂(classroom.zju.edu.cn)回放的语音字幕与课件文本提取。"
263
- "字幕先匿名请求;401/403 时自动使用本机登录态重试一次,无需开启登录辅助工具。"
263
+ "提供浙大智云课堂(classroom.zju.edu.cn)与互动式课堂"
264
+ "(interactivemeta.cmc.zju.edu.cn)回放的语音字幕与课件文本提取。"
265
+ "两种回放链接(普通 query 与 #/replay hash 路由)都可以直接交给工具。"
266
+ "字幕先匿名请求;401/403 时自动使用本机登录态重试一次,无需开启登录辅助工具;"
267
+ "主站失败时工具会自动回退互动式课堂后端,不要自行更换主机。"
264
268
  "本机没有可用登录态、或登录态已失效时,调用 zju_login(url=<这节课链接>) "
265
269
  "打开独立登录窗口:用户只需在窗口里正常登录,窗口会自动关闭并把登录态安全保存在本机;"
266
270
  "不要让用户打开开发者工具复制 Cookie,也不要索要 Cookie / 密码。",
@@ -476,14 +480,21 @@ def _cookie_failure_text(
476
480
  TOOLS: List[Dict[str, Any]] = [
477
481
  {
478
482
  "name": "zju_parse_url",
479
- "description": "解析浙大智云课堂 (classroom.zju.edu.cn) 回放链接,提取 sub_id、course_id 与 tenant_code。",
483
+ "description": (
484
+ "解析浙大智云课堂 / 互动式课堂回放链接,提取 sub_id、course_id 与 tenant_code;"
485
+ "兼容 classroom.zju.edu.cn/livingroom?... 与 "
486
+ "interactivemeta.cmc.zju.edu.cn/#/replay?... 两种 URL。"
487
+ ),
480
488
  "inputSchema": {
481
489
  "type": "object",
482
490
  "additionalProperties": False,
483
491
  "properties": {
484
492
  "url": {
485
493
  "type": "string",
486
- "description": "智云课堂回放 URL(例如 https://classroom.zju.edu.cn/livingroom?course_id=...&sub_id=...)或纯 sub_id 数字",
494
+ "description": (
495
+ "回放 URL(classroom.zju.edu.cn/livingroom?... 或 "
496
+ "interactivemeta.cmc.zju.edu.cn/#/replay?...)或纯 sub_id 数字"
497
+ ),
487
498
  }
488
499
  },
489
500
  "required": ["url"],
@@ -492,8 +503,9 @@ TOOLS: List[Dict[str, Any]] = [
492
503
  {
493
504
  "name": "zju_fetch_transcript",
494
505
  "description": (
495
- "抓取智云课堂某节课的语音识别字幕。先匿名;401/403 时自动用本机登录态重试一次。"
496
- "登录态只能来自本机 Edge 或 ZJU_COOKIE_FILE,不要传 Cookie。"
506
+ "抓取智云课堂 / 互动式课堂某节课的语音识别字幕。先匿名;401/403 时自动用本机登录态"
507
+ "重试一次,并自动回退互动式课堂后端。登录态只能来自本机 Edge 或 ZJU_COOKIE_FILE,"
508
+ "不要传 Cookie。"
497
509
  "默认 per_minute 带时间戳;长课用 chunked;同一节课只抓一次,"
498
510
  "per_segment 仅在确实需要秒级时间戳时用。"
499
511
  ),
@@ -503,7 +515,9 @@ TOOLS: List[Dict[str, Any]] = [
503
515
  "properties": {
504
516
  "url_or_sub_id": {
505
517
  "type": "string",
506
- "description": "回放 URL 或 sub_id",
518
+ "description": (
519
+ "回放 URL(含互动式课堂 #/replay hash 链接)或 sub_id"
520
+ ),
507
521
  },
508
522
  "tenant_code": {
509
523
  "type": "string",
@@ -544,8 +558,10 @@ TOOLS: List[Dict[str, Any]] = [
544
558
  {
545
559
  "name": "zju_fetch_slides",
546
560
  "description": (
547
- "(投影模块)抓取智云课堂投影 PPT 截图清单。search-ppt 返回的是"
548
- "投影截图,不是文字层/OCR;download=true 时下载截图并合成 PDF。"
561
+ "(投影模块)抓取智云课堂 / 互动式课堂投影 PPT 截图清单。search-ppt 返回的是"
562
+ "投影截图,不是文字层/OCR;主站为空时自动回退互动式课堂后端。"
563
+ "download=true 时下载截图并合成 PDF。"
564
+ "返回紧凑索引:截图目录/文件名模式、页时间轴、建议抽查页与引用示例。"
549
565
  "当插件把投影作为讲义来源(slidesAsSource / ZJU_SLIDES_SOURCE=1)时,"
550
566
  "写讲义前应调用一次并传 download=true, confirm=true;download 省略时"
551
567
  "跟随 slidesAsSource / embedSlideImages(ZJU_SLIDES_SOURCE / ZJU_EMBED_SLIDES)。"
@@ -559,7 +575,9 @@ TOOLS: List[Dict[str, Any]] = [
559
575
  "properties": {
560
576
  "url_or_sub_id": {
561
577
  "type": "string",
562
- "description": "回放 URL(通常含 course_id)或 sub_id",
578
+ "description": (
579
+ "回放 URL(通常含 course_id,支持互动式课堂 hash 链接)或 sub_id"
580
+ ),
563
581
  },
564
582
  "course_id": {
565
583
  "type": "string",
@@ -708,7 +726,7 @@ TOOLS: List[Dict[str, Any]] = [
708
726
  {
709
727
  "name": "zju_write_note",
710
728
  "description": (
711
- "写入讲义 Markdown:自动命名(知识总结-<日期>-<课程>-<主题>)、默认拒绝静默覆盖、"
729
+ "写入讲义 Markdown(content 或 content_file 二选一):自动命名(知识总结-<日期>-<课程>-<主题>)、默认拒绝静默覆盖、"
712
730
  "写前修正公式、写后返回规范检查,并按设置自动排版同名 PDF——"
713
731
  "写文件、检查、出 PDF 一次完成。只写工作区内的 .md 文件。"
714
732
  ),
@@ -722,7 +740,14 @@ TOOLS: List[Dict[str, Any]] = [
722
740
  },
723
741
  "content": {
724
742
  "type": "string",
725
- "description": "讲义 Markdown 全文",
743
+ "description": "讲义 Markdown 全文(与 content_file 二选一)",
744
+ },
745
+ "content_file": {
746
+ "type": "string",
747
+ "description": (
748
+ "从工作区内的 Markdown 草稿读取讲义全文(与 content 二选一)。"
749
+ "长篇讲义建议先用 write 落盘,再传此路径,避免在 run_code 里重复粘贴。"
750
+ ),
726
751
  },
727
752
  "name": {
728
753
  "type": "string",
@@ -761,7 +786,7 @@ TOOLS: List[Dict[str, Any]] = [
761
786
  "description": "写入后是否排版同名 PDF(默认跟随插件设置 renderPdf;显式 true/false 可覆盖)",
762
787
  },
763
788
  },
764
- "required": ["sub_id", "content"],
789
+ "required": ["sub_id"],
765
790
  },
766
791
  },
767
792
  {
@@ -1248,10 +1273,80 @@ def _doctor_report(install: bool, check_login: bool = False) -> str:
1248
1273
  return "\n".join(lines)
1249
1274
 
1250
1275
 
1276
+ _NOTE_IMAGE_RE = re.compile(
1277
+ r'!\[[^\]]*\]\(\s*([^)\s]+)(?:\s+"[^"]*")?\s*\)'
1278
+ )
1279
+
1280
+
1281
+ def _note_image_report(note_text: str, note_path: str) -> str:
1282
+ """One compact line for the image references in a note.
1283
+
1284
+ The reading PDF silently turns a missing local image into an
1285
+ ``#aside("图片未嵌入")`` placeholder; the agent should not have to glob
1286
+ every path to discover that. Remote images are counted separately because
1287
+ the PDF never downloads them.
1288
+ """
1289
+ refs: List[str] = []
1290
+ in_fence = False
1291
+ for line in (note_text or "").splitlines():
1292
+ stripped = line.strip()
1293
+ if stripped.startswith(('```', "~~~")):
1294
+ in_fence = not in_fence
1295
+ continue
1296
+ if in_fence:
1297
+ continue
1298
+ refs.extend(_NOTE_IMAGE_RE.findall(line))
1299
+ if not refs:
1300
+ return ""
1301
+ note_dir = os.path.dirname(os.path.abspath(note_path))
1302
+ external = 0
1303
+ local = 0
1304
+ bad: List[str] = []
1305
+ for raw in refs:
1306
+ ref = str(raw or "").strip().strip("<>")
1307
+ if not ref:
1308
+ continue
1309
+ if ref.startswith(("http://", "https://")):
1310
+ external += 1
1311
+ continue
1312
+ if ref.startswith("data:"):
1313
+ continue
1314
+ local += 1
1315
+ candidate = os.path.abspath(os.path.join(note_dir, unquote(ref)))
1316
+ if not is_inside_workspace(candidate) or not os.path.isfile(candidate):
1317
+ bad.append(ref)
1318
+ parts = [f"{len(refs)} 张"]
1319
+ if external:
1320
+ parts.append(f"外链 {external} 张(PDF 不嵌入)")
1321
+ if bad:
1322
+ shown = ", ".join(bad[:5])
1323
+ if len(bad) > 5:
1324
+ shown += f" … 另有 {len(bad) - 5} 张"
1325
+ parts.append(f"缺失/不可用 {len(bad)} 张:{shown}")
1326
+ elif local:
1327
+ parts.append("本地文件全部存在")
1328
+ return "图片引用: " + " | ".join(parts)
1329
+
1330
+
1331
+ def _pdf_warning_lines(warnings: Optional[List[str]]) -> List[str]:
1332
+ cleaned = [
1333
+ " ".join(str(item).split())[:240]
1334
+ for item in (warnings or [])
1335
+ if str(item).strip()
1336
+ ]
1337
+ if not cleaned:
1338
+ return []
1339
+ lines = ["PDF 提示:"]
1340
+ lines.extend(f"- {item}" for item in cleaned[:5])
1341
+ if len(cleaned) > 5:
1342
+ lines.append(f"- 另有 {len(cleaned) - 5} 条提示未展开")
1343
+ return lines
1344
+
1345
+
1251
1346
  def _render_note_pdf(note_path: str, note_text: str) -> List[str]:
1252
1347
  """Typeset the written note into a reading PDF; never raises.
1253
1348
 
1254
- Returns 0–2 short lines for the tool result. A missing Typst or a
1349
+ Returns a few short lines for the tool result. A missing Typst or a
1255
1350
  rendering error must not turn a successful Markdown write into a failure:
1256
1351
  the Markdown is the deliverable, the PDF is an enhancement.
1257
1352
  """
@@ -1272,7 +1367,9 @@ def _render_note_pdf(note_path: str, note_text: str) -> List[str]:
1272
1367
  return [f"PDF 跳过: {exc}"]
1273
1368
  if result.ok:
1274
1369
  pages = f"({result.pages} 页)" if result.pages else ""
1275
- return [f"PDF: {result.pdf_path}{pages}"]
1370
+ lines = [f"PDF: {result.pdf_path}{pages}"]
1371
+ lines.extend(_pdf_warning_lines(result.warnings))
1372
+ return lines
1276
1373
  detail = ";".join(result.errors[:2]) or "未知原因"
1277
1374
  if "找不到 typst" in detail:
1278
1375
  # Keep the common "Typst is not installed" case to one short line:
@@ -1282,10 +1379,12 @@ def _render_note_pdf(note_path: str, note_text: str) -> List[str]:
1282
1379
  detail = detail[:219] + "…"
1283
1380
  # 这是「同一份讲义要不要再查一次」的唯一例外:上面报的是渲染错误,
1284
1381
  # 不改文件永远好不了。给一句可执行的下一步,Agent 就不必自己猜。
1285
- return [
1382
+ lines = [
1286
1383
  f"PDF 跳过: {detail}",
1287
1384
  "Markdown 已写好;按上面的错误改掉对应公式后,调用 zju_check_note(pdf=true) 重排一次。",
1288
1385
  ]
1386
+ lines.extend(_pdf_warning_lines(result.warnings))
1387
+ return lines
1289
1388
 
1290
1389
 
1291
1390
  def _patch_draft(arguments: Dict[str, Any]) -> str:
@@ -1780,6 +1879,7 @@ def _dispatch_tool(name: str, arguments: Dict[str, Any]) -> Any:
1780
1879
  pdf_path = ""
1781
1880
  download_note = ""
1782
1881
  note_example = ""
1882
+ pages: List[Dict[str, Any]] = []
1783
1883
  if download:
1784
1884
  target, target_error = artifact_dir(
1785
1885
  output_dir,
@@ -1805,19 +1905,25 @@ def _dispatch_tool(name: str, arguments: Dict[str, Any]) -> Any:
1805
1905
  pdf_path = written
1806
1906
  download_note = (
1807
1907
  f"下载 {summary.get('downloaded', 0)} 张,失败 {summary.get('failed', 0)} 张,"
1808
- f"连续重复折叠 {summary.get('duplicates', 0)} 张;"
1908
+ f"连续字节完全重复折叠 {summary.get('duplicates', 0)} 张(仅字节级去重);"
1809
1909
  f"截图目录: {summary.get('images_dir')}"
1810
1910
  )
1811
1911
  if pdf_path:
1812
1912
  download_note += f"\nPDF: {pdf_path}({len(pages)} 页)"
1813
1913
 
1814
- md = format_slides_as_markdown(slides_data, pdf_path=pdf_path)
1914
+ index_slides = pages if (download and pages) else slides_data
1915
+ md = format_slides_as_markdown(
1916
+ index_slides,
1917
+ pdf_path=pdf_path,
1918
+ compact=True,
1919
+ download_attempted=download,
1920
+ )
1815
1921
  mode_text = "开启" if slide_images_enabled else (
1816
1922
  "关闭" if slides_as_source else "关闭(默认)"
1817
1923
  )
1818
1924
  source_text = "开启" if slides_as_source else "关闭(默认)"
1819
1925
  lines = [
1820
- f"=== 课堂投影 PPT 截图 (sub_id={sub_id}, 共 {len(slides_data)} 页) ===",
1926
+ f"=== 课堂投影 PPT 截图 (sub_id={sub_id}, 共 {len(index_slides)} 页) ===",
1821
1927
  f"投影作为讲义来源: {source_text}"
1822
1928
  "(dsh 设置 slidesAsSource / 环境变量 ZJU_SLIDES_SOURCE)",
1823
1929
  f"讲义插图模式: {mode_text}"
@@ -1952,6 +2058,9 @@ def _dispatch_tool(name: str, arguments: Dict[str, Any]) -> Any:
1952
2058
  report = format_report(
1953
2059
  os.path.basename(file_path), check_markdown(note_text), max_samples
1954
2060
  )
2061
+ image_line = _note_image_report(note_text, file_path)
2062
+ if image_line:
2063
+ report = image_line + "\n\n" + report
1955
2064
  if applied:
1956
2065
  applied_block = "\n".join(f"- {item}" for item in applied)
1957
2066
  if backup_path:
@@ -1964,27 +2073,64 @@ def _dispatch_tool(name: str, arguments: Dict[str, Any]) -> Any:
1964
2073
  if name == "zju_write_note":
1965
2074
  sub_id = str(arguments.get("sub_id", "")).strip()
1966
2075
  content = arguments.get("content")
2076
+ content_file = str(arguments.get("content_file") or "").strip()
1967
2077
  if not sub_id:
1968
2078
  raise ValueError("zju_write_note 需要 sub_id 参数")
2079
+ if content_file and isinstance(content, str) and content.strip():
2080
+ raise ValueError("zju_write_note 的 content 与 content_file 只能传一个")
2081
+
2082
+ source_path = ""
2083
+ if content_file:
2084
+ source_path, path_error = require_workspace_path(
2085
+ content_file, extensions=NOTE_EXTENSIONS, kind="讲义草稿"
2086
+ )
2087
+ if path_error:
2088
+ return f"错误: {path_error}"
2089
+ try:
2090
+ # UTF-8 is at most 4 bytes per character; this rejects a
2091
+ # pathological file before materialising it in memory.
2092
+ if os.path.getsize(source_path) > MAX_NOTE_CHARS * 4:
2093
+ return (
2094
+ f"错误: 讲义草稿超过 {MAX_NOTE_CHARS} 字符上限,"
2095
+ "请检查是否误传了别的内容。"
2096
+ )
2097
+ with open(source_path, "r", encoding="utf-8") as handle:
2098
+ content = handle.read()
2099
+ except UnicodeDecodeError:
2100
+ return f"错误: 讲义草稿不是 UTF-8 编码: {source_path}"
2101
+ except OSError as exc:
2102
+ return f"错误: 读取讲义草稿失败: {exc}"
2103
+
1969
2104
  if not isinstance(content, str) or not content.strip():
1970
- raise ValueError("zju_write_note 需要非空的 content 参数(讲义 Markdown 全文)")
2105
+ raise ValueError(
2106
+ "zju_write_note 需要非空的 content 或 content_file 参数(讲义 Markdown 全文)"
2107
+ )
1971
2108
  if len(content) > MAX_NOTE_CHARS:
1972
2109
  return (
1973
2110
  f"错误: 讲义内容 {len(content)} 字符,超过 {MAX_NOTE_CHARS} 字符上限;"
1974
2111
  "请分批写入或检查是否误传了别的内容。"
1975
2112
  )
1976
2113
 
2114
+ note_name = str(arguments.get("name") or "").strip()
2115
+ if not note_name and source_path:
2116
+ draft_stem = os.path.splitext(os.path.basename(source_path))[0]
2117
+ if draft_stem.startswith("知识总结"):
2118
+ note_name = draft_stem
1977
2119
  target, target_error = note_target(
1978
2120
  sub_id,
1979
2121
  str(arguments.get("slug") or ""),
1980
2122
  arguments.get("directory"),
1981
- str(arguments.get("name") or ""),
2123
+ note_name,
1982
2124
  )
1983
2125
  if target_error:
1984
2126
  return f"错误: {target_error}"
1985
2127
 
1986
2128
  overwrite = bool(arguments.get("overwrite"))
1987
- already = os.path.exists(target)
2129
+ same_file = bool(source_path) and (
2130
+ os.path.normcase(os.path.realpath(target))
2131
+ == os.path.normcase(os.path.realpath(source_path))
2132
+ )
2133
+ already = os.path.exists(target) and not same_file
1988
2134
  if already and not overwrite:
1989
2135
  # Silent overwrite is how one lecture's note ate the previous one's:
1990
2136
  # hand the decision back to the caller instead of guessing.
@@ -2004,7 +2150,7 @@ def _dispatch_tool(name: str, arguments: Dict[str, Any]) -> Any:
2004
2150
  if arguments.get("fix", True):
2005
2151
  fixed_text, applied = fix_markdown(content)
2006
2152
  try:
2007
- if already:
2153
+ if already or same_file:
2008
2154
  backup_path = write_with_backup(target, fixed_text)
2009
2155
  else:
2010
2156
  backup_path = ""
@@ -2021,11 +2167,16 @@ def _dispatch_tool(name: str, arguments: Dict[str, Any]) -> Any:
2021
2167
  f"路径: {target}",
2022
2168
  f"字数: {len(fixed_text)} 字符",
2023
2169
  ]
2024
- if not str(arguments.get("name") or "").strip():
2170
+ image_line = _note_image_report(fixed_text, target)
2171
+ if image_line:
2172
+ header.append(image_line)
2173
+ if not note_name:
2025
2174
  header.append(
2026
2175
  "提示: 本次用的是回退文件名。建议下次传 name=知识总结-<上课日期>-<课程简称>-<本节主题>,"
2027
2176
  "文件名带日期与内容更利于区分不同讲次。"
2028
2177
  )
2178
+ if source_path:
2179
+ header.append(f"草稿来源: {source_path}")
2029
2180
  if applied:
2030
2181
  header.append("自动修复:")
2031
2182
  header.extend(f"- {item}" for item in applied)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-zju-lecture-note",
3
- "version": "2.2.8",
3
+ "version": "2.2.9",
4
4
  "description": "浙大智云课堂回放讲义插件(DeepSeek Harness 原生插件):以「语音字幕 + 本地课件」为主链路,写完讲义自动排版同名 PDF;可选启用投影 PPT 截图抓取、基于 Typst scholia 模板排版的填空式学习笔记与登录辅助工具;一键登录窗口让用户正常登录后把登录态加密保存到平台凭据库(Windows DPAPI / macOS 钥匙串 / Linux 密钥环,无可用凭据库时不落盘),不回显、不进入对话、不保存密码",
5
5
  "license": "MIT",
6
6
  "author": "chenqianyu486",
package/plugin.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
3
3
  "name": "zju-lecture",
4
- "version": "2.2.8",
4
+ "version": "2.2.9",
5
5
  "description": "浙大智云课堂回放讲义:语音字幕 + 本地课件 → 结构化讲义与 PDF(MCP + Agent Skills)",
6
6
  "author": {
7
7
  "name": "chenqianyu486"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "scholia-notes",
3
- "version": "2.2.8",
3
+ "version": "2.2.9",
4
4
  "contentHash": "sha256:a2996a352ec54b35350e9830e3a9063d4ae147324a48ab89efd10fe429e64f3b",
5
5
  "fileCount": 12,
6
6
  "files": [
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: zju-lecture-summarizer
3
- description: 整理浙江大学智云课堂(classroom.zju.edu.cn)课程回放为结构化讲义。用户给出智云课堂回放链接或 sub_id、要求总结/整理课堂笔记、提取某段时间的讲解内容、整理考点预测或公式清单时使用。
3
+ description: 整理浙江大学智云课堂(classroom.zju.edu.cn)与互动式课堂(interactivemeta.cmc.zju.edu.cn)课程回放为结构化讲义。用户给出普通或 hash 路由回放链接或 sub_id、要求总结/整理课堂笔记、提取某段时间的讲解内容、整理考点预测或公式清单时使用。
4
4
  ---
5
5
 
6
6
  # 智云课堂课程知识总结 (ZJU Lecture Summarizer)
@@ -25,7 +25,8 @@ description: 整理浙江大学智云课堂(classroom.zju.edu.cn)课程回
25
25
  | `zju_login` | 打开独立登录窗口;用户登录后自动关闭,登录态安全保存到本机 | 需要用户点一下登录;不接收密码 / Cookie |
26
26
 
27
27
  > **字幕主链路**不依赖投影 PPT 抓取。字幕工具先匿名请求;仅 HTTP 401/403 时自动读取本地登录态、
28
- > 解析 Bearer 重试一次,不需要开启登录辅助工具。字幕只向 `classroom.zju.edu.cn` 发 Bearer,不发 Cookie 头。
28
+ > 解析 Bearer 重试,不需要开启登录辅助工具。携带登录态时若主站失败,工具会自动回退
29
+ > `interactivemeta.cmc.zju.edu.cn` 互动式课堂后端;字幕只向这两个浙大官方主机发 Bearer,不发 Cookie 头。
29
30
  > 本机没有可用登录态时,`zju_login` 会打开一个**独立**的 Edge / Chrome 登录窗口:
30
31
  > 不碰用户日常浏览器,不用开发者工具,登录页自己处理 SSO / 2FA;成功后窗口自动关闭,
31
32
  > Cookie 只写入平台凭据库(Windows DPAPI / macOS 钥匙串 / Linux 密钥环,静态加密;都不可用时不落盘),只存登录态、不存账号密码。
@@ -41,7 +42,8 @@ description: 整理浙江大学智云课堂(classroom.zju.edu.cn)课程回
41
42
 
42
43
  ## 2. 触发场景
43
44
 
44
- - 用户给出智云课堂链接(如 `https://classroom.zju.edu.cn/livingroom?...`)要求总结或整理笔记;
45
+ - 用户给出智云课堂链接(如 `https://classroom.zju.edu.cn/livingroom?...`)或互动式课堂链接
46
+ (如 `https://interactivemeta.cmc.zju.edu.cn/#/replay?course_id=...&sub_id=...`)要求总结或整理笔记;
45
47
  - 用户要求提取某节课的语音识别字幕;
46
48
  - 用户要求整理考点清单、重点公式或推导过程;
47
49
  - 用户询问某节课特定时间段(如"第 30 到 50 分钟")老师讲解的内容。
@@ -74,8 +76,9 @@ flowchart TD
74
76
  2. **抓取语音字幕**(先匿名,整节课只抓一次):
75
77
  - HTTP 401/403 后的 Bearer 重试由工具内部自动完成,不需先调读 Cookie 工具,也不需要开启登录辅助;
76
78
  登录态沿用本地缓存 / 环境变量 / 文件 / Edge,模型不传 Cookie 或 token。
77
- - 若仍报 401/403,**不要反复重试、不要擅断为校园网限制,也不要擅自更换主机或后端**;
78
- 调用一次 `zju_login(url=<这节课的链接>)`:
79
+ - 主站失败时工具会自动尝试互动式课堂后端,不要自行拼 URL、换主机或换后端;
80
+ 若仍报 401/403,**不要反复重试、不要擅断为校园网限制**,调用一次
81
+ `zju_login(url=<这节课的链接>)`:
79
82
  1. 先告诉用户:「会弹出一个独立的登录窗口,请在窗口里正常登录;成功后窗口会自动关闭。」
80
83
  2. 用户完成登录后,工具会返回「登录成功」并给出 Cookie 条数;**不要索要或复述 Cookie**。
81
84
  3. 登录成功后重试 `zju_fetch_transcript` **一次**。最多调用 `zju_login` 两次;
@@ -116,21 +119,43 @@ flowchart TD
116
119
  > `enableStudyNotes` → 写完讲义再出填空版(底稿的挖空用 `mode=patch` 一次写回,
117
120
  > 不要一处一处改)。
118
121
 
122
+ :warning: **dsh 的 `run_code` 每次都是独立进程**:不要先在 A 次程序里生成一版 Markdown
123
+ 只 `console.log` 校验,再在 B 次程序里重发全文给 `zju_write_note`。把 Markdown 的构造和
124
+ `zju_write_note` 调用放在**同一个**程序里,写入工具返回的检查报告就是校验结果。
125
+
126
+ 长篇讲义优先用 `content_file`:先用 `write` 把草稿落到工作区
127
+ (建议 `.zju-lecture/drafts/知识总结-<日期>-<课程>-<主题>.md`),再调用
128
+ `zju_write_note(sub_id=..., content_file="<草稿路径>", name="...")`,避免 20k 字符在
129
+ `run_code` 的模板字符串里重复粘贴。`content` 与 `content_file` 二选一;
130
+ 草稿名以 `知识总结-` 开头且不传 `name` 时,工具会沿用草稿名。
131
+
132
+ 如果必须在 `String.raw` 模板字符串里构造 Markdown:反斜杠写成 `@@`、反引号写成 `@BT@`、
133
+ `${` 写成 `@D{`,写入前再统一替换;不要留裸反引号。实地会话里一次裸反引号就导致整份
134
+ 20k 字符的讲义重新生成。
135
+
119
136
  按第 4 节的规范把字幕蒸馏成讲义,然后用 `zju_write_note` 写入。**文件名由你自己起**——
120
137
  按「上课日期 + 课程 + 本节内容」命名,一眼能看出是哪一讲:
121
138
 
122
139
  ```
140
+ # 短讲义:直接传全文
123
141
  zju_write_note(
124
142
  sub_id="<sub_id>",
125
143
  name="知识总结-<上课日期 YYYY-MM-DD>-<课程简称>-<本节主题>",
126
144
  content="<讲义 Markdown 全文>",
127
145
  )
146
+
147
+ # 长讲义:先落盘,再 finalize(与 content 二选一)
148
+ zju_write_note(
149
+ sub_id="<sub_id>",
150
+ content_file=".zju-lecture/drafts/知识总结-<日期>-<课程>-<主题>.md",
151
+ name="知识总结-<上课日期 YYYY-MM-DD>-<课程简称>-<本节主题>",
152
+ )
128
153
  ```
129
154
 
130
155
  - **命名模板**:`知识总结-2026-10-28-复变函数-保角映射与拉普拉斯变换.md`。
131
156
  日期写上,讲义就会按时间自然排序;主题写具体(「第 7 章」「上」这类含糊的词不要用)。
132
157
  - **不要往 `content` 里塞二进制**:不要把 PDF、图片或整份课件塞进讲义。投影截图只在可选的
133
- 「PPT 投影抓取」模块开启时按追加的规范处理。
158
+ 「PPT 投影抓取」模块开启时按追加的规范处理。长篇讲义用 `content_file`,避免把全文重复粘贴。
134
159
  - **上课日期从哪来**(按优先级,都不要就省略日期段):
135
160
  用户明确给出的日期 > 课件首页/回放页面上的日期 > 老师在课堂上提到"我们 10 月 28 日这节课…"。
136
161
  **拿不到日期就省略**,不要用今天的日期顶替——那会让文件名说谎。
@@ -143,6 +168,8 @@ zju_write_note(
143
168
  - 它写入前自动修可机械修复的公式问题,写入后立刻返回渲染检查报告;**默认还会在本地排一份同名 PDF**
144
169
  (插件设置 `renderPdf`,默认开启),所以通常**不需要再单独调 `zju_check_note`,也不需要额外调排版工具**。
145
170
  **先写文件,再校验,不要只在回复里贴公式。**
171
+ - 返回里的 `图片引用: N 张 | ...` 已经检查了本地图片是否存在;**不要再 `glob` 逐张确认**。
172
+ 出现「缺失/不可用」先修路径再交付;`PDF 提示:` 里是 Typst 对图片/排版的警告,也要读。
146
173
  - 交付时把两条路径都给用户:Markdown 是源文件,同名 `.pdf` 是阅读版。
147
174
  返回里出现 `PDF 跳过: …` 时照常交付 Markdown,**不要重试或假装 PDF 已生成**;
148
175
  若原因是 `找不到 typst`,调用一次 `zju_doctor(install=true, confirm=true)` 后重试 `zju_check_note(pdf=true)`,
@@ -17,7 +17,8 @@
17
17
  | **插图** | `slidesAsSource=false, embedSlideImages=true` | 抓一次投影,挑 3–8 张关键页插入 | `download=true, confirm=true` |
18
18
  | **仅抓取** | 两个子开关都关 | 抓一次清单核对页数/进度 | `download=false` |
19
19
 
20
- - 整节课只调用一次,不要循环抓取;失败一次就按返回的诊断降级,不要换后端重试。
20
+ - 整节课只调用一次,不要循环抓取;失败一次就按返回的诊断降级。工具会在主站为空/失败时
21
+ 自动回退互动式课堂后端,模型不要自行拼 URL 或换后端。
21
22
  - 模型不能查看本地图片时:**不要臆造幻灯片文字**。投影讲义模式在文末列截图索引并说明
22
23
  哪些内容未核对;插图模式只列索引;仅抓取模式只用字幕。
23
24
  - 投影接口只有截图、没有文字层 / OCR;需要幻灯片原文时请用户提供 `.pptx`,走
@@ -25,8 +26,8 @@
25
26
 
26
27
  ## 1. 能力与边界
27
28
 
28
- `zju_fetch_slides` 抓取智云课堂该节课的投影 PPT **截图清单**。`search-ppt` 接口返回的是
29
- 投影画面截图(`pptimgurl`),**不是文字层,也不提供 OCR**。需要阅读幻灯片内容时:
29
+ `zju_fetch_slides` 抓取智云课堂 / 互动式课堂该节课的投影 PPT **截图清单**。`search-ppt`
30
+ 接口返回的是投影画面截图(`pptimgurl`),**不是文字层,也不提供 OCR**。需要阅读幻灯片内容时:
30
31
 
31
32
  - 设置 `download=true, confirm=true` 下载截图并合成 PDF,交给支持视觉的模型查看;
32
33
  - 宿主/模型不能看图时,只把截图当作索引,**不要臆造幻灯片文字**;
@@ -56,9 +57,12 @@
56
57
 
57
58
  `download=true, confirm=true` 时:
58
59
 
59
- - 截图存到工作区 `ppt-assets/<sub_id>/images/slide-XXXX.jpg`(JPEG 原样写入);
60
+ - 截图存到工作区 `ppt-assets/<sub_id>/slide-XXXX.jpg`(JPEG 原样写入);
60
61
  - 合成 `PPT-<sub_id>.pdf`;
61
- - 返回里给出截图目录、PDF 路径,以及每页的**工作区相对路径**与引用示例。
62
+ - 返回**紧凑索引**:截图目录、文件命名模式、页时间轴、建议抽查页与引用示例;
63
+ 不再逐页打印绝对路径,避免 150 页的索引本身占掉十几 k 字符。
64
+ - `页时间轴` 是相对第一页的 `HH:MM`,与字幕的 `[HH:MM]` 基本对齐;优先按时间轴选页,
65
+ 不要从第 1 页开始顺序通读。
62
66
 
63
67
  整节课的截图可能有几十到几百张,下载可能需要数分钟。**整节课只下载一次**,不要循环重复下载。
64
68
  `zju_fetch_slides` 在 dsh 里单独使用 600 秒超时,其他工具仍使用插件配置的超时。
@@ -70,8 +74,10 @@
70
74
  开启后,投影截图是与字幕并列的**内容来源**,不是配图:
71
75
 
72
76
  - 写讲义前抓一次并下载(`download=true, confirm=true`),整节课只抓一次;
73
- - 如果宿主能读图,逐页查看关键截图,把定义、公式、图例、例题写进对应小节,
74
- 并与字幕互相校正;不要只把截图当索引却声称读过正文;
77
+ - 如果宿主能读图,**按时间轴抽查 15–25 页**(没有时间轴时按页码均匀抽样):先从字幕挑 8–12 个关键节点
78
+ (定义、定理、公式推导、例题、易错点),每个节点读最近 1–2 页,把定义、公式、
79
+ 图例、例题写进对应小节,并与字幕互相校正;只有字幕与投影冲突或关键推导缺失时,
80
+ 再补读相邻页。超过 60 页的 deck **不要逐页通读**;
75
81
  - 老师口述与幻灯片不一致时以口述为准,并在正文用 `[易错]` 或 `⚠` 注明差异;
76
82
  - 宿主不能读图时**不要臆造幻灯片文字**:在文末列「课堂投影截图索引」,
77
83
  说明哪些内容未核对,正文仍以字幕与本地课件为准;
@@ -85,8 +91,8 @@
85
91
  开启后,从下载结果里挑 **3–8 张**最有讲解价值的页(定义、示意图、公式推导、例题),
86
92
  在对应小节插入 Markdown 图片。路径按**讲义所在目录**写:
87
93
 
88
- - 讲义在工作区根目录:`![第 12 页](ppt-assets/1988057/images/slide-0012.jpg)`
89
- - 讲义在 `notes/`:`![第 12 页](../ppt-assets/1988057/images/slide-0012.jpg)`
94
+ - 讲义在工作区根目录:`![第 12 页](ppt-assets/1988057/slide-0012.jpg)`
95
+ - 讲义在 `notes/`:`![第 12 页](../ppt-assets/1988057/slide-0012.jpg)`
90
96
 
91
97
  如果模型不能查看图片:**不要臆造截图内容**;在讲义末尾加「课堂投影截图索引」,
92
98
  列出页码与相对路径,正文仍以字幕与本地课件为准。
@@ -95,7 +101,8 @@
95
101
 
96
102
  - 只嵌入 3–8 张,不要把全部截图的二进制或整份 PDF 塞进上下文;
97
103
  - 图片必须有正文解释(图注或一句话说明),不能只堆图;
98
- - `zju_check_note` 不检查图片路径是否存在,写完后自己确认引用的文件确实在 `ppt-assets/` 下;
104
+ - `zju_write_note` / `zju_check_note` 会返回 `图片引用: N 张 | ...`,直接看这一行;
105
+ 不要再 `glob` 逐张确认,也不要把坏图留给 PDF 里的「图片未嵌入」占位;
99
106
  - 相对路径只在工作区内有效;要离线分享或换机器,直接发 `PPT-<sub_id>.pdf`。
100
107
 
101
108
  两个子开关都关闭(仅抓取模式)时:只调用一次 `download=false` 核对清单,
@@ -105,10 +112,11 @@
105
112
 
106
113
  投影接口需要登录态,且 Cookie 中必须包含 `_token`:
107
114
 
108
- - 服务端自动尝试:内存缓存 → `ZJU_COOKIE` 环境变量 → `ZJU_COOKIE_FILE` → 本机 Edge;
115
+ - 服务端自动尝试:内存缓存 → `ZJU_COOKIE` 环境变量 → `ZJU_COOKIE_FILE` → `zju_login` 保存的本机登录态 → 本机 Edge;
109
116
  - 从 Cookie 的父域 `.zju.edu.cn` 会话中解析 `_token`,再加 `Authorization: Bearer`;
110
- - 若本机 Edge 正在运行,Cookie 数据库会被独占锁定:提示用户**完全退出 Edge**(含后台驻留进程)后重试,
111
- 或在宿主配置里设置 `ZJU_COOKIE` / `ZJU_COOKIE_FILE`;
117
+ - 若本机 Edge 正在运行、Cookie 数据库被锁定,或 Edge 启用了 ABE 导致读不到:**不要要求用户退出 Edge,也不要让普通用户手工配置 Cookie 文件**;
118
+ 直接调用 `zju_login(url=<这节课链接>)` 打开独立登录窗口,用户正常登录后窗口自动关闭并保存登录态;
119
+ - 只有 `zju_login` 返回 `no_browser` / `devtools_blocked` 时,才提 `ZJU_COOKIE` / `ZJU_COOKIE_FILE` 作为高级兜底;
112
120
  - **不要让用户把 Cookie 粘贴进对话**,也不要把 Cookie 写进讲义或命令参数;
113
121
  - 工具不接受 cookie 参数,也不会回显明文;登录辅助模块开启时,`zju_read_browser_cookie`
114
122
  也只返回名称与长度。
@@ -117,6 +125,7 @@
117
125
 
118
126
  按失败原因给出一个可行动作,不要罗列互相矛盾的猜测:
119
127
 
120
- - 没有登录态 / 登录失效 → 引导用户设置 `ZJU_COOKIE_FILE` 或退出 Edge 后重试;
128
+ - 没有登录态 / 登录失效 → 调用 `zju_login(url=<这节课链接>)` 打开独立登录窗口,登录成功后重试一次;
129
+ 仍失败就按返回诊断给结论,不要反复重试,也不要让用户退出 Edge 或手工配置 Cookie;
121
130
  - 没有返回截图列表 → 确认回放链接带 `course_id`,或换一条更完整的链接;
122
131
  - 仍然失败 → **平滑降级为纯字幕总结**:跳过 PPT,直接用 `zju_fetch_transcript` 的字幕生成讲义。
@@ -55,7 +55,7 @@ description: 浙大智云课堂插件的登录辅助与故障排查(401/403、
55
55
  不要把文件内容发给模型或贴进对话。`ZJU_COOKIE` / `ZJU_COOKIE_FILE` 存在时优先级最高,
56
56
  配错会挡住 `zju_login`;指导用户检查或移除后再重试。
57
57
  - 若登录态显示可用但 401/403 仍存在:请用户确认官网同一账号能看同一节课的字幕,
58
- 然后重新调用 `zju_login`;**不要直接归因校园网,不要更换后端或主机**。
58
+ 然后重新调用 `zju_login`;工具已自动试过互动式课堂后端,**不要直接归因校园网或自行更换主机**。
59
59
  - 若接口返回业务错误(code≠0)或列表为空:检查 `sub_id`、课程权限、字幕是否已生成。
60
60
 
61
61
  ### B. 找不到命令或工具
@@ -1,13 +1,13 @@
1
1
  {
2
2
  "name": "zju-lecture-summarizer-help",
3
- "version": "2.2.8",
4
- "contentHash": "sha256:00bd81aacd7e965a05fde47f98e6d9e2ef3ca56e608a24baa6c433e8d734b709",
3
+ "version": "2.2.9",
4
+ "contentHash": "sha256:9ebbe22b9e7d69c7ed837daa4d2053d57a5b687c9ef9f8d2e3cc2fb481ee45d8",
5
5
  "fileCount": 1,
6
6
  "files": [
7
7
  {
8
8
  "path": "SKILL.md",
9
- "sha256": "00bd81aacd7e965a05fde47f98e6d9e2ef3ca56e608a24baa6c433e8d734b709",
10
- "size": 6541,
9
+ "sha256": "9ebbe22b9e7d69c7ed837daa4d2053d57a5b687c9ef9f8d2e3cc2fb481ee45d8",
10
+ "size": 6577,
11
11
  "mode": "0644"
12
12
  }
13
13
  ]
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "zju-lecture-summarizer-login",
3
- "version": "2.2.8",
3
+ "version": "2.2.9",
4
4
  "contentHash": "sha256:be91313617dbd1cfdc8bba3aff93c7291d616b0f395311d706fd5fba56103e08",
5
5
  "fileCount": 1,
6
6
  "files": [