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/
相关推荐
掘金安东尼17 分钟前
前端周刊第421期(2025年7月1日–7月6日)
前端·面试·github
小林up2 小时前
github push:ssh: connect to host github.com port 22
运维·ssh·github
Leinwin9 小时前
微软开源GitHub Copilot Chat,AI编程领域迎新突破
microsoft·github·copilot
草梅友仁12 小时前
草梅 Auth 与 AI 开发心得 | 2025 年第 27 周草梅周报
github·ai编程·视觉设计
qianmoQ16 小时前
GitHub 趋势日报 (2025年07月02日)
github
A5资源网20 小时前
cloudflare配合github搭建免费开源影视LibreTV一个独享视频网站 详细教程
github
mortimer20 小时前
从零到一:构建一个 Chatterbox-TTS API 服务
开源·github·ai编程
真智AI20 小时前
利用 Claude Opus 4 自动化 GitHub 工作流:从安装到实战详解
运维·自动化·github
寻月隐君1 天前
Rust 网络编程实战:用 Tokio 手写一个迷你 TCP 反向代理 (minginx)
后端·rust·github
喜欢吃豆1 天前
快速手搓一个MCP服务指南(九): FastMCP 服务器组合技术:构建模块化AI应用的终极方案
服务器·人工智能·python·深度学习·大模型·github·fastmcp