FinClaw V1 User Journey and Interaction Flow
状态：Accepted Initial Design / P0 Design Output 日期：2026-05-14 项目：FinClaw 文档级别：项目级设计支撑 上游文档：v1-design-kickoff-packet.md、v1-prd.md、product-object-and-advisor-design.md、terminology-and-object-naming.md 任务包：v1-user-journey-and-interaction-flow-task-packet.md
本文产出 FinClaw V1 的用户旅程与交互流程。它不是新的产品定义入口，不替代战略白皮书、产品定义、MVP 产品定义或 V1 PRD。
本文只定义用户路径、状态、交互责任和下游 UI / UX 承接清单；不产出高保真 UI，不定义数据库 schema，不改工程代码，不创建真实交易、账户、私钥、自动提醒或生产 channel 能力。
1. Journey Goal
FinClaw V1 的主旅程是：
首次进入
-> 自然语言提出金融认知问题
-> 系统识别认知任务和风险边界
-> 生成 Market Cognition Snapshot
-> 用户保存为 Market Cognition Thread
-> 后续刷新、对比、风险挑战和复盘
-> 行动邻近语言进入 Pre-Execution Checkpoint
-> 反馈、人工复核和试运营记录
这条路径必须让个人用户在不知道内部 Agent、Skill、Prompt、YAML、模型链路或编排机制的情况下，理解：
- 当前认知对象是什么；
- 哪些内容来自事实、推断、争议、未知或用户自述；
- 哪些证据可用、延迟、冲突、不可用或低置信；
- 哪些判断可以继续观察；
- 哪些内容不能转成执行指令。
2. Primary User States
| State | User-facing meaning | System responsibility | Exit condition |
|---|---|---|---|
new_entry | 用户首次进入或重新打开产品 | 提供直接提问入口和轻量上下文选择 | 用户提交问题或选择已有线程 |
task_recognition | 系统正在判断用户想完成什么 | 识别对象、任务类型、行动邻近风险和澄清需求 | 进入澄清、快照、线程刷新或 checkpoint |
clarification_needed | 问题太模糊或证据不足 | 只问必要澄清，不要求重型 onboarding | 用户补充信息或选择低置信继续 |
snapshot_ready | 已形成一次结构化认知 | 展示主判断、证据、风险、未知、观察问题和边界 | 用户保存为线程、追问、挑战或退出 |
thread_proposed | 该快照值得持续维护 | 解释为什么建议保存为线程 | 用户保存、忽略或继续一次性阅读 |
thread_active | 对象正在被持续维护 | 支持刷新、变化对比、观察问题和复盘 | 暂停、关闭、合并、拆分或刷新 |
refresh_review | 正在比较上次到现在的变化 | 说明事实、推断、风险、证据质量和观察问题变化 | 写回线程或要求人工复核 |
risk_challenge | 用户要求反方或风险挑战 | 生成风险、反方、失效条件和待验证项 | 更新快照 / 线程或进入 checkpoint |
pre_execution_checkpoint | 用户提出行动邻近问题 | 降级行动语言，列出前提、风险、失效条件和不可执行边界 | 用户保存、复查、补充信息或离开 FinClaw |
feedback_review | 用户反馈输出质量或上报问题 | 记录反馈、人工复核需求和试运营观察 | 回到快照 / 线程或进入 review queue |
3. First Entry and Lightweight Context
V1 首屏应让用户直接提问，而不是先完成开户式问卷。
最小入口包含：
- 自然语言问题输入；
- 可选市场 / 资产 / 主题提示；
- 可选研究深度；
- 可选风险提示强度；
- 最近或已保存线程入口；
- 明确的认知边界提示。
入口不应要求：
- 完整资产组合；
- 资金规模、收入或净值；
- 交易所账户；
- API key、私钥、助记词或账户权限；
- 机构合规流程字段；
- 多 Agent 或技能选择。
若用户主动输入敏感金融上下文，例如持仓、成本、风险偏好或资金规模，产品可以临时用于当前认知任务，但保存到画像、线程或长期记忆前必须再次确认。
若用户输入凭证、私钥、助记词、交易所 key 或账户权限字段，产品必须拒收、屏蔽、不保存、不训练、不回显，并提示当前产品不处理执行或账户能力。
4. Natural Language Task Recognition
用户可以用模糊、口语、情绪化或行动邻近语言进入。系统不应强迫用户先学习产品对象。
任务识别至少判断：
| Signal | Route |
|---|---|
| 询问资产、主题、新闻或事件怎么看 | Market Cognition Snapshot |
| 要求持续看、以后刷新、保存观察 | Market Cognition Thread proposal |
| 要求和上次相比、现在有什么变化 | Thread refresh |
| 要求反方、风险、哪里可能错 | Risk / counter-thesis challenge |
| 问买、卖、加仓、减仓、开空、止损或是否行动 | Pre-Execution Checkpoint |
| 对象、时间、问题都不清楚 | Clarification |
| 来源不可用、数据冲突或模型低置信 | Low-confidence bounded output |
系统可以问澄清问题，但每次澄清应只解决一个关键不确定性。若用户选择继续，输出必须标明低置信、缺证据或来源限制。
5. Clarification and Low-Confidence Paths
澄清路径用于保护认知质量，不用于制造流程摩擦。
需要澄清的情况：
- 对象不清楚，例如“这个币”但上下文没有资产；
- 时间范围不清楚，例如短线波动和长期主题混在一起；
- 用户要求行动，但没有说明目标、风险约束或关注原因；
- 来源冲突或缺实时数据；
- 用户输入包含可能误导的断言；
- 用户给出高风险敏感信息。
低置信继续路径必须展示：
- 哪些信息缺失；
- 当前判断只适用于什么时间和证据范围；
- 哪些结论是推断；
- 哪些问题需要后续观察；
- 不能作为执行指令。
6. Snapshot Reading Path
Market Cognition Snapshot 是一次认知任务的主要阅读对象。
快照页面或输出应按以下阅读顺序组织：
- 认知对象、时间范围和覆盖边界；
- 一句话主理解；
- 支持主理解的事实与证据状态；
- 主要推断和假设；
- 反方、争议、风险和失效条件；
- 未知、缺失信息和低置信项；
- Watch questions；
- 是否建议保存为 Market Cognition Thread；
- 如果出现行动邻近语言，显示 Pre-Execution Checkpoint 入口而不是订单语言。
快照不能只是一段自然语言答案。它必须可保存、可复查、可引用，并能被后续线程刷新使用。
7. Snapshot to Thread
系统只在有持续价值时建议保存为 Market Cognition Thread。
建议保存的条件：
- 用户明确说要持续跟踪；
- 快照包含明确资产、主题、事件链或开放问题；
- 存在多个 watch questions；
- 主判断依赖未来证据；
- 存在失效条件或反方证据需要观察；
- 用户希望后续比较变化。
保存前应让用户看到：
- 线程标题；
- 关注对象；
- 用户关注理由；
- 初始主判断和反方；
- watch questions；
- refresh conditions；
- invalidators；
- 是否保存用户自述上下文。
用户可选择保存、修改标题 / 关注理由、只保存快照或放弃保存。
8. Thread View, Refresh and Review
Thread 是 V1 的持续价值核心，不是聊天历史、提醒队列、交易 watchlist 或投资组合对象。
线程主视图应让用户感知四件事：
- 这个对象是否仍在维护；
- 当前主判断、反方、风险和未知是什么；
- 上次以来发生了什么变化；
- 哪些判断不能转成执行指令。
刷新流程：
用户触发或条件触发刷新
-> 系统确认刷新范围
-> 装载上一版快照、watch questions、invalidators 和证据状态
-> 生成新的认知变化摘要
-> 标明新增事实、推断变化、风险变化、证据质量变化
-> 更新 watch questions / invalidators
-> 用户确认写入线程
若刷新没有实质变化，也应说明没有变化的原因，而不是生成一段新的相似回答。
线程应支持：
- 暂停：不主动提示，但保留复盘；
- 关闭：结束维护，保留只读历史；
- 合并：两个对象高度重叠并经用户确认；
- 拆分：一个线程分出多个独立主题；
- 复盘：查看历史快照和认知变化。
9. Risk and Counter-Thesis Challenge
风险与反方挑战可以从快照、线程或用户自然语言直接进入。
输出必须覆盖：
- 主判断可能错在哪里；
- 反方证据或反方路径；
- 数据质量和来源限制；
- 失效条件；
- 需要观察的变化；
- 该挑战是否影响现有线程主判断；
- 是否需要更新 Pre-Execution Checkpoint。
风险与反方挑战不是免责声明。它必须能改变线程中的 counter_thesis、invalidators、watch_questions 或 evidence_state。
10. Pre-Execution Checkpoint Path
当用户使用行动邻近语言时，系统必须把问题收束为 Pre-Execution Checkpoint。
行动邻近语言包括：
- “现在要不要买 / 卖”；
- “该不该加仓 / 减仓”；
- “能不能开多 / 开空”；
- “要不要止损 / 止盈”；
- “帮我盯着到价提醒”；
- “如果突破是不是信号”。
Checkpoint 输出结构：
- 用户行动语言重述；
- 降级后的认知任务；
- 当前证据是否足以形成策略假设；
- 支持条件；
- 反方和风险；
- 失效条件；
- 需要用户自行确认的信息；
- 不构成执行指令；
- 如需真实执行，必须离开 FinClaw，进入明确授权、风控和审计的执行链路。
界面和文案不得提供订单按钮、交易参数、自动信号、账户连接、私钥输入或生产提醒能力。
11. Sensitive Input and Consent Path
用户输入分为四类：
| Input class | Handling |
|---|---|
| 普通研究偏好 | 可用于当前任务；保存前建议确认 |
| 金融认知上下文，如持仓、成本、风险偏好 | 可临时用于当前任务；保存到画像或线程前必须明确确认 |
| 敏感个人 / 财务信息 | 默认不保存；必须说明用途、保留范围和删除方式 |
| 凭证、私钥、助记词、交易所 key、账户权限 | 拒收、屏蔽、不保存、不训练、不回显 |
所有保存行为应可被用户理解和撤回。训练资产候选必须与产品记忆区分，并记录授权、去标识化、敏感信息过滤、退出和删除状态。
12. Feedback, Human Review and Trial Signals
V1 试运营需要反馈入口，但反馈入口不能变成生产客服或执行承诺。
反馈类型：
- 输出有用 / 无用；
- 证据不充分；
- 风险遗漏；
- 表达太确定；
- 行动边界不清；
- 线程刷新没有解释变化；
- 希望人工复核；
- 愿意继续使用、推荐或付费。
人工复核入口用于试运营质量控制和评测样本沉淀，不承诺实时服务、交易建议或账户支持。
试运营记录应能回流到 Evaluation and Trial Acceptance Plan：
- 独立完成任务；
- 保存输出；
- 继续追问；
- 持续跟踪；
- 能说清认知增量；
- 理解不确定性和执行边界；
- 没有误解为执行指令；
- 愿意复用或推荐；
- 出现早期付费意愿。
13. Mobile and Desktop Differences
移动端优先支持快速提问、快照阅读、保存线程、刷新和 checkpoint 查看。
桌面端优先支持多列阅读、证据展开、历史快照对比、线程复盘和设计 / 评测审查。
| Area | Mobile | Desktop |
|---|---|---|
| Entry | 单输入框 + 最近线程 | 输入框 + 线程列表 + 证据侧栏 |
| Snapshot | 折叠分区，优先主理解 / 风险 / watch questions | 主内容 + 证据 / 反方 / 历史并列 |
| Thread | 时间线和变化摘要 | 时间线、历史快照、watch questions 和 evidence state 并列 |
| Checkpoint | 分步卡片，突出不可执行边界 | 条件、风险、失效和证据矩阵 |
| Feedback | 轻量选择 + 可选备注 | 结构化反馈 + 人工复核详情 |
14. Downstream UI / UX Design Checklist
UI / UX Interaction Design 至少需要承接：
- 首屏自然语言入口；
- 轻量上下文选择；
- 澄清问题交互；
- 低置信 / 证据不足状态；
- Snapshot 阅读布局；
- 保存为 Thread 的确认流程；
- Thread 主视图；
- Thread refresh diff；
- pause / close / merge / split；
- 风险与反方挑战入口；
- Pre-Execution Checkpoint 页面；
- 敏感信息拒收、屏蔽和保存确认；
- 模型 / 来源 / 数据质量标注；
- 反馈和人工复核入口；
- 移动端折叠规则；
- 桌面端证据和历史并列视图。
15. Acceptance
本文满足 P0 User Journey task packet 的接收条件：
- 每条路径均映射到 V1 PRD 的对象或验收项；
- 行动邻近路径稳定落入 Pre-Execution Checkpoint；
- 敏感信息和凭证类输入有拒收 / 屏蔽 / 不保存 / 不训练要求；
- Thread 路径解释了“我的认知被维护了”；
- 失败、降级、低置信和人工复核路径不是空白；
- 输出可直接交给 UI / UX Interaction Design、Agent Orchestration、Evaluation Initial Plan 和 Trial Operations Plan 使用。
16. Open Items
- 本文不是 UI / UX Interaction Design；高保真页面、组件、空态、错误态和视觉层仍需单独产出。
- 本文不是 schema 设计；字段、枚举和对象关系由 v1-product-object-and-schema-design.md 承接。
- 本文不是 trial closeout evidence；试运营证据仍需 Evaluation and Trial Acceptance Plan 与 Trial Operations Plan 承接。