---
name: qsyn-compilation
description: 使用 Qsyn 的原生公开 API 完成C++ 库、线路综合、ZX/张量变换、优化、验证与 CLI，支持用户自定义模型、程序与结果文件。
---

# Qsyn

<!-- BEGIN NATIVE SDK ACCESS -->
## 原生 SDK 路径

本能力使用 **Qsyn 的原生公开 API**。用户需要 C++ 库、线路综合、ZX/张量变换、优化、验证与 CLI 时，由 Agent 在固定依赖环境中编写和运行任务代码。

使用 `node scripts/sdk-access.mjs inspect qsyn-compilation` 定位环境，按[完整 SDK 工作流](../quantum-sdk-workbench/references/workflow.md)执行。模块导航：固定版本的原生头文件与源码；导航不是 API 白名单。

使用完整固定源码与 C++20 构建。输入语言、门集、布局、全局相位和导出语义分别核对；编译成功不构成等价性证明。

Apple Silicon macOS 本轮验证使用 GCC 16.2.0；显式 setup 时用 CC/CXX 指定已安装编译器。Clang 22 与上游 fmt 10.2.1 组合已知构建失败，其他工具链须独立核验。

本入口复用宿主文件与代码工具，没有新增通用执行 Tool。原生 SDK 受上游版本、可选依赖、宿主资源与用户授权约束。已禁用或被拒绝的动作不能借代码路径绕过。执行状态和科研验收分别报告。
<!-- END NATIVE SDK ACCESS -->


使用完整固定源码与 C++20 构建。输入语言、门集、布局、全局相位和导出语义分别核对；编译成功不构成等价性证明。

按固定版本的公开文档和签名选择方法；输入、算法与资源预算由任务决定。该 Skill 通过[原生 SDK 工作台](../quantum-sdk-workbench/SKILL.md)和宿主代码工具执行自定义程序，没有新增通用执行服务或专用计算 Tool。

保留程序、输入、完整结果、依赖锁摘要和实际检查。原生 API 的执行不推导最终科学验收，`scientificValidation=not_evaluated`。

[上游源码与文档入口](https://github.com/DVLab-NTU/qsyn)。

## 原生程序示例

[固定版本的可编辑程序](references/native-example.qsyn)展示公开 API 的使用方式，参数与模型可按研究任务修改。先显式准备环境，再在独立任务目录运行，保留结果文件；示例检查不构成最终科学验收。

[构建条件与已验证工具链](references/build.md)。