Arduino UNO Q 讲好中国儿童故事

本示例国产大模型睡前故事讲述器是一个使用Arduino UNO Q构建的生成式AI应用，通过HTTP API直接调用科大讯飞Spark X1.5大语言模型，根据用户选择的参数创建个性化中文睡前故事。应用使用Streamlit构建直观的用户界面，支持实时参数调整和故事生成。

主要功能：

使用科大讯飞Spark X1.5大语言模型生成高质量中文睡前故事。

通过HTTP API直接调用，无需额外的原厂LLM Brick，更加适合中国网络环境，

使用Streamlit构建的现代化UI界面，带有精美国产动画背景图片，

支持多种故事参数自定义：年龄、主题、语调、结局类型、叙事结构、时长等，

支持随机生成故事功能，一键创建中国元素的成语故事，红色经典等积极教育意义的故事，

响应式设计，适配不同设备屏幕。

硬件：

Arduino UNO Q (x1)

USB-C电缆（用于供电和编程）(x1)

软件:

Arduino App Lab

科大讯飞Spark X1.5 API密钥

此示例需要有效的互联网连接以访问AI提供商的API。您还需要使用的服务的有效API密钥，目前科大讯飞Spark X1.5提供免费服务值得推荐。此外科大讯飞开源了API调用的示例方便二次开发。

下图中密钥为APIPassword，点击文档在跳转页面下载示例程序

引入WebUI - Streamlit金砖配置

python程序main.py输入：

复制代码

# SPDX-FileCopyrightText: Copyright (C) ARDUINO SRL (http://www.arduino.cc)
#
# SPDX-License-Identifier: MPL-2.0

import re
import os
import json
import datetime
import hashlib
import hmac
import base64
import urllib.parse
import requests
from arduino.app_utils import App

# 科大讯飞Spark X1.5 API配置
SPARK_API_KEY = "你申请的密钥"
SPARK_API_URL = "https://spark-api-open.xf-yun.com/v2/chat/completions"

def call_spark_api(prompt):
    """调用科大讯飞Spark X1.5 API"""
    headers = {
        "Authorization": f"Bearer {SPARK_API_KEY}",
        "Content-Type": "application/json"
    }
    
    # 构建请求体
    data = {
        "model": "spark-x",
        "messages": [
            {
                "role": "system",
                "content": "你是一个擅长讲述中国传统文化故事的儿童睡前故事讲述者。你的回答必须是故事本身，直接用HTML格式呈现。不要将回答包装在markdown代码块或任何其他格式中。使用<h1>、<h2>等标签作为标题和副标题。使用<strong>或<b>标签表示粗体文本。包含相关的表情符号。如果故事是分章节的，使用标题标签作为章节标题。请用中文回复，确保故事内容适合儿童睡前阅读。特别擅长讲述成语故事、西游记等经典名著、红色经典故事等中国传统文化题材。"
            },
            {
                "role": "user",
                "content": prompt
            }
        ],
        "stream": False,  # Streamlit UI不适合流式响应，改为非流式
        "temperature": 0.8,
        "max_tokens": 2048
    }
    
    try:
        response = requests.post(SPARK_API_URL, headers=headers, json=data, timeout=60)
        
        if response.status_code == 200:
            result = response.json()
            if 'choices' in result and len(result['choices']) > 0:
                return result['choices'][0]['message']['content']
            else:
                return "API返回了无效的响应格式"
        else:
            return f"API请求失败，状态码: {response.status_code}, 错误信息: {response.text}"
    
    except Exception as e:
        return f"API调用异常: {str(e)}"

def generate_stories_app():
    """使用Streamlit UI构建故事生成应用"""
    import streamlit as st
    
    st.set_page_config(
        page_title="国产大模型睡前故事讲述器",
        page_icon="🏰",
        layout="wide"
    )
    
    # 读取并编码背景图片
    import base64
    try:
        with open("assets/img/storyteller-background.png", "rb") as image_file:
            encoded_string = base64.b64encode(image_file.read()).decode()
        
        st.markdown(
            f"""
            <style>
            .stApp {{
                background-image: url("data:image/png;base64,{encoded_string}");
                background-size: cover;
                background-position: center;
                background-repeat: no-repeat;
                background-attachment: fixed;
            }}
            </style>
            """,
            unsafe_allow_html=True
        )
    except Exception as e:
        st.error(f"无法加载背景图片: {e}")
    
    st.title("🏰 国产大模型睡前故事讲述器")
    
    # 创建侧边栏用于参数设置
    st.sidebar.header("📚 故事参数设置")
    
    # 年龄选择
    age_options = ["3-5岁", "6-8岁", "9-12岁", "13-16岁"]
    age = st.sidebar.selectbox("年龄段", age_options)
    
    # 主题选择
    theme_options = ["奇幻/冒险", "童话", "成语故事", "西游记", "科学/宇宙", "动物", "喜剧", "红色经典"]
    theme = st.sidebar.selectbox("故事主题", theme_options)
    
    # 语调选择
    tone_options = ["平静甜美", "史诗冒险", "活泼愉快", "神秘好奇", "智慧深思", "紧张怪诞"]
    tone = st.sidebar.selectbox("故事语调", tone_options)
    
    # 结局类型
    ending_options = ["快乐安心", "开放式神秘", "有道德寓意", "戏剧性但有希望"]
    ending_type = st.sidebar.selectbox("结局类型", ending_options)
    
    # 叙事结构
    structure_options = ["经典", "分章节", "系列剧式"]
    narrative_structure = st.sidebar.selectbox("叙事结构", structure_options)
    
    # 故事时长
    duration_options = ["短篇 5分钟", "中篇 10-15分钟", "长篇 20+分钟"]
    duration = st.sidebar.selectbox("故事时长", duration_options)
    
    # 其他要求
    other = st.sidebar.text_area("其他要求（可选）", height=100)
    
    # 生成按钮
    generate_button = st.sidebar.button("📖 生成故事", type="primary")
    
    # 随机生成按钮
    random_button = st.sidebar.button("🎲 随机生成")
    
    if random_button:
        import random
        age = random.choice(age_options)
        theme = random.choice(theme_options)
        tone = random.choice(tone_options)
        ending_type = random.choice(ending_options)
        narrative_structure = random.choice(structure_options)
        duration = random.choice(duration_options)
        st.sidebar.success("已随机选择参数！")
    
    # 主内容区域
    if generate_button:
        # 创建提示
        prompt = f"作为一个喜欢给{age}的孩子读睡前故事的家长，我需要一个愉快且适合年龄的故事。"
        
        # 根据主题类型添加特定提示
        if theme == "成语故事":
            prompt += " 请创作一个基于中国成语的故事，解释成语的由来和含义，使用生动有趣的方式讲述。"
        elif theme == "西游记":
            prompt += " 请创作一个基于西游记人物和情节的冒险故事，保持原著的风格和价值观。"
        elif theme == "红色经典":
            prompt += " 请创作一个类似《鸡毛信》、《小兵张嘎》、《闪闪的红星》等红色经典的故事，传承革命精神和爱国情怀。"
        else:
            prompt += f" 故事类型是{theme}。"
            
        prompt += f"语调应该是{tone}。"
        prompt += f"请确保故事有{narrative_structure}的叙事结构，给孩子留下{ending_type}的感觉。"
        prompt += f"长度应该大约是{duration}。语言应该易于理解，适合我孩子的年龄理解能力。"
        prompt += "请在故事中加入适合中国儿童的文化元素和价值观念。"
        
        if other:
            prompt += f"\n\n其他可选的故事元素：{other}"
        
        # 显示加载状态
        with st.spinner("正在生成故事..."):
            # 调用API生成故事
            story = call_spark_api(prompt)
        
        # 显示故事
        st.header("📖 生成的故事")
        st.markdown(story, unsafe_allow_html=True)
        
        # 添加复制按钮
        if st.button("📋 复制故事"):
            st.write("故事已复制到剪贴板")
    else:
        st.info("请在左侧设置参数后点击\"生成故事\"按钮")
        
        # 显示示例故事
        st.header("📖 示例故事")
        example_story = """
        <h1>小兔子的冒险</h1>
        <p>从前，有一只可爱的小兔子，它住在一个美丽的森林里...</p>
        """
        st.markdown(example_story, unsafe_allow_html=True)
        st.caption("这是一个示例故事，设置参数并点击生成按钮来创建您自己的故事！")

# 使用Streamlit运行应用
if __name__ == "__main__":
    generate_stories_app()

背景图片按照此路径assets/img/storyteller-background.png放置，尺寸笔者给的是1980x1024大小。

使用说明

启动应用后，您会看到一个带有精美背景的Streamlit界面，
在左侧边栏中设置故事参数：

年龄段：选择适合的年龄段（3-5岁、6-8岁、9-12岁、13-16岁）

故事主题：选择故事类型（奇幻/冒险、童话、成语故事、西游记、科学/宇宙、动物、喜剧、红色经典）

故事语调：选择叙述风格（平静甜美、史诗冒险、活泼愉快等）

结局类型：选择故事结尾方式（快乐安心、开放式神秘等）

叙事结构：选择故事结构（经典、分章节、系列剧式）

故事时长：选择故事长度（短篇、中篇、长篇）

点击"生成故事"按钮，科大讯飞Spark X1.5将根据您的设置生成个性化中文故事，
或点击"随机生成"按钮，系统会随机选择参数生成故事。

较原厂程序笔者的方案更加简单，更加容易理解。融入中国元素，契合国情使开源硬件在中国落地生根，枝繁叶茂。以此示例建议大家在应用中多采用国产大语言模型，这样国产大语言模型才能越做越好，越来越聪明。