用途：从 JSON 配置数据生成美观的交互式时间线 HTML 页面，适合展示项目里程碑、产品发布历史、公司发展历程、个人简历、课程大纲等按时间顺序排列的信息。
主要能力：提供三种布局模式——vertical（经典上下时间线，事件卡片在轴线两侧交替）、horizontal（可横向滚动，适合事件较少时）、dual-side（按 side 字段将事件放在左或右，适合对比展示）。所有布局均支持点击展开/折叠事件详情、移动端响应式设计、自定义主题颜色、图标和分类标签，输出为纯静态 HTML，零依赖，可直接在浏览器打开。
使用方式：需 Python 3.6+（仅标准库）。基本用法：python3 scripts/generate_timeline.py --config timeline_data.json --output timeline.html；也可从标准输入读取：cat timeline_data.json | python3 scripts/generate_timeline.py --stdin --output timeline.html；可用 --layout 覆盖布局：python3 scripts/generate_timeline.py --config data.json --layout horizontal --output timeline.html。CLI 参数包括 --config/-c、--stdin、--output/-o、--layout/-l、--title/-t。JSON 配置包含 title、layout、theme（primaryColor、secondaryColor、backgroundColor、textColor、lineColor、fontFamily）和 events 数组；事件字段中 date 与 title 必填，summary、details、icon、category、color、side 可选，side 仅用于 dual-side 布局。
限制：资料未提供安装方式、收费、平台支持范围及性能上限等信息。