可定制迭代器是核心机制，通过统一接口、自动注册、按需组合与上下文管理实现解耦扩展：next/reset方法、type标识、动态注册、配置驱动装配、错误隔离及作用域上下文。
构建支持插件扩展的数据遍历引擎，关键不在“造轮子”，而在于把遍历逻辑与数据结构解耦，并预留标准化的接入点。Customizable Iterators（可定制迭代器）正是实现这一目标的核心机制——它让不同插件能按需注入自己的遍历策略，而不修改主引擎代码。
定义统一的迭代器插件接口
所有插件必须实现同一套轻量协议，确保引擎能无差别调用：
- 提供 next() 方法，返回
{ value: any, done: boolean }格式对象 - 暴露 reset() 方法，支持重复遍历或状态回滚
- 可选实现 filter(fn) 或 map(fn) 等链式方法，供上层组合使用
- 通过静态属性
type: string标识插件类型（如"range"、"tree-dfs"、"api-paginator"）
引擎内置插件注册与发现机制
引擎启动时扫描指定目录或模块路径，自动加载符合接口规范的迭代器插件：
- 支持按文件名或导出名识别插件（例如
RangeIterator.js导出默认类） - 允许运行时动态注册：
engine.registerIterator('csv-stream', CsvStreamIterator) - 插件可声明依赖项（如需
fetch或fs），引擎在加载前做能力校验 - 冲突检测：同名
type插件被后注册者覆盖，或抛出明确警告
按需组合与运行时调度
用户通过配置描述所需遍历行为，引擎解析后装配对应插件链：
- 配置示例：
{ type: "api-paginator", baseUrl: "/users", pageSize: 20, maxPages: 5 } - 引擎根据
type查找已注册插件，实例化并传入参数 - 支持多级嵌套：一个插件的输出可作为另一个插件的输入源（如先分页拉取，再对每页结果做字段过滤）
- 错误隔离：单个插件异常不影响整体流程，可配置 fallback 迭代器或跳过策略
插件间共享上下文与状态管理
为支撑复杂遍历场景（如带认证的分页、树节点缓存、增量游标），引擎需提供轻量上下文容器：
- 每个遍历会话拥有独立
context对象，插件可通过this.context.set('token', ...)存储临时状态 - 上下文支持作用域继承（父插件设的值，子插件可读；子插件设的值默认不污染父作用域）
- 引擎自动清理会话结束后的上下文，避免内存泄漏
- 插件可声明需要的上下文键（如
requires: ['authToken', 'cache']），引擎提前校验可用性
不复杂但容易忽略：真正让插件生态活起来的，不是功能多强大，而是注册够简单、报错够清晰、组合够自然。从第一个 console.log("registered: file-reader") 开始，就该有明确反馈。
