【代码贡献】补充 QSEncode 稀疏编码模块单元测试与文档示例

[B664577]

改动内容

• 单元测试扩充：test/QAlgBase/Test_class_basic_sparecode_QSpare_Code.py 由 1 个用例扩充至 22 个——walsh/fourier 双模式基本功能、构造参数校验与异常路径（None/类型错误/空表/int 元素/负数/概率和偏差）、补零到 2^n 与 cut_length 截断边界、Transform 与独立构造的 WHT/DFT 矩阵逐值对拍、Quantum_Res 端到端小例子（1–2 比特）与手工基准值逐值对拍（atol=1e-9，模拟器结果两次运行 bit 级一致）。
• 文档补充：新增 docs/【完善文档】QSEncode稀疏编码文档与示例.md（按官方文档模板：算法介绍 / 核心思想 / 数学原理 / 可运行示例 / 限制说明）。
• 注释纠错：pyqpanda_alg/QSEncode/QSEncode.py 仅修正 docstring（构造器"Returns"误述改为 Notes、Warning 抛出行为与 mode 校验时机说明、Examples 格式），无任何逻辑改动。

测试

• 改动文件：22 passed
• 全目录回归：python -m pytest QAlgBase → 32 passed（无连带破坏）
• 环境：pyqpanda3 0.4.0 / Python 3.12

说明

本 PR 为 2026 CCF 本源杯开源创新赛道参赛作品（团队：量子溯源）。改动为零风险纯增量：不触碰任何核心 API 与其他模块。