create-ccc-tutor

一行命令装好的多科目 AI 复习助手（基于 CCC-MAGI harness）。

cd /想要安装的目录
npx create-ccc-tutor@latest

装好后在该目录打开 Claude Code（或 Codex），告诉它科目 + 问题即可：

• /slide <问题> — 只依据当前科目 course/<科目>/slide/ 里的课件回答，每条标出处、绝不编造；课件里没有时先如实告知，再问你要不要用外部知识补充（标注来源）。
• /exam <文件 + 第几题> — 在 course/<科目>/exam/ 里定位题目并解答，解题依据优先引用课件。

目录结构

course/
  <课程代码>/
    slide/   ← 课件 PDF
    exam/    ← 题目文件

course/course_code(example)/ 是带两个示例课件的样板，复制改名即可开始。

更新已安装的环境

已经装过、想升级到新版（拿到新功能/修复，如 PDF 看图与检索引擎）时，在项目目录里跑：

npx create-ccc-tutor@latest --update

--update 会更新框架、技能与功能文件，但保护你的用户数据：course/ 课件、.harness/state/install.json 配置、constitution.md 项目身份都不会被覆盖。

不加 --update 直接重装会跳过所有已存在文件（改过的技能不会更新，等于半更新）；检测到老环境时安装器会提示你改用 --update。

选项

| 选项 | 作用 | |---|---| | --dry-run | 只预览要写哪些文件，不实际写入 | | --update | 更新已装环境：覆盖框架/技能/功能，但保护 course/、install.json、constitution.md | | --force | 全量覆盖所有已存在文件（含用户配置，慎用） |

要求

• Node.js ≥ 18
• Claude Code（必需）/ Codex（可选，用其技能需先 bash .codex/install-skills.sh）
• jq、git（harness hook 依赖）

License

Apache-2.0。harness 部分版权归 CCC-MAGI 作者，详见随包的 CCC_MAGI_LICENSE。