名称： gedcom-explorer
描述： 从任意 GEDCOM (.ged) 文件生成交互式家谱仪表盘。创建一个包含 5 个标签页（仪表盘、家谱、人物、时间线、每日提醒）的单文件 HTML 应用，支持搜索、人物详情弹窗、图表和“历史上的今天”事件。当用户要求可视化族谱数据、探索家族历史、构建家谱查看器或处理 GEDCOM 文件时使用。触发词包括“family tree”、“genealogy”、“GEDCOM”、“ancestors”、“family explorer”、“family history dashboard”。

GEDCOM 家谱浏览器

解析任意 GEDCOM 文件并生成一个独立的交互式 HTML 仪表盘。

快速开始

python3 scripts/build_explorer.py <输入.ged> [输出.html] [--title "标题"] [--subtitle "副标题"]

示例

# 基础用法 — 在当前目录生成 family-explorer.html
python3 scripts/build_explorer.py ~/my-family.ged

# 自定义输出路径和标题
python3 scripts/build_explorer.py ~/my-family.ged ~/Desktop/hart-family.html \
  --title "Hart 家族树" --subtitle "六代人的历史"

# 使用内置的美国总统数据演示
python3 scripts/build_explorer.py assets/demo-presidents.ged presidents.html \
  --title "总统家族浏览器" --subtitle "美国总统及其祖先"

功能特性

• 仪表盘 — 统计网格（人物、家庭、地点、世代）、今日历史事件、常见姓氏、地理起源、世纪人物分布、党派构成（针对总统数据）
• 家谱图 — 交互式树状图，支持缩放/平移，可选择任意人物作为根节点，按性别/总统身份颜色编码
• 人物目录 — 可搜索/筛选的人物列表，支持性别和总统筛选、分页，点击可查看完整详情弹窗
• 时间线 — 按时间顺序显示事件（出生、死亡、婚姻），支持筛选和搜索
• 每日提醒 — 今日纪念日、随机祖先聚焦、趣味知识
• 人物详情弹窗 — 完整详情视图，包含父母、配偶、子女（均为可点击链接）
• 全局搜索 — 在所有标签页中按姓名、地点或年份搜索

工作原理

build_explorer.py 解析 GEDCOM 文件，提取所有个人和家庭信息，计算统计数据，并将所有内容以内联 JSON 形式嵌入单个 HTML 文件。无需服务器 — 直接打开 HTML 文件即可使用。

自动从 OCCU（职业）字段识别美国总统数据。适用于任何 GEDCOM 文件；若无总统数据，相关功能将不会显示。

GEDCOM 数据来源

用户可从以下平台导出 .ged 文件：
- Ancestry.com → 树设置 → 导出树
- FamilySearch.org → 下载 GEDCOM
- MyHeritage → 家谱 → 导出 → GEDCOM
- 任何族谱软件（Gramps、RootsMagic、Legacy 等）

演示数据

assets/demo-presidents.ged — 公共领域的美国总统 GEDCOM 数据（2,322 人，1,115 个家庭，44 位总统）。来源：webtreeprint.com。

本地运行

cd /path/to/output/dir
python3 -m http.server 8899
# 打开 http://localhost:8899/family-explorer.html

扩展与定制

生成的 HTML 文件完全独立。如需自定义：
- 编辑 :root 中的 CSS 变量以调整主题
- 仪表盘会根据 GEDCOM 中的数据自适应 — 无需总统数据
- 如需与 OpenClaw 定时任务集成：可解析 GEDCOM 中的每日事件，并通过 Telegram 发送“历史上的今天”通知