文物讲解词一键生成

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

目录结构

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 信息：

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

配置说明：

使用方法

交互式运行

cd scripts
python narration_generator.py

程序会引导您：

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

工作流程

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

自动风格判断

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

输出示例

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

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

生成中...

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

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

支持的 API

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

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

技术特点

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