场景 对应功能
私人占卜仪式 五阶段抽牌（focus→shuffle→cut→draw→reveal）+ 触感与音频反馈
情绪陪伴与自省 AI 助手「小月」，温柔不宿命的解读 + 留白式开放式提问
牌义学习 /learning 翻卡学习页，78 张卡面 + 牌义复用
轻量化日常仪式 每日牌历（日期种子，同一天翻到同一张牌）
关系/事业专项咨询 恋爱 3 阵（关系阵 7 张、情感金字塔 6 张、关系发展预测 7 张）、事业 6 张阵
重大议题深度拆解 凯尔特十字 10 张大阵
私人纪念（隐藏层） 纪念日记录等
九种牌阵（数据驱动）、AI 解读五层法（总览/逐牌三层位置义/组合观察/整体叙事/建议/行动/结语/留白问句）、继续追问、RAG 知识库检索、每日牌历、牌义学习、Hive 本地历史（含 AI 分析存档）、分享海报（RepaintBoundary + share_plus）、设置（音频/触感/动效）、无障碍适配（48dp 触控、字号缩放、reduced-motion 降级）。
1 反幻觉工程 —— 这是全项目最有价值的设计
从 v1.5 起，AI 链路从"让模型自由生成"改成了「本地确定性底稿 → AI 仅润色」：
reading_draft_builder.dart 先从知识库逐牌 cardId 精确取回全文文档，解析出结构化事实（正逆位关键词、牌义、指引、画面意象），并按规则本地计算组合信号（大牌占比 / 花色主导 / 逆位比例）；
交给 DeepSeek 时用硬性约束："keywords 不得增删改、message 只能基于底稿展开、不得引入底稿以外的事实"；
无 Key / 超时 / 429 / 坏 JSON → 底稿直接作为解读（isFallback: true），主流程永不中断。
2 数据驱动的通用牌阵引擎：SpreadType 用 cardCount + positionLabels 描述所有牌阵，引擎里没有任何按牌阵分支的代码——新增任意 1–10 张牌阵只需加数据。
3 知识库工程化：单一数据源 kb/data/*.json → build-kb.js 构建器 → 同时产出运行时 KB、人读文档（docs/tarot-knowledge/03–07）、并对齐 App 的 78 个中文牌名做一致性测试。
4 失败安全贯穿全栈：Hive 不可用、box 缺失、设置读取失败、AI 全链路异常——每一处都有降级路径，不抛异常、不白屏。
5 确定性资产生成：品牌图标（五形状几何）、助手头像、卡面均由 Python 生成器产出，Flutter 侧有同几何的 Painter 兜底，图片加载失败会自动回退程序化卡面。
评论