---
name: openqarp-excited-states
description: 用固定 OpenQARP 执行VQD 激发态、残差与正交性，解释输入语义、独立数值对照、成本与科学边界。
---

# OpenQARP

确认 Hermitian 实系数 Pauli Hamiltonian（最左字符 q0，q0 是最低有效位）、所求态数、复数 HEA 层数和迭代预算，调用 `solve_openqarp_vqd`。自动 penalty 严格高于保守谱宽。态保持 deflation 顺序，不通过排序掩盖重复态或激发态错误。

同时查看 optimizer.success/message、独立重算能量、残差方差、态间重叠和可选精确谱。优化器成功不是正确激发态的证明；失败也不自动意味着能量误差大。`referenceMode=skip` 仅跳过精确谱，独立态/Pauli重算仍执行。

资源由用户选择，通过 `execution.timeoutMs`、`maxOutputBytes`、`threads` 控制进程；首调可能物化锁定环境，因此完整调用为 workspace-write。不要把执行成功或参考相符写成最终科学验收。安装、来源与示例见 [候选库接入说明](../../../docs/integrations/CANDIDATE_LIBRARIES.md)。