DSH Plugins Marketplace

DSH Plugins

Plugins

/

zju-campus

A

zju-campus

Manifest valid

DSH Host Plugin: Zhejiang University Unified Identity Authentication, "Xue Zhe Zhe Da" Pending Assignments, Zhiyun Classroom Schedule Playback Notes, Campus Notification Aggregation

UI (client)hasBundlePatchMachine translated

浙大校园助手(zju-campus)

DSH Host 插件:把 ZJUAM 统一身份认证、学在浙大、智云课堂和校园公开通知,做成一组模型可直接调用的工具。

  • 零第三方依赖,只用 Node 内置能力(fetch / FormData / BigInt)。
  • ZJUAM 密码用学校下发的 RSA 公钥加密后提交;凭据保存在本机私有明文配置文件,不回显、不写普通日志。独立校内HTTP系统不继承该密码。
  • Cookie 只在内存,进程退出即失效。
  • 只允许访问 *.zju.edu.cn,重定向到外站直接拒绝。
  • 写操作(提交/撤回作业)与虚拟位置代签默认关闭。

面板预览

截图由 node test/preview-render.mjs --demo 用示例数据生成,学号、课程、教师、教室、路径均为占位值。

| 会话右侧抽屉(紧凑版) | |---|---| | 抽屉 | 签到区 |

环境要求:DSH 0.2.x 及以上(rc 预发布版也能装),Node.js >= 20。不需要 Git、Python 或任何第三方 npm 包;只有想用「课件 OCR」时才额外装 rapidocr-onnxruntime。

一、配置账号

推荐放在插件私有文件里,不要把密码写进补丁或聊天:

# C:\Users\<你>\.dsh\zju-campus\credentials.env
ZJU_USER=你的学号
ZJU_PASSWORD=你的密码

保存后不需要重启,下一次工具调用会自动读取。

为什么不放 $DSH_HOME/.env:DSH 会把那个文件的变量注入到所有子进程环境,而它的过滤规则只认名字里含 KEY/PASSWORD/SECRET/TOKEN 的变量。ZJU_PASS 不匹配,密码会出现在每个 shell 的环境变量里;改成 ZJU_PASSWORD 能被过滤,但学号仍会漏。放在插件私有文件里最干净——DSH 根本不读它。

插件仍兼容 $DSH_HOME/.env(变量名 ZJU_PASS 或 ZJU_PASSWORD)和进程环境变量,只是不如私有文件安全。

二、安装

在 DSH 里用插件管理工具安装本目录:

plugin_manager install_bundle target = <解压后的插件目录绝对路径>

或手动在 profile 的 package.json 加 "@local/zju-campus": "link:<解压后的插件目录绝对路径>",并把 @local/zju-campus 加进 dsh.profile.bundles。

安装后 include:zju-campus 行应为 active。

三、侧边栏面板与会话右侧抽屉

插件支持双入口并存,在不同场景下自由使用:

  1. 左侧全页面板(左导航栏入口):

    • 安装后左侧边栏多出「浙大」图标入口,点开为大页面板。
    • 待办:支持全部与紧迫筛选,临近截止标红,带一键「💬 问 AI」按钮。
    • 近 7 天课表:日期条覆盖今天与往前 6 天,点日期即可切换;每节课都能直接「转录 / 笔记」,非今日课程也能回看复习。点击课程直接打开智云课堂对应课堂(统一走 /livingroom)。
    • 签到提醒:面板顶部红色「正在进行签到」横幅,并显示当前默认虚拟位置。默认只提醒,不代签;
    • 最新通知:求是学院、本科生院、外国语学院、光电学院聚合。
    • 作业入口:截止时间显示为北京时间;点击直接打开作业详情。
    • 独立校园系统:大物实验课表、工程训练预习作业截止时间与答题入口。
  2. 会话右侧抽屉(对话界面即时唤出):

    • 在任何会话窗口中,顶栏右侧工具区(header utilities)新增「浙大」快捷按钮,点击一键展开/收起右侧助手抽屉。
    • 也可通过右侧边栏 + 号添加标签页选择「浙大校园助手」。
    • 抽屉模式自适应紧凑排版,方便一边与 AI 对话交流,一边随时对照课表与待办作业。
    • 点击待办旁「💬 问 AI」,系统会自动组装该门作业的提问词并直接填入当前聊天输入框,同时复制到剪贴板,立刻就能向大模型获取解题思路或规划。

四、工具(共 23 个)

工具作用需要账号
zju_status认证状态、会话有效期、写操作开关否
zju_login主动登录 / 刷新两套会话是
zju_logout清除内存会话否
zju_todos学在浙大未完成待办(支持 urgent_only 快速筛 7 天内待办、type、days)是
zju_courses我的课程(拿 course_id)是
zju_homework某课全部作业,含提交状态、得分、评语、activity_id是
zju_materials某门课的课件、讲义与资料(含附件名、大小、更新时间),支持关键词过滤是
zju_schedule智云课堂课表(拿 sub_id),支持 date / end_date 日期区间,如一次查近 7 天是
zju_playback智云课堂某节课的视频回放直达链接(livingroom 网页播放地址)是
zju_transcript某节课的语音识别转录逐段文本是
zju_notes取某节课的笔记材料:已有缓存直接返回 Markdown;没有缓存时返回「逐页课件 OCR 文字 + 按 5 分钟分桶的转录(每桶标注讲了哪几页)」,长课用 part 分段读全是
zju_slides_ocr把某节课的课件截图批量 OCR 成文字并缓存(_附件/<sub_id>/ocr.json),之后 zju_notes 的材料就会带上每页 PPT 的文字否
zju_save_note保存结构化课堂笔记:{{slide:N}} 占位符自动替换成正文内嵌图片、写本地缓存、镜像到 Obsidian是
zju_notes_list列出已缓存的课堂笔记(按日期倒序,可按课程/关键词过滤)否
zju_obsidian查看 / 检测 / 指定 Obsidian 库(status / detect / use / disable)否
zju_notices外国语学院 / 光电学院 / 求是学院 / 本科生院公开通知否
zju_notice_detail通知正文、发布时间、附件链接否
zju_rollcall查看当前有没有正在进行的点名/签到(默认只提醒,不代签)是
zju_rollcall_location
zju_rollcall_answer
zju_lab_materials大物实验课件:列出某次实验的指导书/讲义/PPT,或下载到本地并返回路径独立实验账号
zju_submit_homework提交作业(写操作,需 confirm: true)是
zju_retract_homework撤回作业(写操作,需 confirm: true)是

典型链路:

zju_courses → zju_materials(查课件)
zju_courses → zju_homework → zju_submit_homework(交作业)
zju_schedule → zju_playback(看回放)
zju_schedule(近 7 天区间) → zju_transcript / zju_notes(回看非今日课程)
zju_notes(材料) → 模型写结构化笔记 → zju_save_note(缓存 + Obsidian)
zju_notes_list / zju_obsidian(管理已缓存笔记与同步)
zju_notices → zju_notice_detail(看通知)

五、

仅供学习与个人使用。签到规则由学校制定,使用前请自行确认合规性,风险自负。

六、课堂笔记与 Obsidian

一节课的笔记分两步,都是对话里直接说就行:

用 zju_notes 拉一下 10-27 示例物理的课堂材料
(模型生成结构化笔记后自动调用 zju_save_note 保存)
  1. zju_notes:有缓存就直接返回已存的 Markdown;没有缓存时拉取
    • 语音识别转录(按 5 分钟分桶,带 [mm:ss - mm:ss] 时间段,每桶标注这段讲了第几页);
    • 课件页(search-ppt 接口,按 created_sec 排序,标注重点页),已 OCR 的话逐页列出 PPT 上的文字;
    • 长课自动分段:材料头写「第 k/N 段」,用 part=2、3… 逐段读完再动笔。
  2. zju_save_note:把模型写好的 Markdown 落盘,并
    • 把正文里的 {{slide:N}} / {{slide:N|说明}} 占位符替换成内嵌图片,做到图文混排;
    • 写入本地缓存 $DSH_HOME/zju-campus/notes/(同名笔记覆盖更新,索引存 index.json);
    • 下载课件图片到 notes/_附件/<sub_id>/(单张超过 8MB 跳过);
    • 正文里没有占位符时,才回退到文末「课件时间轴」清单;
    • 配置了 Obsidian 时镜像一份到库内。

课件 OCR:课件接口只给图片、不给文字,所以 PPT 上的定义公式要靠 OCR 提取。

先 zju_slides_ocr(sub_id=1234507)     # 逐页识别,缓存到 _附件/<sub_id>/ocr.json
再 zju_notes(sub_id=1234507)          # 材料里就带上每页 PPT 的文字了

引擎是 RapidOCR(pip install rapidocr-onnxruntime),纯本地离线、约 3.6 秒/页,中文标题、公式结构、表格数字都能出来。解释器路径用配置项 ocrPython 指定。

建议的笔记结构(写进提问词里,模型会照做):

## 本节要点 / ## 知识点 / ## 公式与定义 / ## 例题与讲解 / ## 作业与截止时间 / ## 待复习

Obsidian 同步:库内结构如下,用双链把笔记、课程索引、总索引串起来。

<库>/智云课堂/
├── 2026-10-27 示例课程B (1234505).md   # 带 frontmatter:sub_id / course / date / tags
├── _索引.md                                  # 全部笔记的日期表格
├── _课程/<课程名>.md                          # 单门课的笔记列表
└── _附件/<sub_id>/ppt-001.jpg                # 课件图片

配置方式(三选一,按优先级):

  1. 对话里说「把 Obsidian 库设为 D:/Obsidian/Vault」→ 写 $DSH_HOME/zju-campus/obsidian.json,立即生效;
  2. profile 配置 obsidianVault / obsidianFolder;
  3. 什么都不配时自动探测 %APPDATA%\obsidian\obsidian.json,只有一个库才自动启用。

对应工具:zju_obsidian action=status|detect|use|disable、zju_notes_list。

七、配置项

写在 profile 补丁 zju-campus 行的 config 里:

键默认说明
allowWriteOpsfalse是否允许提交/撤回作业
allowIndependentHttpfalse独立校园HTTP系统授权;当前用户明确同意后,本地bundle中已启用
sessionTtlMinutes15会话缓存时长
requestTimeoutMs20000单次请求超时
noticeSources["qsxy","bksy","sis","opt"]通知来源
tenantId"112"智云课堂租户 id
username / password空不推荐,优先用 .env
envFile$DSH_HOME/zju-campus/credentials.env自定义凭据文件路径
allowRollcallSignfalse
rollcallLocationsFile$DSH_HOME/zju-campus/rollcall-locations.json
rollcallSwitchFile$DSH_HOME/zju-campus/rollcall-switch.json
rollcallAutotrue
rollcallAutoIntervalMs60000
rollcallAutoMaxTries2
rollcallAutoRetryMs180000
rollcallAutoFile$DSH_HOME/zju-campus/rollcall-auto.json
rollcallNumbertrue
rollcallNumberTtlMs90000
rollcallNumberLivetrue
rollcallDefaultLocation空
rollcallAccuracy68
rollcallMaxAttempts20
rollcallAttemptDelayMs800
notesDir$DSH_HOME/zju-campus/notes课堂笔记缓存目录
notesDownloadSlidestrue保存笔记时是否下载课件图片
obsidianFile$DSH_HOME/zju-campus/obsidian.jsonObsidian 同步设置文件(工具/对话写入,优先于配置)
obsidianVault空Obsidian 库根目录;留空时自动探测
obsidianFolder智云课堂库内子目录
ocrPythonpython跑课件 OCR 的 Python 解释器(需装 rapidocr-onnxruntime)

开启写操作:

- id: zju-campus
  name: '@local/zju-campus'
  config:
    allowWriteOps: true

八、结构

zju-campus/
├── index.js           # 插件入口:23 个工具 + 侧边栏数据路由
├── client.js          # 浏览器端:侧边栏页面与入口
├── cordis.patch.yml   # bundle 补丁
├── src/
│   ├── http.js        # Cookie Jar、受限 fetch、HTML 工具
│   ├── zjuam.js       # CAS 登录 + RSA 加密
│   ├── courses.js     # 学在浙大接口(含雷达点名应答)
│   ├── cmc.js         # 智云课堂接口
│   ├── notices.js     # 公开通知抓取
│   ├── session.js     # 凭据解析、会话缓存、重试
│   ├── panel.js       # 侧边栏快照聚合与 60 秒缓存
│   ├── rollcall-locations.js  # 
│   ├── rollcall-answer.js     # 
│   ├── rollcall-switch.js     # 
│   ├── notes.js       # 课堂笔记缓存与 Obsidian 镜像
│   └── format.js      # 工具结果文本渲染
├── locale/{zh,en}.json
├── icon.svg
├── scripts/           # 辅助脚本:课件 OCR、材料落盘、笔记保存、课表探针
├── test/              # 冒烟测试(非插件运行时依赖)
├── preview/           # 面板静态预览(示例数据,由 test/preview-render.mjs --demo 生成)
├── .env.example       # 凭据模板
└── CONTRIBUTING.md    # 参与开发须知

预览图重生成(示例数据,不含真实学号/课程):

node test/preview-render.mjs --demo                                  # 面板 + 分区特写
node test/preview-render.mjs preview/rollcall-preview.html --demo --with-rollcall  # 含签到的页

注意参数顺序:输出路径必须是第一个非 -- 开头的参数,--demo 放后面。

九、测试

node test/smoke.mjs          # 通知解析、RSA 可逆、凭据解析
node test/plugin.mjs         # 工具注册、schema、写操作开关
node test/client.mjs         # 模拟浏览器加载 client.js,检查插槽注册
node test/panel-mock.mjs     # 不联网验证侧边栏数据映射
node test/route.mjs          # 路由注册 + 假 req/res 实调
node test/rollcall-locations.mjs # 
node test/rollcall-answer.mjs    # 
node test/rollcall-switch.mjs    # 
node test/rollcall-tools.mjs     # 
node test/notes.mjs          # 笔记缓存 + Obsidian 镜像(临时目录)
node test/ppt.mjs            # 课件解析、转录分桶、笔记/材料渲染
node scripts/slides-ocr.py <课件目录>   # 批量 OCR 课件截图(需 rapidocr-onnxruntime)
node scripts/live-materials.mjs 1234507 1   # 命令行看某节课的笔记材料(第几段)
node scripts/dump-materials.mjs 1234506      # 把全部材料分段落盘,长课交给子代理分块整理
node scripts/save-note.mjs <sub_id> <md文件>  # 用文件里的 markdown 直接保存笔记
node scripts/dump-transcript.mjs <sub_id>     # 完整转录落盘,长课分块整理用
node scripts/probe-lesson.mjs                # 查近 14 天课表的 sub_id / course_id
node scripts/live-notes-e2e.mjs  # 真实账号:拉材料 → 存笔记 → 校验缓存与 Obsidian
node test/cas-live.mjs       # 真实 CAS 链路(用不存在的学号,验证解析/加密/提交/判定)
node test/live-login.mjs     # 真实账号端到端:待办、课程、作业、课表
node test/panel-summary.mjs  # 真实账号拉一次侧边栏快照
node test/transcript-live.mjs # 真实转录(找最近有「回放」的课)
node test/courses-only.mjs   # 只测学在浙大登录(排查账号/风控)
node test/debug-cmc.mjs      # 打印智云课堂登录每一跳,排查重定向

smoke / plugin / client / panel-mock / rollcall-* / notes / ppt 不需要真实账号;route 会拉一次真实侧边栏快照;其余 *-live 脚本会读取插件私有凭据文件并用真实账号访问学校站点,只在你本机运行。 scripts/live-notes-e2e.mjs 默认用临时目录,加 --vault D:/Obsidian/Vault 才会写真实库(建议先不加,验证完再单独指定)。 test/cas-live.mjs 用不存在的学号,不会触碰任何真实账户。

注意:短时间内反复登录会触发学校风控(表现为「停在登录页」)。插件默认缓存会话 15 分钟,正常使用不会频繁登录;调试时请拉开间隔。

十、限制

  • courses.zju.edu.cn 与 *.cmc.zju.edu.cn 只对国内 IP 开放,必须在国内网络的本机运行。
  • 智云课堂只有「回放」状态的课才有转录。
  • 若学校改了登录页结构(execution / 表单 action)或接口路径,需要相应调整。
  • 验证码、二次验证会表现为「停在登录页」,本插件不会尝试绕过。
  • 求是学院通知(qsxy)只对校内 IP 开放,校外网络下拉不到列表,会返回空结果而不是报错。

十一、参与开发

改动流程、代码风格、测试命令、以及「哪些东西绝对不能提交」的清单见 CONTRIBUTING.md。

离线测试(不需要真实账号、不联网)一条命令跑完:

for t in smoke plugin client panel-mock rollcall-locations rollcall-answer \
         rollcall-switch rollcall-tools notes ppt engineering-parser \
         independent-panel requirements-v12; do
  node test/$t.mjs || echo "FAIL $t"
done

十二、致谢

这个插件的几个关键思路来自下面这些开源项目,感谢作者把它们公开出来:

十三、许可证

GPL-3.0-only

十四、免责声明

本项目仅供学习交流与个人效率使用,请勿用于任何商业用途。使用前请自行了解浙江大学关于统一身份认证、教务系统、课堂签到与课程材料的有关规定;因使用本项目产生的一切后果由使用者自行承担。

插件不会绕过验证码、不会伪造签到以外的身份信息、不会把凭据发送到 *.zju.edu.cn 之外的任何地方。

Comments

Loading…

Similar plugins

dsh-jlu-baixiaosheng

by WilliamWang6586

吉林大学百晓生知识库 DeepSeek Harness 插件:转专业/培养方案/保研/选课/校园网/考试/车队纳新/新生攻略,38 篇实测参考随包分发

Manifest valid

★ 0

JavaScript

Nov 16, 2026

dsh plugin --profile web add dsh-jlu-baixiaosheng

by EricWang1358

StudyHub: a DeepSeek Harness (DSH) plugin that turns your own material into questions and spaced review · 把自己的资料变成题目与间隔复习的 DSH 学习插件

Tools & CapabilitiesManifest valid

★ 194

↓ 428/wk

MIT

JavaScript

Nov 17, 2026

dsh plugin --profile web add @ericwang1358/dsh-daily-flashcard

by w32394045-dotcom

DeepSeek Harness 的 GitHub 接入插件:设置里登录账号,agent 用它真实干活(12 个工具 + 云计算与成本护栏)。token 不经过模型上下文。

Manifest valid

★ 0

MIT

JavaScript

Oct 6, 2026

dsh plugin --profile web add @ptfm/dsh-github

by zgdllt

Study Companion (伴学): a DeepSeek Harness plugin for learning plans, exams, spaced review, and lecture notes.

Development & InfrastructureManifest valid

★ 3

MIT

JavaScript

Nov 14, 2026

dsh plugin --profile web add @local/study-companion

by Make0209

DeepSeek Harness 插件:GitHub 风格用量热力图 + Token / 缓存命中 / 账户余额看板 + 工作区别名管理。

UI & ExperienceManifest valid

★ 33

↓ 447/wk

MIT

JavaScript

Aug 14, 2026

dsh plugin --profile web add dsh-usage-stats

by deepseek-dsh

DeepSeek Harness Web UI 增强插件:余额用量概览、项目文件浏览、Git 变更与历史、内置终端、Harness 更新检查

Tools & CapabilitiesModels & ProvidersManifest valid

★ 4

↓ 19/wk

JavaScript

Aug 20, 2026

dsh plugin --profile web add dsh-workspace