核心内容摘要
2026年开源大模型趋势入门必看：Qwen2.5+弹性GPU部署指南
目录
项目背景与技术选型
需求分析
技术栈选择
系统架构与核心模块设计
后端核心模块游戏逻辑类IdiomGame1初始成语生成generate_initial_idiom2游戏状态管理3API 接口封装
AI 交互层容错与响应处理
前端交互层用户体验优化1状态可视化2输入校验3历史记录展示4完整代码
三、
关键技术难点与解决方案
AI 响应异步处理问题
跨域请求问题
敏感配置管理
用户体验与容错平衡
系统优化与扩展方向
现有优化点
扩展方向1功能扩展2技术优化
项目
总结与思考
技术价值
产品思考
开发感悟
快速上手指南
环境准备
启动服务
访问游戏结语成语接龙作为中国传统文化的经典游戏既考验词汇量又锻炼思维敏捷度。
当传统游戏遇上 AI 技术会碰撞出怎样的火花本文将详细拆解一个基于 FlaskCoze AI 打造的智能成语接龙游戏的实现过程从技术架构、核心逻辑到用户体验优化带你深入了解如何将 AI 能力落地到实际应用中。
项目背景与技术选型
需求分析我们希望打造一个兼具趣味性和智能化的成语接龙游戏核心需求包括自动生成初始接龙成语支持游戏重置验证用户输入的成语有效性实现 AI 自动接龙记录游戏历史提供友好的交互界面具备容错机制在 AI 服务异常时保证游戏可用
技术栈选择技术 / 工具用途选型理由Flask后端 Web 框架轻量级、易上手适合快速开发小型 API 服务Coze AI智能成语生成字节跳动旗下 AI 平台支持多轮对话响应速度快中文处理能力优秀Flask-CORS跨域支持解决前端页面与后端 API 的跨域请求问题HTML/CSS/JS前端界面原生技术栈无需额外依赖适配性强dotenv环境变量管理安全管理敏感配置如 API Token便于环境切换
系统架构与核心模块设计整个系统分为后端服务层、AI 交互层和前端交互层三个核心部分架构如下前端页面HTML/JS → 后端APIFlask → Coze AI SDK → 成语生成/验证 ↑ ↓ ↓ 游戏状态展示 ← 游戏逻辑处理 ← AI响应解析与容错 ← 成语结果返回
后端核心模块游戏逻辑类IdiomGame游戏的核心逻辑封装在IdiomGame类中主要承担三个核心职责1初始成语生成generate_initial_idiomAI 调用流程构造用户指令消息调用 Coze Chat API 生成四字成语容错机制设置 30 秒超时时间若 AI 响应超时 / 返回无效结果自动切换到默认成语列表数据清洗过滤非中文字符确保返回结果为标准四字成语def generate_initial_idiom(self): try: # 构造AI请求消息 messages [Message(roleuser, content生成一个四字成语作为开头仅返回成语本身)] chat self.coze.chat.create(bot_idself.bot_id, user_idself.user_id, additional_messagesmessages) # 等待AI响应超时控制 timeout 0 while chat.status ChatStatus.IN_PROGRESS and timeout 30: chat self.coze.chat.retrieve(conversation_idchat.conversation_id, chat_idchat.id) timeout 1 time.sleep(
# 解析并清洗AI响应 initial_idiom msg.content.strip() initial_idiom .join(filter(lambda x: \u4e00 x \u9fff, initial_idiom)) if initial_idiom and len(initial_idiom) 4: return initial_idiom raise Exception(AI生成的初始成语无效) except Exception as e: # 降级策略使用默认成语列表 return random.choice(COMMON_IDIOMS)2游戏状态管理reset_game重置游戏生成新初始成语并清空历史记录add_to_history记录用户与 AI 的接龙记录限制最多保存 20 条get_sdk_response处理用户输入调用 AI 完成接龙返回标准化响应3API 接口封装后端暴露三个核心 API 接口实现前后端交互接口路径请求方法功能/api/initGET初始化游戏返回当前成语和历史记录/api/playPOST提交用户成语返回 AI 接龙结果/api/restartPOST重置游戏生成新初始成语
AI 交互层容错与响应处理AI 交互是整个系统的关键环节我们做了多层容错设计超时保护所有 AI 请求设置 30 秒超时避免服务挂起响应验证检查返回结果是否为 4 个中文字符无效则触发降级异常捕获捕获网络错误、API 调用错误等统一返回错误信息历史兜底即使 AI 服务完全不可用默认成语列表仍能保证游戏基础功能
前端交互层用户体验优化前端页面聚焦于流畅的交互体验和清晰的状态反馈核心设计点包括1状态可视化加载状态初始成语获取时显示 “加载中...”操作反馈提交按钮显示 “提交中...”禁用重复点击结果提示不同类型的消息使用不同样式成功 - 绿色、错误 - 红色、信息 - 蓝色2输入校验前端提前做输入验证减少无效请求if (!/^[\u4e00-\u9fa5]$/.test(userInput)) { showMessage(请输入中文成语, error); return; } if (userInput.length !
{ showMessage(请输入四字成语, error); return; }3历史记录展示按时间倒序展示用户与 AI 的接龙记录清晰呈现游戏进程li span classuser你: 一心一意/span span classaiAI: 意气风发/span span classtime14:25:30/span /li4完整代码后端# 导入必要的库和模块 import os # 用于操作系统环境变量 from flask import Flask, request, jsonify, send_file # Flask web框架相关功能 from cozepy import Coze, TokenAuth, ChatStatus, COZE_CN_BASE_URL, Message # Coze AI服务SDK from dotenv import load_dotenv # 用于加载环境变量文件 import uuid # 用于生成唯一的用户ID import time # 用于时间相关操作 # 加载.env文件中的环境变量 load_dotenv() # 创建Flask应用实例 app Flask(__name__) # 用于存储会话状态的字典key为客户端IP或自定义标识value为会话信息 user_sessions {} # 定义Coze服务类用于封装与Coze AI服务的交互 class CozeService: def __init__(self): # 从环境变量获取Coze API令牌如果没有则返回None self.api_token os.getenv(COZE_API_TOKEN) # 从环境变量获取机器人ID如果没有则使用默认值 self.bot_id os.getenv(BOT_ID,
# 初始化Coze客户端使用令牌认证和中国区基础URL self.coze Coze( authTokenAuth(tokenself.api_token), base_urlCOZE_CN_BASE_URL ) def get_sdk_response(self, user_message, user_identifier): 获取智能体响应基于用户标识保持会话 try: # 检查是否已有该用户的会话 if user_identifier in user_sessions: session_data user_sessions[user_identifier] conversation_id session_data[conversation_id] user_id session_data[user_id] # 构建用户消息 messages [ Message( roleuser, # 消息角色为用户 contentuser_message, # 消息内容 content_typetext, # 内容类型为文本 typequestion # 消息类型为问题 ) ] # 在现有会话中继续聊天 chat self.coze.chat.create( bot_idself.bot_id, # 指定机器人ID user_iduser_id, # 使用相同的用户ID conversation_idconversation_id, # 使用相同的会话ID additional_messagesmessages, # 添加用户消息 auto_save_historyTrue # 自动保存聊天历史 ) else: # 创建新的会话 # 生成唯一的用户ID user_id str(uuid.uuid4()) # 构建用户消息 messages [ Message( roleuser, # 消息角色为用户 contentuser_message, # 消息内容 content_typetext, # 内容类型为文本 typequestion # 消息类型为问题 ) ] # 创建新的聊天会话 chat self.coze.chat.create( bot_idself.bot_id, # 指定机器人ID user_iduser_id, # 指定用户ID additional_messagesmessages, # 添加用户消息 auto_save_historyTrue # 自动保存聊天历史 ) # 保存会话信息到user_sessions字典中 user_sessions[user_identifier] { conversation_id: chat.conversation_id, # Coze的会话ID user_id: user_id, # 用户ID chat_id: chat.id, # 聊天ID created_at: time.time(), # 会话创建时间戳 last_activity: time.time() # 最后活动时间 } # 更新最后活动时间 user_sessions[user_identifier][last_activity] time.time() # 更新chat_id每次新的聊天都会生成新的chat_id user_sessions[user_identifier][chat_id] chat.id # 轮询等待聊天完成当聊天状态为进行中时继续查询 while chat.status ChatStatus.IN_PROGRESS: chat self.coze.chat.retrieve( conversation_idchat.conversation_id, # 会话ID chat_idchat.id # 聊天ID ) # 如果聊天状态为已完成获取聊天消息 if chat.status ChatStatus.COMPLETED: messages self.coze.chat.messages.list( conversation_idchat.conversation_id, # 会话ID chat_idchat.id # 聊天ID ) # 遍历消息找到助手的回复 for msg in messages: if msg.role assistant: return { status: success, content: msg.content } # 如果对话未完成返回失败状态 return {status: failed, content: 对话未完成} except Exception as e: # 如果发生异常返回错误状态和异常信息 return {status: error, content: str(e)} # 创建CozeService实例 coze_service CozeService() app.route(/) def index(): # 在返回页面之前清理过期会话 cleanup_expired_sessions() # 返回index.html文件 return send_file(index.html) # 定义聊天路由处理POST请求 app.route(/chat, methods[POST]) def chat(): # 从请求的JSON数据中获取用户消息 data request.json user_message data.get(message) # 如果消息为空返回错误 if not user_message: return jsonify({status: error, content: 消息不能为空}) # 使用客户端IP作为用户标识也可以使用cookie或其他方式 user_identifier request.remote_addr # 获取AI响应基于用户标识保持会话 response coze_service.get_sdk_response(user_message, user_identifier) # 将响应转换为JSON格式返回 return jsonify(response) # 清理过期会话的辅助函数 def cleanup_expired_sessions(): expired_sessions [] for user_identifier, session_data in user_sessions.items(): expired_sessions.append(user_identifier) # 删除过期会话 for user_identifier in expired_sessions: del user_sessions[user_identifier] # 如果是直接运行此脚本启动Flask应用 if __name__ __main__: # 启动应用开启调试模式端口为5000 app.run(debugTrue, port
前端!DOCTYPE html html langzh-CN head meta charsetUTF-8 meta nameviewport contentwidthdevice-width, initial-scale
0 title我的人生我做主/title style * { margin: 0; padding: 0; box-sizing: border-box; } body { font-family: Arial, sans-serif; background: linear-gradient(135deg, #f5f7fa 0%, #c3cfe2 100%); color: #333; line-height:
6; min-height: 100vh; padding: 20px; } .container { max-width: 900px; margin: 0 auto; background-color: white; border-radius: 15px; box-shadow: 0 10px 30px rgba(0, 0, 0,
0.
; overflow: hidden; } header { background: linear-gradient(90deg, #3498db, #2c3e
; color: white; padding: 30px 20px; text-align: center; } header h1 { font-size:
5rem; margin-bottom: 10px; text-shadow: 1px 1px 3px rgba(0, 0, 0,
0.
; } header p { font-size:
2rem; opacity:
9; } .chat-container { display: flex; flex-direction: column; height: 500px; } .chat-messages { flex: 1; overflow-y: auto; padding: 20px; background-color: #f9f9f9; } .message { margin-bottom: 15px; padding: 12px 18px; border-radius: 18px; max-width: 80%; animation: fadeIn
3s ease; } keyframes fadeIn { from { opacity: 0; transform: translateY(10px); } to { opacity: 1; transform: translateY(
; } } .user-message { background-color: #3498db; color: white; margin-left: auto; border-bottom-right-radius: 5px; } .bot-message { background-color: #ecf0f1; color: #333; margin-right: auto; border-bottom-left-radius: 5px; } .input-area { display: flex; padding: 15px; border-top: 1px solid #eee; background-color: white; } #user-input { flex: 1; padding: 12px 18px; border: 1px solid #ddd; border-radius: 25px; outline: none; font-size: 1rem; transition: border-color
3s; } #user-input:focus { border-color: #3498db; box-shadow: 0 0 0 2px rgba(52, 152, 219,
0.
; } #send-button { margin-left: 10px; padding: 12px 25px; background-color: #3498db; color: white; border: none; border-radius: 25px; cursor: pointer; font-size: 1rem; transition: background-color
3s, transform
2s; } #send-button:hover { background-color: #2980b9; transform: scale(
1.
; } #send-button:active { transform: scale(
0.
; } .typing-indicator { display: none; padding: 10px 15px; background-color: #ecf0f1; border-radius: 18px; margin-bottom: 15px; width: fit-content; border-bottom-left-radius: 5px; } .typing-dots { display: flex; align-items: center; height: 20px; } .typing-dot { width: 8px; height: 8px; background-color: #7f8c8d; border-radius: 50%; margin: 0 3px; animation: typingAnimation
4s infinite ease-in-out; } .typing-dot:nth-child(
{ animation-delay: 0s; } .typing-dot:nth-child(
{ animation-delay:
2s; } .typing-dot:nth-child(
{ animation-delay:
4s; } keyframes typingAnimation { 0%, 60%, 100% { transform: translateY(
; } 30% { transform: translateY(-5px); } } media (max-width: 600px) { header h1 { font-size: 2rem; } header p { font-size: 1rem; } .message { max-width: 90%; } #send-button { padding: 12px 20px; } } /style /head body div classcontainer header h1我的未来我做主/h1 p与AI助手一起规划您的未来/p /header div classchat-container div idchat-messages classchat-messages div classmessage bot-message p您好我是您的未来规划助手。
请问您想了解什么关于未来规划的问题/p /div /div div classtyping-indicator idtyping-indicator div classtyping-dots div classtyping-dot/div div classtyping-dot/div div classtyping-dot/div /div /div div classinput-area input typetext iduser-input placeholder输入您的问题... button idsend-button发送/button /div /div /div script document.addEventListener(DOMContentLoaded, function() { const chatMessages document.getElementById(chat-messages); const userInput document.getElementById(user-input); const sendButton document.getElementById(send-button); const typingIndicator document.getElementById(typing-indicator); // 添加用户消息到聊天界面 function addUserMessage(message) { const messageElement document.createElement(div); messageElement.classList.add(message, user-message); messageElement.innerHTML p${message}/p; chatMessages.appendChild(messageElement); scrollToBottom(); } // 添加AI消息到聊天界面 function addBotMessage(message) { const messageElement document.createElement(div); messageElement.classList.add(message, bot-message); messageElement.innerHTML p${message}/p; chatMessages.appendChild(messageElement); scrollToBottom(); } // 显示正在输入指示器 function showTypingIndicator() { typingIndicator.style.display block; scrollToBottom(); } // 隐藏正在输入指示器 function hideTypingIndicator() { typingIndicator.style.display none; } // 滚动到底部 function scrollToBottom() { chatMessages.scrollTop chatMessages.scrollHeight; } // 发送消息到后端 async function sendMessage() { const message userInput.value.trim(); if (!message) return; // 添加用户消息到界面 addUserMessage(message); userInput.value ; // 显示正在输入指示器 showTypingIndicator(); try { // 发送请求到后端 const response await fetch(/chat, { method: POST, headers: { Content-Type: application/json }, body: JSON.stringify({ message: message }) }); const data await response.json(); // 隐藏正在输入指示器 hideTypingIndicator(); if (data.status success) { addBotMessage(data.content); } else { addBotMessage(抱歉我遇到了一些问题请稍后再试。
); console.error(API Error:, data.content); } } catch (error) { // 隐藏正在输入指示器 hideTypingIndicator(); addBotMessage(网络错误请检查您的连接。
); console.error(Fetch Error:, error); } } // 发送按钮点击事件 sendButton.addEventListener(click, sendMessage); // 输入框回车事件 userInput.addEventListener(keypress, function(e) { if (e.key Enter) { sendMessage(); } }); // 页面加载后自动聚焦到输入框 userInput.focus(); }); /script /body /html
三、
关键技术难点与解决方案
AI 响应异步处理问题Coze Chat API 采用异步响应模式直接调用后无法立即获取结果。
解决方案轮询机制调用chat.create后循环调用chat.retrieve获取最新状态超时控制设置最大轮询次数避免无限等待状态判断通过ChatStatus枚举值判断 AI 处理状态IN_PROGRESS/COMPLETED
跨域请求问题前端页面与后端 API 部署在同一域名但不同端口导致跨域请求被浏览器拦截。
解决方案引入 Flask-CORS 扩展全局启用 CORSCORS(app)生产环境可配置指定域名白名单提升安全性
敏感配置管理API Token、Bot ID 等敏感信息直接写死代码存在安全风险。
解决方案使用.env文件存储环境变量COZE_API_TOKENxxx通过dotenv加载配置load_dotenv()代码中通过os.environ.get()获取避免硬编码
用户体验与容错平衡AI 响应存在延迟若直接等待会导致用户体验下降。
解决方案前端禁用操作按钮并显示加载状态明确告知用户处理中后端设置合理的超时时间30 秒兼顾响应速度和成功率AI 服务异常时自动切换到本地成语列表保证游戏不中断
系统优化与扩展方向
现有优化点性能优化历史记录限制最多 20 条减少数据传输量资源复用全局唯一的IdiomGame实例避免重复初始化 AI 客户端错误处理全局异常处理器统一返回 JSON 格式错误信息
扩展方向1功能扩展成语验证增加成语合法性校验接入成语词典 API难度分级根据用户水平调整 AI 接龙难度如生僻成语 / 常用成语计分系统记录接龙成功次数增加游戏竞技性多语言支持适配繁体中文面向海外用户2技术优化缓存机制缓存 AI 生成的成语列表减少 API 调用次数异步处理使用 Flask-Async 扩展将 AI 请求改为异步任务提升并发能力前端框架重构使用 Vue/React 重构前端提升代码可维护性部署优化使用 Docker 容器化部署支持多环境一键部署
项目
总结与思考
技术价值这个小项目展示了 AI 技术与传统应用结合的可能性轻量化 AI 集成无需复杂的模型部署通过 API 即可快速接入 AI 能力容错设计的重要性任何依赖外部服务的应用都需要做好降级策略前后端分离的简化实现原生技术栈也能打造流畅的交互体验
产品思考从产品角度这个游戏的
核心价值在于 “轻量化” 和 “趣味性”无需下载安装网页端直接体验AI 接龙替代人工随时随地可玩传统文化与现代技术结合兼具教育意义和娱乐性
开发感悟小项目也需要注重架构设计模块化封装让代码更易维护容错机制是生产级应用的必备用户不会关心技术细节只在意是否可用快速迭代与验证先实现核心功能再逐步优化体验和扩展功能
快速上手指南
环境准备# 安装依赖 pip install flask flask-cors cozepy python-dotenv # 创建.env文件 COZE_API_TOKEN你的Coze API Token BOT_ID你的Coze Bot ID USER_ID自定义用户ID
启动服务python app.py
访问游戏打开浏览器访问http://localhost:5000即可开始游戏。
结语这个智能成语接龙游戏看似简单却涵盖了前后端交互、AI 集成、容错设计、用户体验优化等多个开发维度。
在实际开发中我们不需要一开始就追求完美而是先实现核心功能再通过持续优化提升系统的稳定性和用户体验。
AI 技术的普及让小型应用也能具备智能能力关键在于找到合适的应用场景并用简洁的技术方案解决核心问题。
希望本文的拆解能为你带来启发也欢迎你基于这个项目继续扩展打造更有趣的 AI 应用。