本源司南用户手册及关键文档
================================
“本源司南”量子计算机操作系统是本源量子在2021年上线的中国第一款量子计算机操作系统，是面向量子计算机的“运行与调度中枢”，向下统一接入多体系量子硬件，向上承载云平台/应用服务，并可与超算/智算/通算资源协同编排，支撑量子算力的稳定交付与规模化服务。

三大核心优势
----------
1. 国产自研：

- 国产自主可控的量子计算操作系统
- 自主研发的量子计算机操作系统，支撑国产量子计算机关键软件底座。
2. 多体系：

- 多物理体系量子计算机的统一接入与调度
- 提供面向多物：理体系的统一接入与调度框架，覆盖超导、离子阱、半导体、中性原子、光量子等
3. 量超融合：

- 面向量超融合的混合计算协同能力
- 支持量子计算与超算/智算/通算协同:将任务在量子与经典算力之间进行拆分、调度与分配，提升整体计算效率与可用性。
- 技术路线，实现接口统一、快速接入。

核心系统能力
-----------

1. 多后端统一接入与高效通信

- 统一接入多体系量子计算后端与经典计算资源
- 提供跨后端的高效通信、调用与数据通道
- 支撑混合任务的提交、执行与结果回传

2. 多用户多任务协同调度与优先级管理

- 多用户、多任务并发下的量子资源调度与队列管控
- 支持量子与经典算力的联合编排、协同分配
- 支持高保真优先等策略的优先级管理与资源隔离

3. 混合任务统一管理与系统控制中枢

- 统一接收与管理量子、经典与量超混合任务
- 管理任务全生命周期：提交、排队、执行、重试等
- 响应系统调用请求，执行用户下发的系统命令

4. 混合编译编排与并行加速

- 支持异构量子任务编译与多级编译流程
- 支持多节点并行编译与批量处理，提升吞吐与效率
- 面向向量超融合流程，支持混合任务编排优化与执行加速

5. 资源统一管理、监控与告警体系

- 统一管理量子后端与经典计算资源的配额与权限
- 周期性保真度检查 + 资源状态监控
- 异常检测与告警通知，提升稳定性与可观测性

6. 系统级噪声校正与结果可信度提升

- 独立分配采样任务
- 获取噪声校正矩阵
- 对采样结果进行噪声缓解/校正，提升结果准确性


目录
----
.. toctree::
    :maxdepth: 3
    :caption: 本源司南 V4.0 用户手册与 API 文档
    
    简介 <rst/01_简介.rst>
    安装与部署 <rst/02_安装与部署.rst>
    系统架构 <rst/03_系统架构.rst>
    可视化管理控制平台 <rst/04_可视化管理控制平台.rst>
    API参考 <rst/05_API参考.rst>
    消息推送 <rst/06_消息推送.rst>
    类型定义与错误码 <rst/07_类型定义与错误码.rst>
    运维与管理 <rst/08_运维与管理.rst>

.. toctree::
    :maxdepth: 2
    :caption: 光量子测控系统通信协议文档
    
    简介 <rst/光量子测控系统通信协议文档简介.rst>
    通信协议 <rst/光量子通信协议.rst>
    消息定义 <rst/光量子消息定义.rst>
    订阅消息 <rst/光量子订阅消息.rst>
    类型定义 <rst/光量子类型定义.rst>
    指令定义 <rst/光量子指令定义.rst>



.. toctree::
    :maxdepth: 2
    :caption: 超导量子芯片测控系统通信协议文档
    
    简介 <rst/超导量子芯片测控系统通信协议文档简介.rst>
    通信协议 <rst/超导量子芯片通信协议.rst>
    消息定义 <rst/超导量子芯片消息定义.rst>
    订阅消息 <rst/超导量子芯片订阅消息.rst>
    类型定义 <rst/超导量子芯片类型定义.rst>
    指令定义 <rst/超导量子芯片指令定义.rst>



.. toctree::
    :maxdepth: 2
    :caption: 离子阱测控系统通信协议文档
    
    简介 <rst/离子阱测控系统通信协议文档简介.rst>
    通信协议 <rst/离子阱通信协议.rst>
    消息定义 <rst/离子阱消息定义.rst>
    订阅消息 <rst/离子阱订阅消息.rst>
    类型定义 <rst/离子阱类型定义.rst>
    指令定义 <rst/离子阱指令定义.rst>    



.. toctree::
    :maxdepth: 2
    :caption: 中性原子测控系统通信协议文档
    
    简介 <rst/中性原子测控系统通信协议文档简介.rst>
    通信协议 <rst/中性原子通信协议.rst>
    消息定义 <rst/中性原子消息定义.rst>
    订阅消息 <rst/中性原子订阅消息.rst>
    类型定义 <rst/中性原子类型定义.rst>
    指令定义 <rst/中性原子指令定义.rst>    


    
..  toctree:: 
    :maxdepth: 2
    :caption: 量子模拟 ZMQ 服务器说明文档

    项目简介 <rst/1_项目简介.rst>
    功能特性 <rst/2_功能特性.rst>
    系统架构 <rst/3_系统架构.rst>
    安装指南 <rst/4_安装指南.rst>
    快速开始 <rst/5_快速开始.rst>
    协议详情 <rst/6_协议详情.rst>
    任务流程 <rst/7_任务流程.rst>
    配置说明 <rst/8_配置说明.rst>
    任务状态枚举与错误码 <rst/9_任务状态枚举与错误码.rst>
    客户端示例 <rst/10_客户端示例.rst>
    测试 <rst/11_测试.rst>
    日志 <rst/12_日志.rst>
    常见问题排查 <rst/13_常见问题排查.rst>
    发布-订阅消息结构 <rst/14_发布-订阅消息结构.rst>
    许可证 <rst/15_许可证.rst>
    技术支持 <rst/16_技术支持.rst>