缺陷协议 — “大声宣告”
计算与引擎栈是新的且在持续演进。每次失败都需遵循此协议。 切勿为了保持活动推进而掩盖错误——吞咽一个缺陷比阻塞一个阶段更糟糕。臆造机制(即编造引擎为何如此行事)是最糟糕的失败模式:活动中最糟糕的时刻都源于对调和事件、定价行为及预算行为的臆造。 验证,而非断言。
先例:一个 totalBudget 超额部署缺陷(一个配置了 40% 预算的账簿在冷启动时部署了约 96% 的资产净值)正是以这种方式被捕获,并使数周的结果失效。一般教训是:隔离受引擎缺陷影响的每个结果,并仅在行为修正后重新运行。
五个步骤(每次失败均适用)
- 停止并表征 —— 是配置(我的过错)、数据(来源端)还是引擎(NexusTrade)?最小化复现 —— 仍然能复现该问题的最小作业/回测。
- 立即记录 在运行的
CAMPAIGN_LOG.md中,使用⚠️ BUG/ISSUE标题:症状、复现 ID、预期与观察结果、当前假设(标记为 假设)、它阻塞了什么。 - 如果是真正的引擎/数据缺陷,写一份交接文档
<名称>_BUG.md放在运行目录下,模板参照references/BUG_TEMPLATE.md(一行摘要、预期与观察结果、包含 ID 的复现步骤、主要假设、需排除的替代方案、查看位置、对结果的影响)。 - 隔离受影响的结果 —— 将修复前运行的所有回测/研究标记为可疑/无效。修复后重新运行。如果缺陷放大了杠杆,那么收益率和回撤都会被放大,且任何受影响的扫描基因都可能失去区分能力——需全部重新验证。
- 在对话中醒目地告知人类操作者。 缺陷与交易结果一样,是该阶段同等重要的交付物——不是需要绕过的尴尬事。
什么不是缺陷(诚信信号失败 —— 不要提交这些)
- 一个返回
NoEligibleCandidate的因子 = 诚信信号,不是缺陷。扩大验证范围;不要降低认证标准。 - 一个已退市/尚未上市的名称(例如 2022 年的 SNDK)缺失或位于拒绝列表中,且没有捏造的值 = 正确行为。引擎捏造一个未交易名称的价格/指标值才算是缺陷(参见 engine-sanity)。
- 单 tick 的调和目标 = 实时策略通过每日再平衡积累其余部分——这样说明即可,不要将其重新诊断为缺陷(参见 deploy-gate)。
验证而非断言检查清单
在将任何关于引擎行为的声明写入交付物之前,请用以下之一作为支撑:query_backtest_events / query_portfolio_events、conditionFieldAudit 或最小化复现。“引擎可能……”不是证据。