头图

2025跨平台flutter实战ai对话,基于flutter3.27+dart3.6+get+dio+markdown集成deepseek实战流式输出对话模板。支持markdown流解析、代码高亮、图片/链接/表格、对话本地存储等功能。

uni-app+deepseek+vue3跨多端【小程序+H5+App端】流式输出AI聊天
vue3.5接入deepseek-chat网页版ai流式聊天会话系统
基于vue3.5+deepseek-chat搭建mobile版流式打字ai聊天会话助手

附上一个演示视频
https://www.bilibili.com/video/BV1Ndj3zYEnH/?aid=114568990954...

运用技术

  • 技术框架:flutter3.27.1+dart3.6.0
  • ai模型:deepseek-v3
  • 网络请求:dio^5.8.0+1
  • 路由/状态管理:get^4.7.2
  • 本地存储:get_storage^2.1.1
  • markdown解析:flutter_markdown^0.7.7
  • 高亮插件:flutter_highlight^0.7.0
  • 弹框组件:shirne_dialog^4.8.3
  • 图片预览:easy_image_viewer^1.5.1
  • 环境变量插件:flutter_dotenv^5.2.1

功能特性

  1. 基于Flutter3.27搭建项目,接入DeepSeek-V3,对话更丝滑
  2. 支持手机端/桌面端显示
  3. 支持代码块高亮、多轮上下文会话、本地存储对话
  4. 支持代码块横向滚动、代码复制
  5. 支持图片宽度100%渲染、在线图片预览功能
  6. 支持链接跳转
  7. 支持表格显示功能

项目框架目录

flutter3-deepseek流式ai项目已经更新到我的原创作品集。
Flutter3+DeepSeek-V3跨平台AI流式输出聊天模板

入口main.dart配置

import 'dart:io';
import 'package:flutter/material.dart';
import 'package:get/get.dart';
import 'package:get_storage/get_storage.dart';
import 'package:shirne_dialog/shirne_dialog.dart';
import 'package:flutter_dotenv/flutter_dotenv.dart';

import 'controller/app.dart';
import 'controller/chat.dart';

// 引入路由配置
import 'router/index.dart';

void main() async {
  // 初始化存储服务
  await GetStorage.init();

  // 将.env文件内容加载到dotenv中
  await dotenv.load(fileName: '.env');

  // 注册GetxController
  Get.put(AppStore());
  Get.put(ChatStore());

  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    // 获取AppStore实例
    final appStore = AppStore.to;
    
    return GetMaterialApp(
      title: 'Flutter3 DeepSeek',
      debugShowCheckedModeBanner: false,
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Color(0xFF4F6BFE)),
        useMaterial3: true,
        fontFamily: Platform.isWindows ? 'Microsoft YaHei' : null,
      ),
      // 初始路由
      initialRoute: appStore.isLogin ? '/' : '/login',
      // 路由页面
      getPages: routePages,
      navigatorKey: MyDialog.navigatorKey,
      localizationsDelegates: [
        ShirneDialogLocalizations.delegate,
      ],
    );
  }
}

flutter3配置环境变量.env

在项目根目录新建一个.env文件。
27f665416a19713ca22a40186280af2c_1289798-20250524090516038-1427204845.png

去deepseek申请一个API key替换掉.env文件里面的key 就能体验流式对话功能。

# 项目名称
APP_NAME = 'Flutter3-DeepSeek'

# DeepSeek API配置
DEEPSEEK_API_KEY = your apikey
DEEPSEEK_BASE_URL = https://api.deepseek.com

flutter中配置环境变量,使用的flutter_dotenv^5.2.1插件。

void main() async {
  // ...

  // 将.env文件内容加载到dotenv中
  await dotenv.load(fileName: '.env');

  runApp(const MyApp());
}

在页面上获取配置变量。

// 获取.env环境变量baseUrl和apiKey
String baseURL = dotenv.get('DEEPSEEK_BASE_URL');
String apiKEY = dotenv.get('DEEPSEEK_API_KEY');

如果运行到桌面windows端,则以750px宽度展示布局。

emmmmm,做的还不错吧,哈哈~~

项目布局模板

07d571759835d82eb608b6ef958c57f9_1289798-20250524092637499-691060066.png

@override
Widget build(BuildContext context) {
  return Scaffold(
    key: scaffoldKey,
    backgroundColor: Colors.white,
    appBar: AppBar(
      ...
      actions: [
        IconButton(icon: Icon(Icons.try_sms_star_outlined), onPressed: () => handleCreate(),),
      ],
    ),
    body: Center(
      child: ConstrainedBox(
        constraints: BoxConstraints(
          maxWidth: 750.0,
        ),
        child: Flex(
          direction: Axis.vertical,
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Expanded(
              child: Stack(
                children: [
                  GestureDetector(
                    child: ScrollConfiguration(
                      behavior: CustomScrollBehavior().copyWith(scrollbars: false),
                      // GetBuilder响应流式输出
                      child: Obx(() {
                        if (chatStore.currentMessages.isEmpty) {
                          // 欢迎信息
                          return Welcome(
                            onChanged: (value) {
                              textEditingController.text = value;
                            },
                          );
                        }
                        return ListView.builder(
                          keyboardDismissBehavior: ScrollViewKeyboardDismissBehavior.onDrag, // 当滚动时候隐藏键盘
                          controller: scrollController,
                          padding: EdgeInsets.all(10.0),
                          reverse: true,
                          shrinkWrap: true,
                          itemCount: chatStore.currentMessages.length,
                          itemBuilder: (context, index) {
                            ...
                          }
                        );
                      }),
                    ),
                    onTap: () {
                      focusNode.unfocus();
                    },
                  ),
                  // 滚动到底部
                  AnimatedPositioned(
                    ...
                  ),
                ],
              ),
            ),
            // 底部编辑器区域
            ChatEditor(controller: textEditingController),
          ]
        ),
      ),
    ),
    // 侧边栏
    drawer: Drawer(
      child: Sidebar(),
    ),
  );
}

flutter3-deepseek路由配置

import 'package:flutter/material.dart';
import 'package:get/get.dart';

import '../controller/app.dart';

/* 引入路由页面 */
import '../pages/auth/login.dart';
import '../pages/auth/register.dart';
import '../pages/index/index.dart';
import '../pages/aihub/index.dart';
import '../pages/setting/index.dart';

// 路由地址集合
final Map<String, Widget> routes = {
  '/': Home(),
  '/aihub': Aihub(),
  '/setting': Setting(),
};

final List<GetPage> routeList = routes.entries.map((e) => GetPage(
  name: e.key, // 路由名称
  page: () => e.value, // 路由页面
  transition: Transition.rightToLeftWithFade, // 跳转路由动画
  middlewares: [RouteMiddleware()], // 路由中间件
)).toList();

final List<GetPage> routePages = [
  GetPage(name: '/login', page: () => const Login()),
  GetPage(name: '/register', page: () => const Register()),
  ...routeList,
];

// 路由中间件拦截验证
class RouteMiddleware extends GetMiddleware {
  final appStore = AppStore.to;

  @override
  RouteSettings? redirect(String? route) {
    return appStore.isLogin ? null : const RouteSettings(name: '/login');
  }
}

flutter3封装markdown解析

采用 flutter_markdown 组件来解析markdown语法结构。 flutter_highlight 组件来高亮代码块。

5b8373aa91d43961f59042511664bcf7_1289798-20250524094230511-841161850.png

特性

  1. 支持代码块横向滚动
  2. 支持代码块、行内代码高亮
  3. 支持代码块复制功能
  4. 支持表格渲染功能
  5. 支持网络图片100%宽度渲染及预览
  6. 支持网络链接跳转功能
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:get/get.dart';
import 'package:flutter_markdown/flutter_markdown.dart';
import 'package:flutter_highlight/flutter_highlight.dart';
import 'package:flutter_highlight/themes/github.dart';
import 'package:url_launcher/url_launcher.dart';
import 'package:easy_image_viewer/easy_image_viewer.dart';
import 'package:markdown/markdown.dart' as md;

class FMarkdown extends StatefulWidget {
  const FMarkdown({
    super.key,
    required this.data,
  });

  final String data;

  @override
  State<FMarkdown> createState() => _FMarkdownState();
}

class _FMarkdownState extends State<FMarkdown> {
  @override
  Widget build(BuildContext context) {
    return MarkdownBody(
      data: widget.data,
      fitContent: false,
      styleSheet: MarkdownStyleSheet(
        blockSpacing: 12.0,
        // 表格
        tableBorder: TableBorder.all(color: Colors.black12),
        // 水平线
        horizontalRuleDecoration: BoxDecoration(
          border: Border(top: BorderSide(color: Colors.black12, width: 1.0)),
        ),
        // 代码块
        codeblockDecoration: BoxDecoration(
          color: Color(0xfff8f8f8),
          borderRadius: BorderRadius.circular(10.0),
        ),
        // 引用
        blockquotePadding: EdgeInsets.only(left: 16.0, top: 8.0, bottom: 8.0),
        blockquoteDecoration: BoxDecoration(
          border: Border(left: BorderSide(color: Colors.black12, width: 4.0)),
        )
      ),
      builders: {
        // 自定义代码/代码块构建
        'code': CustomCodeBuilder(),
      },
      // 自定义图片构建
      sizedImageBuilder: (config) => ImageBuilderWidget(config: config),
      // 点击链接
      onTapLink: (text, href, title) async {
        if (href != null) {
          if(await canLaunchUrl(Uri.parse(href))) {
            await launchUrl(Uri.parse(href));
          }else {
            debugPrint('无法访问 $href');
          }
        }
      },
    );
  }
}

flutter3+dio对接deepseek api流式输出

final response = await dio.post(
  '$baseURL/v1/chat/completions',
  options: Options(
    // 响应超时
    receiveTimeout: const Duration(seconds: 60),
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer $apiKEY",
    },
    // 设置响应类型为流式响应
    responseType: ResponseType.stream,
  ),
  data: {
    // 多轮会话
    'messages': widget.multiConversation ? chatStore.historySession : [{'role': 'user', 'content': editorValue}],
    'model': 'deepseek-chat', // deepseek-chat对话模型 deepseek-reasoner推理模型
    'stream': true, // 流式输出
    'max_tokens': 8192, // 限制一次请求中模型生成 completion 的最大 token 数(默认使用 4096)
    'temperature': 0.4, // 严谨采样 越低越严谨(默认1)
  }
);

好了,以上就是flutter3对接deepseek api实现跨平台流式ai的一些分享知识。开发不易,感谢大家的阅读与支持!

往期热文

基于 DeepSeek + Uniapp 跨多端AI流式对话【app演示版】
原创electron35+deepseek-v3+arco搭建桌面端AI流式输出对话助手
vue3.5+deepseek-chat网页版ai流式聊天会话系统
基于Flutter3.27实战2025抖音app直播商城+短视频+聊天
tauri2.0+vite6客户端仿MacOS桌面|tauri2+rust+vue3桌面os后台
tauri2.0+vue3桌面端后台Exe系统|tauri2+rust+vite5管理系统后台模板
基于uniapp+vue3+uv-ui聊天实例|uni-app+vite4仿微信app应用
Electron32-MacOS:基于vue3+electron32+arcoDesign仿win/mac桌面os模板
原创electron31+vue3+elementPlus仿微信客户端聊天Exe实例
基于electron31+vue3+pinia2桌面端后台管理模板


xiaoyan2017
779 声望332 粉丝

web前端开发爱好者,专注于前端h5、jquery、vue、react、angular等技术研发实战项目案例。