gedcom-explorer

🌳 一键生成互动家族历史档案馆

离线解析 GEDCOM 家谱文件,生成自包含交互式 HTML 仪表板,零依赖零上传,保护家族隐私数据安全。

收藏
14k
安装
3.5k
版本
v1.0.0
CLS 安全性认证2026-05-11
点击查看完整报告 >

使用说明

GEDCOM Explorer 是一款专注于家谱数据可视化的实用工具,能够将标准的 GEDCOM (.ged) 格式文件转换为独立的交互式 HTML 仪表板。用户只需通过简单的命令行操作,即可生成包含五大功能模块(仪表板概览、家族树、人员目录、时间线和每日提醒)的单文件应用,无需任何服务器环境或外部依赖,直接在浏览器中打开即可使用。

该工具的核心优势在于其完全离线的处理能力和出色的数据隐私保护。不同于需要上传家族数据至云端的家谱平台,GEDCOM Explorer 在本地完成所有解析和渲染工作,生成的 HTML 文件自包含所有数据,确保敏感的家族信息不会离开用户设备。工具支持从 Ancestry.com、FamilySearch.org、MyHeritage 等主流家谱平台导出的 GEDCOM 文件,具备智能识别功能(如自动检测美国总统职业标记),并提供丰富的交互体验,包括可缩放拖拽的家族树、全文搜索、人员详情弹窗和"历史上的今天"事件提醒。

然而,该工具也存在一些局限性。首先,生成的 HTML 文件会引用 Google Fonts CDN 加载字体,虽然不影响功能,但在完全离线的环境中可能导致样式回退。其次,输出文件缺乏覆盖保护机制,若目标路径已存在同名文件将被直接覆盖,用户需自行管理输出路径。此外,由于所有数据都内嵌在单个 HTML 文件中,处理超大型家谱(数万人规模)时可能面临浏览器性能瓶颈和加载延迟。

该工具非常适合家谱研究者、家族史爱好者、传记作家以及需要安全分享家族数据的用户。对于注重隐私、不希望将家族历史上传至商业平台的研究者而言,这是理想的本地可视化方案。同时,生成的单文件 HTML 便于通过邮件、网盘等方式与亲属安全共享。

使用风险方面,主要需注意:1)文件覆盖风险,建议输出前确认目标路径;2)敏感数据暴露,生成的 HTML 包含完整的家族信息,分享时需谨慎;3)浏览器性能限制,极大数据集可能导致卡顿;4)字体加载依赖,完全离线环境可能缺失网络字体。

安全解读

核心用法

GEDCOM Explorer 是一款纯 Python 实现的族谱数据可视化工具。用户只需执行单条命令,即可将任何标准 .ged 文件转换为自包含的单页 HTML 应用,无需服务器或联网即可运行。

典型工作流
1. 从 Ancestry、FamilySearch 或 MyHeritage 导出 GEDCOM 文件

2. 运行 python3 build_explorer.py input.ged output.html

3. 直接用浏览器打开生成的 HTML,获得 5 大功能模块

5 大功能模块

  • Dashboard:统计概览(人数、家族、地点、世代数)、"历史上的今天"事件、姓氏分布、地理起源、世纪分布图
  • Family Tree:可缩放平移的交互式树状图,支持任意人物设为根节点,按性别/身份着色
  • People:可搜索、筛选、分页的完整人员目录,点击弹出详细模态框
  • Timeline:按时间排序的生命事件(出生、死亡、婚姻),支持筛选与搜索
  • Daily Alerts:今日纪念日、随机祖先 spotlight、趣味 facts

显著优点

| 维度 | 优势 |
|------|------|

隐私安全 | 100% 本地处理,不上传任何数据,无账号系统 |
零依赖 | 纯 Python 3 标准库,无 pip 安装负担,无供应链风险 |

便携性 | 输出为单 HTML 文件,可邮件发送、U 盘携带、离线存档 |

兼容性 | 支持任何标准 GEDCOM 源,自动适配数据内容(如检测到美国总统数据会展示政党分布) |

性能 | 测试数据集含 2,322 人、1,115 个家族,生成与加载均无压力 |

潜在缺点与局限性

  • 外部字体依赖:生成的 HTML 默认引用 Google Fonts(Inter 字体),完全离线环境需手动处理(虽已有系统字体回退)
  • 无实时协作:单机文件,不支持多用户同步编辑
  • GEDCOM 格式依赖:仅支持标准 GEDCOM 5.5/5.5.1,非常见扩展格式或损坏文件可能解析失败
  • 无移动端优化:UI 以桌面浏览器体验为主,手机可用但非最佳
  • 数据单向:可视化工具,不支持从 HTML 回写修改至 GEDCOM

适合人群

  • 家族史研究者:希望以可视化方式探索、分享族谱成果
  • 隐私敏感用户:拒绝将族谱数据上传至云端平台
  • 技术爱好者:需要可自托管、可二次开发的族谱工具
  • 教育工作者:以美国总统 demo 数据开展历史教学

常规风险

  • 数据泄露风险极低:全程本地处理,但用户需注意生成的 HTML 文件本身包含全部族谱数据,分享时需评估隐私
  • 来源可信度:T2 级别(GitHub 社区个人开发者),代码开源透明,建议关键使用前审查源码
  • 长期维护:个人项目,无企业级 SLA 保障
  • 离线可用性:除字体加载外完全离线,建议对隐私极端敏感者移除 Google Fonts 引用

gedcom-explorer 内容

scripts文件夹
手动下载zip · 18.2 kB
build_explorer.pytext/plain
请选择文件