# BigHead Memo — 开发文档

> 私人 memo 应用 · X.com 设计语言 · PWA 形态
> 创建：2026-07-20 · 状态：需求讨论中，PRD 未完成

---

## 一句话定义

给自己做一个私人 memo 应用：X.com 式白底简约界面，随时随地记录想法/照片/视频，事后打标签分类，核心差异化是「那年今日 + 随机回顾」。

---

## 已冻结的需求（2026-07-20 确认）

### 用户与商业

| 项 | 结论 |
|----|------|
| 目标用户 | 大头哥本人，单人使用 |
| 商业模式 | 纯个人工具，永久免费，不考虑多用户扩展 |
| 项目性质 | 长期工具（替代 flomo），不好用就持续打磨 |
| 现有替代品 | flomo（界面不喜欢、缺回顾功能、年费 98） |

### 产品形态

| 项 | 结论 |
|----|------|
| 平台 | PWA（不做安卓原生、不做小程序） |
| 电脑端 | Chrome/Edge 安装 PWA = 独立窗口 App（同 flomo 电脑版体验） |
| 安卓端 | Chrome 添加到主屏幕 = 全屏 App |
| 账号体系 | 不需要（单人，简单 token 或复用 admin-auth） |

### 界面设计语言

**核心要求：X.com 的整体设计语言，不只是时间流**

- 白底、简约、克制、大量留白
- 无花哨配色、无渐变、无阴影堆砌
- 时间流 = X 时间线 / 微信朋友圈式（倒序单列）
- 明确不要 flomo 式界面

### 功能需求（优先级未最终排序）

| 功能 | 说明 | 状态 |
|------|------|------|
| 随手记录 | 文字 + 图片 + 视频，先发后打标签 | 已确认 |
| 时间流 | X 式倒序单列 | 已确认 |
| 标签系统 | flomo 式，事后补标签，平铺（是否分层级待定） | 已确认，细节待定 |
| 那年今日 | 查看历史上今天的所有记录（入口按钮） | 已确认 |
| 随机回顾 | 随机跳出一条历史记录（类 iOS 相册） | 已确认 |
| Web Push 提醒 | 每日推送"今天有 N 条回忆"（iOS 相册式主动跳出） | **明确搁置，后续版本再加** |

### 数据存储

| 数据类型 | 存储位置 |
|----------|----------|
| 文字/标签/元数据 | SQLite（服务器本地） |
| 图片/视频 | 腾讯云 COS（全部存 COS，不用服务器磁盘） |

### 明确不做

- 不做安卓/iOS 原生 App（至少 v1）
- 不做微信/支付宝小程序（个人主体类目受限 + 无推送能力 + 数据在腾讯手里）
- 不做多用户/账号体系
- 不做 flomo 历史数据导入
- v1 不做 Web Push

---

## 待回答的问题（PRD Phase 1 剩余）

4. **核心导航结构**：
   - 方案 A：桌面端左侧窄边栏（时间流/标签/那年今日/随机回顾/设置）+ 移动端底部 Tab（X 风格）
   - 方案 B：极致单页面，标签和回顾收在顶部（flomo 风格）
   - **待选**

5. **记录入口**：
   - 方案 A：页面顶部固定输入框（X 风格"有什么新鲜事？"）
   - 方案 B：底部悬浮 + 按钮，点开弹窗输入（flomo 移动版风格）
   - **待选**

6. **视频时长上限**：限 1 分钟以内 vs 不限时长（决定 COS 上传策略和成本架构）
   - **待答**

---

## 技术方案（初步，待 PRD 冻结后细化）

| 层 | 选型 | 备注 |
|----|------|------|
| 后端 | FastAPI + SQLite | 服务器现有 Python 环境 |
| 媒体存储 | 腾讯云 COS | 复用现有桶和上传经验 |
| 前端 | 单页 HTML（PWA） | X 设计语言 |
| PWA | manifest.json + service worker | Chrome 安装 + 安卓主屏幕 |
| 部署 | sieta.vip 子路径（如 /memo/） | 复用现有 nginx + HTTPS |
| 推送 | web-push 库（搁置） | v2 再加 |

---

## 为什么不走其他路线（决策记录）

| 路线 | 否决原因 |
|------|----------|
| flomo 继续用 | 界面不喜欢、缺那年今日/随机回顾、年费 |
| Memos 自建 | 界面是 flomo 式不是 X 式、无回顾功能、视频支持弱 |
| 安卓原生 | 开发量 3-5 倍、单用户无分发优势、需求未验证 |
| 微信小程序 | 个人主体做不了该类目、无后台推送、UGC 审核、数据入口被微信卡死 |
| Electron 桌面端 | PWA 安装模式已等同体验，无需额外开发 |

---

## 下一步

1. 回答剩余 3 个问题（导航结构 / 记录入口 / 视频上限）
2. 走 write-prd skill Phase 2-4：概念版 → 范围冻结 → 落地版 PRD
3. PRD 确认后进 dfc Kanban 流水线（forge 实现 + chief 审查）

---

## 参考

- X.com 设计语言：https://x.com（白底简约、左侧边栏桌面端、底部 Tab 移动端）
- flomo 标签系统：https://flomoapp.com
- iOS 相册"回忆"：那年今日 + 随机跳出的产品灵感来源