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/lib/index.js CHANGED
@@ -5,13 +5,14 @@
5
5
  * 以语音字幕 + 本地课件为主链路;投影 PPT 截图是可选模块,由 `enableSlides` 开关。
6
6
  * 产出带时间戳、公式可渲染的讲义。
7
7
  *
8
- * 实现方式:插件最多注册 10 个原生 dsh 工具(默认只注册 6 个核心工具,可选模块按设置打开),
8
+ * 实现方式:插件最多注册 11 个原生 dsh 工具(默认只注册 7 个核心工具,可选模块按设置打开),
9
9
  * 内部复用随包分发的 Python 核心(与 MCP 插件同一份 mcp_server.py),
10
10
  * 通过 JSON-RPC over stdio 调用,保证「MCP 插件」与「dsh 插件」的行为完全一致。
11
11
  *
12
- * 隐私约定:插件自身不写用户目录、不收集遥测、不回显 Cookie;随包 Skill
13
- * 通过 dsh 的技能注册表**在内存中**注册,而不是复制到 $DSH_HOME/skills,
14
- * 因此安装/卸载都不会在本机留下数据副本。
12
+ * 隐私约定:插件不回显 Cookie、不收集遥测;`zju_login` 只在本机用户状态目录
13
+ * 安全保存登录态与独立登录窗口配置(Windows DPAPI;macOS / Linux 0600),
14
+ * 可用 `zju_login(clear=true)` 一并删除;随包 Skill 通过 dsh 的技能注册表
15
+ * **在内存中**注册,而不是复制到 $DSH_HOME/skills。
15
16
  */
16
17
 
17
18
  import { createHash } from "node:crypto";
@@ -81,6 +82,8 @@ const name = "dsh-zju-lecture-note";
81
82
  const PLUGIN_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
82
83
 
83
84
  const SKILL_NAME = "zju-lecture-summarizer";
85
+ const HELP_SKILL_NAME = "zju-lecture-summarizer-help";
86
+ const LOGIN_SKILL_NAME = "zju-lecture-summarizer-login";
84
87
 
85
88
  /**
86
89
  * The projection appendix of the transcript skill.
@@ -99,6 +102,13 @@ const SLIDES_SKILL_FILE = join(PLUGIN_ROOT, "skills", SKILL_NAME, "SLIDES.md");
99
102
  * transcript-only session never sees instructions for a tool that was not
100
103
  * registered.
101
104
  *
105
+ * `zju-lecture-summarizer-help` is a user-invocable troubleshooting SOP for
106
+ * login / 401/403 / dependency questions. It is deliberately not advertised to
107
+ * the model so it cannot displace the main note-writing skill.
108
+ * `zju-lecture-summarizer-login` is the one-command login window: it invokes `zju_login`
109
+ * and nothing else, so a user can refresh the local login without starting a
110
+ * note task.
111
+ *
102
112
  * `scholia-notes` is the fill-in study-note workflow: it turns a lecture note
103
113
  * into a Typst notebook with blanks (see `zju_build_study_notes`). It has no
104
114
  * appendix and no feature gate.
@@ -110,6 +120,20 @@ const SKILL_SPECS = [
110
120
  when: "always",
111
121
  appendices: [{ path: SLIDES_SKILL_FILE, when: "slides" }],
112
122
  },
123
+ {
124
+ name: HELP_SKILL_NAME,
125
+ fallbackDescription: "登录辅助与故障排查(不读取/回显凭据)",
126
+ when: "always",
127
+ appendices: [],
128
+ invocation: { modelInvocable: false, userInvocable: true },
129
+ },
130
+ {
131
+ name: LOGIN_SKILL_NAME,
132
+ fallbackDescription: "打开独立登录窗口,保存本机登录态",
133
+ when: "always",
134
+ appendices: [],
135
+ invocation: { modelInvocable: false, userInvocable: true },
136
+ },
113
137
  {
114
138
  name: "scholia-notes",
115
139
  fallbackDescription: "把 STEM 讲义排成填空式学习笔记(Typst → PDF)",
@@ -145,8 +169,8 @@ const Config = Schema.object({
145
169
  enableSlides: Schema.boolean()
146
170
  .description(
147
171
  "启用「PPT 投影抓取」可选模块(默认关闭):开启后注册 zju_fetch_slides,"
148
- + "可从课堂回放抓取投影截图并合成 PDF。关闭时插件只走「语音字幕 + 本地课件」链路,"
149
- + "不注册投影工具、不读取浏览器登录态、不下载截图;字幕接口本身公开免登录。",
172
+ + "可从课堂回放抓取投影截图并合成 PDF。关闭时不注册投影工具、不下载截图;"
173
+ + "字幕鉴权由核心链路自动完成,与投影独立。",
150
174
  )
151
175
  .default(false)
152
176
  .volatile(),
@@ -158,9 +182,9 @@ const Config = Schema.object({
158
182
  .volatile(),
159
183
  enableLoginTools: Schema.boolean()
160
184
  .description(
161
- "启用登录辅助工具(默认关闭):zju_get_video_url 解析视频直链、"
162
- + "zju_read_browser_cookie 读取本机 Edge 登录态。投影抓取会自行解析登录态,"
163
- + "不依赖这两个工具;只有需要下载视频或 Whisper 重识别时才打开。",
185
+ "启用登录辅助工具(默认关闭):注册 zju_get_video_url 解析视频直链、"
186
+ + "zju_read_browser_cookie 读取本机 Edge 登录态。字幕鉴权与一键登录窗口"
187
+ + "(zju_login)都属于核心链路,不受本开关影响;投影抓取也独立解析登录态。",
164
188
  )
165
189
  .default(false)
166
190
  .volatile(),
@@ -254,7 +278,8 @@ const SYSTEM_PROMPT = [
254
278
  "用户只说「整理这节课」时按完整链路一次做完,不要只交字幕摘要;只有明确说「只要速记 / 只要 Markdown」时才省略这些增强内容。",
255
279
  "ASR 可靠度低时按 Skill 的数学规范复算,并在讲义开头写明需要人工复核的时间点;公式必须符合 Skill 的「公式书写规范」。",
256
280
  "交付时给出 Markdown 路径;有 PDF 时一并给出 PDF 路径。不要声称看过自己无法查看的图片。",
257
- "隐私边界:登录 Cookie 只在 Python 进程内存里,工具不接受、也不回显 Cookie 明文;不要向用户索要 Cookie,或把它写进对话、文件、命令。",
281
+ "隐私边界:登录态只在本机安全保存或进程内存中使用;工具不接受、也不回显 Cookie / 密码 / token 明文;不要向用户索要 Cookie,或把它写进对话、文件、命令。",
282
+ "字幕先匿名;401/403 时先自动使用本机登录态;仍失败就调用 zju_login(url=<这节课链接>) 打开独立登录窗口,让用户在窗口里正常登录(成功后自动关闭并安全保存),然后重试字幕一次。不要让用户开开发者工具、手工配置 Cookie 文件,也不要把 401/403 直接归因校园网。",
258
283
  ].join("\n");
259
284
 
260
285
  /**
@@ -285,9 +310,9 @@ function slideImageRule(enabled) {
285
310
  function slidesFeatureRule(enableSlides, embedSlideImages) {
286
311
  if (!enableSlides) {
287
312
  return "PPT 投影抓取已关闭(插件设置 enableSlides=false):本会话没有注册 zju_fetch_slides,"
288
- + "不要尝试抓取或引用投影截图,也不要为了投影去读取浏览器 Cookie;"
289
- + "只用语音字幕与本地课件生成讲义。用户明确要投影画面时,"
290
- + "告诉他在插件设置里打开「启用 PPT 投影抓取」后重试。";
313
+ + "不要尝试抓取或引用投影截图,也不要为了投影额外读取浏览器 Cookie;"
314
+ + "字幕鉴权由字幕工具自行处理,需要登录时用 zju_login。只用语音字幕与本地课件生成讲义。"
315
+ + "用户明确要投影画面时,告诉他在插件设置里打开「启用 PPT 投影抓取」后重试。";
291
316
  }
292
317
  return "PPT 投影抓取已开启(插件设置 enableSlides=true):" + slideImageRule(embedSlideImages);
293
318
  }
@@ -315,11 +340,16 @@ function studyFeatureRule(enabled) {
315
340
  }
316
341
 
317
342
  function loginFeatureRule(enabled) {
343
+ const core = "`zju_login` 不受本开关影响,始终可用:需要登录时调用它打开独立登录窗口,"
344
+ + "用户只需在窗口里正常登录,窗口会自动关闭并把登录态安全保存在本机;"
345
+ + "不要让用户开开发者工具、手工配置 Cookie 文件或把凭据贴进对话。"
346
+ + "字幕鉴权也不依赖本开关:先匿名,401/403 时自动读取本机登录态并用 Bearer 重试一次;"
347
+ + "仍失败就调用 zju_login,登录成功后重试字幕一次,不要反复重试、擅断校园网或更换后端。";
318
348
  return enabled
319
- ? "登录辅助工具已开启(zju_get_video_url / zju_read_browser_cookie):"
320
- + "只在确实需要视频直链或预读登录态时使用,二者都不会回显 Cookie。"
349
+ ? "登录辅助工具已开启(zju_get_video_url / zju_read_browser_cookie):仅在需要视频直链或手动检查登录态时调用,"
350
+ + "二者都不会回显 Cookie。" + core
321
351
  : "登录辅助工具已关闭(enableLoginTools=false):本会话没有注册 zju_get_video_url / "
322
- + "zju_read_browser_cookie,不要调用;投影抓取会自行解析登录态,不受影响。";
352
+ + "zju_read_browser_cookie,不要调用。" + core + "投影抓取也会自行解析登录态。";
323
353
  }
324
354
 
325
355
  /** Build the (short) task prompt for one configuration. */
@@ -351,6 +381,7 @@ const TOOL_PRESENT = {
351
381
  zju_extract_courseware: { title: "提取本地课件文本", kind: "read" },
352
382
  zju_check_note: { title: "检查/修正讲义渲染规范", kind: "edit" },
353
383
  zju_write_note: { title: "写入讲义(自动命名 + 写后校验 + PDF)", kind: "edit" },
384
+ zju_login: { title: "打开独立登录窗口(保存本机登录态)", kind: "edit" },
354
385
  zju_get_video_url: { title: "解析回放视频直链", kind: "fetch" },
355
386
  zju_read_browser_cookie: { title: "读取本机 Edge 登录态", kind: "read" },
356
387
  zju_build_study_notes: { title: "生成填空式学习笔记(Typst → PDF)", kind: "edit" },
@@ -435,14 +466,16 @@ function readBundledSkills(configOrSlides = {}) {
435
466
  const text = splitFrontmatter(readFileSync(appendixFile, "utf8")).body.trim();
436
467
  if (text) content = `${body.trimEnd()}\n\n---\n\n${text}\n`;
437
468
  }
438
- skills.push({
469
+ const descriptor = {
439
470
  name: spec.name,
440
471
  description: description || spec.fallbackDescription,
441
472
  content,
442
473
  path: file,
443
474
  source: `plugin:${name}`,
444
475
  provider: name,
445
- });
476
+ };
477
+ if (spec.invocation) descriptor.invocation = spec.invocation;
478
+ skills.push(descriptor);
446
479
  }
447
480
  return skills;
448
481
  }
@@ -551,7 +584,8 @@ function apply(ctx, config = {}) {
551
584
  || tool.name === "zju_check_note"
552
585
  || tool.name === "zju_build_study_notes"
553
586
  || tool.name === "zju_doctor";
554
- const toolTimeoutMs = tool.name === "zju_fetch_slides"
587
+ const slowTool = tool.name === "zju_fetch_slides" || tool.name === "zju_login";
588
+ const toolTimeoutMs = slowTool
555
589
  ? Math.max(timeoutMs, SLOW_TOOL_TIMEOUT_MS)
556
590
  : pdfCapable
557
591
  ? Math.max(timeoutMs, COMPILE_TOOL_TIMEOUT_MS)
package/lib/tools.js CHANGED
@@ -15,7 +15,7 @@ export const ZJU_TOOLS = [
15
15
  },
16
16
  {
17
17
  "name": "zju_fetch_transcript",
18
- "description": "抓取智云课堂某节课的语音识别字幕(公开接口,无需登录)。默认 per_minute 带时间戳;长课用 chunked;同一节课只抓一次,per_segment 仅在确实需要秒级时间戳时用。",
18
+ "description": "抓取智云课堂某节课的语音识别字幕。先匿名;401/403 时自动用本机登录态重试一次。登录态只能来自本机 Edge 或 ZJU_COOKIE_FILE,不要传 Cookie。默认 per_minute 带时间戳;长课用 chunked;同一节课只抓一次,per_segment 仅在确实需要秒级时间戳时用。",
19
19
  "parameters": {
20
20
  "url_or_sub_id": {
21
21
  "description": "回放 URL 或 sub_id",
@@ -194,9 +194,29 @@ export const ZJU_TOOLS = [
194
194
  }
195
195
  }
196
196
  },
197
+ {
198
+ "name": "zju_login",
199
+ "description": "打开一个独立的浏览器登录窗口完成浙大登录(不接收密码,也不接收 Cookie)。用户在该窗口里正常登录后,窗口自动关闭,登录态安全保存在本机,后续字幕与投影自动复用。字幕/投影 401/403、ABE 导致 Edge Cookie 读不了、用户说「登录智云课堂」时调用。clear=true 清除本机登录态与独立登录窗口配置。",
200
+ "parameters": {
201
+ "url": {
202
+ "description": "登录后要打开的课堂链接(可选,仅接受 https 的 *.zju.edu.cn;建议传用户给的这节课链接)",
203
+ "type": "string"
204
+ },
205
+ "timeout_seconds": {
206
+ "description": "等待用户完成登录的最长秒数(默认 300,范围 30–540)",
207
+ "default": 300,
208
+ "type": "integer"
209
+ },
210
+ "clear": {
211
+ "description": "只清除本机保存的登录态与独立登录窗口配置,不打开窗口(默认 false)",
212
+ "default": false,
213
+ "type": "boolean"
214
+ }
215
+ }
216
+ },
197
217
  {
198
218
  "name": "zju_read_browser_cookie",
199
- "description": "读取本机 Edge 的 classroom.zju.edu.cn 登录态(含父域 .zju.edu.cn 的 _token)到服务端内存;只返回名称与长度,绝不回显明文,无参数。",
219
+ "description": "读取本机 Edge 的 classroom.zju.edu.cn 登录态(含父域 .zju.edu.cn 的 _token)到服务端内存;只返回名称与长度,绝不回显明文,无参数。Edge 启用 ABE 时会失败;这种情况改用 zju_login。",
200
220
  "parameters": {}
201
221
  },
202
222
  {
@@ -289,12 +309,17 @@ export const ZJU_TOOLS = [
289
309
  },
290
310
  {
291
311
  "name": "zju_doctor",
292
- "description": "检查本机依赖并给出可执行结论:Python、Typst(版本 / 路径 / 来源 / 是否满足 ≥0.13)、随包中文字体与离线 Typst 包、缓存目录。install=true 时下载并校验安装 Typst(SHA256 固定,仅官方 Release;可用 ZJU_TYPST_AUTO_INSTALL=0 关闭自动安装)。PDF 失败或用户问「为什么没有 PDF」时先跑它。",
312
+ "description": "检查本机依赖并给出可执行结论:Python、Typst(版本 / 路径 / 来源 / 是否满足 ≥0.13)、随包中文字体与离线 Typst 包、缓存目录、登录窗口是否可用、本机是否保存了登录态;login=true 时额外验证登录态是否真的可用。install=true 时下载并校验安装 Typst(SHA256 固定,仅官方 Release;可用 ZJU_TYPST_AUTO_INSTALL=0 关闭自动安装)。PDF 失败或用户问「为什么没有 PDF」时先跑它;没有任何输出时先跑它,再调用一次 zju_login。",
293
313
  "parameters": {
294
314
  "install": {
295
315
  "description": "缺少 Typst 时是否立即下载安装(默认否;安装约 20 MB)",
296
316
  "default": false,
297
317
  "type": "boolean"
318
+ },
319
+ "login": {
320
+ "description": "是否读取本机登录态检查可用性(默认否;不会回显凭据)",
321
+ "default": false,
322
+ "type": "boolean"
298
323
  }
299
324
  }
300
325
  }
@@ -12,7 +12,7 @@
12
12
  },
13
13
  {
14
14
  "name": "zju_fetch_transcript",
15
- "description": "抓取智云课堂某节课的语音识别字幕(公开接口,无需登录)。默认 per_minute 带时间戳;长课用 chunked;同一节课只抓一次,per_segment 仅在确实需要秒级时间戳时用。",
15
+ "description": "抓取智云课堂某节课的语音识别字幕。先匿名;401/403 时自动用本机登录态重试一次。登录态只能来自本机 Edge 或 ZJU_COOKIE_FILE,不要传 Cookie。默认 per_minute 带时间戳;长课用 chunked;同一节课只抓一次,per_segment 仅在确实需要秒级时间戳时用。",
16
16
  "parameters": {
17
17
  "url_or_sub_id": {
18
18
  "description": "回放 URL 或 sub_id",
@@ -191,9 +191,29 @@
191
191
  }
192
192
  }
193
193
  },
194
+ {
195
+ "name": "zju_login",
196
+ "description": "打开一个独立的浏览器登录窗口完成浙大登录(不接收密码,也不接收 Cookie)。用户在该窗口里正常登录后,窗口自动关闭,登录态安全保存在本机,后续字幕与投影自动复用。字幕/投影 401/403、ABE 导致 Edge Cookie 读不了、用户说「登录智云课堂」时调用。clear=true 清除本机登录态与独立登录窗口配置。",
197
+ "parameters": {
198
+ "url": {
199
+ "description": "登录后要打开的课堂链接(可选,仅接受 https 的 *.zju.edu.cn;建议传用户给的这节课链接)",
200
+ "type": "string"
201
+ },
202
+ "timeout_seconds": {
203
+ "description": "等待用户完成登录的最长秒数(默认 300,范围 30–540)",
204
+ "default": 300,
205
+ "type": "integer"
206
+ },
207
+ "clear": {
208
+ "description": "只清除本机保存的登录态与独立登录窗口配置,不打开窗口(默认 false)",
209
+ "default": false,
210
+ "type": "boolean"
211
+ }
212
+ }
213
+ },
194
214
  {
195
215
  "name": "zju_read_browser_cookie",
196
- "description": "读取本机 Edge 的 classroom.zju.edu.cn 登录态(含父域 .zju.edu.cn 的 _token)到服务端内存;只返回名称与长度,绝不回显明文,无参数。",
216
+ "description": "读取本机 Edge 的 classroom.zju.edu.cn 登录态(含父域 .zju.edu.cn 的 _token)到服务端内存;只返回名称与长度,绝不回显明文,无参数。Edge 启用 ABE 时会失败;这种情况改用 zju_login。",
197
217
  "parameters": {}
198
218
  },
199
219
  {
@@ -286,12 +306,17 @@
286
306
  },
287
307
  {
288
308
  "name": "zju_doctor",
289
- "description": "检查本机依赖并给出可执行结论:Python、Typst(版本 / 路径 / 来源 / 是否满足 ≥0.13)、随包中文字体与离线 Typst 包、缓存目录。install=true 时下载并校验安装 Typst(SHA256 固定,仅官方 Release;可用 ZJU_TYPST_AUTO_INSTALL=0 关闭自动安装)。PDF 失败或用户问「为什么没有 PDF」时先跑它。",
309
+ "description": "检查本机依赖并给出可执行结论:Python、Typst(版本 / 路径 / 来源 / 是否满足 ≥0.13)、随包中文字体与离线 Typst 包、缓存目录、登录窗口是否可用、本机是否保存了登录态;login=true 时额外验证登录态是否真的可用。install=true 时下载并校验安装 Typst(SHA256 固定,仅官方 Release;可用 ZJU_TYPST_AUTO_INSTALL=0 关闭自动安装)。PDF 失败或用户问「为什么没有 PDF」时先跑它;没有任何输出时先跑它,再调用一次 zju_login。",
290
310
  "parameters": {
291
311
  "install": {
292
312
  "description": "缺少 Typst 时是否立即下载安装(默认否;安装约 20 MB)",
293
313
  "default": false,
294
314
  "type": "boolean"
315
+ },
316
+ "login": {
317
+ "description": "是否读取本机登录态检查可用性(默认否;不会回显凭据)",
318
+ "default": false,
319
+ "type": "boolean"
295
320
  }
296
321
  }
297
322
  }