公务员备考计划生成器
概述
此技能将一个 Python 脚本 scripts/gen_plan.py 打包为可复用能力。该脚本根据可配置的课程数据（粉笔980系统班四阶段：判断推理、言语理解、资料分析、数量关系、政治理论、申论）生成交互式 HTML 备考计划。
功能清单
| 模块 | 说明 |
|---|---|
| 仪表盘 | 备考倒计时、总进度、连续打卡、总学习时长 |
| 每日打卡 | 一键打卡，自动计算连续打卡天数 |
| 今日推荐任务 | 动态检查完成进度，自动跳过已完成任务，顺延推荐下一未完成任务 |
| 打卡日历 | 最近7天日历，今天显示在最右侧；点击打卡，标记完成状态 |
| 四阶段路线图 | 方法精讲→强化提升→套题演练→双线冲刺，含进度条 |
| 每周学习复盘 | 独立模块，按周记录心得+上传笔记文件，localStorage 持久化 |
| 按月任务清单 | 6个月全部任务明细，支持勾选完成状态 |
| 里程碑 | 国考/省考报名、准考证、考试等关键日期 |
| 学习节奏 | 工作日3h+周末6h的时间分配方案 |
| 备考策略 | 各阶段备考建议文字 |
| 导入/导出数据 | 一键下载完整备份 JSON，新链接导入恢复全部进度 |
核心流程
初次生成 → 后续修改
初次使用时，直接运行脚本生成计划：
python scripts/gen_plan.py [输出目录]
默认输出到当前目录，生成 plan.json 和 plan.html。
后续修改时，按照以下步骤：
- 读取
scripts/gen_plan.py，定位需要修改的配置块 - 根据用户需求编辑对应的数据（课程列表、老师、日期等）
- 运行脚本重新生成
plan.html - 如用户需要在线链接，使用 CloudStudio 部署
plan.html所在目录
常见修改场景
| 用户需求 | 定位文件位置 | 修改内容 |
|---|---|---|
| 换老师名字 | S1_COURSES / S2_COURSES / STAGE_MODULES |
修改 teacher_name 字段 |
| 调整课程顺序 | S1_COURSES / S2_COURSES |
重新排列课程元组顺序，同步更新 STAGE_MODULES |
| 增减课程 | S1_COURSES ~ S4_COURSES |
添加/删除课程元组 |
| 改起止日期 | 第14-15行 | 修改 START_DATE / DEADLINE |
| 改每日学习时长 | 第16-17行 | 修改 WEEKDAY_MIN / WEEKEND_MIN |
| 改阶段天数 | STAGES_DEF |
修改各项 days |
| 改阶段卡片 | STAGE_INFO / STAGE_MODULES / STAGE_MONTHS |
修改对应字段 |
| 改节假日 | is_holiday() 函数 |
修改 holidays set |
| 改学习节奏 | gen_rhythm() 函数 |
修改时间段文字 |
| 改模块颜色 | CAT_COLORS |
修改颜色对 |
| 改模块图例 | gen_stage_cards() 中的 module-legend |
修改图例顺序/文字 |
重要规则
CSS/版式/配色保护
CRITICAL：除非用户明确要求修改版式/配色/样式，否则 只改数据内容，不动 CSS 变量和 JS 逻辑。这是用户反复强调的硬性约束。
数据内容包括：课程列表、老师名字、日期、阶段天数、阶段卡片文字、学习节奏文字、策略文字、资源文字。
非数据内容包括：CSS 样式变量（颜色、字号、间距、圆角等）、JS 交互逻辑、HTML 结构布局。
星期计算
gen_calendar() 中星期数组为 ["一","二","三","四","五","六","日"]，与 Python date.weekday() 返回值一一对应（0=周一→"一"）。
课程顺序约定
默认课程顺序为：判断推理→言语理解→资料分析→数量关系→政治理论→申论。
如需修改顺序，必须同步更新以下所有位置：
- S1_COURSES 和 S2_COURSES 的课程排列
- STAGE_MODULES["S1"] 和 STAGE_MODULES["S2"] 的模块列表
- gen_stage_cards() 中 module-legend 的图例顺序
运行脚本
# 在目标项目目录运行（输出 plan.json + plan.html 到当前目录）
python <skill-dir>/scripts/gen_plan.py
# 指定输出目录
python <skill-dir>/scripts/gen_plan.py /path/to/output
# 使用托管 Python
<managed-python-path> <skill-dir>/scripts/gen_plan.py
部署到 CloudStudio
生成 plan.html 后，如需在线链接：
# 使用 workbuddy_cloudstudio_deploy 工具，传入 plan.html 所在目录
参考文档
references/config_guide.md 包含所有配置项的详细说明，包括每个数据结构的字段含义、可选值、修改示例。当需要了解配置细节时加载此参考文档。
