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/ATTRIBUTION.md +1 -1
- package/CHANGELOG.md +23 -0
- package/README.md +10 -3
- package/SECURITY.md +25 -18
- package/docs/technical.md +32 -12
- package/lib/index.js +14 -9
- package/lib/tools.js +13 -10
- package/lib/tools.schema.json +13 -10
- package/mcp_server.py +176 -25
- package/package.json +1 -1
- package/plugin.json +1 -1
- package/skills/scholia-notes.manifest.json +1 -1
- package/skills/zju-lecture-summarizer/SKILL.md +33 -6
- package/skills/zju-lecture-summarizer/SLIDES.md +23 -14
- package/skills/zju-lecture-summarizer-help/SKILL.md +1 -1
- 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 +2 -1
- package/zju_lecture/client.py +325 -116
- package/zju_lecture/formatter.py +201 -3
- package/zju_lecture/slides.py +9 -7
package/ATTRIBUTION.md
CHANGED
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
| 文件 | 来源 | 说明 |
|
|
11
11
|
| :--- | :--- | :--- |
|
|
12
12
|
| `zju_lecture/cookies.py` | 上游 `browser_cookies.py` | Edge Cookie 数据库定位、内置纯 Python AES-128-CBC 解密(macOS Keychain + PBKDF2-SHA1(1003))、Windows DPAPI 解密。移植时改进了错误分类、临时文件清理与 Windows 侧 v10/v20 前缀兼容。 |
|
|
13
|
-
| `zju_lecture/client.py` | 上游 `pipeline.py` 的抓取逻辑 | 智云课堂公开字幕接口 `courseapi/v3/web-socket/search-trans-result`、投影 PPT 接口 `pptnote/v1/schedule/search-ppt`、播放器配置接口 `courseapi/v2/play-template/get-config
|
|
13
|
+
| `zju_lecture/client.py` | 上游 `pipeline.py` 的抓取逻辑 | 智云课堂公开字幕接口 `courseapi/v3/web-socket/search-trans-result`、投影 PPT 接口 `pptnote/v1/schedule/search-ppt`、播放器配置接口 `courseapi/v2/play-template/get-config`;互动式课堂 hash 回放链接解析、`interactivemeta.cmc.zju.edu.cn` 字幕 / `pptnoteapi` 备用后端与官方图片 CDN 白名单。 |
|
|
14
14
|
| `zju_lecture/formatter.py` | 上游 `pipeline.py` 的格式化逻辑 | 按分钟聚合、按字符数分块、时间戳格式化。 |
|
|
15
15
|
| `zju_lecture/courseware.py` | 上游 `pipeline.py` 的课件提取逻辑 | PPTX / DOCX / TXT / MD / PDF 纯标准库文本提取。 |
|
|
16
16
|
| `skills/zju-lecture-summarizer/SKILL.md` | 上游 README 与总结提示词 | 五段式讲义模板(速览表 / 分章详解 / 公式清单 / 考试信息 / 考点预测)、降噪规则、LaTeX 公式规范。 |
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,28 @@
|
|
|
1
1
|
# 更新日志
|
|
2
2
|
|
|
3
|
+
## 2.2.9 — 2026-11-17
|
|
4
|
+
|
|
5
|
+
- 跟进上游互动式课堂支持:`zju_parse_url` 兼容
|
|
6
|
+
`interactivemeta.cmc.zju.edu.cn/#/replay?course_id=...&sub_id=...` 的 hash 路由回放链接;
|
|
7
|
+
字幕带登录态时主站失败自动回退互动式课堂后端,投影为空/失败时回退
|
|
8
|
+
`interactivemeta.cmc.zju.edu.cn/pptnoteapi`。
|
|
9
|
+
- 投影截图允许上游互动式课堂实际使用的官方图片 CDN(`chinamcloud.com` /
|
|
10
|
+
`chinamcloud.cn` / `chinamcache.com`,闭集白名单);仍强制 HTTPS,跨 origin 剥离
|
|
11
|
+
Cookie / Authorization,Cookie 只发往浙大图片主机。字幕仍不发 Cookie 头。
|
|
12
|
+
- `zju_write_note` 新增 `content_file`(与 `content` 二选一):长讲义先 `write` 落盘,
|
|
13
|
+
再 finalize,避免在 `run_code` 模板字符串里重复粘贴全文;草稿与目标同名时允许原地
|
|
14
|
+
finalize 并备份原稿。
|
|
15
|
+
- `zju_fetch_slides` 从截图 URL 的 13 位毫秒文件名解析拍摄时间,转成相对第一页的
|
|
16
|
+
`time`;返回紧凑索引(目录 + 命名模式 + `页时间轴` + 建议抽查页),不再逐页打印
|
|
17
|
+
绝对/相对路径。150 页索引从约 18–21k 字符降到约 1.8k。
|
|
18
|
+
- 系统提示与 Skill 增加投影阅读预算:按字幕关键节点抽查 15–25 页,超过 60 页不要逐页通读;
|
|
19
|
+
并明确 `run_code` 每次是独立进程,构造 Markdown 与调用 `zju_write_note` 必须在同一程序。
|
|
20
|
+
- 修复 `time=0` 被 `or` 丢掉、`/images/` 截图路径示例与实际输出不一致的问题。
|
|
21
|
+
- `zju_write_note` / `zju_check_note` 新增 `图片引用: N 张 | ...` 检查:区分本地缺失、
|
|
22
|
+
工作区外与外链;PDF 成功时把 Typst 的图片/排版警告以 `PDF 提示:` 回传。
|
|
23
|
+
- `SLIDES.md` 的登录指引统一到 `zju_login` 优先;去重输出改为
|
|
24
|
+
「连续字节完全重复折叠」,投影索引使用折叠后的 kept pages,避免索引页数与 PDF 页数不一致。
|
|
25
|
+
|
|
3
26
|
版本号在 `package.json`、`pyproject.toml`、`mcp_server.SERVER_VERSION`、根 `plugin.json`、
|
|
4
27
|
`.minimax-plugin/plugin.json`、`adapters/claude_code/plugin.json` 与四个 Skill manifest
|
|
5
28
|
共十处对齐。
|
package/README.md
CHANGED
|
@@ -29,6 +29,8 @@
|
|
|
29
29
|
## 功能特色
|
|
30
30
|
|
|
31
31
|
- **一句话出讲义**:给回放链接或 `sub_id`,Agent 抓字幕、写 Markdown、修公式、校验、命名,一次完成。
|
|
32
|
+
- **普通课堂与互动式课堂都能用**:支持 `classroom.zju.edu.cn/livingroom?...` 与
|
|
33
|
+
`interactivemeta.cmc.zju.edu.cn/#/replay?...` 两种回放链接;主站失败时自动回退互动式课堂后端。
|
|
32
34
|
- **便捷获取登录态**:缺登录态导致 401/403 时自动打开独立登录窗口,登录后保存在本机,无需额外使用开发者工具。
|
|
33
35
|
- **装完即用**:缺少 Typst 时首次排版自动准备(可关);中文字体与 Typst 包随插件分发,填空笔记离线也能编译。
|
|
34
36
|
- **自动 PDF**:使用内置脚本在本地排同名 PDF,无需额外 token 花销;PDF 失败不影响 Markdown 讲义。
|
|
@@ -113,6 +115,9 @@ python -m zju_lecture.cli slides "<回放链接>" --download
|
|
|
113
115
|
|
|
114
116
|
> 刚才那份讲义,把第 3 节的公式再推导一遍,并出 3 道自测题。
|
|
115
117
|
|
|
118
|
+
互动式课堂的回放地址(浏览器地址栏里带 `#/replay?course_id=...&sub_id=...` 的那种)
|
|
119
|
+
也可以直接粘贴,不需要手动改成 `classroom.zju.edu.cn` 链接。
|
|
120
|
+
|
|
116
121
|
- 讲义默认写在工作区根目录,文件名由 Agent 按「上课日期 + 本节内容」起名
|
|
117
122
|
(`知识总结-2026-10-28-复变函数-保角映射.md`),PDF 同名同目录。
|
|
118
123
|
- 同名讲义默认拒绝覆盖,要覆盖请明确说「覆盖」。
|
|
@@ -140,6 +145,7 @@ python -m zju_lecture.cli slides "<回放链接>" --download
|
|
|
140
145
|
- **依据投影截图写讲义**:写讲义前抓取并下载一次投影,把幻灯片上的定义、公式、图例与例题
|
|
141
146
|
同字幕对照写进正文;模型看不到本地图片时不会臆造幻灯片文字,只在文末列出截图索引。
|
|
142
147
|
- **把截图引用进讲义**:只挑 3–8 张关键页插入 Markdown;不改变「投影是否作为内容来源」。
|
|
148
|
+
- 截图索引带**页时间轴**(相对第一页);模型按字幕关键节点抽查 15–25 页,长 deck 不会逐页通读。
|
|
143
149
|
- 两个子开关都关闭时,写讲义前只调用一次清单接口核对页数,不下载、不插图。
|
|
144
150
|
|
|
145
151
|
「投影讲义」预设会把「抓取投影截图 + 依据投影截图写讲义 + 引用关键页」一起打开,
|
|
@@ -223,9 +229,10 @@ Markdown 已经正常写入,只是 PDF 没排出来。让 Agent 跑一次 `zju
|
|
|
223
229
|
没有可用凭据库时**不落盘**,只在本次进程内保留。2.2.7 及更早版本的明文 `session.bin`
|
|
224
230
|
会在升级后首次读取时迁移并删除。`zju_login(clear=true, confirm=true)` 会清除凭据项、
|
|
225
231
|
旧文件与独立浏览器配置。Cookie / Bearer 输出脱敏,镜像 URL 等诊断也会去掉 userinfo 与签名 query。
|
|
226
|
-
- **网络边界**:正常请求只到 `classroom.zju.edu.cn`、`
|
|
227
|
-
|
|
228
|
-
|
|
232
|
+
- **网络边界**:正常请求只到 `classroom.zju.edu.cn`、`interactivemeta.cmc.zju.edu.cn`
|
|
233
|
+
(互动式课堂后端)、`https://*.zju.edu.cn` 与官方图片 CDN 截图主机、Typst 官方下载地址;
|
|
234
|
+
每个课堂请求只允许同 origin 重定向。投影截图的每一跳都校验白名单域、HTTPS 与私网地址,
|
|
235
|
+
白名单外目标不跟随;证书校验不降级。
|
|
229
236
|
- **本地文件有边界**:课件 / 讲义工具只接受指定扩展名,拒绝凭据、私钥与浏览器数据;
|
|
230
237
|
所有回写(含 `fix=true` 与填空 `mode=patch`)都限制在工作区内;读取工作区外课件
|
|
231
238
|
必须显式传 `allow_outside_workspace=true`,且结果首行会标注。
|
package/SECURITY.md
CHANGED
|
@@ -25,7 +25,8 @@
|
|
|
25
25
|
> `enableStudyNotes` / `enableSlides` / `slidesAsSource` / `embedSlideImages` / `enableLoginTools`。
|
|
26
26
|
> 关闭时不注册对应可选工具、不加载对应代码、不追加 Skill 附录;投影的子开关仍由 `enableSlides` 总控。
|
|
27
27
|
> **字幕鉴权与一键登录 `zju_login` 属于核心链路**:先匿名请求,只有 HTTP 401/403 才读取本地登录态、
|
|
28
|
-
> 解析 Bearer
|
|
28
|
+
> 解析 Bearer 重试;携带登录态时若主站失败,工具会自动回退 `interactivemeta.cmc.zju.edu.cn`
|
|
29
|
+
> 互动式课堂后端。仍失败就由 `zju_login` 打开独立登录窗口。登录辅助开关
|
|
29
30
|
> (`enableLoginTools` / `ZJU_ENABLE_LOGIN_TOOLS`)只控制视频直链与读取浏览器登录态两个可选工具。
|
|
30
31
|
> 本文件中与截图下载、填空笔记、登录辅助工具相关的边界,只在对应模块开启时适用。
|
|
31
32
|
|
|
@@ -44,8 +45,8 @@
|
|
|
44
45
|
| **凭据落盘(一键登录)** | 登录态为了免重复登录被明文写到磁盘,或被其他本机用户、备份、磁盘镜像读取 | `zju_login` 只保存 Cookie、不保存账号密码;写入平台凭据库(Windows DPAPI / macOS 钥匙串 / Linux Secret Service,均为静态加密),**没有可用后端时只在内存里保留、不落盘**;提取后删除 `login-profile/`;`zju_login(clear=true)` 同时清除凭据项、旧明文文件与浏览器配置 |
|
|
45
46
|
| **本机调试端口暴露** | 独立登录窗口的 CDP 端口被本机进程利用 | 只用 `--remote-debugging-port=0` 随机端口 + `127.0.0.1` 绑定;使用专用 profile;不向 CDP 传 Cookie,也不开放给模型;登录结束即关闭浏览器。端口本身无应用层认证,共享电脑需避免使用 |
|
|
46
47
|
| **中间人窃取** | 本机根证书不全时"关闭证书校验"以让请求成功 | **绝不关闭证书校验**;信任库按 `certifi` → 随包 `cacert.pem` → 系统根证书 三级回落,三级都失败才报错,并在错误里写明当前生效的是哪一级 |
|
|
47
|
-
| **跨域重定向带走 Cookie** | 服务端 302 到第三方域,urllib 原样重发 Cookie | 课堂 API 只允许**完整 origin**(scheme + host + port)一致的重定向;截图下载跨 origin 时剥离 Cookie / Authorization / Proxy-Authorization
|
|
48
|
-
| **截图下载 SSRF / 明文凭证** | API 返回恶意图片地址,诱导插件读取内网资源或明文发送登录态 | **初始**地址只接受 `https://*.zju.edu.cn
|
|
48
|
+
| **跨域重定向带走 Cookie** | 服务端 302 到第三方域,urllib 原样重发 Cookie | 课堂 API 只允许**完整 origin**(scheme + host + port)一致的重定向;截图下载跨 origin 时剥离 Cookie / Authorization / Proxy-Authorization,白名单外目标不跟随(第 7.2 节、第 10 节) |
|
|
49
|
+
| **截图下载 SSRF / 明文凭证** | API 返回恶意图片地址,诱导插件读取内网资源或明文发送登录态 | **初始**地址只接受 `https://*.zju.edu.cn` 或官方图片 CDN 白名单;**每一跳**重新校验 HTTPS、白名单域、非 IP 字面量/loopback/私网,拒绝 HTTPS→HTTP 降级;Cookie 只发给 ZJU 主机,图片按魔数校验(第 7.2 节、第 10 节) |
|
|
49
50
|
| **安装副作用** | 插件把 Skill 复制进 `$DSH_HOME`,卸载后仍留副本 | 插件在 `apply()` 期间把 Skill **注册到 dsh 技能表**,不写用户目录 |
|
|
50
51
|
| **仓库泄露** | 把本机路径、真实课程号、Cookie、API key 提交进 git | `tools/privacy_scan.py` 扫描工作区、git 历史与 npm tarball;默认只输出 path:line、规则名与命中长度,摘录需 `--show-excerpt` 且前后各 6 字符(第 7.5 节) |
|
|
51
52
|
|
|
@@ -63,11 +64,12 @@
|
|
|
63
64
|
`ZJU_COOKIE_FILE`,**不会**要求模型向用户索要 Cookie,也不会让普通用户开开发者工具。
|
|
64
65
|
2. **校验**:拒绝换行/回车(HTTP 头注入)、拒绝空 name、限制 8 KiB;不合法时返回原因但**不回显内容**。
|
|
65
66
|
3. **使用**:字幕不发送 Cookie 头;匿名请求被拒后,从 Cookie 中解析 `_token`,
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
67
|
+
向 `classroom.zju.edu.cn` 发送 `Authorization: Bearer` 重试;主站失败时再向
|
|
68
|
+
`interactivemeta.cmc.zju.edu.cn` 发同一个 Bearer。两个请求都按同 origin 校验重定向。
|
|
69
|
+
投影 Cookie 只发往 `classroom.zju.edu.cn`;回退到 `interactivemeta.cmc.zju.edu.cn` 时也只发往
|
|
70
|
+
该浙大官方域。视频直链仍只走主站。截图下载只把 Cookie 发给 `*.zju.edu.cn` 图片主机;
|
|
69
71
|
图片响应为 401/403 时才会把 Bearer 重试到同一图片主机。
|
|
70
|
-
|
|
72
|
+
重定向逐跳校验:只允许浙大域或官方图片 CDN 白名单、拒绝 HTTPS 降级与 IP/loopback/私网目标;
|
|
71
73
|
跨 origin 时剥离 Cookie / Authorization / Proxy-Authorization(第 7.2 节、第 10 节)。
|
|
72
74
|
4. **缓存**:运行时缓存存于 Python 子进程内存(`_COOKIE_CACHE`),进程退出即消失;
|
|
73
75
|
唯一的持久凭据副本是第 8 条由 `zju_login` 保存的登录态。
|
|
@@ -120,7 +122,7 @@
|
|
|
120
122
|
Typst 仍可能访问包注册表;底稿不是安全边界,见第 7.8 节。
|
|
121
123
|
- **截图/PDF 写入范围**:`zju_fetch_slides(download=true)` 只写工作区内的 `ppt-assets/<sub_id>/`
|
|
122
124
|
(或 `output_dir` 指定的工作区内目录);最多 2000 张、单张 ≤32 MiB、总量 512 MiB 硬停,
|
|
123
|
-
只落盘通过魔数校验的 JPEG/PNG
|
|
125
|
+
只落盘通过魔数校验的 JPEG/PNG。白名单外主机、HTTP 降级、IP/loopback/私网目标与跨 origin 凭据
|
|
124
126
|
都会被拒绝(第 7.2 与 7.9 节、第 10 节)。`output_dir` 指向非默认目录时,该目录可能不在
|
|
125
127
|
`.gitignore` 内,提交前请自行确认。
|
|
126
128
|
- **投影三档**:`enableSlides` 只负责注册工具;`slidesAsSource`(`ZJU_SLIDES_SOURCE`)决定
|
|
@@ -146,15 +148,17 @@
|
|
|
146
148
|
## 4. 不收集、不外传
|
|
147
149
|
|
|
148
150
|
- 无遥测、无统计、无自动更新、无后台常驻进程。
|
|
149
|
-
- 正常请求发往 `https://classroom.zju.edu.cn
|
|
150
|
-
`https
|
|
151
|
+
- 正常请求发往 `https://classroom.zju.edu.cn`(字幕、投影列表、视频直链)、
|
|
152
|
+
`https://interactivemeta.cmc.zju.edu.cn`(互动式课堂字幕 / 投影回退后端)、
|
|
153
|
+
`https://*.zju.edu.cn` 图片主机与官方图片 CDN(`chinamcloud.com` / `chinamcloud.cn` /
|
|
154
|
+
`chinamcache.com`,仅投影截图下载,且只在该模块开启时)。
|
|
151
155
|
`zju_login` 的独立浏览器会访问 `classroom.zju.edu.cn` 与浙大 SSO
|
|
152
156
|
(`zjuam.zju.edu.cn`,同一 `*.zju.edu.cn` 域),由浏览器按正常网页流程发起。
|
|
153
157
|
例外:
|
|
154
158
|
- 缺少 Typst 且允许自动安装时,会从 GitHub 官方 Release 下载归档(约 20 MB),
|
|
155
159
|
按固定 SHA256 校验;归档镜像可通过 `ZJU_TYPST_MIRROR` 改为用户指定地址;
|
|
156
160
|
- 底稿引用未 vendor 的 Typst 包时,编译器可能访问 `https://typst.app` 包注册表;
|
|
157
|
-
-
|
|
161
|
+
- 截图重定向逐跳校验,白名单外主机、HTTP 降级、IP/loopback/私网目标都不会被访问
|
|
158
162
|
(第 7.2 节、第 10 节)。
|
|
159
163
|
- 不写 `~/.dsh`、不写 `~/.minimax`;为了提示同名旧 Skill 冲突,会**只读**检查
|
|
160
164
|
`$DSH_HOME/skills/<name>/SKILL.md` 或 `~/.dsh/skills/...` 的内容哈希,不会修改它。
|
|
@@ -234,7 +238,7 @@
|
|
|
234
238
|
| 编号 | 等级 | 审查确认的问题 | 修复(commit) | 回归测试 |
|
|
235
239
|
| :--- | :--- | :--- | :--- | :--- |
|
|
236
240
|
| 7.1 | **高** | dsh 的整个插件共用一个 Python bridge;会话 A 有在途调用时,会话 B 切换工作区被 `pending.size > 0` 挡住,B 按 A 的 cwd / `ZJU_WORKSPACE` 解析相对路径。 | `c69fbdf`:按绝对 workspace 建 `Map<key, WorkspaceSession>`(LRU 2),每个会话独立 cwd / `ZJU_WORKSPACE` / pending / stderr;删除 `PLUGIN_ROOT` 回退,工作区缺失或不存在时直接拒绝。 | `tests/bridge_workspace_isolation.mjs`;`bridge_workspace_smoke.mjs`。 |
|
|
237
|
-
| 7.2 | 中 | 截图只校验初始 URL;重定向按 hostname 决定是否剥凭据,同主机 HTTPS→HTTP / 换端口仍带 Cookie,跨主机可到 loopback / 内网。 | `a45e551`:按完整 origin(scheme + host + port)比较;拒绝 HTTPS 降级、URL userinfo、IP 字面量、localhost 与私网;非浙大目标不跟随并写 diagnostics;跨 origin 剥离 Cookie / Authorization / Proxy-Authorization(第 10 节)。 | `tests/test_redirect_security.py`(
|
|
241
|
+
| 7.2 | 中 | 截图只校验初始 URL;重定向按 hostname 决定是否剥凭据,同主机 HTTPS→HTTP / 换端口仍带 Cookie,跨主机可到 loopback / 内网。 | `a45e551`:按完整 origin(scheme + host + port)比较;拒绝 HTTPS 降级、URL userinfo、IP 字面量、localhost 与私网;非浙大目标不跟随并写 diagnostics;跨 origin 剥离 Cookie / Authorization / Proxy-Authorization(第 10 节)。 | `tests/test_redirect_security.py`(17 条,含本地 server「目标 0 请求」断言)。 |
|
|
238
242
|
| 7.3 | 中 | `zju_check_note(fix=true)` 与 `mode=patch` 可写工作区外 Markdown;`patch` 不生成备份。 | `0d7f037`:`paths.require_workspace_path()` 统一 resolve → realpath → 工作区 → guard →(写入)realpath 复检;三个分支接入,读工具新增显式 `allow_outside_workspace`(默认 false,第 9 节)。 | `tests/test_workspace_boundary.py`(10 条,含软链/junction 与 mtime 断言)。 |
|
|
239
243
|
| 7.4 | 中 | `ZJU_TYPST_MIRROR` 原样进入 `zju_doctor`、下载进度与 stderr,userinfo / 签名 query 会进入模型上下文或宿主日志。 | `db46f38`:`deps._redact_url()` 只保留 `scheme://host[:port]/path`;describe / progress / 异常全部脱敏;bridge.js 对 Python stderr 再做一层 JS 脱敏(Cookie 头、URL userinfo、token/key/secret/signature)。 | `tests/test_deps_redaction.py`(6 条)。 |
|
|
240
244
|
| 7.5 | 中 | `privacy_scan.py` 的摘录只截断不掩码,文本与 JSON 输出都包含命中原文。 | `d6f0668`:Finding 增加 `match_length`;摘录保留前后各 6 字符、中间 `***`;默认只输出 path:line / 规则 / 长度,`--show-excerpt` 才输出掩码摘录。 | `tests/test_privacy_scan_mask.py`(7 条)。 |
|
|
@@ -313,15 +317,18 @@ python tools/privacy_scan.py --tarball <npm pack 产物>
|
|
|
313
317
|
**origin 定义**:`(scheme, host, port)`,缺省端口按 80/443 补齐。只看 hostname 会让
|
|
314
318
|
`https://a:443 → https://a:8443` 或 `https → http` 继续携带 Cookie,所以两者都按不同 origin 处理。
|
|
315
319
|
|
|
316
|
-
1. **课堂 API(`_SameHostRedirectHandler
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
320
|
+
1. **课堂 API(`_SameHostRedirectHandler`)**:每个请求只允许与其当前 origin 完全一致的跳转
|
|
321
|
+
(`classroom.zju.edu.cn` 或 `interactivemeta.cmc.zju.edu.cn`);跨 origin、HTTPS→HTTP、
|
|
322
|
+
带 userinfo 的 URL 一律抛 `HTTPError`。互动式课堂后端是独立请求,不是 302 跳转。
|
|
323
|
+
2. **截图下载(`_StripAuthOnCrossHostRedirectHandler`)**:目标必须是 `*.zju.edu.cn` 或官方图片 CDN
|
|
324
|
+
白名单(`chinamcloud.com` / `chinamcloud.cn` / `chinamcache.com`),否则**不跟随**(返回 3xx),
|
|
325
|
+
并把原因写入 `diagnostics`(「已阻止跳转到非浙大域/非官方图片 CDN: …」
|
|
326
|
+
「已阻止跳转到受限主机: …」)。
|
|
321
327
|
跨 origin 时剥离 `Cookie` / `Authorization` / `Proxy-Authorization`;同 origin 才保留。
|
|
322
328
|
3. **SSRF 目标**:IP 字面量(含 `127.0.0.0/8`、`169.254.0.0/16`、`10/8`、`172.16/12`、
|
|
323
329
|
`192.168/16`、`::1`)、`localhost` / `*.localhost` 一律拒绝,且拒绝发生在建立连接之前。
|
|
324
|
-
4. **初始地址**仍是 `https://*.zju.edu.cn
|
|
330
|
+
4. **初始地址**仍是 `https://*.zju.edu.cn` 或上述官方图片 CDN;`http` 只对这些白名单主机
|
|
331
|
+
升级为 HTTPS,其他直接拒绝。
|
|
325
332
|
5. **诊断不含凭据**:阻断原因只写 host/origin,不写请求头;与第 7.4 节的 URL 脱敏共用出口。
|
|
326
333
|
|
|
327
334
|
回归:`tests/test_redirect_security.py`(origin 单元测试 + 本地 HTTP server:
|
package/docs/technical.md
CHANGED
|
@@ -78,14 +78,21 @@ dsh-zju-lecture-note/
|
|
|
78
78
|
→(compile)scholia PDF + 逐页 PNG
|
|
79
79
|
```
|
|
80
80
|
|
|
81
|
+
回放地址支持两种官方形态:`classroom.zju.edu.cn/livingroom?course_id=...&sub_id=...`,
|
|
82
|
+
以及互动式课堂的 hash 路由 `interactivemeta.cmc.zju.edu.cn/#/replay?course_id=...&sub_id=...`。
|
|
83
|
+
`parse_lecture_url()` 先读普通 query;没有 `sub_id` 时再解析 `#` 后的 fragment query,两种链接都可以
|
|
84
|
+
直接交给 `zju_fetch_transcript` / `zju_fetch_slides`。
|
|
85
|
+
|
|
81
86
|
字幕保留 `classroom.zju.edu.cn`:先匿名请求,**仅 HTTP 401/403** 时调用 `_resolve_cookie`
|
|
82
87
|
(进程缓存 → `ZJU_COOKIE` → `ZJU_COOKIE_FILE` → `zju_login` 保存的本机登录态 → Edge)
|
|
83
|
-
解析 `_token`,用 Bearer
|
|
88
|
+
解析 `_token`,用 Bearer 重试。携带登录态时,主站失败或业务错误会再试一次
|
|
89
|
+
`interactivemeta.cmc.zju.edu.cn` 的同一个 `search-trans-result` 路径;这是工具内部的自动回退,
|
|
90
|
+
不要手工换主机。字幕请求**不发 Cookie 头**,Bearer 只发往这两个浙大官方主机。
|
|
84
91
|
兼容两种返回:`ainew` 用 `BeginSec` / `Text`,老课程 `ai` 用 `time` / `zhtext` / `entext`
|
|
85
92
|
(以第一条时间戳为相对零点换算秒数)。
|
|
86
93
|
字幕鉴权属于核心链路,**不需要开启登录辅助工具**(`enableLoginTools` 只控制视频直链与读 Cookie 工具)。
|
|
87
|
-
|
|
88
|
-
|
|
94
|
+
官网实证同一课匿名 403、Bearer-only HTTP 200 / code 0;CLI 默认自动重试,`--no-login` 可关闭,
|
|
95
|
+
`--cookie-file` 可指定本地文件;没有明文 token 参数。
|
|
89
96
|
|
|
90
97
|
### 一键登录窗口(`zju_login`)
|
|
91
98
|
|
|
@@ -255,9 +262,13 @@ v2.0.1 起,「字幕 → 讲义 → PDF」主链路与投影、填空笔记等
|
|
|
255
262
|
讲义内容来源(写前必须抓取并下载一次);`embedSlideImages` 只决定是否插入 3–8 张关键页。
|
|
256
263
|
两个子开关都关闭时,提示词仍要求写讲义前调用一次 `download=false` 核对清单,避免
|
|
257
264
|
「打开了抓取开关但模型从不调用」。系统提示、Skill 附录和工具描述三处都写明顺序。
|
|
265
|
+
- 投影接口主站为 `classroom.zju.edu.cn/pptnote`,空列表或请求失败时回退
|
|
266
|
+
`interactivemeta.cmc.zju.edu.cn/pptnoteapi`;两个后端都使用同一份登录态。401/403 不重试后端,
|
|
267
|
+
直接提示重新登录。
|
|
258
268
|
- 投影截图默认下载到 `<工作区>/ppt-assets/<sub_id>/`(已 gitignore);接口没有文字层 / OCR,
|
|
259
269
|
需要幻灯片原文时走 `zju_extract_courseware`。模型不能读图时禁止臆造幻灯片文字,
|
|
260
270
|
只在文末列截图索引。
|
|
271
|
+
- 截图 URL 的时间戳会转成相对第一页的 `time`;`zju_fetch_slides` 返回紧凑的 `页时间轴`。
|
|
261
272
|
- 登录辅助默认关闭(dsh `enableLoginTools=false`),只影响视频直链与读 Cookie 工具,不影响字幕。
|
|
262
273
|
`zju_login` 是核心工具,始终注册;字幕鉴权由字幕工具内部自动完成,不需模型先调读 Cookie 工具,
|
|
263
274
|
也不新增工具或凭据参数。
|
|
@@ -300,7 +311,12 @@ v2.0.1 起,「字幕 → 讲义 → PDF」主链路与投影、填空笔记等
|
|
|
300
311
|
4. **写文件**:原子替换;回写前备份到 `ZJU_BACKUP_DIR`。
|
|
301
312
|
5. **排版 PDF**:把同一份内容写进 `<工作区>/.zju-lecture/handout/<stem>/main.typ` 并编译;
|
|
302
313
|
成功时 PDF 落在讲义同目录,返回一行 `PDF: <路径>(N 页)`;失败只回一行
|
|
303
|
-
`PDF 跳过: …`,Markdown
|
|
314
|
+
`PDF 跳过: …`,Markdown 已写入。成功时也把 Typst 的图片/排版警告以
|
|
315
|
+
`PDF 提示:` 回传,不再静默丢弃。
|
|
316
|
+
6. **图片检查**:扫描 Markdown 图片引用,返回 `图片引用: N 张 | ...`;
|
|
317
|
+
区分本地缺失、工作区外与外链,避免 PDF 里只剩「图片未嵌入」占位。
|
|
318
|
+
|
|
319
|
+
输入支持 `content` 或 `content_file`(二选一;后者读取工作区 `.md` 草稿,适合长讲义,避免在 `run_code` 里重复粘贴)。
|
|
304
320
|
|
|
305
321
|
省 token 的约定:`zju_write_note` 已经包含校验,**通常不需要**再调 `zju_check_note`;
|
|
306
322
|
只有手工改过文件、或想给已有讲义补 PDF 时才用 `zju_check_note(pdf=true)`。
|
|
@@ -508,8 +524,9 @@ python tools/check_note.py --fix 讲义.md # 自动修正机械问题
|
|
|
508
524
|
|
|
509
525
|
1. 来源只有本地:内存缓存 → `ZJU_COOKIE` → `ZJU_COOKIE_FILE` → `zju_login` 保存的登录态 → 本机 Edge;
|
|
510
526
|
2. 校验:拒绝换行(HTTP 头注入)、空 name、超长;不合法只返回原因,不回显内容;
|
|
511
|
-
3. 使用:字幕先匿名,仅 HTTP 401/403 后自动读取本地登录态、解析 Bearer
|
|
512
|
-
|
|
527
|
+
3. 使用:字幕先匿名,仅 HTTP 401/403 后自动读取本地登录态、解析 Bearer 重试;
|
|
528
|
+
主站失败时自动回退 `interactivemeta.cmc.zju.edu.cn`。字幕不发 Cookie 头,Bearer 只发往这两个
|
|
529
|
+
浙大官方主机;每次请求仍按同 origin 校验重定向;投影边界见下;
|
|
513
530
|
4. 缓存:Python 子进程内存;
|
|
514
531
|
5. 回显:Cookie / 密码 / Bearer 没有;工具 schema 中没有 cookie / password / reveal / domain 参数。
|
|
515
532
|
签名视频直链是例外,会作为预期结果返回给调用方;
|
|
@@ -551,13 +568,16 @@ dsh 0.2.x 不为工具参数生成根级封闭声明,但 `handle_tool_call`
|
|
|
551
568
|
- TLS 证书校验**永远不会被关闭**。信任库按 `certifi` → 随包 `cacert.pem` → 系统根证书三级回落;
|
|
552
569
|
三级都不够时才失败,并返回原因 + 下一步(当前信任库、CA 张数、`HTTPS_PROXY`、该装什么)。
|
|
553
570
|
- 瞬时故障(`IncompleteRead` / `SSLEOFError` / 超时 / 5xx)重试 3 次,指数退避 + 抖动;
|
|
554
|
-
证书校验失败**不重试**。字幕 HTTP 401/403 只做一次 Bearer
|
|
555
|
-
|
|
556
|
-
|
|
557
|
-
|
|
558
|
-
|
|
571
|
+
证书校验失败**不重试**。字幕 HTTP 401/403 只做一次 Bearer 重试;携带登录态时主站失败再试
|
|
572
|
+
一次互动式课堂后端,不能无限循环;区分 HTTP 状态、接口业务错误与本地凭据读取失败,
|
|
573
|
+
不把 403 直接判为校园网限制。
|
|
574
|
+
- 课堂 API 的 Cookie(投影 / 视频直链)与 Bearer 只发往 `classroom.zju.edu.cn` 与
|
|
575
|
+
`interactivemeta.cmc.zju.edu.cn`;字幕不发 Cookie 头。每个课堂请求的跨域 302 直接拒绝,
|
|
576
|
+
避免 `urllib` 把 `Cookie` / `Authorization` 头重发到第三方域。
|
|
577
|
+
- 投影截图的**初始**地址只允许 `https://*.zju.edu.cn` 或官方图片 CDN 白名单
|
|
578
|
+
(`chinamcloud.com` / `chinamcloud.cn` / `chinamcache.com`);`http://` 对这些主机自动升级 HTTPS。
|
|
559
579
|
Cookie 只给 ZJU 图片主机。图片返回 401/403 时 Bearer 只重试到同一图片主机。
|
|
560
|
-
|
|
580
|
+
重定向逐跳校验:目标必须属于上述白名单,拒绝 HTTPS→HTTP、URL userinfo、IP 字面量与
|
|
561
581
|
私网/loopback;跨 origin 时剥离 Cookie / Authorization / Proxy-Authorization,
|
|
562
582
|
被阻止的跳转只写 diagnostics(见 [SECURITY.md](../SECURITY.md) §10)。
|
|
563
583
|
- 可选的 Typst 自动安装会访问 GitHub 官方 Release,并通过 `ZJU_TYPST_MIRROR` 支持镜像;
|
package/lib/index.js
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* dsh-zju-lecture-note — DeepSeek Harness 原生插件。
|
|
3
3
|
*
|
|
4
|
-
* 把浙大智云课堂(classroom.zju.edu.cn
|
|
4
|
+
* 把浙大智云课堂(classroom.zju.edu.cn)与互动式课堂
|
|
5
|
+
* (interactivemeta.cmc.zju.edu.cn)回放变成可复习的结构化讲义:
|
|
5
6
|
* 以语音字幕 + 本地课件为主链路;投影 PPT 截图是可选模块,由 `enableSlides` 开关。
|
|
6
7
|
* 产出带时间戳、公式可渲染的讲义。
|
|
7
8
|
*
|
|
@@ -365,7 +366,7 @@ function toolTimeoutFor(toolName, timeoutMs) {
|
|
|
365
366
|
}
|
|
366
367
|
|
|
367
368
|
const SYSTEM_PROMPT = [
|
|
368
|
-
"适用范围:仅处理浙大智云课堂(classroom.zju.edu.cn
|
|
369
|
+
"适用范围:仅处理浙大智云课堂(classroom.zju.edu.cn)与互动式课堂(interactivemeta.cmc.zju.edu.cn)回放与讲义任务;两种回放链接(普通 query 与 #/replay hash 路由)都直接接受;其他任务请忽略本段。",
|
|
369
370
|
"主链路:把链接或 sub_id 直接交给 zju_fetch_transcript(默认 per_minute;长课 chunked;同一节课只抓一次,per_segment 仅在确实需要秒级时间戳时用)→ 按下面的材料规则补齐投影或课件 → zju_write_note 一次写入。write_note 会自动命名、拒绝静默覆盖、修公式、校验,并按设置自动排版同名 PDF;不要再调 zju_parse_url,也不要对同一份讲义重复调 zju_check_note。",
|
|
370
371
|
"讲义默认按「复习版」写:每节保留 [HH:MM];老师讲过的例题整理成「题目 → 切入点 → 关键步骤 → 易错点」,本节没有例题就写「本节无例题」,不要编题;文末给 3–5 道自测题(答案用多行 <details> 折叠)与 5–10 条考点预测。",
|
|
371
372
|
"例题/定理/定义/证明要写成行首标记([例] 标题 —— 正文 / [定理] … / [定义] … / [证明] …),"
|
|
@@ -373,7 +374,7 @@ const SYSTEM_PROMPT = [
|
|
|
373
374
|
"用户只说「整理这节课」时按完整链路一次做完,不要只交字幕摘要;只有明确说「只要速记 / 只要 Markdown」时才省略这些增强内容。",
|
|
374
375
|
"交付时给出 Markdown 路径;有 PDF 时一并给出 PDF 路径。不要声称看过自己无法查看的图片。",
|
|
375
376
|
"隐私边界:登录态只在本机安全保存或进程内存中使用;工具不接受、也不回显 Cookie / 密码 / token 明文;不要向用户索要 Cookie,或把它写进对话、文件、命令。",
|
|
376
|
-
"字幕先匿名;401/403
|
|
377
|
+
"字幕先匿名;401/403 时先自动使用本机登录态并重试,主站失败时工具会自动回退互动式课堂后端,不要自行换主机或拼 URL。仍失败就调用 zju_login(url=<这节课链接>) 打开独立登录窗口,让用户在窗口里正常登录(成功后自动关闭并安全保存),然后重试字幕一次。不要让用户开开发者工具、手工配置 Cookie 文件,也不要把 401/403 直接归因校园网。",
|
|
377
378
|
].join("\n");
|
|
378
379
|
|
|
379
380
|
/**
|
|
@@ -388,7 +389,7 @@ const SYSTEM_PROMPT = [
|
|
|
388
389
|
function slideImageRule(enabled) {
|
|
389
390
|
return enabled
|
|
390
391
|
? "讲义插图模式已开启:从下载结果里挑 3–8 张关键页(定义、示意图、公式推导、例题),"
|
|
391
|
-
+ "按讲义所在目录的相对路径插入 Markdown(例如 );"
|
|
392
393
|
+ "如果宿主不能查看本地图片,不要把截图当作已读文字,只在文末列出截图索引。"
|
|
393
394
|
+ "不要一次塞入全部截图或图片字节。"
|
|
394
395
|
: "讲义插图模式关闭(节省下载时间与 token):不要插入截图;"
|
|
@@ -419,9 +420,12 @@ function slidesFeatureRule(enableSlides, embedSlideImages, slidesAsSource = fals
|
|
|
419
420
|
if (slidesAsSource) {
|
|
420
421
|
return "PPT 投影抓取已开启(enableSlides=true),投影作为讲义来源已开启(slidesAsSource=true):"
|
|
421
422
|
+ "写讲义前必须先调用一次 zju_fetch_slides(url_or_sub_id=<回放链接>, download=true, confirm=true),"
|
|
422
|
-
+ "
|
|
423
|
+
+ "整节课只抓一次;主站为空/失败时工具会自动回退互动式课堂后端,不要自行拼 URL 或反复重试。"
|
|
423
424
|
+ "把投影当作与字幕并列的内容来源:定义、公式、图例、例题按幻灯片与字幕互相校正,写进对应小节。"
|
|
424
|
-
+ "
|
|
425
|
+
+ "如果当前宿主能读取本地图片,先按返回的「页时间轴」抽查 15–25 页关键截图"
|
|
426
|
+
+ "(没有时间轴时按页码均匀抽样;从字幕挑 8–12 个关键节点,每个节点读最近 1–2 页;"
|
|
427
|
+
+ "超过 60 页的 deck 不要逐页通读);"
|
|
428
|
+
+ "不能读图时不要臆造幻灯片文字,"
|
|
425
429
|
+ "只在文末列「课堂投影截图索引」并说明哪些内容未核对。"
|
|
426
430
|
+ "登录失败时按工具返回调用 zju_login 后重试一次;仍失败就降级为纯字幕,并在讲义开头注明投影未使用。"
|
|
427
431
|
+ (embedSlideImages
|
|
@@ -501,8 +505,9 @@ function loginFeatureRule(enabled) {
|
|
|
501
505
|
const core = "`zju_login` 不受本开关影响,始终可用:需要登录时调用它打开独立登录窗口,"
|
|
502
506
|
+ "用户只需在窗口里正常登录,窗口会自动关闭并把登录态安全保存在本机;"
|
|
503
507
|
+ "不要让用户开开发者工具、手工配置 Cookie 文件或把凭据贴进对话。"
|
|
504
|
-
+ "字幕鉴权也不依赖本开关:先匿名,401/403 时自动读取本机登录态并用 Bearer
|
|
505
|
-
+ "
|
|
508
|
+
+ "字幕鉴权也不依赖本开关:先匿名,401/403 时自动读取本机登录态并用 Bearer 重试,"
|
|
509
|
+
+ "主站失败会自动回退互动式课堂后端;仍失败就调用 zju_login,登录成功后重试字幕一次,"
|
|
510
|
+
+ "不要反复重试、擅断校园网或自行更换后端。";
|
|
506
511
|
return enabled
|
|
507
512
|
? "登录辅助工具已开启(zju_get_video_url / zju_read_browser_cookie):仅在需要视频直链或手动检查登录态时调用,"
|
|
508
513
|
+ "二者都不会回显 Cookie。" + core
|
|
@@ -543,7 +548,7 @@ const jsonOutput = {
|
|
|
543
548
|
|
|
544
549
|
/** 每个工具在 UI 上的呈现方式与超时。 */
|
|
545
550
|
const TOOL_PRESENT = {
|
|
546
|
-
zju_parse_url: { title: "
|
|
551
|
+
zju_parse_url: { title: "解析智云课堂/互动式课堂回放链接", kind: "read" },
|
|
547
552
|
zju_fetch_transcript: { title: "抓取课堂语音字幕", kind: "fetch" },
|
|
548
553
|
zju_fetch_slides: { title: "抓取/下载课堂投影 PPT", kind: "fetch" },
|
|
549
554
|
zju_extract_courseware: { title: "提取本地课件文本", kind: "read" },
|
package/lib/tools.js
CHANGED
|
@@ -9,10 +9,10 @@
|
|
|
9
9
|
export const ZJU_TOOLS = [
|
|
10
10
|
{
|
|
11
11
|
"name": "zju_parse_url",
|
|
12
|
-
"description": "解析浙大智云课堂
|
|
12
|
+
"description": "解析浙大智云课堂 / 互动式课堂回放链接,提取 sub_id、course_id 与 tenant_code;兼容 classroom.zju.edu.cn/livingroom?... 与 interactivemeta.cmc.zju.edu.cn/#/replay?... 两种 URL。",
|
|
13
13
|
"parameters": {
|
|
14
14
|
"url": {
|
|
15
|
-
"description": "
|
|
15
|
+
"description": "回放 URL(classroom.zju.edu.cn/livingroom?... 或 interactivemeta.cmc.zju.edu.cn/#/replay?...)或纯 sub_id 数字",
|
|
16
16
|
"type": "string",
|
|
17
17
|
"required": true
|
|
18
18
|
}
|
|
@@ -20,10 +20,10 @@ export const ZJU_TOOLS = [
|
|
|
20
20
|
},
|
|
21
21
|
{
|
|
22
22
|
"name": "zju_fetch_transcript",
|
|
23
|
-
"description": "
|
|
23
|
+
"description": "抓取智云课堂 / 互动式课堂某节课的语音识别字幕。先匿名;401/403 时自动用本机登录态重试一次,并自动回退互动式课堂后端。登录态只能来自本机 Edge 或 ZJU_COOKIE_FILE,不要传 Cookie。默认 per_minute 带时间戳;长课用 chunked;同一节课只抓一次,per_segment 仅在确实需要秒级时间戳时用。",
|
|
24
24
|
"parameters": {
|
|
25
25
|
"url_or_sub_id": {
|
|
26
|
-
"description": "回放 URL
|
|
26
|
+
"description": "回放 URL(含互动式课堂 #/replay hash 链接)或 sub_id",
|
|
27
27
|
"type": "string",
|
|
28
28
|
"required": true
|
|
29
29
|
},
|
|
@@ -60,10 +60,10 @@ export const ZJU_TOOLS = [
|
|
|
60
60
|
},
|
|
61
61
|
{
|
|
62
62
|
"name": "zju_fetch_slides",
|
|
63
|
-
"description": "
|
|
63
|
+
"description": "(投影模块)抓取智云课堂 / 互动式课堂投影 PPT 截图清单。search-ppt 返回的是投影截图,不是文字层/OCR;主站为空时自动回退互动式课堂后端。download=true 时下载截图并合成 PDF。返回紧凑索引:截图目录/文件名模式、页时间轴、建议抽查页与引用示例。当插件把投影作为讲义来源(slidesAsSource / ZJU_SLIDES_SOURCE=1)时,写讲义前应调用一次并传 download=true, confirm=true;download 省略时跟随 slidesAsSource / embedSlideImages(ZJU_SLIDES_SOURCE / ZJU_EMBED_SLIDES)。需要登录态(Cookie 含 _token,由服务端本地解析,不接受也不回显 Cookie)。抓不到时返回诊断,可降级为纯字幕总结。dsh 的 enableSlides(ZJU_ENABLE_SLIDES)关闭时本工具不注册。",
|
|
64
64
|
"parameters": {
|
|
65
65
|
"url_or_sub_id": {
|
|
66
|
-
"description": "回放 URL(通常含 course_id
|
|
66
|
+
"description": "回放 URL(通常含 course_id,支持互动式课堂 hash 链接)或 sub_id",
|
|
67
67
|
"type": "string",
|
|
68
68
|
"required": true
|
|
69
69
|
},
|
|
@@ -164,7 +164,7 @@ export const ZJU_TOOLS = [
|
|
|
164
164
|
},
|
|
165
165
|
{
|
|
166
166
|
"name": "zju_write_note",
|
|
167
|
-
"description": "写入讲义 Markdown
|
|
167
|
+
"description": "写入讲义 Markdown(content 或 content_file 二选一):自动命名(知识总结-<日期>-<课程>-<主题>)、默认拒绝静默覆盖、写前修正公式、写后返回规范检查,并按设置自动排版同名 PDF——写文件、检查、出 PDF 一次完成。只写工作区内的 .md 文件。",
|
|
168
168
|
"parameters": {
|
|
169
169
|
"sub_id": {
|
|
170
170
|
"description": "课程回放的 sub_id,用于追溯(不传 name 时也参与文件名)",
|
|
@@ -172,9 +172,12 @@ export const ZJU_TOOLS = [
|
|
|
172
172
|
"required": true
|
|
173
173
|
},
|
|
174
174
|
"content": {
|
|
175
|
-
"description": "讲义 Markdown
|
|
176
|
-
"type": "string"
|
|
177
|
-
|
|
175
|
+
"description": "讲义 Markdown 全文(与 content_file 二选一)",
|
|
176
|
+
"type": "string"
|
|
177
|
+
},
|
|
178
|
+
"content_file": {
|
|
179
|
+
"description": "从工作区内的 Markdown 草稿读取讲义全文(与 content 二选一)。长篇讲义建议先用 write 落盘,再传此路径,避免在 run_code 里重复粘贴。",
|
|
180
|
+
"type": "string"
|
|
178
181
|
},
|
|
179
182
|
"name": {
|
|
180
183
|
"description": "讲义文件名(可省略 .md),由你按上课时间与本节内容命名,推荐 知识总结-<上课日期 YYYY-MM-DD>-<课程简称>-<本节主题>;拿不到上课日期时省略日期段,不要用当天日期顶替",
|
package/lib/tools.schema.json
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
[
|
|
2
2
|
{
|
|
3
3
|
"name": "zju_parse_url",
|
|
4
|
-
"description": "解析浙大智云课堂
|
|
4
|
+
"description": "解析浙大智云课堂 / 互动式课堂回放链接,提取 sub_id、course_id 与 tenant_code;兼容 classroom.zju.edu.cn/livingroom?... 与 interactivemeta.cmc.zju.edu.cn/#/replay?... 两种 URL。",
|
|
5
5
|
"parameters": {
|
|
6
6
|
"url": {
|
|
7
|
-
"description": "
|
|
7
|
+
"description": "回放 URL(classroom.zju.edu.cn/livingroom?... 或 interactivemeta.cmc.zju.edu.cn/#/replay?...)或纯 sub_id 数字",
|
|
8
8
|
"type": "string",
|
|
9
9
|
"required": true
|
|
10
10
|
}
|
|
@@ -12,10 +12,10 @@
|
|
|
12
12
|
},
|
|
13
13
|
{
|
|
14
14
|
"name": "zju_fetch_transcript",
|
|
15
|
-
"description": "
|
|
15
|
+
"description": "抓取智云课堂 / 互动式课堂某节课的语音识别字幕。先匿名;401/403 时自动用本机登录态重试一次,并自动回退互动式课堂后端。登录态只能来自本机 Edge 或 ZJU_COOKIE_FILE,不要传 Cookie。默认 per_minute 带时间戳;长课用 chunked;同一节课只抓一次,per_segment 仅在确实需要秒级时间戳时用。",
|
|
16
16
|
"parameters": {
|
|
17
17
|
"url_or_sub_id": {
|
|
18
|
-
"description": "回放 URL
|
|
18
|
+
"description": "回放 URL(含互动式课堂 #/replay hash 链接)或 sub_id",
|
|
19
19
|
"type": "string",
|
|
20
20
|
"required": true
|
|
21
21
|
},
|
|
@@ -52,10 +52,10 @@
|
|
|
52
52
|
},
|
|
53
53
|
{
|
|
54
54
|
"name": "zju_fetch_slides",
|
|
55
|
-
"description": "
|
|
55
|
+
"description": "(投影模块)抓取智云课堂 / 互动式课堂投影 PPT 截图清单。search-ppt 返回的是投影截图,不是文字层/OCR;主站为空时自动回退互动式课堂后端。download=true 时下载截图并合成 PDF。返回紧凑索引:截图目录/文件名模式、页时间轴、建议抽查页与引用示例。当插件把投影作为讲义来源(slidesAsSource / ZJU_SLIDES_SOURCE=1)时,写讲义前应调用一次并传 download=true, confirm=true;download 省略时跟随 slidesAsSource / embedSlideImages(ZJU_SLIDES_SOURCE / ZJU_EMBED_SLIDES)。需要登录态(Cookie 含 _token,由服务端本地解析,不接受也不回显 Cookie)。抓不到时返回诊断,可降级为纯字幕总结。dsh 的 enableSlides(ZJU_ENABLE_SLIDES)关闭时本工具不注册。",
|
|
56
56
|
"parameters": {
|
|
57
57
|
"url_or_sub_id": {
|
|
58
|
-
"description": "回放 URL(通常含 course_id
|
|
58
|
+
"description": "回放 URL(通常含 course_id,支持互动式课堂 hash 链接)或 sub_id",
|
|
59
59
|
"type": "string",
|
|
60
60
|
"required": true
|
|
61
61
|
},
|
|
@@ -156,7 +156,7 @@
|
|
|
156
156
|
},
|
|
157
157
|
{
|
|
158
158
|
"name": "zju_write_note",
|
|
159
|
-
"description": "写入讲义 Markdown
|
|
159
|
+
"description": "写入讲义 Markdown(content 或 content_file 二选一):自动命名(知识总结-<日期>-<课程>-<主题>)、默认拒绝静默覆盖、写前修正公式、写后返回规范检查,并按设置自动排版同名 PDF——写文件、检查、出 PDF 一次完成。只写工作区内的 .md 文件。",
|
|
160
160
|
"parameters": {
|
|
161
161
|
"sub_id": {
|
|
162
162
|
"description": "课程回放的 sub_id,用于追溯(不传 name 时也参与文件名)",
|
|
@@ -164,9 +164,12 @@
|
|
|
164
164
|
"required": true
|
|
165
165
|
},
|
|
166
166
|
"content": {
|
|
167
|
-
"description": "讲义 Markdown
|
|
168
|
-
"type": "string"
|
|
169
|
-
|
|
167
|
+
"description": "讲义 Markdown 全文(与 content_file 二选一)",
|
|
168
|
+
"type": "string"
|
|
169
|
+
},
|
|
170
|
+
"content_file": {
|
|
171
|
+
"description": "从工作区内的 Markdown 草稿读取讲义全文(与 content 二选一)。长篇讲义建议先用 write 落盘,再传此路径,避免在 run_code 里重复粘贴。",
|
|
172
|
+
"type": "string"
|
|
170
173
|
},
|
|
171
174
|
"name": {
|
|
172
175
|
"description": "讲义文件名(可省略 .md),由你按上课时间与本节内容命名,推荐 知识总结-<上课日期 YYYY-MM-DD>-<课程简称>-<本节主题>;拿不到上课日期时省略日期段,不要用当天日期顶替",
|