XTTS-v2 原生波形解码器昇腾 NPU 适配

1. 模型与官方物料

• 官方模型清单 URL：https://ai.gitcode.com/hf_mirrors/coqui/XTTS-v2
• 固定模型 revision：6c2b0d75eae4b7047358e3b6bd9325f857d43f77
• 固定官方 Coqui TTS 源码 commit：dbf1a08a0d4e47fdad6172e433eeb34bc6b13b4e
• 灾备上游：https://huggingface.co/coqui/XTTS-v2（仅同一 revision 人工核验时使用）。

权重不随仓库分发。model.pth 必须为 1,867,929,118 字节，SHA-256 c7ea20001c6a0a841c77e252d8409f6a74fb423e79b3206a0771ba5989776187；config.json SHA-256 ef262b1454dd2a77e1461b0b2cd53e19b8a7624cc131b837d36df67356bc75e8；固定源码文件 TTS/tts/layers/xtts/hifigan_decoder.py SHA-256 714ad014287ad16937f2b8ec9766dfa5c04c0184e2f87a8e5ca0a8a3c9ca67de。

2. 容器与隔离环境

本次官方 ModelAgent Hosted 实测环境为 Python 3.11、PyTorch 2.9.0+cpu、torch_npu 2.9.0.post1+gitfe2ha04、CANN 8.5.1，物理设备为 Ascend910_9362。模型和输入/输出的实际设备均为 npu:0。官方 TTS 源码以固定 commit 独立放置，禁止替换共享全局加速栈；模型层运行使用独立 .venv、PYTHONNOUSERSITE=1 与 TORCH_DEVICE_BACKEND_AUTOLOAD=0。CPU Golden 进程未导入 torch_npu；模型加载使用 weights_only=True 与固定 allowlist。

3. 唯一验收入口

PYTHONNOUSERSITE=1 TORCH_DEVICE_BACKEND_AUTOLOAD=0 .venv/bin/python inference.py --model_path ./model --source-path ./official-source --revision dbf1a08a0d4e47fdad6172e433eeb34bc6b13b4e --device npu:0 --seed 20260812 --output_json audit/npu.json

源码/权重哈希漂移、非法设备、CPU 冒充、设备回退、输出不完整或非有限值均非零退出。

4. CPU Golden 与 NPU 运行

PYTHONNOUSERSITE=1 TORCH_DEVICE_BACKEND_AUTOLOAD=0 .venv/bin/python inference.py --model_path ./model --source-path ./official-source --revision dbf1a08a0d4e47fdad6172e433eeb34bc6b13b4e --device cpu --seed 20260812 --output_json audit/cpu.json
flock -n /data/.modelagent-npu-0.lock bash -lc 'export ASCEND_RT_VISIBLE_DEVICES=0 PYTHONNOUSERSITE=1 TORCH_DEVICE_BACKEND_AUTOLOAD=0; .venv/bin/python inference.py --model_path ./model --source-path ./official-source --revision dbf1a08a0d4e47fdad6172e433eeb34bc6b13b4e --device npu:0 --seed 20260812 --output_json audit/npu.json'

CPU/NPU 已有同身份结果时必须复用；启动前检查 RAM、磁盘、pgrep 与目标 die 的 npu-smi。每个物理 die 独立 flock，同 die 只允许一个 NPU 进程。

5. 样本、完整输出与精度

完整测试用例由一个确定性 GPT latent [1,1024,4] 与 speaker embedding [1,512,1] 的 8 个逻辑部分组成；声明输出为完整原生波形 [1,1,1024]，比较全部 1,024/1,024 个值。冻结门限：cosine ≥ 0.999、最大绝对误差 ≤ 0.05、最大缩放相对误差 ≤ 0.05。

官方 Hosted 本轮完整比较为 PASS：cosine 0.9999833520787371，最大绝对误差 0.0008811093866825104，最大缩放相对误差 0.0008653936108775693，RMSE 0.0002606065258916668。NPU 本轮推理耗时 122.60293579101562 秒。比较命令：

python accuracy/compare_accuracy.py --cpu audit/cpu.json --npu audit/npu.json --output audit/accuracy_hosted.json

6. 三张真实截图

agent_workflow.png 为真实 ModelAgent 迁移规划对话；npu_device_call.png 是真实 NPU 设备证据，在本轮进程存活时同屏绑定 Python PID 9902、物理 die0、--device npu:0 与 npu-smi 的 110 MB 活跃进程；model_result.png 显示同轮完整波形比较 PASS 和指标。三图均已检查 PNG 魔数 89504e470d0a1a0a，尺寸分别为 1270×714、1280×720、1280×720，内容清晰可读。

7. 发布与复核门禁

要求 hook PASS、禁凭证匿名 HEAD 与本地 commit 一致、默认 fresh clone 审计通过、工作树 clean、根目录仅大写 README.md、三图真 PNG。竞赛先查重再唯一提交，随后按 HOSTED_PASS → SUBMITTED → SCORE_100 更新 tracker。

本仓为 2301_76761127 队伍交付件（与备份账号合并提交）。