命理咨询入门工具（免费版）

概述

本工具为个人用户提供传统命理八字分析能力。基于出生时间排出八字命盘，分析五行强弱、性格特质与流年运势。适合对传统命理文化感兴趣的个人用户，用于自我认知与人生规划参考. 注：本工具内容仅供文化娱乐参考，不构成任何决策建议.

核心能力

分析功能

功能	说明	免费版支持
命盘排盘	八字四柱排盘	支持
五行分析	五行强弱分布	支持
性格解读	基于命盘的性格分析	支持
流年运势	年度运势概览	支持
合婚分析	两人命盘匹配	不支持
事业财运	深度财运分析	基础概述
健康提示	体质与健康建议	不支持
大运分析	十年大运走势	不支持

处理: 解析分析功能的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回分析功能的响应数据,包含状态码、结果和日志.

八字四柱排盘与解析

柱位	说明	信息
年柱	出生年份	祖业根基
月柱	出生月份	父母兄弟
日柱	出生日子	自身配偶（日主为自身）
时柱	出生时辰	子女晚运

处理: 解析八字四柱说明的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回八字四柱说明的响应数据,包含状态码、结果和日志.

核心功能执行

用input_params参数进行配置.

处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志.

执行此能力时使用input_params参数,支持创建/查询/导出操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：传统命理八字分析、提供基础命盘排盘、与性格特质解读、面向个人用户的传、统命理咨询工具、基于八字命理学说、提供基础命盘、性格特质解读与流、年运势概览、Use、when、需要数据分析、报表生成、统计洞察、数据可视化时使用、不适用于实时流数、据处理、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

使用场景

场景一：排八字命盘

用户输入："我1990年5月15日早上8点出生，帮我排个盘"

输入格式

参数名	类型	必填	说明
input	string	是	命理咨询入门工具处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

# 排八字命盘
python3 （请参考skill目录中的脚本文件） chart \
  --year 1990 \
  --month 5 \
  --day 15 \
  --hour 8 \
  --gender male
# ...
# 输出：
# === 八字命盘 ===
# 年柱: 庚午 (金火)
# 月柱: 辛巳 (金火)
# 日柱: 戊子 (土水)  ← 日主: 戊土
# 时柱: 丙辰 (火土)
#
# 五行分布:
# 金: 2  木: 0  水: 2  火: 3  土: 3
# 五行缺木，火土偏旺

场景二：性格解读

用户输入："根据我的八字分析一下性格"

# 性格特质解读
python3 （请参考skill目录中的脚本文件） personality \
  --year 1990 --month 5 --day 15 --hour 8
# ...
# 输出性格分析报告

场景三：流年运势

用户输入："我2026年运势怎么样？"

# 流年运势分析
python3 （请参考skill目录中的脚本文件） fortune \
  --year 1990 --month 5 --day 15 --hour 8 \
  --target-year 2026

快速开始

阅读## 核心能力章节了解skill功能
按## 依赖说明配置环境
执行所需能力对应的命令
参考## 错误处理章节处理异常
查看## FAQ解答常见疑问

环境准备

# 依赖说明
pip install lunardate sxtwl
# ...
# 排盘
python3 （请参考skill目录中的脚本文件） chart --year 1990 --month 5 --day 15 --hour 8 --gender male

常用命令

# 排八字命盘
python3 （请参考skill目录中的脚本文件） chart --year 1990 --month 5 --day 15 --hour 8 --gender male
# ...
# 五行分析
python3 （请参考skill目录中的脚本文件） elements --year 1990 --month 5 --day 15 --hour 8
# ...
# 性格解读
python3 （请参考skill目录中的脚本文件） personality --year 1990 --month 5 --day 15 --hour 8
# ...
# 流年运势
python3 （请参考skill目录中的脚本文件） fortune --year 1990 --month 5 --day 15 --hour 8 --target-year 2026

响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.

示例

命理分析配置

bazi_config:
  calendar: "lunar"               # 农历计算
  timezone: "Asia/Shanghai"
# ...
  analysis:
    elements: true                # 五行分析
    personality: true             # 性格解读
    fortune: true                 # 流年运势
    day_master: true              # 日主分析
# ...
  output:
    language: "zh-CN"
    format: "text"
    include_explanation: true     # 包含术语解释

最佳实践

时间准确：出生时间尽量精确到时辰（2小时为一时辰）
农历转换：工具自动处理公历转农历，无需手动转换
综合判断：命理分析需综合四柱，不可单看一柱
理性对待：命理为传统文化，仅供参考娱乐

实践要点	说明
时辰确认	早子时(00-01)与晚子时(23-24)需区分
性别影响	大运排法因性别而异
文化性质	命理为传统文化，非科学预测
免责声明	结果仅供文化娱乐参考

常见问题

Q1：命理分析准确吗？

命理学属于传统文化范畴，非科学预测方法。分析结果仅供文化娱乐参考，不应作为人生决策的依据.

Q2：免费版支持合婚分析吗？

免费版不包含合婚（两人命盘匹配）分析。如需合婚分析，建议升级PRO版.

Q3：出生时间不确定怎么办？

出生时间不确定会影响时柱准确性。建议尽量确认准确时间，或提供大致时间段进行范围分析.

Q4：支持紫微斗数等其他命理吗？

免费版仅支持八字命理。如需紫微斗数、奇门遁甲等其他命理分析方法，建议升级PRO版.

依赖说明

运行环境

Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
操作系统: Windows / macOS / Linux
Python版本: 3.8+

第三方依赖

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供
Python	运行时	必需	系统安装或conda环境
lunardate	Python库	必需	`pip install lunardate`（农历计算）
sxtwl	Python库	可选	`pip install sxtwl`（精确排盘）

API Key 配置

免费版无需任何API Key
所有计算在本地完成

可用性分类

分类: MD+EXEC（Markdown指令+Python脚本执行）
说明: 基于八字命理的传统命理分析工具
免费版限制: 基础排盘与解读、不支持合婚与深度分析
文化声明: 内容仅供传统文化娱乐参考，不构成任何决策建议

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

已知限制

需LLM支持,无LLM环境不可用
复杂业务场景建议结合人工经验判断
执行效率受模型能力与网络环境影响

命理咨询入门工具

安装到 Tokeny（自动）

SKILL.md