跳到主要内容

口径 disclaimer（2026-05-28 promote 后追加）

本 proposal 是 2026-05-28 的提案版本，已 promoted 为 ADR-008 supplement（accepted）。正文中提到的「5 个新字段」「mca_tag」「structured-result-version」等表述为提案时口径。

正式契约口径以 ADR-008 supplement 为准：6 个 StructuredCognitionResult 顶层字段 + Task.mca_bucket（非 mca_tag） + structured_result_version（下划线，非连字符）。详见 ADR-008 supplement 机制层输出契约扩展。

本文件保留作为提案演化 audit trail，不作为活契约事实源。审阅 ADR-008 supplement 当前事实时，请以 promoted_to 指向的 ADR 正式版为准。

FinBayes 认知机制输出形态契约扩展请求（ADR-008 supplement）

1. 提案概述​

本提案来自 FinBayes 金融认知体系研究专题 Phase 6 R-B 工程视角 review。R-B 在《reviews/2026-05-28-phase6-r-b-engineering.md》第二节明确指出：Phase 3 升级后的 8 机制输出形态契约与 L3 架构层 ADR-008 锁定的 StructuredCognitionResult 10 要素之间存在 5 处「无槽位承载」+ 1 处 Task 元数据缺位，新增字段量级超过既有契约的 50%。R-B 据此建议触发架构层补独立 ADR（仿 ADR-008「架构层补独立 ADR for StructuredCognitionResult」的悬而未决登记路径），把新增字段纳入正式契约。

紧迫性方面，本扩展不阻塞 ADR-007 supplement 的 formalize（认知体系研究专题可在现有 ADR-008 之上发起 supplement），但强阻塞 Phase 4 评测体系的工程化落地：评测维度 D6（双峰后验形态正确率 / 凯利合规率）、D4（传导图基准 / shared-book 形态命中）与 D7（反向触发命中率）均依赖本提案的字段才能被结构化采集与可计算化。架构层若不承接，Phase 4 评测只能停留在文本层面，无法走向正式工程评测管线。

影响范围严格限定在 L3 架构层 ADR-008 的扩展条款，不涉及 L1 战略白皮书第五节用户产品段的 10 要素声明，不涉及 L2 产品定义层 §7 表 7 的 7 任务类型映射。L1 / L2 现状保持，仅 L3 工程契约新增 5 个字段 + 1 个元数据标签。

2. 五字段加一元数据规约建议​

以下规约以 ADR-008 第 47-60 行 10 要素现行风格为基线，采用「字段名 / 数据类型 / 必选可选 / 来源机制 / 与既有 10 要素的关系 / 示例 JSON 骨架」六栏描述。所有字段统一进入 StructuredCognitionResult 顶层或其指定子节点；具体 Pydantic schema 由架构工作流在 supplement formalize 时锁定。

2.1 mechanism.M3.clock-phase-matrix — 跨时钟相位差矩阵​

  • 字段名：phase_evidence
  • 数据类型：list[ClockPhaseLabel] 一维数组 + ClockPhaseMatrix 综合层后处理对象（矩阵元素为「相位差」枚举值：aligned / lead-1 / lead-2 / lag-1 / lag-2 / opposed / not-applicable）
  • 必选可选：必选（M3 启用时；M3 全槽位不激活时为空数组）
  • 来源机制：M3 时间维度对齐（含 M3.t1–t9 全 9 类时钟槽位 + Minsky 子相位）
  • 与既有 10 要素的关系：并列新增。10 要素中「依据」承载文本依据，相位标签是机制层结构化输出，不应挤入「依据」自由文本，故并列。
  • 示例 JSON 骨架（仅形态参考，字段值省略）：
{
  "phase_evidence": [
    {"clock-id": "M3.t1", "phase-label": "late-debt", "confidence": 0.72, "evidence-ref": "..."},
    {"clock-id": "M3.t4", "phase-label": "growth",     "confidence": 0.81, "evidence-ref": "..."},
    {"clock-id": "M3.t9", "phase-label": "speculative", "confidence": 0.55, "evidence-ref": "..."}
  ],
  "phase_matrix": {
    "axes": ["M3.t1", "M3.t4", "M3.t9"],
    "cells": [["aligned","opposed","lead-1"], ["opposed","aligned","lag-1"], ["lag-1","lead-1","aligned"]],
    "contradictions": [{"axes": ["M3.t1","M3.t4"], "type": "opposed", "severity": "high"}]
  }
}

矩阵尺寸 N×N（N 为当前激活时钟数，上界 9），LLM 仅产元素，综合层产矩阵；与 R-B 第三节并发竞态判定一致，参见 Phase 3 v1 工程回退条款。

2.2 mechanism.M5.propagation-graph — 事件传导图​

  • 字段名：causal_graph
  • 数据类型：TransmissionGraph 子模型，含 nodes: list[Node]（节点对应 M1 对象）+ edges: list[Edge]（边类型枚举：causal / reflexivity / shared-book / institutional-friction / cross-market-mapping）+ reverse-forces: list[ReverseForce] + path-confidence: dict[edge-id, float] + translation-loss: dict[edge-id, float] + correlation_regime: CorrelationRegime（R2 mini-review 补字段，承载 M5.8 相关性跃迁：含 regime-label: enum["normal", "tail-coupled", "regime-switched"] + pair-correlations: dict[(node-id-A, node-id-B), float] + regime-shift-trigger: optional[str]，用于在 shared-book contagion 场景下显式标记相关性结构性跃迁，区别于普通因果传导）
  • 必选可选：必选（M5 启用时）
  • 来源机制：M5 事件传导链路（含 M5.1–M5.7 全子机制 + M5.3 shared-book 四形态 + M5.4 制度摩擦层 + M5.5 反向力量）
  • 与既有 10 要素的关系：并列新增。10 要素的「依据」目前以文本承载因果叙述，无法表达图结构；「成立条件」与「失效条件」是结论侧，不能承担节点 / 边级别的路径粒度。
  • 示例 JSON 骨架：
{
  "causal_graph": {
    "nodes": [{"id": "n1", "object-ref": "M1.entity.HKD-carry"}, {"id": "n2", "object-ref": "M1.entity.US-equity"}],
    "edges": [{"id": "e1", "from": "n1", "to": "n2", "type": "shared-book", "form": "acute-liquidity"}],
    "reverse-forces": [{"edge-id": "e1", "type": "arbitrageur", "evidence-ref": "..."}],
    "path-confidence": {"e1": 0.63},
    "translation-loss": {"e1": 0.22}
  }
}

2.3 mechanism.M6.applicability-trinary — 三支柱适用性三态标签​

  • 字段名：applicability_flags
  • 数据类型：dict[Pillar, ApplicabilityLevel]，Pillar 枚举 = valuation / factor / derivatives，ApplicabilityLevel 枚举 = applicable / partial / not-applicable，附 reason: str 字段说明不适用原因（无基本面锚 / 周期 PE 错觉 / 折溢价机制差异）
  • 必选可选：必选（M6 启用时；7 任务类型中除「解释」外大多数任务都会激活 M6）
  • 来源机制：M6.4「规律不适用」显式输出子机制
  • 与既有 10 要素的关系：与「成立条件 / 失效条件」语义相邻但不同层。三态标签是规律层元标签（哪种规律对该对象可用），10 要素「成立条件」是结论层条件（在何前提下结论成立）。两者并列，不能合并。
  • 示例 JSON 骨架：
{
  "applicability_flags": {
    "valuation":   {"level": "partial",       "reason": "周期 PE 错觉，mature 期表观便宜"},
    "factor":      {"level": "applicable",    "reason": null},
    "derivatives": {"level": "not-applicable", "reason": "标的衍生品市场未成熟"}
  }
}

2.4 mechanism.M7.uq.bimodal-posterior — 双峰后验与凯利上限​

  • 字段名：posterior_distribution + kelly_cap
  • 数据类型：BimodalPosterior 子模型，含 mode-a: {value, weight, tail-width}、mode-b: {value, weight, tail-width}、fit-method 枚举（prompt-direct / multi-scenario-fit / bayesian-module，对应 R-B 第一节判定的三条实现路径）；kelly_cap: float 为仓位输出硬约束（0–1）
  • 必选可选：M7.uq 启用时必选（决策辅助 / 交易准备类任务），其余任务可选
  • 来源机制：M7.uq 不确定性量化子机制
  • 与既有 10 要素的关系：与「不确定性 / 信息缺口」是同义指向，但既有字段是文本字段，无法承载分布形态参数。建议关系：posterior_distribution 作为「不确定性 / 信息缺口」的结构化补充而非替换，文本部分仍保留；kelly_cap 独立并列，作为可被下游交易系统直接消费的硬约束值。
  • 示例 JSON 骨架：
{
  "posterior_distribution": {
    "fit-method": "multi-scenario-fit",
    "mode-a": {"value": -0.15, "weight": 0.35, "tail-width": 0.08},
    "mode-b": {"value":  0.22, "weight": 0.65, "tail-width": 0.12}
  },
  "kelly_cap": 0.18
}

2.5 horizontal.S1.consistency-report — 横切子流程八字段输出​

  • 字段名：s1_consistency
  • 数据类型：NarrativeNumberConsistency 子模型，含 8 字段：s1_mode（枚举 a/b/c）、coupling_direction、coupling_strength: float、evidence: dict（含 narratives 与 numbers 两子字段）、falsification（叙事可证伪条件 + 数字偏离阈值）、backtrigger: list[BackTrigger]（反向触发指令）、confidence: float、second_order_branch: Optional[dict]（attention 数字 vs 自洽度）
  • 必选可选：必选（S1 作为横切子流程在所有任务终态前都会触发；详见兼容性影响第 3 节）
  • 来源机制：S1 横切子流程（叙事-数字一致性），承接 Phase 3 T3
  • 与既有 10 要素的关系：
    • s1_consistency.evidence.numbers 与 10 要素「依据」存在语义重叠，建议序列化时引用既有 evidence 节点而非复制；
    • s1_consistency.falsification 与 10 要素「失效条件」语义一致，建议统一为同一字段（写入「失效条件」并在 s1_consistency 内只保留引用 id），避免双源漂移；
    • 其余 6 字段（mode / coupling-direction / coupling-strength / backtrigger / confidence / second-order-branch）为独立新增。
  • 示例 JSON 骨架：
{
  "s1_consistency": {
    "s1_mode": "b",
    "coupling_direction": "narrative-leads-numbers",
    "coupling_strength": 0.71,
    "evidence": {"narratives": ["..."], "numbers-ref": ["evidence.id.42"]},
    "falsification-ref": "invalidation_conditions.id.7",
    "backtrigger": [{"target": "M5", "reason": "...", "priority": "high"}],
    "confidence": 0.58,
    "second_order_branch": null
  }
}

2.6 task.metadata.mca-tag — MCA 六加一桶位标签​

  • 字段名：mca_tag
  • 数据类型：MCATag 子模型，含 axis-1 至 axis-6 六个轴位枚举（参考 Phase 5 MCA 定义） + axis-7-pending: Optional[str]（P0-2 留位）+ worst-bucket: str（三组阈值最差档） + tag-version: str（轴位标签版本，年度校准刷新）
  • 必选可选：必选
  • 来源机制：Market Coverage Axis（MCA 6+1）横切维度
  • 与既有 10 要素的关系：不进入 StructuredCognitionResult，进入 Task schema 元数据层。理由：MCA 标签是任务发起时刻的横切上下文，不是单次认知输出的内在要素；评测桶分层依赖任务元数据而非认知输出本身。
  • 示例 JSON 骨架（Task schema 侧）：
{
  "task": {
    "task-id": "...",
    "task-type": "decision-support",
    "metadata": {
      "mca_tag": {
        "axis-1": "L2", "axis-2": "M1", "axis-3": "C2",
        "axis-4": "N1", "axis-5": "I3", "axis-6": "D2",
        "axis-7-pending": null,
        "worst-bucket": "axis-4-N1",
        "tag-version": "v1.0"
      }
    }
  }
}

3. 兼容性影响​

3.1 ADR-008 既有实现是否需变更​

不需要变更，仅扩展。ADR-008 决策摘要第 17 行明确「不展开各类任务的具体要素清单（那是 L2 产品定义层的事）」并在「与其他 ADR 的关系」段已为架构层补独立 ADR 预留接口。本提案与 ADR-008 决策详情的 10 要素列表、动态组合机制、战略不变量「画像不裁剪事实空间」均无冲突：

  • 10 要素全部保留，无替换、无删除；
  • 5 个新字段中 4 个（phase_evidence / causal_graph / applicability_flags / posterior_distribution+kelly_cap）为并列新增；
  • 1 个（s1_consistency）与既有「依据」和「失效条件」存在受控重叠，通过引用 id 而非内容复制的方式避免双源漂移；
  • mca_tag 进入 Task schema 元数据而非 StructuredCognitionResult，不挤压 10 要素层。

3.2 既有下游消费方是否需适配​

  • L2 产品定义层 §7 表 7（7 任务类型与 10 要素映射）：无需立即修订。表 7 仍以 10 要素为契约基线；新增字段对所有 7 任务类型按机制激活情况动态可选，不强制全量出现。
  • 工程实现侧（架构 §4 / §6 / §13）：需在 supplement formalize 后同步扩展 Pydantic schema + 序列化层 + 审计日志层，工作量见第 5 节估算。
  • 评测体系（Phase 4 D4 / D6 / D7）：强依赖本提案落地，在本提案 formalize 前评测维度只能停留在文本层。

3.3 版本号字段建议​

建议在 StructuredCognitionResult 顶层引入 structured-result-version: str 字段，本次扩展将版本从 1.0 升级至 1.1。旧版本 1.0 输出在新版本上线后仍可被消费方识别（向后兼容），新增 5 字段在 1.0 schema 中以缺省值处理。对应规则：

  • 1.0：ADR-008 锁定的 10 要素契约
  • 1.1：1.0 + 本提案 5 字段 + Task schema 增加 mca_tag
  • 后续机制扩展（如 Phase 5 治理协议支持的 8→9 机制）走 1.2 / 2.0 升级路径

版本号字段一并要求 audit trail（架构 §15）记录每条 Judgment Record 的 structured-result-version，撤回或降级时按版本筛选受影响记录。

4. 后续承接建议​

  • 接收工作流：首选 governance/workstreams/finbayes-arch-rewrite/（架构工作流），由其在 decisions/ 下起草正式 ADR；若架构工作流当前无空闲承接，可新建独立 ADR 起草子流程，由认知体系研究专题维护者协同。
  • 估算工作量：约 2–4 小时，仅含 supplement ADR 起草 + 与 ADR-008 兼容性逐项核对 + 兼容版本号字段确认。不含工程实现（Pydantic schema 扩展、序列化、审计日志、评测管线对接），实现工作量另行估算。
  • 建议时机：与 FinBayes 认知体系研究专题的 ADR-007 supplement formalize 并行推进。两者在内容上互补：ADR-007 supplement 锁定「8 机制 + 横切层 + 横切子流程」的认知契约，本提案锁定其在架构层的输出契约。并行可避免「认知契约定了但架构层无槽位」的悬空状态。
  • 公示窗口：按变更协议 §1，本提案为 L3 生态级变更，需「生态发起人 + 至少 1 名相关项目 Controller」联合评审；formalize 为 ADR 后若涉及治理协议字段调整，可能触发 §1 L4 流程，由架构工作流维护者在 formalize 时再次定级。

5. 关联资产​

  • 来源工作流：governance/workstreams/finbayes-cognition-system-research/
  • 来源 R-B review：governance/workstreams/finbayes-cognition-system-research/reviews/2026-05-28-phase6-r-b-engineering.md（第二节明确列出 5 字段无槽位 + MCA 元数据缺位）
  • 来源机制定义：governance/workstreams/finbayes-cognition-system-research/drafts/2026-05-28-phase3-mechanisms-v1.md（M3.t7 相位矩阵、M5 传导图、M6.4 三态、M7.uq 双峰后验、S1 横切输出形态契约的源定义）
  • 关联 ADR：governance/workstreams/finbayes-whitepaper-rewrite/decisions/ADR-008-战略层与架构层关于结构化认知输出的对齐.md（待扩展为 supplement）
  • 上位 ADR-007 supplement（拟）：本工作流后续将提交的「金融认知体系第一版正式构成」ADR-007 supplement，本提案与之并行
  • L3 架构文档：projects/finbayes/engineering/architecture.md 第 4 节 StructuredCognitionResult 现行定义

6. 评审决定记录占位​

按变更协议 §6.2，评审人请在本目录追加 2026-05-28--finbayes-cognition-mechanism-output-extension-to-adr008.review.md，记录评审人 / 日期 / 结论（approve / changes-requested / reject）与评审依据。接受后由本提案作者把变更移入对应承接工作流的 decisions/ 目录，本提案 frontmatter status 改为 accepted 并移入 governance/proposals/accepted/2026/。