qcut-knitting · diff
git:20260924.1dc6767 to git:20261012.5ce3b3e
11 added, 0 removed. Audit A to A.
---
name: qcut-knitting
description: 用固定 QCut 执行门切割与期望值重建，解释输入语义、独立数值对照、成本与科学边界。
---
# QCut
+ <!-- BEGIN NATIVE SDK ACCESS -->
+ ## 原生 SDK 路径
+
+ 本能力同时支持 **QCut / Qiskit Addon Cutting 的原生公开 API**。用户需要 自定义电路、切割位置、子实验生成、执行器与重构 时，由 Agent 在固定依赖环境中编写和运行任务代码，不限于下文便捷 Tool 的预设模型。
+
+ 使用 `node scripts/sdk-access.mjs inspect qcut-knitting` 定位环境，按[完整 SDK 工作流](../quantum-sdk-workbench/references/workflow.md)执行。模块导航：`QCut`、`qiskit_addon_cutting`；导航不是 API 白名单。
+
+ 下文关于模型、门集、输入与预算的限制描述便捷 Tool 的合同；原生 SDK 另受上游版本、可选依赖、宿主资源与用户授权约束。已禁用或被拒绝的动作不能借代码路径绕过。执行状态和科研验收分别报告。
+ <!-- END NATIVE SDK ACCESS -->
+
+
确认 unitary 门列表、零起始门索引、Pauli（最左字符是 q0）、采样预算。调用 `knit_qcut_circuit`：automatic 先归一到对称 CZ，explicit 按原始二比特门索引切割且保留操作数顺序。只支持门切割，暂不开放 wire cutting、联合旋转合并或 sampled QPD。
比较未切割期望值；保留有限 shots 下超出 [-1,1] 的重建值。分别报告 gamma² 理论开销、生成电路、实际完成电路与实际 shots，不能把 `shots` 单电路值当总成本。`referenceMode=auto|required|skip` 控制可选指数规模参考。没有参考时明确未检查，不推断量子优势。
资源由用户选择，通过 `execution.timeoutMs`、`maxOutputBytes`、`threads` 控制进程；依赖须显式准备；计算仍可能写 SDK 缓存，保留 workspace-write。不要把执行成功或参考相符写成最终科学验收。安装、来源与示例见 [候选库接入说明](../../../docs/integrations/CANDIDATE_LIBRARIES.md)。
## 依赖准备
运行前执行 `node scripts/setup-paper-tools.mjs qcut-knitting`。缺失、旧锁和已安装环境的处理见[共同准备说明](../../../docs/integrations/LOCAL_ENVIRONMENTS.md)；Tool 不自动安装或升级依赖。