【代码贡献】新增多量子比特 SWAP Test 状态重叠估计算法

[tokenjunkielabs]

概要

本提交为 #13 的代码贡献类参赛条目，新增可复用的多量子比特 SWAP Test，用于估计两个量子态的重叠/相似度。

主要内容

• 新增 QOverlap.SwapTest，使用 1 个 ancilla + 两个等宽状态寄存器执行标准受控 SWAP 测试。
• 状态制备由调用方提供，因此可比较计算基态、变分态、特征编码态等任意等宽制备电路。
• 新增 SwapTestResult：返回 overlap²、overlap、ancilla P(0)、dominant bitstring 与 shots。
• 新增 overlap_squared_from_zero_probability 独立后处理 API，并对采样/硬件噪声导致的非物理小负值做 [0,1] 截断。
• 将 QOverlap 暴露到 pyqpanda_alg 包。
• 新增模块 README 示例与 focused regression source。

该实现直接遵循 SWAP Test 关系 P(0)=(1+|<psi|phi>|²)/2，不绑定特定状态制备方式，可作为量子核、态验证、变分算法结果比较等上层模块的基础组件。

未运行额外测试/验证矩阵；本提交直接提交实现、文档与回归源文件。

相关：#13