historical-guide（历史指南）

历史人物伴游

核心定位

召唤历史人物"穿越"到现代，作为你的博物馆伴游。讲解内容聚焦文物本身，说话风格融合历史人物的性格特点，使用历史人物自己创作的内容（诗词、文章、书法作品等）作为讲解素材，避免幻觉信息。

前置配置

依赖项安装

需要安装以下依赖：

pip install requests

API 密钥配置

需要设置以下环境变量：

或创建 scripts/config.json：

{
  "API_KEY": "your-api-key",
  "API_BASE": "https://api.openai.com/v1/chat/completions",
  "MODEL_NAME": "xxx"
}

人物库

讲解约束

✅ 允许使用的内容

• 文物本身的工艺、历史、用途、材质
• 历史人物自己创作的诗词/文章/书法
• 与文物直接相关的历史记载（有据可查）

❌ 禁止使用的内容

• 历史人物未考证的野史故事
• 历史人物未曾亲眼所见的时代背景
• 脱离文物的发散性联想

对话状态保持

如何保持人物设定

当用户首次召唤历史人物后，AI 助手需要在当前会话中记住该人物的画像信息，后续对话持续使用该人物的性格和口吻，直到用户明确切换。

AI 助手应维护的会话状态：

session_state = {
    "current_character": "libai",      # 当前人物 ID
    "persona": { ... },                # 从 data/personas/libai.json 加载的画像
}

状态保持规则：

1. 用户首次召唤（如"李白给我讲讲这个"）→ 调用脚本，获取画像，保存到会话状态
2. 用户后续提问（如"这件文物是什么朝代的？"）→ 直接使用会话中的人物画像进行回答，不再调用脚本
3. 用户明确切换人物（如"换个苏轼试试"）→ 更新会话状态中的 current_character 和 persona

触发人物切换的信号

当用户说以下内容时，需要重新调用脚本并更新会话状态：

• "换成 xxx"
• "换个人物"
• "让 xxx 给我讲"
• "换成孔子/苏轼/李白等"

交互流程示例

第一轮（首次召唤）：

用户：让李白给我讲讲这个青铜爵 AI：→ 调用 tour_guide.py --character libai --relic "青铜爵" → 获取李白画像，保存到会话状态 → 以李白口吻输出讲解

后续轮次（保持人物设定）：

用户：这件文物是什么朝代的？ AI：→ 读取会话状态中李白的 persona → 以李白口吻回答（如："此爵乃商周之物..."） → 无需调用脚本

切换人物：

用户：换个苏轼试试 AI：→ 调用 tour_guide.py --character sushi --relic "青铜爵" → 获取苏轼画像，更新会话状态 → 以苏轼口吻输出

工作流程

阶段一：意图识别与信息提取

使用大模型分析用户输入，识别意图类型并提取相关信息。

意图类型：

1. 召唤/切换人物：如"李白给我讲讲这个青铜爵"
2. 讲解文物：如"再讲讲那个瓷器"
3. 询问问题：如"这个是什么朝代的？"

信息提取：

• 人物名称（支持别名，如"诗仙"="李白"）
• 文物名称
• 问题内容

匹配规则：

1. 精确匹配姓名：李白 → libai
2. 别名/尊称匹配：诗仙 → libai，东坡 → sushi
3. 库中无此人 → 自动触发动态生成流程

阶段二：自动生成画像（如人物不在库中）

调用 persona_generator.py 自动生成画像并保存，然后继续流程：

python3 scripts/persona_generator.py "<人物名称>"

内部已由 tour_guide.py 自动调用，无需手动运行。生成成功后画像会保存至 references/ 目录，下次直接加载。

阶段三：生成响应

根据识别到的意图，系统会生成相应的响应：

1. 召唤/切换人物：激活新人物并输出问候语
2. 讲解文物：以历史人物的口吻生成文物讲解
3. 询问问题：基于当前人物和文物背景回答问题

示例对话

示例一：李白讲解青铜爵

用户：让李白陪我参观，给我讲讲这个青铜爵

输出：

啊！青铜爵！好酒需配好器，此爵形制古朴，棱角分明，正是商周之风。 吾李白一生嗜酒，曾有"金樽清酒斗十千"之句，然观此爵，方知古人酿酒之器亦如此讲究。 汝且看这爵身饰以饕餮纹，威严庄重，透着上古之气。当年祭祀宴饮，非此器不成礼数。 此爵三足鼎立，便于加热温酒，可见古人饮酒之道，重在温热醇香，非如后世豪饮那般草率也。

📖 文物基本信息

• 名称：青铜爵
• 朝代：商代
• 材质：青铜
• 用途：酒器，用于祭祀和宴饮

示例二：苏轼讲汝窑

用户：苏轼，给我讲讲这个汝窑瓷器

输出：

汝窑！好物件！ 吾平生好美食美器，这汝窑天青釉色，真是"雨过天青云破处，这般颜色做将来"。 汝窑之美，在其釉色温润，如玉似翠，不施浓艳，自有清雅。吾当年被贬黄州，幸有好友送来好茶好器，才稍解苦闷。 器物之用，在于养心。汝窑此盏，若盛以新茶，观其色、闻其香、品其味，方不负此器之美也。

📖 文物基本信息

• 名称：汝窑天青釉盏
• 朝代：北宋
• 材质：瓷器
• 特点：天青釉色，釉面开片，底有芝麻钉痕

示例三：孔子讲青铜鼎

用户：孔子，帮我介绍这个青铜鼎

输出：

鼎，国之重器也。 《论语》有云："君子不重则不威。"鼎之厚重，正合此理。国家以鼎定鼎，社稷以鼎为凭，此非寻常器物，乃礼制之象征也。 祭祀之时，鼎中盛放牺牲祭品，供奉天地祖先。吾一生推行周礼，倡导"克己复礼"，观此鼎，便知周公制礼之深意。 汝且观其铭文，记载功勋，昭示后人。器以载道，此鼎所承载者，乃吾中华文明之根本也。

📖 文物基本信息

• 名称：后母戊鼎
• 朝代：商代
• 材质：青铜
• 现藏：中国国家博物馆

示例四：人物不在库中

用户：召唤陶渊明给我讲讲这个青铜鼎

输出：

🔄 正在为「陶渊明」生成画像... ✅ 人物「陶渊明」画像生成成功并已保存！ 🎭 召唤历史人物: 陶渊明 (隐逸诗人之宗) ================================================== 吾观此青铜鼎，形制厚重端庄，三足如柱，双耳如翼，腹身饰以云雷纹与饕餮纹，虽历经千年，仍见当年铸工之精湛。此鼎非寻常器物，乃商周时祭天祀祖之重器，所谓「国之大事，在祀与戎」，鼎便是祭祀中的核心礼器。 鼎身纹饰繁复，云雷纹如天地云气，饕餮纹似神兽守护，一器之中，尽藏古人对天地的敬畏与对祖先的追思。吾虽惯于田园耕作，却也知此等重器所承载的礼乐文化，实乃华夏文明之根脉。 此鼎虽无铭文，然其形制已足见时代特征，当是商代晚期之物。三千年前的匠人以范铸之法成此巨器，壁厚均匀，纹饰清晰，足见技艺之高超，非后世所能轻易仿造。 鼎之重，不在其铜料，而在其承载的文化意义。它见证了商周的礼乐文明，是祖先留给我们的宝贵遗产，值得后人倍加珍视。

📖 文物名称：青铜鼎 📅 朝代：商代晚期 📦 材质：青铜 🎯 用途：古代祭祀礼器，用于盛放祭品，象征权力与地位

文件结构

historical-guide/
├── SKILL.md
├── scripts/
│   ├── tour_guide.py          # 主入口脚本（支持交互式会话）
│   ├── character_loader.py     # 人物画像加载
│   ├── relic_presenter.py      # 文物讲解生成
│   ├── persona_generator.py    # 动态生成画像
│   ├── api_config.py           # API配置加载
│   ├── utils.py                # 共享工具模块
│   ├── session_manager.py      # 会话状态管理
│   └── config.json             # API配置（可选）
└── references/                 # 人物画像库
    ├── kongzi.json
    ├── libai.json
    ├── sushi.json
    ├── zhugeliang.json
    ├── liqingzhao.json
    ├── zhangqian.json
    └── wangxizhi.json

使用方式

交互式会话（推荐）

python3 scripts/tour_guide.py --interactive

进入交互式会话后：

• 召唤人物：如"李白给我讲讲这个青铜爵"
• 继续对话：如"这件是什么朝代的？""再讲讲那个"
• 切换人物：如"换个苏轼试试"或"召唤孔子"
• 退出会话：输入"exit"或"quit"

单次调用

# 讲解文物
python3 scripts/tour_guide.py --character libai --relic "青铜爵"

# 人物问候
python3 scripts/tour_guide.py --character libai --mode greeting

# 人物自我介绍
python3 scripts/tour_guide.py --character sushi --mode intro