SuperAPI AI 工具集

trader-cloud-backtest

数据与分析

查看项目

更新于 10-14 22:48

技能介绍

用途

本技能用于把重型 neural-trader 作业(长时间 walk-forward、大规模蒙特卡洛、参数扫描、模型训练)派发到 Anthropic Claude Managed Agent(云容器)上运行,而不是在本地执行。相关设计参见项目 ADR-117(配方与成本规则)和 ADR-115(managed_agent_* 运行时)。

何时使用(与本地 trader-backtest 对比)

  • 快速合理性检查、单个短回测(少于约 1 分钟):用本地 trader-backtest 技能。
  • 多年期 walk-forward、大规模蒙特卡洛计数、网格参数扫描,或模型训练(LSTM/Transformer/N-BEATS):用本云端技能。

前提条件

需要 ANTHROPIC_API_KEY(或 CLAUDE_API_KEY)+ Managed Agents beta 访问权限。如果 managed_agent_* 返回 "needs ANTHROPIC_API_KEY",则回退到本地 trader-backtest 技能。

使用步骤

  1. 先估算成本。 根据作业规模打印预估成本(约等于容器分钟数 × 费率 + token),长扫描是有意为之的选择,不是默认行为。

  2. 准备(或复用)容器 —— 在容器启动时安装 neural-trader,避免 agent 在运行中途重新安装。

  3. 低成本预检。 在运行 1000 路径/多年期作业前,先做一个小型冒烟测试(1 条 MC 路径、约 3 个月),几秒内即可发现错误的策略名或代码。如果失败,先修正参数(并调用 managed_agent_terminate)。

  4. 运行真正的作业:通过 managed_agent_prompt 发送执行命令(回测、训练或扫描)。若 finished:false,则用 managed_agent_events 跟进直到空闲。

  5. 拉取产物(如需要)。

  6. 本地摄取 + Ed25519 验证(ADR-126 Phase 4 fail-closed 门):

    • 用云端返回的指标、参数哈希、运行哈希构建 SignedBacktestArtifact 主体。
    • 在本地用 plugins/ruflo-neural-trader/src/signed-artifact.mjs 中的 signBacktestArtifact(body, privateKeyHex) 签名(密钥解析与 trader-backtest 相同:RUFLO_WITNESS_KEY_PATH → verification/witness-key.json → 降级未签名警告)。
    • 在存储或把产物提升为实盘策略前,调用 await verifyBacktestArtifact(artifact, trustedPublicKey),其中 trustedPublicKey 是固定的项目配置 Ed25519 公钥(不是 artifact.witnessPublicKey 字段,那可由攻击者控制;见 CWE-347 / #1922)。
    • 如果验证返回 false:拒绝提升,输出明显错误并提前返回。这是 ADR-126 的 fail-closed 门。
    • 验证成功后用 memory_store 存入命名空间 trading-backtests。
    • 如果 Sharpe > 1.5,则用 agentdb_pattern-store 存储模式。
    • 把本次运行的容器时间和 token 成本记录到成本追踪命名空间(按 ADR-117,云会话在终止前持续计费)。
  7. 拿到结果后立即终止: managed_agent_terminate({ sessionId, environmentId }) 永远不要留下空闲的计费容器。

成本规则

安装一次(initScript)、复用环境、把扫描批处理进一个 prompt、低成本预检、尽早终止、agent 循环使用 Haiku/Sonnet、启动前先估算。运行一小时的云回测花费一小时的容器时间加上 agent 循环的 token,需谨慎操作。

限制与注意事项

需要 Managed Agents beta 访问权限;缺少密钥时需回退本地技能。实盘策略提升受签名验证的 fail-closed 门约束,验证不通过必须拒绝提升。具体的费率、价格、成本数值资料未提供。