* 解析年份字符串为数字 * @param {string} yearStr - 年份字符串 * @returns {number} 解析后的年份数字（负数表示公元前）

* 将实际年份转换为滑块值 (非线性转换) * @param {number} year - 实际历史年份 * @returns {number} 滑块位置值

* 更新到指定年份 * @param {number} year - 目标年份

* 格式化年份 * @param {number} year - 年份 * @returns {string} 格式化后的年份字符串

* 显示错误信息 * @param {string} message - 错误信息

* 将滑块值转换为实际年份 (非线性转换的逆运算) * @param {number} value - 滑块位置值 * @returns {number} 实际历史年份

* 查找最接近指定年份的地图数据文件 * @param {number} year - 目标年份(负数表示公元前) * @returns {Object} 最接近的地图年份对象

* 获取当前年份 * @returns {number} 当前年份

* 更新事件列表 * @param {Array} events - 事件数组 * @param {number} year - 当前年份

* 更新到指定年份 * @param {number} year - 目标年份

* 更新年份显示 * @param {number} year - 年份

* 隐藏加载指示器

* 初始化应用

* 主题切换功能 * 为了被main.js调用而提供

* 显示指定步骤 * @param {number} step - 步骤索引

* 将地图更新到指定年份的数据 * @param {number} year - 要更新到的年份 * @param {Object} data - 包含各种数据类型的对象

* 添加脉冲效果 * @param {number} lat - 纬度 * @param {number} lng - 经度

* 关闭介绍页面

* 获取类别图标 * @param {string} category - 类别名 * @returns {string} 图标名

* 获取类别图标的CSS类 * @param {string} category - 类别名 * @returns {string} CSS类

* 获取默认的世界地图（简化版）

* 加载备用地图 * @param {string} fileName - 原始文件名 * @returns {Promise} 返回解析后的GeoJSON数据的Promise

* 加载GeoJSON数据 * @param {string} filePath - GeoJSON文件完整路径 * @returns {Promise} 返回解析后的GeoJSON数据的Promise

* 设置年份变化回调 * @param {Function} callback - 回调函数

* 开始播放

* 停止播放

* 切换播放状态

* 更新滑块指示器位置 * @param {number} year - 当前年份

* 添加关键历史年份标记

* 添加时期标记

* 添加时间刻度的CSS样式

* 创建控制按钮

* 创建错误提示框

* 创建事件卡片 * @param {Object} event - 事件对象 * @returns {HTMLElement} 事件卡片元素

* 创建加载指示器

* 创建时间轴容器

* 创建时间刻度

* 创建UI元素

* 过滤事件列表 * @param {Array} events - 事件数组 * @param {number} year - 当前年份 * @returns {Array} 过滤后的事件数组

* 筛选与特定年份相关的事件 * @param {Array} events - 事件数组 * @param {number} year - 目标年份 * @returns {Array} 过滤后的事件数组

* 格式化刻度年份 * @param {number} year - 年份 * @returns {string} 格式化后的年份字符串

* 从事件数据生成关键历史年份 * 根据重要程度选择典型事件标记在时间轴上

* 从事件数据生成时间段 * 根据事件中的重要时期自动生成时间段配置