canvas-study-helper

// **Version:** 1.1.0

$ git log --oneline --stat

stars:1,933

forks:367

updated:March 4, 2026

SKILL.mdreadonly

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