用途:让上游 PyTorch 自定义算子仓库在 Paddle 上按原调用路径运行,并保持后续 rebase / sync upstream 能力;迁移完成后如需集成进 PaddleFleet,走 PaddleFleet 集成流程。
主要能力:按控制面把仓库分为四层——框架无关内核/算法、构建与打包、C++ compat API/注册、Python 包装/runtime glue/tests;输出迁移方案、最小修改边界、验证路径与 compat gap 处理策略。
使用方式:先识别上游仓库、fork、默认分支与迁移分支(PFCCLab 适配仓库默认分支通常为 paddle);首轮补丁集中在 build、runtime glue、device/stream/distributed 边界;沿 build → import → 最小功能测试 → 运行时对照逐步验证。setup.py/pyproject.toml 优先加 paddle.enable_compat(),保留 from torch.utils import cpp_extension 写法;Python 入口与测试优先用 paddle.enable_compat(scope={...}) 限定代理范围,短生命周期 build script 可用全局 paddle.enable_compat()。
适用场景:迁移外部算子库、分析 PFCCLab fork、定位 Paddle 内部错误、复用既有迁移经验、处理 compat gap、运行时行为不一致调试。
限制:不做额外格式化、优化、重构,不主动改公共 API;CUDA/C++ 核心 kernel、原有 schema、大部分 TORCH_LIBRARY/pybind11 注册代码通常不动;workaround 须写明覆盖范围、删除条件与是否需提 Paddle issue;至少跑通一条最小 build/test 路径。具体参考文件与案例索引内容暂未提供。