手相大师专业看手相

概述

掌纹解析 (Palm Reading)

上传手掌照片，AI 分析掌纹特征（生命线、智慧线、感情线、事业线），生成包含健康分析、运势解析和性格特质的专业报告。

功能特点

• 掌纹识别: 自动识别生命线、智慧线、感情线、事业线等主要掌纹
• 健康分析: 基于掌纹可见特征做客观分析
• 运势解析: 基于传统相学文化解读事业、感情、财运
• 性格特质: 分析性格特点、行为倾向、优势与劣势
• 综合评分: 给出 0-100 的综合评分

付费前置检查

在调用此技能前，Agent 必须检查是否已安装 weixinpay 插件：

# 检查 weixinpay 插件是否可用
if not has_extension("weixinpay"):
    return "请先安装 weixinpay 插件以使用付费技能"

工作流程

第一步：上传手掌照片

请求方式：POST 请求地址：https://meihua.astrakairos.com/palm/api/resource

请求参数（multipart/form-data）：

• file: 手掌照片文件（JPG/PNG）

curl -X POST https://meihua.astrakairos.com/palm/api/resource 
  -F "file=@/path/to/palm.jpg"

首次响应（402 Payment Required，PAYMENT_REQUIRED）：

{
  "code": "PAYMENT_REQUIRED",
  "message": "请支付 ¥1.99 获取掌纹解析报告",
  "out_trade_no": "PM1A2B3C4D5E6F",
  "amount": "¥1.99",
  "WeixinPay": {
    "WeixinPay-Required": "payment_code_xxx",
    "prompt": "请将 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay"
  }
}

响应头：

• X-Out-Trade-No: 订单号
• WeixinPay-Required: 支付码

第二步：调用微信支付

使用第一步返回的 WeixinPay-Required 值调用微信支付插件：

# 调用 weixinpay 插件完成支付
payment_result = weixinpay_pay(paymentCode="payment_code_xxx")

第三步：重试请求（携带订单号）

支付成功后，必须使用相同的请求参数（同一张照片），并在请求头中携带订单号重新发起请求：

请求方式：POST 请求地址：https://meihua.astrakairos.com/palm/api/resource

请求头：

X-Out-Trade-No: PM1A2B3C4D5E6F

curl -X POST https://meihua.astrakairos.com/palm/api/resource 
  -F "file=@/path/to/palm.jpg" 
  -H "X-Out-Trade-No: PM1A2B3C4D5E6F"

成功响应（200 OK）：

{
  "code": "SUCCESS",
  "message": "分析完成",
  "out_trade_no": "PM1A2B3C4D5E6F",
  "result": {
    "palm_lines": {
      "生命线": {"length": "长", "depth": "深", "curvature": "弧度适中", "quality": "良"},
      "智慧线": {"length": "长", "depth": "深", "clarity": "清晰", "quality": "良"}
    },
    "health_analysis": "从掌纹整体来看，您的健康状况良好...",
    "fortune_analysis": "事业线清晰可见，说明您在职业发展上有明确的方向...",
    "character_analysis": "从掌纹特征来看，您是一个理性与感性并重的人...",
    "overall_score": 82,
    "html_report": "<!DOCTYPE html>..."
  }
}

第四步（可选）：查看报告页面

curl https://meihua.astrakairos.com/palm/report/PM1A2B3C4D5E6F

返回完整的 HTML 报告页面。

API 端点

POST /api/resource

分析手掌照片的掌纹

请求参数:

• file: 手掌照片文件（multipart/form-data）
• X-Out-Trade-No: 订单号（Header，支付后重试时必须提供）

响应:

• 首次请求: 402 状态码，包含支付信息
• 支付后重试: 200 状态码，包含分析结果

GET /api/health

健康检查接口

请求地址：https://meihua.astrakairos.com/palm/api/health

{
  "status": "ok",
  "mode": "production",
  "price": "¥1.99",
  "service": "palm-reading"
}

GET /report/{order_id}

获取报告页面（HTML）

请求地址：https://meihua.astrakairos.com/palm/report/{order_id}

响应:

• 200: 返回 HTML 报告页面
• 404: 订单不存在

POST /api/pay/notify

微信支付结果异步回调（服务内部使用）。

支付流程

1. 首次请求 → 返回 402 状态码 + PAYMENT_REQUIRED + 支付信息
2. 用户支付 → 调用 weixinpay_pay(paymentCode=...) 完成微信支付
3. 重试请求 → 携带 X-Out-Trade-No header 用相同参数重新请求
4. 返回结果 → 200 状态码，包含分析结果

异常处理

重试策略：支付完成后如查询订单仍返回 402 NOT_PAID，等待 3 秒后重试，最多重试 3 次（支付状态同步可能有延迟）。

注意事项

• 请上传清晰的手掌照片，建议光线充足
• 手掌应完全展开，手指自然伸展
• 健康分析基于掌纹可见特征做客观分析，运势解读基于传统相学文化
• 本报告仅供参考，不构成医疗或投资建议

技术栈

• 后端框架: FastAPI
• 视觉模型: Qwen-VL-Max (DashScope)
• 支付集成: 微信支付 Native 支付 (X402 协议)

许可证

MIT License