常见问题

这里整理了使用 AutoPku 过程中最常遇到的问题。如果仍未解决，请查阅 一起共建 或提交 Issue。

平台与兼容性

Q1：支持哪些 AI 平台？

目前正式支持三大运行时：Claude Code、Codex（GitHub Copilot CLI）、Kimi Code CLI。它们都支持自然语言指令与本地文件系统操作，是驱动 AutoPku Agent Team 的理想载体。

理论上，任何支持工具调用（Tool Use）且能访问本地目录的 AI 运行时都可以接入，但上述三个平台经过充分测试。

作业与安全

Q2：作业会被自动提交吗？

不会。 AutoPku 在作业解答完成后会强制暂停，等待你审阅生成的 PDF。只有你明确回复 "确认提交" 或类似指令后，AI 才会执行最终的上传操作。

这是系统的核心安全设计，旨在避免未经审核的内容被提交到教学网。

Q3：密码安全吗？

你的教学网密码仅在本地使用，用于 pku3b 的首次登录与 Cookie 刷新。密码不会被上传到任何第三方 AI 服务或远程服务器。

建议将登录脚本设置为 chmod 600 权限，并避免将密码明文提交到 Git 仓库。

依赖与工具

Q4：为什么需要 pku3b？

pku3b 是连接北京大学教学网（基于 Blackboard 平台）的核心命令行工具。AutoPku 通过它完成：

  • 教学网身份认证与会话保持
  • 课程列表与通知页面的爬取
  • 作业附件的下载与提交

没有 pku3b，AutoPku 无法与教学网进行任何数据交互。

功能范围

Q5：支持哪些作业类型？

当前版本主要针对以下类型优化：

  • PDF 文档类作业：解析题目 → 生成解答 PDF → 上传
  • 文本类作业：直接生成答案文本并粘贴到提交框

对于需要在线答题（如选择题系统）、编程 OJ、或实物实验报告的作业，AutoPku 可能只能完成部分辅助工作（如生成报告草稿），无法全自动提交。

Q6：笔记生成支持图片吗？

当前版本的 NoteAgent 主要提取课件中的文本与公式，将其转为 Markdown + LaTeX。对于课件中的插图、示意图，会尝试用图片描述文字记录，但不会自动提取原图嵌入笔记。

如果课件图片对理解至关重要，建议手动补充截图到生成的笔记中。

Q7：如何处理没有附件的作业？

部分老师直接在通知正文中布置作业，不附 PDF。此时 AutoPku 会：

  1. 提取通知正文作为题目来源
  2. 尝试解析其中的题目描述与要求
  3. 生成解答文档并等待确认

如果正文描述过于模糊，AI 会向你询问补充信息。

异常处理

Q8：课程筛选遗漏怎么办？

AutoPku 默认同步教学网课程列表中的所有课程。如果你发现某门课程没有被同步，可能的原因包括：

  • 该课程在教学网中处于 "隐藏" 或 "未完成注册" 状态
  • 学期切换后 Cookie 过期，导致拉取到旧学期数据
  • 课程名称包含特殊字符，被过滤规则误排除

解决方法：先运行 pku3b courses 手动检查课程列表。如果课程确实存在但 AutoPku 未抓取，请检查同步日志 courses/sync_log.md 中的错误信息。

💡 更多帮助

如果以上问题未能解决你的疑惑，欢迎查看 一起共建 了解系统内部机制，或直接向 AI 运行时提问："AutoPku 怎么……"，Agent Team 会尝试根据当前上下文给出针对性解答。