fx·Tome APP 核心设计方案
2026-04-17 更新版。以 iOS 原生为第一优先。 记录为核心，计划为通用骨架，社交为增长层。
全 App 级产品宪法见 PRODUCT_PHILOSOPHY.md， "书为什么能活很久"这一层见 BOOK_PHILOSOPHY.md。
一、产品定位
一句话： fx·Tome 是一本会生长的真实生活之书。
它不是攻略工具，不是健康仪表盘，不是纯内容社区，而是把三件事打通：
- 记录是核心 — 身体数据（体温、用药、睡眠）、情绪变化、陪伴、出行、日常经历，写成书页归入章节
- 计划是通用骨架 — 减肥计划、感冒恢复计划、健身计划、旅行路线、工作项目……任何目标都可以拆成步骤，一步一步完成，完成后自动写回书页
- 社交是增长层 — 任何计划和书页都可以分享，别人可以一键「沿用」，书灵做个性化改写后变成自己的
旅行是社交场景中最好的串联示例（路线可沿用、地点可点亮），但不是产品主线。
核心等式
记录（书页） + 计划（行动骨架） + 社交（沿用与分享） = 一本会生长的人生之书
三大章节
用户的所有内容归入三个章节架：
| 章节 | 主题 | 包含内容 |
|---|---|---|
| 世界章 | 出行与地点 | 城市、路线、旅行页、地点章印 |
| 工作章 | 项目与成长 | 工作计划、学习记录、项目里程碑 |
| 生活章 | 身体与日常 | 体温、用药、睡眠、情绪、陪伴、饮食、运动 |
二、设计方向
2.0 设计哲学总纲
整个产品同时遵守两层哲学：
- 设计哲学：
先关注自己，再面向他人先归章，再分发先留白与秩序，再表达丰富 - 长期哲学： 这不是追热点的内容容器，而是用户很多年后仍然能回看、能理解、能导出的个人之书
因此，fx·Tome 的所有页面必须追求：
- 值得留下
- 值得回看
- 值得理解
- 值得传递
- 值得在几十年后重新打开
2.1 视觉气质
- 钉钉的可靠感：信息分层清楚，计划推进清晰，状态明确
- 小红书的分享感：内容有封面感、图片感、故事感，愿意被看见和被沿用
- 一本书的品牌感：纸感、章节、章印、脚注、批注、编年秩序
明确避免：
- 普通社区 App 的热闹感
- 普通工具 App 的冰冷感
- 普通 AI App 的"很会说但不留痕"感
- 健康 App 的仪表盘冰冷感
2.2 视觉关键词
- 真实，不假精致
- 纸感，章印感，温暖
- 墨蓝
#2F80ED代表系统与信任 - 珊瑚
#F26D5B代表行动与分享 - 暖白
#FFF9F2/#F8F5F0代表"书页"而不是"黑盒" - 金色
#C79B63代表成就与章印
三、核心概念
3.1 一本书
用户所有内容最终都沉淀进"一本书"里：
- 每天的健康数据、情绪、用药记录 → 生活章的脚注
- 每次出行 → 世界章的城市页
- 每个工作项目 → 工作章的里程碑页
- 多次记录同一主题 → 自然形成章节与卷
3.2 结构化记录
书灵帮用户把碎片变成结构：
- 说一句"记体温 37.2" → 自动归入生活章，带时间戳和趋势
- 拍一张照片 → 自动识别场景，写成书页
- 说"今天吃了布洛芬" → 归入用药记录，关联感冒恢复计划
- 说"今天心情不好" → 归入情绪记录，书灵温和接话
3.3 计划可沿用
计划是通用的行动骨架，不限于旅行：
| 计划类型 | 示例 | 结构化字段 |
|---|---|---|
| 健康恢复 | 感冒恢复·第3天 | 体温(°C)、用药、间隔提醒 |
| 减肥健身 | 30天体重管理 | 体重(kg)、饮食、运动 |
| 睡眠改善 | 一周作息调整 | 睡眠(小时)、情绪、入睡时间 |
| 旅行路线 | 京都两日慢走 | 地点、预算、时长 |
| 工作项目 | 官网开发计划 | 里程碑、进度、截止日 |
任何计划都可以：
- 被分享到书集
- 被别人一键沿用
- 书灵做个性化改写后变成自己的版本
- 显示沿用人数、完成率、版本来源
3.4 社交沿用
社交的本质不是点赞，而是"别人可以直接拿来用"：
- 用户公开一份减肥计划 → 别人沿用后，书灵根据其体重目标改写
- 用户分享一条旅行路线 → 别人沿用后，书灵根据时间预算调整
- 沿用后保留原作者署名与版本来源
- feedScore = likes×2 + reused×4 + comments×12
四、底部导航结构
iOS 5 Tab，书灵居中为默认首页：
┌──────────────────────────────────────┐
│ fx·Tome │
├──────┬──────┬──────┬──────┬─────────┤
│ 书集 │ TOME │ 书灵 │ 计划 │ 密友 │
│ Feed │ Book │Agent │ Plan │ Social │
└──────┴──────┴──────┴──────┴─────────┘
默认选中 → 书灵
4.1 书集（Feed）
发现别人的真实书页。
作用：
- 浏览别人分享的书页、计划、路线
- 像书市一样有封面感，不像信息流
- 支持按类型筛选：健康、旅行、工作、生活
- 沿用按钮 + 沿用人数 + 完成率
- 评论是"页边批注"，像朋友接话
4.2 TOME（Book）
这是产品核心——用户自己的书。
作用：
- 三个章节架：世界章 / 工作章 / 生活章
- 每个章节下有页列表，按时间与主题组织
- 生活章包含：身体数据、用药、睡眠、情绪、陪伴
- 世界章包含：城市页、地点章印、出行记录
- 工作章包含：项目页、里程碑、学习记录
- 支持导出为长图、PDF、年度合订本
- 回看时有编年秩序和成长感
4.3 书灵（Agent）
默认首页。温和、专业、懂你的记录入口。
作用：
- 和书灵对话，最短路径把今天写成一页
- 快捷意图：记体温、记用药、记睡眠、做计划
- 输入"去京都两天" → 生成旅行路线
- 输入"感冒第三天" → 生成身体恢复计划
- 输入"想减肥" → 生成健康管理计划
- 输入"拍了张照" → 写成一页归入章节
- 读取历史书页与偏好，提供延续性建议
- 明确标注哪些是 AI 生成，哪些是沿用改写
闲时语录示例：
- "记录体温、用药、睡眠——我帮你写进生活章。"
- "想做一份减肥计划？告诉我你的目标。"
- "今天的一页，就是明天的来时路。"
4.4 计划（Plan）
通用行动骨架，不限于旅行。
作用：
- 展示当前所有待执行的计划和步骤
- 时间轴 + 状态卡片（已完成 / 进行中 / 待确认 / 已锁定）
- 结构化字段显示（体温 °C、体重 kg、睡眠 小时）
- 分类标签（健康 / 健身 / 旅行 / 工作 / 通用）
- 支持间隔提醒（用药每6小时、体温每日3次）
- 完成后一键写回 TOME 对应章节
- 过去/今天/未来三态展示
4.5 密友（Social）
书友关系与通信。
作用：
- 书友列表，像微信联系人而不是粉丝列表
- 往来像书信，不是消息洪流
- 页边批注（评论）的汇总入口
- 隐私与公开范围管理
- Agent 偏好设置
- 数据导出与备份
五、核心用户闭环
主闭环（记录驱动）
日常发生
-> 书灵帮你记录（体温/情绪/用药/拍照/到达一个地方）
-> 自动归入对应章节（生活章/世界章/工作章）
-> 沉淀成可回看的书页
-> 选择性分享到书集
-> 被别人沿用
-> 回流成新的计划模板
计划闭环（行动驱动）
有一个目标（减肥/旅行/感冒恢复/做个项目）
-> 书灵拆成可执行步骤
-> 每步完成后自动记录
-> 记录里的结构化数据（体温/体重/睡眠时长）形成趋势
-> 计划完成后写回书页
-> 分享出去，别人可沿用
增长飞轮
- 记录带来日常使用
- 计划带来目标驱动的持续使用
- 章节沉淀带来长期留存
- 分享与沿用带来传播与新用户
- 书灵改写能力带来复用价值
六、页面原则
6.1 书灵页
必须像一个真实可工作的 Agent，而不是摆设聊天框。
需要有：
- 快捷意图入口（记体温、记用药、记睡眠、做计划）
- 最近一次记录或规划上下文
- 可追溯的计划生成逻辑
- 明确标注 AI 生成 vs 沿用改写 vs 用户原创
6.2 计划页
必须像一个真的能执行的行动工作台，不限于旅行。
需要有：
- 时间轴与状态推进
- 结构化数据显示（体温、体重、睡眠等）
- 分类标签（健康/健身/旅行/工作）
- 间隔提醒能力
- 替换建议
- 写回章节按钮
6.3 TOME 页
必须体现"书"的价值，而不是数据仪表盘或相册列表。
需要有：
- 三个章节架入口（世界/工作/生活）
- 章节封面与摘要
- 页内脚注与批注
- 时间秩序与编年回看
- 生活章子分类：身体、用药、睡眠、情绪、陪伴
6.4 书集页
必须兼顾"书市美感"和"可沿用性"。
需要有：
- 封面卡片
- 分类筛选（健康/旅行/工作/生活）
- 沿用按钮 + 沿用人数 + 完成率
- 版本来源与原作者署名
- 页边批注（评论）
七、书灵 Agent 的使用方式
7.1 核心原则
书灵运行在 iOS 本地，核心体验不依赖远端。
- iOS 原生体验
- 本地可用、可响应、可积累
- 使用 Swift + MLX 在 iOS 本地推理
- 服务端只负责同步和分享，不做主脑
7.2 推荐架构
iOS App (SwiftUI)
->
Local MLX Agent Kernel (Gemma 4 E4B)
->
On-device Session / Planner / Book / Recording Engine
->
Optional Sync Backend (FastAPI)
7.3 书灵在产品中的职责
书灵必须同时具备记录能力和规划能力：
记录能力：
- 把口语化输入转成结构化记录（"37度2" → 体温记录）
- 识别照片场景，写成书页
- 根据情绪和语气，温和接话
- 归入对应章节，保持编年秩序
规划能力：
- 把目标拆成可执行步骤
- 结合时间/预算/健康状态做个性化排布
- 在沿用他人计划时做改写
- 管理局部记忆，不让每次生成都从零开始
成长能力：
- 初灵 → 知墨灵 → 识函灵 → 守书人 → 典籍灵
- 越用越懂你，基于历史记录提供延续性建议
八、技术方案
8.1 iOS
- SwiftUI 原生
- MLX / MLX Swift LM（Gemma 4 E4B）
- PhotosUI / Camera
- CoreLocation / MapKit
- UNUserNotificationCenter（计划间隔提醒）
- HealthKit（可选，读取设备健康数据）
- ShareLink
- Background tasks for sync
8.2 服务端
- FastAPI 负责同步、账户、媒体、分享、统计
- PostgreSQL 保存用户、章节、计划、沿用关系
- 对象存储保存照片与封面素材
- Redis 做流式状态、队列和缓存
8.3 Agent 内核
- 运行在 iOS 本地
- Swift 封装 agent loop（规划、记录、沿用改写、章节生成）
- MLX / MLX Swift LM 本地推理
- 服务端只作为同步和分享承载
8.4 PlanItem 数据模型
struct PlanItem: Identifiable {
let id: String
let time: String // "08:00" / "步骤 1"
let title: String // "量体温并记录"
let location: String // "生活章" / "世界章"
let note: String // 脚注说明
let status: String // "已完成" / "进行中" / "待确认" / "已锁定"
let symbol: String // SF Symbol
let category: String // "健康" / "健身" / "旅行" / "工作" / "通用"
let valueLabel: String? // "体温" / "体重" / "睡眠"
let valueUnit: String? // "°C" / "kg" / "小时"
}
九、真实原则
产品必须坚持：
- 不伪造"懂你"，所有 Agent 能力都来自真实上下文和用户授权
- 不伪造"攻略"，所有分享都要保留来源与版本
- 不伪造"记录"，健康数据、照片、地点、文案的公开范围可分开控制
- 不伪造"书"，回看时必须真的有章节感、秩序感、成长感
- 不伪造"健康建议"，AI 只帮记录和整理，不做医疗诊断
十、书的哲学（设计宪法）
四条设计规则，贯穿所有页面：
- 页先于帖 — 一页必须值得回看，不是发完即忘的动态
- 章先于流 — 所有内容最终归章，信息流只是入口不是归宿
- 批注先于噪音 — 评论是页边批注，不是喊话区
- 书信先于碎聊 — 书友往来像来信回信，不是消息洪流
十一、分期建议
Phase 1（当前）
- iOS 原生 5 Tab 骨架（书集/TOME/书灵/计划/密友）
- 书灵对话 + 快捷意图（记体温、记用药、记睡眠、做计划）
- 基础计划生成（健康恢复、减肥健身、睡眠改善、旅行路线）
- 结构化记录（体温/体重/睡眠时长，带单位和趋势）
- TOME 三章节架（世界/工作/生活）
- 书集基础展示 + 沿用能力
- 地点打卡与点亮
Phase 2
- 计划间隔提醒（本地通知）
- 生活章子分类（身体/情绪/日常）
- 书集分类筛选（健康/旅行/工作/生活）
- 计划完成率统计与展示
- 更完整的沿用链路（原版→改写版对比）
- 城市章节封面自动生成
Phase 3
- HealthKit 设备数据自动同步
- 年度合订本导出
- 章节协作（家庭健康共管、共同出行）
- 地图模式
- 评论/批注体系完善
Phase 4
- 会员体系
- 实体印刷
- 城市主题策展
- 品牌合作路线与健康计划
十二、当前项目结论
当前项目正式收口为：
- 官网（www.fxtome.com）：品牌与下载承接
- iOS App：正式产品形态，书灵居中为默认入口
- 远端服务器（106.14.25.166）：同步、分享、账户与媒体服务
产品的核心是记录，计划是行动骨架，社交是增长层。旅行是最佳社交场景示例，但产品服务的是整个人生——健康、工作、情绪、陪伴、出行，都值得被写成书页。