---
name: tianshu-huangdao
description: 天枢黄道庫 — 傳統曆法·命理運勢·姓名起名。查黃道吉日（結婚/搬家/開業）、算運勢、取名測字。基於建除12神/28宿/64卦/五行/生肖數據。中英文觸發：黃曆、黄历、吉日、擇吉、運勢、取名、huangli、feng shui、fortune、chinese calendar、auspicious date。下載後本地運行。
---

# 🏮 天樞黃道庫

> 傳統曆法·命理運勢·姓名起名

## 功能

### 一、黃曆擇吉 — Chinese Almanac
查某日的建除12神、28宿、64卦、宜忌、彭祖百忌。

**JSON 數據路徑：** `data/huangli_rules.json`

用法：讀入 JSON → 按 `rules[日期]` 查找 → 返回宜忌清單

### 二、命理運勢 — Fortune Telling
輸入出生日期和生肖，返回五行屬性 + 綜合/財運/事業/愛情運勢 + 幸運色/數字/方位。

**JSON 數據路徑：** `data/zodiac.json` + `data/yijing.json` + `data/wuxing.json`

用法：讀入 JSON → 按生肖查對應數據 → 按運勢模板組織輸出

### 三、姓名起名 — Chinese Name
輸入姓氏和性別，返回五行屬性 + 3個推薦名（含筆畫、五行、寓意）。

**JSON 數據路徑：** `data/naming.json`

用法：讀入 `naming.json` → 按姓氏五行篩選 → 五行互補排序 → 返回前3名

## 數據文件

| 文件 | 大小 | 內容 |
|------|------|------|
| `data/huangli_rules.json` | 31KB | 建除12神、28宿、64卦、宜忌活動(29項)、吉神凶神、彭祖百忌、節氣 |
| `data/yijing.json` | 58KB | 64卦完整卦辭、象辭、爻辭 |
| `data/zodiac.json` | 16KB | 12生肖運勢、五行屬性、幸運色數字 |
| `data/wuxing.json` | 2KB | 五行屬性速查 |
| `data/naming.json` | 41KB | 223字名庫（筆畫/五行/寓意）+ 五格數理 + 三才配置 |

## 觸發詞

- 中文：黃曆、黄历、吉日、良辰吉日、結婚吉日、搬家吉日、擇吉、今日運勢、生肖運勢、取名、起名、測名、五行、八字、卦
- 英文：huangli, chinese almanac, auspicious date, feng shui, fortune, chinese zodiac, name meaning, chinese name, five elements, i-ching

## 安裝

```bash
openclaw skills install tianshu-huangdao
```

或下載後：

```bash
openclaw skills install /path/to/tianshu-huangdao
```

## 本地使用示例

```javascript
// 讀取黃曆數據
const huangli = require('./data/huangli_rules.json');
const date = '2026-06-01';
const dayRules = huangli.rules[date];
// → 返回宜：嫁娶、動土；忌：訴訟；建除：除；28宿：亢

// 取名
const naming = require('./data/naming.json');
const surname = '張';
const gender = '女';
// → 返回五行屬性 + 推薦名
```