* 向任务池中添加一个新任务 * @param {Function} fn - 要执行的异步函数 * @param {*} args - 函数的参数 * @returns {Promise} 返回一个在任务完成后 resolve 的 Promise

* 记录 INFO 级别的日志 * @param {...any} args

* 记录 DEBUG 级别的日志 * @param {...any} args

* 记录 ERROR 级别的日志 * @param {...any} args

* 克隆配置对象，隔离 manager 快照和子模块运行期可变状态。 * * 优先使用 structuredClone 以保留更多数据类型；如果宿主不支持或克隆 * 失败，则回退到 JSON clone。本项目当前配置主要是普通 JSON 数据。

* 读取并自动反序列化 JSON 字符串为 JS 对象。 * @param {string} key 键名 * @returns {Promise<Object|Array|null>} 返回反序列化后的数据，发生解析错误或为空时返回 null

* 构造 YouTube 播放器附近的最小 DOM 结构。 * * @returns {HTMLVideoElement} 测试用 video 节点。

* 翻译动作分发入口。 * * 顶层页面发起的动作会同步广播给 iframe；来自扩展 background 的动作 * 已经是统一入口，不再二次广播，避免 iframe 收到重复指令。

* 写入序列化后的对象数据。 * @param {string} key 键名 * @param {Object|Array} obj 待存入 of JS 对象或数组

* 启动字幕显示及监听流程

* 展现通知气泡，支持传入自定义停留展示时长。 * * @param {string} message 通知文案。 * @param {number} [duration=2000] 停留展示时长，单位毫秒。 * @returns {void}

* 记录 WARN 级别的日志 * @param {...any} args

* 检查异步处理版本是否已经过期。 * * @private * @param {number} version 异步任务创建时捕获的版本号。 * @returns {boolean} 当前实例版本已变化时返回 true。

* 清空任务池 * // REVIEW: 定时器未清理风险。如果有些任务在 catch 块中，已经处于 setTimeout 延迟重试阶段（重试定时器还未触发）， * // 此时调用 clear()，由于这些任务还没有被放回 #pool 队列中，所以 clear() 无法将它们 reje

* 启动前台翻译业务。 * * start 注册全局通信、快捷入口和 SPA 监听，并创建运行期子模块。 * start 是幂等的；重复调用只记录日志，不会重复注册监听器。

* 调度虚拟列表渲染到下一帧执行。 * 多次滚动或数据更新只保留一个 RAF；force 会在合并后继续保留，确保下一帧跳过窗口相同的短路逻辑。 * @param {boolean} force 是否强制重建当前可见窗口

* 将 React effect 与 Promise 微任务推进到稳定状态。 * * @returns {Promise<void>} 等待队列清空的 Promise。

* 销毁双语字幕管理器以及字幕侧边栏，恢复网页原生字幕展示状态。 * * @private * @returns {void}

* 初始化字幕面板并启动首次渲染与事件挂载 * @param {Array} subtitles 初始格式化完毕的字幕数组

* 线性插值法计算排序数组的分位数 * * @param {Array<number>} sortedData - 已按升序排列的数值数组 * @param {number} p - 目标分位数，取值范围 (0 - 100) * @returns {number} 对应的分位数值

* 渲染划词翻译结果组件。 * * @param {Object} props 覆盖默认组件参数。 * @returns {{container: HTMLElement, root: Object}} React 根节点与容器。