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.shCookie 获取方法（方案 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.pdf3. 生成 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.pdforganize_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