ClawHub

Cultural Relics Guide

Data & APIs

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

Install

openclaw skills install guide

文物讲解词一键生成

用户输入文物名称、博物馆和 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
  }
}

配置说明：

字段必填说明
base_url✅API 服务器地址
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 独立：模板与代码分离，易于调整
More in Data & APIs