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页面:算法实现原理

演示地址

项目界面

同类项目介绍

查询网

在线查询网

这些同类项目提供了额外的查询工具和资源,可以帮助用户更好地理解和使用亲戚关系计算器。

总结

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

项目地址

ruby 复制代码
https://github.com/mumuy/relationship/
相关推荐
HelloGitHub2 小时前
开源新旗舰 GLM-4.5:不想刷榜,只想干活儿
人工智能·开源·github
星际码仔3 小时前
Zread 和 DeepWiki 怎么选?一张图全搞懂
github·chatglm (智谱)
DogDaoDao3 小时前
GitHub开源项目Zerox:AI驱动的OCR革命
人工智能·深度学习·开源·github·ocr·图像识别·zerox
Albert_Lsk3 小时前
【2025/07/28】GitHub 今日热门项目
人工智能·开源·github·开源协议
C++ 老炮儿的技术栈15 小时前
在 Scintilla 中为 Squirrel 语言设置语法解析器的方法
linux·运维·c++·git·ubuntu·github·visual studio
油泼辣子多加15 小时前
2025年07月25日Github流行趋势
github
OpenTiny社区16 小时前
把 SearchBox 塞进项目,搜索转化率怒涨 400%?
前端·vue.js·github
王小义笔记17 小时前
创建属于自己的github Page主页
github
猫头虎20 小时前
GitHub下载教程:2025年最新详解从GitHub上传、下载文件、子目录与完整项目【图文教程】
git·svn·gitee·开源·github·gitea·gitcode
go546315846520 小时前
在本地环境中运行 ‘dom-distiller‘ GitHub 库的完整指南
人工智能·深度学习·神经网络·算法·矩阵·github