西浦课程助手

Learning Mall · 西浦

让 AI 帮你盯 DDL、读课件。

装好以后，直接在 Codex、Claude Code 等 AI 里问：「我最近有哪些 DDL？」「把这门课的 PDF 都下下来。」用你自己的学校账号登录，课件只存在你自己的电脑上。

  • 只看不改，不会替你交作业
  • 资料留在自己电脑
  • 免费开源

安装

你的电脑
1
打开能帮你操作电脑的 AI

比如 Codex、Claude Code、Kimi Code。普通网页聊天做不了这件事。

2
把这段话复制发给它
3
它要权限就点允许，弹出窗口就登录

在弹出的窗口点「XJTLU Account」，输入账号密码。装好后按 AI 的提示重启一下应用。

电脑上没有 Node.js 也没关系，会自动装好。大约需要 2–5 分钟。

装好以后

像问同学一样问 AI

AI 会自己去 Learning Mall 找答案，能看到的就是你登录后在网页上本来就能看到的内容。不知道从哪问起也没关系，它会先问你是要查 DDL、下载课件，还是读讲义。

示例 · 查 DDL
目前有哪些 DDL？
正在看 Moodle 时间线，再翻每门课的 Module Handbook 和作业说明…

按截止时间排好了，括号里是来源：

  • 10/30 周五 17:00　MTH205 · Coursework 1（Moodle，还没提交）
  • 11/15 20:00　MTH202 · Empirical project（Handbook；作业说明写的是 11/16 18:00，两份不一致，建议问老师）
  • 12/11 17:00　MTH205 · Coursework 2（只写在 Handbook 里，Moodle 上还没有）

需要整理成 HTML 页面吗？

示例 · 一键存课件
帮我把这门课的 PDF 下载出来，形成文件夹。
正在下载这门课的全部资料…

找到 81 个文件，全部下载好了。重复上传的只留一份，一共 76 个文件、37.5 MB：

当前文件夹 / MTH129 ├─ Lecture 1.pdf ├─ Lecture 2.pdf ├─ …（共 32 份 PDF） └─ Lab 1.ipynb …

要先帮你读 Lecture 1 吗？

两个示例都根据真实使用整理；存课件的数字来自一门课。

开始之前

你需要准备

一台 Mac 或 Windows 电脑

不需要管理员密码，也不用改任何系统设置。

Chrome 或 Edge 浏览器

用来登录学校账号。没有的话先装一个 Chrome。

一个电脑上的 AI 应用

比如 Codex、Claude Code、Kimi Code，也支持 Claude 桌面版、Cursor、Windsurf。网页版聊天暂时连不上。

安全吗

你的账号，只在你的电脑上

密码只输在学校登录页

工具不会让你在别处输入密码，也不会保存密码。它只记住登录状态，就像浏览器的“保持登录”。

只看，不改

不会提交作业、开始测验、发帖或改成绩，也不会绕过任何人机验证。

资料留在你电脑上

登录状态和课件都只存在你自己的电脑。注意：你让 AI 读的内容，会发给你所用的 AI 服务。

常见问题

遇到问题？

在国内能打开这个网址吗？

网址通过 Cloudflare 和 GitHub Pages 提供，大多数网络能直接打开。安装时用到的 Node.js 和依赖都会在官方源太慢时自动换成国内镜像。如果网页或安装命令打不开，换个网络（校园网、手机热点）再试。

能用 npm / npx 安装吗？

也可以用：已经装了 Node.js 的同学，运行 npx -y xjtlu-core-mcp@latest setup 就行。但很多同学电脑上没有 Node.js，那样连 npx 这个命令都没有，所以网页上主推的是一行安装命令：它会先自己装好 Node.js，再从 npm 的国内镜像下载课程助手。

登录过期了，或者 AI 说“需要重新登录”

再运行一次同一行安装命令（或者把上面那段话再发给 AI 一次）就行，会重新弹出登录窗口。Node.js 已经装好的话不会重复下载。

装好了，但 AI 里找不到我的课程

先把 AI 应用完全退出（Mac 上按 ⌘ + Q），再重新打开。还不行的话，再运行一次安装命令，最后问你要不要连接 AI 应用时按回车。

提示“没有找到支持的 AI 应用”

先安装其中一个（比如 Codex、Claude Code 或 Kimi Code），打开一次，再运行一次安装命令。

登录窗口一直白屏

关掉这个窗口，确认网络正常后再运行一次安装命令。工具用的是一个独立的浏览器窗口，和你平时用的 Chrome 互不影响。

下载很慢，或者提示下载失败

安装程序会自动换用国内镜像。仍然失败的话，换个网络（比如校园网或手机热点）再试一次。

它能做什么，不能做什么？

能查课程、作业和测验的时间与要求，能读讲义 PDF、Word，能把整门课的资料存到电脑。扫描版 PDF（图片）读不出文字；单个文件最大 200 MB；外部网站上的资料不会下载。

可以把这个网页发给同学吗？

可以。网页里没有任何人的账号信息，同学用自己的学校账号登录。但不要把你电脑上的 .xjtlu-session-mcp 文件夹发给别人，那里有你的登录状态。

下载的课件存在哪里？

如果你是在 Codex、Claude Code 等 AI 里打开了某个文件夹再让它下载，课件会直接存进这个文件夹（每门课一个子文件夹），AI 会先告诉你存到哪、完成后给出完整路径。想换地方，直接告诉它文件夹路径就行（需要在你自己的用户目录里）。没有指定时，存在「文稿 / XJTLU Core」。

怎么卸载？

删除用户目录下的 .xjtlu-session-mcp 文件夹即可；AI 应用的设置里会多一个叫 xjtlu-core 的连接，也可以一并删掉。下载的课件在「文稿 / XJTLU Core」，想留就留着。

给懂技术的同学

这是一个本地 stdio MCP 服务器，共 11 个工具（课程、DDL 时间线、按课程从 handbook 和作业说明里找 DDL、作业/测验、活动、文件列表、读文件、批量保存、导出目录等），除保存文件外都只读，源码在 GitHub。安装命令会把 Node.js（官方二进制包，校验 SHA-256）和程序装进 ~/.xjtlu-session-mcp，再修改你同意的 AI 客户端配置，并保留备份。登录窗口是不受自动化控制的普通 Chrome / Edge。目前在 macOS 上实测通过；Windows 脚本按同样流程编写，尚未真机测试。

工具包 SHA-256
3d2b042dd1171c3b6db8bd07472d69983206ed09c24458d926ab2be1754026ab
构建于 2026-10-19 · 28 个文件