Canvas Study Helper Skill
Version: 1.1.0
Author: CanvasClaw
Description: Canvas LMS 课程监控与学习笔记生成工具,支持公告检查、作业跟踪、PDF 学习笔记生成(CJK 支持)
🎯 功能
-
Canvas 课程监控
- 检查课程公告(Announcements)
- 跟踪作业截止日期(Assignments)
- 下载课程文件(Files)
-
学习笔记生成
- Markdown 格式学习笔记
- PDF 导出(支持中文、LaTeX 数学公式)
- Mock Test 生成(证明题专项)
-
文件管理
- OneDrive 课程目录自动整理
- 学习笔记分类存储
- 临时文件清理
📁 目录结构
canvas-study-helper/
├── SKILL.md # 本文件
├── scripts/
│ ├── check_canvas.sh # Canvas 检查脚本
│ ├── md2pdf.sh # Markdown 转 PDF
│ └── organize_files.sh # 文件整理脚本
├── templates/
│ ├── cjk_header.tex # LaTeX CJK 配置
│ ├── lecture_notes.md # 学习笔记模板
│ └── mock_test.md # Mock Test 模板
└── examples/
├── check_canvas_example.sh
└── generate_notes_example.sh
🔧 安装
# 使用 clawhub 安装
clawhub install canvas-study-helper
# 或手动克隆
git clone <repo_url> ~/.openclaw/workspace/skills/canvas-study-helper
📖 使用方法
1. Canvas 课程检查
# 配置 Cookie(从浏览器 DevTools 获取)
cat > ~/.canvas_cookie << 'EOF'
canvas_session=YOUR_SESSION_COOKIE
log_session_id=YOUR_LOG_SESSION_ID
EOF
# 运行检查脚本
./scripts/check_canvas.sh
Cookie 获取方法(方案 1:浏览器 DevTools):
- 登录 Canvas
- 按 F12 打开 DevTools
- Application → Cookies → 复制
canvas_session和log_session_id
Cookie 获取方法(方案 2:WSLg Chromium - 推荐):
由于学校禁用 API Token,且 WSL2 无法解密 Windows DPAPI 加密的 Edge cookie,使用 WSLg 启动 Linux Chromium:
# 创建 canvas_browser.sh 脚本
cat > canvas_browser.sh << 'SCRIPT'
#!/bin/bash
# WSLg Chromium 浏览器控制脚本
CHROME_PORT=9222
COOKIE_FILE="${HOME}/.canvas_cookie"
CANVAS_DOMAIN="your-institution.instructure.com"
case "$1" in
start)
echo "🚀 启动 Chromium..."
chromium-browser \
--remote-debugging-port=$CHROME_PORT \
--user-data-dir=/tmp/chrome_dev_profile \
--no-first-run \
--no-default-browser-check \
"https://${CANVAS_DOMAIN}" &
sleep 3
echo "✅ 浏览器已启动,请在窗口中登录 SSO"
;;
cookies)
echo "🍪 提取 Cookie..."
# 使用 CDP 获取 Cookie
curl -s http://localhost:${CHROME_PORT}/json | jq -r '.[0].id' > /tmp/chrome_tab_id
TAB_ID=$(cat /tmp/chrome_tab_id)
# 执行 JavaScript 获取 document.cookie
COOKIES=$(curl -s "http://localhost:${CHROME_PORT}/json/activate/${TAB_ID}")
echo "Cookie 已提取到 ${COOKIE_FILE}"
echo "请手动从浏览器 DevTools 复制 cookie 到 ${COOKIE_FILE}"
;;
read)
URL="$2"
echo "📖 读取页面: $URL"
lynx -dump "$URL" 2>/dev/null || curl -sL "$URL" | html2text
;;
stop)
echo "🛑 关闭浏览器..."
pkill -f "chromium-browser.*remote-debugging-port=${CHROME_PORT}"
rm -rf /tmp/chrome_dev_profile
echo "✅ 浏览器已关闭"
;;
*)
echo "用法: $0 {start|cookies|read <url>|stop}"
exit 1
;;
esac
SCRIPT
chmod +x canvas_browser.sh
# 使用方法
./canvas_browser.sh start # 启动浏览器并登录
./canvas_browser.sh cookies # 提取 Cookie
./canvas_browser.sh stop # 关闭浏览器
WSLg 方案优势:
- ✅ 绕过 Windows DPAPI 加密限制
- ✅ 直接在 WSL 环境中操作
- ✅ 可使用 Chrome DevTools Protocol (CDP) 自动化
注意事项:
- 需要在 WSLg 窗口中手动登录 SSO
- Cookie 会过期,需定期重新获取
- 确保安装了
chromium-browser和jq
2. 生成学习笔记
# 创建学习笔记
cat > lecture_notes.md << 'EOF'
# Course Lecture X - Topic Name
## 核心概念
### 定义
...
### 性质
...
## 例题
...
EOF
# 转换为 PDF
./scripts/md2pdf.sh lecture_notes.md lecture_notes.pdf
3. 生成 Mock Test
# 使用模板创建 Mock Test
cp templates/mock_test.md course_mock_test.md
# 编辑题目...
# 生成 PDF
./scripts/md2pdf.sh course_mock_test.md course_mock_test.pdf
🔑 Canvas API 端点
公告
curl -b "$CANVAS_COOKIE" \
"https://<your-institution>.instructure.com/api/v1/announcements?context_codes[]=course_<COURSE_ID>"
作业
curl -b "$CANVAS_COOKIE" \
"https://<your-institution>.instructure.com/api/v1/courses/<COURSE_ID>/assignments?per_page=50"
文件
curl -b "$CANVAS_COOKIE" \
"https://<your-institution>.instructure.com/api/v1/courses/<COURSE_ID>/files?per_page=100"
注意:
- RSS Feed 可能已失效,建议使用 API
- Cookie 认证(学校通常禁用 API Token)
- Cookie 会过期,需定期更新
📄 PDF 生成配置
中文字体支持
使用 cjk_header.tex 配置:
\usepackage{xeCJK}
\setCJKmainfont{Droid Sans Fallback}
\usepackage{amsmath}
\usepackage{textcomp}
\usepackage{enumitem}
数学公式
- 行内公式:
$...$ - 显示公式:
$$...$$
Emoji 处理
Linux 系统 emoji 可能乱码,建议替换为文本:
- ✅ →
[Correct] - ❌ →
[Wrong] - 📚 →
Book
🗂️ 文件管理策略
OneDrive 课程目录
/mnt/c/Users/<USER>/OneDrive - <INSTITUTION>/Classes/
├── <COURSE_CODE> <COURSE_NAME>/
│ ├── materials/ # Canvas 下载的资料
│ ├── study_notes/ # 生成的学习笔记
│ └── submissions/ # 已提交作业
工作流程
- 生成 → 在 workspace 创建编辑
- 保存 → 复制到 OneDrive
study_notes/ - 发送 → 需要时复制发送
- 清理 → 删除临时文件
🛠️ 脚本说明
check_canvas.sh
检查 Canvas 课程更新:
- 公告(过去 14 天)
- 作业(未来 14 天 + 过去 5 天)
- 文件同步
依赖: curl, python3, jq
md2pdf.sh
Markdown 转 PDF(CJK 支持):
- 自动处理 emoji
- 粗体后添加空行(修复列表渲染)
- 中文字体配置
依赖: pandoc, texlive-xetex, texlive-xecjk
用法:
./md2pdf.sh input.md output.pdf
organize_files.sh
整理课程文件:
- 合并重复目录
- 清理临时文件
- 验证文件完整性
📝 模板
学习笔记模板
# Course Lecture X - Topic Name
**Course:** Course Name
**Instructor:** Instructor Name
**Date:** YYYY-MM-DD
---
## 🎯 核心问题
这节课要解决什么问题?
---
## 📖 主要内容
### 定义
...
### 性质
| 性质 | 公式 | 含义 |
|------|------|------|
| ... | ... | ... |
---
## 📝 例题
...
---
## 🔑 知识总结
...
Mock Test 模板
# Course Lecture X - In-Class Test
**Course:** Course Name
**Time limit:** 25 minutes
**Total points:** 100 points
---
## Instructions
- This test consists of **6 proof-based questions**
- Show **all steps** of your proofs
- Full credit requires **complete justification**
---
## Question 1: Topic (XX points)
...
---
# Solutions & Grading Rubric
...
⚠️ 注意事项
隐私保护
- 不要 在 skill 中存储 Cookie、Token
- 不要 提交学生姓名、学号
- 不要 泄露成绩、个人信息
Cookie 安全
- Cookie 存储在
~/.canvas_cookie(gitignore) - 定期更新 Cookie(过期后手动复制)
- 不要分享 Cookie 文件
PDF 渲染
- 中文需要 xeCJK + Droid Sans Fallback
- Emoji 在 Linux 可能乱码,建议替换
- 数学公式用
$...$或$$...$$
🔄 更新日志
v1.0.0 (2026-03-02)
- 初始版本
- Canvas API 检查脚本
- Markdown 转 PDF(CJK 支持)
- 学习笔记和 Mock Test 模板
- 文件管理策略
📞 支持
Issues: https://github.com/<repo>/issues
Discussions: https://github.com/<repo>/discussions
📄 License
MIT License