重复名称会触碰已有权重
`PeftModel.add_adapter()` 与 `PeftMixedModel.add_adapter()` 接受已经存在的 `adapter_name` 时，会先覆盖配置并再次向模型注入 Adapter 层。原有训练权重可能被重新初始化；如果后续注入失败，回滚逻辑甚至可能删除原来的配置，使一次非法调用留下部分修改状态。
PEFT
—StarsHugging Face 的参数高效微调框架，通过 LoRA、IA³、AdaLoRA 等方法只训练少量参数，降低 Transformer 与 Diffusion 模型适配成本。
在修改权重之前拒绝非法状态
重复名称不是一个普通输入错误，它可能静默覆盖已经训练的 Adapter。
EXISTING STATEadapter: financetrained weights ✓
UNIQUENESS GATEname exists?
YES → ValueErrorNO → mutate
FAILED REQUESTstate_dict unchanged原配置对象保持不变
失败必须发生在修改之前
这不是普通的重名提示，而是模型状态的原子性边界：公开 API 已约定名称唯一，冲突必须在任何配置写入、模块注入或权重初始化之前失败。与此同时，Prompt Learning 初始化与 `load_adapter` 的正常路径仍需经过同一入口，不能被新校验误伤。
先校验唯一性，再注入层
在两个 `add_adapter` 入口最前方检查名称是否已注册，冲突立即抛出明确的 `ValueError`；Prompt Learning 初始化改为空注册表后再通过统一入口添加首个 Adapter，`load_adapter` 则保持仅在名称不存在时调用该路径。回归同时比对异常前后的配置与全部权重。
错误请求不再留下半成品
重复名称从静默覆盖变为修改前失败，已有 Adapter 的配置、结构和训练权重在异常路径中保持逐项不变；Prompt Learning、Mixed Model 与正常加载行为继续可用。相关定向与扩展测试共覆盖 1,400 余个用例，模型状态不再出现半提交。
PR #3559 已进入 PEFT v0.21.0
查看正式版本 - 重复 Adapter 前置拒绝
- v0.21.0 标签包含合并提交
- 正式版本已发布