資料集合說明

        本表提供緣份居 API 涉及的各項命理及占星枚舉常量。 我們建議開發者將此類數據存儲為映射表。接口返回的原始數據均為下表中的標準枚舉值，您可以根據自身產品的多語言需求，對展示層文字進行自定義映射處理。

一、東方命理

集合類型	集合數據
十天干集合(包含地支藏干)	'甲', '乙', '丙', '丁', '戊', '己', '庚', '辛', '壬', '癸'
十二地支集合	'子', '丑', '寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥'
十神集合[古代版](包含藏干十神)	'比', '劫', '食', '傷', '財', '才', '殺', '官', '梟', '印', '日元'
十神集合[現代版](包含藏干十神)	'比肩', '劫財', '食神', '傷官', '正財', '偏財', '七殺', '正官', '偏印', '正印', '日元'
十二長生集合	'長生', '沐浴', '冠帶', '臨官', '帝旺', '衰', '病', '死', '墓', '絕', '胎', '養'
五行集合	'金', '木', '水', '火', '土'
納音集合	'海中金','大溪水','覆燈火','沙中金','泉中水','山頭火', '澗下水','爐中火','沙中土','天河水','山下火','屋上土', '霹靂火','城頭土','大林木','天上火','大驛土','平地木', '壁上土','松柏木','白蠟金','路旁土','石榴木','釵釧金', '桑柘木','金箔金','長流水','楊柳木','劍鋒金','大海水'
八卦集合	'乾', '坤', '震', '艮', '離', '坎', '兌', '巽'
十二生肖集合	'鼠', '牛', '虎', '兔', '龍', '蛇', '馬', '羊', '猴', '雞', '狗', '豬'
十二星座集合	'水瓶座', '雙魚座', '白羊座', '金牛座', '雙子座', '巨蟹座', '獅子座', '處女座', '天秤座', '天蠍座', '射手座', '摩羯座'
神煞集合	天乙貴人, 天德貴人, 月德貴人, 天德合, 月德合, 太極貴人, 三奇貴人, 福星貴人, 德秀貴人, 國印貴人, 文昌貴人, 學堂, 詞館, 天廚貴人, 祿神, 干祿, 將星, 驛馬, 天醫, 金輿, 華蓋, 紅鸞, 天喜, 桃花, 天赦日, 十靈日, 六秀日, 拱祿, 日德, 日貴, 進神, 福德, 羊刃, 飛刃, 血刃, 劫煞, 災煞, 亡神, 天羅地網, 天羅, 地網, 孤辰, 寡宿, 陰差陽錯, 魁罡, 孤鸞煞, 勾絞煞, 紅艷煞, 十惡大敗, 童子煞, 元辰, 金神, 空亡, 流霞, 六厄, 白虎, 天狗, 天轉日, 地轉日, 喪門, 吊客, 披麻, 八專日, 九丑日, 四廢日
奇門九星集合	'天蓬星', '天芮星', '天衝星', '天輔星', '天禽星', '天心星', '天柱星', '天任星', '天英星'
奇門八門集合	'休門', '死門', '傷門', '杜門', '中門', '開門', '驚門', '生門', '景門'
奇門九神集合	'值符', '螣蛇', '太陰', '六合', '勾陳', '太常', '朱雀', '九地', '九天', '白虎', '玄武'
每日運勢顏色範圍(星座、生肖)	顏色範圍：棕色, 黃色, 深紅色, 紅色, 天藍色, 橄欖綠, 黑色, 深綠色, 粉紅色, 橙色, 金色, 玫瑰紅, 白色, 紫色, 灰色, 深藍色, 綠色, 青色
每日運勢寶石範圍(星座、生肖)	寶石範圍：紫水晶, 草綠石, 紅寶石, 藍寶石, 紫羅蘭, 鑽石, 金石, 綠松石, 黑曜石, 琥珀, 綠幽靈, 紫晶, 蛋白石, 紅瑪瑙, 黃玉, 珍珠, 翡翠, 碧璽, 玉髓, 藍貓眼石
每日運勢數字範圍(星座、生肖、八字)	數字範圍：1～99
每日運勢數字範圍(八字每日運勢)	數字範圍：0、1、2、3、4、5、6、7、8、9
每日運勢顏色範圍(八字每日運勢)	顏色範圍：白色、銀色、金色、青色、綠色、黑色、 藍色、赤色、紅色、黃色、棕色
每日運勢方位範圍(八字每日運勢)	方位範圍：西方、西北方、東方、東南方、北方、 南方、中央、東北方、西南
每日運勢食物範圍(八字每日運勢)	食物範圍：白蘿蔔、銀耳、百合、白果、梨、豆腐、牛奶、白芝麻、 杏仁、山藥、梨膏、銀耳羹、白果燉雞、白蘿蔔汁、 豆腐腦、燕麥片、蓮藕、馬蹄、甘蔗、百合粥、杏仁露、 牛奶燉蛋、銀耳蓮子湯、白蘿蔔燉排骨、菠菜、芹菜、 韭菜、油麥菜、西蘭花、青蘋果、獼猴桃、綠豆芽、 青豆、春卷、菠菜面、青豆泥、芹菜汁、獼猴桃汁、 韭菜盒子、芹菜炒豆干、油麥菜沙拉、西蘭花炒蝦仁、 菠菜蛋花湯、青蘋果汁、黑豆、黑芝麻、海帶、紫菜、 黑木耳、黑米、烏雞、生蠔、紫菜湯、海帶燉排骨、 黑芝麻糊、桑葚酒、黑木耳炒肉、黑豆粥、生蠔煎、 紫菜包飯、海帶絲、黑米紅棗粥、烏雞白鳳湯、紫菜蛋花湯、 海帶豆腐湯、黑芝麻湯圓、紅棗、枸杞、西紅柿、櫻桃、 紅豆、羊肉、紅糖、桂圓、櫻桃醬、紅豆沙、紅棗糕、 枸杞茶、西紅柿炒蛋、羊肉泡饃、紅糖發糕、紅豆薏米粥、 櫻桃酸奶、紅酒燉牛肉、桂圓蓮子羹、紅棗枸杞茶、 西紅柿牛腩、紅糖饅頭、小米、南瓜、玉米、土豆、 黃豆、胡蘿蔔、紅薯、栗子、黃小米、小米粥、 南瓜餅、玉米汁、土豆泥、山藥糕、黃豆豆漿、 胡蘿蔔燉牛腩、紅薯粥、黃小米飯、栗子燒雞、 南瓜粥、玉米烙、土豆燒牛肉、山藥排骨湯、黃豆燉豬蹄
每日運勢配飾範圍(八字每日運勢)	配飾範圍：冰種玉手鐲, 原木手串, 土棕色領結, 土色髮夾, 土色手鍊, 土黃色絲巾, 土黃項鍊, 木製戒指, 木製眼鏡, 木製胸針, 木頭髮夾, 木頭戒指, 木手杖, 木梳, 木珠手鍊, 木珠鍊, 木耳墜, 木質手表, 木質耳環, 木質腰飾, 木質項鍊, 木雕戒指, 木雕掛墜, 朱砂手串, 棕玉手鐲, 棕色髮簪, 棕色帽子, 棕色戒指, 棕色皮飾, 棕色腰帶, 植物胸針, 水晶髮飾, 水晶掛飾, 水晶耳墜, 水晶項鍊, 水滴吊墜, 水滴形耳飾, 水紋絲巾, 水紋手表, 水色圍巾, 海藍寶戒, 深藍領結, 火焰圖案胸針, 火焰形戒指, 火焰形掛飾, 火焰形耳釘, 火焰紋袖扣, 火焰項鍊, 火紅手鍊, 烈焰耳飾, 瑪瑙項鍊, 玫瑰金耳環, 玫紅包鍊, 珍珠耳環, 琥珀吊墜, 琥珀耳墜, 砂巖耳飾, 竹製髮簪, 竹節手鍊, 紅寶石髮卡, 紅寶石戒指, 紅寶耳墜, 紅曜石戒指, 紅水晶戒指, 紅瑪瑙吊墜, 紅珊瑚項鍊, 紅色絲巾, 紅色髮帶, 紅色項鍊, 藍寶石耳釘, 藍寶石胸針, 藍玉髓吊墜, 藍色髮夾, 藍色手鍊, 藤編包, 貝殼項鍊, 金髮夾, 金屬吊墜, 金屬帽扣, 金屬扣包, 金屬眼鏡框, 金屬紐扣, 金屬表鍊, 金屬飾邊包, 金手鍊, 金手鐲, 金色手表, 金色耳墜, 金色腰帶扣, 金鍊墜, 金項鍊, 鈦合金戒指, 鋼戒指, 鉑金戒指, 銀戒, 銀耳環, 銀胸針, 黃土色胸針, 黃水晶戒指, 黃玉吊墜, 黃玉戒指, 黃瑪瑙手串, 黃銅耳釘, 黑曜石手鍊, 黑水晶戒指
每日運勢宜忌範圍(八字每日運勢)	宜忌範圍：開市,納財,立券,交易,求財,掛匾,置產, 出貨財,買車,赴任,見貴,求醫,治病,探病,安機械, 開倉,納畜,投資,縫補,艾灸,作染,入學,理發,會親友, 訓畜,習藝,祈福,求嗣,結網,栽種,捕捉,畋獵,牧養, 針灸,整手足甲,剃頭,乘船,渡水,出行,入宅,安香, 掃舍,祭祀,求雨,酬神,普渡,齋醮,焚香,沐浴,解除, 脫毛,移徙,分居,歸寧,問病情,見友人,問名,出火, 破屋,斷蟻,行喪,書法,經絡,嫁娶,訂婚,納采,安床, 合帳,冠笄,開光,塑繪,裁衣,作竈,修造,動土,上梁, 豎柱,蓋屋,拆卸,破土,開廁,造屋,合脊,修門,安葬, 立碑,啟鑽,修墳,入殮,移柩,安門,補垣,壞垣,起基, 定磉,塞穴,築堤,開池,掘井,平治道塗,修飾垣墻, 作梁,開井開池,作廁,修倉
八字正格範圍	正印格、正財格、建祿格、劫財格、偏財格、 食神格、傷官格、七殺格、 正官格、偏印格、未入格
紫微星系集合	紫微, 天機, 太陽, 武曲, 天同, 廉貞
天府星系集合	天府, 太陰, 貪狼, 巨門, 天相, 天梁, 七殺, 破軍
紫微月系星曜	左輔, 右弼, 天刑, 天姚, 天月, 天巫, 陰煞
紫微時系星曜	文昌, 文曲, 地空, 地劫, 台輔, 封誥
紫微年干系星曜	祿存, 擎羊, 陀羅, 天鉞, 天魁, 天福, 天官, 正空, 副空
紫微年支系星曜	天虛, 天哭, 天空, 龍池, 鳳閣, 咸池, 紅鸞, 天喜, 天馬, 解神, 華蓋, 孤辰, 寡宿, 劫殺, 蜚廉, 破碎, 大耗
紫微博士十二神	博士, 力士, 青龍, 小耗, 將軍, 奏書, 飛廉, 喜神, 病符, 大耗, 伏兵, 官府
紫微歲建十二神	歲建, 晦氣, 喪門, 貫索, 官符, 小耗, 大耗, 龍德, 白虎, 天德, 吊客, 病符
紫微將星十二神	將星, 攀鞍, 歲驛, 息神, 華蓋, 劫煞, 災煞, 天煞, 指背, 咸池, 月煞, 亡神
紫微雜曜/其他星曜	火星, 鈴星, 三台, 八座, 天貴, 恩光, 天才, 天壽, 天傷, 天使

二、西方占星

星座字段映射

接口說明：該集合定義了 API 返回的星座對象標準。建議開發者使用 sign_id (0-11) 作為邏輯判斷依據，使用 sign_font 映射前端占星字體圖標。

sign_id	sign_english	sign_chinese	sign_chinese_traditional	sign_font
0	Aries	白羊	白羊	A
1	Taurus	金牛	金牛	B
2	Gemini	雙子	雙子	C
3	Cancer	巨蟹	巨蟹	D
4	Leo	獅子	獅子	E
5	Virgo	處女	處女	F
6	Libra	天秤	天秤	G
7	Scorpio	天蠍	天蠍	H
8	Sagittarius	射手	射手	I
9	Capricorn	摩羯	摩羯	J
10	Aquarius	水瓶	水瓶	K
11	Pisces	雙魚	雙魚	L

宮位字段映射

接口說明：該集合定義了後天十二宮位的對應關系。house_id 為固定枚舉（1-12），house_life 代表該宮位在占星學中的核心世俗含義（如：命宮、財帛宮等）。

house_id	house_life
1	命宮
2	財帛宮
3	兄弟宮
4	田宅宮
5	子女宮
6	奴僕宮
7	夫妻宮
8	疾厄宮
9	遷移宮
10	官祿宮
11	福德宮
12	玄秘宮

星體與敏感點映射

接口說明：該集合定義了 API 可計算的所有天體及虛點。code_name 是星體的唯一識別碼；object_type 用於區分星體類別（如：行星、小行星、四軸、虛點等）。

code_name	object_type	planet_english	planet_chinese	planet_chinese_traditional	planet_font
0	planet	Sun	太陽	太陽	Su
1	planet	Moon	月亮	月亮	Mo
2	planet	Mercury	水星	水星	Me
3	planet	Venus	金星	金星	Ve
4	planet	Mars	火星	火星	Ma
5	planet	Jupiter	木星	木星	Ju
6	planet	Saturn	土星	土星	Sa
7	planet	Uranus	天王星	天王星	Ur
8	planet	Neptune	海王星	海王星	Ne
9	planet	Pluto	冥王星	冥王星	Pl
D	asteroid	Chiron	凱龍	凱龍	Ch
F	asteroid	Ceres	谷神	穀神	Ce
G	asteroid	Pallas	智神	智神	Pa
H	asteroid	Juno	婚神	婚神	Jo
I	asteroid	Vesta	灶神	灶神	Vt
xs16	asteroid	Psyche	靈神	靈神	Psy
xs433	asteroid	Eros	愛神	愛神	Eros
ASC	angle	Ascendant	上升	上升點	Asc
MC	angle	Midheaven	天頂	天頂	Mc
IC	angle	ImumCoeli	天底	天底	Ic
DC	angle	Descendant	下降	下降點	Dsc
VX	angle	Vertex	宿命點	宿命點	Vx
pFortune	arabic_part	PartOfFortune	福點	福點	Pfo
TN	lunar	TrueNode	北交點(真)	北交點(真)	Tn
MN	lunar	MeanNode	北交點(平)	北交點(平)	Mn
SN	lunar	SouthNode	南交點	南交點	Sn
ML	lunar	MeanLilith	莉莉絲(平均)	莉莉絲(平均)	Lil

星座屬性映射

接口說明：sign_attribute 包含兩個子對象：element（四元素屬性）與 mode（四正特質屬性）。以下為所有可能的枚舉值。

分類	id	en	zh	zht
element (四元素)	fire	Fire	火相	火相
	earth	Earth	土相	土相
	air	Air	風相	風相
	water	Water	水相	水相
mode (三方四正)	cardinal	Cardinal	本位	本位
	fixed	Fixed	固定	固定
	mutable	Mutable	變動	變動

星盤格局映射

接口說明：patternData 包含了星盤中所有符合幾何邏輯的格局。以下為 pattern_id 及其對應的多語言名稱枚舉。

pattern_id	pattern_en	pattern_zh	pattern_zht
grand_trine	Grand Trine	大三角	大三角
medium_trine	Medium Trine	中三角	中三角
minor_trine	Minor Trine	小三角	小三角
t_square	T-Square	T三角	T三角
grand_cross	Grand Cross	大十字	大十字
kite	Kite	風箏	風箏
yod	Yod	上帝之指	上帝之指
cradle	Cradle	搖籃	搖籃

相位映射

接口說明：該集合定義了星盤中星體之間形成相位的基準角度（allow）及其對應的多語言名稱。在接口返回的 planet_allow_degree 數組中，請參照此表進行字段解析。

allow	aspect_english	aspect_chinese	aspect_chinese_traditional
0	Conjunction	合相	合相
30	SemiSextile	半六合	半六合
60	Sextile	六分相	六分相
90	Square	四分相	四分相
120	Trine	拱相	拱相
150	Quincunx	梅花相	梅花相
180	Opposition	對分相	對分相

宮位主題與權重映射

接口說明：該表定義了 12 宮位的核心主題枚舉及其在能量分析中的算法權重。在進行合盤分析、情感深度評估等加權計算時，建議參照此表邏輯。

相位性質與極性定義

接口說明：該集合定義了相位在占星學中的動態性質（aspect_type）與能量互動模式（polarity）。開發者可根據 aspect_type 字段配置連線主色調，根據 polarity 字段實現不同的交互動效。

allow	aspect_type	polarity	含義說明
0	positive	fusion	強烈融合：兩股力量合二為一，產生強大的聚焦能量。
30	neutral	flow	微調流動：能量在細微處流動，代表需要覺察的次要機會。
60	positive	flow	機會流動：和諧且帶有邀請性質的能量，代表通過努力可得的機會。
90	challenging	friction	沖突成長：強烈的摩擦與阻礙，但也提供了巨大的突破動力。
120	positive	flow	和諧流動：天賦般的順暢能量，代表天生俱來的好運與資源。
150	challenging	friction	調整摩擦：難以調和的張力，代表需要不斷修正與適應的領域。
180	neutral	integrative_tension	整合張力：兩極對峙產生的張力，代表需要在沖突中尋找平衡。