时安解忧屋产品系统Vibe Coding

随着移动互联网发展，命理学、占卜术等传统文化内容正在经历数字化转型。Z世代对星座、塔罗、八字等内容接受度显著提高，社交媒体相关话题热度持续攀升，线上命理消费市场活跃。

但现有命理类产品存在几个核心痛点。第一，专业门槛过高，排盘规则复杂，普通用户拿到结果后看不懂，需要额外找大师解读。第二，AI融合程度浅，多数产品仅停留在机械排盘阶段，缺乏智能化的自然语言解读。第三，体验割裂，不同术数工具散落在不同App，用户想同时参考八字和奇门需要反复切换。第四，多端覆盖不足，多数产品仅支持单一平台。

"时安解忧屋"正是在此背景下立项，定位为一站式民俗命理参考平台。核心思路是将八字、奇门遁甲、六爻、梅花易数、紫微斗数、塔罗、择吉等多种术数整合到统一平台，并通过大语言模型对排盘结果进行专业解读，用自然语言向用户解释命盘含义。

商业模式采用"免费基础工具+付费AI解读"。排盘计算免费开放，AI深度解读通过积分按次收费。用户可充值获取积分，平台提供多种套餐。社区功能让用户分享经验、交流心得，形成用户粘性。

技术上，大语言模型具备了理解复杂命理数据并生成自然语言解读的能力，实现了传统术数服务的规模化交付。项目基于UniApp统一代码库，一套代码构建H5、微信、支付宝、头条、App五个平台，最大化用户覆盖面。

平台包含以下核心功能：

首页综合AI解读是核心入口。用户输入问题后，系统自动分析并推荐最合适的术数组合——问事业推荐八字+奇门，问感情推荐六爻+塔罗。后端自动排盘计算，再将结果送入大模型生成解读。整个过程通过SSE流式输出实时展示，以Tab卡片形式呈现多个术数的排盘和解读。

八字排盘输入出生时间和性别，自动计算四柱八字、十神、藏干、大运流年。还有合盘功能做合婚分析，专业细盘展示神煞纳音等。排盘后可触发AI解读，分析命局格局、五行旺衰、用神喜忌。

奇门遁甲支持时家奇门排盘，展示天盘、地盘、八门、九星、八神，AI结合用户问题分析盘中格局，支持多轮追问。

六爻排盘支持手动和自动两种起卦模式，计算六亲、世应、动爻、变卦。梅花易数支持时间起卦、数字起卦等多种方式。两者均配备AI对话式解读。

紫微斗数支持三合派和四化飞星两种模式，展示十二宫星曜分布，AI解读各宫位含义。

塔罗占卜提供多种牌阵，内置78张韦特塔罗牌数据，AI结合牌意、牌位、正逆位综合解读。

其他功能：择吉工具（查询吉日）、专属日历（农历黄历节气宜忌）、社区（发帖评论点赞）、积分中心（充值消费记录）、个人中心（命盘存档、排盘历史）。

技术栈：前端UniApp + Vue 3 + Pinia + Vite + SCSS，通过条件编译一套代码构建五个平台。后端Python Flask + SQLAlchemy + Flask-Login + Gunicorn，数据库SQLite/MySQL双模式。AI通过OpenAI SDK调用DeepSeek和豆包模型。排盘引擎依赖sxtwl（天文历）、ephem（天文计算）、lunar-python（农历）、iztro-py（奇门）等专业库本地计算。

架构前后端分离，通过HTTP和SSE通信。后端分排盘引擎层（本地高精度计算）和AI服务层（大模型解读），数据层17张表覆盖用户、排盘、对话、积分、社区等完整业务。

实现亮点：一、排盘引擎全部本地计算，不依赖第三方API，响应100毫秒以内。二、AI智能路由，根据关键词自动匹配术数组合。三、SSE流式输出，实时展示解读过程，支持中途取消。四、多端统一代码库，构建流水线自动执行三项补丁修复跨端差异。五、积分幂等设计，数据库唯一索引防重复扣费。六、体系化Prompt工程，每种术数专用System Prompt保证解读准确性。

技术难点：一是八字排盘精确计算，涉及公历农历互转、节气时刻、闰月、夜子时等复杂历法规则，通过天文历库解决。二是SSE多端兼容，小程序不支持EventSource，通过分块传输模拟实现。三是多术数联合解读的Prompt设计，不同术数数据格式差异大，需精心设计模板。四是跨端渲染一致性，通过构建后补丁脚本和自动化截图验证解决。