艾莉丝努力练剑头像
【AI大模型接入SDK】前端页面生成封面图

【AI大模型接入SDK】前端页面生成


头像


🎬 个人主页:艾莉丝努力练剑

❄专栏传送门:《C语言》《数据结构与算法》《C/C++干货分享&学习过程记录》
《Linux操作系统编程详解》《笔试/面试常见算法:从基础到进阶》《Python干货分享》

⭐️为天地立心,为生民立命,为往圣继绝学,为万世开太平

🎬 艾莉丝的简介:

在这里插入图片描述



在这里插入图片描述


1 ~> AI 聊天助手前端页面自动生成

1.1 整体业务流程

1.1.1 大模型辅助前端生成工作流

  • 准备需求文档:Chat 前端页面需求说明.txt
  • 模型提示词构造:指定业务背景、约束条件、部署路径、后端服务器信息
我实现了一个智能聊天助手的应用,后端代码经过了严格的测试,请你仔细阅读Chat前端页面需求说明文档,严格按照要求帮我生成一份前端页面,生成好之后,将页面放置在ChatServer/build/www的目录下。
注意在生产的过程中,禁止修改我的后端代码
服务器地址:192.168.100.238 端口:8080
  • 调用模型 @Builder,传入需求文档上下文,交由 AI 完成前端工程代码输出
  • 前置环境准备
    1. 后端服务预先启动
    2. 访问境外大模型则提前配置代理
    3. 确认输出目录ChatServer/build/www存在
  • AI 输出产物:拆分 HTML、CSS、JS 三份独立文件,完成页面业务编码
  • 验证:浏览器访问 http://192.168.100.238:8080 进行全功能接口联调测试

1.1.2 效率对比

  • 传统人工前端开发:前端工程师需要 2‑3 工作日
  • AI 模型自动生成:5‑6 分钟完成基础完整页面工程

1.2 前端工程输出产物

1.2.1 文件目录:ChatServer/build/www/

  • index.html:主页面结构,页面 DOM、弹窗、布局骨架
  • styles.css:全局样式文件,实现现代化 UI 效果
  • script.js:业务逻辑脚本,接口请求、页面交互、SSE 流式处理

1.2.2 UI 页面结构实现

1.2.2.1 页面布局
  • 顶部导航栏:应用图标 + 新建对话按钮
  • 左侧侧边栏:会话列表区域
    • 展示会话创建时间、会话首条消息、模型名称、会话删除按钮
  • 右侧主聊天区域
    • 默认欢迎占位界面;选中会话后切换聊天视图
  • 弹窗组件:模型选择弹窗,网格布局,单选模型,确认 / 取消按钮
  • 加载指示器、全局错误提示组件
1.2.2.2 用户体验特性
  • 流式消息渲染:SSE 协议解析,Markdown 渲染、代码语法高亮
  • 消息气泡布局:用户消息居右,AI 回复居左,每条消息附带时间戳
  • 输入框交互
    • Enter 键发送消息;Shift+Enter 实现文本框内换行
    • 输入字符计数
  • AI 消息支持一键复制功能
  • 响应式布局,兼容多屏幕尺寸
  • UI 视觉:渐变背景、毛玻璃效果、卡片阴影、交互动画

1.3 后端 API 接口清单(前端对接)

服务器基准地址:http://192.168.100.238:8080

1.3.1 会话管理接口

  • GET /api/sessions:获取全部会话列表
  • POST /api/session:创建新会话
  • DELETE /api/session/{sessionid}:删除指定会话
  • GET /api/session/{session_id}/history:获取指定会话历史消息记录

1.3.2 模型与消息接口

  • GET /api/models:获取后端支持的全部大模型列表
  • POST /api/message/async:发送用户消息,SSE 流式异步返回 AI 输出内容

1.4 功能联调测试结果与缺陷记录

1.4.1 验证通过接口

  1. 获取会话列表接口:正常拉取会话数据渲染侧边栏
  2. 获取模型列表接口:正常拉取模型元数据,弹窗展示模型选项
  3. 创建会话接口:点击新建对话 + 选择模型,后端生成会话,前端会话列表自动更新
  4. 获取会话历史接口:切换历史会话,正确加载历史聊天消息
  5. 删除会话接口
    • 前端弹出确认提示框做容错校验
    • 请求下发后端,数据库 session 表会话记录删除
    • 前端会话列表同步移除对应条目,刷新浏览器状态保持一致

1.4.2 现存待修复缺陷

  • 消息时间戳格式化异常:聊天消息展示的时间显示错误,需要迭代修改前端时间格式化逻辑
  • 流式消息接口未完成测试:SSE 异步流式响应业务逻辑复杂,尚未开展验证

1.4.3 后端数据存储校验手段

  • 数据库两张核心业务表
    • session表:存储会话元信息;测试删除会话后可直接查询该表确认记录物理 / 逻辑删除
    • message表:存储每一条会话内的聊天消息记录

1.5 完整操作步骤总结

  1. 启动 ChatServer 后端服务;需要境外模型访问则开启代理
  2. 确认输出目录ChatServer/build/www已存在
  3. 向 AI 模型传入提示词 + 需求文档,自动生成 index.html、styles.css、script.js
  4. 浏览器访问 http://192.168.100.238:8080
  5. 逐项测试会话、模型、历史、删除业务;数据库校验数据状态
  6. 定位缺陷:修复时间格式化逻辑,后续完成流式消息接口测试

2 ~> AI 聊天助手自动生成页面具备的功能

2.1 页面 UI 与布局功能

2.1.1 整体页面布局

  • 三部分结构:顶部导航栏、左侧会话列表栏、右侧聊天主区域。
  • 顶部:AI 聊天助手图标 +「新建对话」按钮。
  • 左侧会话列表:展示会话时间、会话第一条消息、使用的模型名称、会话删除按钮。
  • 右侧聊天区:默认展示欢迎引导界面,选中会话切换聊天界面。

2.1.2 模型选择弹窗

  • 网格布局展示后端返回全部可用模型;支持单选模型;提供取消、确定按钮。

2.1.3 通用 UI 体验

  • 现代化渐变背景、毛玻璃效果、卡片阴影、交互动画。
  • 加载指示器、错误提示弹窗;响应式设计,适配不同屏幕尺寸。

2.2 后端 API 对接业务功能

2.2.1 会话管理

  • 获取会话列表:GET /api/sessions,加载渲染左侧会话列表。
  • 创建新会话:POST /api/session,新建对话 + 选择模型后创建会话。
  • 获取会话历史记录:GET /api/session/{session_id}/history,点击历史会话加载过往聊天消息。
  • 删除会话:DELETE /api/session/{sessionid},删除前弹出确认提示框,删除后更新页面会话列表。

2.2.2 模型能力

  • 获取可用模型列表:GET /api/models,弹窗展示全部模型信息。

2.2.3 消息交互

  • 发送消息流式响应:POST /api/message/async,基于 SSE 协议接收流式输出。

2.3 聊天消息用户体验功能

2.3.1 消息渲染

  • 气泡区分:用户消息居右,AI 消息居左,每条消息附带时间戳(存在格式化 bug)。
  • 支持 Markdown 渲染、代码语法高亮。

2.3.2 输入框操作

  • Enter发送消息;Shift + Enter输入框内换行。
  • 输入字符计数。

2.3.3 辅助操作

  • AI 回复消息支持一键复制内容。

2.4 已知未完善点

  1. 消息时间戳格式化异常,展示时间错误,需要修改前端代码修复。
  2. SSE 流式消息发送接口仅代码实现,视频环境下没有做实际测试验证。

3 ~> Web页面响应式设计实现(AI聊天助手项目实例)

3.1 响应式设计基础定义

3.1.1 核心目标

  • 在不同物理尺寸设备(桌面显示器、笔记本、平板、移动手机)下,页面布局、组件、字体自动适配视口。
  • 保证不同设备上功能完整、布局可用,避免横向滚动、内容溢出、组件遮挡问题。
  • 本项目业务场景:左侧会话侧边栏 + 右侧聊天主区域的双栏聊天界面。

3.1.2 响应式与自适应的概念区分

  • 响应式(Responsive):单套HTML源码,依靠CSS能力完成多设备适配,本项目采用该方案。
  • 自适应(Adaptive):维护多套独立页面,服务端根据客户端设备标识跳转至对应页面版本。

3.2 响应式核心技术栈

3.2.1 viewport视口元标签(移动端必备基础)

  • 作用:告知移动浏览器使用设备物理视口宽度渲染文档,禁用浏览器默认缩放逻辑。
  • 必须放置于index.html文档的<head>标签内部。
<!-- index.html head内部视口配置 -->
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
  • width=device-width:页面布局宽度跟随设备视口宽度。
  • initial-scale=1.0:页面初始缩放倍率为1。
  • maximum-scale=1.0:限制最大缩放比例。
  • user-scalable=no:禁止用户双指缩放页面,适用于WebSPA聊天应用。

3.2.2 CSS弹性布局 Flexbox

  • 业务定位:本聊天页面主要布局方案,用于实现侧边栏‑主内容分栏。
  • 关键属性说明
    • display:flex:开启弹性容器。
    • flex-shrink:0:固定宽度侧边栏,禁止被容器挤压收缩。
    • flex:1:聊天主区域自动占满容器剩余全部可用空间。
/* PC端基础双栏布局 */
.container {
    display: flex;
    height: 100vh;
}
.sidebar {
    width: 280px;
    flex-shrink: 0;
}
.chat-main {
    flex: 1;
    overflow: auto;
}

3.2.3 Media Query 媒体查询

  • 作用:根据视口断点条件,重写CSS规则,实现不同屏幕尺寸切换布局形态。
  • 本项目业务断点:768px;大于等于768px为PC大屏;小于768px为平板/移动小屏。
/* >=768px PC大屏:永久展示左右双栏布局 */
@media (min-width: 768px) {
    .container {
        display: flex;
    }
    .sidebar {
        position: static;
        width: 280px;
    }
}

/* <768px 移动端:侧边栏改为悬浮抽屉 */
@media (max-width: 767px) {
    .container {
        display: block;
    }
    /* 抽屉默认移出视口不可见 */
    .sidebar {
        position: fixed;
        top: 0;
        left: -280px;
        width: 280px;
        height: 100vh;
        transition: left 0.3s ease;
        z-index: 100;
    }
    /* 通过class控制抽屉滑入显示 */
    .sidebar.show {
        left: 0;
    }
    .chat-main {
        width: 100vw;
        height: 100vh;
    }
    /* 弹窗做视口边界保护 */
    .model-modal {
        width: 600px;
        max-width: 90vw;
    }
}

3.2.4 CSS相对单位体系

  • 规避全部使用固定px带来的适配缺陷,优先采用相对单位。
    • rem:基于根元素字体大小,用于字体尺寸适配。
    • vh / vw:视口高度、视口宽度百分比,用于页面整体高度、弹窗约束。
    • %:基于父容器尺寸百分比。
  • 长文本溢出防护,防止消息内容撑开容器:
.message-item {
    word-break: break-all;
    overflow-wrap: break-word;
}

3.2.5 JavaScript辅助响应逻辑

  • CSS仅处理样式;窗口动态变化、抽屉开关状态需要JavaScript补充业务逻辑。
// 监听浏览器视口尺寸变化事件
window.addEventListener('resize', () => {
    const innerW = window.innerWidth;
    if (innerW < 768) {
        // 小屏设备业务逻辑
    } else {
        // 大屏设备,强制关闭抽屉
        document.querySelector('.sidebar').classList.remove('show');
    }
})

3.3 AI自动生成聊天页面现有响应式能力

3.3.1 已实现特性

  • 引入Flex弹性盒作为页面基础布局模型。
  • 使用max-width约束弹窗组件,避免弹窗超出视口边界。
  • 基础多屏幕尺寸布局兼容。
  • 消息文本开启自动换行处理,防止长文本溢出。

3.3.2 缺失待补充特性

  • 未实现移动端侧边栏抽屉交互逻辑,小屏幕下边栏会造成布局错乱。
  • 需手动补充媒体查询抽屉样式、汉堡菜单DOM节点、JS抽屉开关逻辑,才可完整支持移动端。

3.4 响应式验证测试规范

3.4.1 测试手段

  • 使用浏览器开发者工具设备模拟器,模拟多分辨率平板、手机视口。

3.4.2 校验检查项

  • 页面不存在横向滚动条。
  • 按钮、输入框、弹窗组件不会超出视口边界。
  • 聊天消息完整渲染,长文本自动换行。
  • 布局切换断点下交互功能全部可用。

结尾

uu们,本文的内容到这里就全部结束了,艾莉丝在这里再次感谢您的阅读!

艾莉丝努力练剑

C/C++ & Linux 底层探索者 | 一个正在努力练剑的技术博主


👀 【关注】 跟随我一起深耕技术领域,见证每一次成长。
❤️ 【点赞】 让优质内容被更多人看见,让知识传递更有力量。
⭐ 【收藏】 把核心知识点存好,在需要时随时查、随时用。
💬 【评论】 分享你的经验或疑问,评论区一起交流避坑!

不要忘记给博主“一键四连”哦!

“今日练剑达成!”
文章配图

“技术之路难免有困惑,但同行的人会让前进更有方向。”

结语:希望对学习Linux相关内容的uu有所帮助,不要忘记给博主“一键四连”哦!

往期回顾:

【AI大模型接入SDK】前端页面提示词

🗡博主在这里放了一只小狗,大家看完了摸摸小狗放松一下吧!🗡
૮₍ ˶ ˊ ᴥ ˋ˶₎ა

在这里插入图片描述

转载自 CSDN-专业IT技术社区

原文链接:https://blog.csdn.net/2401_89899187/article/details/170231428

文章来源转载

评论

评论列表

微信小程序
QQ小程序

关于作者

点赞数:0
关注数:0
粉丝:0
文章:0
关注标签:0
加入于:--