【代码贡献】修复 QmRMR 星号导入报错、8 个无法运行的示例及文档中的过时接口

[CREVIOS]

修复 #38 中报告的全部问题。
关联 Issue：#38、#13 ｜ 参赛队伍：DU_Fanta

---

一、修复内容

1【Bug】from pyqpanda_alg.QmRMR import * 抛出 TypeError

__all__ 中存放的是类对象而非名称字符串：

- __all__ = [Feature_Selection]
+ __all__ = ['Feature_Selection']

修复前：

>>> from pyqpanda_alg.QmRMR import *
TypeError: Item in pyqpanda_alg.QmRMR.__all__ must be str, not type

包内其余 12 个子模块本就使用字符串，此处为唯一例外。

2【Bug】example/QAlgBase/ 中 8 个示例无法运行

两类原因，逐个修复：

• pyqpanda_alg.QFinance 已不存在：内容已拆分为 QUBO / QCmp / QSVR / QSEncode；
• 示例仍基于 pyqpanda v2（initQVM、qAlloc_many、prob_run_dict），而本项目依赖为 pyqpanda3。

testeg_QmRMR.py 引用的 all_code 模块实际名为 QmRMR_core。

示例	修复前	修复后
newtest.py	ModuleNotFoundError: pyqpanda	OK
testeg_QUBO.py	ModuleNotFoundError: QFinance	OK
testeg_QmRMR.py	ImportError: all_code	OK
testeg_class_qsvr.py	ModuleNotFoundError: QFinance	OK
testeg_comparator.py	ModuleNotFoundError: QFinance	OK
testeg_grover_markdata.py	ModuleNotFoundError: pyqpanda	OK
testeg_t_spare.py	ModuleNotFoundError: QFinance	OK
QmRMR/testeg_QmRMR.py	ModuleNotFoundError: pyqpanda	OK

11 个示例现全部可运行（testeg_QSVD.py 见下方说明）。

3【文档】5 处示例使用已移除的 pyqpanda v2 接口

pq.QMachine(pq.QMachineType.CPU) / import pyqpanda as pq → CPUQVM() / QProg()，涉及 plugin.qft、plugin.QFT、plugin.bind_nonnegative_data、QSVM.quantum_kernel_svm、QAOA.qaoa。plugin 的三处示例同时补上了所需的 import，可直接复制运行。

4【文档】parse_quantum_result_dict 示例调用不存在的函数

parse_quantum_result → parse_quantum_result_dict（3 处）。另修正 select_max=2 的示例输出：原文档列出 3 个条目，实际返回 2 个。

5【文档】Grover.cir 示例缺少 QProg 导入

6【文档】两个模块 docstring 描述了错误的模块

Grover/__init__.py 与 QmRMR/__init__.py 原均写作「The QFinance module provides...」，现改为各自模块的说明。

7【清理】6 处已赋值但从未读取的局部变量

QAE、QKmeans、QSVD、QSVM（2 处）、QUBO。ruff check --select F841 现无告警。

---

二、验证

$ cd test && python -m pytest QAlgBase QAOA QARM QPCA QSVM
18 passed

$ cd pyqpanda-algorithm/example/QAlgBase && for f in *.py QmRMR/*.py; do python "$f"; done
11 个示例全部通过（testeg_QSVD.py 除外，见下）

$ ruff check pyqpanda_alg --select F841
All checks passed!

$ python -c "from pyqpanda_alg.QmRMR import *"
（无报错）

可正常执行的 docstring 示例从 33/40 提升到 39/40。剩余 1 处为 plugin.apply_QGate，其使用标准 ... 续行，本身写法正确，仅是检查脚本无法解析。

所有文件的 CRLF 行尾均保持不变，diff 中不含无关的行尾变动。

---

三、本 PR 未处理的问题

example/QAlgBase/testeg_QSVD.py 运行超过 300 秒未结束。已在未修改的 develop 上复现，确认为既有问题，与本 PR 无关，留待单独处理。

---

English summary

Fixes everything reported in #38:

1. pyqpanda_alg/QmRMR/__init__.py put the class object in __all__ instead of its name, so from pyqpanda_alg.QmRMR import * raised TypeError.
2. Eight of eleven example scripts did not run — they imported the removed pyqpanda_alg.QFinance package, or were still written against pyqpanda v2, which is not a dependency. All are ported to pyqpanda3.
3. Five docstring examples taught the removed v2 API (pq.QMachine, import pyqpanda as pq) and raised ModuleNotFoundError when copied.
4. parse_quantum_result_dict's example called a non-existent parse_quantum_result, and its select_max=2 output showed three entries instead of two.
5. Grover.cir's example used QProg without importing it.
6. Grover/__init__.py and QmRMR/__init__.py both described "the QFinance module".
7. Six assigned-but-unread local variables removed; ruff --select F841 is now clean.

18 existing tests still pass; executable docstring examples go from 33/40 to 39/40. CRLF line endings preserved throughout.

Not addressed: testeg_QSVD.py exceeds 300 s, which reproduces on unmodified develop and is therefore pre-existing.