| --- |
| 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 |
|
|
