FinClaw 第一版产品对象与顾问设计
状态：Current Design Support / 第一版已收束 日期：2026-05-13 项目：FinClaw 文档级别：项目级设计支撑 上游文档：strategic-whitepaper.md、product-definition.md、mvp-product-definition.md、terminology-and-object-naming.md
本文承接 FinClaw 第一版产品定义和 MVP 定义，收束两个需要下推到 PRD、schema、UI 和评测的设计层内容：
- Market Cognition Thread（市场认知线程）的生命周期、字段和用户可感知机制；
- Financial Cognition Advisor（金融认知顾问）层的职责、输出契约、分歧处理和入线程方式。
本文不是新的产品入口，也不替代 product-definition.md 或 mvp-product-definition.md。项目级正式入口仍保持三份：战略白皮书、产品定义、MVP 产品定义。
1. Market Cognition Thread（市场认知线程）
1.1 对象定位
Market Cognition Thread 是第一版 FinClaw 的持续价值核心对象。它把同一资产、主题、事件链、叙事或开放问题下的多次认知快照、用户关注理由、观察问题、刷新记录、策略假设演化、失效条件和反方证据串联起来。
它不是：
- 交易执行 watchlist；
- 自动提醒队列；
- 投资组合管理对象；
- 订单、信号或自动执行触发器；
- 多人协作审计流。
1.2 最小生命周期
| 状态 | 含义 | 用户可感知表达 | 可进入条件 | 可退出条件 |
|---|---|---|---|---|
proposed | 系统建议把一次快照延展为线程 | “可保存为持续跟踪对象” | 快照中出现明确关注对象、观察问题或刷新条件 | 用户保存、忽略或放弃 |
active | 用户确认持续跟踪 | “正在维护该资产 / 主题认知” | 用户保存为线程，或显式选择持续跟踪 | 用户暂停、关闭、合并或删除 |
refresh_due | 存在应刷新条件 | “有新变化 / 到达刷新条件” | 触发事件、时间间隔、用户追问、数据质量变化、关键假设被挑战 | 刷新后回到 active，或用户跳过 |
refreshed | 已完成一次刷新并记录变化 | “相对上次发生了什么变化” | 系统生成新快照或刷新摘要 | 刷新摘要写入线程后回到 active |
paused | 用户暂不继续跟踪 | “已暂停，不主动提示” | 用户暂停、低价值、信息不足或阶段性结束 | 用户恢复、关闭或合并 |
closed | 线程结束 | “已关闭，可复盘但不再维护” | 用户关闭、主题失效、关注对象消失或产品判断不再适合维护 | 可复盘或复制为新线程 |
merged | 与另一线程合并 | “已合并到新的 / 既有线程” | 两个线程对象高度重叠，且用户确认 | 合并记录保留，只读追溯 |
1.3 创建规则
线程不应在所有对话中自动创建。第一版只在以下条件中建议创建：
- 用户明确表示“持续跟踪”“以后帮我看”“建立观察清单”“之后刷新”；
- 快照中存在明确资产、主题、事件链或开放问题；
- 输出包含多个 watch questions，需要后续观察；
- 用户要求保存、复盘、刷新、对比或生成后续计划；
- 策略假设依赖未来信号、失效条件或反方证据。
在用户只是一次性提问、证据不足、对象模糊或任务属于低价值闲聊时，系统应先生成快照或澄清任务，不默认创建线程。
1.4 刷新触发
| 触发类型 | 说明 | 默认动作 |
|---|---|---|
| 用户触发 | 用户追问、要求更新、要求对比上次判断 | 立即刷新或先澄清范围 |
| 条件触发 | 原线程记录的 watch question、失效条件、风险阈值被触及 | 标记 refresh_due，生成变化摘要 |
| 时间触发 | 每日、每周、事件后、财报后、政策发布后 | 只在用户确认的线程中生效 |
| 证据触发 | 新来源、来源冲突、数据质量变化、此前不可用数据恢复 | 刷新证据层和置信边界 |
| 反方触发 | 出现反证、争议升级、原假设被挑战 | 强制进入风险 / 反方挑战路径 |
刷新结果必须说明：
- 相对上次新增了什么事实；
- 哪些推断被加强、削弱或撤回；
- 哪些风险、争议、未知或数据质量状态发生变化；
- 原 watch questions 是否已解决、失效或需要拆分；
- 是否需要更新策略假设或执行前认知检查点；
- 哪些内容仍然不能作为执行指令。
1.5 合并、拆分与关闭
合并适用于两个线程围绕同一资产、主题或事件链，且 watch questions、用户关注理由和刷新条件高度重叠的情况。合并时必须保留原线程引用、合并原因、被保留的主判断、被保留或废弃的观察问题、重要分歧和反方证据、合并时间和用户确认状态。
拆分适用于一个线程内部出现多个独立主题、市场、资产或策略假设的情况。拆分时必须说明哪些问题留在原线程、哪些问题进入新线程、拆分后每个线程的关注对象和刷新条件，以及是否有共同证据或共同风险仍需交叉引用。
关闭线程不是删除历史。关闭后应保留只读复盘能力。可关闭条件包括用户明确结束关注、主题或事件链已经结束、原假设已经失效且无继续观察价值、数据长期不可用，或用户转入新的更准确线程。
1.6 最小字段
| 字段 | 说明 |
|---|---|
thread_id | 线程唯一标识 |
title | 用户可读名称 |
object | 资产、项目、主题、叙事、事件链或开放问题 |
status | proposed / active / refresh_due / paused / closed / merged |
user_focus_reason | 用户为什么关注 |
research_style | 深度、语言、风险提示强度、报告形式等偏好 |
linked_snapshots | 历史市场认知快照引用 |
current_thesis | 当前主理解或主判断 |
counter_thesis | 主要反方或分歧 |
watch_questions | 后续观察问题 |
refresh_conditions | 刷新条件 |
invalidators | 失效条件 |
evidence_state | 关键证据、来源限制和数据质量说明 |
cognition_changes | 每次刷新后的变化记录 |
pre_execution_checkpoints | 如涉及行动语言，保存执行前认知检查点引用 |
last_refreshed_at | 上次刷新时间 |
closed_reason | 关闭原因，仅关闭时需要 |
1.7 用户可感知机制
用户不应被迫理解内部状态机。产品界面只需让用户感知四件事：
- 这个对象是否正在被持续维护；
- 上次到现在发生了什么变化；
- 哪些问题仍在观察；
- 哪些判断不能转化为执行指令。
推荐呈现：
- “当前认知状态”：主判断、反方、未知、风险；
- “上次以来变化”：新增事实、修正推断、变化原因；
- “继续观察”：watch questions、刷新条件、失效条件；
- “证据质量”：实时、延迟、模拟、不可用、冲突、低置信；
- “执行前边界”：如果用户问行动，显示执行前认知检查点而不是订单语言。
1.8 验收口径
一条线程可被认为成立，至少满足：
- 能从一次快照创建或由用户显式创建；
- 能保存历史快照，不用新输出覆盖旧判断；
- 能解释刷新前后的认知变化；
- 能维护 watch questions、刷新条件和失效条件；
- 能记录证据与数据质量变化；
- 能暂停、关闭、合并或拆分；
- 涉及行动语言时只生成执行前认知检查点，不生成执行指令。
2. 金融认知顾问层
2.1 设计原则
金融认知顾问不是角色名展示，也不是多 Agent 演示；它是围绕具体金融认知任务形成的专业认知视角，用于组合金融技能、提出判断、暴露分歧、约束证据并写入市场认知对象。
第一版顾问体系遵循四条原则：
- 职责必要：只有当一个顾问视角能改善用户认知状态时才出现。
- 输出对象化：顾问输出必须进入市场认知快照、市场认知线程、风险映射或执行前认知检查点。
- 分歧可见：不同顾问之间可以分歧，但必须解释分歧来自事实、假设、时间尺度、风险偏好还是数据质量。
- 边界稳定：顾问不能越过 FinClaw 的认知边界，不输出真实订单、自动执行信号、收益承诺或无授权调仓建议。
2.2 首批顾问矩阵
| 顾问 | 负责的问题 | 不负责的问题 | 典型输出 | 可调用技能 | 入线程方式 |
|---|---|---|---|---|---|
| 事件解读顾问 | 某条新闻、公告、政策、项目更新或突发事件意味着什么，影响哪些对象 | 把事件直接翻译成买卖建议；替代实时新闻终端 | 事件 / 叙事认知快照、影响路径、待验证信息 | event-impact-reader、narrative-mapper、source-quality-checker | 写入相关线程的 recent_events、watch_questions、evidence_state |
| 标的研究顾问 | 围绕资产、项目、协议、公司或主题形成当前认知快照 | 做完整估值承诺、收益预测承诺或自动评级执行 | 市场认知快照、主叙事、反向叙事、未知项 | asset-context-summarizer、narrative-mapper、source-quality-checker | 创建或更新线程的 current_thesis、linked_snapshots |
| 市场 / 宏观顾问 | 补充市场状态、流动性、风险偏好、宏观或板块背景 | 建设完整宏观系统；用宏观框架压倒具体证据 | 市场背景、regime hint、板块 / 风格上下文 | event-impact-reader、narrative-mapper、source-quality-checker | 写入 market_context、refresh_conditions、evidence_state |
| 风控顾问 | 识别主判断的风险点、脆弱点、暴露和约束 | 替用户决定仓位、止损、杠杆或执行参数 | 风险清单、风险约束、数据质量提醒 | risk-controversy-mapper、source-quality-checker | 写入 risk_and_controversy、invalidators、pre_execution_checkpoints |
| 反方挑战顾问 | 系统构造反方逻辑、反证和失效条件 | 为了制造分歧而分歧；无证据地唱反调 | 反方观点、反证需求、失效条件 | risk-controversy-mapper、watch-question-generator | 写入 counter_thesis、invalidators、watch_questions |
| 交易前判断顾问 | 当用户使用行动邻近语言时，把问题收束为执行前认知检查 | 输出订单、交易信号、自动提醒、调仓或资金动作 | 条件化策略假设、执行前认知检查点、不可执行边界 | strategy-hypothesis-framer、risk-controversy-mapper、source-quality-checker | 写入 pre_execution_checkpoints，必要时更新 current_thesis 和 invalidators |
2.3 顾问输出契约
| 字段 | 说明 |
|---|---|
advisor_role | 顾问角色 |
question_scope | 本次负责的问题范围 |
not_covered | 明确未覆盖或不应覆盖的问题 |
key_points | 主要判断或观察 |
evidence_used | 使用的来源、材料或数据质量说明 |
assumptions | 推断依赖的假设 |
uncertainties | 未知、缺口、冲突或低置信内容 |
risks_or_counterpoints | 风险、反方或失效条件 |
thread_write_target | 写入快照或线程的字段 |
execution_boundary | 如触及行动语言，声明不构成执行指令 |
顾问输出可以被用户查看，但不是第一版主消费对象。用户主消费对象仍是市场认知快照、市场认知线程和执行前认知检查点。
2.4 分歧处理
顾问之间发生分歧时，不应由系统强行压成单一结论。第一版应按以下结构表达：
| 分歧来源 | 表达方式 |
|---|---|
| 事实分歧 | 列出冲突来源、时间、口径和待验证证据 |
| 推断分歧 | 说明相同事实下的不同解释路径 |
| 时间尺度分歧 | 区分短期事件影响和中长期主题判断 |
| 风险偏好分歧 | 标明某判断只适合特定风险承受或研究风格 |
| 数据质量分歧 | 标明实时、延迟、模拟、缺失或低置信数据如何影响判断 |
| 执行边界分歧 | 收束为执行前认知检查点，不让任何顾问直接给出执行指令 |
最终输出应保留主判断、反方判断和待观察问题，而不是消除所有不确定性。
2.5 与金融技能的关系
金融认知顾问可以调用金融技能，但不能等同于技能。
| 层 | 第一版含义 |
|---|---|
| 金融技能 | 原子能力，例如信息抽取、叙事识别、风险映射、来源质量检查 |
| 金融认知顾问 | 围绕具体认知任务组合技能，形成专业视角、分歧和证据边界 |
| 金融 Claw 产品层 | 判断需要哪些顾问、如何整合分歧、如何生成对象、如何维护线程 |
评测时不以“出现了多少顾问”或“调用了多少技能”为成功标准。成功标准是用户是否获得可保存、可复盘、可更新、证据有界的金融认知对象。
2.6 验收口径
顾问体系可被认为成立，至少满足：
- 每个核心顾问有清晰负责 / 不负责范围；
- 每个顾问输出能映射到标准对象或字段；
- 风险顾问和反方挑战顾问不是装饰，而能改变主判断、失效条件或观察问题；
- 交易前判断顾问能稳定把行动语言收束为执行前认知检查点；
- 顾问分歧能被解释并保留到线程；
- 顾问不会绕过证据质量、模型标注、用户授权和执行边界。