dsh-zju-lecture-note 2.2.7 → 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/ATTRIBUTION.md +1 -1
- package/CHANGELOG.md +108 -2
- package/README.md +57 -25
- package/SECURITY.md +96 -51
- package/docs/technical.md +98 -40
- package/lib/bridge.js +12 -2
- package/lib/client.js +142 -36
- package/lib/index.js +130 -22
- package/lib/tools.js +14 -11
- package/lib/tools.schema.json +14 -11
- package/mcp.json +21 -0
- package/mcp_server.py +258 -43
- package/package.json +5 -2
- package/plugin.json +19 -0
- package/server.mjs +118 -0
- package/skills/scholia-notes.manifest.json +1 -1
- package/skills/zju-lecture-summarizer/SKILL.md +46 -9
- package/skills/zju-lecture-summarizer/SLIDES.md +58 -14
- package/skills/zju-lecture-summarizer-help/SKILL.md +2 -2
- package/skills/zju-lecture-summarizer-help.manifest.json +4 -4
- package/skills/zju-lecture-summarizer-login.manifest.json +1 -1
- package/skills/zju-lecture-summarizer.manifest.json +6 -6
- package/zju_lecture/__init__.py +6 -0
- package/zju_lecture/browser_login.py +176 -222
- package/zju_lecture/cli.py +24 -2
- package/zju_lecture/client.py +325 -116
- package/zju_lecture/cookies.py +43 -4
- package/zju_lecture/credential_store.py +621 -0
- package/zju_lecture/deps.py +16 -0
- package/zju_lecture/formatter.py +201 -3
- package/zju_lecture/handout.py +29 -3
- package/zju_lecture/slides.py +9 -7
- package/zju_lecture/study_notes.py +4 -0
package/server.mjs
ADDED
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* Launcher for the ZJU Lecture MCP server.
|
|
4
|
+
*
|
|
5
|
+
* The MCP server itself is implemented in Python (standard library only), so
|
|
6
|
+
* this launcher resolves a usable interpreter at runtime and then pipes stdio
|
|
7
|
+
* through to it. That keeps one cross-platform command (`node`) in the
|
|
8
|
+
* plugin manifest while still working on hosts where only `python3` exists
|
|
9
|
+
* and on hosts where only `python` exists.
|
|
10
|
+
*/
|
|
11
|
+
|
|
12
|
+
import { spawn, spawnSync } from 'node:child_process';
|
|
13
|
+
import { existsSync } from 'node:fs';
|
|
14
|
+
import path from 'node:path';
|
|
15
|
+
import { fileURLToPath } from 'node:url';
|
|
16
|
+
|
|
17
|
+
const here = path.dirname(fileURLToPath(import.meta.url));
|
|
18
|
+
const serverScript = path.join(here, 'mcp_server.py');
|
|
19
|
+
const MIN_PYTHON = [3, 9];
|
|
20
|
+
|
|
21
|
+
const CANDIDATES = [
|
|
22
|
+
{ command: 'python3', args: [] },
|
|
23
|
+
{ command: 'python', args: [] },
|
|
24
|
+
{ command: 'py', args: ['-3'] },
|
|
25
|
+
];
|
|
26
|
+
|
|
27
|
+
// An explicit interpreter (same variable the dsh plugin honours) wins.
|
|
28
|
+
if (process.env.ZJU_PYTHON && process.env.ZJU_PYTHON.trim()) {
|
|
29
|
+
CANDIDATES.unshift({ command: process.env.ZJU_PYTHON.trim(), args: [] });
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
function parseVersion(text) {
|
|
33
|
+
const match = String(text || '').match(/(\d+)\.(\d+)/);
|
|
34
|
+
if (!match) return null;
|
|
35
|
+
return [Number(match[1]), Number(match[2])];
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
function probe(candidate) {
|
|
39
|
+
try {
|
|
40
|
+
const result = spawnSync(candidate.command, [...candidate.args, '--version'], {
|
|
41
|
+
encoding: 'utf8',
|
|
42
|
+
timeout: 20000,
|
|
43
|
+
windowsHide: true,
|
|
44
|
+
});
|
|
45
|
+
if (result.error || result.status !== 0) return null;
|
|
46
|
+
const version = parseVersion(result.stdout || result.stderr);
|
|
47
|
+
if (!version) return null;
|
|
48
|
+
if (version[0] < MIN_PYTHON[0] || (version[0] === MIN_PYTHON[0] && version[1] < MIN_PYTHON[1])) {
|
|
49
|
+
return null;
|
|
50
|
+
}
|
|
51
|
+
return { ...candidate, version: version.join('.') };
|
|
52
|
+
} catch {
|
|
53
|
+
return null;
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
function resolvePython() {
|
|
58
|
+
for (const candidate of CANDIDATES) {
|
|
59
|
+
const resolved = probe(candidate);
|
|
60
|
+
if (resolved) return resolved;
|
|
61
|
+
}
|
|
62
|
+
return null;
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
function fail(message) {
|
|
66
|
+
process.stderr.write(`[zju-lecture] ${message}\n`);
|
|
67
|
+
process.exit(1);
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
if (!existsSync(serverScript)) {
|
|
71
|
+
fail(`找不到 MCP 服务器脚本:${serverScript}`);
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
const python = resolvePython();
|
|
75
|
+
if (!python) {
|
|
76
|
+
fail(
|
|
77
|
+
'未找到可用的 Python 3.9+ 解释器(尝试过 python3 / python / py -3)。\n' +
|
|
78
|
+
'请安装 Python 3.9 或更高版本并确保它在 PATH 中,然后重试。',
|
|
79
|
+
);
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
const child = spawn(python.command, [...python.args, serverScript], {
|
|
83
|
+
stdio: ['pipe', 'pipe', 'pipe'],
|
|
84
|
+
windowsHide: true,
|
|
85
|
+
env: {
|
|
86
|
+
...process.env,
|
|
87
|
+
PYTHONUTF8: '1',
|
|
88
|
+
PYTHONIOENCODING: 'utf-8',
|
|
89
|
+
PYTHONUNBUFFERED: '1',
|
|
90
|
+
},
|
|
91
|
+
});
|
|
92
|
+
|
|
93
|
+
process.stderr.write(`[zju-lecture] MCP server starting with ${python.command} (Python ${python.version})\n`);
|
|
94
|
+
|
|
95
|
+
child.stdout.on('error', () => {});
|
|
96
|
+
child.stderr.on('error', () => {});
|
|
97
|
+
child.stdout.pipe(process.stdout);
|
|
98
|
+
child.stderr.pipe(process.stderr);
|
|
99
|
+
|
|
100
|
+
process.stdin.on('error', () => {});
|
|
101
|
+
process.stdin.pipe(child.stdin);
|
|
102
|
+
|
|
103
|
+
for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
|
|
104
|
+
process.on(signal, () => {
|
|
105
|
+
if (!child.killed) child.kill(signal);
|
|
106
|
+
});
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
child.on('exit', (code, signal) => {
|
|
110
|
+
if (signal) {
|
|
111
|
+
process.exit(1);
|
|
112
|
+
}
|
|
113
|
+
process.exit(code === null ? 0 : code);
|
|
114
|
+
});
|
|
115
|
+
|
|
116
|
+
child.on('error', (error) => {
|
|
117
|
+
fail(`启动 Python 进程失败:${error && error.message ? error.message : String(error)}`);
|
|
118
|
+
});
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: zju-lecture-summarizer
|
|
3
|
-
description: 整理浙江大学智云课堂(classroom.zju.edu.cn
|
|
3
|
+
description: 整理浙江大学智云课堂(classroom.zju.edu.cn)与互动式课堂(interactivemeta.cmc.zju.edu.cn)课程回放为结构化讲义。用户给出普通或 hash 路由回放链接或 sub_id、要求总结/整理课堂笔记、提取某段时间的讲解内容、整理考点预测或公式清单时使用。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# 智云课堂课程知识总结 (ZJU Lecture Summarizer)
|
|
@@ -25,10 +25,11 @@ description: 整理浙江大学智云课堂(classroom.zju.edu.cn)课程回
|
|
|
25
25
|
| `zju_login` | 打开独立登录窗口;用户登录后自动关闭,登录态安全保存到本机 | 需要用户点一下登录;不接收密码 / Cookie |
|
|
26
26
|
|
|
27
27
|
> **字幕主链路**不依赖投影 PPT 抓取。字幕工具先匿名请求;仅 HTTP 401/403 时自动读取本地登录态、
|
|
28
|
-
> 解析 Bearer
|
|
28
|
+
> 解析 Bearer 重试,不需要开启登录辅助工具。携带登录态时若主站失败,工具会自动回退
|
|
29
|
+
> `interactivemeta.cmc.zju.edu.cn` 互动式课堂后端;字幕只向这两个浙大官方主机发 Bearer,不发 Cookie 头。
|
|
29
30
|
> 本机没有可用登录态时,`zju_login` 会打开一个**独立**的 Edge / Chrome 登录窗口:
|
|
30
31
|
> 不碰用户日常浏览器,不用开发者工具,登录页自己处理 SSO / 2FA;成功后窗口自动关闭,
|
|
31
|
-
> Cookie
|
|
32
|
+
> Cookie 只写入平台凭据库(Windows DPAPI / macOS 钥匙串 / Linux 密钥环,静态加密;都不可用时不落盘),只存登录态、不存账号密码。
|
|
32
33
|
>
|
|
33
34
|
> 下面三个是可选模块,只有插件设置打开时才会注册对应工具:
|
|
34
35
|
>
|
|
@@ -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 分钟")老师讲解的内容。
|
|
@@ -62,6 +64,10 @@ flowchart TD
|
|
|
62
64
|
H2 --> I
|
|
63
65
|
```
|
|
64
66
|
|
|
67
|
+
> 若系统提示写明投影已开启,材料收集还要按模式调用 `zju_fetch_slides`(见步骤一第 3 条);
|
|
68
|
+
> **投影讲义模式(`slidesAsSource`)下它是必做步骤,不是可选附录**。整节课只抓一次,
|
|
69
|
+
> 抓不到就平滑降级为纯字幕。
|
|
70
|
+
|
|
65
71
|
### 步骤一:材料收集(省 token 顺序)
|
|
66
72
|
|
|
67
73
|
1. **不要再先调 `zju_parse_url`**:`zju_fetch_transcript` 直接接受回放 URL 或 `sub_id`,
|
|
@@ -70,8 +76,9 @@ flowchart TD
|
|
|
70
76
|
2. **抓取语音字幕**(先匿名,整节课只抓一次):
|
|
71
77
|
- HTTP 401/403 后的 Bearer 重试由工具内部自动完成,不需先调读 Cookie 工具,也不需要开启登录辅助;
|
|
72
78
|
登录态沿用本地缓存 / 环境变量 / 文件 / Edge,模型不传 Cookie 或 token。
|
|
73
|
-
-
|
|
74
|
-
|
|
79
|
+
- 主站失败时工具会自动尝试互动式课堂后端,不要自行拼 URL、换主机或换后端;
|
|
80
|
+
若仍报 401/403,**不要反复重试、不要擅断为校园网限制**,调用一次
|
|
81
|
+
`zju_login(url=<这节课的链接>)`:
|
|
75
82
|
1. 先告诉用户:「会弹出一个独立的登录窗口,请在窗口里正常登录;成功后窗口会自动关闭。」
|
|
76
83
|
2. 用户完成登录后,工具会返回「登录成功」并给出 Cookie 条数;**不要索要或复述 Cookie**。
|
|
77
84
|
3. 登录成功后重试 `zju_fetch_transcript` **一次**。最多调用 `zju_login` 两次;
|
|
@@ -96,31 +103,59 @@ flowchart TD
|
|
|
96
103
|
- 课件用于校准专业术语、公式与章节结构;没有课件时只用字幕,**不要臆造课件内容**;
|
|
97
104
|
- 老师现场投影的画面属于独立的可选「PPT 投影抓取」模块(`zju_fetch_slides`)。
|
|
98
105
|
该模块未开启时工具不会注册,**不要尝试抓取或引用投影截图**;用户确实需要时,
|
|
99
|
-
|
|
106
|
+
提示他在插件设置里打开「抓取投影截图」。开启后按系统提示里写明的模式执行:
|
|
107
|
+
- **投影讲义模式**(`slidesAsSource`):写讲义前**必须**先抓一次投影并下载
|
|
108
|
+
(`download=true, confirm=true`),把幻灯片上的定义、公式、图例、例题与字幕对照写入正文;
|
|
109
|
+
- **插图模式**(`embedSlideImages`):抓一次并挑 3–8 张关键页插入;
|
|
110
|
+
- **仅抓取模式**:只调用一次 `download=false` 核对清单,不下载、不插图、不当内容来源。
|
|
111
|
+
整节课只抓一次;登录态不可用时平滑降级为纯字幕,不要反复重试。
|
|
100
112
|
|
|
101
113
|
### 步骤二:蒸馏与产出
|
|
102
114
|
|
|
103
115
|
> **默认按「复习版」交付**:用户只说「整理这节课」时,一次做完——讲义里有例题拆解、
|
|
104
116
|
> 文末有自测题;只有用户明确说「只要速记 / 只要 Markdown」时才省略这些增强内容。
|
|
105
|
-
> 可选模块打开时也默认执行:`enableSlides` →
|
|
117
|
+
> 可选模块打开时也默认执行:`enableSlides` → 写讲义前按系统提示的模式抓一次投影
|
|
118
|
+
> (投影讲义模式必须下载并阅读,插图模式挑 3–8 张,仅抓取模式只看清单);
|
|
106
119
|
> `enableStudyNotes` → 写完讲义再出填空版(底稿的挖空用 `mode=patch` 一次写回,
|
|
107
120
|
> 不要一处一处改)。
|
|
108
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
|
+
|
|
109
136
|
按第 4 节的规范把字幕蒸馏成讲义,然后用 `zju_write_note` 写入。**文件名由你自己起**——
|
|
110
137
|
按「上课日期 + 课程 + 本节内容」命名,一眼能看出是哪一讲:
|
|
111
138
|
|
|
112
139
|
```
|
|
140
|
+
# 短讲义:直接传全文
|
|
113
141
|
zju_write_note(
|
|
114
142
|
sub_id="<sub_id>",
|
|
115
143
|
name="知识总结-<上课日期 YYYY-MM-DD>-<课程简称>-<本节主题>",
|
|
116
144
|
content="<讲义 Markdown 全文>",
|
|
117
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
|
+
)
|
|
118
153
|
```
|
|
119
154
|
|
|
120
155
|
- **命名模板**:`知识总结-2026-10-28-复变函数-保角映射与拉普拉斯变换.md`。
|
|
121
156
|
日期写上,讲义就会按时间自然排序;主题写具体(「第 7 章」「上」这类含糊的词不要用)。
|
|
122
157
|
- **不要往 `content` 里塞二进制**:不要把 PDF、图片或整份课件塞进讲义。投影截图只在可选的
|
|
123
|
-
「PPT
|
|
158
|
+
「PPT 投影抓取」模块开启时按追加的规范处理。长篇讲义用 `content_file`,避免把全文重复粘贴。
|
|
124
159
|
- **上课日期从哪来**(按优先级,都不要就省略日期段):
|
|
125
160
|
用户明确给出的日期 > 课件首页/回放页面上的日期 > 老师在课堂上提到"我们 10 月 28 日这节课…"。
|
|
126
161
|
**拿不到日期就省略**,不要用今天的日期顶替——那会让文件名说谎。
|
|
@@ -133,6 +168,8 @@ zju_write_note(
|
|
|
133
168
|
- 它写入前自动修可机械修复的公式问题,写入后立刻返回渲染检查报告;**默认还会在本地排一份同名 PDF**
|
|
134
169
|
(插件设置 `renderPdf`,默认开启),所以通常**不需要再单独调 `zju_check_note`,也不需要额外调排版工具**。
|
|
135
170
|
**先写文件,再校验,不要只在回复里贴公式。**
|
|
171
|
+
- 返回里的 `图片引用: N 张 | ...` 已经检查了本地图片是否存在;**不要再 `glob` 逐张确认**。
|
|
172
|
+
出现「缺失/不可用」先修路径再交付;`PDF 提示:` 里是 Typst 对图片/排版的警告,也要读。
|
|
136
173
|
- 交付时把两条路径都给用户:Markdown 是源文件,同名 `.pdf` 是阅读版。
|
|
137
174
|
返回里出现 `PDF 跳过: …` 时照常交付 Markdown,**不要重试或假装 PDF 已生成**;
|
|
138
175
|
若原因是 `找不到 typst`,调用一次 `zju_doctor(install=true, confirm=true)` 后重试 `zju_check_note(pdf=true)`,
|
|
@@ -3,11 +3,31 @@
|
|
|
3
3
|
> 本附录由 dsh 插件在 **`enableSlides`(启用 PPT 投影抓取)** 为 `true` 时追加到 Skill 中。
|
|
4
4
|
> 关闭时 `zju_fetch_slides` 不会被注册,也不应尝试读取登录态或下载截图。
|
|
5
5
|
> 字幕主链路(`zju_fetch_transcript` + `zju_extract_courseware`)不需要本附录。
|
|
6
|
+
>
|
|
7
|
+
> 开启后**以系统提示里写明的模式为准**(系统提示每次按当前设置重新生成);本附录末尾还会
|
|
8
|
+
> 追加一段「本次会话:投影……」的摘要。两者冲突时以系统提示为准。
|
|
9
|
+
|
|
10
|
+
## 0. 三种投影模式
|
|
11
|
+
|
|
12
|
+
`enableSlides` 只负责注册工具;写讲义前做什么由两个子开关决定:
|
|
13
|
+
|
|
14
|
+
| 模式 | 配置 | 写讲义前必须做的动作 | 是否下载 |
|
|
15
|
+
| :--- | :--- | :--- | :--- |
|
|
16
|
+
| **投影讲义** | `slidesAsSource=true` | 抓一次投影,把幻灯片内容与字幕对照写入正文 | `download=true, confirm=true` |
|
|
17
|
+
| **插图** | `slidesAsSource=false, embedSlideImages=true` | 抓一次投影,挑 3–8 张关键页插入 | `download=true, confirm=true` |
|
|
18
|
+
| **仅抓取** | 两个子开关都关 | 抓一次清单核对页数/进度 | `download=false` |
|
|
19
|
+
|
|
20
|
+
- 整节课只调用一次,不要循环抓取;失败一次就按返回的诊断降级。工具会在主站为空/失败时
|
|
21
|
+
自动回退互动式课堂后端,模型不要自行拼 URL 或换后端。
|
|
22
|
+
- 模型不能查看本地图片时:**不要臆造幻灯片文字**。投影讲义模式在文末列截图索引并说明
|
|
23
|
+
哪些内容未核对;插图模式只列索引;仅抓取模式只用字幕。
|
|
24
|
+
- 投影接口只有截图、没有文字层 / OCR;需要幻灯片原文时请用户提供 `.pptx`,走
|
|
25
|
+
`zju_extract_courseware`。
|
|
6
26
|
|
|
7
27
|
## 1. 能力与边界
|
|
8
28
|
|
|
9
|
-
`zju_fetch_slides`
|
|
10
|
-
|
|
29
|
+
`zju_fetch_slides` 抓取智云课堂 / 互动式课堂该节课的投影 PPT **截图清单**。`search-ppt`
|
|
30
|
+
接口返回的是投影画面截图(`pptimgurl`),**不是文字层,也不提供 OCR**。需要阅读幻灯片内容时:
|
|
11
31
|
|
|
12
32
|
- 设置 `download=true, confirm=true` 下载截图并合成 PDF,交给支持视觉的模型查看;
|
|
13
33
|
- 宿主/模型不能看图时,只把截图当作索引,**不要臆造幻灯片文字**;
|
|
@@ -37,21 +57,42 @@
|
|
|
37
57
|
|
|
38
58
|
`download=true, confirm=true` 时:
|
|
39
59
|
|
|
40
|
-
- 截图存到工作区 `ppt-assets/<sub_id>/
|
|
60
|
+
- 截图存到工作区 `ppt-assets/<sub_id>/slide-XXXX.jpg`(JPEG 原样写入);
|
|
41
61
|
- 合成 `PPT-<sub_id>.pdf`;
|
|
42
|
-
-
|
|
62
|
+
- 返回**紧凑索引**:截图目录、文件命名模式、页时间轴、建议抽查页与引用示例;
|
|
63
|
+
不再逐页打印绝对路径,避免 150 页的索引本身占掉十几 k 字符。
|
|
64
|
+
- `页时间轴` 是相对第一页的 `HH:MM`,与字幕的 `[HH:MM]` 基本对齐;优先按时间轴选页,
|
|
65
|
+
不要从第 1 页开始顺序通读。
|
|
43
66
|
|
|
44
67
|
整节课的截图可能有几十到几百张,下载可能需要数分钟。**整节课只下载一次**,不要循环重复下载。
|
|
45
68
|
`zju_fetch_slides` 在 dsh 里单独使用 600 秒超时,其他工具仍使用插件配置的超时。
|
|
46
69
|
|
|
47
|
-
## 4.
|
|
70
|
+
## 4. 投影内容与截图入讲义
|
|
71
|
+
|
|
72
|
+
### 4.1 投影讲义模式(`slidesAsSource`,优先于插图模式)
|
|
73
|
+
|
|
74
|
+
开启后,投影截图是与字幕并列的**内容来源**,不是配图:
|
|
75
|
+
|
|
76
|
+
- 写讲义前抓一次并下载(`download=true, confirm=true`),整节课只抓一次;
|
|
77
|
+
- 如果宿主能读图,**按时间轴抽查 15–25 页**(没有时间轴时按页码均匀抽样):先从字幕挑 8–12 个关键节点
|
|
78
|
+
(定义、定理、公式推导、例题、易错点),每个节点读最近 1–2 页,把定义、公式、
|
|
79
|
+
图例、例题写进对应小节,并与字幕互相校正;只有字幕与投影冲突或关键推导缺失时,
|
|
80
|
+
再补读相邻页。超过 60 页的 deck **不要逐页通读**;
|
|
81
|
+
- 老师口述与幻灯片不一致时以口述为准,并在正文用 `[易错]` 或 `⚠` 注明差异;
|
|
82
|
+
- 宿主不能读图时**不要臆造幻灯片文字**:在文末列「课堂投影截图索引」,
|
|
83
|
+
说明哪些内容未核对,正文仍以字幕与本地课件为准;
|
|
84
|
+
- 登录失败或接口没有返回截图时,平滑降级为纯字幕,并在讲义开头注明「投影未使用」。
|
|
85
|
+
- 如果同时开启 `embedSlideImages`,再按 §4.2 挑 3–8 张关键页插入;不开启时正文仍必须
|
|
86
|
+
使用投影内容,只是不插图。
|
|
87
|
+
|
|
88
|
+
### 4.2 插图模式(`embedSlideImages`)
|
|
48
89
|
|
|
49
90
|
开关:讲义插图模式(`embedSlideImages`,默认 `false`)。
|
|
50
91
|
开启后,从下载结果里挑 **3–8 张**最有讲解价值的页(定义、示意图、公式推导、例题),
|
|
51
92
|
在对应小节插入 Markdown 图片。路径按**讲义所在目录**写:
|
|
52
93
|
|
|
53
|
-
- 讲义在工作区根目录:``
|
|
95
|
+
- 讲义在 `notes/`:``
|
|
55
96
|
|
|
56
97
|
如果模型不能查看图片:**不要臆造截图内容**;在讲义末尾加「课堂投影截图索引」,
|
|
57
98
|
列出页码与相对路径,正文仍以字幕与本地课件为准。
|
|
@@ -60,20 +101,22 @@
|
|
|
60
101
|
|
|
61
102
|
- 只嵌入 3–8 张,不要把全部截图的二进制或整份 PDF 塞进上下文;
|
|
62
103
|
- 图片必须有正文解释(图注或一句话说明),不能只堆图;
|
|
63
|
-
- `
|
|
104
|
+
- `zju_write_note` / `zju_check_note` 会返回 `图片引用: N 张 | ...`,直接看这一行;
|
|
105
|
+
不要再 `glob` 逐张确认,也不要把坏图留给 PDF 里的「图片未嵌入」占位;
|
|
64
106
|
- 相对路径只在工作区内有效;要离线分享或换机器,直接发 `PPT-<sub_id>.pdf`。
|
|
65
107
|
|
|
66
|
-
|
|
67
|
-
|
|
108
|
+
两个子开关都关闭(仅抓取模式)时:只调用一次 `download=false` 核对清单,
|
|
109
|
+
不下载、不插图、不把截图当内容来源;用户明确要求画面时再按需下载并列出截图索引。
|
|
68
110
|
|
|
69
111
|
## 5. 登录态与隐私
|
|
70
112
|
|
|
71
113
|
投影接口需要登录态,且 Cookie 中必须包含 `_token`:
|
|
72
114
|
|
|
73
|
-
- 服务端自动尝试:内存缓存 → `ZJU_COOKIE` 环境变量 → `ZJU_COOKIE_FILE` → 本机 Edge;
|
|
115
|
+
- 服务端自动尝试:内存缓存 → `ZJU_COOKIE` 环境变量 → `ZJU_COOKIE_FILE` → `zju_login` 保存的本机登录态 → 本机 Edge;
|
|
74
116
|
- 从 Cookie 的父域 `.zju.edu.cn` 会话中解析 `_token`,再加 `Authorization: Bearer`;
|
|
75
|
-
- 若本机 Edge
|
|
76
|
-
|
|
117
|
+
- 若本机 Edge 正在运行、Cookie 数据库被锁定,或 Edge 启用了 ABE 导致读不到:**不要要求用户退出 Edge,也不要让普通用户手工配置 Cookie 文件**;
|
|
118
|
+
直接调用 `zju_login(url=<这节课链接>)` 打开独立登录窗口,用户正常登录后窗口自动关闭并保存登录态;
|
|
119
|
+
- 只有 `zju_login` 返回 `no_browser` / `devtools_blocked` 时,才提 `ZJU_COOKIE` / `ZJU_COOKIE_FILE` 作为高级兜底;
|
|
77
120
|
- **不要让用户把 Cookie 粘贴进对话**,也不要把 Cookie 写进讲义或命令参数;
|
|
78
121
|
- 工具不接受 cookie 参数,也不会回显明文;登录辅助模块开启时,`zju_read_browser_cookie`
|
|
79
122
|
也只返回名称与长度。
|
|
@@ -82,6 +125,7 @@
|
|
|
82
125
|
|
|
83
126
|
按失败原因给出一个可行动作,不要罗列互相矛盾的猜测:
|
|
84
127
|
|
|
85
|
-
- 没有登录态 / 登录失效 →
|
|
128
|
+
- 没有登录态 / 登录失效 → 调用 `zju_login(url=<这节课链接>)` 打开独立登录窗口,登录成功后重试一次;
|
|
129
|
+
仍失败就按返回诊断给结论,不要反复重试,也不要让用户退出 Edge 或手工配置 Cookie;
|
|
86
130
|
- 没有返回截图列表 → 确认回放链接带 `course_id`,或换一条更完整的链接;
|
|
87
131
|
- 仍然失败 → **平滑降级为纯字幕总结**:跳过 PPT,直接用 `zju_fetch_transcript` 的字幕生成讲义。
|
|
@@ -34,7 +34,7 @@ description: 浙大智云课堂插件的登录辅助与故障排查(401/403、
|
|
|
34
34
|
**不需要开启「登录辅助」工具**。
|
|
35
35
|
- **首选动作:调用 `zju_login(url=<这节课链接>)`**。它会弹出一个独立的
|
|
36
36
|
Edge / Chrome 登录窗口,不碰用户日常浏览器;用户在窗口里正常登录后,
|
|
37
|
-
|
|
37
|
+
窗口自动关闭,登录态加密保存到平台凭据库(Windows DPAPI / macOS 钥匙串 / Linux 密钥环;都不可用时只在本次会话内有效)。
|
|
38
38
|
不需要开发者工具,不需要用户手工复制 Cookie,也不需要修改环境变量。
|
|
39
39
|
- 调用前先告诉用户:「会弹出一个独立登录窗口,请在里面完成登录;成功后窗口会自动关闭。」
|
|
40
40
|
登录成功后重试字幕一次;**最多调用 `zju_login` 两次**,不要无限弹窗。
|
|
@@ -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.
|
|
4
|
-
"contentHash": "sha256:
|
|
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": "
|
|
10
|
-
"size":
|
|
9
|
+
"sha256": "9ebbe22b9e7d69c7ed837daa4d2053d57a5b687c9ef9f8d2e3cc2fb481ee45d8",
|
|
10
|
+
"size": 6577,
|
|
11
11
|
"mode": "0644"
|
|
12
12
|
}
|
|
13
13
|
]
|
|
@@ -1,19 +1,19 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "zju-lecture-summarizer",
|
|
3
|
-
"version": "2.2.
|
|
4
|
-
"contentHash": "sha256:
|
|
3
|
+
"version": "2.2.9",
|
|
4
|
+
"contentHash": "sha256:9a1e26141a9cf32f38a7ad9c8290cf5a50b0d150638463d6db270667e8214eae",
|
|
5
5
|
"fileCount": 2,
|
|
6
6
|
"files": [
|
|
7
7
|
{
|
|
8
8
|
"path": "SKILL.md",
|
|
9
|
-
"sha256": "
|
|
10
|
-
"size":
|
|
9
|
+
"sha256": "9a1e26141a9cf32f38a7ad9c8290cf5a50b0d150638463d6db270667e8214eae",
|
|
10
|
+
"size": 28438,
|
|
11
11
|
"mode": "0644"
|
|
12
12
|
},
|
|
13
13
|
{
|
|
14
14
|
"path": "SLIDES.md",
|
|
15
|
-
"sha256": "
|
|
16
|
-
"size":
|
|
15
|
+
"sha256": "a4588d67c0a1d6e72b9b685d143ff262e50134cf1ce30582c67a589c6dfbd858",
|
|
16
|
+
"size": 8237,
|
|
17
17
|
"mode": "0644"
|
|
18
18
|
}
|
|
19
19
|
]
|
package/zju_lecture/__init__.py
CHANGED
|
@@ -9,14 +9,17 @@ ship this same implementation, so their tools behave identically.
|
|
|
9
9
|
|
|
10
10
|
from .client import (
|
|
11
11
|
BASE_URL,
|
|
12
|
+
INTERACTIVE_BASE_URL,
|
|
12
13
|
ZJUAPIError,
|
|
13
14
|
extract_classroom_token,
|
|
14
15
|
fetch_slides,
|
|
15
16
|
fetch_transcript,
|
|
16
17
|
fetch_video_url,
|
|
18
|
+
is_allowed_image_host,
|
|
17
19
|
is_zju_host,
|
|
18
20
|
normalize_slide,
|
|
19
21
|
parse_lecture_url,
|
|
22
|
+
secure_image_url,
|
|
20
23
|
secure_zju_url,
|
|
21
24
|
)
|
|
22
25
|
from .cookies import CookieAccessError, get_edge_cookie, read_edge_cookies
|
|
@@ -99,6 +102,7 @@ def __getattr__(name: str):
|
|
|
99
102
|
|
|
100
103
|
__all__ = [
|
|
101
104
|
"BASE_URL",
|
|
105
|
+
"INTERACTIVE_BASE_URL",
|
|
102
106
|
"ZJUAPIError",
|
|
103
107
|
"CookieAccessError",
|
|
104
108
|
"CoursewareError",
|
|
@@ -110,6 +114,8 @@ __all__ = [
|
|
|
110
114
|
"normalize_slide",
|
|
111
115
|
"extract_classroom_token",
|
|
112
116
|
"is_zju_host",
|
|
117
|
+
"is_allowed_image_host",
|
|
118
|
+
"secure_image_url",
|
|
113
119
|
"secure_zju_url",
|
|
114
120
|
"download_slides",
|
|
115
121
|
"build_slides_pdf",
|