CSP C++ Courseware

面向零基础学习者、以 CSP-J 入门到提高 为验收目标的 C++ 交互式课程项目。项目将长期学习路线拆成 5 个递进阶段、40 节课程；每一课都包含学习目标、具体内容、检验清单和练习建议。

课程强调“先把程序写对，再把题目做对”。CSP-J 是明确边界；CSP-S/NOI 的内容只在最后一课说明衔接方向，不作为本项目的承诺范围。

当前课程原型

仓库根目录的 index.html 是无需构建的课程路线原型。它当前提供：

• 五阶段课程路径与阶段切换；
• 40 节课件的学习目标、讲授内容、检验清单和练习建议；
• 本地保存的逐项学习进度，不收集账号或个人信息；
• 适合外部录课制作时使用的“视频组织建议”和移动端阅读布局。

它目前用于确认课程规划，不代表每节课的在线学习页、视频和测验已经完成。后续交付范围与验收标准见 docs/roadmap.md。

本地预览使用 Bun：

bun run dev

打开 http://localhost:4173。

课件目录

每节课都有自己的目录：lessons/<小写课程-id>/。全部 40 个目录及其 lesson.json 已由 Bun 脚手架建立；目前可体验的互动课件是：

lessons/s1-01/
├── index.html   # 引导式互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现
lessons/s1-02/
├── index.html   # 变量与数据类型的互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现
lessons/s1-03/
├── index.html   # 表达式、整除、取模与括号的互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现
lessons/s1-04/
├── index.html   # 输入输出格式的互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现
lessons/s1-05/
├── index.html   # 条件判断的互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现
lessons/s1-06/
├── index.html   # 循环、累加与死循环对照的互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现
lessons/s1-07/
├── index.html   # 嵌套循环、行列职责与 break 对照的互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现
lessons/s1-08/
├── index.html   # 三类错误、语法定位与小数据检查的互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现
lessons/s2-01/
├── index.html   # 数组声明、下标 0 到 n-1 与越界对照的互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现
lessons/s2-02/
├── index.html   # 字符与字符串区分、下标遍历与数字判断的互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现
lessons/s2-03/
├── index.html   # 函数定义、参数返回值与闰年抽取的互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现
lessons/s2-04/
├── index.html   # 局部变量、值传递与引用对照的互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现
lessons/s2-05/
├── index.html   # 结构体记录卡、成员访问与按字段比较的互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现
lessons/s2-06/
├── index.html   # 冒泡思想、相邻交换、sort 与稳定性对照的互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现
lessons/s2-07/
├── index.html   # 枚举范围、状态更新、漏分支对照的互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现
lessons/s2-08/
├── index.html   # 操作次数、O(n)/O(n²) 直觉与测试点对照的互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现
lessons/s3-01/
├── index.html   # 数位拆分、辗转相除与循环停止对照的互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现
lessons/s3-02/
├── index.html   # 递归边界、三层调用追踪与阶乘对照的互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现
lessons/s3-03/
├── index.html   # 有序前提、左右边界收缩与首尾/死循环对照的互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现
lessons/s3-04/
├── index.html   # 前缀和定义、区间公式与 l=1/下标偏移对照的互动学习与随机选择题小测
└── lesson.json  # 本课的交付状态；视频明确为仓库外实现

启动 bun run dev 后，打开 http://localhost:4173/lessons/s1-01/、http://localhost:4173/lessons/s1-02/、http://localhost:4173/lessons/s1-03/、http://localhost:4173/lessons/s1-04/、http://localhost:4173/lessons/s1-05/、http://localhost:4173/lessons/s1-06/、http://localhost:4173/lessons/s1-07/、http://localhost:4173/lessons/s1-08/、http://localhost:4173/lessons/s2-01/、http://localhost:4173/lessons/s2-02/、http://localhost:4173/lessons/s2-03/、http://localhost:4173/lessons/s2-04/、http://localhost:4173/lessons/s2-05/、http://localhost:4173/lessons/s2-06/、http://localhost:4173/lessons/s2-07/、http://localhost:4173/lessons/s2-08/、http://localhost:4173/lessons/s3-01/、http://localhost:4173/lessons/s3-02/、http://localhost:4173/lessons/s3-03/ 或 http://localhost:4173/lessons/s3-04/。其余课程目录目前只保留元数据，尚未实现页面。

课件里的陌生词（例如 g++）可点开 glossary/faq.json 中的基础解释。后续课件出现同类概念时，也必须引用同一份词条表。

五阶段课程路线

阶段	主题	课件数	关键结果
第一阶段	建立程序感	8	能独立编译、读写、判断、循环并排错
第二阶段	写得正确	8	能用数组、字符串、函数和结构体组织程序
第三阶段	算法思维入门	8	能把常见题意转成枚举、搜索、前缀和、贪心或 DP
第四阶段	CSP-J 专项	8	能在题面、复杂度、实现和调试之间形成稳定闭环
第五阶段	赛场整合	8	能完成限时模拟、复盘并以 CSP-J 提高为目标参赛

完整课程目录见 docs/course-plan.md。

后续课程形态

每一节课程最终都应成为一个独立、可在线学习的单元，包含：

• 与本课目标对应的网页互动学习界面；
• 可重复参加的在线测试，从经审校题库中随机组卷，并以选择题为主；
• 作答结果、解析和下一步复习建议。

每节课还有对应的视频课件，但视频由仓库外的制作流程实现和交付；本仓库不制作、存储或渲染视频资产，只维护课程 ID、目标与外部视频交付的对齐约定。

“随机”只指从经过验证的题库中进行可复现的抽取，不能用未校验的临时生成内容替代题目质量。具体边界见 AGENTS.md 与路线图。

文档

• docs/roadmap.md：项目画像、边界、方向与业务能力验收矩阵
• docs/feature-checklist.md：功能清单与交付状态
• docs/course-plan.md：40 节视频课件的内容规划
• tests/e2e/manual-checklist.md：无依赖的手工端到端验收脚本
• AGENTS.md：内容、交互和验收规约

质量与验收

所有一级用户能力都必须遵守 docs/roadmap.md#验收矩阵业务能力覆盖矩阵 中的覆盖底线：新增能力要同步更新矩阵并提供 Happy Path 验证；涉及状态或权限时，还必须验证失败路径及恢复行为。

课程内容结构可通过下列命令校验，无需安装依赖：

bun test