dsh-zju-lecture-note 0.0.0-stage → 2.2.3
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 +164 -0
- package/CHANGELOG.md +341 -0
- package/LICENSE +26 -0
- package/README.md +297 -2
- package/SECURITY.md +133 -0
- package/cordis.patch.yml +3 -0
- package/docs/technical.md +551 -0
- package/icon.png +0 -0
- package/lib/bridge.js +343 -0
- package/lib/client.js +757 -0
- package/lib/index.js +607 -0
- package/lib/tools.js +301 -0
- package/lib/tools.schema.json +298 -0
- package/mcp_server.py +1838 -0
- package/package.json +90 -4
- package/skills/scholia-notes/LICENSE +21 -0
- package/skills/scholia-notes/README.md +62 -0
- package/skills/scholia-notes/SKILL.md +325 -0
- package/skills/scholia-notes/THIRD_PARTY_NOTICES.md +103 -0
- package/skills/scholia-notes/references/api.md +165 -0
- package/skills/scholia-notes/references/format-spec.md +284 -0
- package/skills/scholia-notes/references/mapping.md +51 -0
- package/skills/scholia-notes/references/prelude.typ +100 -0
- package/skills/scholia-notes/references/starter.typ +75 -0
- package/skills/scholia-notes/references/style.md +157 -0
- package/skills/scholia-notes/references/troubleshooting.md +134 -0
- package/skills/scholia-notes/references/typography-spec.md +340 -0
- package/skills/scholia-notes.manifest.json +80 -0
- package/skills/zju-lecture-summarizer/SKILL.md +324 -0
- package/skills/zju-lecture-summarizer/SLIDES.md +85 -0
- package/skills/zju-lecture-summarizer.manifest.json +20 -0
- package/zju_lecture/__init__.py +148 -0
- package/zju_lecture/cacert.pem +4508 -0
- package/zju_lecture/cli.py +292 -0
- package/zju_lecture/client.py +741 -0
- package/zju_lecture/cookies.py +616 -0
- package/zju_lecture/courseware.py +180 -0
- package/zju_lecture/deps.py +532 -0
- package/zju_lecture/fonts/FONT-NOTICE.md +40 -0
- package/zju_lecture/fonts/NotesKaiSC-Subset.ttf +0 -0
- package/zju_lecture/fonts/NotesSerifSC-Subset.ttf +0 -0
- package/zju_lecture/fonts/OFL-Kai.txt +94 -0
- package/zju_lecture/fonts/OFL.txt +94 -0
- package/zju_lecture/formatter.py +319 -0
- package/zju_lecture/handout.py +1350 -0
- package/zju_lecture/handout_prelude.typ +345 -0
- package/zju_lecture/note_lint.py +726 -0
- package/zju_lecture/paths.py +304 -0
- package/zju_lecture/prelude.typ +100 -0
- package/zju_lecture/security.py +278 -0
- package/zju_lecture/slides.py +597 -0
- package/zju_lecture/study_notes.py +2120 -0
- package/zju_lecture/typst-packages/VENDORED.md +40 -0
- package/zju_lecture/typst-packages/preview/frame-it/2.0.0/LICENSE +21 -0
- package/zju_lecture/typst-packages/preview/frame-it/2.0.0/src/inspect.typ +35 -0
- package/zju_lecture/typst-packages/preview/frame-it/2.0.0/src/layout.typ +108 -0
- package/zju_lecture/typst-packages/preview/frame-it/2.0.0/src/lib.typ +45 -0
- package/zju_lecture/typst-packages/preview/frame-it/2.0.0/src/parse.typ +54 -0
- package/zju_lecture/typst-packages/preview/frame-it/2.0.0/src/styles/boxy.typ +214 -0
- package/zju_lecture/typst-packages/preview/frame-it/2.0.0/src/styles/hint.typ +101 -0
- package/zju_lecture/typst-packages/preview/frame-it/2.0.0/src/styles/thmbox.typ +152 -0
- package/zju_lecture/typst-packages/preview/frame-it/2.0.0/src/styling.typ +15 -0
- package/zju_lecture/typst-packages/preview/frame-it/2.0.0/src/utils/encode.typ +30 -0
- package/zju_lecture/typst-packages/preview/frame-it/2.0.0/src/utils/html.typ +82 -0
- package/zju_lecture/typst-packages/preview/frame-it/2.0.0/src/utils/text-queries.typ +25 -0
- package/zju_lecture/typst-packages/preview/frame-it/2.0.0/typst.toml +10 -0
- package/zju_lecture/typst-packages/preview/marginalia/0.3.1/UNLICENSE +24 -0
- package/zju_lecture/typst-packages/preview/marginalia/0.3.1/lib.typ +1294 -0
- package/zju_lecture/typst-packages/preview/marginalia/0.3.1/typst.toml +22 -0
- package/zju_lecture/typst-packages/preview/noteworthy/0.4.0/LICENSE +21 -0
- package/zju_lecture/typst-packages/preview/noteworthy/0.4.0/lib.typ +128 -0
- package/zju_lecture/typst-packages/preview/noteworthy/0.4.0/typst.toml +15 -0
- package/zju_lecture/typst-packages/preview/scholia/0.1.0/LICENSE +21 -0
- package/zju_lecture/typst-packages/preview/scholia/0.1.0/src/colors.typ +44 -0
- package/zju_lecture/typst-packages/preview/scholia/0.1.0/src/fonts.typ +35 -0
- package/zju_lecture/typst-packages/preview/scholia/0.1.0/src/lib.typ +181 -0
- package/zju_lecture/typst-packages/preview/scholia/0.1.0/src/theorems.typ +92 -0
- package/zju_lecture/typst-packages/preview/scholia/0.1.0/src/visual.typ +17 -0
- package/zju_lecture/typst-packages/preview/scholia/0.1.0/typst.toml +18 -0
- package/zju_lecture/typst-packages/preview/showybox/2.0.4/LICENSE +21 -0
- package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/func.typ +143 -0
- package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/id.typ +12 -0
- package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/pre-rendering.typ +50 -0
- package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/sections.typ +142 -0
- package/zju_lecture/typst-packages/preview/showybox/2.0.4/lib/shadows.typ +118 -0
- package/zju_lecture/typst-packages/preview/showybox/2.0.4/showy.typ +268 -0
- package/zju_lecture/typst-packages/preview/showybox/2.0.4/typst.toml +12 -0
- package/zju_lecture/typst-packages/preview/theoretic/0.3.1/UNLICENSE +24 -0
- package/zju_lecture/typst-packages/preview/theoretic/0.3.1/lib.typ +3 -0
- package/zju_lecture/typst-packages/preview/theoretic/0.3.1/src/base.typ +1198 -0
- package/zju_lecture/typst-packages/preview/theoretic/0.3.1/src/presets.typ +6 -0
- package/zju_lecture/typst-packages/preview/theoretic/0.3.1/src/styles/bar.typ +102 -0
- package/zju_lecture/typst-packages/preview/theoretic/0.3.1/src/styles/basic.typ +33 -0
- package/zju_lecture/typst-packages/preview/theoretic/0.3.1/src/styles/colorbox.typ +142 -0
- package/zju_lecture/typst-packages/preview/theoretic/0.3.1/src/styles/columns.typ +100 -0
- package/zju_lecture/typst-packages/preview/theoretic/0.3.1/src/styles/corners.typ +71 -0
- package/zju_lecture/typst-packages/preview/theoretic/0.3.1/src/styles/fancy.typ +197 -0
- package/zju_lecture/typst-packages/preview/theoretic/0.3.1/typst.toml +13 -0
- package/zju_lecture/typst_assets.json +43 -0
package/ATTRIBUTION.md
ADDED
|
@@ -0,0 +1,164 @@
|
|
|
1
|
+
# Attribution
|
|
2
|
+
|
|
3
|
+
本插件(ZJU Lecture Agent Plugin / `zju-lecture`)改编自开源项目
|
|
4
|
+
[`nzw806/zju-lecture-summerizer-`](https://github.com/nzw806/zju-lecture-summerizer-),
|
|
5
|
+
遵循其 MIT 许可证。原项目的版权声明与许可条款完整保留在仓库根目录的
|
|
6
|
+
[`LICENSE`](LICENSE) 中。
|
|
7
|
+
|
|
8
|
+
## 复用自上游的部分
|
|
9
|
+
|
|
10
|
+
| 文件 | 来源 | 说明 |
|
|
11
|
+
| :--- | :--- | :--- |
|
|
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`。 |
|
|
14
|
+
| `zju_lecture/formatter.py` | 上游 `pipeline.py` 的格式化逻辑 | 按分钟聚合、按字符数分块、时间戳格式化。 |
|
|
15
|
+
| `zju_lecture/courseware.py` | 上游 `pipeline.py` 的课件提取逻辑 | PPTX / DOCX / TXT / MD / PDF 纯标准库文本提取。 |
|
|
16
|
+
| `skills/zju-lecture-summarizer/SKILL.md` | 上游 README 与总结提示词 | 五段式讲义模板(速览表 / 分章详解 / 公式清单 / 考试信息 / 考点预测)、降噪规则、LaTeX 公式规范。 |
|
|
17
|
+
|
|
18
|
+
## 本插件新增的部分
|
|
19
|
+
|
|
20
|
+
- 标准 MCP stdio 服务器(JSON-RPC 2.0)与 10 个工具定义(dsh 默认按开关注册 6 个);
|
|
21
|
+
- `server.mjs` 启动器:运行时解析 Python 解释器,跨平台统一用 `node` 启动;
|
|
22
|
+
- Skill 化的工作流 SOP;
|
|
23
|
+
- 协议级回归测试、FIPS-197 AES 已知向量测试、Edge Cookie 失败原因分类;
|
|
24
|
+
- MiniMax Code(MCode)插件包形态(`.minimax-plugin/plugin.json` + `zju-lecture.mcp.json`);
|
|
25
|
+
- DeepSeek Harness(dsh)原生插件形态(本仓库根目录的 `package.json` + `cordis.patch.yml` + `lib/`,
|
|
26
|
+
npm 包名 `dsh-zju-lecture-note`,与 MCP 形态共用同一份 Python 核心);
|
|
27
|
+
- 隐私加固:Cookie 不进工具参数/返回值、全输出 redaction、Edge 数据库只读优先与安全清理、
|
|
28
|
+
TLS 校验不降级、同域重定向限制、本地文件敏感路径拒绝、`tools/privacy_scan.py` 发布闸门。
|
|
29
|
+
设计说明见 [`SECURITY.md`](SECURITY.md)。
|
|
30
|
+
|
|
31
|
+
## 参考实现(未拷贝代码)
|
|
32
|
+
|
|
33
|
+
v1.5.0 的智云投影 PPT 管线与「讲义插图」开关参考了以下项目的公开实现思路,
|
|
34
|
+
代码按本仓库的纯标准库与安全边界重新实现,未拷贝其代码:
|
|
35
|
+
|
|
36
|
+
| 项目 | 许可 | 参考点 |
|
|
37
|
+
| :--- | :--- | :--- |
|
|
38
|
+
| [`8eoyw/zju-learning-cli`](https://github.com/8eoyw/zju-learning-cli) | MIT | 从会话 Cookie 的 PHP 序列化值中解析 `_token` 并作为 `Authorization: Bearer`;`search-ppt` 的 `course_id` + `page/per_page` 分页与按 URL 去重;截图合成 PDF;ZJU `http://` 升级 HTTPS;按堂次组织 PPT 输出的思路。 |
|
|
39
|
+
| [`PeiPei233/zju-learning-assistant`](https://github.com/PeiPei233/zju-learning-assistant) | MIT | 智云课堂 / 学在浙大 API 流程的原始来源;本插件与 `zju-learning-cli` 的共同上游,其桌面端实现是很多边界问题的第一手参考。 |
|
|
40
|
+
| [`eWloYW8/ZJU-course-material-download`](https://github.com/eWloYW8/ZJU-course-material-download) | MIT | 课件/附件下载思路的上游参考(经 `zju-learning-cli` 致谢链)。本插件目前未使用其下载端点。 |
|
|
41
|
+
| [`Kcalb35/Tronclass-pdf-downloaderforChrome`](https://github.com/Kcalb35/Tronclass-pdf-downloaderforChrome) / [`fish-can/TronClass-PDF-Downloader`](https://github.com/fish-can/TronClass-PDF-Downloader) | 见各自仓库 | 预览器转 PDF 思路的上游参考(经 `zju-learning-cli` 致谢链)。本插件目前未使用该端点。 |
|
|
42
|
+
| [`xzzd-pro/xzzd-pro`](https://github.com/xzzd-pro/xzzd-pro) | 见项目仓库 | 关闭下载时的端点处理思路(经 `zju-learning-cli` 致谢链)。本插件目前未使用。 |
|
|
43
|
+
|
|
44
|
+
本仓库只实现了**连续字节完全相同**的截图折叠;`zju-learning-cli` 基于 numpy/Pillow 的
|
|
45
|
+
“笔画是否仍存在于后续页面”近似去重没有移植——那会打破本插件零第三方依赖的约束。
|
|
46
|
+
|
|
47
|
+
## 特别感谢
|
|
48
|
+
|
|
49
|
+
- [`nzw806/zju-lecture-summerizer-`](https://github.com/nzw806/zju-lecture-summerizer-):最初的抓取框架与讲义模板,本插件的起点。
|
|
50
|
+
- [`PeiPei233/zju-learning-assistant`](https://github.com/PeiPei233/zju-learning-assistant):把智云课堂 API 流程完整跑通的桌面端实现。
|
|
51
|
+
- [`8eoyw/zju-learning-cli`](https://github.com/8eoyw/zju-learning-cli):把 PPT 鉴权、分页与 PDF 合成写成可脚本化 CLI,直接启发了本插件 v1.5.0 的修复。
|
|
52
|
+
- [`Typst`](https://typst.app)(Apache-2.0):阅读版讲义与填空笔记两条 PDF 链路的排版编译器。
|
|
53
|
+
- [`@preview/scholia`](https://typst.app/universe/package/scholia)(MIT © Eric Yang):填空笔记的排版引擎;阅读版讲义模板在视觉上参考其浅色 notes 主题。详见下方 v1.6.0 / v2.0.1 两节。
|
|
54
|
+
- [`certifi`](https://github.com/certifi/python-certifi) 与 [Mozilla CA Certificate Program](https://www.mozilla.org/en-US/about/governance/policies/security-group/certs/):随包 CA 信任库。
|
|
55
|
+
- 所有为本插件提交 issue、做实地运行反馈、审查代码与文档的同学:真实课堂里的复现步骤和原始输出,是这些修复能落地的原因。
|
|
56
|
+
|
|
57
|
+
> 上述参考项目的版权归各自作者所有;若后续需要拷贝其中任何代码,将按其 MIT 许可证保留版权声明与许可文本。
|
|
58
|
+
|
|
59
|
+
## v2.0.1 新增:讲义阅读版 PDF(`zju_lecture/handout.py`)
|
|
60
|
+
|
|
61
|
+
`zju_lecture/handout.py` 与 `zju_lecture/handout_prelude.typ` 是本项目原创的
|
|
62
|
+
Markdown → Typst 直排模板,**不 import 任何 Typst Universe 包**,也不拷贝上游模板代码。
|
|
63
|
+
它只依赖 Typst 可执行文件与系统字体;封面、目录、标题、表格、代码、引用等样式由本项目实现。
|
|
64
|
+
许可随本仓库 MIT。
|
|
65
|
+
|
|
66
|
+
> 讲义阅读版 PDF 与填空笔记 PDF 是两条不同的链路;后者才使用下面的
|
|
67
|
+
> `@preview/scholia`,且只在 `enableStudyNotes` 打开时注册。
|
|
68
|
+
>
|
|
69
|
+
> v2.0.2 起,阅读版 PDF 的配色与装置语义(蓝/青绿/琥珀、note / knot / proof / 边注)
|
|
70
|
+
> 与 scholia 保持一致,作为两条链路统一的视觉规范;实现仍是本项目自己的 Typst
|
|
71
|
+
> 模板(`handout_prelude.typ`),**未拷贝上游源码**。
|
|
72
|
+
>
|
|
73
|
+
> 这里的「参考 scholia」指**视觉与信息结构**:浅色 notes 主题的配色角色
|
|
74
|
+
> (`thm` / `def` / `eg` / `warn` / `muted`)、命题—证明—边注的装置语义、
|
|
75
|
+
> 右侧 Tufte 边注与三线表。模板代码由本项目独立编写,不 import 上游包,
|
|
76
|
+
> 也不复制其 `src/`;色值本身(`soft-palette`)是本项目自定义的(见文末「配色方面」)。
|
|
77
|
+
|
|
78
|
+
## v1.6.0 新增:填空式学习笔记链路(`skills/scholia-notes/`)
|
|
79
|
+
|
|
80
|
+
**口径**:填空式学习笔记是**基于 Typst scholia 模板排版**的产物;配色与段落规范由本项目定义,
|
|
81
|
+
见 scholia-notes 规范(`skills/scholia-notes/references/typography-spec.md`)。
|
|
82
|
+
上游包的版权归其作者所有;本项目与上游作者无隶属关系、未获背书。
|
|
83
|
+
|
|
84
|
+
| 项目 | 许可 | 版权人 | 说明 |
|
|
85
|
+
| :--- | :--- | :--- | :--- |
|
|
86
|
+
| [`@preview/scholia`](https://typst.app/universe/package/scholia) | MIT | [Eric Yang](https://github.com/Eryc123Y)(杨星宇) | 基于 Typst scholia 模板排版的填空式学习笔记的排版引擎(knot / note / 右边栏 / 封面)。**v2.1.0 起随本仓库分发(vendored)**:`zju_lecture/typst-packages/preview/scholia/0.1.0/`,保留 `LICENSE` 与 `typst.toml`;删除文档,并对 `src/fonts.typ` / `src/lib.typ` 打补丁(见 `VENDORED.md`)。 |
|
|
87
|
+
| [`@preview/frame-it`](https://typst.app/universe/package/frame-it) | MIT | Marc Thieme | scholia 的 knot 底层(figure + 原生 label 交叉引用)。随仓库分发,保留 `LICENSE`。 |
|
|
88
|
+
| [`@preview/marginalia`](https://typst.app/universe/package/marginalia) | UNLICENSE | 公有领域 | scholia 的右边栏边注。随仓库分发,保留 `UNLICENSE`。 |
|
|
89
|
+
| [`@preview/theoretic`](https://typst.app/universe/package/theoretic) | UNLICENSE | 公有领域 | noteworthy 的定理底层;随仓库分发,保留 `UNLICENSE`。 |
|
|
90
|
+
| [`@preview/showybox`](https://typst.app/universe/package/showybox) | MIT | Pablo González Calderón | noteworthy 的方框底层;随仓库分发,保留 `LICENSE`。 |
|
|
91
|
+
| [`@preview/noteworthy`](https://typst.app/universe/package/noteworthy) | MIT | Tarun Kumar Jana | scholia 的证明/注记底层;随仓库分发,保留 `LICENSE`。 |
|
|
92
|
+
| [`loom-notes`](https://github.com/Polaris-Aeterna/loom-notes) | MIT | 北极甜虾(Polaris) | 上游 `scholia` 作者声明其实现是受该项目**设计启发**的独立重写,未复用其源码;本仓库亦未分发其代码。 |
|
|
93
|
+
|
|
94
|
+
> **v2.1.0 起,6 个 `@preview` 包已 vendor 进 `zju_lecture/typst-packages/`**,用于离线编译。
|
|
95
|
+
> MIT 的「保留版权声明与许可全文」义务由此触发,已逐包保留 `LICENSE`;Unlicense 包保留 `UNLICENSE`。
|
|
96
|
+
> 删除范围是文档(README / template / tests);另外 `@preview/scholia` 的
|
|
97
|
+
> `src/fonts.typ` / `src/lib.typ` 由本项目打了补丁(字体表改为可再分发栈、
|
|
98
|
+
> 二/三级标题字号统一、边注段距补 0.4em),补丁在
|
|
99
|
+
> `tools/vendor_typst_packages.py` 里可重放,逐条记录见
|
|
100
|
+
> `zju_lecture/typst-packages/VENDORED.md`。
|
|
101
|
+
|
|
102
|
+
**随包中文字体**(v2.1.0 起 Serif,v2.2.0 起 Kai):
|
|
103
|
+
|
|
104
|
+
| 项目 | 许可 | 版权人 | 说明 |
|
|
105
|
+
| :--- | :--- | :--- | :--- |
|
|
106
|
+
| Noto Serif SC → `Notes Serif SC` | SIL OFL 1.1 | Copyright 2012 Google Inc.;字体内部 © 2017-2023 Adobe | GB2312 + 常用符号子集(约 7.5k 字),保留 `wght` 变量轴。已改名以避免与本机完整字体冲突;`zju_lecture/fonts/OFL.txt` 与 `FONT-NOTICE.md` 必须随包分发。 |
|
|
107
|
+
| LXGW WenKai(霞鹜文楷)→ `Notes Kai SC` | SIL OFL 1.1 | Copyright 2021-2026 LXGW;上游还包含 Copyright 2020 The Klee Project Authors | GB2312 子集(约 3.6 MB),**上游有 Reserved Font Name,因此必须改名**;`zju_lecture/fonts/OFL-Kai.txt` 与 `FONT-NOTICE.md` 必须随包分发。 |
|
|
108
|
+
|
|
109
|
+
**Typst 二进制**(不随仓库分发):
|
|
110
|
+
|
|
111
|
+
| 项目 | 许可 | 说明 |
|
|
112
|
+
| :--- | :--- | :--- |
|
|
113
|
+
| [Typst](https://typst.app) 0.15.1 | Apache-2.0 | 插件不含二进制;缺少时从官方 GitHub Release 下载到用户缓存目录,按 `zju_lecture/typst_assets.json` 的 SHA256 校验。若将来改为随包/镜像分发,必须补 Apache-2.0 的 `LICENSE` 与 `NOTICE`,并带上其内嵌字体(Libertinus / New Computer Modern / DejaVu)的 OFL 声明。 |
|
|
114
|
+
|
|
115
|
+
本插件与 `@preview/scholia` 的作者**没有隶属关系,也未获其背书**;
|
|
116
|
+
「scholia」一词仅用于指代所依赖的 Typst 包(指示性使用),不主张任何商标权利。
|
|
117
|
+
|
|
118
|
+
`skills/scholia-notes/` 目录里的一切(工作流 SOP、淡彩 palette 与五个助手、
|
|
119
|
+
`api` / `mapping` / `style` / `troubleshooting` 文档)是本项目原创,以 MIT 发布,
|
|
120
|
+
见该目录下的 [`LICENSE`](skills/scholia-notes/LICENSE) 与
|
|
121
|
+
[`THIRD_PARTY_NOTICES.md`](skills/scholia-notes/THIRD_PARTY_NOTICES.md)。
|
|
122
|
+
|
|
123
|
+
`skills/scholia-notes/references/prelude.typ` 是**生成副本**,唯一权威副本是
|
|
124
|
+
`zju_lecture/prelude.typ`(随 Python 包分发,编译时写进项目目录);
|
|
125
|
+
`tools/sync_skill_assets.py` 同步两者,`tests/test_study_notes.py` 校验逐字节一致。
|
|
126
|
+
|
|
127
|
+
### 字体:影响产物的可再分发性
|
|
128
|
+
|
|
129
|
+
Typst 编译 PDF 时会内嵌并子集化用到的字体。上游 `scholia` 的 `default-fonts`
|
|
130
|
+
把 `Optima`、`Avenir Next`、`Menlo`、`Songti SC` 放在首选位 —— **商业专有字体**;
|
|
131
|
+
`STIX Two` 为 SIL OFL,`Libertinus Serif` / `New Computer Modern` / `DejaVu Sans Mono`
|
|
132
|
+
由 Typst 运行时内嵌。字体文件不随本仓库分发,但**会进入生成的 PDF**。
|
|
133
|
+
|
|
134
|
+
本仓库的处理:
|
|
135
|
+
|
|
136
|
+
- **阅读版讲义**(`handout_prelude.typ`,默认 PDF 链路)**默认就用可再分发的字体栈**:
|
|
137
|
+
`STIX Two Text` → Typst 内嵌的 `Libertinus Serif`,标题同理,mono 用
|
|
138
|
+
`DejaVu Sans Mono`,中文优先随包 `Notes Kai SC` / `Notes Serif SC`,再退
|
|
139
|
+
`Noto Serif SC` / `Source Han Serif SC`(皆 OFL)。默认产物不内嵌任何商业字体,
|
|
140
|
+
可以直接对外分享。想在本机还原上游观感,模板里留了一份注释掉的 local 字体栈 ——
|
|
141
|
+
那种 PDF 不要再分发。
|
|
142
|
+
- **填空笔记**的 vendored `scholia` 已 patch `src/fonts.typ` 的 `default-fonts`:
|
|
143
|
+
`note` / `sidenote` / `label-it` 不再直接读商业字体,而是跟随同一套可再分发栈;
|
|
144
|
+
补丁由 `tools/vendor_typst_packages.py` 重放,记录在 `VENDORED.md`。
|
|
145
|
+
`skills/scholia-notes/SKILL.md` 与 `references/troubleshooting.md` 给出了
|
|
146
|
+
`pdffonts` 核对方法。
|
|
147
|
+
|
|
148
|
+
配色方面:**浅色主题(`soft-palette`)是本项目自定义的**,色值由
|
|
149
|
+
`zju_lecture/prelude.typ` 定义、`tools/sync_palette.py` 同步到讲义模板与 Python 侧;
|
|
150
|
+
深色主题由上游 `scholia` 自带。配色不改变上述任何 MIT 归属。
|
|
151
|
+
|
|
152
|
+
## 第三方数据:随包 CA 证书库
|
|
153
|
+
| 文件 | 来源 | 许可 | 说明 |
|
|
154
|
+
| :--- | :--- | :--- | :--- |
|
|
155
|
+
| `zju_lecture/cacert.pem` | [`certifi`](https://github.com/certifi/python-certifi) 的 `cacert.pem`,其上游是 [Mozilla CA Certificate Program](https://www.mozilla.org/en-US/about/governance/policies/security-group/certs/) 根证书库 | Mozilla Public License 2.0 | 原样复制(仅在文件头追加来源注释),作为 `certifi` 缺失时的信任库兜底。dsh 自带的 Python 解释器不含 certifi,没有这份文件时在根证书不全的机器上会 `CERTIFICATE_VERIFY_FAILED`。刷新方式见 `tools/refresh_ca_bundle.py`。 |
|
|
156
|
+
|
|
157
|
+
> 该文件只包含**公开的根证书**,不含任何私钥、站点证书或个人信息;它不会关闭 TLS 校验,
|
|
158
|
+
> 只是把信任库从"用户碰巧装了什么"变成"随包可复现"。
|
|
159
|
+
|
|
160
|
+
## 声明
|
|
161
|
+
|
|
162
|
+
本项目仅供个人学习使用:抓取的是本人有权限访问的课程回放,频率极低。请遵守
|
|
163
|
+
浙江大学智云课堂的使用条款,不要用于批量抓取、传播课件或任何商业用途。
|
|
164
|
+
登录 Cookie 属于个人凭证,不要提交到任何仓库或发送给他人。
|
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,341 @@
|
|
|
1
|
+
# 更新日志
|
|
2
|
+
|
|
3
|
+
版本号在 `package.json`、`pyproject.toml`、`mcp_server.SERVER_VERSION`、
|
|
4
|
+
`.minimax-plugin/plugin.json` 与两个 Skill manifest 六处对齐。
|
|
5
|
+
|
|
6
|
+
## 2.2.3 — 2026-11-04
|
|
7
|
+
|
|
8
|
+
按又一次真实上课(`session-5415d8a5`,sub_id 1990907)里「工具没错、但 Agent 得替它
|
|
9
|
+
擦屁股」的地方收口。回归钉在 `tests/test_session_5415d8a5.py`。
|
|
10
|
+
|
|
11
|
+
- **`\qquad` / `\quad` 排成真间距**:以前映射成两个空格,Typst 会把空格折叠掉,
|
|
12
|
+
四条麦克斯韦方程挤成 `0∇×H` 这种像乘法的东西;Agent 只好自己写
|
|
13
|
+
`.tmp_split_display.py` 把 28 个公式块拆开、再重排两份 PDF。现在
|
|
14
|
+
`\qquad` → `wide`(2em)、`\quad` → `quad`(1em)、`\,` → `thin`、`\;` → `med`,
|
|
15
|
+
并保持转换幂等。
|
|
16
|
+
- **行内 `$1/r$` 不再顶高行距**:行内数学把 `/` 排成平排的 `slash`
|
|
17
|
+
(`1 slash r`),独占一行的 `$$…$$` 仍排上下分式。此前 Agent 手改 4 处成 `r^{-1}`。
|
|
18
|
+
- **含公式的行不再拥挤**:Typst 的行内数学盒子高度是固定值(11pt 下 ≈0.68em,
|
|
19
|
+
`measure($frac(1,2)$)` 与 `measure($x$)` 都是 7.51pt),分式的分子/分母、根式、
|
|
20
|
+
大算子的上下限会溢出盒子、压到邻行(实测重叠 1–4pt),`par.leading` 管不到。
|
|
21
|
+
现在两处显式留白:模板的 `#show math.equation.where(block: false)` 给每个行内
|
|
22
|
+
公式补上 `0.12em` / 下 `0.10em`;`pad_inline_math()` 再给分式/根式/矩阵/大算子
|
|
23
|
+
包一层 `#box(inset: (bottom: 0.30em))`。同一份讲义实测:行间 < 2pt 的行对
|
|
24
|
+
37 → 15,最差一处 −3.74pt(重叠)→ +1.19pt,纯文字行的行距一点没动。
|
|
25
|
+
数值进 `typography-spec.md` §3.2,两条链路由 `tests/test_typography_unified.py` 绑定。
|
|
26
|
+
- **引用块不再印出字面量 `>`**:Typst 没有 `>` 引用语法,旧实现把 `>` 原样写进
|
|
27
|
+
PDF,还把抬头三个字段粘成「时长:约 01:40:16 上课时间:未提供…」。现在两条链路
|
|
28
|
+
都渲染成左侧细线 + 灰色小字块,`**字段**:` 之间自动换行(`#quoted[…]`)。
|
|
29
|
+
- **`bare_imaginary_unit` 不再误报电流**:只有出现复数语境(`i^2`、`e^{iθ}`、
|
|
30
|
+
`\pm i`、复数 / 虚部 / 相量等用语)时才报;LC 回路里的 `i = -q_0ω_0 sin(…)`
|
|
31
|
+
不再逼 Agent 把物理量改成 `\mathrm{i}`。
|
|
32
|
+
- **方框预算按最小小节统计**:`## 二、分章详解` 下挂 7 个 `### 2.x` 时逐 `2.x` 计数,
|
|
33
|
+
不再把整章 9 个框算成「一节超预算」(Agent 为此纠结过一大段)。
|
|
34
|
+
- **新增 `zju_build_study_notes(mode="patch")`**:`edits=[{old, new}, …]` 一次写回
|
|
35
|
+
十几处挖空 / 标记,逐条报告命中与未命中;`old` 默认要求唯一命中(重复时加
|
|
36
|
+
`"all": true`)。此前 35 步里有 12 步是一条一条改底稿。
|
|
37
|
+
- 顺带收紧投影抓取的失败文案:`ZJU_COOKIE_FILE` 的建议不再在 5 行报错里出现两次。
|
|
38
|
+
- **列表序号之间留出呼吸**:`-` 与 `1.` 的相邻条目间距 0.3em → **0.7em**
|
|
39
|
+
(两条链路同一组参数,`list.spacing` / `list.indent` 进 `typography-spec.md`
|
|
40
|
+
的机器可读块);原来相邻条目几乎粘在一起。版式规范与实现由
|
|
41
|
+
`tests/test_typography_unified.py` 绑定。
|
|
42
|
+
|
|
43
|
+
## 2.2.2 — 2026-11-04
|
|
44
|
+
|
|
45
|
+
修一次真实上课(sub_id 1990907,大学物理·麦克斯韦方程组)里暴露的**多余手工操作**:
|
|
46
|
+
PDF 因两个没映射的 LaTeX 符号直接跳过,Agent 手改 Markdown;填空底稿的每节空占位
|
|
47
|
+
要删改近 20 次;`---` 被排成孤立「–」,Agent 写通配脚本清理时误伤旧讲义。
|
|
48
|
+
回归钉在 `tests/test_session_7402719b.py`。
|
|
49
|
+
|
|
50
|
+
- **补上 `\perp` / `\leftrightarrow` 等关系符号**:`zju_write_note` 首次排版返回
|
|
51
|
+
`PDF 跳过: error: unknown variable: leftrightarrow`,`note_lint` 还对 `\perp`
|
|
52
|
+
报「没有 Typst 对应写法」。现在两者都映射为 `⊥` / `↔`,并补齐常用双向箭头、
|
|
53
|
+
`\parallel`、`\nparallel`、`\hookrightarrow`、`\doteq` 等;`latex_unmapped`
|
|
54
|
+
自然消失。
|
|
55
|
+
- **斜杠分式归一化**:`\partial D/\partial t`、`\mathrm{d}i/\mathrm{d}t`、
|
|
56
|
+
`\sqrt{\mu_0/\varepsilon_0}` 在渲染层转成 `\frac{…}{…}`,不再需要 Agent
|
|
57
|
+
写脚本逐条替换;只处理明确的微分/根式,不动普通 `a/b`。
|
|
58
|
+
- **修 `bare_imaginary_unit` 误报**:`$L\frac{\mathrm{d}i}{\mathrm{d}t}$` 里的
|
|
59
|
+
`i` 是电流,不是虚数单位;负向后行断言把 `}` 也排除,不再逼 Agent 把电流改成
|
|
60
|
+
`\mathrm{i}`(那会把物理量改错)。
|
|
61
|
+
- **填空底稿不再逐节塞空占位**:`build_draft` 以前在每节插
|
|
62
|
+
`[直觉](用一句人话解释…)` / `[练习](留给读者自己重做的一题)` /
|
|
63
|
+
`[边注](一个主动回忆问题)`,实地会话为此花了近 20 次编辑。现在只保留原文,
|
|
64
|
+
文件头留一条 HTML 注释说明可选装置;加不加、加在哪儿由内容判断。
|
|
65
|
+
- **`---` 水平分隔线不再变成孤立「–」**:`render_typst` 现在把独占一行的
|
|
66
|
+
`---` 映射成 `#divider`(与 `[分隔]` 同款细线)。此前 Agent 只能写
|
|
67
|
+
`知识总结*.md` 通配脚本删分隔线,误伤了另外两份旧讲义;Skill 也补了
|
|
68
|
+
「不要用通配批量改讲义」。
|
|
69
|
+
- **小节标题后的间距加大**:一级标题下 8pt → 12pt,二级标题下 0.5em → 0.85em,
|
|
70
|
+
三级标题下 0.4/0.5em → 0.65em;两条 PDF 链路同步(改 vendored scholia 补丁)。
|
|
71
|
+
规范机器可读块新增 `heading.h{1,2,3}.above/below`,测试逐项比对。
|
|
72
|
+
- **新增主界面左栏入口**:`lib/client.js` 增加 `sidebar.panellist` 一行「智云讲义」
|
|
73
|
+
(`id: zju-lecture`,order 30,排在「插件」「自动化任务」之后),点开在**主区域**
|
|
74
|
+
渲染与「设置 → 浙大智云课堂讲义」完全相同的页面——同一个 `PipelineSettings`
|
|
75
|
+
控制器、同一份配置,设置弹窗里的那一栏保留。折叠态只显示 `currentColor` 的 SVG
|
|
76
|
+
图标,页首按 `--dsh-frame-top-clearance` 让出窗口标题栏。回归钉在
|
|
77
|
+
`tests/test_sidebar_entry_v222.py` 与 `tests/client_settings_smoke.mjs`。
|
|
78
|
+
- 版本 2.2.1 → 2.2.2(六处对齐,两个 Skill 清单重新生成)。**尚未发布**。
|
|
79
|
+
|
|
80
|
+
## 2.2.1 — 2026-11-04
|
|
81
|
+
|
|
82
|
+
修一次真实上课(sub_id 1990049,89 步)暴露的**自相矛盾**:工具和文档各说各话,
|
|
83
|
+
Agent 只好拿 50 步去猜;同批把方框标签的字体层次找回来。回归钉在
|
|
84
|
+
`tests/test_session_d0cfd0ac.py` 与 `tests/test_box_style_v221.py`。
|
|
85
|
+
|
|
86
|
+
- **底稿契约统一成「纯 Markdown + LaTeX」**:`zju_build_study_notes(mode=draft)`
|
|
87
|
+
以前会把公式改写成 Typst(`frac(…)` / `cal(…)`)、把表格写成 `#table(…)`、
|
|
88
|
+
把有序列表写成 `+`,而工具自己的提示、`SKILL.md`、`format-spec.md` 都说
|
|
89
|
+
「公式写 LaTeX,工具会转」——模型照着文档补 LaTeX,第二次转换就把已经转好的
|
|
90
|
+
`frac` / `cal` 逐字母拆成 `f r a c` / `c a l`,编译报 `unknown variable`。
|
|
91
|
+
现在 `draft` 只搬运结构,**转换只在 `compile` 做一次**。
|
|
92
|
+
- **LaTeX → Typst 转换变成幂等的**:`_plain_word` 认识转换器自己会产出的名字
|
|
93
|
+
(`frac` / `cal` / `sum` / `quad` / `cdots`…),引号串(`"Res"`、`"d"`)原样搬运。
|
|
94
|
+
以前 `latex_to_typst(latex_to_typst(x)) ≠ latex_to_typst(x)`,一次误转就毁一份公式。
|
|
95
|
+
- **补齐 Markdown 结构映射**:`render_typst` 新增 GFM 表格(→ `#table(…)`)、
|
|
96
|
+
无序/有序列表(→ Typst 列表)、`**粗体**`(→ `*粗体*`)三个分支。
|
|
97
|
+
此前表格只在 `draft` 转、`render_typst` 不认,底稿里的 `#table(` 会被当正文
|
|
98
|
+
转义成 `\[…\]`;`**` 会触发 `warning: no text within stars`,加粗失效。
|
|
99
|
+
- **行内代码不再转义**:`` `[00:20]` `` 曾变成 `` `\[00:20\]` `` 印在 PDF 里;
|
|
100
|
+
反引号在 Typst 是 raw,内容原样输出才对。
|
|
101
|
+
- **补上掉的数学符号**:`\triangleq`(Typst 没有这个符号,曾让整份 PDF 失败)→ `≙`;
|
|
102
|
+
`\not\to` / `\not=` 等前缀否定 → `↛` / `≠`(以前直接印成 "not →")。
|
|
103
|
+
- **「检查通过」和「PDF 能编译」不再打架**:`note_lint` 新增 `latex_unmapped` 规则,
|
|
104
|
+
命令表取自转换器自己的 `supported_latex_commands()`,行内与块级公式都查。
|
|
105
|
+
`zju_write_note` 返回 `PDF 跳过` 时多给一句可执行下一步(改完再
|
|
106
|
+
`zju_check_note(pdf=true)` 重排一次)。
|
|
107
|
+
- **填空笔记 PDF 落在底稿同目录**:以前只在 `*-typst/out.pdf`,Agent 每次得手动
|
|
108
|
+
`cp` 才交得出来;现在同时写 `<底稿名去掉 -填空底稿>.pdf`,工具直接返回该路径。
|
|
109
|
+
- **方框标签换成无衬线(两条链路一起)**:`Definition 1.1` / `Theorem 2.1` /
|
|
110
|
+
`Example` / `Your turn.` 原先用的是 `heading`(衬线 + 楷体),和正文糊在一起,
|
|
111
|
+
看不出「这是一个框」。现在标签走 `sans`:`Noto Sans` → `Liberation Sans` →
|
|
112
|
+
`DejaVu Sans`,中文仍回 `Notes Kai SC`。上游用 Optima(也是无衬线),这条是
|
|
113
|
+
把被字体补丁改丢的层次找回来。**没有**把 `Noto Sans SC` 放进栈里:本机那份是
|
|
114
|
+
可变字体,Typst 只取到 Thin(`pdffonts` 里是 `NotoSansSC-Thin`),中文会发灰。
|
|
115
|
+
- **「伪方框」检查**:`note_lint` 新增 `pseudo_box`。把例题/定理/证明写成
|
|
116
|
+
`#### 例 1:…` 或 `**证明(…)**` 时,PDF 里只会是小标题/粗体 —— 实测一份
|
|
117
|
+
3.5 万字的讲义因此整页没有一个框。现在检查器会点名,并给出 `[例] 标题 —— 正文`
|
|
118
|
+
的改法;讲义 Skill 与系统提示同步补了对照表。
|
|
119
|
+
- **填空笔记不再覆盖阅读版 PDF**:`<讲义名>-填空底稿.md` 编译出的 PDF 曾落到
|
|
120
|
+
`<讲义名>.pdf`,正好把刚排好的阅读版覆盖掉;现在自动底稿输出
|
|
121
|
+
`<讲义名>-填空.pdf`,手写底稿保持同名。
|
|
122
|
+
- 系统提示与 `SKILL.md` / `format-spec.md` / `docs/technical.md` 同步口径:
|
|
123
|
+
底稿只补占位符、不要重写全文,公式保持 LaTeX。
|
|
124
|
+
- 版本 2.2.0 → 2.2.1(六处对齐,两个 Skill 清单重新生成)。
|
|
125
|
+
|
|
126
|
+
## 2.2.0 — 2026-11-03
|
|
127
|
+
|
|
128
|
+
- **两条 PDF 链路统一到同一套排版**:阅读版讲义与填空笔记现在共用 30pt 封面标题 /
|
|
129
|
+
10pt kicker / 13pt 副标题 / 11pt 作者 / 9pt 日期、15 / 12.5 / 11.5pt 三级标题、
|
|
130
|
+
2.4 / 3.9 / 2.0 / 2.3cm 版心、2.6cm 边注栏(与版心间距 0.7cm)、
|
|
131
|
+
0.82em / 0.5em 边注;直觉块首行**不缩进**(按参考图口径),正文段首仍空两格。
|
|
132
|
+
实测两份 PDF 的正文左/右边界与边注左边界一致(误差 ≤ 2pt)。
|
|
133
|
+
- **随包 `Notes Kai SC`(OFL 楷体)**:`zju_lecture/fonts/NotesKaiSC-Subset.ttf`
|
|
134
|
+
是 LXGW WenKai(霞鹜文楷 v1.530)的 GB2312 子集,约 3.6MB;上游有 Reserved
|
|
135
|
+
Font Name,因此**改名**。两条链路的中文首选都是它,复现参考图的楷体观感,
|
|
136
|
+
且不再把 Windows 的 KaiTi 子集嵌进 PDF。`OFL-Kai.txt` 与 `FONT-NOTICE.md`
|
|
137
|
+
随包分发;`tools/build_font_subset.py` 现在可一次生成 Serif / Kai 两个子集。
|
|
138
|
+
- **vendored scholia 打补丁**:`src/fonts.typ` 的 `default-fonts` 改为可再分发栈
|
|
139
|
+
(移除 Optima / Avenir Next / Menlo / Songti SC),`src/lib.typ` 统一二级/三级
|
|
140
|
+
标题字号与边注段距。补丁在 `tools/vendor_typst_packages.py` 里可重放,
|
|
141
|
+
`VENDORED.md` 如实记录;`--check` 会验证补丁已生效。
|
|
142
|
+
- **规范去重**:重写 `skills/scholia-notes/references/typography-spec.md` 为
|
|
143
|
+
唯一排版真相源(含机器可读的 `typography-params` 块);`format-spec.md` /
|
|
144
|
+
`style.md` / `api.md` / `docs/technical.md` / `SKILL.md` 的数值改为指向它。
|
|
145
|
+
新增 `tests/test_typography_unified.py`(规范 ↔ 实现 ↔ 渲染几何 ↔ `pdffonts`),
|
|
146
|
+
`test_palette_sync.py` / `test_deps_v210.py` 扩展到 Kai 字体与 vendored 字体表。
|
|
147
|
+
- **文档口径**:填空式学习笔记统一表述为「基于 Typst scholia 模板排版的填空式学习笔记;
|
|
148
|
+
配色与段落规范由本项目定义,见 scholia-notes 规范」。README / ATTRIBUTION /
|
|
149
|
+
THIRD_PARTY_NOTICES / docs/technical / SKILL / typography-spec 已同步。
|
|
150
|
+
- 版本 2.1.1 → 2.2.0(六处对齐,两个 Skill 清单重新生成)。
|
|
151
|
+
|
|
152
|
+
## 2.1.1 — 2026-11-03
|
|
153
|
+
|
|
154
|
+
- **修复「设置全开还是只有字幕」的根因**:dsh 把 `.volatile()` 的 `Config` 字段投影成
|
|
155
|
+
实时引用(`{ get() }`),插件却直接拿它和 `true` 比较——引用永远不等于 `true`,于是
|
|
156
|
+
`enableSlides` / `enableStudyNotes` / `enableLoginTools` / `embedSlideImages` 无论用户
|
|
157
|
+
怎么保存都读成 `false`(`renderPdf` 因为写的是 `!== false` 反而一直是开)。新增
|
|
158
|
+
`readSetting()` 统一解包引用,`featureFlags()`、`timeoutMs`、`python`、`registerSkill`
|
|
159
|
+
都走它;`tests/plugin_apply_smoke.mjs` 增加「ref 形状」用例,防止再退回。
|
|
160
|
+
- **讲义默认按「复习版」写**:系统提示与 Skill 不再把增强内容写成「可选/需要时」——
|
|
161
|
+
例题按「题目 → 切入点 → 关键步骤 → 易错点」整理(本节没有就写「本节无例题」,
|
|
162
|
+
不编题),文末给 3–5 道自测题(答案折叠)与 5–10 条考点预测。
|
|
163
|
+
- **开关打开即默认执行**:`enableSlides` → 写讲义前抓一次投影并挑 3–8 页;
|
|
164
|
+
`enableStudyNotes` → 写完讲义再出填空版。MCP 的 `initialize.instructions` 同步。
|
|
165
|
+
- **设置页口径改成真话**:保存只对新建会话生效,当前会话的工具集在开始时已固定;
|
|
166
|
+
工具数标签从「本次会话注册」改为「当前配置注册」。
|
|
167
|
+
- 版本 2.1.0 → 2.1.1(六处对齐,两个 Skill 清单重新生成)。
|
|
168
|
+
|
|
169
|
+
## 2.1.0 — 2026-11-03
|
|
170
|
+
|
|
171
|
+
- **PDF 装完即用(Typst 自举)**:新增 `zju_lecture/deps.py`,把「本机没装 Typst」从静默的
|
|
172
|
+
`PDF 跳过` 变成一次可解释的准备:`ZJU_TYPST_BIN` → 插件缓存 → `PATH` → 常见目录;版本低于
|
|
173
|
+
0.13.0 提示升级;缺失时按平台从 **GitHub 官方 Release** 下载,只信任
|
|
174
|
+
`zju_lecture/typst_assets.json` 里钉死的 SHA256(6 个平台,`tools/pin_typst_assets.py` 生成),
|
|
175
|
+
解压后再用 `typst --version` 复核。下载失败写 6 小时冷却标记,避免每份讲义都卡一次超时。
|
|
176
|
+
开关 `typstAutoInstall` / `ZJU_TYPST_AUTO_INSTALL`(默认开),镜像前缀 `ZJU_TYPST_MIRROR`。
|
|
177
|
+
- **随包中文字体**:`zju_lecture/fonts/NotesSerifSC-Subset.ttf` —— Noto Serif SC 的
|
|
178
|
+
GB2312 + 常用符号子集(约 7.5k 字,5.7 MB,保留 `wght` 变量轴),**改名为 `Notes Serif SC`**
|
|
179
|
+
以免与本机完整字体重名。两条 PDF 链路都把它排在中文首位,干净 Windows 上标题也有真正的粗体。
|
|
180
|
+
随附 `OFL.txt` 与 `FONT-NOTICE.md`(OFL 1.1 要求随字体分发)。`tools/build_font_subset.py`
|
|
181
|
+
从 Google Fonts 固定 URL 取源字体并按 SHA256 校验,产物可复现。
|
|
182
|
+
- **Typst 包 vendor(离线编译)**:`zju_lecture/typst-packages/` 收录 scholia / frame-it /
|
|
183
|
+
marginalia / theoretic / showybox / noteworthy 六个包(约 257 KB),编译统一带
|
|
184
|
+
`--package-path` 与工作区内的 `--package-cache-path`,填空笔记首次编译不再访问 Typst 包注册表。
|
|
185
|
+
**逐包保留 `LICENSE` / `UNLICENSE` 与 `typst.toml`**,只删除 README 与模板示例;
|
|
186
|
+
`tools/vendor_typst_packages.py` 可重建,`VENDORED.md` 记录版本与许可。
|
|
187
|
+
- **新工具 `zju_doctor`**(第 10 个,始终常驻):报告 Python / Typst(版本 / 路径 / 来源)/
|
|
188
|
+
随包字体 / Typst 包 / 缓存 / 自动安装开关;`install=true` 立即下载安装。默认工具数 5 → 6,
|
|
189
|
+
全开 9 → 10。
|
|
190
|
+
- **设置页新增「环境与依赖」**:`typstAutoInstall` 开关 + 依赖说明;PDF 提示不再说「需要本机装 Typst」。
|
|
191
|
+
- **打包**:npm `files`、`pyproject` package-data、`tools/build_plugin.py` 都纳入字体、vendored 包与
|
|
192
|
+
资产清单;MCode 包的收集逻辑从「只收 `.py` / `.pem`」改为递归收 `.typ` / `.toml` / `.ttf` /
|
|
193
|
+
`LICENSE` 等,修掉此前 MCode 包缺 `prelude.typ` 的隐患。
|
|
194
|
+
- **文档口径修正(合规)**:`README` / `ATTRIBUTION` / `docs/technical.md` /
|
|
195
|
+
`THIRD_PARTY_NOTICES.md` / 市场条目中「编译期拉取、未随仓库分发、No upstream code is copied」
|
|
196
|
+
等表述改为「已 vendor 并附许可」;补「非官方工具,与浙大无隶属关系」声明;补 Typst 二进制的
|
|
197
|
+
Apache-2.0 边界(不随包分发,若将来转分发需补 LICENSE / NOTICE 与内嵌字体许可)。
|
|
198
|
+
- **测试**:新增 `tests/test_deps_v210.py`(清单 / 校验和 / 平台映射 / 恶意归档 / 字体改名 /
|
|
199
|
+
vendor 许可 / doctor / 离线编译 / 打包清单)。
|
|
200
|
+
- **npm 发布**:`package.json` 增 `prepublishOnly`(全量测试 + 隐私扫描,测试红了发不出去);
|
|
201
|
+
README 把 npm 安装写成首选、GitHub 仓库安装降为备选;`docs/technical.md` §10 补齐发布顺序
|
|
202
|
+
(pack → 扫 tarball → publish --dry-run → publish);README 行数闸门从 260 行放宽到 300 行。
|
|
203
|
+
|
|
204
|
+
## 2.0.2 — 2026-11-03
|
|
205
|
+
|
|
206
|
+
- **阅读版讲义 PDF 按参考图重做**:一级标题是「灰蓝编号 + 蓝色标题 + 细横线」;
|
|
207
|
+
直觉 / 定义 / 定理 / 例 / 练习用淡彩底 + 左侧竖线的方框;证明以斜体 `Proof.` + 行末 qed 结束;
|
|
208
|
+
边注进右侧留白栏;表格改三线表;封面、目录、代码块重排。配色与 scholia 填空笔记同一套
|
|
209
|
+
(蓝 = 结论、青绿 = 定义、琥珀 = 例子 / 练习、灰 = 次要)。
|
|
210
|
+
- **版心**:左 2.4cm / 右 3.9cm,右侧 2.6cm 是边注栏;封面与目录不占页码,正文第一页从 1 起。
|
|
211
|
+
- **标记语法**:普通讲义也能用 `[直觉]`、`[定理] 标题 —— 正文`、`[定义]`、`[例]`、
|
|
212
|
+
`[证明]`、`[练习]`(3 行书写位)、`[边注]` / `[边注!]`、`[强调]` / `[易错]` / `[弱注]`、
|
|
213
|
+
`[分隔]`、`____`、`[缺口: …]`、`<def:x>` + `@def:x` 回指。语义、预算与数学写法由
|
|
214
|
+
`format-spec.md` 统一规定,填空笔记与阅读版讲义两条链路共用。
|
|
215
|
+
- **数学环境**:`pmatrix` / `bmatrix` / `cases` / `aligned` 会机械转成 Typst 的
|
|
216
|
+
`mat` / `cases` / 对齐换行;多字母标识符(`AC`、`e^{-st}`、`BVP`)不再让 PDF 编译失败。
|
|
217
|
+
- **配色单一来源**:浅色 soft-palette 只定义在 `zju_lecture/prelude.typ`;
|
|
218
|
+
`handout_prelude.typ` 与 `handout._PALETTE` 是它的生成副本,
|
|
219
|
+
`python tools/sync_palette.py` 同步、`--check` 在测试里守住三处一致。
|
|
220
|
+
- **字体默认可分发**:讲义模板首选 STIX Two(SIL OFL),退到 Typst 内嵌的 Libertinus /
|
|
221
|
+
New Computer Modern / DejaVu;中文优先 Noto Serif SC / Source Han Serif SC。
|
|
222
|
+
商业专有字体(Optima / Avenir Next / Menlo / Songti SC)降为注释里的「本机原味」选项。
|
|
223
|
+
- **文档重构**:README 只保留安装与使用,技术细节移到 `docs/technical.md`,版本历史移到本文件。
|
|
224
|
+
插件市场条目补齐上游 PDF 模板 `@preview/scholia` 的署名与「未拷贝源码 / 未获背书」说明。
|
|
225
|
+
- **测试**:`tests/test_handout_v202.py` 覆盖标题编号剥离、全部标记装置、回指、方框预算、
|
|
226
|
+
模板自包含、数学环境与真实编译;`tests/test_palette_sync.py` 覆盖配色一致与字体可再分发性。
|
|
227
|
+
- **行内代码不再被自动修复改写**(感谢 [@RTXwcz](https://github.com/RTXwcz) 提交
|
|
228
|
+
[#2](https://github.com/chenqianyu486-sys/dsh-zju-lecture-note/pull/2)):
|
|
229
|
+
`_apply_outside_code` 改为按反引号 run 长度配对 —— 用两个或更多反引号包住的
|
|
230
|
+
`\frac12` 保持原样(旧实现逐字符切换状态,双反引号跨度会被误改);
|
|
231
|
+
代码跨度保护下沉到 `_normalize_math` 内部,所有调用方一致。代理报错在未设置代理时
|
|
232
|
+
点名 `HTTPS_PROXY` / `HTTP_PROXY`,不再输出 `((未设置))`。
|
|
233
|
+
|
|
234
|
+
## 2.0.1
|
|
235
|
+
|
|
236
|
+
- **自动 PDF 讲义**:`zju_write_note` 写入后自动把同一份 Markdown 排成同名 PDF
|
|
237
|
+
(封面 / 目录 / 标题 / 正文 / 列表 / 表格 / 公式 / 代码 / 引用 / 图片),本地 Typst 完成,
|
|
238
|
+
模型只多收到一行路径;PDF 失败不影响 Markdown。实现见 `zju_lecture/handout.py`,
|
|
239
|
+
工程目录 `<工作区>/.zju-lecture/handout/`。
|
|
240
|
+
- **功能解耦**:新增 `enableStudyNotes` 与 `enableLoginTools` 两个 dsh 设置
|
|
241
|
+
(MCP:`ZJU_ENABLE_STUDY_NOTES` / `ZJU_ENABLE_LOGIN_TOOLS`)。默认只注册 5 个核心工具;
|
|
242
|
+
填空笔记、投影抓取、登录辅助各自独立,关掉时不注册工具、不加载对应代码、不追加 Skill 附录。
|
|
243
|
+
- **GUI 重做**:设置页按「核心 → 阅读 → 复习 → 投影 → 登录」分组,显示当前工具数、PDF 状态、
|
|
244
|
+
模块依赖和一枚 `已保存` 反馈;新增 **省 Token / 复习模式 / 全功能** 三个一键预设。
|
|
245
|
+
- **省 token 的流程修正**:Skill 不再要求先 `zju_parse_url`、写后也不再强制重复
|
|
246
|
+
`zju_check_note`;系统提示压缩,明确「同一节课字幕只抓一次」「写入 + 校验 + PDF 一次完成」;
|
|
247
|
+
`zju_build_study_notes(draft)` 的返回从整页说明压到几行。工具描述整体缩短。
|
|
248
|
+
- **测试**:新增 `tests/test_handout_v201.py`(渲染 / 编译 / 自动 PDF / 开关矩阵),
|
|
249
|
+
更新 `plugin_apply_smoke.mjs` 与工具数断言。
|
|
250
|
+
|
|
251
|
+
## 1.6.0
|
|
252
|
+
|
|
253
|
+
- 新增工具 `zju_build_study_notes`(第 9 个),把讲义变成 scholia 填空式学习笔记:
|
|
254
|
+
- `mode=draft`:讲义 → 填空底稿(标题层级映射、标记位插入、LaTeX 数学 → Typst 数学);
|
|
255
|
+
- `mode=compile`:底稿 → `main.typ` + `prelude.typ` → `out.pdf` + 逐页 `page-N.png`,
|
|
256
|
+
并报告编译错误、方框视觉预算与悬空回指。
|
|
257
|
+
- 随包新增第二个 Skill `scholia-notes`(**非官方第三方工作流说明**,MIT,独立授权):
|
|
258
|
+
淡彩极简配色、视觉预算、内容出处规则、字体与分发注意事项、逐条第三方归属。
|
|
259
|
+
本 skill 与 `@preview/scholia` 包的作者无关,也未获其背书。
|
|
260
|
+
- 新增 `zju_lecture/study_notes.py` 与 `zju_lecture/prelude.typ`(唯一权威副本);
|
|
261
|
+
`tools/sync_skill_assets.py` 负责把 prelude 同步到 Skill 目录并校验一致。
|
|
262
|
+
- 工具数 8 → 9;`lib/tools.js` / `lib/tools.schema.json` / 两个 Skill 清单重新生成。
|
|
263
|
+
|
|
264
|
+
## 1.5.1
|
|
265
|
+
|
|
266
|
+
- **新增总开关**:dsh 插件设置 `enableSlides`(默认 `false`)与 MCP 环境变量
|
|
267
|
+
`ZJU_ENABLE_SLIDES`。关闭时 `zju_fetch_slides` 不注册、不读登录态、不下载截图;
|
|
268
|
+
字幕主链路完全不受影响。MCP 宿主未设置该变量时保持旧行为(开启),设 `0` 即关闭。
|
|
269
|
+
- **代码层解耦**:`zju_lecture/__init__.py` 用 PEP 562 懒加载 `download_slides` /
|
|
270
|
+
`build_slides_pdf` / `SlideError`;`mcp_server.py` 只在进入 `zju_fetch_slides` 分支时才导入
|
|
271
|
+
`zju_lecture.slides`。纯字幕进程的 `sys.modules` 里不会出现截图/PDF 模块。
|
|
272
|
+
- **协议层解耦**:`tools/list` 与 `initialize.instructions` 按开关动态输出;关闭时即使客户端
|
|
273
|
+
直接调用 `zju_fetch_slides`,也会得到可执行的「投影抓取未启用 + 如何开启」错误。
|
|
274
|
+
- **Skill 拆分**:`SKILL.md` 只保留字幕主链路;投影下载与插图规范移到
|
|
275
|
+
`skills/zju-lecture-summarizer/SLIDES.md`,dsh 插件仅在 `enableSlides=true` 时追加到内存 Skill。
|
|
276
|
+
- **两层次开关**:`enableSlides` 是总开关,`embedSlideImages` 是「截图是否入讲义」子开关;
|
|
277
|
+
总开关关闭时子开关无效。
|
|
278
|
+
- **图形化设置**:新增浏览器半边 `lib/client.js`,通过 `settings.section` 在设置左侧导航注册
|
|
279
|
+
独立的「浙大智云课堂讲义」一栏;`enableSlides` / `embedSlideImages` 标记为 Schemastery
|
|
280
|
+
`.volatile()`,通过共享 `configForms` 服务读写并带 revision 校验。
|
|
281
|
+
- 新增 `tests/test_feature_decoupling_v151.py` 与 `tests/client_settings_smoke.mjs`。
|
|
282
|
+
|
|
283
|
+
## 1.5.0
|
|
284
|
+
|
|
285
|
+
- `zju_fetch_slides` 按真实接口修正:从 Cookie 父域 `.zju.edu.cn` 会话中解析 `_token` 并加
|
|
286
|
+
`Authorization: Bearer`;按 `course_id` + `page/per_page` 分页并按截图 URL 去重;正确解包
|
|
287
|
+
`content.pptimgurl`(以前把 JSON 字符串当文字输出)。
|
|
288
|
+
- 新增 `download` / `output_dir` / `dedup` 参数与 CLI `slides --download`:截图存到
|
|
289
|
+
`ppt-assets/<sub_id>/images/`,用纯标准库合成 `PPT-<sub_id>.pdf`(JPEG `DCTDecode`、
|
|
290
|
+
PNG `FlateDecode`),连续字节完全相同的截图折叠为一页。
|
|
291
|
+
- 明确「接口返回截图,不是文字层 / OCR」:Skill 不再暗示能读取幻灯片文字。
|
|
292
|
+
- 安全:截图只允许 `https://*.zju.edu.cn`;ZJU 的 `http://` 自动升级 HTTPS;Cookie 只发给
|
|
293
|
+
ZJU 图片主机、不发送 Bearer;跨主机重定向剥离凭据;写盘限制在工作区,最多 2000 张、
|
|
294
|
+
单张 ≤ 32 MiB。
|
|
295
|
+
- 新增 dsh 设置 `embedSlideImages`(默认 `false`)与 MCP 环境变量 `ZJU_EMBED_SLIDES=1`。
|
|
296
|
+
- 参考 [`8eoyw/zju-learning-cli`](https://github.com/8eoyw/zju-learning-cli)(MIT)的公开实现思路,
|
|
297
|
+
未拷贝代码;其基于 numpy/Pillow 的近似笔画去重未移植。
|
|
298
|
+
- 完善致谢:补充 `PeiPei233/zju-learning-assistant`、`8eoyw/zju-learning-cli` 及其上游参考项目。
|
|
299
|
+
- dsh 单独把 `zju_fetch_slides` 的超时提高到 600s。
|
|
300
|
+
- 新增 `tests/test_slides_v150.py`。
|
|
301
|
+
|
|
302
|
+
## 1.4.2
|
|
303
|
+
|
|
304
|
+
- `@deepseek-ai/schemastery` 从 `dependencies` 改为 `peerDependencies`(`^3.18.1`),
|
|
305
|
+
与插件市场的推荐写法、`dshmarket` 保持一致:profile 里不会出现第二份运行时,
|
|
306
|
+
peer 由 pnpm 在 `dsh plugin add` 时自动装好;本地目录安装只需补这一颗依赖。
|
|
307
|
+
- 文档口径统一到 **8 个工具**:`zju_write_note` 在 1.4.1 加入后,`README.md`、`ATTRIBUTION.md`
|
|
308
|
+
与 `lib/index.js` 的注释还写着 7。
|
|
309
|
+
|
|
310
|
+
## 1.4.1
|
|
311
|
+
|
|
312
|
+
针对 [实地运行反馈](docs/issue-1.4.0-实地运行反馈.md) 的 8 项问题(真实一节课 `sub_id=1988057` 跑下来):
|
|
313
|
+
|
|
314
|
+
| # | 修复 |
|
|
315
|
+
| :-: | :--- |
|
|
316
|
+
| P1-1 | 相对路径按**会话工作区**解析(`ZJU_WORKSPACE` → `PWD` → 进程 cwd);找不到时回显**已尝试的绝对路径**。 |
|
|
317
|
+
| P1-2 | `fix=true` 新增**块级 `$$` 前后补空行**修复器:区分开块/闭块(不往公式体里插空行)、跳过代码块、保留列表缩进。 |
|
|
318
|
+
| P2-1 | 检查报告**按 `code` 聚合**:`[错误] display_not_isolated × 59` + 有界行号列表 + 少量示例,新增 `max_samples`(默认 3)。 |
|
|
319
|
+
| P2-2 | PPT / 视频直链失败分支改为**单一结论 + 单一动作**(`reason` 枚举 `abe` / `locked` / `no_rows` …)。 |
|
|
320
|
+
| P2-3 | 新增 `zju_write_note`:文件名由 Agent 按「上课日期 + 本节内容」起名,缺省才回退 `知识总结-<sub_id>-<课程简称>.md`;**同名拒绝静默覆盖**。 |
|
|
321
|
+
| P3-1 | 备份改写到备份目录(`ZJU_BACKUP_DIR`,默认系统临时目录),不再污染 `git status`。 |
|
|
322
|
+
| P3-2 | Skill 清单新增 `contentHash`;插件启动告警打印两边的 sha256;新增防回归测试禁止「让用户提供 cookie」这类过期文案。 |
|
|
323
|
+
| P3-3 | 字幕返回 **`ASR 可靠度`**(噪声比 / 碎句比 / 平均句长 / 高频口头禅 + 处置建议),`chunked` / `json` 视图给 `quality` 对象。 |
|
|
324
|
+
|
|
325
|
+
## 1.4.0
|
|
326
|
+
|
|
327
|
+
针对 [issue #1](https://github.com/chenqianyu486-sys/dsh-zju-lecture-note/issues/1) 的 11 项审查:
|
|
328
|
+
|
|
329
|
+
| # | 修复 |
|
|
330
|
+
| :-: | :--- |
|
|
331
|
+
| 1 | `fix=true` 不再改写行内代码/围栏代码里的示例 |
|
|
332
|
+
| 2 | 回写前先备份,再原子替换;工具卡类型从 `read` 改为 `edit` |
|
|
333
|
+
| 3 | DOCX 按 token 流解析,恢复段落、制表符、`<w:br/>` 与 XML 实体 |
|
|
334
|
+
| 4 | `chunked` / `json` 遵守 `max_chars`,超限时给 `truncated` / `next_start_minute` |
|
|
335
|
+
| 5 | 切片时同时报告「课程总时长」和「本次区间」 |
|
|
336
|
+
| 6 | 检测 `app_bound_encrypted_key`(ABE),命中时直接引导 `ZJU_COOKIE_FILE` |
|
|
337
|
+
| 7 | Cookie 兜底复制带上 `-wal` / `-shm` 并回放 WAL |
|
|
338
|
+
| 8 | `config.json` 移出敏感名单;凭据词改整词匹配 |
|
|
339
|
+
| 9 | PDF 解析失败时汇总每种库的失败原因,并给出当前解释器的绝对路径 |
|
|
340
|
+
| 10 | `isError` 已能冒泡;超时仅在无其他在途调用时才回收 Python 子进程 |
|
|
341
|
+
| 11 | 系统提示段落声明适用范围,只对智云课堂相关任务生效 |
|
package/LICENSE
ADDED
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 chenqianyu486
|
|
4
|
+
|
|
5
|
+
Copyright (c) 2026 zju-lecture-summerizer- contributors
|
|
6
|
+
(the original zju-lecture-summerizer- project, whose MIT-licensed
|
|
7
|
+
subtitle, cookie and courseware logic this plugin is adapted from;
|
|
8
|
+
see ATTRIBUTION.md)
|
|
9
|
+
|
|
10
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
11
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
12
|
+
in the Software without restriction, including without limitation the rights
|
|
13
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
14
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
15
|
+
furnished to do so, subject to the following conditions:
|
|
16
|
+
|
|
17
|
+
The above copyright notice and this permission notice shall be included in all
|
|
18
|
+
copies or substantial portions of the Software.
|
|
19
|
+
|
|
20
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
21
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
22
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
23
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
24
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
25
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
26
|
+
SOFTWARE.
|