csp/docs/知识库重塑与游戏化规划.md

知识库重塑与游戏化规划（CSP 平台）

1. 重塑目标

• 建立“可学习、可打卡、可成长”的知识库系统，不再只是文章列表。
• 形成四条核心技能线：
  • C++14 技能树（竞赛编码主线）
  • GitHub 协作技能树（团队工程主线）
  • Linux 服务器技能树（部署运维主线）
  • 计算机基础技能树（底层认知主线）
• 将“知识点学习”直接转化为积分成长，形成闭环：学习 -> 打卡 -> 得分 -> 排行与成长反馈。

2. 内容架构

2.1 主线知识文章（已落地）

• cpp14-skill-tree
• github-collaboration-basics
• linux-server-basics
• computer-fundamentals-for-oi

2.2 每篇文章的知识点模型

• 每篇文章附带一组 skill_points：
  • key: 唯一知识点 ID
  • title: 知识点标题
  • description: 可执行的学习目标
  • difficulty: bronze/silver/gold
  • reward: 领取奖励分值

2.3 文章与题目联动

• 保留 kb_article_links，把知识点和题目联起来。
• 在 KB 列表中提供“做相关任务”跳转到题库搜索。

3. 游戏化机制

3.1 积分获取

• 用户可对每个知识点打卡领取奖励。
• 领取规则：user + article + knowledge_key 唯一，不可重复刷分。
• 奖励实时写入用户 rating。

3.2 数据表设计

• 新增表：kb_knowledge_claims
  • user_id
  • article_id
  • knowledge_key
  • reward
  • created_at
  • 唯一约束：UNIQUE(user_id, article_id, knowledge_key)

3.3 成长展示

• 文章详情页展示：
  • 技能点清单
  • 已领取数量
  • 已领取总积分
  • 单点“领取奖励”按钮与状态
• 积分流水新增 kb_skill 类型，进入个人成长历史。

4. 交互设计

4.1 KB 列表页

• 支持关键词搜索。
• 增加快捷筛选按钮：C++14、GitHub、Linux、计算机基础。
• 分类分组：路线图、C++、CSP-J、CSP-S、GitHub、Linux、计算机基础、其他。

4.2 KB 详情页

• 文章内容区
• 技能打卡区（奖励领取）
• 关联题目区（学练结合）

5. 版本规划（建议）

Phase A（当前已实现）

• 重构四条核心文章
• 技能点打卡与积分领取
• 积分流水接入
• KB 列表筛选与分类增强

Phase B（下一步）

• 技能点前置依赖（先修解锁）
• 每周学习任务（自动生成）
• 学习路径推荐（根据已领取点与错题）
• 章节徽章（铜/银/金）

Phase C（进阶）

• 班级/战队学习排行
• 学习挑战赛（限时技能闯关）
• 知识点掌握度雷达图
• AI 学习教练（按薄弱点推送下一步）

6. 运营指标（建议）

• 日活学习人数
• 人均领取知识点数
• 文章完成率（领取数 / 可领取数）
• 学完知识后去做题转化率
• 学习后 AC 提升率

7. 风险与控制

• 风险：刷接口刷分。
  • 控制：唯一约束 + 服务端验证技能点 key。
• 风险：内容过长难消化。
  • 控制：拆分为技能点任务和周计划。
• 风险：学习与做题割裂。
  • 控制：每篇文章都提供相关题目入口。