中国家庭亲属关系称谓计算库

功能亮点

1. 精准解决 “中国亲属称谓复杂” 痛点：针对中国家庭 “舅舅 / 叔叔区分”“表亲 / 堂亲差异”“地域称谓不同” 等核心问题，内置海量亲属关系数据，避免常规工具 “称谓模糊” 或 “错算” 问题（如准确识别 “舅妈与外婆” 为 “婆媳” 关系，而非泛化的 “亲属”）。
2. “自然语言 + 配置参数” 双查询方式：既支持普通人易懂的自然语句（如 “我称呼妈妈的哥哥什么？”），也支持开发者灵活的配置对象（如{type: 'default', relation: 'm,xb'}），兼顾 “快速测试” 与 “项目集成” 两种场景。
3. 轻量无依赖，易集成：库体积小（未压缩版约几十 KB），无第三方依赖，可通过 CDN 直接引用（如<script src="https://cdn.jsdelivr.net/npm/relationship.js"></script>），无需额外安装依赖包，适配 Vue、React 等主流前端框架。
4. 地域与自定义适配性强：不仅覆盖广东、北方等主流地域称谓（如广东 “公公” 对应北方 “姥爷”），还允许通过setMode扩展自定义模式（如添加方言区称谓、重组家庭特殊关系），避免 “一刀切” 的称谓限制。

适用场景

• 家庭树 / 族谱工具：用户添加 “妈妈的弟弟” 后，工具自动生成 “舅舅” 称谓，并提示 “舅舅的儿子是表哥”，无需用户手动输入，提升操作效率。
• 春节 / 节日工具：开发 “走亲戚称谓查询器”，用户输入 “要拜访的亲属（如妈妈的姑姑）”，快速获取 “姑姥姥” 称谓及见面称呼建议，解决 “见面不知怎么叫” 的尴尬。
• 社交 APP 功能：亲属社交平台中，用户添加联系人时选择 “爸爸的哥哥”，系统自动备注 “大伯”，并显示 “大伯称呼我为侄子 / 侄女”，辅助用户维护亲属关系。
• 教育类产品：儿童启蒙 APP 中，通过 “问答互动”（如 “妈妈的妈妈叫什么？”）结合库的计算能力，让孩子在游戏中学习亲戚称谓，理解家庭关系。
• 商业项目集成：家政 APP、亲子服务平台中，为 “亲属照护” 功能添加称谓标签（如 “用户需照护的‘姥姥’”），让服务人员快速理解用户家庭结构。

与同类工具对比

使用小贴士

1. 优先用在线演示测试效果：集成前先访问项目在线演示页，输入目标亲属关系（如 “舅舅的女儿是我的什么人”），确认计算结果符合预期，再进行代码集成。
2. 地域模式按需配置：若项目面向特定地域用户（如广东用户），初始化时通过relationship.setMode('guangdong')切换地域模式，避免称谓与用户习惯冲突。
3. 复杂关系用配置对象查询：自然语句无法覆盖的特殊关系（如 “爸爸的继弟的儿子”），改用配置对象传参（如{relation: 'f,jd,xb,s'}），通过关系链代码（f=父，jd=继弟，xb=兄弟，s=儿子）精准查询。
4. CDN 引用适配生产环境：生产环境推荐使用 jsDelivr、unpkg 等 CDN 引用压缩版库，减少项目体积；若需自定义称谓数据，下载源码修改后本地引入，确保自定义规则生效。
5. 关注特殊场景扩展：处理重组家庭、远亲等特殊关系时，通过setMode添加自定义规则（如relationship.setMode('custom', {'f,jd': ['继爸']})），避免称谓缺失或错误。

总结推荐