feat: add local autosave history prototype

This commit is contained in:
QiuSW
2026-08-04 23:00:05 +08:00
parent b62e9697a4
commit a82af6939f
31 changed files with 1730 additions and 73 deletions
+63 -7
View File
@@ -21,11 +21,15 @@
## 2. 信息架构
MVP 顶层不需要底部导航。主流程是线性的,使用单 Activity 和清晰的返回行为:
MVP 顶层不需要底部导航。首次欢迎与回访首页是不同状态;核心流程仍保持线性,并使用单 Activity 和清晰的返回行为:
```text
欢迎/方法说明
└── 起念
首次欢迎/方法说明
└── 回访首页
├── 开始一问 → 起念
└── 最近一次 / 问卦簿
起念
└── 投币(1/6…6/6)
└── 结果
├── 本地解释
@@ -54,7 +58,26 @@ MVP 顶层不需要底部导航。主流程是线性的,使用单 Activity 和
主操作只有一个:“开始”。“查看方法”是次级文本操作,不制造必须完成的教程轮播。
### 3.2 起念
### 3.2 回访首页与功能扩展
目的:让回访用户快速开始新的一问,同时能回看默认保存在本机、由自己控制的记录。
首页层级固定为:
1. 唯一主操作“开始一问”;
2. “你的观照”次级区域;
3. 存在记录时显示最近一次及“查看问卦簿”;无记录时显示简短空态和隐私说明。
扩展规则:
- 不展示“敬请期待”、禁用卡片或空宫格;只有已上线且用户可进入的功能才出现。
- MVP 只显示问卦簿,不为了预留而引入底部导航。
- 当出现至少 3 个长期、同级、需要频繁切换的顶层功能时,才评估带文字标签的底部导航;最多 5 项。
- “最近一次”由历史查询派生,不复制问题或解释正文;记录删除后首页同步显示下一条或空态。
- 最近卡片必须同时显示日期、卦名、动爻概况和解释来源;问题因设置或当次选择未保存时明确写“未保存问题原文”。
- 首页在主操作附近持续显示:“起卦与历史默认保存在本机,不主动上传。只有你选择 AI 解读时,本次所需内容才会发送。”末尾提供可点击的“管理保存设置”,但不能把设置做成开始流程的前置门。
### 3.3 起念
页面标题可使用“此刻,你在为何事迟疑?”。问题输入框有固定标签“正在纠结的事”,辅文提示尽量描述事实、选择和顾虑,不要求生日、性别等无关信息。
@@ -65,7 +88,7 @@ MVP 顶层不需要底部导航。主流程是线性的,使用单 Activity 和
- 默认不把问题发送到网络;
- 用户可选择“不写具体内容,直接开始”,最终是否允许空值见[决策记录](decisions.md#未决问题)。
### 3.3 投币
### 3.4 投币
页面始终显示:
@@ -79,7 +102,7 @@ MVP 顶层不需要底部导航。主流程是线性的,使用单 Activity 和
每次确认可以有一次轻触觉反馈和 150–250ms 的爻线出现动画。不得使用持续摇晃、金币飞散、音效倒计时或强制等待。开启“减少动态效果”时直接更新状态。
### 3.4 成卦与观象
### 3.5 成卦与观象
信息优先级:
@@ -93,7 +116,7 @@ MVP 顶层不需要底部导航。主流程是线性的,使用单 Activity 和
原文、本地白话和 AI 解释必须有明确标签,不使用视觉相似但来源不明的段落混排。
### 3.5 解读与落事
### 3.6 解读与落事
「解」是结果页唯一主操作。点击后先选择或显示当前方式:
@@ -104,6 +127,39 @@ AI 加载超过 300ms 时显示内联进度;按钮在请求期间禁用,避
结尾固定使用“可以试的一小步”区域,包含时间范围和撤销方式;它是建议,不是判词。
### 3.7 保存与问卦簿
第六爻确认并生成结果后,默认在后台立即创建本机会话。结果页在不打断阅读的位置显示“已保存到本机问卦簿”,并提供次级操作“本次不保存/删除本次记录”;它们不能抢占结果页唯一主操作「解」。自动保存关闭时,同一位置显示“本次未保存”和“保存本次”。
设置页必须提供以下控制:
- “自动保存完整记录”,默认开启;
- “保存问题原文”,默认开启;
- “保存解读全文”,默认开启;
- “保存行动记录”,默认开启;
- “清空全部问卦记录”,使用危险操作样式并再次确认。
关闭总开关后,三个内容开关保持其值但在界面中同步停用,便于再次开启时恢复用户偏好。总开关不影响未完成草稿的进程恢复,也不能改变 AI 同意状态。
保存边界必须分层说明:
- 固定快照包含 18 枚币面、六爻结果、动爻、方法版本和内容版本;
- 问题原文、当次解读和行动记录由各自开关控制;
- 未完成问题与投币只用于当前流程恢复,不进入问卦簿;
- 存储范围是应用私有本机存储,默认不进入系统备份、设备迁移或云同步;
- 本地保存与 AI 发送是两个独立决定,自动保存绝不触发网络请求。
本地或 AI 解读在生成后应自动关联到当次会话,并给出轻量的“已加入本次记录”反馈。重新解读默认新增版本;若产品只保留一个版本,覆盖前必须让用户明确确认。
问卦簿要求:
- 列表按保存时间倒序,展示卦名、动爻概况、问题保存状态和解释来源;
- 空状态说明“完成起卦后会默认保存在本机;你可以在设置中关闭”,并提供“开始第一次记录”和“管理保存设置”;
- 详情展示保存时的卦象快照、问题状态、解释来源、方法/内容版本和可选行动;
- 删除使用明确确认对话框,并级联删除该会话关联的解释和行动记录;
- “清空全部”必须在设置或问卦簿菜单中二次确认,并清楚说明不可恢复范围;
- 返回列表后保留原滚动位置;从问卦簿开始新流程时,返回行为不得跳到首次欢迎页。
## 4. 视觉系统
### 4.1 风格关键词