Cultural Relics Guide

文物讲解词一键生成。用户只需提供文物名称和 API 信息，系统自动判断讲解风格并生成400-500字的专业讲解词。

文物讲解词一键生成

用户输入文物名称、博物馆和 API 信息 → 系统自动判断风格 → 生成400-500字讲解词

---

目录结构

text

narration-generator/
├── SKILL.md                    # 本文件
├── config/
│   ├── user_config.example.json # 配置模板（示例）
│   ├── user_config.json        # 用户配置（实际使用）
│   └── prompts.json            # Prompt 模板
└── scripts/
    ├── narration_generator.py   # 主程序
    └── utils.py                # 公共工具

---

首次使用配置

1. 编辑配置文件

打开 config/user_config.json，填入您的 API 信息：

json

{
  "api": {
    "base_url": "https://your-api.com/v1/chat/completions",
    "api_key": "您的API密钥",
    "model_narration": "模型名称",
    "model_style": "模型名称",
    "timeout": 60
  }
}

配置说明：

字段	必填	说明
base_url	✅	API 服务器地址
api_key	✅	API 密钥
model_narration	✅	讲解词生成模型
model_style	❌	风格判断模型（默认同讲解模型）
timeout	❌	超时时间（秒），默认60

---

使用方法

交互式运行

bash

cd scripts
python narration_generator.py

程序会引导您：

1. 配置 API（如首次使用）
2. 输入文物名称和博物馆
3. 选择听众类型
4. 可选：输入额外问题
5. 自动生成讲解词

---

工作流程

text

输入文物信息 → 自动判断风格 → 生成讲解词 → 输出结果

自动风格判断

系统根据听众画像自动适配讲解风格（用户无需选择）：

听众类型	系统自动适配风格
普通游客	通识全面型
儿童	儿童探索型
学者/研究者	深度学术型
自定义描述	智能判断

---

输出示例

text

============================================================
🖼️  文物讲解词一键生成
============================================================

文物: 后母戊鼎 | 博物馆: 中国国家博物馆 | 听众: 普通游客
确认生成? (Y/n): Y

生成中...

============================================================
这件重达832.84公斤的青铜巨兽，是三千多年前商王朝的国力象征...
（完整讲解词）

------------------------------------------------------------
字数: 512 | 已保存: 讲解词_后母戊鼎.txt

---

支持的 API

所有兼容 OpenAI API 格式的服务商：

• 火山引擎（豆包）
• DeepSeek
• 阿里云（通义千问）
• OpenAI
• 本地模型（Ollama 等）

---

技术特点

• 零依赖：仅使用 Python 标准库
• 自动风格适配：根据听众自动判断，用户无需选择
• 配置持久化：API 配置保存后下次无需重复输入
• Prompt 独立：模板与代码分离，易于调整