tianwen / PRD.md
liuyd-dev's picture
v0: zero is infinite
07c10da verified
|
Raw
History Blame Contribute Delete
23.3 kB

A newer version of the Gradio SDK is available: 6.20.0

Upgrade

《司天御盘 · 赛博道心》产品需求文档 (PRD) V3.0

产品名称:司天御盘 (The Celestial Dial) · 赛博道心
产品形态:本地化部署的 Web 应用 (PWA 可安装)
版本号:V3.0 终版合并
文档状态:正式发布
面向团队:产品、设计、前端/动效、后端算法、内容策略、测试
密级:内部


目录

  1. 产品愿景与核心理念
  2. 用户画像与使用场景
  3. 五维时空算法模型
  4. 用户旅程与核心交互流程
  5. 功能模块详设
    • Tab1:知命观运(乾坤星图)
    • Tab2:时空日盘(首页日运)
    • Tab3:一事一请(摇卦决疑)
    • Tab4:日终结缘(司天集珍)
  6. 冷启动与首次引导
  7. 个性化与自适应
  8. 情绪日记与自我觉察
  9. 数据管理与隐私设计
  10. 本地AI技术架构
  11. 心理安全护栏与伦理守护
  12. 禅意美学与动效规范
  13. 音景与交互音效
  14. 无障碍与多语言
  15. 错误处理与边界情况
  16. 模型更新与内容维护
  17. 非功能性需求
  18. 开发路线图
  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-InstructGLM-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 变量)

--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-pythonllama.cppLLaMA-FactoryGradioThree.js
  • 心理援助热线:北京心理危机研究与干预中心 010-82951332,希望 24 热线 400-161-9995,生命热线 400-821-1215

结语:《司天御盘》不仅是一款产品,更是一场数字时代的东方文艺复兴实验。它用极简克制的留白承载华丽的文化图腾,用冰冷的技术包裹温暖的人性关怀。愿每位用户在此寻得片刻安宁,然后更有力量地走向属于自己的烟火人间。