木棉盛夏 — 产品说明与路线图

品牌：木棉盛夏（主软件）· 木棉书简（回忆录成书）· 木棉家忆（家族树）
基于代码库全局检索整理（页面路由、API、SaaS 进度、前后端实现）。
与 SAAS_IMPLEMENTATION.md 互补：该文档偏落地 checklist；本文档偏产品全景、功能说明与方向。

文档目录

1. 产品定位与成熟度
2. 离「可上线产品」还差什么
3. 功能说明（功能 / 实现 / 特点）
4. 未来发展方向
5. 总结对照表
6. 建议落地顺序

1. 产品定位与成熟度

木棉盛夏 是一款基于 Web 的 AI 应用，两大产品模块：

• 木棉书简：多 Agent 引导口述，生成可珍藏的人生书简（章节归档）
• 木棉家忆：口述 / 文本 → 四表抽取 → 世系表 → 塔状家族树可视化
• 多模态输入：实时语音 ASR、语音文件、图片 OCR、TTS 朗读
• 账号体系：手机号注册登录、家族空间、数据导出与注销

技术栈摘要

当前成熟度：可演示的 MVP / 内测原型（核心链路能跑，距离公开 SaaS 仍有明显缺口）。
粗估完成度约 70%～80%（功能面较全，工程化、安全收口、商业化未齐）。

2. 离「可上线产品」还差什么

P0 — 上线前必须补（安全 + 稳定）

相关文件：backend/main.py、backend/routes/interview.py、backend/routes/archive.py、backend/services/blob_storage.py、.github/workflows/ci.yml

P1 — 产品体验收口（从「能用」到「好用」）

P2 — 商业化与运营（若要对外收费）

P3 — 可延后但长期有价值

• 微信登录（users.wechat_openid 已在 schema 预留）
• 邮件通知、审计日志、备份与灾难恢复文档
• PWA / 原生 App
• 国际化、API 版本化（/v1）
• 关系矩阵 UI（后端 API 已有，前端未作为主流程）

SaaS 清单对照（摘自 SAAS_IMPLEMENTATION.md）

已完成：A1–A6、B1–B2、C1–C2

未完成：A7、A8、B3–B5、C3–C4、D1–D3

3. 功能说明（功能 / 实现 / 特点）

3.1 账号与家族空间

页面路由：/login、/signin（重定向）、/account（见 backend/frontend_pages.py）

3.2 人生访谈（回忆录）

主要 API 模块：session_api.py、conversation.py、interview.py

3.3 语音 / 图片 / 通用聊天

实现文件：backend/main.py、backend/ws_client.py、backend/services/ocr_image.py

3.4 家族树（核心差异化）

正式入口：/family-tree（旧 /familytree-test 307 重定向）

3.5 合规与分享

操作指南：分享给朋友-ngrok一步步.md

3.6 基础设施（开发者向）

3.7 用户路径简图

flowchart LR
  subgraph pages [页面]
    Home["/ 主页"]
    Memoir["/memoir"]
    FT["/family-tree"]
    Tower["/tower-tree"]
    Login["/login"]
    Account["/account"]
  end
  subgraph apis [主要 API]
    Chat["/api/chat*"]
    Session["/api/session/*"]
    Conv["/api/conversation/*"]
    FTAPI["/api/familytree/*"]
    Auth["/api/auth/*"]
    Archive["/api/archive/*"]
  end
  Home --> Session
  Home --> Conv
  Home --> Chat
  Home --> FTAPI
  Memoir --> Archive
  FT --> FTAPI
  FT --> Tower
  Login --> Auth
  Account --> Auth

4. 未来发展方向

4.1 从「个人工具」到「家族协作平台」

• 家庭成员邀请（链接 / 扫码加入同一 family_id）
• 角色权限（管理员 / 录入员 / 只读）
• 多人共同补全族谱（冲突合并、变更历史）
• 讲述者与人物档案绑定（persons 与访谈 speaker 深度关联）

定位升级：「全家一起补回忆录 + 修族谱」，而非单人记事本。

4.2 AI 能力产品化

• 口述 → 结构化族谱 作为核心卖点（四表 + 世系 + 塔状树一条龙）
• 智能追问（Agent 按缺失关系主动提问）
• OCR 老照片 / 族谱页 批量导入
• 语音优先（面向长辈：大字、少打字、纯语音录入）

差异化：中文复杂亲属关系（过继、再婚、同父异母、相好等）的规则与可视化。

4.3 商业化路径

需补：落地页（C3）+ 支付 + 用量计费 + 套餐限制中间件。

4.4 工程成熟度演进

flowchart TB
  subgraph now [当前 MVP]
    A1[本机 / ngrok]
    A2[单实例]
    A3[local 存储]
  end
  subgraph next [约 6 个月]
    B1[云部署 24h]
    B2[S3 / OSS]
    B3[测试 + Staging]
    B4[短信登录 / 找回密码]
  end
  subgraph later [约 12 个月+]
    C1[家庭协作]
    C2[付费套餐]
    C3[微信生态]
    C4[PWA / 小程序]
  end
  now --> next --> later

• 短期：P0（安全、存储、测试、监控）+ 流程统一（B3–B5）
• 中期：固定域名云部署、短信登录、家庭邀请、落地页
• 长期：协作编辑、印刷导出、微信生态、行业合作

4.5 内容与生态

• 模板库：章节模板、族谱样例（如李氏演示数据）
• 导出形态：PDF 回忆录、可印刷族谱图、GEDCOM 等交换格式
• 开放 API：供家谱软件、档案馆对接

5. 总结对照表

6. 建议落地顺序

若目标为 「可给亲友长期使用的内测版」：

1. P0 安全收口：chat/TTS/OCR/ASR 与 admin 鉴权
2. B3 + B4：主页与 /family-tree 引导统一；塔状树只保留一套
3. 云部署 + 固定域名：摆脱「必须开着 start.bat」
4. 自助找回密码（或短信验证码登录）
5. A7 对象存储 + D1 基础集成测试

若目标为 「对外收费 SaaS」，在以上基础上追加：C3 落地页、支付、用量限制、C4 监控、D3 Staging。

相关文档

文档版本：与代码库同步整理。功能以实际代码与路由为准。