flagquantum-workbench · diff
git:20260924.1dc6767 to git:20261012.5ce3b3e
11 added, 0 removed. Audit A to A.
---
name: flagquantum-workbench
description: 用固定 FlagQuantum 执行电路分析、编译、模拟和参数训练，解释输入语义、独立数值对照、成本与科学边界。
---
# FlagQuantum
+ <!-- BEGIN NATIVE SDK ACCESS -->
+ ## 原生 SDK 路径
+
+ 本能力同时支持 **FlagQuantum 的原生公开 API**。用户需要 Circuit、序列化、门、拓扑、路由、训练与后端 时，由 Agent 在固定依赖环境中编写和运行任务代码，不限于下文便捷 Tool 的预设模型。
+
+ 使用 `node scripts/sdk-access.mjs inspect flagquantum-workbench` 定位环境，按[完整 SDK 工作流](../quantum-sdk-workbench/references/workflow.md)执行。模块导航：`flagquantum`；导航不是 API 白名单。
+
+ 下文关于模型、门集、输入与预算的限制描述便捷 Tool 的合同；原生 SDK 另受上游版本、可选依赖、宿主资源与用户授权约束。已禁用或被拒绝的动作不能借代码路径绕过。执行状态和科研验收分别报告。
+ <!-- END NATIVE SDK ACCESS -->
+
+
这是默认关闭的上游电路工作台。用户需要其 IR、编译、模拟或参数训练方法时，从设置中心启用 `flagquantum` 并准备固定环境。只使用该 server 命名空间中的 Tool，避免与 Qiskit 同名 Tool 混淆。
根据目标选择所需步骤：原始 gate-list QIR 需要 serialize_circuit_tool 转成 IR；分析用 analyze_circuit_tool，优化/路由用 optimize_circuit_tool / route_circuit_tool，需要导出时再用 emit_openqasm_tool / emit_qcis_tool。已有有效 IR 不必重复序列化；仅模拟不要求先优化、路由和导出。输入是 FlagQuantum IR JSON 或 QIR 门列表；OpenQASM 仅输出，不当作可读入格式。示例 QIR：`[{"name":"h","index":[0]},{"name":"cx","index":[0,1]}]`。
本地模拟使用 simulate_circuit_tool，核对 output kind、wire 顺序、precision、shots 和执行模式。先读 describe_gate_set_tool 再选不熟悉的门；训练必须有独立基线。17 个上游 Tool 的成功/失败在结果 `status` 中，不应只看 MCP `isError`。`status=success` 与 accuracy.metric=not_measured 不代表科学验收；实际硬件作业没有通过此连接提交。源服务的 readOnlyHint 只描述计算，启动器首次物化环境会写磁盘，因此 OQ 保守按 workspace-write 登记。
此上游协议没有 `execution` 字段。连接超时由 MCP 设置控制；启动器继承用户配置的数值线程与设备环境（如 `OMP_NUM_THREADS`），不固定为单线程。首调可能物化锁定环境，因此完整调用为 workspace-write。不要把执行成功或参考相符写成最终科学验收。安装、来源与示例见 [候选库接入说明](../../../docs/integrations/CANDIDATE_LIBRARIES.md)。
可按编译、模拟或训练选用[专业工具范围](../../../docs/integrations/CAPABILITY_SELECTION.md#大型可选服务的工具范围)；未选择时保留完整原接口。