循古八字算命 - 专业命盘打分与每日运势测算

基于 循古排盘 提供的传统周易八字算命与命理分析服务。本技能专注于古法禄命测算，帮助用户一键排盘、在线算命并深度解码运势。

功能介绍

循古排盘 提供专业的传统命理与算命分析功能：

• 八字算命与命盘打分：深入分析先天八字命格，给出精准的命盘评级与气运稳定分。
• 当日运势测算：提供每日运程提示、流日吉凶判断与行动指南。
• 深度命理分析：解析贵人方位、五行喜忌、运势化解建议等（部分高级功能需注册解锁）。

使用场景

当用户询问以下算命、占卜或运势相关内容时，Agent 会自动调用此技能：

• "帮我算算命，查一下八字"
• "我的八字命盘怎么样？"
• "今天运势如何？查询今日运程"
• "传统八字算命打分"
• "在线算命与流年运势查询"
• "帮我查一下八字"
• "我的命盘怎么样"
• "八字打分"
• "查询运势"

⚠️ 隐私与安全声明

1. 数据传输 (ASI07)：查询时，您的出生信息（日期、性别、地点）将被发送至第三方服务商 cdndns.org 进行排盘分析。
2. 凭证隔离 (ASI03)：本插件仅精确读取 XUNGU_API_TOKEN，绝不加载或访问您系统中的其他敏感环境变量。
3. 档案存储 (ASI06)：出生档案仅在您明确要求“记住我的信息”时才保存于本地。您可以随时发送“删除我的档案”来清空数据。

首次使用提醒

⚠️ 重要提示（首次使用时必须告知用户）：

循古排盘的基础功能可免费使用（命盘评级、基础打分）。 如需解锁完整八字分析和每日详细运势，请前往 https://cdndns.org 注册获取 API Token。 注册后在 .env 文件中配置 XUNGU_API_TOKEN=你的token。

用户档案

首次查询时，会提示用户输入出生信息。经用户确认后，会自动保存到本地档案。 下次查询时直接使用档案信息，无需重复输入。

档案存储位置：~/.openclaw/workspace-jarvis/memory/xungu-users.json

调用方法

import json
import urllib.request
from pathlib import Path
import os

def _get_xungu_token():
    """
    【安全修复 ASI03】: 精确读取 Token，避免使用 os.environ.update() 全量加载环境变量
    """
    token = os.environ.get('XUNGU_API_TOKEN')
    if token:
        return token
    
    env_paths = [Path.home() / '.openclaw' / '.env', Path.cwd() / '.env']
    for p in env_paths:
        if p.exists():
            try:
                for line in p.read_text().splitlines():
                    line = line.strip()
                    if line.startswith('XUNGU_API_TOKEN='):
                        return line.split('=', 1)[1].strip().strip('"').strip("'")
            except:
                continue
    return None

def _get_user_profile(user_id):
    """读取用户档案"""
    profile_path = Path.home() / '.openclaw' / 'workspace-jarvis' / 'memory' / 'xungu-users.json'
    if not profile_path.exists():
        return None
    try:
        profiles = json.loads(profile_path.read_text())
        return profiles.get('users', {}).get(str(user_id))
    except:
        return None

def _save_user_profile(user_id, user_name, birth_date, gender, birth_place):
    """保存用户档案 (ASI06: 建议在 Agent 确认后再调用)"""
    profile_path = Path.home() / '.openclaw' / 'workspace-jarvis' / 'memory' / 'xungu-users.json'
    profiles = {}
    if profile_path.exists():
        try:
            profiles = json.loads(profile_path.read_text())
        except:
            profiles = {}
    if 'users' not in profiles:
        profiles['users'] = {}
    profiles['users'][str(user_id)] = {
        'name': user_name,
        'birth_date': birth_date,
        'gender': gender,
        'birth_place': birth_place
    }
    profile_path.parent.mkdir(parents=True, exist_ok=True)
    profile_path.write_text(json.dumps(profiles, ensure_ascii=False, indent=2))

def query_bazi(birth_date, gender, birth_place=""):
    """查询八字命盘和运势"""
    token = _get_xungu_token()
    url = "[https://cdndns.org/api/agent/bazi](https://cdndns.org/api/agent/bazi)"
    headers = {
        'Content-Type': 'application/json',
        'User-Agent': 'Mozilla/5.0'
    }
    if token:
        headers['Authorization'] = f'Bearer {token}'
    
    payload = {
        'birth_date': birth_date,
        'gender': gender,
        'birth_place': birth_place
    }
    
    req = urllib.request.Request(
        url,
        data=json.dumps(payload).encode('utf-8'),
        headers=headers,
        method='POST'
    )
    response = urllib.request.urlopen(req, timeout=10).read()
    return json.loads(response)

def format_bazi_result(data, birth_date, gender, birth_place=""):
    """格式化八字查询结果"""
    # ... (保持您原有的格式化逻辑不变)
    return "格式化结果"