云策略文档与历史运行档案¶
这些接口读写当前认证用户的私有文档，不执行策略。默认关闭；真实后端行为仍为 UNVERIFIED。
| RPC | REST (POST) / CLI | MCP | Scope |
|---|---|---|---|
GetQuantCloudStrategies |
/api/get-quant-cloud-strategies / get-quant-cloud-strategies |
futu_get_quant_cloud_strategies |
acc:read |
CreateQuantCloudStrategies |
/api/create-quant-cloud-strategies / create-quant-cloud-strategies |
futu_create_quant_cloud_strategies |
qot:write + acc:read |
UpdateQuantCloudStrategy |
/api/update-quant-cloud-strategy / update-quant-cloud-strategy |
futu_update_quant_cloud_strategy |
qot:write + acc:read |
DeleteQuantCloudStrategies |
/api/delete-quant-cloud-strategies / delete-quant-cloud-strategies |
futu_delete_quant_cloud_strategies |
qot:write + acc:read |
GetQuantCloudArchives |
/api/get-quant-cloud-archives / get-quant-cloud-archives |
futu_get_quant_cloud_archives |
acc:read |
CreateQuantCloudArchives |
/api/create-quant-cloud-archives / create-quant-cloud-archives |
futu_create_quant_cloud_archives |
qot:write + acc:read |
UpdateQuantCloudArchive |
/api/update-quant-cloud-archive / update-quant-cloud-archive |
futu_update_quant_cloud_archive |
qot:write + acc:read |
DeleteQuantCloudArchives |
/api/delete-quant-cloud-archives / delete-quant-cloud-archives |
futu_delete_quant_cloud_archives |
qot:write + acc:read |
GetQuantCloudQuota |
/api/get-quant-cloud-quota / get-quant-cloud-quota |
futu_get_quant_cloud_quota |
acc:read |
所有请求必须显式传 extension_version: 1。读取需由运维开启 desktop_phase2_reads；写入同时需要读取、写入开关。账户受限的密钥不能访问这些用户级文档接口。CLI 使用 --rest-url（或 --rest-port）、--api-key 和 --c2s-json；MCP 需要 --opend-rest-url，并转发实际调用者密钥。Gateway 与 gRPC 使用相同的类型化请求合同。
读取只返回一页，保留原始游标和字段有无。strategy_ids / archive_ids 最多 14 项，count 最大 14；显式零值与省略保持区别。配额返回服务端剩余数量，不推算总量或已用数量。属性原始字节与解码属性、解码状态分别返回。
每次写入必须传不可变的 intent_key。策略创建要求非空 items，每项传 document_key、attribute_info（JSON 字节数组）和显式 prepare_import。false 保留已有非零本地策略身份，true 分配并冻结本地导入身份；可选 strategy_name 用于明确改名。档案创建使用 archive_key、attribute_info、source，不会生成执行标识。更新需要 cloud_id 和属性字节，档案还需 source；删除要求非空 cloud_ids，空列表拒绝执行。
结果不明时重用原 intent。回执分别保留 ack_state、association_state 和 readback_status；创建已确认仍可能等待可靠的 ID 关联。读回成功不代表此前未知的写入已获确认。已消耗的本地准备身份不能换一个 intent 静默创建第二份云对象。接口不会自动重发或覆盖。
运维可配置本地上传策略 XML 路径。大小限制仅作用于策略属性字节，等于上限也拒绝；策略快照报告来源和状态。历史档案保留真实导入身份，不等同于当前运行策略清单。
带 API-key 认证的原生二进制 WebSocket、REST WebSocket 与 gRPC 的显式订阅可接收私有变更通知，只携带失效元数据，不包含策略代码；文档内容通过显式读取取得。这些接口不提供 compare-and-swap，也不保证排他控制其他客户端同时编辑的文档。
四个携带属性的新增/更新 REST 接口使用 10 MiB 总 JSON 请求上限，包含字节数组展开与其它字段；其它接口保留默认上限。上传策略另检查策略属性字节数。最终序列化的后端请求还必须小于 1,024,000 字节，批量策略与运行档案同样适用；这些限制分别计算。