@captiveorigins/onepedigree-core

中文文档
0.1.0-alpha.15发布于 2026/11/09PolyForm-Noncommercial-1.0.0TypeScriptES Module零依赖构建来源已验证近 30 天下载 1903

OnePedigree核心:物种中性pedigree数据模型,验证,有分界线的traversal,查看预测和布局,没有回放,有效载荷或数据库依赖性.

中文使用文档
文档目录6 节
  1. 原则
  2. 快开始
  3. 视图
  4. 遗传学
  5. 发展
  6. 许可证

单页

人类和其他动物(和植物)的物种中性幼虫框架:便携式 数据模型、图表验证、分界祖先、视图预测、自动 版式,服务器可发送的 React 组件和一个 Bayload CMS 插件.

状态:α. Schema-version-1合同在意图上是稳定的;套件API可能 仍然在第一次释放前改变.

软件包目的
@captiveorigins/onepedigree-core数据模型 常态化 验证 转录 预测 布局 序列化 无反应、有效载荷或数据库依赖性.
@captiveorigins/onepedigree-react服务器可响应SVG视图(全为13),可交互探索器,无头钩,CSS可变型.
@captiveorigins/payload-plugin-onepedigree有效载荷插件:被管理,标准或被映射的收藏,周期安全序列化的写作,删除政策,权限意识端点,管理员预览和颜色设置.

原则

  • 父母身份由个人决定数字 : parentage.parents[{ individual, role }], (中文(简体) ), reproductiveMode (单位:千美元)sexual, (中文(简体) ), parthenogenesis, (中文(简体) ), self, (中文(简体) ), asexual, (中文(简体) ), cloning, (中文(简体) ), other(中文(简体) ) 财务报告和审定财务报表 cohort儿童与兄弟姐妹是生而无存的.
  • 未知无为. 角色从未从性别中推断出来;缺失的父母或模式是 未猜到; 不完整的幼稚园是有效的( 它们生成通知, 不是错误) .
  • 安全无虞. 每道有深度和大小限制 并报告 截取; 循环被拒绝 .
  • 身份对事件. (a) 一个被储存的个人可能多次出现在视图中; 事件总是映射到一个身份.

快开始

import { getAncestors, indexPedigree, validatePedigree, type PedigreeDocument } from '@captiveorigins/onepedigree-core'

const pedigree: PedigreeDocument = {
  schemaVersion: 1,
  individuals: [
    { id: 'atlas', label: 'Atlas', sex: 'male' },
    { id: 'nova', label: 'Nova', sex: 'female' },
    {
      id: 'ember',
      label: 'Ember',
      parentage: {
        parents: [
          { individual: 'nova', role: 'mother' },
          { individual: 'atlas', role: 'father' },
        ],
        reproductiveMode: 'sexual',
      },
    },
  ],
}

const { valid, issues } = validatePedigree(pedigree)
const ancestors = getAncestors(indexPedigree(pedigree), 'ember', { maxGenerations: 4 })

大型数据集:已执行 PedigreeRepository (单位:千美元)getByIds, (中文(简体) ), findChildrenOf)和打电话 loadNeighborhood();它每代加载一个有界限的邻里查询.

视图

pedigree, (中文(简体) ), fan, (中文(简体) ), ahnentafel, (中文(简体) ), descendants, (中文(简体) ), hourglass, (中文(简体) ), cohort, (中文(简体) ), relationship, (中文(简体) ), timeline, (中文(简体) ), inbreeding, (中文(简体) ), population, (中文(简体) ), compact, (中文(简体) ), maternal, (中文(简体) ), paternal: 每个带一个 预测(projectPedigree),内置定型布局(layoutPedigree树, 分层或射线、纵向或横向)和反应成形器。 自定义布局引擎(如:. ELK)通过插接 PedigreeLayoutEngine。 。 。 .

对于列表而不是图表("显示所有亲属"), relativesByGeneration(projection) 按代代(父母、祖父母、兄弟姐妹、, 后代,.); generationKind() 给主机提供要翻译的"伟大"的种类和数量,以及 generationLabel() 一个英文标签.

遗传学

可选且与 pedigree 文档相分离 (schema 1 不变): 主机 提供基因目录(GeneDefinition: 阴性,不完全的主导, 具有优势、多源或未知; 通过共享 locus· ; Z-或X-链接)和个人 GenotypeRecords(视觉、单身、超级、湿润、, 有可能是偶然的,非载人,未知;如何知道.

  • pairingOdds ——每个蝗虫的预期后代(超级形态,复合体,与性别相接 按后代性别划分; 假设没有未记录的基因,并报告为假设.
  • expectedNormalLookingRecord 例如,66%的可能从两个het.
  • checkOffspring ——被记录的父母不能生产的旗帜后代(检查亲子关系).
  • carrierFromOffspring - 由视觉沉降后代证明的载体;建议 仅限(basis: 'inferred') (中文(简体) ).
  • genotypeSummary ——"超级帕斯特66%的可能Het Pied"出自唱片.

无事可猜:多基因和未经证实的基因没有概率,而一个与性别相关的基因需要性. 单位 @captiveorigins/onepedigree-react, (中文(简体) ), genotypes 在每个节点上绘制多个基因的 alle 点 (每个基因2个点,每个副本1个), GenotypeDots 把他们引到任何地方 geneOverlay 专注于一个 基因具有通常的基因血统符号和 GeneLegend。 。 。 .

发展

pnpm install
pnpm typecheck && pnpm test && pnpm build   # build also writes apps/playground/dist (gallery.html, index.html)

apps/playground 显示每个固定位置的每个视图 : dist/gallery.html (静态,服务器 - (已作出)和 dist/index.html (交互;服务文件夹等). python3 -m http.server) (中文(简体) ).

许可证

非商业形式 1.0.0. 免费用于非商业用途,具有归属性;商业用途需要从Captive Origins获得单独的许可证. 这一变化之前出版的版本仍然属于麻省理工学院.

版本与发布记录

@captiveorigins/onepedigree-core 共发布 11 个版本,首次发布于 2026/11/01;过去 12 个月发布了 11 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.0-alpha.132026/11/09今天
0.1.0-alpha.15latest2026/11/09今天
0.1.0-alpha.122026/11/063 天前
0.1.0-alpha.112026/11/036 天前
0.1.0-alpha.102026/11/036 天前
0.1.0-alpha.92026/11/036 天前

其他发布通道:alpha → 0.1.0-alpha.8。

关于 @captiveorigins/onepedigree-core 的常见问题

@captiveorigins/onepedigree-core 是什么?

OnePedigree核心:物种中性pedigree数据模型,验证,有分界线的traversal,查看预测和布局,没有回放,有效载荷或数据库依赖性.

如何安装 @captiveorigins/onepedigree-core?

在项目目录运行 npm install @captiveorigins/onepedigree-core,或使用 pnpm add / yarn add / bun add。

@captiveorigins/onepedigree-core 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@captiveorigins/onepedigree-core 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@captiveorigins/onepedigree-core 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@captiveorigins/onepedigree-core 可以商用吗?

@captiveorigins/onepedigree-core 使用 PolyForm-Noncommercial-1.0.0 许可。声明的许可为 PolyForm-Noncommercial-1.0.0,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

@captiveorigins/onepedigree-core 的下载量有多少?

根据 npm 官方下载统计,@captiveorigins/onepedigree-core 在 2026/10/09 – 2026/11/07 这 30 天内被下载 1,903 次,日均约 63 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@captiveorigins/onepedigree-core 还在维护吗?

最新版本 0.1.0-alpha.15 发布于 2026/11/09(今天);至今共发布 11 个版本,其中过去 12 个月发布了 11 个;首次发布于 2026/11/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。