dsh-zju-lecture-note 2.2.6 → 2.2.8
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/CHANGELOG.md +154 -2
- package/README.md +77 -46
- package/SECURITY.md +169 -66
- package/docs/technical.md +101 -50
- package/lib/bridge.js +288 -79
- package/lib/client.js +1013 -758
- package/lib/index.js +349 -75
- package/lib/tools.js +28 -3
- package/lib/tools.schema.json +23 -3
- package/mcp.json +21 -0
- package/mcp_server.py +186 -44
- package/package.json +5 -2
- package/plugin.json +19 -0
- package/server.mjs +118 -0
- package/skills/scholia-notes/references/prelude.typ +9 -1
- package/skills/scholia-notes.manifest.json +3 -3
- package/skills/zju-lecture-summarizer/SKILL.md +14 -4
- package/skills/zju-lecture-summarizer/SLIDES.md +42 -5
- package/skills/zju-lecture-summarizer-help/SKILL.md +3 -3
- package/skills/zju-lecture-summarizer-help.manifest.json +4 -4
- package/skills/zju-lecture-summarizer-login/SKILL.md +1 -1
- package/skills/zju-lecture-summarizer-login.manifest.json +4 -4
- package/skills/zju-lecture-summarizer.manifest.json +6 -6
- package/zju_lecture/browser_login.py +174 -210
- package/zju_lecture/cli.py +50 -2
- package/zju_lecture/client.py +95 -18
- package/zju_lecture/cookies.py +43 -4
- package/zju_lecture/courseware.py +37 -2
- package/zju_lecture/credential_store.py +621 -0
- package/zju_lecture/deps.py +114 -17
- package/zju_lecture/handout.py +29 -3
- package/zju_lecture/note_lint.py +34 -10
- package/zju_lecture/paths.py +57 -2
- package/zju_lecture/prelude.typ +9 -1
- package/zju_lecture/slides.py +73 -35
- package/zju_lecture/study_notes.py +40 -4
package/CHANGELOG.md
CHANGED
|
@@ -1,7 +1,158 @@
|
|
|
1
1
|
# 更新日志
|
|
2
2
|
|
|
3
|
-
版本号在 `package.json`、`pyproject.toml`、`mcp_server.SERVER_VERSION`、
|
|
4
|
-
`.minimax-plugin/plugin.json` 与四个 Skill manifest
|
|
3
|
+
版本号在 `package.json`、`pyproject.toml`、`mcp_server.SERVER_VERSION`、根 `plugin.json`、
|
|
4
|
+
`.minimax-plugin/plugin.json`、`adapters/claude_code/plugin.json` 与四个 Skill manifest
|
|
5
|
+
共十处对齐。
|
|
6
|
+
|
|
7
|
+
## 2.2.8 — 2026-11-07
|
|
8
|
+
|
|
9
|
+
### 设置:第四枚「投影讲义」预设
|
|
10
|
+
|
|
11
|
+
- 新增 **`slidesAsSource`(依据投影截图写讲义)**:把课堂投影当作与字幕并列的内容来源。
|
|
12
|
+
写讲义前抓取并下载一次投影截图,把幻灯片上的定义、公式、图例、例题同字幕对照写入正文;
|
|
13
|
+
模型看不到本地图片时不得臆造幻灯片文字,只在文末列截图索引。
|
|
14
|
+
- 新增第四枚预设 **投影讲义**:`renderPdf=true`、`enableStudyNotes=false`、`enableSlides=true`、
|
|
15
|
+
`slidesAsSource=true`、`embedSlideImages=true`、`enableLoginTools=false`——依据字幕与投影
|
|
16
|
+
写阅读版 PDF + Markdown,不生成填空 PDF。其余三枚预设同步写入 `slidesAsSource=false`。
|
|
17
|
+
- **预设没有隐藏状态**:`PRESET_SPECS` 只定义 6 个子开关的目标值,点击时批量写入;高亮由
|
|
18
|
+
`matchingPreset()` 实时比较配置得出。手动把同样的开关拨到同样位置,行为与高亮都和点预设
|
|
19
|
+
一致;少一个开关就不高亮。选中态用渐变底色 + 过渡高亮,并同步 `aria-pressed`。
|
|
20
|
+
- 设置页「课堂投影」分组新增「依据投影截图写讲义」一行(依赖投影抓取);原「把截图引用进
|
|
21
|
+
讲义」明确为只控制插图,不决定投影是否作为内容来源。
|
|
22
|
+
|
|
23
|
+
### 行为:打开投影开关后模型真的会调用
|
|
24
|
+
|
|
25
|
+
- **修正提示词的自相矛盾**:此前只打开「抓取投影截图」时,系统提示写的是
|
|
26
|
+
「讲义插图模式关闭……不要主动下载或插入截图」,于是模型从不调用 `zju_fetch_slides`。
|
|
27
|
+
现在只要 `enableSlides=true`,系统提示就会把投影写进材料顺序:
|
|
28
|
+
- `slidesAsSource=true`:写前**必须**调用一次
|
|
29
|
+
`zju_fetch_slides(download=true, confirm=true)`,投影是必做材料而非可选项;
|
|
30
|
+
- `embedSlideImages=true`:写前抓一次并挑 3–8 张关键页插入;
|
|
31
|
+
- 两个子开关都关:写前调用一次 `download=false` 核对清单,不下载、不插图。
|
|
32
|
+
- **三处口径一致**:系统提示的 `materialRule` / `slidesFeatureRule`、随包 Skill 末尾按当前模式
|
|
33
|
+
追加的「本次会话:投影……」段、以及 `zju_fetch_slides` 的工具描述,都写明同一条顺序;
|
|
34
|
+
投影模式的 Skill 附录会在设置改动后重新注册,不需要重启。
|
|
35
|
+
- **Python 侧默认下载**:新增 `ZJU_SLIDES_SOURCE`;`download` 省略时在
|
|
36
|
+
`embedSlideImages` 或 `slidesAsSource` 开启时下载,并在返回里单独报告「投影作为讲义来源」
|
|
37
|
+
与「讲义插图模式」两个状态,避免把「下载了截图」误当成「读了截图」。
|
|
38
|
+
- 登录失败按工具诊断调用一次 `zju_login` 后重试;仍失败降级纯字幕,并在讲义开头注明投影未使用。
|
|
39
|
+
|
|
40
|
+
### 安全与隐私(2026-11-08 复核)
|
|
41
|
+
|
|
42
|
+
- **登录态全平台加密存储,不再有任何明文落盘路径**:Windows 用 DPAPI(不变);macOS 改为
|
|
43
|
+
登录钥匙串的 generic password 项;Linux 改为 Secret Service(`secret-tool`)。两者都通过
|
|
44
|
+
stdin 写入,密钥不出现在命令行(`ps` 不可见),写后回读校验;有可用后端时才持久化,
|
|
45
|
+
否则只在进程内存保留(`ZJU_LOGIN_STORAGE=memory` 可显式关闭持久化)。凭据库调用带 10 秒超时,
|
|
46
|
+
避免无桌面/半初始化 D-Bus 时挂起登录与自检。
|
|
47
|
+
- **清掉旧明文与第二份副本**:2.2.7 及更早版本在 POSIX 写下的明文 `session.bin` 在首次读取时
|
|
48
|
+
迁移到新后端并覆写删除(迁移失败也删除,本次会话用内存里的 Cookie);`zju_login` 提取凭据后
|
|
49
|
+
删除 `login-profile/`,磁盘上只留平台凭据库这一份加密副本;`clear=true` 三处一起清。
|
|
50
|
+
- **隐私扫描器补 ZJU 凭据形态**:新增 `zju-session-token`(`_token=…`)与
|
|
51
|
+
`php-serialized-session`(`s:6:"_token";s:40:"…";` 及其整型索引变体)两条规则,
|
|
52
|
+
避免最核心的凭据形态绕过发布前扫描。
|
|
53
|
+
- **PDF 与子进程收紧**:讲义 PDF 落盘改用 `mkstemp` + `os.replace`(原先的固定
|
|
54
|
+
`<name>.pdf.tmp` 可被预置符号链接劫持);`typst` 子进程环境删除所有 `ZJU_COOKIE*`
|
|
55
|
+
(大小写无关);`cookies.py` 的一处裸 `stderr` 输出改走 `SecretRedactor`。
|
|
56
|
+
|
|
57
|
+
### 测试与文档
|
|
58
|
+
|
|
59
|
+
- `tests/client_settings_smoke.mjs`:覆盖四枚预设、每个预设写满 6 个字段、点击后高亮、
|
|
60
|
+
手动配置等价高亮、`aria-pressed` 同步;`tests/plugin_apply_smoke.mjs` 覆盖投影讲义模式的
|
|
61
|
+
提示词、Skill 模式段与 `slidesAsSource` 热更新;Python 侧补 `ZJU_SLIDES_SOURCE` 的默认下载
|
|
62
|
+
与模式文案。
|
|
63
|
+
- README / `docs/technical.md` 更新四枚预设、`slidesAsSource`、`ZJU_SLIDES_SOURCE` 与
|
|
64
|
+
「打开开关后写前抓一次投影」的行为说明。
|
|
65
|
+
|
|
66
|
+
## 2.2.7 — 2026-11-07
|
|
67
|
+
|
|
68
|
+
### 通用入口(Agent Plugins 1.0)
|
|
69
|
+
|
|
70
|
+
- **仓库根现在同时是 Agent Plugins 1.0 通用包**:新增根 `plugin.json` 与根 `mcp.json`
|
|
71
|
+
(stdio → `node ./server.mjs`),复用既有 `skills/` 与启动器。兼容该标准的通用 agent 客户端
|
|
72
|
+
指向仓库根或解包后的 npm 包目录即可自动发现 Skill 与 MCP Server,不用手工拼配置。
|
|
73
|
+
对外入口收敛为两个:dsh 原生插件与该通用包;`adapters/*`、`.minimax-plugin/` 与
|
|
74
|
+
`tools/build_plugin.py` 的 zip 降为历史遗留,文档不再单列、也不点名任何通用客户端。
|
|
75
|
+
- **dsh 的 npm 包名与 `github:` 安装不受影响**:安装器与 loader 只读 `package.json`
|
|
76
|
+
(`app.asar` 全量扫描取证:`mcp.json` / `agent-plugins` 零命中,`plugin.json` 仅出现在无关的
|
|
77
|
+
Codex hosted-plugin 注释里),根清单是惰性行李。`lib/`、`mcp_server.py`、`zju_lecture/`、
|
|
78
|
+
`skills/` 逐字节未改。
|
|
79
|
+
- `package.json` 的 `files` 补 `plugin.json` / `mcp.json` / **`server.mjs`**:后者此前不在 npm 包里
|
|
80
|
+
(dsh 走 bridge 直拉 Python 所以不需要),而通用入口的 `args` 指向它,不补就是断链。
|
|
81
|
+
- `tools/build_plugin.py` 的「根目录不得有 plugin.json」守卫改为断言**收集后的文件清单**不含
|
|
82
|
+
`plugin.json` / `mcp.json`:产物只经由 `PACKAGE_FILES` / `PACKAGE_DIRS` 复制,根清单本来就进不去,
|
|
83
|
+
原实现查仓库根会误伤通用入口。
|
|
84
|
+
- 版本对齐从九处变**十处**(加根 `plugin.json`);新增 `tests/test_agent_plugins.py` 离线守
|
|
85
|
+
两份清单的封闭 schema(`additionalProperties: false`)、Skill 发现与 frontmatter 限额、
|
|
86
|
+
npm `files` 三项、以及与历史打包产物的隔离。
|
|
87
|
+
- 已知取舍:通用客户端按规范以插件根为 cwd,相对输出路径会落进安装目录——文档提示给绝对路径
|
|
88
|
+
或自补 `ZJU_WORKSPACE`,不改 `paths.py`;`-help` / `-login` 两个 Skill 在通用宿主里是普通可被
|
|
89
|
+
模型调用的 Skill(`modelInvocable:false` 是 dsh 的注册属性,不在 frontmatter)。
|
|
90
|
+
|
|
91
|
+
### 设置(dsh 图形化界面)
|
|
92
|
+
|
|
93
|
+
- **设置保存后立即对 Agent 生效,不再要求重启**:此前 `.volatile()` 字段保存时 dsh 只更新引用,
|
|
94
|
+
不重新执行 `apply()`;插件读到的仍是启动时的工具集、Skill、系统提示词与 Python 子进程环境。
|
|
95
|
+
现在监听 `loader/volatile-update`,重新同步工具注册、随包 Skill、提示词(`text` 改为每次组装
|
|
96
|
+
重新读取配置的 thunk),并让已启动的 Python 子进程作废,下一次调用用新环境变量拉起。
|
|
97
|
+
- **补齐设置项**:`python`(Python 解释器)、`timeoutMs`(工具超时)、`registerSkill`(注册随包
|
|
98
|
+
Skill)原先只在 Config schema 里、没有 `.volatile()`,因此不会出现在设置页;现在与
|
|
99
|
+
`renderPdf` / `enableStudyNotes` / `enableSlides` / `embedSlideImages` / `enableLoginTools`
|
|
100
|
+
一样可写。新增 `typstPath`(固定 Typst 可执行文件)与 `typstMirror`(GitHub 下载镜像前缀),
|
|
101
|
+
对应既有的 `ZJU_TYPST_BIN` / `ZJU_TYPST_MIRROR`。
|
|
102
|
+
- 设置页新增「环境与依赖」的两个输入框与「高级」分组(解释器 / 超时 / Skill 开关);
|
|
103
|
+
「全功能」预设同时打开 `embedSlideImages`;页脚说明改为「保存后立即同步,下一轮可用」。
|
|
104
|
+
- **设置页视觉收敛**:一键配置以下不再使用卡片方框,改为灰色横线分隔分组;组内设置项左缩进
|
|
105
|
+
20px;顶部标题头保留原有卡片边框与渐变;设置项文案去重并缩短(同一信息只出现一次)。
|
|
106
|
+
- `zju_doctor` 的模块状态仍取自子进程环境;设置变更后子进程重建,因此报告与实际开关一致。
|
|
107
|
+
- 回归:`tests/plugin_apply_smoke.mjs` 覆盖「引用变更 → 工具 / Skill / 提示词 / 超时同步」;
|
|
108
|
+
`tests/client_settings_smoke.mjs` 覆盖字符串与数字字段写入;新增
|
|
109
|
+
`tests/test_settings_v227.py` 静态约束(所有字段 `.volatile()`、热更新监听、环境变量映射)。
|
|
110
|
+
|
|
111
|
+
### Security
|
|
112
|
+
|
|
113
|
+
按 2026-11-06 的只读安全审查结论逐项修复(分支 `fix/security-audit-2026-11`)。
|
|
114
|
+
详细威胁模型、边界与逐条验证见 `SECURITY.md` 第 7 / 9 / 10 节。
|
|
115
|
+
|
|
116
|
+
**P0 — 可被直接利用**
|
|
117
|
+
|
|
118
|
+
- **7.1 会话工作区隔离**(`c69fbdf`):bridge 改为按绝对 workspace 维护
|
|
119
|
+
`Map<key, WorkspaceSession>`(LRU 2),每个会话独立 cwd / `ZJU_WORKSPACE` / pending;
|
|
120
|
+
删除 `PLUGIN_ROOT` 回退,工作区缺失或不存在时直接拒绝。
|
|
121
|
+
- **7.2 重定向与 SSRF**(`a45e551`):按完整 origin(scheme + host + port)比较;
|
|
122
|
+
拒绝 HTTPS→HTTP、URL userinfo、IP 字面量、localhost 与私网;截图只跟随浙大主机,
|
|
123
|
+
跨 origin 剥离 Cookie / Authorization / Proxy-Authorization,阻断原因写入 diagnostics。
|
|
124
|
+
- **7.3 工作区外读写**(`0d7f037`):新增 `require_workspace_path()`(resolve → realpath →
|
|
125
|
+
工作区 → guard → 写入复检),`zju_extract_courseware` / `zju_check_note` /
|
|
126
|
+
`mode=patch` 全部接入;外读需显式 `allow_outside_workspace=true` 且首行标注。
|
|
127
|
+
- **7.8 Typst 封面注入**(`25862cb`):拆 `escape_typst_text()` / `escape_typst_string()`;
|
|
128
|
+
封面改 `#scholia-cover(title: "…", …)` 命名参数,值按字符串字面量转义。
|
|
129
|
+
|
|
130
|
+
**P1 — 凭据、权限与资源**
|
|
131
|
+
|
|
132
|
+
- **7.4 镜像 URL 脱敏**(`db46f38`):`_redact_url()` 去掉 userinfo / query / fragment,
|
|
133
|
+
describe / progress / 异常全走脱敏;bridge.js 对 Python stderr 再做一层 JS 脱敏。
|
|
134
|
+
- **7.5 隐私扫描器掩码**(`d6f0668`):默认只输出 path:line、规则名与命中长度;
|
|
135
|
+
`--show-excerpt` 才输出前后各 6 字符、中间 `***` 的摘录;JSON 默认不含 excerpt。
|
|
136
|
+
- **7.6 临时文件与备份权限**(`2f2de09`):session / 截图 / PDF 统一 `mkstemp` +
|
|
137
|
+
`os.replace`;备份目录 0700、文件 0600、随机文件名;写入前 `lstat` 拒绝符号链接。
|
|
138
|
+
- **7.9 资源上限**(`b3864a6`):课件单成员 16 MiB / 合计 64 MiB 预检;PNG 用
|
|
139
|
+
`decompressobj(max_length)`;截图总量达到上限即停止;Typst 下载 256 MiB 上限并删半成品;
|
|
140
|
+
tar 拒绝符号链接 / 硬链接。
|
|
141
|
+
|
|
142
|
+
**P2 — 入口、副作用与文档**
|
|
143
|
+
|
|
144
|
+
- **7.7 参数白名单**(`ea2f6d6`):`handle_tool_call` 以 `inputSchema.properties` 为白名单,
|
|
145
|
+
未知键直接拒绝,工具不执行,错误只含键名。
|
|
146
|
+
- **副作用确认**(`d7ccae0`):`zju_login(clear=true)`、`zju_doctor(install=true)`、
|
|
147
|
+
`zju_fetch_slides(download=true)` 必须同时传 `confirm=true`,否则不产生任何副作用。
|
|
148
|
+
- **CLI 与依赖**(本次提交):`zju-lecture cookie --reveal` 在非 TTY 下拒绝、交互式需输入
|
|
149
|
+
`yes`;`pypdf` 收紧为 `>=4.0,<8`;补 `package-lock.json` 使 `npm audit` 可运行。
|
|
150
|
+
- **文档**:`SECURITY.md` 第 7 节改为逐条「修复 commit + 回归测试」,新增第 9 节
|
|
151
|
+
「工作区边界」与第 10 节「重定向 origin 校验与 SSRF」。
|
|
152
|
+
|
|
153
|
+
验证:734 tests OK(skipped=6);`node tests/bridge_smoke.mjs` / `bridge_workspace_smoke.mjs` /
|
|
154
|
+
`bridge_workspace_isolation.mjs` 均 `ok:true`;`python tools/privacy_scan.py` 通过;
|
|
155
|
+
`npm pack --dry-run` 文件清单无临时 / 备份产物。
|
|
5
156
|
|
|
6
157
|
## 2.2.6 — 2026-11-06
|
|
7
158
|
|
|
@@ -50,6 +201,7 @@
|
|
|
50
201
|
插件通过 `127.0.0.1` 随机端口从浏览器进程内读取 Cookie,成功后自动关闭窗口。
|
|
51
202
|
- **登录态安全保存**:只保存 Cookie(不保存账号密码),Windows 用 DPAPI 绑定当前用户,
|
|
52
203
|
macOS / Linux 用 0600 文件;`zju_login(clear=true)` 一并删除登录态与独立浏览器配置。
|
|
204
|
+
(2.2.8 起 macOS / Linux 改为平台凭据库加密存储,明文文件路径已移除。)
|
|
53
205
|
登录态失效时自动清除,下次从真正的登录页开始,不重放死 Cookie。
|
|
54
206
|
- **新的解析顺序**:内存缓存 → `ZJU_COOKIE` → `ZJU_COOKIE_FILE` → `zju_login` 登录态 → 本机 Edge。
|
|
55
207
|
`ZJU_COOKIE_FILE` 降为无图形界面服务器的高级兜底,普通用户不再需要手工配置。
|
package/README.md
CHANGED
|
@@ -1,13 +1,10 @@
|
|
|
1
1
|
# 浙大智云课堂讲义插件(ZJU Lecture Agent Plugin)
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
面向 **DeepSeek Harness(dsh)** 与任意 **MCP 宿主**(Claude Code / Cursor / Cline / MiniMax Code…)。
|
|
3
|
+
[](https://github.com/deepseek-ai/deepseek-harness)
|
|
5
4
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
> - 核心只用 Python 标准库;PDF 排版所需的 Typst、中文字体与 Typst 包由插件自带或首次使用时自动准备。
|
|
10
|
-
> - **非官方工具**:与浙江大学及其「智云课堂」平台无隶属关系,也未获其背书。
|
|
5
|
+
由 [`nzw806/zju-lecture-summerizer-`](https://github.com/nzw806/zju-lecture-summerizer-) 改编的 DeepSeek Harness 原生插件,提供开箱即用的体验。
|
|
6
|
+
面向 **DeepSeek Harness(dsh)**,以及任何兼容 **Agent Plugins 1.0** 的通用 agent 客户端。
|
|
7
|
+
<img width="2288" height="916" alt="image" src="https://github.com/user-attachments/assets/a7c62c79-bb7a-4770-9893-859f75692059" />
|
|
11
8
|
|
|
12
9
|
## 开始使用
|
|
13
10
|
|
|
@@ -23,16 +20,23 @@
|
|
|
23
20
|
/zju-lecture-summarizer-help 帮我解决当前无法使用的问题
|
|
24
21
|
```
|
|
25
22
|
|
|
23
|
+
> 把浙大智云课堂(`classroom.zju.edu.cn`)的课程回放,变成一份**能直接复习的讲义**:
|
|
24
|
+
> - Agent 生成结构化 Markdown ,并按内置排版器在本机排成易读的 PDF 讲义,单次总结成本约 ¥0.3,耗时约 1.5min 。
|
|
25
|
+
> - 字幕先匿名;401/403 时自动使用本机登录态重试一次。仍不可用时插件会打开独立登录窗口,你正常登录即可;登录态加密保存在系统凭据库(Windows DPAPI / macOS 钥匙串 / Linux 密钥环;没有可用凭据库时不落盘),不回显、不进入对话、不保存密码。
|
|
26
|
+
> - 核心只用 Python 标准库;PDF 排版所需的 Typst、中文字体与 Typst 包由插件自带或首次使用时自动准备。
|
|
27
|
+
> - **非官方工具**:与浙江大学及其「智云课堂」平台无隶属关系,也未获其背书。
|
|
28
|
+
|
|
26
29
|
## 功能特色
|
|
27
30
|
|
|
28
31
|
- **一句话出讲义**:给回放链接或 `sub_id`,Agent 抓字幕、写 Markdown、修公式、校验、命名,一次完成。
|
|
29
|
-
-
|
|
30
|
-
- **装完即用**:缺少 Typst 时首次排版自动准备(可关);中文字体与 Typst
|
|
31
|
-
- **自动 PDF
|
|
32
|
-
-
|
|
33
|
-
- **能动手复习**:可选「填空式学习笔记」——基于 Typst scholia 模板排版的填空式学习笔记;配色与段落规范由本项目定义。
|
|
32
|
+
- **便捷获取登录态**:缺登录态导致 401/403 时自动打开独立登录窗口,登录后保存在本机,无需额外使用开发者工具。
|
|
33
|
+
- **装完即用**:缺少 Typst 时首次排版自动准备(可关);中文字体与 Typst 包随插件分发,填空笔记离线也能编译。
|
|
34
|
+
- **自动 PDF**:使用内置脚本在本地排同名 PDF,无需额外 token 花销;PDF 失败不影响 Markdown 讲义。
|
|
35
|
+
- **填空式复习**:可选「填空式学习笔记」——基于 Typst scholia 模板排版的填空式学习笔记;配色与段落规范由本项目定义。
|
|
34
36
|
- **隐私优先**:常规工具不要求或读取 Cookie 参数,登录态不回显,Cookie/Bearer 输出脱敏;敏感文件拒绝;TLS 永不降级。当前版本仍有已知安全缺口,见 [SECURITY.md](SECURITY.md)。
|
|
35
|
-
|
|
37
|
+
|
|
38
|
+
PDF 渲染效果预览:
|
|
39
|
+
<img width="1098" height="1472" alt="image" src="https://github.com/user-attachments/assets/610d5f5d-5dd0-45bb-abfc-924e629132da" />
|
|
36
40
|
|
|
37
41
|
## 安装
|
|
38
42
|
|
|
@@ -60,9 +64,19 @@ dsh plugin --profile desktop add github:chenqianyu486-sys/dsh-zju-lecture-note
|
|
|
60
64
|
|
|
61
65
|
> 帮我把这节课整理成讲义:https://classroom.zju.edu.cn/livingroom?course_id=58133&sub_id=123456
|
|
62
66
|
|
|
63
|
-
### 2.
|
|
67
|
+
### 2. Agent Plugins 1.0(通用 agent 客户端)
|
|
68
|
+
|
|
69
|
+
仓库根本身就是一个合法的 Agent Plugins 1.0 包:根 `plugin.json` + 根 `mcp.json` + `skills/`。
|
|
70
|
+
把客户端的插件目录指向仓库根(或解包后的 npm 包目录),Skill 与 MCP Server 会被自动发现,
|
|
71
|
+
不用手工拼配置。依赖只有 PATH 上的 `node` 与 Python 3.9+。
|
|
64
72
|
|
|
65
|
-
|
|
73
|
+
- **输出路径**:通用客户端按标准以插件根为工作目录,相对文件名会写进安装目录。请给绝对输出路径,
|
|
74
|
+
或在根 `mcp.json` 的 `env` 里加 `ZJU_WORKSPACE` 指向你的工作目录。dsh 原生入口不受影响,
|
|
75
|
+
它按会话工作区传 `ZJU_WORKSPACE`。
|
|
76
|
+
- **可选模块**:投影截图、填空笔记、登录辅助工具与自动 PDF 默认关闭,改根 `mcp.json` 的 `env` 开启
|
|
77
|
+
(`ZJU_ENABLE_SLIDES` / `ZJU_ENABLE_STUDY_NOTES` / `ZJU_ENABLE_LOGIN_TOOLS` / `ZJU_RENDER_PDF`)。
|
|
78
|
+
字幕鉴权与 `zju_login` 不受这些开关影响。
|
|
79
|
+
- **只认裸 MCP 的宿主**:直接抄根 `mcp.json` 的 `mcpServers` 段,把 `./server.mjs` 换成绝对路径即可:
|
|
66
80
|
|
|
67
81
|
```json
|
|
68
82
|
{
|
|
@@ -77,16 +91,10 @@ dsh plugin --profile desktop add github:chenqianyu486-sys/dsh-zju-lecture-note
|
|
|
77
91
|
}
|
|
78
92
|
```
|
|
79
93
|
|
|
80
|
-
|
|
94
|
+
### 3. 维护者命令
|
|
81
95
|
|
|
82
96
|
```bash
|
|
83
|
-
|
|
84
|
-
```
|
|
85
|
-
|
|
86
|
-
### 3. 其它入口
|
|
87
|
-
|
|
88
|
-
```bash
|
|
89
|
-
# MiniMax Code 插件包
|
|
97
|
+
# 历史打包脚本的 staged 产物(通用客户端请走上面第 2 节)
|
|
90
98
|
python tools/build_plugin.py --install --zip
|
|
91
99
|
|
|
92
100
|
# 命令行
|
|
@@ -126,9 +134,17 @@ python -m zju_lecture.cli slides "<回放链接>" --download
|
|
|
126
134
|
|
|
127
135
|
### 投影截图(可选,默认关闭)
|
|
128
136
|
|
|
129
|
-
|
|
137
|
+
打开「抓取投影截图」后,可把课堂投影作为讲义的补充材料(需要浙大登录态)。
|
|
130
138
|
投影接口只返回截图,没有文字层或 OCR;需要幻灯片原文请提供原始 `.pptx`。
|
|
131
139
|
|
|
140
|
+
- **依据投影截图写讲义**:写讲义前抓取并下载一次投影,把幻灯片上的定义、公式、图例与例题
|
|
141
|
+
同字幕对照写进正文;模型看不到本地图片时不会臆造幻灯片文字,只在文末列出截图索引。
|
|
142
|
+
- **把截图引用进讲义**:只挑 3–8 张关键页插入 Markdown;不改变「投影是否作为内容来源」。
|
|
143
|
+
- 两个子开关都关闭时,写讲义前只调用一次清单接口核对页数,不下载、不插图。
|
|
144
|
+
|
|
145
|
+
「投影讲义」预设会把「抓取投影截图 + 依据投影截图写讲义 + 引用关键页」一起打开,
|
|
146
|
+
并保持填空笔记关闭,适合只要阅读版 PDF / Markdown 的课程。
|
|
147
|
+
|
|
132
148
|
## 设置
|
|
133
149
|
|
|
134
150
|
设置有两个入口,内容与配置完全一致:
|
|
@@ -136,19 +152,28 @@ python -m zju_lecture.cli slides "<回放链接>" --download
|
|
|
136
152
|
- **设置 → 左侧导航「浙大智云课堂讲义」**;
|
|
137
153
|
- **主界面左栏「智云讲义」**,点开在主区域显示同一页。
|
|
138
154
|
|
|
139
|
-
设置按「核心链路 → 阅读输出 →
|
|
140
|
-
|
|
155
|
+
设置按「核心链路 → 阅读输出 → 环境 → 主动回忆 → 课堂投影 → 登录辅助 → 高级」分组,
|
|
156
|
+
并提供四枚预设:**省 Token / 复习模式 / 投影讲义 / 全功能**。预设只是批量写入同一组开关:
|
|
157
|
+
点预设和手动把同样的开关拨到同样位置,行为与高亮完全一致;当前配置与某个预设完全吻合时,
|
|
158
|
+
该预设会高亮。
|
|
141
159
|
|
|
142
160
|
| 设置 | 作用 | 默认 |
|
|
143
161
|
| :--- | :--- | :--- |
|
|
144
162
|
| 自动排版 PDF 讲义 | 写完讲义后自动生成同名 PDF | 开 |
|
|
145
163
|
| 自动安装 Typst | 缺少排版引擎时自动准备(约 20 MB) | 开 |
|
|
164
|
+
| Typst 可执行文件 | 留空自动查找;填写绝对路径可固定版本 | 留空 |
|
|
165
|
+
| Typst 下载镜像 | 自动安装时的 GitHub 镜像前缀 | 留空 |
|
|
146
166
|
| 填空式学习笔记 | 额外提供填空笔记 PDF | 关 |
|
|
147
167
|
| 抓取 PPT 投影截图 | 获取课堂投影截图(需登录态) | 关 |
|
|
148
|
-
|
|
|
168
|
+
| 依据投影截图写讲义 | 把投影内容作为讲义来源,写前抓取并下载一次 | 关 |
|
|
169
|
+
| 把截图引用进讲义 | 只挑 3–8 张关键页插入,需先开启投影抓取 | 关 |
|
|
149
170
|
| 视频直链与登录态工具 | 额外的登录辅助工具;不影响字幕与一键登录 | 关 |
|
|
171
|
+
| Python 解释器 | 留空优先用 dsh 自带 Python;可指定绝对路径 | 留空 |
|
|
172
|
+
| 工具超时(毫秒) | 普通工具的超时;PDF / 登录等有更高下限 | 120000 |
|
|
173
|
+
| 注册随包 Skill | 关闭后不注册讲义工作流与用户命令,工具仍可用 | 开 |
|
|
150
174
|
|
|
151
|
-
|
|
175
|
+
保存后**立即生效**:插件会重新同步工具、Skill、系统提示词与 Python 子进程,Agent 在下一轮就能读到新配置,不需要重启。
|
|
176
|
+
只有首次安装或更新插件本身才需要完全重启 DeepSeek Harness。环境变量与开关分层见
|
|
152
177
|
[技术细节](docs/technical.md#3-工具与开关分层)。
|
|
153
178
|
|
|
154
179
|
## 常见问题
|
|
@@ -161,8 +186,13 @@ Markdown 已经正常写入,只是 PDF 没排出来。让 Agent 跑一次 `zju
|
|
|
161
186
|
缺少 Typst 时可让 Agent 安装,或打开设置里的「自动安装 Typst」。
|
|
162
187
|
|
|
163
188
|
**看不到投影或登录辅助工具?**
|
|
164
|
-
|
|
165
|
-
|
|
189
|
+
它们默认关闭,到设置里打开即可立即生效(Agent 下一轮会读到新工具);如果刚安装或更新过插件,
|
|
190
|
+
仍需完全重启 dsh。一键登录 `zju_login` 始终可用,字幕鉴权也不依赖登录辅助开关。
|
|
191
|
+
|
|
192
|
+
**打开了投影开关,Agent 还是不抓投影?**
|
|
193
|
+
只开「抓取投影截图」时,写讲义前只会调用一次清单接口核对页数,不下载、不读图;
|
|
194
|
+
要让它把投影写进讲义,请选「投影讲义」预设(会同时打开「依据投影截图写讲义」),
|
|
195
|
+
或手动打开这一项。保存后下一轮生效;刚更新过插件仍需完全重启 dsh。
|
|
166
196
|
|
|
167
197
|
**只解压 zip 启用报错?**
|
|
168
198
|
请用 npm 包名、`github:` 或 `file:` 方式安装,不要直接让 dsh 加载解压目录。
|
|
@@ -179,27 +209,28 @@ Markdown 已经正常写入,只是 PDF 没排出来。让 Agent 跑一次 `zju
|
|
|
179
209
|
|
|
180
210
|
## 隐私与安全
|
|
181
211
|
|
|
182
|
-
> **当前安全状态(2026-11-06
|
|
183
|
-
>
|
|
184
|
-
>
|
|
185
|
-
>
|
|
186
|
-
>
|
|
212
|
+
> **当前安全状态(2026-11-08)**:2026-11-06 安全审查发现的 9 项问题已全部修复,
|
|
213
|
+
> 包括多会话工作区隔离、截图重定向/SSRF、工作区外回写、镜像 URL 脱敏、隐私扫描器输出、
|
|
214
|
+
> POSIX 临时文件与备份权限、参数白名单、封面注入与资源上限。2.2.8 复核又把登录态改成
|
|
215
|
+
> 全平台加密存储(不再有任何明文落盘路径),并补齐扫描器的 `_token` 规则、PDF 原子写与
|
|
216
|
+
> typst 子进程环境收敛。逐条修复与边界见 [SECURITY.md](SECURITY.md) 第 7 / 9 / 10 节。
|
|
187
217
|
|
|
188
218
|
- **登录态不是正常工具参数**:字幕 / 投影 / 视频直链 / 读 Cookie 工具不要求 Cookie;
|
|
189
|
-
登录态只能由 `zju_login`、本地配置或本机 Edge
|
|
190
|
-
|
|
191
|
-
- **登录态落盘、不回显**:`zju_login` 只保存 Cookie
|
|
192
|
-
Windows
|
|
193
|
-
`
|
|
194
|
-
|
|
219
|
+
登录态只能由 `zju_login`、本地配置或本机 Edge 提供。工具调用入口会拒绝任何
|
|
220
|
+
未在 schema 中声明的字段,不要把凭据粘进工具调用。
|
|
221
|
+
- **登录态落盘、不回显**:`zju_login` 只保存 Cookie(不保存账号密码),并且只写平台凭据库——
|
|
222
|
+
Windows DPAPI、macOS 登录钥匙串、Linux 密钥环(Secret Service),都是静态加密;
|
|
223
|
+
没有可用凭据库时**不落盘**,只在本次进程内保留。2.2.7 及更早版本的明文 `session.bin`
|
|
224
|
+
会在升级后首次读取时迁移并删除。`zju_login(clear=true, confirm=true)` 会清除凭据项、
|
|
225
|
+
旧文件与独立浏览器配置。Cookie / Bearer 输出脱敏,镜像 URL 等诊断也会去掉 userinfo 与签名 query。
|
|
195
226
|
- **网络边界**:正常请求只到 `classroom.zju.edu.cn`、`https://*.zju.edu.cn` 截图主机
|
|
196
|
-
与 Typst 官方下载地址;课堂 API
|
|
197
|
-
|
|
227
|
+
与 Typst 官方下载地址;课堂 API 只允许同 origin 重定向。投影截图的每一跳都校验
|
|
228
|
+
浙大域、HTTPS 与私网地址,非浙大目标不跟随;证书校验不降级。
|
|
198
229
|
- **本地文件有边界**:课件 / 讲义工具只接受指定扩展名,拒绝凭据、私钥与浏览器数据;
|
|
199
|
-
`
|
|
200
|
-
|
|
230
|
+
所有回写(含 `fix=true` 与填空 `mode=patch`)都限制在工作区内;读取工作区外课件
|
|
231
|
+
必须显式传 `allow_outside_workspace=true`,且结果首行会标注。
|
|
201
232
|
|
|
202
|
-
|
|
233
|
+
完整威胁模型与边界见 [SECURITY.md](SECURITY.md)。
|
|
203
234
|
|
|
204
235
|
## 许可与致谢
|
|
205
236
|
|