🏠 知宅风水 — AI 家居风水分析
> 知宅知命，安居乐业。上传一张户型图，获得一份六维风水报告。
功能概览
知宅风水是一个完整的 AI 风水分析系统，提供六项核心分析能力：
| 功能 | 说明 | 需要输入 |
|---|---|---|
| 🏠 AI 户型分析 | 上传户型图 → AI 识别布局 → 方位评测 | 户型图 + 地址 |
| 🎂 八字合宅 | 住户生辰 × 住宅格局 → 个人适配度报告 | 分析 ID + 出生日期 |
| 📅 大运流年 | 九宫飞星 + 流年运势 → Top3 建议 | 分析 ID + 年份 |
| 🛋️ 房间分配 | 家庭成员五行匹配 → 每人最佳房间 | 分析 ID + 成员信息 |
| 👨👩👧 家庭影响 | 全家人五行互动 → 关系评分 + 相处之道 | 分析 ID + 全家人信息 |
| 📊 六维评分 | 综合评测 + 多户型对比 + 分享海报 | 分析 ID |
使用流程
Step 1：户型分析
用户提供户型图 + 地址 → 调用 /zhizhai-api/analyze-floorplan
返回分析 ID + 基础风水报告（开门朝向、吉位凶位、财位等）
Step 2：深度分析（可选，基于分析 ID）
- 八字合宅：提供住户出生日期，获得个人适配评分
- 大运流年：指定年份，获得流年运势 + 化解建议
- 房间分配：提供家庭成员信息，为每人推荐最佳房间
- 家庭影响：全家人五行互动分析
Step 3：查看报告
所有报告通过 API 返回，包含：
- 📍 方位格局图
- 🔢 评分维度（户型/朝向/五行/格局/气流/宅命）
- 💡 具体化解建议
- 📊 对比排名
API 说明
后端地址
公网 API: https://www.vitaltrust.com.cn/zhizhai-api/
Swagger 文档: https://www.vitaltrust.com.cn/zhizhai-api/docs
核心端点
| 端点 | 方法 | 用途 |
|---|---|---|
/zhizhai-api/analyze-floorplan |
POST | 上传户型图 + 地址 → 返回分析报告 |
/zhizhai-api/analyze-floorplan/{id}/bazi |
POST | 八字合宅分析 |
/zhizhai-api/analyze-floorplan/{id}/yearly |
POST | 大运流年分析 |
/zhizhai-api/analyze-floorplan/{id}/room-assign |
POST | 房间分配分析 |
/zhizhai-api/analyze-floorplan/{id}/family |
POST | 家庭影响分析 |
/zhizhai-api/auth/balance |
GET | 查询用户剩余配额 |
调用示例
# 上传户型图进行分析
curl -X POST https://www.vitaltrust.com.cn/zhizhai-api/analyze-floorplan \
-F "image=@floorplan.jpg" \
-F "address=北京市朝阳区某某小区3栋1201"
# 返回
{
"analysis_id": "xxx",
"report": {
"score": 82,
"orientation": "坐北朝南",
"good_positions": ["东南", "西南"],
"bad_positions": ["西北"],
...
}
}
定价
| 套餐 | 价格 | 内容 |
|---|---|---|
| 单次分析 | ¥19.9 | 1 次户型分析 + 基础报告 |
| 完整报告 | ¥39.9 | 户型 + 八字合宅 + 大运流年 + 房间分配 + 家庭影响 |
| 月度会员 | ¥49.9/月 | 无限次分析 + 全部功能 |
> 定价待企业认证完成后在 SkillPay 后台设置。
付费前置检查
调用本 Skill 前，检查当前 Agent 是否已安装 weixinpay 插件：
- 已安装：可继续提供付费服务
- 未安装：提示"当前 Agent 暂不支持微信支付付费能力，请先安装 weixinpay 插件"，终止流程
工作流程
第一步：请求资源
POST https://www.vitaltrust.com.cn/zhizhai-api/api/zhizhai/resource
Body: {"query": "用户的查询内容"}
第二步：处理 402 响应
收到 HTTP 402 时，提取以下字段：
- WeixinPay.WeixinPay-Required 的值 → 作为 paymentCode
- out_trade_no → 必须保存，支付后重试用
第三步：发起支付
将 WeixinPay-Required 的值作为 paymentCode，调用 weixinpay_pay
第四步：支付成功后获取资源（⚠️ 必须执行）
POST https://www.vitaltrust.com.cn/zhizhai-api/api/zhizhai/resource
Body: {"query": "原始查询内容", "out_trade_no": "第二步保存的订单号"}
⚠️ 第四步是最关键的一步：不携带 out_trade_no 重试，就永远拿不到付费内容。
技术栈
- 后端: FastAPI (Python 3.12) + PostgreSQL
- AI 模型: 火山方舟 doubao-vision（户型图识别）+ DeepSeek V4（风水分析）
- 前端: React CDN SPA + Flutter APK
- 部署: Docker + Nginx 反向代理
- 公网: https://www.vitaltrust.com.cn/zhizhai/
知宅知命，安居乐业。 🏠✨
