# 《司天御盘 · 赛博道心》产品需求文档 (PRD) V3.0 **产品名称**：司天御盘 (The Celestial Dial) · 赛博道心 **产品形态**：本地化部署的 Web 应用 (PWA 可安装) **版本号**：V3.0 终版合并 **文档状态**：正式发布 **面向团队**：产品、设计、前端/动效、后端算法、内容策略、测试 **密级**：内部 --- ## 目录 1. [产品愿景与核心理念](#1-产品愿景与核心理念) 2. [用户画像与使用场景](#2-用户画像与使用场景) 3. [五维时空算法模型](#3-五维时空算法模型) 4. [用户旅程与核心交互流程](#4-用户旅程与核心交互流程) 5. [功能模块详设](#5-功能模块详设) - Tab1：知命观运（乾坤星图） - Tab2：时空日盘（首页日运） - Tab3：一事一请（摇卦决疑） - Tab4：日终结缘（司天集珍） 6. [冷启动与首次引导](#6-冷启动与首次引导) 7. [个性化与自适应](#7-个性化与自适应) 8. [情绪日记与自我觉察](#8-情绪日记与自我觉察) 9. [数据管理与隐私设计](#9-数据管理与隐私设计) 10. [本地AI技术架构](#10-本地AI技术架构) 11. [心理安全护栏与伦理守护](#11-心理安全护栏与伦理守护) 12. [禅意美学与动效规范](#12-禅意美学与动效规范) 13. [音景与交互音效](#13-音景与交互音效) 14. [无障碍与多语言](#14-无障碍与多语言) 15. [错误处理与边界情况](#15-错误处理与边界情况) 16. [模型更新与内容维护](#16-模型更新与内容维护) 17. [非功能性需求](#17-非功能性需求) 18. [开发路线图](#18-开发路线图) 19. [附录与参考](#19-附录与参考) --- ## 1. 产品愿景与核心理念 ### 1.1 一句话定位 一款**完全本地运行**，以传统五维时空算法为骨架，以积极心理学为灵魂，以宋代美学与重彩工笔为肌肤的**新中式运势洞察与心理自助 Web App**。 ### 1.2 核心理念三角 - **知命而不认命**：命理是“人生天气预报”，低谷为蓄力期，顺境为耕作期。 - **导之以命，解之以心**：所有解读最终落回认知行为疗法（CBT）、阿德勒课题分离、叙事疗法，提供可行动的建议而非宿命断言。 - **绝对隐私，绝对安宁**：生辰八字与心中困惑由本地计算，物理级隔离，不上传任何云端。 ### 1.3 科技向善 - 拒绝贩卖焦虑，严禁铁口直断，所有“凶煞”转化为心理成长的契机。 - 提供心理援助热线入口，具备危机自动熔断机制。 - 通过 AI 赋予传统命理以现代心理学的温情与科学感。 --- ## 2. 用户画像与使用场景 | 画像 | 描述 | 核心诉求 | |------|------|----------| | 都市知性青年 (25-40) | 对传统文化有亲近感但反感迷信，面临职场/关系焦虑，有基本技术能力 | 隐私安全，有行动建议，非说教式自我探索 | | 文化修习者 (40+) | 热爱国学，希望通过命理进行自我省思 | 大字体，简洁操作，文化深度 | | 心理助人者 | 咨询师/教练，将此作为辅助来访者自我觉察的工具 | 安全护栏可信，话术专业，可本地集成 | 使用场景：晨间快速查看日运（5秒），晚间摇卦复盘（3分钟），周末深读大运长河（10分钟），每日保存结缘图作为正念句点。 --- ## 3. 五维时空算法模型 产品核心引擎基于一个层层嵌套的五维计算公式，**所有数学排盘由 Python 开源库精确完成，LLM 仅负责自然语言转化**： $$实时事件/当日综合气场 = 【维度一：命】 \times 【维度二：运】 \times 【维度三：日运】 \times 【维度四：状态】 \times 【维度五：成败】$$ | 维度 | 名称 | 数据来源 | 计算方式 | UI呈现 | |------|------|----------|----------|--------| | 一 | 命 | 出生公/农历时间 | `lunar-python` 排盘：八字、五行旺衰、喜用神、本命生肖、神煞 | 本命星盘、生肖守护神工笔插画 | | 二 | 运 | 出生时间+当前年份 | 十年大运干支，判断与日主生克系数 | 星盘外圈大运环，当前大运高亮光环 | | 三 | 日运 | 今日公历日期 | 老黄历：日干支、建除十二神、宜忌 | 日晷区干支与宜忌卡片 | | 四 | 状态 | 本命+大运+今日干支 | 流日五行力量对比，得出个人当日五行能量分布 | 五行能量玉盘（五色流体） | | 五 | 成败 | 用户摇卦（六爻） | 铜钱正反面→阴阳爻→本卦、变卦、六亲、六神 | 卦象动画、六神显现、心理引导解卦 | --- ## 4. 用户旅程与核心交互流程 ``` [首次启动] → 隐私承诺 → 生辰采集向导 → 星盘织造动画 → 自动进入 Tab1 [日常回访] → 默认进入 Tab2（时空日盘），大运注入动画 → 可记录情绪 → 可查看 Tab1/3/4 [特定抉择] → Tab3 摇卦 → 正念呼吸引导 → 6次摇卦 → 变卦动画 → 解卦+行动卡片 [一日终结] → Tab4 自动生成今日结缘图 → 可保存/回看历史 → 感受闭环 [设置与档案] → 可切换用户档案、导出备份、调整偏好 ``` **交互原则**：关键路径≤3步；支持单手操作；给予即时的视觉/听觉/触觉（震动）反馈。 --- ## 5. 功能模块详设 ### 5.1 Tab1：知命观运——乾坤星图（命 & 运维度） **界面** - 背景：深黛色 (`#1a1f2b`) 静止夜空，散布极细白色星芒粒子，缓慢浮动。 - 中央：由 1px 金色 (`#c5a46b`) 线条勾勒的“先天八字本命星盘”，中心为日柱天干大字，外围环绕十天干地支。 - 外圈：10个半透明同心圆环，代表一生大运（每运十年），环上标注干支名称，当前所处大运环呈“日全食光环”效果（淡金粒子呼吸）。 - 侧方或背景暗处：**新中式工笔重彩本命生肖守护神壁画**，半透明融入，华丽但克制。 **交互与动效** - 首次生辰录入后触发**织造动画**：一袅白烟升腾，黑洞扩散，金丝如绸编织成星盘，生肖壁画渐显。 - 用户上下滑动（移动端）或滚轮（桌面），大运环随星盘旋转，惯性缓停。 - 点击某大运环，弹出浮层显示该运简析（由本地 LLM 生成，积极心理学话术），大运环暂时放大。 - 长按星盘上任一干支或神煞，弹出解释小卡片，如“羊刃：代表锐利而专注的能量，用在创作上是利器”。 - 支持查看未来大运叙事，强调“起伏本是常态”。 **情绪价值**：将生命长河星图化，获得宏观视角，淡化当下焦虑。 --- ### 5.2 Tab2：时空日盘——首页（日运 & 状态维度） **界面** - 背景：宣纸白 (`#f9f6f0`) 质感，细微纸纹。 - 上部“天时区”：极简半透明线条构成的日晷，竖排宋体显示今日干支及黄历宜忌摘要（如“宜纳财、会友”“忌争讼”）。 - 下部“人和区”：温润玉石质感的圆盘，盘内五颗半透明流体球（Metaball），分别对应五行：金（白）、木（青）、水（蓝）、火（赤）、土（黄）。大小与基线五行比例一致。 - 日晷旁提供“今日心境”轻记录入口，可选一个表情符号（云/晴/雨/风）配短句。 **交互与动效** - **注入动画**：每日首次打开，一缕代表“当前大运五行属性”的半透明气流从屏幕上方丝滑垂下，**注入**玉盘。 - **流体融合**：五色流体受注入影响有机流动，利于木则青球舒展微光，不利则水球缩紧变暗，整体过程约3秒，伴随极低音风铃。 - **触摸涟漪**：手指轻点玉盘任何位置，产生一圈涟漪，流体轻微避让，暗示“你的关注扰动能量场”。 - **长按调和**：长按玉盘进入“调和模式”，可拖动某行流体向另一行移动，象征“泄秀”或“扶抑”，松开后弹出短句：“你正将木之生发导向火之热情，这在心理学上如同将创造力转化为行动。”不改变实际算法，纯心理暗示。 - **能量历史回放**：双指下滑查看过去7日玉盘状态快照，翻页式浏览。 - 点击“宜忌”条目弹出精致民俗插画卡片（童子戏鲤图等，克制华丽），再次点击消失。 **情绪价值**：直观“看见”内在能量状态，将模糊不适转化为可调节的五行比例，增强掌控感。 --- ### 5.3 Tab3：一事一请——心卦明镜（成败维度） **界面** - 背景：深赭石色至暗棕色渐变，模拟静室暗光。 - 中央：具备 3D 质感的青铜古简或古木纹理龟壳轮廓，微微悬浮。 **交互流程（情绪释放核心）** 1. **书愿**：弹出无边框手写输入区，提示“落笔心中所念之事…”。用户输入后，文字化为白色字符粒子流，被“吸入”龟壳/简内。寓意问题被郑重收纳。 2. **正念呼吸引导**（新增）：点击“开始摇卦”后，先进入10秒正念呼吸圆环动画（光晕随吸气扩大，呼气缩小），附文字“将注意力带回身体，默念所问之事”。 3. **摇卦**：界面提示“请轻摇手机”。调用设备陀螺仪，触发线性马达微震（模拟硬币滚动），播放高保真青铜碰撞声。6次摇动，每次摇完后一枚铜钱掉落至屏幕前方。 4. **成爻**：铜钱根据正反结果化为重墨横线（阴爻）或流金横线（阳爻），**自下而上**飞升至堆叠区。连续6次，完成本卦。 5. **变爻**：若存在老阳或老阴，对应爻线剧烈震动，水墨炸开或金羽飘落，形态互变（本卦→变卦）。上方浮现变卦。 6. **解卦**：卦象静止，下方淡入由本地 LLM 生成的解卦文本，融合六亲、六神意象与积极心理学建议，同时附《周易》原文简注（折叠区）。 7. **微行动卡**：自动生成 1 张行动卡片，包含 24 小时内可完成的小建议，可勾选完成。完成后的成就感会在 Tab4 结缘图中点亮一颗小星辰。 8. 所有卦例保存在“请事录”中，可回看并记录事后发展。 **情绪价值**：具身交互将焦虑外化为可控的因果叙事，摇卦过程就是一场正念练习。 --- ### 5.4 Tab4：日终结缘——司天集珍（信息沉淀） **界面** - 动态生成一幅“今日生命结缘图”：底层为今日黄历对应的主题色调（雨日青灰，晴日暖杏），中层为五行玉盘静态快照与六爻所得的六神线条图案，顶层为本命生肖剪影与极简断语（如“云在青天水在瓶”）。 - 图下方列出今日 CBT 行动建议 2~3 条，字体小而清晰。 **交互** - 提供 3 种艺术风格模板（水墨留白、敦煌流金、宋画淡彩）供切换。 - “长按保存”按钮，导出高画质国潮壁纸。 - 历史结缘图收纳进“司天集珍”册页，可翻看过去每一天的结缘。 - 若用户有记录当日情绪，结缘图色调会轻微变化（快乐时略带暖杏色，低落时为沉静灰蓝，但都是美感的）。 **情绪价值**：给予每日心理句点，强化“我关照了自己”的自我关怀感。 --- ## 6. 冷启动与首次引导 1. **欢迎页**：静默 3 秒后浮现水墨标题“司天御盘”，下方随机一句《易经》爻辞（如“君子以反身修德”）。 2. **隐私承诺**：全屏半透明遮罩展示“数据仅存于本设备，您可随时清除”的动画说明，用户勾选“我已知晓”后进入。 3. **生辰采集向导**： - 第一步：选择生肖（视觉化卡片，单击选中，华丽插画）。 - 第二步：选择出生年月（滚动选择器）。 - 第三步：选择时辰（附带时辰对照表）。 每步配一句温柔提示：“您降临人间的那一刻，星辰便有了排列。” 4. **首次奖励**：星盘生成后，自动定位当前大运，弹出第一个“微行动卡”，让用户立刻获得可操作建议。 5. **功能导览**：在 Tab 栏旁提供 “？” 图标，点击以轻提示标注各 Tab 功能，3秒消失。 --- ## 7. 个性化与自适应 - **五行关注收藏**：长按玉盘某行流体，标记“我关注”，后续日签和结缘图会强化该行色彩。 - **内容偏好**：设置中可选择“深度解读/简短语录”、“偏重心理/偏重文化典故”，LLM 输出时调整。 - **提醒频率**：可设置每日推送提醒时间，或关闭所有通知。 - **生肖护符风格**：在 Tab1 中可为自己的本命生肖选择不同艺术风格插画（工笔/水墨/剪纸）。 - **多用户档案**：支持创建多个本地档案（如家庭成员），切换后各自独立。 --- ## 8. 情绪日记与自我觉察 - 在 Tab2 日晷旁提供“今日心境”轻入口，可选一个表情符号（云/晴/雨/风）并配一句话记录。 - 存储于本地，形成周/月心情趋势小图（极简折线，附在结缘图下方可展开）。 - 情绪记录影响结缘图色调，但不影响排盘算法。 - 用户可在设置中清除所有情绪日志。 --- ## 9. 数据管理与隐私设计 - **本地存储介质**：IndexedDB（用户档案、卦例、日运记录）、LocalStorage（设置、缓存标识）、Cache API（PWA 离线资源）。明确告知用户，不包含任何第三方追踪。 - **加密导出**：设置中提供“备份全部数据”按钮，生成 AES 加密的 `.celestial` 文件，密码由用户设定。 - **导入恢复**：新设备导入该文件，输入密码，完整恢复所有个人档案和记录。 - **一键清除**：提供“清除所有本地数据”，二次确认后回到首次启动状态。 - **PWA 隐私**：Service Worker 缓存仅用于静态资源，不缓存任何个人数据；注册的 Service Worker 在清除数据时一并注销。 - **免责声明**：界面底部常驻淡色文字：“本系统基于传统文化与人工智能，仅供个人心性探索与娱乐，不替代专业医疗、心理咨询与财务决策。” --- ## 10. 本地AI技术架构 ### 10.1 技术栈 - **基座模型**：`Qwen2.5-7B-Instruct` 或 `GLM-4-9B-Chat`（中文古文理解力强）。 - **微调框架**：LLaMA-Factory，LoRA 方法。 - **量化部署**：合并 LoRA 权重后转 GGUF 格式，推荐 `Q4_K_M`。使用 `llama.cpp` 启动 OpenAI 兼容 API 服务。 - **排盘库**：`lunar-python`，输入公历/农历时间，输出完整八字、大运、流年、神煞等结构化 JSON。 - **后端**：Python 脚本，负责排盘计算、Prompt 拼装、危机词拦截、调用本地 LLM API。 - **前端**：Gradio 基础框架 + 深度定制 CSS/JS，使用 Three.js / PixiJS 实现 WebGL 流体与卦象动效。 ### 10.2 推理优化 - **流式输出**：前端以“墨迹晕开”动画逐字显示 LLM 回应。 - **后台预生成**：每日首次进入 Tab2 时，后台静默调用 LLM 生成当日运势详细文本，缓存本地，秒开。 - **分级响应**：宜忌解释等简单查询使用本地规则，深度解卦才调用 7B 模型。 - **超时与取消**：生成超过 20 秒显示“凝思中…”，允许取消。 ### 10.3 防幻觉机制 - LLM 不接触任何干支计算，仅接收结构化数据。 - Prompt 中强制要求“只能基于提供的排盘数据解读，严禁编造干支或神煞”。 - 输出后置过滤，再次检查是否出现宿命性词汇。 --- ## 11. 心理安全护栏与伦理守护 ### 11.1 Prompt 内置词汇映射（不可绕过） System Prompt 强制模型按以下映射转化，并融合积极心理学模板： - “七杀攻身” → “外部压力较大，适合借此修炼心理边界” - “枭神夺食” → “内心敏感期，减少外界噪音，专注向内滋养” - “伤官见官” → “思维活跃、富有批判精神，可导向创造性工作” - “比劫夺财” → “注意人际边界，把精力收回自己身上” - 结尾必须附“今日可行的一小步”具体行动建议。 ### 11.2 硬代码危机拦截 - 后端部署敏感词字典（包含自我伤害、绝望等词汇及变体），命中后**直接阻断** LLM 调用。 - 返回固定安慰文案，并显著显示官方心理援助热线（如 010-82951332、400-161-9995）。 - 文案示例：“此刻的风浪或许让你感到孤独，但请记得，寻求帮助是勇者的选择。” ### 11.3 测试与迭代 - 建立“红线攻击测试集”（100 条极端输入），定期自动化回归。 - 用户反馈中若连续 3 次点击“没帮助”，提示“先生偶尔也固于定式，您可稍后重试或更换问题表述”，并记录日志（本地）用于微调数据优化。 --- ## 12. 禅意美学与动效规范 ### 12.1 色彩体系 (CSS 变量) ```css --bg-paper: #F9F6F0; --bg-night: #1C1F24; --gold-line: #C5A46B; --jade-green: #5C7A6B; --ink-black: #2E2E2E; --soft-grey: #B5AFA3; --accent-cyan: #7BA5A8; --accent-rouge: #A35B5B; ``` ### 12.2 排版与字体 - 中文优先 `Noto Serif CJK SC`（思源宋体），标题可选用汉仪瑞意宋/方正清刻本悦宋（需授权）。 - 行距 1.8~2.0，段间距大，字间距 0.05em。 - 竖排古文使用 CSS `writing-mode: vertical-rl`。 - 所有文字与背景对比度 ≥ 4.5:1。 ### 12.3 UI 组件原则 - 1px 极细线条，无拟物投影，留白面积≥40%。 - 按钮：竹叶青底色，悬停加深，点击缩放 0.97。 - 卡片：从模糊到清晰（`backdrop-filter` 渐变），无阴影。 - 动效贝塞尔曲线 `cubic-bezier(0.4, 0.0, 0.2, 1)`，慢起快落。 ### 12.4 华丽插画规范（克制华丽） - 仅在关键节点出现：生肖守护神（工笔重彩）、宜忌卡片（暗金勾边民俗）、六神显现（线描加淡彩）、结缘图模板。 - 插画作为背景时须暗化处理（`opacity: 0.4` 或叠加半透明遮罩），不得反客为主。 - 所有插画需提供 2x 分辨率，适应 Retina 屏。 ### 12.5 动效性能底线 - 五行流体 Metaball、龟壳 3D、粒子动画等在移动端主流 GPU 稳定 60fps。 - 使用 WebGL（Three.js / PixiJS）实现流体，Canvas 2D 作为降级方案。 --- ## 13. 音景与交互音效 - **环境音**：默认静音，可在设置中开启“空山鸟语”“细雨无声”等极低分贝白噪音（需用户授权）。 - **UI 交互音**： - 青铜碰撞声：真币采样，中低频混响。 - 爻象落定：短促木印盖章声。 - 变爻炸裂：水墨泼洒“沙沙”声。 - 大运气流注入：微弱风铃。 - 所有音频响度归一化，提供一键静音开关。 --- ## 14. 无障碍与多语言 - 屏幕阅读器：为非文本元素提供 `aria-label`，如“当前木行能量饱满，青绿色流体舒展”。 - 色盲友好：流体状态辅以纹理变化（如受克时出现细微裂纹），宜忌用图标辅助颜色。 - 大号字体模式：设置中开启，全局字体放大。 - 多语言：MVP 支持简体中文、繁体中文（前端切换）。远期考虑英语，易经术语转译为心理学表达。 --- ## 15. 错误处理与边界情况 | 场景 | 处理方式 | |------|----------| | 缺时辰输入 | 默认“子时”并提示“若时辰未知，解读可能稍有偏差” | | 时间超出范围 | 提示“暂不支持此时间范围” | | LLM 服务未连接 | 显示“本地禅思服务未启动，请确认已运行”，提供一键检测端口按钮 | | 摇卦中途退出 | 保留进度，再次进入时提示“上次摇卦未完成，是否继续？” | | 生成超时 | 显示“先生正在凝思，请稍候…”，提供取消按钮 | | 隐私声明未同意 | 所有功能不可用，焦点锁定在同意按钮 | | 陀螺仪不可用 | 提供“手动摇卦”模式，点击按钮代替摇动 | --- ## 16. 模型更新与内容维护 - 版本号：设置页显示当前模型版本、知识库版本、安全护栏词库版本。 - 本地增量更新：从指定路径加载新的安全词汇库、微行动建议库（JSON 文件），应用自动合并，无需重新部署模型。 - 用户反馈：解卦结果下方提供“有帮助/没帮助”拇指按钮，本地统计，导出的备份中包含反馈数据，用于后续微调迭代。 --- ## 17. 非功能性需求 - **性能**：首屏加载 < 2 秒 (PWA 缓存)，LLM 首 token < 2 秒 (RTX 3060)，动效 60fps。 - **兼容性**：Chrome/Safari/Firefox 最新版，移动端优先触控与陀螺仪交互。 - **安全性**：无外部网络请求（除检查更新可选），所有数据本地加密，敏感词拦截。 - **可维护性**：代码模块化，排盘算法与 LLM 调用解耦，UI 组件可替换。 - **隐私合规**：符合 GDPR 理念（仅本地数据），无 Cookie 追踪。 --- ## 18. 开发路线图 | 阶段 | 时间 | 关键任务 | 产出 | |------|------|----------|------| | **M1 底座** | 第1周 | 部署 llama.cpp，测试 Qwen2.5-7B GGUF 流式 API；搭建 Python 后端骨架 | 可对话的本地服务 | | **M2 排盘** | 第2周 | 集成 lunar-python，构建五维数据拼装模块；调试 System Prompt | 结构化排盘字符串与初级解读 | | **M3 微调** | 第3周 | 构建 800+ 安全 QA 对，LLaMA-Factory LoRA 微调，量化 GGUF | 具备心理话术的定制模型 | | **M4 前端 V1** | 第4周 | 基于 Gradio 实现 4 个 Tab，注入禅意 CSS，完成星盘、玉盘、龟壳原型 | 功能可用但动效基础 | | **M5 动效深化** | 第5周 | Three.js 流体、卦象粒子动画、织造动画、音效集成 | 华丽动效落地 | | **M6 护栏与冷启动** | 第6周 | 硬拦截、词汇映射校验、红线测试集、Onboarding 向导 | 安全与体验闭环 | | **M7 测试与打包** | 第7周 | 性能优化、多设备适配、PWA 离线支持、一键启动包制作 | Beta 版发布 | | **M8 迭代** | 第8周+ | 用户反馈收集、词库更新、多语言、高级交互（调和模式等） | 持续迭代 | --- ## 19. 附录与参考 - 古籍参考：《渊海子平》《滴天髓》《三命通会》《穷通宝鉴》《紫微斗数全书》《高岛易断》 - 心理学参考：阿德勒《被讨厌的勇气》、CBT 核心技术、叙事疗法外部化技术 - 开源库：`lunar-python`、`llama.cpp`、`LLaMA-Factory`、`Gradio`、`Three.js` - 心理援助热线：北京心理危机研究与干预中心 010-82951332，希望 24 热线 400-161-9995，生命热线 400-821-1215 --- **结语**：《司天御盘》不仅是一款产品，更是一场数字时代的东方文艺复兴实验。它用极简克制的留白承载华丽的文化图腾，用冰冷的技术包裹温暖的人性关怀。愿每位用户在此寻得片刻安宁，然后更有力量地走向属于自己的烟火人间。