文物讲解词一键生成#

用户输入文物名称、博物馆和 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 独立：模板与代码分离，易于调整