🏠 知宅风水 — AI 家居风水分析

知宅知命，安居乐业。上传一张户型图，获得一份六维风水报告。

功能概览

知宅风水是一个完整的 AI 风水分析系统，提供六项核心分析能力：

使用流程

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

核心端点

调用示例

# 上传户型图进行分析
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": ["西北"],
    ...
  }
}

定价

定价待企业认证完成后在 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/

知宅知命，安居乐业。 🏠✨