Skip to content

design.md

Latest commit

 

History

History
194 lines (144 loc) · 7.42 KB

design.md

File metadata and controls

194 lines (144 loc) · 7.42 KB

复盘 Agent 设计文档

状态：已完成 最后更新：2026-05-16

1. 产品定位

名称：Reflection（反观）

一句话：一间安静的屋子，坐下来，和自己对话。不局限于交易——生活、学习、关系、所有的经历都可以复盘。侧重心境、念头、道的层面。

目标用户：任何想要深度自我觉察的人。可分发为桌面应用。

核心体验：打开应用 → 看到一个问题 → 开始写 → 自然深入 → AI 提炼洞察 → 跨时间发现模式 → 离开。不需要导航，不需要探索。

2. 架构总览

┌──────────────────────────────────────────────┐
│          Reflection（桌面应用）                │
│                                              │
│  前端：HTML 本地页面（浏览器窗口中打开）        │
│  后端：Python FastAPI（本地服务器，127.0.0.1） │
│  大脑：用户自带的 LLM API Key                  │
│  存储：SQLite（单文件，零配置）                │
│                                              │
│  分发：PyInstaller 打包为 Windows .exe         │
│  数据：完全本地，不上传任何内容                 │
└──────────────────────────────────────────────┘
决策点 选择 理由
AI 大脑 用户自带 API Key（支持 OpenAI / Claude 等） 数据不出本地，不依赖第三方服务
存储 SQLite 单文件、零配置、够轻
分发 PyInstaller → .exe 用户不用装 Python，双击即用
UI 本地 Web 页面 好看、灵活、跨平台一致

3. 数据模型

Session（每次复盘）
├─ id, created_at
├─ 对话全文（raw_conversation）
├─ 状态（进行中 / 已完成）
└─ 标签（可选：生活/学习/交易/关系/其他）

Insight（单条洞察）
├─ id, session_id
├─ 维度：thought（念头）/ state（内在状态）/ dao（道的体悟）
├─ 内容
└─ created_at

Pattern（长期模式，AI 自动发现）
├─ id
├─ 类型：惯性思维 / 情绪模式 / 行为重复
├─ 描述
├─ 关联的 insight_id 列表
├─ 首次出现时间
├─ 最近出现时间
└─ 演化标记：强化中 / 减弱中 / 已转化

4. 复盘引擎：三轮对话

每次复盘走三轮，不跳跃，不显示轮次编号（用户感知不到切换）。

第一轮：放下 · 倾倒

  • Agent 不评判、不建议，只是接住用户说的一切
  • 目标：把心里的事全倒出来
  • 结束时 Agent 用一句话回响："我听到的是……对吗？"

第二轮：觉察 · 深入

  • Agent 从三个维度切入，像镜子反向提问：
    • 念头层："那个时候，你心里冒出的第一句话是什么？"
    • 状态层："身体什么感觉？能量是往上的还是往下的？"
    • 道的层："如果这件事是一个隐喻，它在告诉你什么规律？"
  • 目标：不是分析，是让用户自己看见自己

第三轮：沉淀 · 收束

  • Agent 提炼 3-5 条洞察，每条标注维度
  • 翻过去的历史记录，指出模式：
    • "这个模式 X 天前也出现过，当时是……"
    • "从那时到现在，你的变化是……"
  • 最后问："今天最值得带走的一句话是什么？"
  • 用户回答后，结构化保存

5. 界面设计

5.1 整体理念

只有一个主界面。打开就是一张白纸，一个问句，一个光标。打字就开始了。全程没有"下一步"按钮、没有进度条、没有轮次编号。三轮是用户的心理节奏，不是界面结构。

5.2 视觉方向：黎明初光

  • 底色：深蓝至暖金的垂直渐变（夜空 → 黎明地平线）
  • 气质：高处、开阔、俯瞰——像在摩天楼顶层看城市天际线，远处第一道光
  • 字体：AI 用衬线（Cormorant Garamond / Noto Serif SC），用户用无衬线（Inter / PingFang SC）
  • 留白：极度慷慨
  • 动画：仅慢速淡入
  • 声音：无

5.3 首页布局

┌──────────────────────────────────────────────┐
│  REFLECTION                         ┌──┐     │
│  （左上角英文，9px，字距5px）         │门│     │
│                                     └──┘     │
│                                    （14×17）  │
│                                               │
│                                               │
│             今天，什么在你心里？                 │
│                     ───                       │
│                俯 瞰 自 心                     │
│                                               │
│                                               │
│        ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓         │
│        ▓▓▓▓▓▓ 黎明初光渐变 ▓▓▓▓▓▓▓▓▓         │
└──────────────────────────────────────────────┘
  • 左上角：英文 "R E F L E C T I O N"，极淡金棕色，仅作品牌锚点
  • 右上角：方门小图标（14×17px），半掩形态，横线为锁。通往历史和设置
  • 中央：一句问话，衬线体，温暖金色
  • 底部：暖金渐变黎明光，天际线意象

5.4 两个状态

状态 描述
书写态 主页 → 输入框 → AI 回响 → 继续对话。文字流淌，无气泡装饰。
回看态 点击右上角门图标进入。时间线 + AI 发现的长期模式。像翻开一本旧日记。

5.5 回看态（门后）

  • 时间线：所有复盘记录按日期排列，每条显示一句话摘要
  • 洞见面板：AI 发现的 Pattern 列表，每个可展开看详情（演化轨迹、关联复盘）
  • 设置：API Key 配置、模型选择、外观偏好（深色/浅色）

6. 技术栈

层 技术 说明
后端 Python 3.11+ / FastAPI 轻量、异步、适合本地服务
数据库 SQLite（通过 SQLAlchemy） 单文件，零配置
LLM 调用 httpx 直调 OpenAI/Anthropic API 用户配 Key，不经过中间服务
前端 纯 HTML/CSS/JS（无框架） 极简，减少依赖
打包 PyInstaller 一键 .exe
浏览器启动 Python webbrowser 模块 启动后自动打开

7. 分发

  1. pyinstaller --onefile --windowed reflection.spec → Reflection.exe
  2. 用户下载 .exe，双击运行
  3. 自动打开浏览器窗口（本地页面）
  4. 首次使用引导：填入 API Key
  5. 数据存储在 %USERPROFILE%/Reflection/ 下

8. 不做什么（明确排除）

  • 不支持多用户 / 登录系统
  • 不上传数据到任何服务器
  • 不提供语音输入
  • 不支持移动端（首个版本仅桌面）
  • 不做社交分享 / 导出 PDF 等花活
  • 复盘引擎不评判用户、不给建议（只做镜子）

9. 待决定项

  • 产品名称：暂定 "Reflection"（反观），待确认
  • API 支持范围：首版支持 OpenAI + Anthropic，后续扩展
  • 是否支持离线模型（Ollama 等）：暂不支持，后续评估