支持插件化扩展的拷贝库核心是将拷贝流程拆分为准备→读取→写入→完成四阶段并预留扩展点，通过纯虚函数定义稳定接口、运行时动态加载插件、责任链模式执行钩子、异常隔离与生命周期管理实现可定制、可拦截、可增强的复制行为。
构建一个支持插件化扩展的拷贝库，关键不是“把文件复制得更快”，而是让复制行为本身可定制、可拦截、可增强——比如加进度回调、自动重命名冲突文件、加密传输、校验完整性、对接云存储等。核心是把“拷贝”这件事拆成标准流程（准备→读取→写入→完成），并在每个环节留出扩展点。
定义清晰、稳定的插件接口
接口要足够抽象，又不能太宽泛。推荐用纯虚函数定义最小契约，避免传递 STL 类型以防 ABI 问题：
-
必须实现的方法：如
onBeforeCopy(src, dst)（返回是否继续）、onFileProcessed(file, size, elapsed)（用于进度/日志）、onAfterWrite(dst)（可用于校验或触发同步） -
禁止在接口中暴露内部路径类、智能指针或容器，统一用 const char* 或简单结构体（如
{const char* path; uint64_t size;}） -
提供元数据字段：每个插件声明
name、version、priority（决定执行顺序），便于管理与调试
实现运行时插件加载机制
主库不硬链接插件，而是启动时扫描指定目录（如 ./plugins/），按平台调用系统 API 动态加载：
- Linux：用
dlopen()打开.so，再用dlsym()获取导出的create_plugin()工厂函数 - Windows：用
LoadLibrary()+GetProcAddress()，要求插件用extern "C"导出，防止 name mangling - 所有插件实例最终以基类指针（如
IFileHook*）存入管理器，主流程通过多态调用，不感知具体类型
设计可组合的钩子执行链
拷贝不是单个动作，而是一串可插拔的阶段。建议采用责任链模式，让多个插件按优先级有序介入：
- 例如
copy("a.txt", "b.txt")会依次触发：preValidate → preRead → onChunk → postWrite → postVerify - 每个钩子返回
HookResult{continue: true, modified_dst: nullptr}，允许插件改目标路径、跳过文件、中断流程 - 主库内置默认行为（如基础文件读写），插件只负责“增强”或“干预”，不替代核心逻辑
内置插件生命周期与错误隔离
插件异常不能拖垮整个拷贝任务：
- 每个插件在
init()阶段做初始化（如加载配置、连接服务），失败则静默跳过，记录 warning 日志 - 执行钩子时用
try/catch包裹，捕获异常后标记该插件失效，不影响其他插件和主流程 - 提供
unload()接口，在程序退出或热替换时释放资源（关闭句柄、断开连接） - 支持配置文件控制启用状态（如
plugins.json中设"checksum": false）
不复杂但容易忽略：真正让插件“有用”的，不是加载能力，而是钩子设计是否贴合真实场景——比如是否支持断点续传上下文透传、是否允许插件间共享临时状态（通过主库提供的 context 对象）。从第一天就按生产级健壮性设计，后续生态才立得住。
