家谱可视化工具

技能简介

将任意GEDCOM格式的家谱文件转换为独立的互动式HTML仪表板，无需服务器即可在浏览器中浏览完整的家族历史数据。

业务背景

该工具将家谱数据转化为可离线浏览的互动仪表板，帮助家族组织、文化机构或研究人员以可视化方式呈现复杂血缘关系。无需服务器部署，单个HTML文件即可实现多维度探索，兼顾隐私性与传播便利性。

落地案例：某家族史研究协会收集到一份包含800人的GEDCOM档案，希望向成员展示研究成果。管理员运行转换脚本生成独立HTML文件，成员在浏览器中即可缩放查看家谱树、搜索特定人物、浏览跨代时间轴。整个方案零运维成本，文件加密分享后仅限内部传阅。

能做什么

• 统计面板：展示人物数量、家庭数、地点分布、世代跨度等核心指标
• 互动家谱树：支持缩放平移，可切换任意成员为根节点，按性别着色
• 人物目录：可搜索筛选的完整成员列表，点击查看详细档案弹窗
• 时间轴视图：按时间排序的出生、死亡、婚姻事件，支持年份检索
• 每日提醒：今日纪念日、随机祖先推荐、趣味家族史知识
• 全局搜索：跨所有标签页按姓名、地点或年份快速定位

使用说明

安装准备

本技能依赖Python 3环境，无需额外安装第三方库，仅需下载脚本文件即可运行。

执行步骤

1. 获取GEDCOM文件：从Ancestry.com、FamilySearch.org、MyHeritage等平台导出.ged文件，或使用Gramps等家谱软件生成
2. 运行转换命令：python3 scripts/build_explorer.py <输入文件.ged> [输出文件.html] [--title "标题"] [--subtitle "副标题"]
3. 打开生成的HTML文件即可查看完整仪表板

示例命令

python3 scripts/build_explorer.py ~/my-family.ged
python3 scripts/build_explorer.py ~/my-family.ged ~/Desktop/hart-family.html --title "Hart Family Tree" --subtitle "Six generations of history"
python3 scripts/build_explorer.py assets/demo-presidents.ged presidents.html --title "Presidential Family Explorer"

本地预览（可选）

cd /path/to/output/dir
python3 -m http.server 8899

输入与输出

见下方输入与输出表格。

风险提示

• 生成的HTML文件包含完整家谱数据，分享时需注意隐私保护
• 大型GEDCOM文件可能导致生成的HTML体积过大，加载缓慢
• 总统识别功能依赖OCCU字段标记，普通家谱数据不会显示该特性
• 所有数据以嵌入式JSON存储于HTML中，无后端数据库支持增量更新

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/justinhartbiz/gedcom-explorer/SKILL.md
来源类型：GitHub仓库