Autopku

AutoPku

自动处理北京大学课程相关任务：同步通知、完成作业、撰写笔记。

配置说明

本地配置（推荐）

文件位置: .claude/settings.local.json（项目根目录）

{
  "permissions": {
    "allow": ["Skill(update-config)", "Bash(*)"],
    "deny": ["Bash(rm:*)", "Bash(rm -rf:*)"],
    "defaultMode": "bypassPermissions"
  },
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
    "USER_TYPE": "ant"
  }
}

本地配置仅在本项目目录生效，不会影响其他目录的 Claude Code 行为。

Kimi Code CLI 用户: 建议设置环境变量 KIMI_CODE_CLI=1 以启用 Kimi Agent Team 支持（或通过 which kimi 自动检测）。

全局配置（可选）

文件位置: ~/.claude/settings.json

内容同上。全局配置会在所有目录生效，每次打开 Claude Code 都会显示 bypass 模式警告。除非你只在本机使用 AutoPku，否则不推荐。

配置项说明

使用方式

直接告诉我要做什么：

执行架构

1. 环境检测

执行时自动检测运行环境：

import os
import shutil

if os.environ.get("CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS"):
    RUNTIME = "claude"      # 使用 Agent() tool + SendMessage()
elif os.environ.get("CODEX") == "1":
    RUNTIME = "codex"       # 使用 native subagents
elif os.environ.get("KIMI_CODE_CLI") == "1" or os.environ.get("KIMI") == "1" or shutil.which("kimi"):
    RUNTIME = "kimi"        # 使用 Kimi Agent() + TaskList/TaskOutput
else:
    RUNTIME = "serial"      # 串行执行

2. 任务路由

根据用户意图，引用对应的 task skill：

用户: "同步课程通知"
  ↓
引用: sub-skills/tasks/sync-notices.md
  ↓
执行同步流程

用户: "完成作业"
  ↓
引用: sub-skills/tasks/do-homework.md
  ↓
执行作业流程（含用户确认）

用户: "写笔记"
  ↓
引用: sub-skills/tasks/write-notes.md
  ↓
执行笔记撰写流程

用户: "写论文" / "生成课程论文"
  ↓
  引用: sub-skills/tasks/write-paper.md
  ↓
执行论文生成流程（大纲→正文→渲染→询问）

用户: "制作幻灯片" / "生成汇报PPT"
  ↓
  引用: sub-skills/tasks/make-slides.md
  ↓
执行幻灯片生成流程（提取→大纲→生成→渲染→询问）

3. Agent 创建

主 skill 根据 RUNTIME 创建 agents：

# Claude Code 环境
for config in agent_configs:
    Agent({
        "name": config["name"],
        "prompt": config["task"],
        "description": config.get("description", "")
    })

# Kimi Code CLI 环境
for config in agent_configs:
    Agent({
        "description": config.get("description", ""),
        "prompt": config["task"],
        "subagent_type": config.get("subagent_type", "coder")
    })

# Codex 环境
# 使用自然语言描述并行 subagent 任务

# 其他环境
# 串行执行

核心依赖: pku3b

安装

# 检查是否已安装
which pku3b 2>/dev/null || echo "NOT_FOUND"

# 未安装时执行（macOS Apple Silicon 示例）
cd /tmp
curl -LO "https://github.com/sshwy/pku3b/releases/download/0.11.0/pku3b-0.11.0-aarch64-apple-darwin.tar.gz"
tar -xzf pku3b-0.11.0-aarch64-apple-arm64.tar.gz
chmod +x pku3b-0.11.0-aarch64-apple-darwin/pku3b
ln -sf pku3b-0.11.0-aarch64-apple-darwin/pku3b pku3b
./pku3b --version

重要:

• 正确仓库: sshwy/pku3b (原 yang-er/pku3b 已失效)
• 推荐版本: v0.11.0+ (支持公告 ann 和课表 ct 功能)

登录

expect脚本只在初始化执行一次。后续所有命令自动读取 cfg.toml 中的凭证。

步骤：

# 1. 检查是否已登录
/tmp/pku3b a ls 2>&1 || echo "NOT_LOGGED_IN"

如果已登录（正常返回作业列表），跳过步骤 2-4，直接进入任务。

如果返回 NOT_LOGGED_IN（凭证不存在或密码错误），执行步骤 2：

# 2. 使用 expect 脚本登录（TTY-safe）
cat > /tmp/pku3b_login.exp << 'EOF'
#!/usr/bin/expect -f
set timeout 30
spawn /tmp/pku3b init
expect "username:"
send "学号\r"
expect "password:"
send "密码\r"
expect eof
EOF
chmod +x /tmp/pku3b_login.exp
/tmp/pku3b_login.exp

# 3. 验证登录成功
/tmp/pku3b a ls

# 4. 立即覆写 expect 脚本，清除明文密码
echo "" > /tmp/pku3b_login.exp

踩坑: 直接管道输入会报错 "input device is not a TTY"，必须使用 expect。

常用命令

# 作业
/tmp/pku3b a ls --all-term              # 所有学期作业（带ANSI颜色码）
/tmp/pku3b a download <ID> -d <dir>     # 下载附件
/tmp/pku3b a submit <ID> <file>         # 提交作业

# 公告 (v0.11.0+)
/tmp/pku3b ann ls                       # 列出公告
/tmp/pku3b ann show <ID>                # 查看公告详情

# 课表 (v0.11.0+)
/tmp/pku3b ct -r                        # 获取课表 JSON

# 选课
/tmp/pku3b s -d major show              # 主修课程（可能返回302，作为可选）

Task Skills 索引

Tool Skills 索引

Runtime Skills 索引

关键踩坑记录

1. 课程筛选遗漏

问题: 选课系统显示"未选上"但作业系统有记录（如"学术英语写作"）。

解决: 从作业系统提取所有课程，对比选课系统，标注不一致状态。

2. 附件下载问题

检查: grep "课程名" /tmp/pku_assignments_raw.txt | grep "附件"

3. 数据格式问题

• 无 --json 参数: pku3b 输出纯文本带ANSI颜色码，需正则解析
• pku3b a ls -a 不完整: 只显示有作业的课程，需用 pku3b s show 补全
• --all-term 返回所有历史学期: 需筛选当前学期

4. 用户确认（重要）

完成作业前必须:

1. 列出所有待交作业
2. 使用 AskUserQuestion 让用户选择
3. 二次确认后才创建 Agent Team
4. 渲染完成后询问是否提交

禁止: 自动选择最新作业、未经确认直接提交

输出规范

同步通知输出

test/
├── 通知摘要汇总.md
├── {course1}/
│   ├── 作业/           # 下载的附件
│   ├── 通知/           # 公告详情
│   ├── 资料/           # 课程资料
│   └── 通知摘要.md     # 该课程摘要
└── {course2}/
    └── ...

完成作业输出

{course}/
├── 作业/
│   ├── Homework202605.pdf          # 原题
│   ├── homework_parsed.json        # 解析结果
│   ├── answers.json                # 解答数据
│   ├── Homework202605_answer.md    # Markdown答案
│   └── Homework202605_answer.pdf   # PDF答案
└── 提交/                           # 最终提交文件
    └── Homework202605_answer.pdf

生成幻灯片输出

{course}/
└── slides/
    ├── main.typ              # Typst 源文件
    ├── slides.pdf            # 最终 PDF
    ├── outline.md            # 幻灯片大纲
    └── figures/              # 图片目录
        └── ...

安全规则

• 从不回显密码到日志
• 不自动提交作业（必须用户确认）
• 不自动选择作业（必须用户选择）
• 安全处理课程名中的特殊字符

参考

• 原完整 skill 备份: archive/archived-skill.md
• pku3b 仓库: https://github.com/sshwy/pku3b

Source: ICUlizhi/AutoPku — distributed by TomeVault.