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/docs/technical.md
CHANGED
|
@@ -5,8 +5,9 @@
|
|
|
5
5
|
|
|
6
6
|
## 1. 仓库结构与数据流
|
|
7
7
|
|
|
8
|
-
|
|
9
|
-
|
|
8
|
+
本仓库既是插件的**能力核心**,也同时是两种入口的发布源:**dsh 原生插件包**与 **Agent Plugins 1.0
|
|
9
|
+
通用包**。Python 核心、MCP 服务器、讲义 Skill,以及 dsh 用的 `package.json` / `cordis.patch.yml` / `lib/`
|
|
10
|
+
和通用入口用的根 `plugin.json` / `mcp.json` 都在这里。
|
|
10
11
|
|
|
11
12
|
```text
|
|
12
13
|
dsh-zju-lecture-note/
|
|
@@ -18,8 +19,10 @@ dsh-zju-lecture-note/
|
|
|
18
19
|
│ ├── client.js # 浏览器半边:设置页 + 左栏「智云讲义」入口
|
|
19
20
|
│ ├── tools.js # 生成物:dsh 工具定义
|
|
20
21
|
│ └── tools.schema.json # 生成物:工具定义快照(供测试比对)
|
|
21
|
-
├──
|
|
22
|
-
├──
|
|
22
|
+
├── plugin.json # Agent Plugins 1.0 通用入口清单(组件位置固定在 skills/ 与 mcp.json)
|
|
23
|
+
├── mcp.json # Agent Plugins 1.0 的 MCP 配置(stdio → node ./server.mjs)
|
|
24
|
+
├── .minimax-plugin/plugin.json # 历史打包脚本使用的清单(tools/build_plugin.py)
|
|
25
|
+
├── zju-lecture.mcp.json # 历史打包脚本使用的 MCP 定义(带 description / timeout)
|
|
23
26
|
├── server.mjs # 启动器:解析 Python 解释器并拉起 MCP 服务
|
|
24
27
|
├── mcp_server.py # MCP stdio 服务器(JSON-RPC 2.0,隐私边界在这里)
|
|
25
28
|
├── zju_lecture/ # 核心库(纯标准库)
|
|
@@ -75,14 +78,21 @@ dsh-zju-lecture-note/
|
|
|
75
78
|
→(compile)scholia PDF + 逐页 PNG
|
|
76
79
|
```
|
|
77
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
|
+
|
|
78
86
|
字幕保留 `classroom.zju.edu.cn`:先匿名请求,**仅 HTTP 401/403** 时调用 `_resolve_cookie`
|
|
79
87
|
(进程缓存 → `ZJU_COOKIE` → `ZJU_COOKIE_FILE` → `zju_login` 保存的本机登录态 → Edge)
|
|
80
|
-
解析 `_token`,用 Bearer
|
|
88
|
+
解析 `_token`,用 Bearer 重试。携带登录态时,主站失败或业务错误会再试一次
|
|
89
|
+
`interactivemeta.cmc.zju.edu.cn` 的同一个 `search-trans-result` 路径;这是工具内部的自动回退,
|
|
90
|
+
不要手工换主机。字幕请求**不发 Cookie 头**,Bearer 只发往这两个浙大官方主机。
|
|
81
91
|
兼容两种返回:`ainew` 用 `BeginSec` / `Text`,老课程 `ai` 用 `time` / `zhtext` / `entext`
|
|
82
92
|
(以第一条时间戳为相对零点换算秒数)。
|
|
83
93
|
字幕鉴权属于核心链路,**不需要开启登录辅助工具**(`enableLoginTools` 只控制视频直链与读 Cookie 工具)。
|
|
84
|
-
|
|
85
|
-
|
|
94
|
+
官网实证同一课匿名 403、Bearer-only HTTP 200 / code 0;CLI 默认自动重试,`--no-login` 可关闭,
|
|
95
|
+
`--cookie-file` 可指定本地文件;没有明文 token 参数。
|
|
86
96
|
|
|
87
97
|
### 一键登录窗口(`zju_login`)
|
|
88
98
|
|
|
@@ -94,11 +104,13 @@ dsh-zju-lecture-note/
|
|
|
94
104
|
2. 浏览器打开用户给的课堂链接(仅 `https://*.zju.edu.cn`);用户在页面里完成 SSO / 2FA。
|
|
95
105
|
3. 插件每 1.5s 通过 CDP `Storage.getCookies` 读取 Cookie,只保留课堂主机与
|
|
96
106
|
`.zju.edu.cn` 父域(`_token` 所在),排除其他 ZJU 子域与相似域名。
|
|
97
|
-
4. 检测到可解析的 `_token` 后,`save_session()` 只保存 Cookie
|
|
98
|
-
Windows
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
107
|
+
4. 检测到可解析的 `_token` 后,`save_session()` 只保存 Cookie 头,并且**只交给平台凭据库**:
|
|
108
|
+
Windows DPAPI(`CryptProtectData`)、macOS 登录钥匙串、Linux Secret Service(`secret-tool`);
|
|
109
|
+
三者都不可用或 `ZJU_LOGIN_STORAGE=memory` 时只留在进程内存,不写文件。不保存账号密码。
|
|
110
|
+
2.2.7 及更早版本在 POSIX 写下的明文 `session.bin` 会在首次读取时迁移并覆写删除。
|
|
111
|
+
5. 关闭浏览器并删除 `login-profile`(浏览器那份 Cookie 副本),`zju_login` 把 Cookie 放进本进程缓存;
|
|
112
|
+
Agent 重试字幕一次。
|
|
113
|
+
6. 服务端仍返回 401/403 时,`_forget_cookie("session")` 删除凭据项、旧文件与专用 profile,
|
|
102
114
|
下次 `zju_login` 从真正的登录页开始,而不是重放死 Cookie。
|
|
103
115
|
|
|
104
116
|
`clear=true` 删除登录态与独立浏览器 profile;无图形界面、未安装浏览器或策略禁用远程调试时,
|
|
@@ -109,9 +121,26 @@ dsh-zju-lecture-note/
|
|
|
109
121
|
| 形态 | 载体 | 依赖 |
|
|
110
122
|
| :--- | :--- | :--- |
|
|
111
123
|
| dsh 原生插件 | 仓库根目录的 npm 包(`package.json` + `cordis.patch.yml` + `lib/`) | pnpm 装 peer;Python 3.9+;Typst 由插件自举 |
|
|
112
|
-
|
|
|
113
|
-
|
|
114
|
-
|
|
124
|
+
| Agent Plugins 1.0 通用包 | 仓库根的 `plugin.json` + `mcp.json` + `skills/` + `server.mjs` | PATH 上的 `node`;Python 3.9+ |
|
|
125
|
+
|
|
126
|
+
对外只有这两个入口。两种补充手段不算独立入口:只认裸 MCP 的宿主直接抄根 `mcp.json` 的
|
|
127
|
+
`mcpServers` 段(把 `./server.mjs` 换成绝对路径);命令行用 `python -m zju_lecture.cli`
|
|
128
|
+
(Python 3.9+,`pypdf` 仅 PDF 课件需要)。`tools/build_plugin.py` 产出的 `dist/*.zip` 是历史
|
|
129
|
+
打包脚本的 staged 产物,只含它自己的清单,根 `plugin.json` / `mcp.json` 不会混进去。
|
|
130
|
+
|
|
131
|
+
**通用入口的工作目录**:Agent Plugins 1.0 规定 `cwd` 省略时客户端**必须**以插件根为子进程工作目录,
|
|
132
|
+
而 `zju_lecture/paths.py` 的解析顺序是 绝对路径 → `ZJU_WORKSPACE` → `PWD` → cwd,所以相对输出路径
|
|
133
|
+
会落进安装目录。根 `mcp.json` 不写死 `ZJU_WORKSPACE`(用户工作区无法静态预知),由用户给绝对路径
|
|
134
|
+
或自行补 env;dsh 链路不受影响,bridge 按会话工作区传 `ZJU_WORKSPACE` 与 cwd。根 `mcp.json` 也不用
|
|
135
|
+
`${PLUGIN_ROOT}` / `${PLUGIN_DATA}` 占位符——部分客户端不展开它们,`./server.mjs` 配合默认 cwd
|
|
136
|
+
才是跨客户端写法。
|
|
137
|
+
|
|
138
|
+
**清单 schema 是封闭的**:`plugin.schema.json` 与 `mcp.schema.json` 都是 `additionalProperties: false`。
|
|
139
|
+
根 `plugin.json` 只有 `$schema` / `name` 必填,`author` 必须是对象、`repository` 必须是字符串,
|
|
140
|
+
没有 `icon` / `category` / `skills` / `mcpServers` 字段(组件位置固定:Skill 从 `skills/` 的直接子目录
|
|
141
|
+
发现,MCP 从根 `mcp.json` 读)。根 `mcp.json` 的 stdio 项只允许 `type` / `command` / `args` / `env` / `cwd`,
|
|
142
|
+
旧 `zju-lecture.mcp.json` 里的 `schemaVersion` / `description` / `timeout` 在这份 schema 下非法,
|
|
143
|
+
所以两份文件并存、各自服务自己的入口。`tests/test_agent_plugins.py` 离线守这些约束。
|
|
115
144
|
|
|
116
145
|
**Typst 自举**(v2.1.0):`zju_lecture/deps.py` 把「本机没装 Typst」从静默失败变成一次可解释的准备:
|
|
117
146
|
|
|
@@ -184,6 +213,10 @@ PATH 上的 `python3` / `python` / `py -3`。
|
|
|
184
213
|
- `main` 占的是整列页面,页首要用 `calc(20px + var(--dsh-frame-top-clearance, 0px))` 留出
|
|
185
214
|
窗口标题栏的高度,否则 Windows 上第一行会被标题栏压住。
|
|
186
215
|
- 面板页把标题渲染成 `h1`(`asPage`),设置弹窗里仍是 `h2`(弹窗自己提供标题)。
|
|
216
|
+
- 四枚预设(省 Token / 复习模式 / 投影讲义 / 全功能)只是 `PRESET_SPECS` 里的批量写入;
|
|
217
|
+
不保存「当前预设」状态。高亮由 `matchingPreset(moduleState(value))` 按 6 个子开关实时比较
|
|
218
|
+
得出,所以点预设与手动拨到同样位置完全等价;任一开关不同就不高亮。选中态用
|
|
219
|
+
`.zju-preset.is-active` 的渐变底色 + 过渡,`aria-pressed` 同步。
|
|
187
220
|
|
|
188
221
|
## 3. 工具与开关分层
|
|
189
222
|
|
|
@@ -196,14 +229,16 @@ v2.0.1 起,「字幕 → 讲义 → PDF」主链路与投影、填空笔记等
|
|
|
196
229
|
| **字幕主链路** | `zju_parse_url` / `zju_fetch_transcript` / `zju_extract_courseware` / `zju_check_note` / `zju_write_note`(含自动 PDF) / `zju_login` / `zju_doctor` | 字幕接口(先匿名,401/403 自动用本机登录态)+ 一键登录窗口 + 本地文件 + 可选 Typst | 始终开启 |
|
|
197
230
|
| **填空笔记** | `zju_build_study_notes` + `scholia-notes` Skill | 本机 Typst | 关闭(`enableStudyNotes`) |
|
|
198
231
|
| **投影抓取** | `zju_fetch_slides` | 登录态 + 截图下载 + PDF 合成 | 关闭(`enableSlides`) |
|
|
199
|
-
|
|
|
232
|
+
| **投影来源** | (`slidesAsSource` 子开关) | 依赖投影抓取;写讲义前抓取并下载,把幻灯片内容与字幕对照写入 | 关闭 |
|
|
233
|
+
| **投影插图** | (`embedSlideImages` 子开关) | 依赖投影抓取;只决定是否插入 3–8 张关键页 | 关闭 |
|
|
200
234
|
| **登录辅助** | `zju_get_video_url` / `zju_read_browser_cookie`;不影响字幕鉴权与 `zju_login` | 内存缓存 / `ZJU_COOKIE` / `ZJU_COOKIE_FILE` / 本机 Edge | 关闭(`enableLoginTools`) |
|
|
201
235
|
|
|
202
236
|
- dsh 默认注册 **7** 个工具;`enableStudyNotes` +1、`enableSlides` +1、`enableLoginTools` +2,
|
|
203
|
-
全开 **11**
|
|
237
|
+
全开 **11** 个。`slidesAsSource` / `embedSlideImages` 都是投影的子开关,不新增工具。
|
|
204
238
|
- **所有设置项都标 `.volatile()`**:dsh 只把 volatile 字段投影进配置表单,也只有这些字段能由
|
|
205
239
|
设置页写入。2.2.7 起 `python` / `timeoutMs` / `registerSkill` 以及新增的 `typstPath` /
|
|
206
240
|
`typstMirror` 也一并纳入,设置页才覆盖「工具、依赖、解释器」三层,而不是只有模块开关。
|
|
241
|
+
2.2.8 增加 `slidesAsSource`(投影作为讲义来源),设置页共 12 个可写字段。
|
|
207
242
|
- **`.volatile()` 字段是引用,不是布尔值**:dsh 把它们投影成 `{ get() }`,供插件在设置改动后
|
|
208
243
|
读取新值。`lib/index.js` 的 `readSetting()` 统一解包;直接写 `config.enableSlides === true`
|
|
209
244
|
会永远得到 `false`——2.1.1 修的「设置全开仍只有字幕」就是这个原因。新增设置项时务必走
|
|
@@ -223,8 +258,17 @@ v2.0.1 起,「字幕 → 讲义 → PDF」主链路与投影、填空笔记等
|
|
|
223
258
|
- dsh 单独把 `zju_fetch_slides` / `zju_login` 的超时提高到 600s(下载截图 / 等待用户登录),
|
|
224
259
|
其他工具仍用配置值。
|
|
225
260
|
- 投影抓取与填空笔记互不依赖;登录辅助也与投影抓取解耦——投影工具会自己解析登录态。
|
|
226
|
-
-
|
|
227
|
-
|
|
261
|
+
- 投影有三个层次:`enableSlides` 只负责注册工具;`slidesAsSource` 决定是否把幻灯片作为
|
|
262
|
+
讲义内容来源(写前必须抓取并下载一次);`embedSlideImages` 只决定是否插入 3–8 张关键页。
|
|
263
|
+
两个子开关都关闭时,提示词仍要求写讲义前调用一次 `download=false` 核对清单,避免
|
|
264
|
+
「打开了抓取开关但模型从不调用」。系统提示、Skill 附录和工具描述三处都写明顺序。
|
|
265
|
+
- 投影接口主站为 `classroom.zju.edu.cn/pptnote`,空列表或请求失败时回退
|
|
266
|
+
`interactivemeta.cmc.zju.edu.cn/pptnoteapi`;两个后端都使用同一份登录态。401/403 不重试后端,
|
|
267
|
+
直接提示重新登录。
|
|
268
|
+
- 投影截图默认下载到 `<工作区>/ppt-assets/<sub_id>/`(已 gitignore);接口没有文字层 / OCR,
|
|
269
|
+
需要幻灯片原文时走 `zju_extract_courseware`。模型不能读图时禁止臆造幻灯片文字,
|
|
270
|
+
只在文末列截图索引。
|
|
271
|
+
- 截图 URL 的时间戳会转成相对第一页的 `time`;`zju_fetch_slides` 返回紧凑的 `页时间轴`。
|
|
228
272
|
- 登录辅助默认关闭(dsh `enableLoginTools=false`),只影响视频直链与读 Cookie 工具,不影响字幕。
|
|
229
273
|
`zju_login` 是核心工具,始终注册;字幕鉴权由字幕工具内部自动完成,不需模型先调读 Cookie 工具,
|
|
230
274
|
也不新增工具或凭据参数。
|
|
@@ -243,13 +287,14 @@ v2.0.1 起,「字幕 → 讲义 → PDF」主链路与投影、填空笔记等
|
|
|
243
287
|
| `ZJU_BACKUP_DIR` | `zju_check_note` / `zju_write_note` 的备份目录(默认系统临时目录) |
|
|
244
288
|
| `ZJU_COOKIE` / `ZJU_COOKIE_FILE` | 显式本机登录态(优先级最高);存在且损坏时会挡住 `zju_login`,字幕仅在 HTTP 401/403 后自动使用 |
|
|
245
289
|
| `ZJU_LOGIN_DIR` | `zju_login` 保存登录态与独立浏览器 profile 的目录(默认用户状态目录) |
|
|
290
|
+
| `ZJU_LOGIN_STORAGE` | `os`(默认,使用平台凭据库)/ `memory`(不落盘,仅进程内);没有可用凭据库时自动等价 `memory` |
|
|
246
291
|
| `ZJU_BROWSER_BIN` | 指定登录窗口使用的浏览器可执行文件(默认 Edge → Chrome → Chromium) |
|
|
247
292
|
| `ZJU_RENDER_PDF` | 默认 `0`(MCP);对应 dsh `renderPdf`(默认开) |
|
|
248
293
|
| `ZJU_TYPST_AUTO_INSTALL` | 缺 Typst 时自动下载安装(默认 `1`;dsh 对应 `typstAutoInstall`) |
|
|
249
294
|
| `ZJU_TYPST_BIN` | 指定已有 Typst 可执行文件(优先级最高;dsh 对应 `typstPath`) |
|
|
250
295
|
| `ZJU_TYPST_MIRROR` | Typst 下载 URL 的镜像前缀,例如 `https://ghfast.top/`(dsh 对应 `typstMirror`) |
|
|
251
296
|
| `ZJU_TYPST_CACHE` | 覆盖 Typst 缓存目录(默认用户缓存;测试与换盘时用) |
|
|
252
|
-
| `ZJU_ENABLE_STUDY_NOTES` / `ZJU_ENABLE_SLIDES` / `ZJU_EMBED_SLIDES` / `ZJU_ENABLE_LOGIN_TOOLS` |
|
|
297
|
+
| `ZJU_ENABLE_STUDY_NOTES` / `ZJU_ENABLE_SLIDES` / `ZJU_SLIDES_SOURCE` / `ZJU_EMBED_SLIDES` / `ZJU_ENABLE_LOGIN_TOOLS` | 可选模块开关;`ZJU_SLIDES_SOURCE` 把投影作为讲义来源,`ZJU_EMBED_SLIDES` 只控制插图;最后一项只控制登录辅助工具,字幕鉴权不受影响 |
|
|
253
298
|
| `ZJU_ALLOW_SENSITIVE_PATHS` | 显式关闭本地敏感路径保护(不推荐) |
|
|
254
299
|
|
|
255
300
|
相对路径解析顺序:绝对路径 → `ZJU_WORKSPACE` → `PWD` → 服务进程 cwd;都找不到时,
|
|
@@ -266,7 +311,12 @@ v2.0.1 起,「字幕 → 讲义 → PDF」主链路与投影、填空笔记等
|
|
|
266
311
|
4. **写文件**:原子替换;回写前备份到 `ZJU_BACKUP_DIR`。
|
|
267
312
|
5. **排版 PDF**:把同一份内容写进 `<工作区>/.zju-lecture/handout/<stem>/main.typ` 并编译;
|
|
268
313
|
成功时 PDF 落在讲义同目录,返回一行 `PDF: <路径>(N 页)`;失败只回一行
|
|
269
|
-
`PDF 跳过: …`,Markdown
|
|
314
|
+
`PDF 跳过: …`,Markdown 已写入。成功时也把 Typst 的图片/排版警告以
|
|
315
|
+
`PDF 提示:` 回传,不再静默丢弃。
|
|
316
|
+
6. **图片检查**:扫描 Markdown 图片引用,返回 `图片引用: N 张 | ...`;
|
|
317
|
+
区分本地缺失、工作区外与外链,避免 PDF 里只剩「图片未嵌入」占位。
|
|
318
|
+
|
|
319
|
+
输入支持 `content` 或 `content_file`(二选一;后者读取工作区 `.md` 草稿,适合长讲义,避免在 `run_code` 里重复粘贴)。
|
|
270
320
|
|
|
271
321
|
省 token 的约定:`zju_write_note` 已经包含校验,**通常不需要**再调 `zju_check_note`;
|
|
272
322
|
只有手工改过文件、或想给已有讲义补 PDF 时才用 `zju_check_note(pdf=true)`。
|
|
@@ -474,8 +524,9 @@ python tools/check_note.py --fix 讲义.md # 自动修正机械问题
|
|
|
474
524
|
|
|
475
525
|
1. 来源只有本地:内存缓存 → `ZJU_COOKIE` → `ZJU_COOKIE_FILE` → `zju_login` 保存的登录态 → 本机 Edge;
|
|
476
526
|
2. 校验:拒绝换行(HTTP 头注入)、空 name、超长;不合法只返回原因,不回显内容;
|
|
477
|
-
3. 使用:字幕先匿名,仅 HTTP 401/403 后自动读取本地登录态、解析 Bearer
|
|
478
|
-
|
|
527
|
+
3. 使用:字幕先匿名,仅 HTTP 401/403 后自动读取本地登录态、解析 Bearer 重试;
|
|
528
|
+
主站失败时自动回退 `interactivemeta.cmc.zju.edu.cn`。字幕不发 Cookie 头,Bearer 只发往这两个
|
|
529
|
+
浙大官方主机;每次请求仍按同 origin 校验重定向;投影边界见下;
|
|
479
530
|
4. 缓存:Python 子进程内存;
|
|
480
531
|
5. 回显:Cookie / 密码 / Bearer 没有;工具 schema 中没有 cookie / password / reveal / domain 参数。
|
|
481
532
|
签名视频直链是例外,会作为预期结果返回给调用方;
|
|
@@ -483,10 +534,10 @@ python tools/check_note.py --fix 讲义.md # 自动修正机械问题
|
|
|
483
534
|
依赖模块的镜像 URL 先由 `deps._redact_url()` 去掉 userinfo / query / fragment,
|
|
484
535
|
bridge.js 转发 stderr 前再做一层 JS 脱敏(见 [SECURITY.md](../SECURITY.md) §7.4);
|
|
485
536
|
7. 临时文件:只读打开优先;必须复制时连同 `-wal` / `-shm` 一起复制(刚登录的行可能还在 WAL 里),
|
|
486
|
-
权限 0600
|
|
487
|
-
8.
|
|
488
|
-
|
|
489
|
-
`zju_login(clear=true)`
|
|
537
|
+
权限 0600,读完覆写并删除;读取前还会清理一小时前的残留副本(进程被强杀的可能遗留)。
|
|
538
|
+
8. 落盘:登录态只写入平台凭据库(Windows DPAPI 密文文件 / macOS 钥匙串项 / Linux Secret Service 项,
|
|
539
|
+
均为静态加密;无可用后端时只在内存)。独立浏览器 profile 在提取凭据后被删除。
|
|
540
|
+
`zju_login(clear=true)` 清除凭据项、旧明文文件与 profile。CDP 只连接 `127.0.0.1` 随机端口,
|
|
490
541
|
端口与浏览器生命周期由工具管理;端口本身没有应用层认证,见 SECURITY.md 的已知边界。
|
|
491
542
|
|
|
492
543
|
Cookie 不是正常工具参数:`zju_fetch_transcript` / `zju_fetch_slides` / `zju_get_video_url` 不接受 cookie 参数,
|
|
@@ -517,13 +568,16 @@ dsh 0.2.x 不为工具参数生成根级封闭声明,但 `handle_tool_call`
|
|
|
517
568
|
- TLS 证书校验**永远不会被关闭**。信任库按 `certifi` → 随包 `cacert.pem` → 系统根证书三级回落;
|
|
518
569
|
三级都不够时才失败,并返回原因 + 下一步(当前信任库、CA 张数、`HTTPS_PROXY`、该装什么)。
|
|
519
570
|
- 瞬时故障(`IncompleteRead` / `SSLEOFError` / 超时 / 5xx)重试 3 次,指数退避 + 抖动;
|
|
520
|
-
证书校验失败**不重试**。字幕 HTTP 401/403 只做一次 Bearer
|
|
521
|
-
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
|
|
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。
|
|
525
579
|
Cookie 只给 ZJU 图片主机。图片返回 401/403 时 Bearer 只重试到同一图片主机。
|
|
526
|
-
|
|
580
|
+
重定向逐跳校验:目标必须属于上述白名单,拒绝 HTTPS→HTTP、URL userinfo、IP 字面量与
|
|
527
581
|
私网/loopback;跨 origin 时剥离 Cookie / Authorization / Proxy-Authorization,
|
|
528
582
|
被阻止的跳转只写 diagnostics(见 [SECURITY.md](../SECURITY.md) §10)。
|
|
529
583
|
- 可选的 Typst 自动安装会访问 GitHub 官方 Release,并通过 `ZJU_TYPST_MIRROR` 支持镜像;
|
|
@@ -554,7 +608,7 @@ python tools/privacy_scan.py --tarball dist/*.tgz # npm 发布产物
|
|
|
554
608
|
|
|
555
609
|
```bash
|
|
556
610
|
python -m unittest discover -s tests -v # 全部回归测试(含插件形态与隐私测试)
|
|
557
|
-
python tools/build_plugin.py --validate #
|
|
611
|
+
python tools/build_plugin.py --validate # 校验历史打包脚本的产物结构
|
|
558
612
|
python tools/check_note.py 讲义.md # 讲义渲染规范检查
|
|
559
613
|
python tools/privacy_scan.py # 工作区隐私扫描
|
|
560
614
|
python tools/privacy_scan.py --history # 连同 git 历史一起扫
|
|
@@ -611,7 +665,7 @@ npm view dsh-zju-lecture-note version # 验证
|
|
|
611
665
|
|
|
612
666
|
- `package.json` 的 `prepublishOnly` 已挂「全量测试 + 隐私扫描」,测试红了发不出去。
|
|
613
667
|
- registry 必须是 `https://registry.npmjs.org/`:国内镜像只读,`npm publish` 会 403。
|
|
614
|
-
- 版本号不能覆盖:每次发布前必须 bump
|
|
668
|
+
- 版本号不能覆盖:每次发布前必须 bump(十处对齐,见下节)。
|
|
615
669
|
- 发布后用户安装:`dsh plugin --profile desktop add dsh-zju-lecture-note`。
|
|
616
670
|
|
|
617
671
|
`files` 字段是逐文件枚举的运行时清单(`lib/`、`mcp_server.py`、`zju_lecture/*.py`、`skills/`、
|
|
@@ -621,14 +675,16 @@ npm view dsh-zju-lecture-note version # 验证
|
|
|
621
675
|
dsh 按 `peerDependencies` 校验运行时版本。若升级 dsh 后插件被跳过,请检查
|
|
622
676
|
`@deepseek-ai/dsh-*` 的 peer 范围,或按 dsh 提示使用 `dsh plugin allow-version` 做精确版本豁免。
|
|
623
677
|
|
|
624
|
-
###
|
|
678
|
+
### 历史打包脚本产物
|
|
625
679
|
|
|
626
680
|
`python tools/build_plugin.py --install --zip`;运行时文件清单在 `PACKAGE_FILES` / `PACKAGE_DIRS`,
|
|
627
|
-
|
|
681
|
+
新增文档文件时记得同步,否则装好的包里会出现断链。产物只经由这两个清单收集,
|
|
682
|
+
根 `plugin.json` / `mcp.json` **不会**混进去(`validate_package()` 会断言),因此它与通用入口互不遮蔽。
|
|
683
|
+
通用 agent 客户端一律走仓库根的 Agent Plugins 1.0 清单,不需要这个脚本。
|
|
628
684
|
|
|
629
685
|
### 版本号
|
|
630
686
|
|
|
631
|
-
|
|
687
|
+
版本在**十处**对齐:`package.json`、`pyproject.toml`、`mcp_server.SERVER_VERSION`、根 `plugin.json`、
|
|
632
688
|
`.minimax-plugin/plugin.json`、`adapters/claude_code/plugin.json`、四个 Skill manifest
|
|
633
689
|
(由 `tools/build_skill_manifest.py` 生成)。`tests/test_settings_v227.py` 会断言。
|
|
634
690
|
|
|
@@ -679,8 +735,10 @@ PY
|
|
|
679
735
|
并给出删除路径。
|
|
680
736
|
- **git 历史**:历史中已有的个人路径/密钥不会因为当前文件干净而消失;
|
|
681
737
|
用 `python tools/privacy_scan.py --history` 检查,必要时重写历史并轮换凭证。
|
|
682
|
-
-
|
|
683
|
-
|
|
738
|
+
- **入口别选错**:装进 dsh 用的是本仓库根目录的 npm 包(`dsh plugin ... add`,包名或 `github:` 均可);
|
|
739
|
+
通用 agent 客户端用的是同一份仓库根的 Agent Plugins 1.0 清单(`plugin.json` + `mcp.json` + `skills/`)。
|
|
740
|
+
dsh 的安装器与 loader 只读 `package.json`,根清单对它是惰性行李,两条安装路径互不影响。
|
|
741
|
+
`tools/build_plugin.py` 的 zip 是历史产物,不是这两个入口之一。
|
|
684
742
|
- **字幕可能需登录,请遵守平台条款**:只抓本人有权访问的回放,一次一节课,不要批量抓取。
|
|
685
743
|
|
|
686
744
|
## 12. 上游与归属
|
package/lib/bridge.js
CHANGED
|
@@ -31,6 +31,7 @@ const DEFAULT_MAX_WORKSPACES = 2;
|
|
|
31
31
|
const SPAWN_SETTING_KEYS = [
|
|
32
32
|
"python",
|
|
33
33
|
"enableSlides",
|
|
34
|
+
"slidesAsSource",
|
|
34
35
|
"embedSlideImages",
|
|
35
36
|
"enableStudyNotes",
|
|
36
37
|
"enableLoginTools",
|
|
@@ -141,6 +142,12 @@ export class ZjuBridge {
|
|
|
141
142
|
* pre-1.5.1 default (enabled), matching the Python core's MCP default.
|
|
142
143
|
*/
|
|
143
144
|
this.enableSlides = options.enableSlides !== false;
|
|
145
|
+
/**
|
|
146
|
+
* Projection as a note source: the agent must fetch/download the
|
|
147
|
+
* screenshots before writing. Independent of `embedSlideImages`, which
|
|
148
|
+
* only decides whether key pages are inserted into the Markdown.
|
|
149
|
+
*/
|
|
150
|
+
this.slidesAsSource = this.enableSlides && options.slidesAsSource === true;
|
|
144
151
|
this.embedSlideImages = this.enableSlides && options.embedSlideImages === true;
|
|
145
152
|
/** Optional fill-in study-note workflow; default true for direct users. */
|
|
146
153
|
this.enableStudyNotes = options.enableStudyNotes !== false;
|
|
@@ -197,11 +204,13 @@ export class ZjuBridge {
|
|
|
197
204
|
* @returns {boolean} whether anything actually changed
|
|
198
205
|
*/
|
|
199
206
|
configure(options = {}) {
|
|
207
|
+
const enableSlides = options.enableSlides !== false;
|
|
200
208
|
const next = {
|
|
201
209
|
python: options.python || "",
|
|
202
210
|
timeoutMs: options.timeoutMs || 120000,
|
|
203
|
-
enableSlides
|
|
204
|
-
|
|
211
|
+
enableSlides,
|
|
212
|
+
slidesAsSource: enableSlides && options.slidesAsSource === true,
|
|
213
|
+
embedSlideImages: enableSlides && options.embedSlideImages === true,
|
|
205
214
|
enableStudyNotes: options.enableStudyNotes !== false,
|
|
206
215
|
enableLoginTools: options.enableLoginTools !== false,
|
|
207
216
|
renderPdf: options.renderPdf === true,
|
|
@@ -324,6 +333,7 @@ export class ZjuBridge {
|
|
|
324
333
|
// The plugin setting is authoritative for its own Python child; the
|
|
325
334
|
// env vars remain the switches for plain MCP hosts.
|
|
326
335
|
ZJU_ENABLE_SLIDES: this.enableSlides ? "1" : "0",
|
|
336
|
+
ZJU_SLIDES_SOURCE: this.slidesAsSource ? "1" : "0",
|
|
327
337
|
ZJU_EMBED_SLIDES: this.embedSlideImages ? "1" : "0",
|
|
328
338
|
ZJU_ENABLE_STUDY_NOTES: this.enableStudyNotes ? "1" : "0",
|
|
329
339
|
ZJU_ENABLE_LOGIN_TOOLS: this.enableLoginTools ? "1" : "0",
|
package/lib/client.js
CHANGED
|
@@ -17,6 +17,7 @@
|
|
|
17
17
|
* - `renderPdf` auto-typeset the written note into a reading PDF
|
|
18
18
|
* - `enableStudyNotes` fill-in study notes (+ scholia-notes Skill)
|
|
19
19
|
* - `enableSlides` projected-slide capture
|
|
20
|
+
* - `slidesAsSource` read the captured slides as a note source
|
|
20
21
|
* - `embedSlideImages` reference those screenshots in the note
|
|
21
22
|
* - `enableLoginTools` video URL / Edge-cookie helpers
|
|
22
23
|
* - `typstAutoInstall` install Typst on first use
|
|
@@ -52,6 +53,94 @@ window.__ModuleLoader__.load({
|
|
|
52
53
|
'dsh-zju-lecture-note',
|
|
53
54
|
]
|
|
54
55
|
|
|
56
|
+
/**
|
|
57
|
+
* Presets are only bulk writes over the same switches the page edits.
|
|
58
|
+
*
|
|
59
|
+
* Nothing stores a "selected preset" id: the highlight below is derived by
|
|
60
|
+
* comparing the live config with these exact values. That is what makes
|
|
61
|
+
* "clicked a preset" and "set the same switches by hand" identical — both
|
|
62
|
+
* for the agent's prompt and for the highlighted button.
|
|
63
|
+
*/
|
|
64
|
+
const PRESET_SPECS = [
|
|
65
|
+
{
|
|
66
|
+
id: 'token',
|
|
67
|
+
nameKey: 'presetToken',
|
|
68
|
+
hintKey: 'presetTokenHint',
|
|
69
|
+
values: {
|
|
70
|
+
renderPdf: true,
|
|
71
|
+
enableStudyNotes: false,
|
|
72
|
+
enableSlides: false,
|
|
73
|
+
slidesAsSource: false,
|
|
74
|
+
embedSlideImages: false,
|
|
75
|
+
enableLoginTools: false,
|
|
76
|
+
},
|
|
77
|
+
},
|
|
78
|
+
{
|
|
79
|
+
id: 'study',
|
|
80
|
+
nameKey: 'presetStudy',
|
|
81
|
+
hintKey: 'presetStudyHint',
|
|
82
|
+
values: {
|
|
83
|
+
renderPdf: true,
|
|
84
|
+
enableStudyNotes: true,
|
|
85
|
+
enableSlides: false,
|
|
86
|
+
slidesAsSource: false,
|
|
87
|
+
embedSlideImages: false,
|
|
88
|
+
enableLoginTools: false,
|
|
89
|
+
},
|
|
90
|
+
},
|
|
91
|
+
{
|
|
92
|
+
id: 'slides',
|
|
93
|
+
nameKey: 'presetSlides',
|
|
94
|
+
hintKey: 'presetSlidesHint',
|
|
95
|
+
values: {
|
|
96
|
+
renderPdf: true,
|
|
97
|
+
enableStudyNotes: false,
|
|
98
|
+
enableSlides: true,
|
|
99
|
+
slidesAsSource: true,
|
|
100
|
+
embedSlideImages: true,
|
|
101
|
+
enableLoginTools: false,
|
|
102
|
+
},
|
|
103
|
+
},
|
|
104
|
+
{
|
|
105
|
+
id: 'full',
|
|
106
|
+
nameKey: 'presetFull',
|
|
107
|
+
hintKey: 'presetFullHint',
|
|
108
|
+
values: {
|
|
109
|
+
renderPdf: true,
|
|
110
|
+
enableStudyNotes: true,
|
|
111
|
+
enableSlides: true,
|
|
112
|
+
slidesAsSource: true,
|
|
113
|
+
embedSlideImages: true,
|
|
114
|
+
enableLoginTools: true,
|
|
115
|
+
},
|
|
116
|
+
},
|
|
117
|
+
]
|
|
118
|
+
|
|
119
|
+
/**
|
|
120
|
+
* The same normalisation the Host and Python core apply: a missing
|
|
121
|
+
* `renderPdf` means on, optional modules mean off, and the projection
|
|
122
|
+
* sub-switches are inert unless `enableSlides` is on.
|
|
123
|
+
*/
|
|
124
|
+
function moduleState(value) {
|
|
125
|
+
const enableSlides = value?.enableSlides === true
|
|
126
|
+
return {
|
|
127
|
+
renderPdf: value?.renderPdf !== false,
|
|
128
|
+
enableStudyNotes: value?.enableStudyNotes === true,
|
|
129
|
+
enableSlides,
|
|
130
|
+
slidesAsSource: enableSlides && value?.slidesAsSource === true,
|
|
131
|
+
embedSlideImages: enableSlides && value?.embedSlideImages === true,
|
|
132
|
+
enableLoginTools: value?.enableLoginTools === true,
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
/** The preset whose switch values exactly match the current config. */
|
|
137
|
+
function matchingPreset(value) {
|
|
138
|
+
const state = moduleState(value)
|
|
139
|
+
return PRESET_SPECS.find((preset) => (
|
|
140
|
+
Object.keys(preset.values).every((key) => state[key] === preset.values[key])
|
|
141
|
+
)) || null
|
|
142
|
+
}
|
|
143
|
+
|
|
55
144
|
const en = {
|
|
56
145
|
sectionTitle: 'ZJU classroom lecture notes',
|
|
57
146
|
panelLabel: 'ZJU notes',
|
|
@@ -70,9 +159,11 @@ window.__ModuleLoader__.load({
|
|
|
70
159
|
presetsTitle: 'Presets',
|
|
71
160
|
presetToken: 'Token saver',
|
|
72
161
|
presetStudy: 'Study mode',
|
|
162
|
+
presetSlides: 'Slide notes',
|
|
73
163
|
presetFull: 'Everything',
|
|
74
164
|
presetTokenHint: 'PDF only',
|
|
75
165
|
presetStudyHint: 'PDF + fill-in notes',
|
|
166
|
+
presetSlidesHint: 'Transcript + slides · no fill-in PDF',
|
|
76
167
|
presetFullHint: 'All modules',
|
|
77
168
|
coreTitle: 'Core pipeline',
|
|
78
169
|
coreBadge: 'Always on',
|
|
@@ -103,6 +194,8 @@ window.__ModuleLoader__.load({
|
|
|
103
194
|
slidesBadge: 'Needs login',
|
|
104
195
|
slidesTitle2: 'Capture projected slides',
|
|
105
196
|
slidesHint: 'Registers zju_fetch_slides. The transcript path is unaffected.',
|
|
197
|
+
sourceTitle: 'Write notes from projected slides',
|
|
198
|
+
sourceHint: 'Fetch and read the screenshots before writing; weave slide content into the note alongside the transcript.',
|
|
106
199
|
imagesTitle: 'Reference screenshots in notes',
|
|
107
200
|
imagesHint: 'Only when capture is on; adds download time and vision tokens.',
|
|
108
201
|
dependency: 'Turn on capture first.',
|
|
@@ -148,9 +241,11 @@ window.__ModuleLoader__.load({
|
|
|
148
241
|
presetsTitle: '一键配置',
|
|
149
242
|
presetToken: '省 Token',
|
|
150
243
|
presetStudy: '复习模式',
|
|
244
|
+
presetSlides: '投影讲义',
|
|
151
245
|
presetFull: '全功能',
|
|
152
246
|
presetTokenHint: '仅 PDF',
|
|
153
247
|
presetStudyHint: 'PDF + 填空笔记',
|
|
248
|
+
presetSlidesHint: '字幕+投影 · 不做填空 PDF',
|
|
154
249
|
presetFullHint: '全部模块',
|
|
155
250
|
coreTitle: '核心链路',
|
|
156
251
|
coreBadge: '始终开启',
|
|
@@ -181,6 +276,8 @@ window.__ModuleLoader__.load({
|
|
|
181
276
|
slidesBadge: '需登录',
|
|
182
277
|
slidesTitle2: '抓取投影截图',
|
|
183
278
|
slidesHint: '注册 zju_fetch_slides;字幕链路不受影响。',
|
|
279
|
+
sourceTitle: '依据投影截图写讲义',
|
|
280
|
+
sourceHint: '写讲义前先抓取并阅读截图,把幻灯片内容与字幕一起写进讲义。',
|
|
184
281
|
imagesTitle: '把截图引用进讲义',
|
|
185
282
|
imagesHint: '仅在投影抓取开启时生效;增加下载时间与视觉 token。',
|
|
186
283
|
dependency: '请先开启投影抓取。',
|
|
@@ -224,10 +321,13 @@ window.__ModuleLoader__.load({
|
|
|
224
321
|
'.zju-arrow{font-size:12px;line-height:1;color:var(--dsw-alias-label-tertiary)}',
|
|
225
322
|
'.zju-presets{display:flex;align-items:center;gap:8px;flex-wrap:wrap}',
|
|
226
323
|
'.zju-presets-label{font-size:12px;color:var(--dsw-alias-label-secondary);margin-right:2px}',
|
|
227
|
-
'.zju-preset{display:inline-flex;flex-direction:column;align-items:flex-start;gap:1px;padding:6px 10px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:transparent;cursor:pointer;font:inherit;color:var(--dsw-alias-label-primary);text-align:left}',
|
|
228
|
-
'.zju-preset:hover:not(:disabled){border-color:color-mix(in srgb,var(--dsw-alias-brand-primary) 45%,var(--dsw-alias-border-l2));background:color-mix(in srgb,var(--dsw-alias-brand-primary) 5%,transparent)}',
|
|
324
|
+
'.zju-preset{display:inline-flex;flex-direction:column;align-items:flex-start;gap:1px;padding:6px 10px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background-color:transparent;background-image:none;cursor:pointer;font:inherit;color:var(--dsw-alias-label-primary);text-align:left;transition:background-color .18s ease,border-color .18s ease,box-shadow .18s ease,color .18s ease,transform .18s ease}',
|
|
325
|
+
'.zju-preset:hover:not(:disabled){border-color:color-mix(in srgb,var(--dsw-alias-brand-primary) 45%,var(--dsw-alias-border-l2));background-color:color-mix(in srgb,var(--dsw-alias-brand-primary) 5%,transparent)}',
|
|
229
326
|
'.zju-preset:disabled{opacity:.5;cursor:default}',
|
|
230
327
|
'.zju-preset:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:2px}',
|
|
328
|
+
'.zju-preset.is-active{border-color:color-mix(in srgb,var(--dsw-alias-brand-primary) 55%,transparent);background-image:linear-gradient(135deg,color-mix(in srgb,var(--dsw-alias-brand-primary) 15%,transparent) 0%,color-mix(in srgb,var(--dsw-alias-brand-primary) 5%,transparent) 58%,color-mix(in srgb,var(--dsw-alias-brand-primary) 12%,transparent) 100%);box-shadow:0 0 0 1px color-mix(in srgb,var(--dsw-alias-brand-primary) 16%,transparent),0 5px 16px -11px color-mix(in srgb,var(--dsw-alias-brand-primary) 70%,transparent)}',
|
|
329
|
+
'.zju-preset.is-active .zju-preset-name{color:var(--dsw-alias-brand-primary);font-weight:600}',
|
|
330
|
+
'.zju-preset.is-active .zju-preset-hint{color:color-mix(in srgb,var(--dsw-alias-brand-primary) 68%,var(--dsw-alias-label-secondary))}',
|
|
231
331
|
'.zju-preset-name{font-size:12px;line-height:17px;font-weight:500}',
|
|
232
332
|
'.zju-preset-hint{font-size:10px;line-height:14px;color:var(--dsw-alias-label-tertiary)}',
|
|
233
333
|
'.zju-groups{display:flex;flex-direction:column;border-top:1px solid color-mix(in srgb,var(--dsw-alias-label-tertiary) 26%,transparent)}',
|
|
@@ -515,8 +615,8 @@ window.__ModuleLoader__.load({
|
|
|
515
615
|
return [state, run]
|
|
516
616
|
}
|
|
517
617
|
|
|
518
|
-
function Row({ t, title, hint, checked, disabled, onChange }) {
|
|
519
|
-
return h('div', { className: 'zju-row' },
|
|
618
|
+
function Row({ t, title, hint, checked, disabled, onChange, child = false }) {
|
|
619
|
+
return h('div', { className: child ? 'zju-row is-child' : 'zju-row' },
|
|
520
620
|
h('div', { className: 'zju-copy' },
|
|
521
621
|
h('div', { className: 'zju-row-title' }, t(title)),
|
|
522
622
|
h('div', { className: 'zju-row-hint' }, t(hint)),
|
|
@@ -579,7 +679,9 @@ window.__ModuleLoader__.load({
|
|
|
579
679
|
const typstAutoInstall = value.typstAutoInstall !== false
|
|
580
680
|
const enableStudyNotes = value.enableStudyNotes === true
|
|
581
681
|
const enableLoginTools = value.enableLoginTools === true
|
|
682
|
+
const slidesAsSource = enableSlides && value.slidesAsSource === true
|
|
582
683
|
const embedSlideImages = enableSlides && value.embedSlideImages === true
|
|
684
|
+
const activePreset = snapshot.status === 'ready' ? matchingPreset(value) : null
|
|
583
685
|
const registerSkill = value.registerSkill !== false
|
|
584
686
|
const python = typeof value.python === 'string' ? value.python : ''
|
|
585
687
|
const typstPath = typeof value.typstPath === 'string' ? value.typstPath : ''
|
|
@@ -610,14 +712,9 @@ window.__ModuleLoader__.load({
|
|
|
610
712
|
|
|
611
713
|
const update = (field, next) => runSave(() => settings.setField(field, next))
|
|
612
714
|
|
|
613
|
-
const applyPreset = (preset) => runSave(async () =>
|
|
614
|
-
|
|
615
|
-
|
|
616
|
-
: preset === 'study'
|
|
617
|
-
? [['renderPdf', true], ['enableStudyNotes', true], ['enableSlides', false], ['embedSlideImages', false], ['enableLoginTools', false]]
|
|
618
|
-
: [['renderPdf', true], ['enableStudyNotes', true], ['enableSlides', true], ['embedSlideImages', true], ['enableLoginTools', true]]
|
|
619
|
-
return settings.setFields(sets)
|
|
620
|
-
})
|
|
715
|
+
const applyPreset = (preset) => runSave(async () => (
|
|
716
|
+
settings.setFields(Object.entries(preset.values))
|
|
717
|
+
))
|
|
621
718
|
|
|
622
719
|
return h('div', { className: 'zju-settings-page', 'data-zju-settings': 'pipeline' },
|
|
623
720
|
h('style', { 'data-plugin': '@plugin/dsh-zju-lecture-note' }, CSS),
|
|
@@ -644,18 +741,21 @@ window.__ModuleLoader__.load({
|
|
|
644
741
|
note ? h('div', { className: 'zju-note', role: 'status' }, note) : null,
|
|
645
742
|
h('div', { className: 'zju-presets' },
|
|
646
743
|
h('span', { className: 'zju-presets-label' }, t('presetsTitle')),
|
|
647
|
-
|
|
648
|
-
|
|
649
|
-
h('
|
|
650
|
-
|
|
651
|
-
|
|
652
|
-
|
|
653
|
-
|
|
654
|
-
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
744
|
+
PRESET_SPECS.map((preset) => {
|
|
745
|
+
const active = activePreset?.id === preset.id
|
|
746
|
+
return h('button', {
|
|
747
|
+
key: preset.id,
|
|
748
|
+
type: 'button',
|
|
749
|
+
className: active ? 'zju-preset is-active' : 'zju-preset',
|
|
750
|
+
'data-preset': preset.id,
|
|
751
|
+
'aria-pressed': active ? 'true' : 'false',
|
|
752
|
+
disabled,
|
|
753
|
+
onClick: () => applyPreset(preset),
|
|
754
|
+
},
|
|
755
|
+
h('span', { className: 'zju-preset-name' }, t(preset.nameKey)),
|
|
756
|
+
h('span', { className: 'zju-preset-hint' }, t(preset.hintKey)),
|
|
757
|
+
)
|
|
758
|
+
}),
|
|
659
759
|
),
|
|
660
760
|
h('div', { className: 'zju-groups' },
|
|
661
761
|
h(Group, {
|
|
@@ -747,18 +847,24 @@ window.__ModuleLoader__.load({
|
|
|
747
847
|
disabled,
|
|
748
848
|
onChange: (next) => update('enableSlides', next),
|
|
749
849
|
}),
|
|
750
|
-
h(
|
|
751
|
-
|
|
752
|
-
|
|
753
|
-
|
|
754
|
-
|
|
755
|
-
|
|
756
|
-
|
|
757
|
-
|
|
758
|
-
|
|
759
|
-
|
|
760
|
-
|
|
761
|
-
|
|
850
|
+
h(Row, {
|
|
851
|
+
t,
|
|
852
|
+
title: 'sourceTitle',
|
|
853
|
+
hint: enableSlides ? 'sourceHint' : 'dependency',
|
|
854
|
+
checked: slidesAsSource,
|
|
855
|
+
disabled: disabled || !enableSlides,
|
|
856
|
+
child: true,
|
|
857
|
+
onChange: (next) => update('slidesAsSource', next),
|
|
858
|
+
}),
|
|
859
|
+
h(Row, {
|
|
860
|
+
t,
|
|
861
|
+
title: 'imagesTitle',
|
|
862
|
+
hint: enableSlides ? 'imagesHint' : 'dependency',
|
|
863
|
+
checked: embedSlideImages,
|
|
864
|
+
disabled: disabled || !enableSlides,
|
|
865
|
+
child: true,
|
|
866
|
+
onChange: (next) => update('embedSlideImages', next),
|
|
867
|
+
}),
|
|
762
868
|
),
|
|
763
869
|
h(Group, {
|
|
764
870
|
title: t('loginTitle'),
|