基于华为开发者空间-云开发环境（容器）+MaaS实现英语情景学习助手-优快云博客

一、概述

1. 案例介绍

华为开发者空间，是为全球开发者打造的专属开发者空间，致力于为每位开发者提供一台云主机、一套开发工具和云上存储空间，汇聚昇腾、鸿蒙、鲲鹏、GaussDB、欧拉等华为各项根技术的开发工具资源，并提供配套案例指导开发者从开发编码到应用调测，基于华为根技术生态高效便捷的知识学习、技术体验、应用创新。

本项目是华为开发者空间开发平台 - 云开发环境（容器）部署的AI智能对话助手技术实践案例。该应用深度集成华为云MaaS（ModelArts as a Service）平台提供的DeepSeek-V3大语言模型，充分利用平台提供的百万级商用token处理能力，构建了一个英语情景学习助手，其包含智能对话、语法纠错、词汇学习、情景对话等场景，旨在通过AI技术为学习者提供一个沉浸式、个性化的英语练习环境。

华为MaaS平台不仅提供高质量的DeepSeek-V3模型，更具备百万token的超长上下文处理能力，使得本应用能够支持复杂的多轮对话场景和长文档分析任务。前端采用Gradio框架构建响应式聊天界面，后端通过封装MaaS平台API，为用户提供流畅的智能对话体验。

2. 适用对象

企业
个人开发者
高校学生

3. 案例时间

本案例总时长预计90分钟。

4. 案例流程

说明：

登录华为开发者空间，VS Code安装Huawei Developer Space插件，远程连接操作云开发环境；
远程创建、开机、连接云开发环境（容器）；
领取百万token代金券福利，开通商用模型服务，获取模型API 地址、API Key等参数；
GitCode拉取智语灵犀 - AI对话助手代码，安装依赖，修改配置参数API Key；
启动程序，在浏览器端测试验证AI英语学习助手。

5. 资源总览

本案例预计花费0元。

资源名称	规格	单价（元）	时长（分钟）
华为开发者空间开发平台 - 云开发环境（容器）	鲲鹏通用计算增强型 kc1 \| 2vCPUs \| 4G \| HCE	免费	90

二、基础环境与资源准备

1. VS Code远程连接云开发环境容器

参考案例《华为开发者空间 - 云开发环境（容器）IDE插件远程连接操作指导》中的“二、云开发环境IDE插件远程连接操作指导”的内容，完成“1. 安装插件” ~ “4. 连接”章节步骤。

完成连接之后的状态：

2. 领取百万免费token福利

参考案例《Versatile Agent中自定义接入大模型配置华为云Maas指导》中的“一、领取”章节内容，领取华为开发者空间百万token代金券福利，购买ModelArts Studio DeepSeek-V3 轻量体验包（¥3.50）。开通商用模型服务，最后获取API地址、API Key的参数值。

三、AI 英语学习助手

1.AI 英语学习助手功能介绍

AI英语学习助手是一个基于Flask后端框架和Bootstrap 5与JavaScript前端框架、技术开发的智能英语学习Web应用。结合华为云MaaS平台百万免费商用token，配置DeepSeek-V3大模型，为用户提供个性化、互动性强的英语学习体验。

1.1 项目结构

english_ai_tutor/
        ├── app.py                    # Flask主应用，路由管理
        ├── config.py                 # 配置管理
        ├── simple_maas_client.py     # AI客户端封装
        ├── .env                      # 环境配置
        ├── requirements.txt          # 依赖列表
        ├── templates/                # 前端模板
        │   ├── base.html             # 基础模板
        │   ├── index.html            # 首页
        │   ├── chat.html             # 智能对话
        │   ├── grammar.html          # 语法纠错
        │   ├── vocabulary.html       # 词汇学习
        │   └── conversation.html     # 情景对话
        └── static/                   # 静态资源
            └── css/
                └── style.css

1.2 功能介绍

1.2.1 智能对话

功能描述：与AI英语老师进行实时英语对话练习。

特色:

个性化英语对话练习；
实时语法纠正和反馈；
根据用户水平调整对话难度；
保持对话历史，支持连续对话。

使用场景：日常英语口语练习、自由话题英语交流、英语思维训练。

1.2.2 语法纠错

功能描述：智能检查英语句子语法错误并提供详细解释。

特色：

实时语法错误检测；
详细的错误解释；
改进建议和学习提示；
支持复杂句子分析。

使用场景：

英语写作练习
语法学习巩固
句子结构优化

1.2.3 词汇学习

功能描述：深入查询英语单词的详细解释和用法。

特色：

全面的单词解释；
发音和音标信息；
常用搭配和例句；
同义词和反义词。

使用场景：新单词学习、词汇扩展、单词用法掌握。

1.2.4 情景对话

功能描述：模拟真实生活场景的英语对话练习。

支持场景：餐厅点餐、机场问路、酒店入住、商场购物、工作面试、日常聊天。

特色：

真实场景模拟；
角色扮演互动；
实用对话技巧；
场景化学习体验；

2. 项目部署

2.1 获取项目源码

完成VS Code远程连接云开发环境后，点击Source Control图标，然后点Initialize Repository。

点CHANGES右侧的 ··· 图标，在下拉菜单中选择Clone。

输入代码仓地址，Clone from URL：https://gitcode.com/sinat_41661654/english_ai_tutor.git

选择代码仓目录：/workspace/python/，点Select as Repository Destination。

然后点Open，将此目录设置为本地代码仓。

加载结束后的状态如下：

2.2 安装项目依赖

打开VS Code命令行窗口，创建并激活虚拟环境

python -m venv venv
source venv/bin/activate

安装项目依赖

pip3 install -r requirements.txt

2.3 修改配置文件，配置API Key

打开配置文件.env，修改配置参数。将配置文件中的MAAS_API_KEY、BASE_UR替换为“二、基础环境与资源准备”章中的“3. 领取百万免费福利”节获取到的API地址、API Key。

# API配置
MAAS_API_KEY=MaaS平台获取的API Key
BASE_URL=MaaS平台获得的API地址   # 注意删除其尾缀/chat/completions
MODEL=DeepSeek-V3
SECRET_KEY=3MQfRPAosQfB5uggO  # 一串随机数字

3. 测试AI 英语学习助手

3.1 启动项目

在VS Code终端窗口中运行如下命令，启动智语灵犀 - AI对话助手。

python app.py

在VS Code弹出的对话框中点Open in Browser，或者直接在浏览器中打开：http://127.0.0.1:5000/。

3.2 测试智能对话

点AI英语学习助手首页的智能对话 > 开始对话，在对话框中输入“hello”，就可以开始与AI英语学习助手练习英语对话了。

3.3 测试语法纠错

点右上角菜单中的语法纠错。在对话框中输入：“Today，It’s sunny，I‘m pretty good。”，点检查语法。AI英语学习助手给出分析与正确句式。

3.4 测试词汇学习

点右上角菜单中的词汇学习。在对话框中输入错误拼写的单词：“namber”，点查询单词。AI英语学习助手修正并给出解答。

3.5 测试情景对话

点右上角菜单中的情景对话。对话场景选择机场问路，在对话框中输入：“Do you know how to get to the check-in counter at Gate 22”，点发送。AI英语学习助手做出回应。

至此，基于华为开发者空间-云开发环境（容器）+MaaS实现英语情景学习助手案例结束，各位开发者快来华为开发者空间体验吧。