Canvas Study Helper

Canvas Study Helper Skill

Version: 1.1.0 Author: CanvasClaw Description: Canvas LMS 课程监控与学习笔记生成工具，支持公告检查、作业跟踪、PDF 学习笔记生成（CJK 支持）

---

🎯 功能

1. Canvas 课程监控 - 检查课程公告（Announcements） - 跟踪作业截止日期（Assignments） - 下载课程文件（Files）

2. 学习笔记生成 - Markdown 格式学习笔记 - PDF 导出（支持中文、LaTeX 数学公式） - Mock Test 生成（证明题专项）

3. 文件管理 - 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  ~/.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）： 1. 登录 Canvas 2. 按 F12 打开 DevTools 3. 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 |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://.instructure.com/api/v1/announcements?context_codes[]=course_"

作业

curl -b "$CANVAS_COOKIE" \
  "https://.instructure.com/api/v1/courses//assignments?per_page=50"

文件

curl -b "$CANVAS_COOKIE" \
  "https://.instructure.com/api/v1/courses//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//OneDrive - /Classes/
├──  /
│   ├── materials/        # Canvas 下载的资料
│   ├── study_notes/      # 生成的学习笔记
│   └── submissions/      # 已提交作业

工作流程

1. 生成 → 在 workspace 创建编辑 2. 保存 → 复制到 OneDrive study_notes/ 3. 发送 → 需要时复制发送 4. 清理 → 删除临时文件

---

🛠️ 脚本说明

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//issues Discussions: https://github.com//discussions

---

📄 License

MIT License