dsh-zju-lecture-note 2.2.4 → 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.
@@ -6,25 +6,37 @@ description: 整理浙江大学智云课堂(classroom.zju.edu.cn)课程回
6
6
  # 智云课堂课程知识总结 (ZJU Lecture Summarizer)
7
7
 
8
8
  本 Skill 指导 Agent 把浙江大学「智云课堂」(`classroom.zju.edu.cn`)的长篇课堂录音与回放,
9
- 转化为高浓度、前后一致、方便期末复习的结构化知识讲义。
9
+ 转化为高浓度、前后一致、方便期末复习的结构化知识讲义。字幕先匿名,401/403 时由工具自动使用本机登录态重试;
10
+ 需要登录时调用 `zju_login` 打开独立登录窗口,**不要让用户开开发者工具或手工配置 Cookie 文件**。
11
+
12
+ > 遇到登录 / 401/403 / 依赖问题,用户可调用 `/zju-lecture-summarizer-help` 排查;
13
+ > 想单独登录或刷新登录态,可调用 `/zju-lecture-summarizer-login`。
14
+ > 不要向用户索要 Cookie / 密码 / token,也不要把凭据贴进对话。
10
15
 
11
16
  ## 1. 可用工具
12
17
 
13
- | 工具 | 用途 | 鉴权 |
18
+ | 工具 | 用途 | 访问条件 |
14
19
  | :--- | :--- | :--- |
15
- | `zju_fetch_transcript` | 抓取语音识别字幕(支持切片、分块、限长);**直接吃 URL 或 sub_id** | **公开免登录** |
20
+ | `zju_fetch_transcript` | 抓取语音识别字幕(支持切片、分块、限长);**直接吃 URL 或 sub_id** | 先匿名;401/403 时自动用本机登录态重试一次 |
16
21
  | `zju_extract_courseware` | 提取本地 PPTX / DOCX / TXT / MD / PDF 课件文本 | 本地文件(拒绝凭据与浏览器数据) |
17
22
  | `zju_write_note` | 写入讲义:自动命名、拒绝静默覆盖、写前修正、写后校验,并按设置自动排版同名 PDF | 本地文件(只写工作区) |
18
23
  | `zju_check_note` | 检查/修复**已有**讲义(`write_note` 已自动检查,通常不必再调) | 本地文件 |
19
- | `zju_parse_url` | 只在需要单独拿 `course_id` 时用;抓字幕不需要先解析 | 公开 |
20
-
21
- > **字幕主链路**只依赖公开字幕接口与本地文件工具,**不需要登录态,也不依赖投影 PPT 抓取**。
22
- > 下面三个是可选模块,只有插件设置打开时才会注册:
24
+ | `zju_parse_url` | 只在需要单独拿 `course_id` 时用;抓字幕不需要先解析 | 本地解析 |
25
+ | `zju_login` | 打开独立登录窗口;用户登录后自动关闭,登录态安全保存到本机 | 需要用户点一下登录;不接收密码 / Cookie |
26
+
27
+ > **字幕主链路**不依赖投影 PPT 抓取。字幕工具先匿名请求;仅 HTTP 401/403 时自动读取本地登录态、
28
+ > 解析 Bearer 重试一次,不需要开启登录辅助工具。字幕只向 `classroom.zju.edu.cn` 发 Bearer,不发 Cookie 头。
29
+ > 本机没有可用登录态时,`zju_login` 会打开一个**独立**的 Edge / Chrome 登录窗口:
30
+ > 不碰用户日常浏览器,不用开发者工具,登录页自己处理 SSO / 2FA;成功后窗口自动关闭,
31
+ > Cookie 用系统能力安全保存(Windows DPAPI;macOS / Linux 为 0600 文件),只存登录态、不存账号密码。
32
+ >
33
+ > 下面三个是可选模块,只有插件设置打开时才会注册对应工具:
23
34
  >
24
- > - 投影截图 `zju_fetch_slides`(`enableSlides`);
35
+ > - 投影截图 `zju_fetch_slides`(`enableSlides`,独立解析登录态);
25
36
  > - 填空笔记 `zju_build_study_notes` + `scholia-notes` Skill(`enableStudyNotes`);
26
- > - 登录辅助 `zju_get_video_url` / `zju_read_browser_cookie`(`enableLoginTools`)。
37
+ > - 登录辅助 `zju_get_video_url` / `zju_read_browser_cookie`(`enableLoginTools`,dsh 默认关闭;不影响字幕鉴权)。
27
38
  >
39
+ > **`zju_login` 是核心工具,始终可用**,不受 `enableLoginTools` 影响。
28
40
  > 未注册的工具不要调用,也不要假装已经拿到它的结果。
29
41
 
30
42
  ## 2. 触发场景
@@ -55,7 +67,20 @@ flowchart TD
55
67
  1. **不要再先调 `zju_parse_url`**:`zju_fetch_transcript` 直接接受回放 URL 或 `sub_id`,
56
68
  自己解析 `sub_id` / `tenant_code`。只有投影抓取需要单独提供 `course_id` 时,
57
69
  才补一次 `zju_parse_url`。
58
- 2. **抓取语音字幕**(公开免登录,整节课只抓一次):
70
+ 2. **抓取语音字幕**(先匿名,整节课只抓一次):
71
+ - HTTP 401/403 后的 Bearer 重试由工具内部自动完成,不需先调读 Cookie 工具,也不需要开启登录辅助;
72
+ 登录态沿用本地缓存 / 环境变量 / 文件 / Edge,模型不传 Cookie 或 token。
73
+ - 若仍报 401/403,**不要反复重试、不要擅断为校园网限制,也不要擅自更换主机或后端**;
74
+ 调用一次 `zju_login(url=<这节课的链接>)`:
75
+ 1. 先告诉用户:「会弹出一个独立的登录窗口,请在窗口里正常登录;成功后窗口会自动关闭。」
76
+ 2. 用户完成登录后,工具会返回「登录成功」并给出 Cookie 条数;**不要索要或复述 Cookie**。
77
+ 3. 登录成功后重试 `zju_fetch_transcript` **一次**。最多调用 `zju_login` 两次;
78
+ 仍失败就停止,按返回的诊断给结论。
79
+ - **不要让用户开开发者工具复制 Cookie,也不要让普通用户配置 `ZJU_COOKIE_FILE`**;
80
+ 后者只用于无图形界面的服务器 / 无 Edge 的环境,属高级兜底。
81
+ - 不要保证「退出 Edge」能解决 ABE 问题;登录窗口与日常 Edge 的 ABE 无关。
82
+ - `zju_login` 返回 `no_browser` / `devtools_blocked` 时,按提示改用 `ZJU_COOKIE_FILE` 兜底,
83
+ 不要反复弹窗。
59
84
  - 默认 `view_format="per_minute"`,行首带 `[时:分]` 时间戳;
60
85
  - 只关心某段内容时传 `start_minute` / `end_minute` 精确切片;
61
86
  - **长课程(超过约 8 万字)或需要分批处理时改用 `view_format="chunked"`**,
@@ -239,13 +264,21 @@ zju_check_note(file_path="<讲义文件的路径>", fix=true)
239
264
  | 证明 | `[证明] …`(斜体 Proof. + **块末**小方块) | `**证明(…)**` |
240
265
 
241
266
  **标记是「块」的开头,不是一行**:`[定理]` / `[定义]` / `[例]` / `[证明]` 会一直排版到
242
- 下一个标记、下一个标题或整行粗体的伪标题为止 —— 定理里的块级公式、例题的解法段落、
243
- 证明的整段推导,直接写在标记下面(空行就是段落分隔),不用另起标记。
267
+ 下一个标记、下一个标题、整行粗体的伪标题、`>` 引用/提示块、以 `⚠` 开头的提醒段,
268
+ 或「粗体小标题 + 冒号」(如 `**矛盾从哪里来** \`[00:05]\`:…)、
269
+ 「短引导词 + 时间码 + 冒号」(如 `推导要点 \`[00:43]\`:…`,证明块除外)为止 ——
270
+ 定理里的块级公式、例题的解法段落、证明的整段推导,直接写在标记下面
271
+ (空行就是段落分隔),不用另起标记。
272
+ 例题四段式的 `**题目**` / `**切入点**` / `**关键步骤**` / `**易错点**` 是例外,会留在框里。
244
273
  `[证明]` 的小方块因此落在**块内最后一行**:证明要写到真正的结尾,
245
274
  不要把结论另起一段写在标记外面(否则方块停在半路,读者会以为证明已经结束)。
246
275
  `[直觉]` / `[练习]` / `[边注]` / `[强调]` 只吃标记行那一句。
247
276
  复习版例题的「题目 / 切入点 / 关键步骤 / 易错点」即使写在同一段里,排版时也会各自
248
277
  断段(标签紧跟句末标点即可),不必为了分行多敲空行。
278
+ 只写表里列出的中文标记;`[推导]` 这类未知标记不会形成装置,渲染器会按 `[证明]` 的
279
+ Proof 样式兜底(斜体 `Proof.` + 块末 qed,不套框),其余未知标记只排成加粗小标题。
280
+ Markdown 检查会提示 `unknown_marker`:推导 / 证明请写 `[证明]`,补注写 `[弱注]`,
281
+ 重点句写 `[强调]`,不要自造标记。
249
282
 
250
283
  其余标记(都用得上才写,别滥用):
251
284
 
@@ -0,0 +1,95 @@
1
+ ---
2
+ name: zju-lecture-summarizer-help
3
+ description: 浙大智云课堂插件的登录辅助与故障排查(401/403、登录态、代理、Typst/PDF、工具开关)。用户输入 /zju-lecture-summarizer-help 或询问插件为何不可用时使用。
4
+ ---
5
+
6
+ # 智云课堂插件:登录辅助与查错
7
+
8
+ 这是一个**排查命令**,不是讲义生成命令。先判断用户要解决什么,再按证据排查;不要一上来抓字幕、写讲义或改配置。
9
+
10
+ ## 隐私红线(优先于一切)
11
+
12
+ - 不要要求用户把 Cookie、`_token`、Bearer、密码或浏览器数据库内容粘贴到对话。
13
+ - 不要在回复、命令、文件或日志里复述任何凭据;如果用户已经贴出,提醒他撤回并重新登录/轮换,不要重复其中内容。
14
+ - 不要读取浏览器历史、密码或其他网站 Cookie;登录态只允许来自插件既有的本地来源:
15
+ `zju_login` 保存的本机登录态、`ZJU_COOKIE`、`ZJU_COOKIE_FILE` 或本机 Microsoft Edge。
16
+ - 不要建议关闭 TLS 校验,也不要把 Cookie / Bearer 发往 `classroom.zju.edu.cn` 之外的主机。
17
+ - 不要擅自修改用户环境变量、注册表、浏览器配置或 `~/.dsh`;需要用户操作时,只给最短步骤。
18
+ - 诊断结果只描述“可用 / 不可用、来源类别、错误类别、下一步”,不回显值。
19
+
20
+ ## 先确认症状
21
+
22
+ 如果用户没有说明,先问一句:是生成讲义、字幕 401/403、PDF、投影、填空笔记,还是找不到命令/工具?
23
+
24
+ ## 诊断顺序
25
+
26
+ 1. 先运行 `zju_doctor`(默认不读取登录态),确认 Python、Typst、字体、Typst 包和当前模块开关。
27
+ 2. 只有问题涉及登录或字幕 401/403 时,再运行 `zju_doctor(login=true)`。
28
+ 它只报告登录态是否可用、来源类别与 Bearer 是否可用,不返回值。
29
+ 3. 根据结果分流,不要跳过证据直接猜原因。
30
+
31
+ ### A. 字幕 401/403
32
+
33
+ - 插件先匿名请求;401/403 时自动读取本机登录态并用 Bearer 重试一次。
34
+ **不需要开启「登录辅助」工具**。
35
+ - **首选动作:调用 `zju_login(url=<这节课链接>)`**。它会弹出一个独立的
36
+ Edge / Chrome 登录窗口,不碰用户日常浏览器;用户在窗口里正常登录后,
37
+ 窗口自动关闭,登录态安全保存到本机(Windows DPAPI;macOS / Linux 为 0600 文件)。
38
+ 不需要开发者工具,不需要用户手工复制 Cookie,也不需要修改环境变量。
39
+ - 调用前先告诉用户:「会弹出一个独立登录窗口,请在里面完成登录;成功后窗口会自动关闭。」
40
+ 登录成功后重试字幕一次;**最多调用 `zju_login` 两次**,不要无限弹窗。
41
+ - 按 `zju_login` 返回的 `reason` 给一条动作:
42
+ - `no_browser`:本机没有 Edge / Chrome / Chromium。安装浏览器后重试;
43
+ 无图形界面的服务器改用 `ZJU_COOKIE_FILE`。
44
+ - `devtools_blocked` / `launch_failed`:企业策略或安全软件拦截了本机调试端口。
45
+ 重试一次;仍失败改用 `ZJU_COOKIE_FILE`。
46
+ - `timeout` / `closed`:用户没有在时限内完成登录,或提前关了窗口;重试一次即可。
47
+ - `save_failed`:本次会话可用,但重启后需要重新登录。检查用户目录写权限;
48
+ 或改用 `ZJU_COOKIE_FILE`。
49
+ - `bad_url`:只传 `https://*.zju.edu.cn` 的课堂链接,不要传其他站点。
50
+ - 如果 `zju_doctor(login=true)` 仍报 `abe` / `decrypt_failed` / `locked` / `no_rows`:
51
+ **不要建议反复退出 Edge**,直接调用 `zju_login`。这些原因只说明「读 Edge 数据库」失败,
52
+ 与独立登录窗口无关。
53
+ - **高级兜底**(仅当 `zju_login` 不可用,例如无图形界面的服务器):
54
+ 配置 `ZJU_COOKIE_FILE`,文件内只放一行 Cookie 头(含 `_token`),
55
+ 不要把文件内容发给模型或贴进对话。`ZJU_COOKIE` / `ZJU_COOKIE_FILE` 存在时优先级最高,
56
+ 配错会挡住 `zju_login`;指导用户检查或移除后再重试。
57
+ - 若登录态显示可用但 401/403 仍存在:请用户确认官网同一账号能看同一节课的字幕,
58
+ 然后重新调用 `zju_login`;**不要直接归因校园网,不要更换后端或主机**。
59
+ - 若接口返回业务错误(code≠0)或列表为空:检查 `sub_id`、课程权限、字幕是否已生成。
60
+
61
+ ### B. 找不到命令或工具
62
+
63
+ - `/zju-lecture-summarizer` 生成讲义;`/zju-lecture-summarizer-help` 是本排查命令;
64
+ `/zju-lecture-summarizer-login` 只负责打开登录窗口 / 清除本机登录态。
65
+ - 默认注册 7 个核心工具(含 `zju_login` 与 `zju_doctor`);投影(`enableSlides`)、
66
+ 填空笔记(`enableStudyNotes`)、登录辅助工具(`enableLoginTools`)是独立可选开关。
67
+ - 修改设置后必须**完全重启 DeepSeek Harness**,当前会话不会热加载新工具集。
68
+ - 字幕鉴权与 `zju_login` 都不受 `enableLoginTools` 影响,不要把“登录辅助关闭”误判成字幕不可用。
69
+ - 用户想清除本机登录态时,调用 `zju_login(clear=true)`,不要手工删文件。
70
+
71
+ ### C. PDF / Typst
72
+
73
+ - 先跑 `zju_doctor`;缺少 Typst 时用 `zju_doctor(install=true)`。
74
+ - 检查 `renderPdf` 是否开启;Markdown 写入成功而 PDF 失败时,先交付 Markdown。
75
+ - 不要让用户关闭证书校验或从非官方来源安装 Typst。
76
+
77
+ ### D. 代理 / 证书
78
+
79
+ - 查看 `HTTPS_PROXY` / `HTTP_PROXY` / `NO_PROXY`;代理 URL 的 userinfo 在诊断中已掩码。
80
+ - 不要在对话里展示完整代理凭据;不要建议关闭 TLS。
81
+ - 代理导致的问题优先让 `classroom.zju.edu.cn` 直连,或设置 `NO_PROXY`。
82
+
83
+ ### E. 投影 / 填空笔记
84
+
85
+ - 投影抓取需要 `enableSlides` 与可用登录态;登录态问题同样走 `zju_login`。
86
+ - 填空笔记需要 `enableStudyNotes` 与本机 Typst。
87
+ - 两个模块互不依赖;失败时先确认对应开关与 `zju_doctor`,不要混在一起猜。
88
+
89
+ ## 回复格式
90
+
91
+ - 先给一句结论,再分「已确认」「还需要你确认」「下一步」。
92
+ - 最多给 3 个可执行步骤;需要用户操作时,说明完成后回复什么(例如“已登录 Edge,重试”)。
93
+ - 没有工具结果时,不要声称“已经验证”或“已经修复”。
94
+ - 报告问题时可让用户提供:操作系统、dsh 版本、插件版本、工具名、脱敏后的错误文本;
95
+ **不要**要求 Cookie、token、完整 HAR、课程个人数据或代理凭据。
@@ -0,0 +1,14 @@
1
+ {
2
+ "name": "zju-lecture-summarizer-help",
3
+ "version": "2.2.5",
4
+ "contentHash": "sha256:4b240b3eb2e4d5d23947eebc6867cbb0d1f3d64ffcba6c6ce2dc346e7929b86f",
5
+ "fileCount": 1,
6
+ "files": [
7
+ {
8
+ "path": "SKILL.md",
9
+ "sha256": "4b240b3eb2e4d5d23947eebc6867cbb0d1f3d64ffcba6c6ce2dc346e7929b86f",
10
+ "size": 6455,
11
+ "mode": "0644"
12
+ }
13
+ ]
14
+ }
@@ -0,0 +1,40 @@
1
+ ---
2
+ name: zju-lecture-summarizer-login
3
+ description: 打开浙大智云课堂的独立登录窗口并保存本机登录态。用户输入 /zju-lecture-summarizer-login、要求登录/刷新登录智云课堂,或字幕与投影遇到 401/403 需要登录时使用。
4
+ ---
5
+
6
+ # 登录智云课堂
7
+
8
+ 这个命令只做一件事:**调用 `zju_login` 打开独立登录窗口**。不要顺便抓字幕、写讲义或改配置。
9
+
10
+ ## 怎么做
11
+
12
+ 1. 如果用户给了课堂链接,把链接放进 `url`;没有就省略,窗口会打开智云课堂首页。
13
+ 2. 调用前用一句话告诉用户:
14
+ 「会弹出一个独立的 Edge / Chrome 登录窗口,请在窗口里正常登录;成功后窗口会自动关闭,
15
+ 登录态会安全保存在本机,不会保存账号密码。」
16
+ 3. 调用 `zju_login(url="<链接>", timeout_seconds=300)`,然后等待工具返回。
17
+ 工具会阻塞到登录完成、超时或窗口被关闭;不要在此期间重复调用。
18
+ 4. 成功后只报告:浏览器、Cookie 条数、是否已保存。**不要输出、索要或复述任何 Cookie / token / 密码**。
19
+ 如果用户还有原本的抓字幕任务,接着回到原任务即可;否则到此结束。
20
+ 5. 用户明确要退出登录 / 清除本机登录态时,调用 `zju_login(clear=true)`;
21
+ 它会删除本机登录态与独立登录窗口配置。不要手工删文件或改环境变量。
22
+
23
+ ## 失败时
24
+
25
+ 按工具返回的 `reason` 给一条动作,不要反复弹窗:
26
+
27
+ - `no_browser`:本机没有 Edge / Chrome / Chromium。安装浏览器后重试;
28
+ 无图形界面的服务器改用 `ZJU_COOKIE_FILE`(高级兜底)。
29
+ - `devtools_blocked` / `launch_failed`:安全软件或企业策略拦截了本机调试端口。
30
+ 重试一次;仍失败改用 `ZJU_COOKIE_FILE`。
31
+ - `timeout` / `closed`:用户没有在时限内完成登录,或提前关了窗口;重试一次即可。
32
+ - `save_failed`:本次会话可用,但重启后要重新登录。检查用户目录写权限,或改用 `ZJU_COOKIE_FILE`。
33
+ - `bad_url`:只接受 `https://*.zju.edu.cn` 的课堂链接。
34
+
35
+ ## 隐私红线
36
+
37
+ - 不接收、不回显密码、Cookie、token、HAR 或浏览器数据库内容。
38
+ - 不要求用户打开开发者工具,不要建议关闭 TLS 校验。
39
+ - 不要把登录态发往 `*.zju.edu.cn` 之外的主机。
40
+ - 不要修改用户的环境变量、注册表或日常浏览器的配置;登录窗口使用独立配置。
@@ -0,0 +1,14 @@
1
+ {
2
+ "name": "zju-lecture-summarizer-login",
3
+ "version": "2.2.5",
4
+ "contentHash": "sha256:8e077abdc6e0186b1ca253824adad30080a040a5dc2d8eb817fc6269e4f12010",
5
+ "fileCount": 1,
6
+ "files": [
7
+ {
8
+ "path": "SKILL.md",
9
+ "sha256": "8e077abdc6e0186b1ca253824adad30080a040a5dc2d8eb817fc6269e4f12010",
10
+ "size": 2459,
11
+ "mode": "0644"
12
+ }
13
+ ]
14
+ }
@@ -1,13 +1,13 @@
1
1
  {
2
2
  "name": "zju-lecture-summarizer",
3
- "version": "2.2.4",
4
- "contentHash": "sha256:1a0bfd803ef9ecd27932b8de1a8fb23c1ff48cc991c346c0d5de43aa2741184b",
3
+ "version": "2.2.5",
4
+ "contentHash": "sha256:7e8b14eee6f9fb3a6e7d73ec14f7a6ac10af865b630911ca1a2264afbadc59d9",
5
5
  "fileCount": 2,
6
6
  "files": [
7
7
  {
8
8
  "path": "SKILL.md",
9
- "sha256": "1a0bfd803ef9ecd27932b8de1a8fb23c1ff48cc991c346c0d5de43aa2741184b",
10
- "size": 22044,
9
+ "sha256": "7e8b14eee6f9fb3a6e7d73ec14f7a6ac10af865b630911ca1a2264afbadc59d9",
10
+ "size": 25423,
11
11
  "mode": "0644"
12
12
  },
13
13
  {
@@ -75,6 +75,15 @@ _LAZY_EXPORTS = {
75
75
  "render_handout": ".handout",
76
76
  "compile_handout": ".handout",
77
77
  "compile_handout_file": ".handout",
78
+ # The login window is interactive: import it only when the user actually
79
+ # opens it, not for every transcript fetch.
80
+ "LoginError": ".browser_login",
81
+ "open_login_window": ".browser_login",
82
+ "load_session_cookie": ".browser_login",
83
+ "save_session": ".browser_login",
84
+ "clear_session": ".browser_login",
85
+ "session_summary": ".browser_login",
86
+ "login_available": ".browser_login",
78
87
  }
79
88
 
80
89
 
@@ -109,6 +118,13 @@ __all__ = [
109
118
  "render_handout",
110
119
  "compile_handout",
111
120
  "compile_handout_file",
121
+ "LoginError",
122
+ "open_login_window",
123
+ "load_session_cookie",
124
+ "save_session",
125
+ "clear_session",
126
+ "session_summary",
127
+ "login_available",
112
128
  "extract_courseware_text",
113
129
  "check_markdown",
114
130
  "fix_markdown",