救驾（jiujiastudy）是留学生的 Canvas / Moodle 学习手帐：盯 deadline、排本周该学什么、按状态给建议。
用户提到课程、作业、deadline、考试、Canvas、Moodle、老师，或说「现在什么情况」「最近要交什么」「这周学什么」「做完了」「没状态 / 累 / 来不及」「交之前检查」「想问老师」「做学习页」「一直在拖 / 开不了头」时使用；第一次用时自己完成设置，只向用户要学校网址（Canvas 另要 token）。
The English summary is being prepared. Showing the original description.
Run score Not tested
See how to installReview the instructions the agent will receive before you install.
脚本在本文件同目录的 tools/coach.py。宿主给了本文件路径就直接用；没给就先找你这个宿主自己的文件夹：Claude Code 找 ~/.claude/skills/jiujiastudy，Codex 依次找 ~/.codex/skills/jiujiastudy、~/.agents/skills/jiujiastudy；都没有再找另一个宿主的。解释器优先用宿主已经提供的 Python；Codex 桌面版先调用 load_workspace_dependencies 取得 Python executable，再试 python3 / python / Windows py -3。已有任何可用解释器就不安装；全部不可用才征得用户同意安装。下文只写命令名。用用户说话的语言回答，默认中文。你在这个环境里运行不了命令（比如聊天网页），就直接告诉用户换成 Claude Code 或 Codex，不要自己去网页上手翻、手写周报。
两个地方。资料夹给人看：默认桌面的「救驾」，paths 打印具体路径；根目录是「本周清单.html」和「Deadline雷达.html」，每门课一个文件夹，里面只有两个子文件夹，「课件」放原件，「产出」放 AI 做的一切。机器档案给 AI 用：config.json（学校、时区、课程）、state.json（进度、待确认、心情、手动 deadline）、raw/、plans/、reports/、text/（课件文字稿，默认不提取），在资料夹里的 .coach（老版档案仍兼容 ~/CourseCoach），用户不用管。时间照脚本写的说（已经是用户那边的时间），不用解释时区。
第一优先永远是准确的 deadline 和这周的清单。课件只排队、后台补，任何时候都不让用户等下载。
status / radar / study / record done / record mood 打印的那句，可以换成用户的口吻，不加新判断（细则 references/state.md）。--confirmed 跑 api post / api upload 拿预览，原样给用户看；用户说「发」再加 --confirmed，脚本会弹系统确认窗口，用户本人点「确定」才真的发。窗口弹不出就不发，把链接给用户自己交。collect --force 重新核对（不吃 10 分钟缓存），哪怕几分钟前刚采过。脚本打印了采集错误或「没采到」的课，就照它的原话点名说哪门课、数据是几点的，再给清单；不许默默拿旧快照当最新的。每份清单末尾写一句数据截至时间。给别人看的清单同样照这条做。周报和雷达只交脚本生成的页面（资料夹根目录的「本周清单.html」「Deadline雷达.html」），不自己另写一份；脚本跑不起来就照实说卡在哪一步。用户说「帮我从 GitHub 安装 jiujiastudy」这类话：装好（SKILL.md 直接在 skills/jiujiastudy/ 下）不要停，也不用重启，在同一个对话里接着走下面的流程，一直做到把本周清单交到用户手上。更新时旧版备份放到 skills 文件夹外面（比如「文档」），放在 skills 里会被当成第二个技能加载。
动手之前先跟用户说两件事（原话在 references/setup.md）：①输入框左下角的权限设置，Claude Code 选「Auto」、Codex 选「帮我批准」，能省掉很多次点「允许」；顺带一句「想让周报和学习页讲得更细，建议把 AI 的努力程度调到 Extra high（xhigh）或更高，会慢一点、多用一些额度」（只说「更细」，不说「更完整」）——只提醒，不替他改；②接下来要做什么、大概多久，中途不懂直接问你。之后每一步动手前说一句要做什么、要等多久。
status 报「还没有档案」→ 按 references/setup.md 走：确认有可用 Python（宿主内置优先，不重复安装）→ doctor --detect-site（浏览器记录里认 Canvas 域名）→ 打印了「config.json：已新建」就直接往下；否则一次只问一件事：先确认学校网址（认出来了就问对不对；没认出就要他平时交作业那个网站随便一页的网址，是 Canvas 还是 Moodle 你来认），确认是 Canvas 再教他拿 token（发来就 token set 存好），是 Moodle 就 login；再跑 doctor → collect --touch（只记元数据，十几秒；失败不进入缓存）→ radar --write → 模块没按周分的课先读一遍课程说明（outline，见 setup.md 第 5 步）→ study --write --open（写完直接帮他打开，资料夹在桌面上就再放一个「本周清单」快捷方式）→ collect --download --background（课件后台补；同一档案最多一个 worker，命令立刻返回）→ 一条消息：连上了哪个站、最急的一条和第一步、本周最要紧的一件、本周清单已经打开了、以后双击桌面上的「本周清单」就能看、做完一项打勾后要回来说「做完了」、资料夹里的「我能帮你做什么」列着能说的话、状态一句、只推荐一门学习页（原话在 setup.md，study 的 learn.suggest 挑哪门），最后给用户接下来能说的话（「这周学什么」「最近要交什么」「做完了」「帮我导读这周的课件」）和「不知道怎么办直接问我」。doctor 列的「你需要做的事」：自己能做的（--fix-perms）做掉，其余最多一句带给用户。网络和权限已就绪时通常一分钟内出首份雷达和清单；首次权限审批或装依赖的时间另算。
脚本退出码：0 成功；1 = 有提醒，不是失败，照输出里列的事做；2 = 卡住了，输出只有一句原因；3 = 档案版本太老，先跑 migrate。
| 用户说 | 做 | 读 |
|---|---|---|
| 学生打 /jiujiastudy（后面没话） | 先说一句「在更新数据，大约半分钟」→ collect --force --touch（每次都重新采，信息齐全优先）→ status 说本周没有计划：study --write --open --zh plans/<周>.zh.json（覆盖层没有就先写）；有了：同样带覆盖层 study --write 重做，collect 报了新作业、新公告或日期变了才加 --open，并说一句变了什么，没变就不打开 → 回 status 那一屏（今天必做、每门课下一条、状态一句）和两三句能说的话；这周还没有学习页就推荐一门：「打 /jj-learn 就做」→ 课件没下完 collect --download --background；「还差 N 件」答完在后台补 | study.md |
| 任何话（会话开始） | status；要看新数据先 collect --touch（10 分钟内采过它会直接用上次的）；status 说有课件待下载就 collect --download --background，不等它；status 或 study 末尾有「还差 N 件」（给 AI 的）：先回答学生，回答完再照着补（能放后台就放后台），补到新作业、新截止或周报要改的再说一句；不跟学生说「还差」 | — |
| 「现在什么情况」 | status 一屏：今天必做、每门课下一条、状态一句 | — |
| 「最近要交什么」 | collect --touch → radar --write；复述每门课下一条、最急一条和第一步、撞车、待确认里今天要定的；不整表贴 | radar.md |
| 「这周学什么」「这周干什么」「周报」 | collect --force --touch → study --write --open --zh plans/<周>.zh.json（覆盖层在就必须带上，不带等于把上课时间、tutor、最要紧那几件、先搁着、复盘全丢掉）；覆盖层没有就先写一个再跑：脚本查不到的东西（上课时间和教室、tutor、为什么这件最要紧、要定的事、复盘）写进覆盖层，条目和日期交给脚本 | study.md |
| 「做完了」「做完了 2001-2」「✓ 09-16」「2001 看完了」 | record done <目标>，回它打印的「✅ …，明天：…」和状态一句 | study.md |
| 「没状态」「累」「来不及」「病了」 | record mood <词>，按它返回的建议说，别追问 | state.md |
| 「这个日期只是占位」「老师说 X 号交」「公告说考试在 X」 | record note <作业id> "…"（Canvas 日期不算数，不再算过期）/ record deadline "事项" --course 课 --due 日期 --time 时刻 --weight 权重 --url 作业链接（进雷达；--due 认 2026-09-20 / 09-20，--time 认 23:59 / 4pm，认不出当场退回；--list 看、--remove 序号 删） | radar.md |
| 「这周是第 N 周」「X 不是课」「这门课周二上」「时间按 X 显示」 | config set term.week1_monday … / 改 courses / config set user_tz Asia/Shanghai（auto = 跟着电脑） | setup.md |
| 「资料放哪」「换个文件夹」 | paths 报路径；换地方：config set root <路径> 再 doctor，它会把旧文件搬过去 | setup.md |
| 「这门课还用 Ed / Padlet / 别的网站」；「还差 N 件」里列了外部平台 | external 课 看保底清单，公告和课程页面里提到的也找全；browse 网址 --course 课 只读打开（被带去登录页：问学生一句，同意就加 --sign-in 弹窗让学生自己登一次，以后不用再登）；读到的截止 record deadline … --source "Ed（AI 读到的）"；碰到人机验证就停；跟学生只说做了什么、情况是什么，不说「看不到」「你去看」 | learn.md |
「做 X 这周的学习页」「更新 X 学习页」；第一次推荐后学生说「好」；学生打 /jj-learn（不说哪门就照 study --json 的 learn.order 全做，最急的先，每门都按完整标准，开始前说一句做哪几门、大概多久） | learn prep 课（要学习页就是同意读这门课的课件，它直接打开，不再问）→ 照 learn.md 找资料、做页面、写清单 → learn check 课 → 刷新周报（study --write --zh …） | learn.md |
| 学生打 /humanizer，或说「改得像人写的」「去 AI 味」 | 照 humanizer 的说明原样做（主文件夹旁边的 humanizer 技能；没加载就读主文件夹的 skills/humanizer/SKILL.md）：标出 AI 腔 → 改一稿 → 自查 → 在对话里给最终版；意思、数字、引用不改，缺细节就问，不编；不做网页 | skills/humanizer/SKILL.md |
| 「这个作业到底要求什么」「草稿帮我对着评分标准看看」「帮我给老师写封信」「开不了头」 | 直接做，不套固定流程：作业要求读作业页和评分标准全文（Canvas 用 api get，Moodle 用 browse，Moodle 上去哪读见 moodle.md），课程页面、课程说明、公告里提到它的也找全，以 Canvas 为准，说法打架的写出来；草稿按评分标准一项项看，说哪一段还差什么；信给英文稿和中文意思，学生自己发；开不了头就把最急的那件拆成一小步 | — |
| 导读课件、复习包、逐页精讲、做图、写东西、发帖、交作业、任何想法 | 直接做：先 paths 课 拿路径；课件原件在「课件」；课件文字默认不提取给 AI；学生要的东西得读课件（导读、复习包、逐页精讲），就当同意，直接开 config course <课程代码> --materials-ai on（学生明说过不读的除外），开了才有 text/<课>/；某周课件还没下就 collect --materials 课 周；产物一律写进「产出」；做页面先读 references/style.md；发帖交作业按规矩 5 | toolbox.md |
脚本出错时会连「该怎么办」一起打印：照它那句做，做得了就做掉，别复述。下面几种它给不出办法：
| 情况 | 做 |
|---|---|
| 没有可调用的 Python | 先用宿主公开的 Python（Codex：load_workspace_dependencies）并查 python3 / python / Windows py -3；确认全不可用，再征得用户同意按平台安装。不要把 xcode-select --install 当 Python 安装器 |
| 用户在对话里发来 token | token set 存好，token 从标准输入传（Bash <<'EOF'，PowerShell 管道），不进命令参数；回复里不重复 token，说「存好了」 |
| 学校不让生成 token，或学校用的是 Moodle | login（Moodle 不要 token），用户在弹出的窗口里自己登录；照它打印的往下做 |
| 「更新救驾」；学生打 /jj-update | update：GitHub 上有新版就换上（Claude Code、Codex 装着的几份一起换，新的 /jj 口令装上、下架的删掉）；只跟学生说它打印的「这次更新的新内容」和「新口令」，已经是最新就说一句 |
用户说没看到登录窗口，或 login 报这里弹不出窗口 | 先让他看任务栏；还没有，就按宿主的办法申请在沙盒外重跑 login（Codex：申请提升权限）。不要改用宿主自带的浏览器让他登录：救驾读不到那里的登录，他会白登一次 |
| 一步被宿主的自动模式拦下（比如「刚下载的代码」） | 让用户把输入框左下角的权限设置临时换成「每次询问」，回你「继续」；这一步跑完再换回 Auto /「帮我批准」 |
| doctor 报 skills 里有重复的救驾 | 跟用户说一句，把那份挪出 skills 文件夹（比如挪到「文档」），别删 |
| 认不出学校 / 有几个候选 | 让用户发平时交作业那个网站随便一页的网址，或者选一个，doctor --host 网址。探测不发 token |
| 浏览器记录读不了 / 被沙盒隐藏 | 按宿主机制申请一次只读权限；仍读不了就直接要网址 |
| 连不上 / 5xx | 脚本已重试；用上次快照回答，并写明「数据截至 X」，哪门课没采到点名说 |
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Rewrite AI-sounding text so it reads like the writer without changing what it says. Use when editing or reviewing prose for AI tells: not-X-but-Y contrasts, one-line closers, staged openers, forced triads, dashes everywhere, inflated claims, sales language, stock AI words, bold labels, or filler. Based on Wikipedia's "Signs of AI writing."
The English summary is being prepared. Showing the original description.
本周学习页：把每门课这周要学的讲透，英文配中文，带自测题；不说哪门就全做，最急的先做
The English summary is being prepared. Showing the original description.
更新救驾到最新版：主程序和新功能一起装好，只说这次更新了什么新内容
The English summary is being prepared. Showing the original description.