---
title: Fzd8
emoji: 📚
colorFrom: indigo
colorTo: indigo
sdk: gradio
sdk_version: 6.0.2
app_file: app.py
pinned: false
---
# 冯氏家谱RAG机器人
基于Hugging Face Spaces部署的冯氏宗族专属家谱问答机器人，依托RAG（检索增强生成）技术，精准回答家谱中的亲属关系、生卒信息、字辈世代等问题。

## 功能特点
1. **亲属关系查询**：支持查询人物的父母、子女、配偶、上下辈、支系亲属等信息
2. **生卒信息查询**：支持查询人物的出生/卒亡日期（农历+公历）、出生地、卒地、寿龄等信息
3. **字辈世代查询**：支持查询冯氏25字辈完整序列、人物字辈、世代排序、上下字辈等信息
4. **组合查询**：支持同时查询亲属+生卒+字辈的多维度信息
5. **提问引导**：对模糊提问提供标准化提问示例，提升使用体验

## 部署步骤（Hugging Face Spaces）
### 1. 新建HF Spaces仓库
- 打开Hugging Face官网，进入Spaces页面，点击「Create new Space」
- 填写仓库名称（如`feng-shi-jia-pu-rag`），选择「Gradio」框架，点击「Create Space」

### 2. 上传文件
将以下文件上传至HF Spaces仓库根目录：
- `app.py`：主程序入口
- `requirements.txt`：依赖包清单
- `README.md`：项目说明
- `knowledge_base/`：知识库文件夹（包含`family_tree.txt`、`prompt_template.txt`、`query_library.txt`、`generation_verses.txt`）
- `assets/`（可选）：静态资源文件夹

### 3. 等待部署完成
HF Spaces会自动根据`requirements.txt`安装依赖，并运行`app.py`，部署完成后可直接访问生成的链接使用。

## 使用方法
### 1. 直接提问
在输入框中输入标准化问题，例如：
- 冯乔福的子女有谁？
- 冯仁杰的出生地和生卒日期是什么？
- 宗字辈的上一辈是什么字辈？

### 2. 参考提问词库
可查看`knowledge_base/query_library.txt`中的提问示例，获取更多提问方式。

### 3. 查看回答
机器人会根据家谱知识库返回精准的回答，包含姓名、字辈、生卒、亲属等核心信息。

## 项目结构
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference