关系链语法

relationship-ts 内部使用关系链符号来表示亲属关系。理解这些符号有助于你自定义方言模式或调试问题。

基础符号

符号	含义	符号	含义
f	父亲	m	母亲
h	丈夫	w	妻子
s	儿子	d	女儿
xb	兄弟	xs	姐妹
ob	哥哥	lb	弟弟
os	姐姐	ls	妹妹

修饰符

符号	含义
1	男性
0	女性
&o	年长
&l	年幼
&数字	排行（如 &2 表示老二）

关系链格式

关系链使用逗号分隔：

f,m,xb

表示"父亲的母亲的兄弟"（舅外公）。

示例

关系链	含义	常见称谓
f	父亲	爸爸
m	母亲	妈妈
f,f	父亲的父亲	爷爷
f,m	父亲的母亲	奶奶
m,f	母亲的父亲	姥爷/外公
m,m	母亲的母亲	姥姥/外婆
f,xb	父亲的兄弟	伯伯/叔叔
f,xs	父亲的姐妹	姑姑
m,xb	母亲的兄弟	舅舅
m,xs	母亲的姐妹	姨妈
xb,w	兄弟的妻子	嫂子/弟媳
xs,h	姐妹的丈夫	姐夫/妹夫

带修饰符的关系链

修饰符用于更精确地描述关系：

性别修饰符

s,1    // 儿子（男性）
s,0    // 女儿（女性）

年龄修饰符

xb,o   // 哥哥（年长）
xb,l   // 弟弟（年幼）
s&o    // 儿子（年长）
s&l    // 儿子（年幼）

排行修饰符

s&2    // 二儿子
s&3    // 三儿子

自定义方言示例

了解关系链语法后，你可以创建自定义的方言模式：

import relationship from 'relationship-ts';

// 自定义北方方言
relationship.setMode('northern', {
  'm,f': ['姥爷'],
  'm,m': ['姥姥'],
  'f,f': ['爷爷'],
  'f,m': ['奶奶'],
});

// 自定义粤语方言
relationship.setMode('cantonese', {
  'f': ['老豆'],
  'm': ['妈咪'],
  'f,f': ['阿公'],
  'f,m': ['阿嫲'],
});

// 自定义带修饰符的关系
relationship.setMode('custom', {
  'f,xb,o': ['大伯'],
  'f,xb,l': ['叔叔'],
  'm,xb,o': ['大舅'],
  'm,xb,l': ['舅舅'],
});

完整符号参考

家庭成员

符号	中文
f	父亲
m	母亲
h	丈夫
w	妻子
s	儿子
d	女儿

兄弟姐妹

符号	中文
xb	兄弟
xs	姐妹
ob	哥哥
lb	弟弟
os	姐姐
ls	妹妹

修饰符

符号	中文
&o	年长
&l	年幼
&1, &2, ...	排行
,0	女性
,1	男性

下一步

• 方言支持 - 了解如何使用方言
• API 文档 - 了解 setMode API