玄机先生

基于 OpenClaw 的中国传统命理 AI 智能体。

简介

玄机先生是一个专注于中国传统玄学的 AI 算命智能体，基于确定性计算引擎（非大模型猜测），结合大语言模型进行专业解读，提供准确的命理分析服务。

支持的命理系统

八字（四柱命理）— 日主分析、十神推演、身强身弱判定、用神选取、大运流年、神煞查询
紫微斗数 — 十四主星、十二宫位、四化飞星、庙旺利陷、大限分析
风水 — 玄空飞星排盘、八宅命卦、九星组合吉凶、催旺化煞方案
易经占卜 — 铜钱法（六爻）、梅花易数（时间起卦/数字起卦）、体用生克分析

核心设计理念

排盘计算由确定性 Python 代码完成，LLM 只负责解读——不猜、不算、不编。

玄机先生 (OpenClaw 插件)
├── TypeScript 工具层（注册到 OpenClaw）
│   └── xuanji_bazi, xuanji_ziwei, xuanji_fengshui, xuanji_yijing ...
├── Python-TS 桥接层（通过 child_process 调用计算引擎）
├── Python 计算引擎（~/suanming-agent/）
│   ├── calendar/   — 干支历法、节气、真太阳时
│   ├── bazi/       — 八字排盘、十神、强弱、大运
│   ├── ziwei/      — 紫微斗数排盘、安星、四化
│   ├── fengshui/   — 飞星排盘、八宅命卦
│   └── yijing/     — 六十四卦、铜钱法、梅花易数
└── 知识库（~/suanming-kb/）
    └── 7 个参考文档，共 108KB，涵盖所有命理系统

计算引擎详情

八字模块

公历转干支（年柱以立春为界，月柱以节气为界）
地支藏干（本气、中气、余气权重）
十神推演（日主与八字所有天干地支的关系）
身强身弱评估（得令 40%、得地 30%、得助 30%）
用神/忌神判定（抑强扶弱原则）
大运排列（阳男阴女顺行、阴男阳女逆行）
地支合冲刑害（六合、三合、三会、六冲、三刑、六害）
神煞查询（天乙贵人、文昌、桃花、驿马、禄神、羊刃、华盖）
空亡计算
纳音五行（完整六十甲子纳音表）

紫微斗数模块

十四主星安星（紫微系列 + 天府系列）
六吉星、六煞星安星
星曜庙旺利陷亮度表
十天干四化表
五行局判定（水二局至火六局）
十二宫排列（命宫定位、逆时针排宫）
身宫计算
大限排列

风水模块

玄空飞星排盘（九宫飞星、山星水星）
九星吉凶属性（当令/失令含义）
三元九运（当前为九运：2024-2043）
星曜组合吉凶判断及化解方案
八宅命卦计算（东四命/西四命）
八游星吉凶方位（生气、天医、延年、伏位、绝命、五鬼、六煞、祸害）

易经模块

六十四卦完整数据（卦名、上下卦、宫属、核心含义）
八宫归属
互卦、错卦、综卦推导
铜钱法占卜（老阴老阳变爻规则、变卦推算）
梅花易数（时间起卦、数字起卦）
体用生克分析（体克用吉、用克体凶）

知识库

| 文件 | 内容 | |------|------| | 01_foundations.md | 阴阳学说、五行详解（完整对应表）、天干地支（合冲刑害破）、纳音表、节气、神煞、择日 | | 02_bazi.md | 四柱排盘方法、十神详解、格局、用神、大运、实际案例 | | 03_ziwei_doushu.md | 十二宫、十四主星性格详解、六吉六煞、四化表、排盘八步、解盘方法 | | 04_fengshui.md | 形势派、理气派、八宅、飞星（九星、三元九运、排盘、组合、化解）、罗盘、案例 | | 05_yijing_divination.md | 八卦、六十四卦查询表、六爻预测（装卦、用神、六亲、六神）、梅花易数、奇门遁甲 | | 06_face_palm_reading.md | 面相（三停、五官、十二宫）、手相（四大线、八卦区、丘位） | | 07_name_zodiac_history.md | 姓名学（五格剖象法）、十二生肖（性格、合冲）、历史名例（推背图、烧饼歌、梅花易数） |

工具列表

| 工具名 | 功能 | |--------|------| | xuanji_bazi | 八字排盘：输入出生年月日时，返回四柱、十神、强弱、用神、大运、神煞 | | xuanji_ziwei | 紫微斗数排盘：输入农历生辰，返回十二宫星曜、亮度、四化、大限 | | xuanji_fengshui | 风水分析：计算命卦（东/西四命）+ 可选飞星排盘（需提供朝向度数） | | xuanji_yijing | 易经占卜：支持铜钱法、梅花时间起卦、数字起卦三种方式 | | xuanji_full_reading | 综合解读：同时生成八字 + 紫微斗数 + 命卦，适用于全面人生分析 | | xuanji_knowledge | 知识库查询：加载对应系统的参考文档，辅助 LLM 进行深度解读 |

安装

前置条件

OpenClaw 已安装
Python 3.9+
Node.js 18+
计算引擎已部署在 ~/suanming-agent/
知识库已部署在 ~/suanming-kb/

安装步骤

cd ~/Desktop/Xuanji
bash install.sh

安装脚本会： 1. 验证 OpenClaw 和 Python 引擎是否就绪 2. 安装 npm 依赖 3. 将插件复制到 ~/.openclaw/extensions/xuanji/ 4. 将人格文件复制到 ~/.openclaw/workspace/

配置 OpenClaw

在 ~/.openclaw/openclaw.json 中添加：

{
  "agents": {
    "list": [
      {
        "id": "xuanji",
        "workspace": "~/.openclaw/workspaces/xuanji",
        "identity": {
          "name": "玄机先生",
          "theme": "中国传统命理大师",
          "emoji": "🔮"
        }
      }
    ]
  },
  "plugins": {
    "allow": ["xuanji"],
    "load": {
      "paths": ["~/Desktop/Xuanji/plugin/src/index.ts"]
    },
    "entries": {
      "xuanji": { "enabled": true }
    }
  }
}

人格设定

玄机先生的人格定义在 workspace/SOUL.md 中：

权威而不傲慢 — 以数十年研习玄学的大师身份说话，但始终谦和
方法论严谨 — 所有解读必须基于排盘数据，展示推理过程
文化根基深厚 — 自然引用传统命理术语，中英对照
诚实面对不确定性 — 盘面信号矛盾时坦承，不强行下定论
慈悲而直接 — 如实告知，但以建设性方式表达
尊重人为 — 命运揭示趋势而非定数，强调个人努力可以改运

技术栈

| 层级 | 技术 | 行数 | |------|------|------| | 计算引擎 | Python 3 | 3,400+ | | 插件层 | TypeScript (OpenClaw) | 930+ | | 知识库 | Markdown | 2,000+ | | 测试 | Python unittest | 13 项全部通过 |

许可证

MIT

xuanji

Summary

Install to Claude Code