A newer version of the Gradio SDK is available: 6.20.0
《司天御盘 · 赛博道心》产品需求文档 (PRD) V3.0
产品名称:司天御盘 (The Celestial Dial) · 赛博道心
产品形态:本地化部署的 Web 应用 (PWA 可安装)
版本号:V3.0 终版合并
文档状态:正式发布
面向团队:产品、设计、前端/动效、后端算法、内容策略、测试
密级:内部
目录
- 产品愿景与核心理念
- 用户画像与使用场景
- 五维时空算法模型
- 用户旅程与核心交互流程
- 功能模块详设
- Tab1:知命观运(乾坤星图)
- Tab2:时空日盘(首页日运)
- Tab3:一事一请(摇卦决疑)
- Tab4:日终结缘(司天集珍)
- 冷启动与首次引导
- 个性化与自适应
- 情绪日记与自我觉察
- 数据管理与隐私设计
- 本地AI技术架构
- 心理安全护栏与伦理守护
- 禅意美学与动效规范
- 音景与交互音效
- 无障碍与多语言
- 错误处理与边界情况
- 模型更新与内容维护
- 非功能性需求
- 开发路线图
- 附录与参考
1. 产品愿景与核心理念
1.1 一句话定位
一款完全本地运行,以传统五维时空算法为骨架,以积极心理学为灵魂,以宋代美学与重彩工笔为肌肤的新中式运势洞察与心理自助 Web App。
1.2 核心理念三角
- 知命而不认命:命理是“人生天气预报”,低谷为蓄力期,顺境为耕作期。
- 导之以命,解之以心:所有解读最终落回认知行为疗法(CBT)、阿德勒课题分离、叙事疗法,提供可行动的建议而非宿命断言。
- 绝对隐私,绝对安宁:生辰八字与心中困惑由本地计算,物理级隔离,不上传任何云端。
1.3 科技向善
- 拒绝贩卖焦虑,严禁铁口直断,所有“凶煞”转化为心理成长的契机。
- 提供心理援助热线入口,具备危机自动熔断机制。
- 通过 AI 赋予传统命理以现代心理学的温情与科学感。
2. 用户画像与使用场景
| 画像 | 描述 | 核心诉求 |
|---|---|---|
| 都市知性青年 (25-40) | 对传统文化有亲近感但反感迷信,面临职场/关系焦虑,有基本技术能力 | 隐私安全,有行动建议,非说教式自我探索 |
| 文化修习者 (40+) | 热爱国学,希望通过命理进行自我省思 | 大字体,简洁操作,文化深度 |
| 心理助人者 | 咨询师/教练,将此作为辅助来访者自我觉察的工具 | 安全护栏可信,话术专业,可本地集成 |
使用场景:晨间快速查看日运(5秒),晚间摇卦复盘(3分钟),周末深读大运长河(10分钟),每日保存结缘图作为正念句点。
3. 五维时空算法模型
产品核心引擎基于一个层层嵌套的五维计算公式,所有数学排盘由 Python 开源库精确完成,LLM 仅负责自然语言转化:
| 维度 | 名称 | 数据来源 | 计算方式 | 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 质感的青铜古简或古木纹理龟壳轮廓,微微悬浮。
交互流程(情绪释放核心)
- 书愿:弹出无边框手写输入区,提示“落笔心中所念之事…”。用户输入后,文字化为白色字符粒子流,被“吸入”龟壳/简内。寓意问题被郑重收纳。
- 正念呼吸引导(新增):点击“开始摇卦”后,先进入10秒正念呼吸圆环动画(光晕随吸气扩大,呼气缩小),附文字“将注意力带回身体,默念所问之事”。
- 摇卦:界面提示“请轻摇手机”。调用设备陀螺仪,触发线性马达微震(模拟硬币滚动),播放高保真青铜碰撞声。6次摇动,每次摇完后一枚铜钱掉落至屏幕前方。
- 成爻:铜钱根据正反结果化为重墨横线(阴爻)或流金横线(阳爻),自下而上飞升至堆叠区。连续6次,完成本卦。
- 变爻:若存在老阳或老阴,对应爻线剧烈震动,水墨炸开或金羽飘落,形态互变(本卦→变卦)。上方浮现变卦。
- 解卦:卦象静止,下方淡入由本地 LLM 生成的解卦文本,融合六亲、六神意象与积极心理学建议,同时附《周易》原文简注(折叠区)。
- 微行动卡:自动生成 1 张行动卡片,包含 24 小时内可完成的小建议,可勾选完成。完成后的成就感会在 Tab4 结缘图中点亮一颗小星辰。
- 所有卦例保存在“请事录”中,可回看并记录事后发展。
情绪价值:具身交互将焦虑外化为可控的因果叙事,摇卦过程就是一场正念练习。
5.4 Tab4:日终结缘——司天集珍(信息沉淀)
界面
- 动态生成一幅“今日生命结缘图”:底层为今日黄历对应的主题色调(雨日青灰,晴日暖杏),中层为五行玉盘静态快照与六爻所得的六神线条图案,顶层为本命生肖剪影与极简断语(如“云在青天水在瓶”)。
- 图下方列出今日 CBT 行动建议 2~3 条,字体小而清晰。
交互
- 提供 3 种艺术风格模板(水墨留白、敦煌流金、宋画淡彩)供切换。
- “长按保存”按钮,导出高画质国潮壁纸。
- 历史结缘图收纳进“司天集珍”册页,可翻看过去每一天的结缘。
- 若用户有记录当日情绪,结缘图色调会轻微变化(快乐时略带暖杏色,低落时为沉静灰蓝,但都是美感的)。
情绪价值:给予每日心理句点,强化“我关照了自己”的自我关怀感。
6. 冷启动与首次引导
- 欢迎页:静默 3 秒后浮现水墨标题“司天御盘”,下方随机一句《易经》爻辞(如“君子以反身修德”)。
- 隐私承诺:全屏半透明遮罩展示“数据仅存于本设备,您可随时清除”的动画说明,用户勾选“我已知晓”后进入。
- 生辰采集向导:
- 第一步:选择生肖(视觉化卡片,单击选中,华丽插画)。
- 第二步:选择出生年月(滚动选择器)。
- 第三步:选择时辰(附带时辰对照表)。 每步配一句温柔提示:“您降临人间的那一刻,星辰便有了排列。”
- 首次奖励:星盘生成后,自动定位当前大运,弹出第一个“微行动卡”,让用户立刻获得可操作建议。
- 功能导览:在 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 变量)
--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
结语:《司天御盘》不仅是一款产品,更是一场数字时代的东方文艺复兴实验。它用极简克制的留白承载华丽的文化图腾,用冰冷的技术包裹温暖的人性关怀。愿每位用户在此寻得片刻安宁,然后更有力量地走向属于自己的烟火人间。