Python

一、前置知识与环境准备 命理推演的本质是时间坐标的精密转换与关系建模，而非玄学黑箱。本方案严格遵循《渊海子平》《滴天髓》等经典框架，将八字四柱（年、月、日、时）视为一个可计算的时空坐标系——输入是用户提供的公历出生时间与地理经度（如 "1992-02-05 14:30:00", "116.4"），输出是结构化命理数据：四柱干支、十神关系、五行旺衰分值、先天八卦映射编号。整个流程完全离线运行，不依赖任何网络API，既保障用户隐私（出生信息永不离开本地），也支持无网环境下的学术复现与教学演示。 ⚠️ 关键边界声明： 输入：datetime 对象（已带 pytz 时区） + 精确到0.1°的东经度数（如北京116.4°E，上海121.5°E） 输出：JSON 可序列化字典，含 {'year': '壬申', 'month': '壬寅', 'day': '戊辰', 'hour': '己未', 'ten_gods': [...], 'element_strength': {'wood': 0.82, ...}, 'bagua_number': 6} 必需依赖与环境配置 我们禁用所有网络请求类库（如 requests, httpx），仅选用轻量、确定性高的科学计算基础包： # 推荐 Python 版本：3.9+（兼容 `zoneinfo` 且避免旧版 `pytz` 时区陷阱） python3.9 -m venv bazi-env source bazi-env/bin/activate # Linux/macOS # bazi-env\Scripts\activate # Windows pip install julian pytz numpy julian：提供高精度儒略日（JD）计算，误差 < 0.001秒，是节气时刻推算的基石 pytz：处理中国标准时间（CST, Asia/Shanghai）与真太阳时转换 numpy：用于五行旺衰的向量化加权计算（后续章节详述） 时区与真太阳时校正：为什么经度不可省略？ 中国全境统一使用 Asia/Shanghai（UTC+8），但真太阳时（True Solar Time）取决于实际地理经度。北京时间以东经120°为基准，每偏离1°，时间差约4分钟。例如： ...

1. 环境准备与Claude API接入 让我们从零开始，快速打通本地开发环境与 Claude 的 AI 能力。这一步是后续所有自动化能力的地基，务必稳扎稳打。 首先安装官方 SDK（推荐使用 Python 3.9+）： pip install anthropic python-dotenv ✅ python-dotenv 非必需但强烈推荐——它能安全加载 .env 文件，避免 API Key 硬编码或意外提交。 接着，访问 Anthropic Console → API Keys → 点击 Create Key，复制生成的密钥（形如 sk-ant-api03-...）。切勿截图、勿存 GitHub、勿发群聊！ 在项目根目录创建 .env 文件（注意：文件名以 . 开头，隐藏）： ANTHROPIC_API_KEY=sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 最后，编写最小验证脚本 test_claude.py： # test_claude.py import os from dotenv import load_dotenv import anthropic load_dotenv() # 加载 .env 中的 ANTHROPIC_API_KEY client = anthropic.Anthropic() try: message = client.messages.create( model="claude-3-5-sonnet-20240620", max_tokens=100, messages=[{"role": "user", "content": "请用中文说一句打招呼的话"}] ) print("✅ 成功调用 Claude：", message.content[0].text.strip()) except Exception as e: print("❌ 调用失败：", e) 运行 python test_claude.py，应输出类似： ✅ 成功调用 Claude：你好！我是 Claude，很高兴为你提供帮助。 ...