水杉·VSCode 教学适配器
在 VS Code 内一站式完成水杉在线平台的作业查看与提交、课件与视频学习,无需频繁切换浏览器。
功能
- 🔐 登录:侧边栏输入水杉账号密码登录,Token 加密存储于 VS Code Secrets,自动续期。
- 📚 作业中心:课程 → 周进度 → 资源 三级树;顶部「待办作业」跨课程聚合、按截止时间排序、带倒计时配色。
- 📝 作业工作区:点击作业自动创建工作夹(含说明与老师附件),记录「作业 ↔ 文件夹」绑定,新窗口打开即可写代码。
- ☁️ 智能提交:绑定文件夹内单文件直接交、多文件可选,提交前二次确认;提交情况面板显示是否已交、批改状态、得分与教师评语。
- 📄 课件打开:
- PDF 直接在 VS Code 内翻页阅读(可选中/复制文字);
- 图片 / 文本 / 代码 / Notebook 用编辑器原生打开;
- PPT / Word / 压缩包等下载后交由系统默认程序打开。
- 🎬 视频播放:阿里云 VOD 视频在 VS Code 内直接播放(含字幕控件),B 站等外链自动在浏览器打开;若当前编辑器内核不支持视频解码则自动降级到浏览器,不留黑屏。
- 🧰 其他 / 实训 / 通知:其他与实训资源按类型打开,通知以文本查看。
- 👤 个人主页:查看个人信息、退出登录。
快速开始
- 在扩展面板搜索「水杉」并安装(或从
.vsix 安装)。
- 点击活动栏的水杉图标,打开侧边栏并登录。
- 展开课程 → 周 → 资源:
- 作业:点击创建工作区、编写后用内联「提交」按钮上交;
- 课件 / 视频 / 其他:直接点击查看或播放。
配置
在 VS Code 设置中搜索「水杉」:
| 配置项 |
默认值 |
说明 |
shuishan.baseUrl |
https://www.shuishan.net.cn/api |
平台 API 基础地址 |
shuishan.oauthClientId |
system |
OAuth2 客户端 ID |
shuishan.oauthClientSecret |
(空) |
OAuth2 客户端密钥(一般无需填写) |
开发
npm install
npm run compile # 编译
npm run watch # 监听编译
# 按 F5 在 Extension Host 中调试
第三方组件
- PDF.js(Apache-2.0,Mozilla)——用于 PDF 课件渲染,许可见
media/pdfjs/LICENSE。
- Aliplayer(阿里巴巴)——用于视频播放,运行时从阿里云 CDN 加载,未随插件分发。
版权
© 华东师范大学数据科学与工程学院 水杉团队。保留所有权利。详见随附的 LICENSE 文件。
联系方式:fanyang@stu.ecnu.edu.cn
| |