量子云平台使用指南
云服务VS经典求解器
在进行结果求解时，一般有两种方式供开发者选择，一种是调用玻色量子专用量子计算云平台的云服务，一种是使用Kaiwu SDK中的经典求解器（一般为SA，SimulatedAnnealingOptimizer）求解。
经典求解器更多是在使用真机前对模型可行性进行辅助验证。
SA求解器介绍
Kaiwu SDK中的SA求解器指基于模拟退火（Simulated Annealing）算法的求解器。模拟退火算法是一种基于物理退火过程的全局优化算法，在求解优化问题时，通过模拟加热和冷却过程，使系统在解空间中进行全局搜索。
在Kaiwu SDK中，SA求解器主要是以下用途：
（1）求解Ising模型：Kaiwu SDK的classical模块是专用于求解Ising模型的模拟退火求解器；
（2）辅助真机验证：在使用SPQC求解前，可先用SA模拟器进行计算和验证。通过SA模拟器先对模型和数据进行初步计算和分析，可以验证问题建模的合理性，评估结果的大致范围，减少直接使用真机的试错成本，提高真机计算的效率和准确性；
（3）结果对比分析：在求解过程中，可将SA求解器的计算结果与真机结果或其他求解器（如禁忌搜索求解器）的结果进行对比，通过对比分析，从而更好评估量子计算的优势和局限性，以及不同算法和工具在处理特定问题时的性能差异。
玻色量子专用量子计算云平台
玻色量子专用量子计算云平台是通过专用量子计算机的标准化接口实现真机算力资源上云，对外提供持续稳定的、“任务式”的量子真机算力服务。
目前云平台提供两种算力服务方式：一种是Optimization模式（优化模式），适合追求更高解质量的组合优化任务，计算资源单位为Optimization Credits；另一种是Sample模式（采样模式），适合需要获得大量候选解、分布样本或进行探索性计算的任务，计算资源单位为Sampling Credits。
（1）具体真机使用链路指南请参考该链接。
（2）目前支持SPQC-550、SPQC-1000云服务，SPQC-X（1000以上）服务申请详见云平台使用文档最后一条。
云平台使用指南
（一）登录
在浏览器中输入云平台的网址进入登录界面：https://platform.qboson.com/，登录成功后跳转至控制台页面。
（二）控制台
1、【算力服务】看板
展示设备的名称、设备描述、可用状态（可用/不可用）、配额和配额到期时间。
2、【用量总览】看板
用户可点击【周】【月】切换看板，查看对应时间段内提交的任务数量及任务平均运行时间。
3、【公告】看板
用户可在公告栏处查看平台最新动态。
4、【任务列表】看板
用户可在此创建任务、查看和下载任务结果。
（三）任务提交
1、创建任务
在【任务列表】中点击【新建任务】即可创建真机任务。
2、选择计费方式
在【计费方式】栏，用户可以从SPQC-1、SPQC-550和SPQC-X三种计费方式中进行选择。
3、输入任务名称
在【任务名称】栏，用户输入的名称不可重复，否则无法提交任务。
4、上传任务数据
若在【计费方式】栏选择SPQC-550，则用户在【选择数据】栏单次最多可提交20个符合550比特、8精度的矩阵，配额不足20时数据上传上限变为配额数。
注：文件状态中会提示数据上传失败的原因（文件格式错误、非标准QUBO矩阵文件、数据非方阵、行数量超过100、参数精度过高），上传失败的任务不消耗配额。
5、确认任务配置
数据上传完成后点击【下一步】，再次确认提交真机的任务配置（任务名称、数据、消耗配额）。
注：（1）用户选择批量提交任务后，则之前输入的任务名称会在本页面中做自增，避免多次输入任务名称；
（2）用户想修改自增任务名称时，点击对应数据的任务名称即可修改。
6、提交任务
检查任务配置无误后，点击【确定】提交任务，进入【提交成功】提醒界面，可返回控制台等待任务计算结果。
注：确认提交后不可终止计算任务。
（四）任务管理
1、查看任务
在【任务列表】中可查看任务名称、数据文件名称、任务状态、量子计算机型号、创建时间和结束时间。
2、搜索任务
【任务列表】右侧的搜索框可支持用户对任务名称进行模糊搜索。
3、下载任务报告及结果
点击【任务名称】前的复选框，即可使用下载功能，下载功能分为【下载报告】和【下载结果】。
（1）点击【下载报告】，用户可获得pdf格式的综合报告，包含全部任务概览、任务输入及任务输出；
（2）点击【下载结果】，用户可获得txt格式的文件，该文件仅包含任务的结果解向量和Hamiltonian量；
（3）单次批量下载功能最多可下载100条任务数据。
4、查看任务详情
点击【任务列表】操作中的【详情】按钮即可查看对应的任务详情。任务详情包括【任务概览】、【任务输入】、【任务结果】三个板块。
（1）【任务概览】板块展示任务名称、任务ID、创建时间、任务状态、数据文件名称及量子计算机型号；
（2）【任务输入】板块展示 QUBO 矩阵详情和可视化图形；
（3）【任务结果】板块展示当前任务状态描述、任务结束时间、任务运行时长、输出解向量和Hamiltonian演化图。
注：任务结果中【下载】按钮仅可下载txt文件的任务结果。
【重要】：SPQC-X服务申请
SPQC-X是实验中超过1000计算量子比特规模的系统，有战略性合作且有深度量子行业经验的客户可以通过云平台【项目申请】开通限时的计算服务。
注意：此计算服务不承诺结果和返回时间。
以下为SPQC-X服务的注意事项：
SPQC-X服务申请前提是需要在云平台提交10个以上的标准任务，包含SPQC-1000、SPQC-550、SPQC-1；
SPQC-X服务属于单独的计费模式，可允许用户提交超过8位比特精度的矩阵，最高14位比特精度，即【-8192, 8191】之间，因此配额不与SPQC-1000、SPQC-550、SPQC-1等常规配额混用；
SPQC-X服务配额默认有效期为半年。
（1）服务申请入口在控制台算力服务处点击【SPQC-X】后再点击【项目管理】按钮；
（2）进入SPQC-X模块页面后点击【项目申请】按钮，跳转至项目申请列表；
（3）【项目申请】列表需要填写相关的项目信息，例如项目背景、项目阶段、建模思路和配额数量等，以便于工作人员评估项目状况和资源支持。提交完成后会进入审核阶段，审核通过会发放对应的计算资源；
（4）审核流程可能需要等待3-5个工作日，如果提交的项目信息不清晰或内容不符合实际会出现项目审核不通过或提前结项等情况；
（5）通过项目申请后请在【非标任务列表】创建您的X任务；
（6）project_no(str, optional)为SPQC-X项目编号，值为项目列表的项目ID，用于创建项目下的任务。