relationship: Star3.2k，牛B啊，小米手机上也在用，这个项目人人都能用得上的开源项目，抓紧收藏起来吧～～～

嗨，大家好，我是小华同学，关注我们获得"最新、最全、最优质"开源项目和高效工作学习方法

过年回家，面对七大姑八大姨，你是否也感到迷茫？别担心，今天要介绍的这款神器------中国亲戚关系计算器，将帮你轻松解决这个难题！

项目简介

在快节奏的现代生活中，家庭亲戚关系变得越来越复杂，尤其是对于年轻一代来说，面对众多的亲戚称谓，常常感到困惑和尴尬。中国亲戚关系计算器（Chinese kinship system）应运而生，它是一个开源项目，旨在帮助用户快速计算和确定亲戚之间的正确称谓。无论是家庭聚会还是节日拜访，这个工具都能帮你轻松应对。

功能特点

1. 多样化的称谓输入

中国亲戚关系计算器支持多种称谓输入方式，兼容不同地区的叫法习惯。例如，你可以将父亲称呼为"老爸"、"爹地"、"老爷子"等，使得用户可以根据自己的习惯进行输入。

2. 快捷输入和算法支持

计算器提供快捷输入按键，简化用户操作流程。同时，算法支持逆向查找称呼，即用户可以输入一个称谓，计算器会告诉你这个称谓对应的是你的哪位亲戚。

3. 浏览器和Nodejs环境兼容

脚本库不仅可以在浏览器中使用，还可以在Nodejs环境中运行，增加了应用的灵活性和适用范围。

安装与使用

下载 & 安装

浏览器中使用

在网页中引入以下脚本：

ini 复制代码

<script src="https://passer-by.com/relationship/dist/relationship.min.js">

即可获取全局方法 relationship。

Nodejs环境中使用

使用npm安装名为 relationship.js 的包：

复制代码

npm install relationship.js

在脚本中引入模块：

javascript 复制代码

// CommonJS 引入
const relationship = require("relationship.js");

// ES Module 引入
import relationship from 'relationship.js';

使用方法

通用方法：计算称谓

唯一的计算方法是 relationship(options)，其中 options 结构如下：

ruby 复制代码

var options = {
    text:'',       // 目标对象的称谓汉字表达
    target:'',     // 相对对象的称谓汉字表达
    sex:-1,        // 本人性别：0表示女性,1表示男性
    type:'default',// 转换类型：'default'计算称谓,'chain'计算关系链,'pair'计算关系合称
    reverse:false, // 称呼方式：true对方称呼我,false我称呼对方
    mode:'default',// 模式选择：使用setMode方法定制不同地区模式，在此选择自定义模式
    optimal:false, // 最短关系：计算两者之间的最短关系
};

代码示例

php 复制代码

// 如：我应该叫外婆的哥哥什么？
relationship({text:'妈妈的妈妈的哥哥'});
// => ['舅外公']

// 如：七舅姥爷应该叫我什么？
relationship({text:'七舅姥爷',reverse:true,sex:1});
// => ['甥外孙']

开发 & 贡献

如何贡献

如果你希望为这个项目贡献代码或提供改进意见，可以按照以下步骤操作：

bash 复制代码

# 安装开发依赖
npm install

# build 模块：将 relationship 打包压缩
npm run build

# 执行测试用例
npm test

关于分歧

由于地域差异，一些称呼可能存在不同的理解。项目尽量以现代生活常见理解为主，但并不保证和你所处地区的称谓习惯完全一致。

教程

算法实现原理

更多关于算法实现原理的详细信息，可以参考项目的Wiki页面：算法实现原理。

演示地址

项目演示：passer-by.com/relationshi...
移动版演示：passer-by.com/relationshi...

项目界面

总结

中国亲戚关系计算器以其实用性和易用性，为广大用户提供了一个解决家庭亲戚称谓难题的有效工具。无论是技术开发者还是普通用户，都可以从中受益，轻松应对复杂的家庭关系。

项目地址