#在诸多企业机构中桌面应用仍然承担着关键业务流程。这两年很多客户都在问同一件事“能不能在我们这套桌面系统里也加一个 AI 助手”技术上其实并不难。Web 框架通常能轻松构建聊天界面。但是真正落地时会撞上一个问题如果让用户跳出主窗口去外部浏览器对话- AI 助手的价值大打折扣。这是一份技术案例分享介绍了我们如何把一个基于 DeepSeek V4 的 Web 聊天界面嵌入到已有的 Java Swing 桌面应用里并通过 Fuzio 让它直接运行在桌面应用窗口内部。需求我们从一个已有的 Swing 应用开始。它有标准的内部业务系统结构左侧导航树、中央多 Tab 工作区、表单、表格。本次开发任务是在不重写应用的前提下加上 AI 助手。项目需满足两项约束条件助手必须嵌于应用窗口内。用户无需切换到浏览器标签页或外部窗口。从应用任意位置一键唤起。不能要求用户先点几下菜单。理论上我们可以借助 Web 框架开发聊天界面但启动独立浏览器的操作会完全违背 “集成式 AI” 的设计初衷。架构整体方案有三层一个 Web 应用承担聊天界面一个 Swing 层管理浮层中间靠 Web 视图组件把两者连起来。聊天应用聊天界面以常规 Web 应用的形式构建采用 JavaScript 前端框架 Vue 开发用户界面并通过DeepSeek V4实现 AI 聊天功能。DeepSeek 的 Chat Completions 接口完全兼容 OpenAI 协议对写过任何 ChatGPT 集成的人来说迁移成本基本为零后续想切到通义千问、智谱、Ollama 也只需要改一个 base URL。最关键的一点是聊天界面 Web 应用无需感知自身是否运行于桌面应用内——对它来说自己就是被加载在一个浏览器环境里。这种解耦让前端工程师可以使用标准 Web 开发工具独立完成聊天界面的开发与测试全程无需编写任何 Java 代码。Swing 应用为了不打扰已有的业务界面我们在既有 Swing 应用程序中 新增GlassPane组件来展示 AI 助手界面。一个覆盖在主窗口所有内容之上的透明面板。当用户点击 “Ask AI” 按钮时应用原有界面之上会弹出一个悬浮窗口该窗口内置浏览器组件专门用于加载聊天 Web 应用。GlassPane是一种可置于窗口最顶层的 Swing 组件既能拦截用户交互事件也能在已有界面内容之上进行绘图渲染。该悬浮窗口包含以下核心元素半透明背景用于淡化现有界面。居中浏览器视图用于显示聊天应用。点击卡片外的遮罩、或者按 Esc 键浮层淡出。用户点击按钮后悬浮窗口会以渐入动画形式弹出点击聊天窗口外的区域即可关闭该悬浮窗口。Web 视图层本方案通过 Fuzio 在 Swing 应用中提供嵌入式 Chromium 浏览器视图。具体涉及以下三个步骤为悬浮窗口创建一个浏览器实例。通过BrowserView包装一个 Chromium 视图将其作为子组件嵌入 GlassPane 容器中。当悬浮窗口弹出时加载对应的聊天 Web 应用。设置 JavaScript - Java 桥接器。Fuzio 内置了 JavaScript 与 Java 的直接通信桥允许 Web UI 直接调用 Java 方法。在本方案中前端通过该桥向 Java 索取每次请求所需的 API Key从而让密钥留在 Java 一侧。集成 DeepSeekDeepSeek 是国内开源大模型团队“深度求索”推出的对话模型系列。本文使用的DeepSeek V4是它面向常规对话场景的最新版本——响应快、价格低、对中文语境理解到位。DeepSeek 的 API 与 OpenAI 协议兼容官方文档直接推荐复用 OpenAI 官方 SDK只需把baseURL指向https://api.deepseek.com、换上 DeepSeek 的 Key 与模型 ID 即可。集成 DeepSeek 涉及 JavaScript - Java 桥接器的基本用法。本文仅展示与本场景相关的最小用法详细使用规则请参阅 Fuzio 文档 · JavaScript。第一步声明可访问的 Java 类。Fuzio 通过JsAccessible注解标识“对 JavaScript 可访问”的类与方法。桥对象不发起任何网络请求只暴露 Key 管理与配置读取的方法JsAccessiblepublicfinalclassAiBridge{/** 返回原始 key sk-xxx未配置时返回 null。 */publicStringgetApiKey(){/* 获取Api Key */}/** 端点与模型放在 Java 端切换 DeepSeek / 智谱 / 自建网关时前端零改动。 */publicStringchatCompletionsBaseUrl(){/* OpenAI 兼容端点的 base URL */}publicStringmodelName(){/* 模型 ID */}}第二步注入桥对象。使用InjectJsCallback将后端对象注入到浏览器中browser.set(InjectJsCallback.class,params-{JsObjectwindowparams.frame().executeJavaScript(window);window.putProperty(fuzioAi,bridge);returnInjectJsCallback.Response.proceed();});该回调会在每个 frame 的 JavaScript 执行之前触发它将后端对象添加到window对象中使其可以在 JavaScript 中通过window.fuzioAi访问。第三步前端发起请求。前端从桥取出 base URL、模型与 API Key构造 OpenAI 客户端再以流式方式发起对话。importOpenAIfromopenai;constbridgewindow.fuzioAi;constclientnewOpenAI({baseURL:bridge.chatCompletionsBaseUrl(),// https://api.deepseek.comapiKey:bridge.getApiKey(),dangerouslyAllowBrowser:true,});conststreamawaitclient.chat.completions.create({model:bridge.modelName(),messages,stream:true},{signal},// 传入 AbortSignal 即可“停止生成”);关于dangerouslyAllowBrowser。OpenAI SDK 默认禁止在浏览器中运行以防 key 被打包进公开的前端代码而泄露。这里的桌面应用是 Fuzio 自有的渲染进程、key 也始终留在 Java 进程风险可控所以显式开启该选项。流式渲染请求体中stream设为true后DeepSeek 按 Server-Sent Events 协议返回响应。DeepSeek 的每个数据块都符合 OpenAI 兼容协议响应结构为{ choices: [{ delta: { ... } }] }。本文实现只需要累积其中的delta.content但理解完整的字段结构有助于后续扩展功能显示推理过程、统计 token 消耗等字段出现位置用途delta.role仅首个数据块标识消息发送方为assistantdelta.content中间数据块本次增量文本当前实现使用delta.reasoning_content思考模式下thinking.typeenabled默认开启推理过程的增量文本finish_reason末尾数据块stop表示正常结束length表示触发了 token 上限usage末尾数据块本轮 token 消耗明细读取响应体forawait(constchunkofstream){constdeltachunk.choices?.[0]?.delta?.content;if(delta)appendToAssistantBubble(delta);}每拿到一段delta.content就立即追加到当前的 assistant 气泡并触发重渲染由此呈现打字机式的流式输出效果。生产环境注意事项在最简配置下这就是核心的请求/响应调用流程。而在生产环境中您仍然需要加入错误处理、身份验证、重试机制或速率限制等功能。后续可扩展方向本文展示的是企业桌面应用集成 AI 的起点一个能够实时对话的内嵌助手。在此基础上可以沿以下方向继续演进方向关键技术企业知识库 AI 搜索RAG检索增强生成 向量数据库业务数据 AI 问答桥对象暴露业务查询方法 Function Calling智能体AgentFunction Calling 工具编排每一条路径都可在当前架构上零侵入扩展。信创平台支持如果你的桌面应用要进政府、金融、能源、运营商这些行业“信创合规”是个绕不开的门槛——常见要求是必须支持银河麒麟 V10、飞腾 ARM64、龙芯 LoongArch64 等。Fuzio 在配置文件里只需要声明对应平台依赖dependencies{implementation(fuzio.win64)// Windows x64implementation(fuzio.mac)// macOS Intelimplementation(fuzio.macArm)// macOS Apple Siliconimplementation(fuzio.linux64)// Linux x64覆盖麒麟/openKylinimplementation(fuzio.linuxArm)// Linux ARM64飞腾implementation(fuzio.linux64Loong)// Linux LoongArch64龙芯implementation(fuzio.swing)}结论为桌面应用程序添加 AI 功能看似需要攻克诸多复杂难题 —— 既要开发聊天界面、完成 AI 功能集成又要将其嵌入既有软件中同时避免对用户操作造成干扰。但在本案例中我们采用的解决方案简洁高效且能快速落地实施。以下三项关键决策是本方案具备可行性的核心原因最小化改造既有 Swing 应用。我们仅为应用新增了一个 GlassPane 悬浮窗口与浏览器容器原有界面的大部分代码均未改动无需进行大规模架构调整与高风险的代码重构。用 Fuzio 嵌入 Web 视图。它为 Swing 提供了嵌入式 Chromium 视图并构建了在桌面窗口内运行聊天界面的基础模块。用 DeepSeek 替代海外模型。最新的 DeepSeek V4 系列原生支持 100 万 token 超长上下文在中文理解、长文档处理与复杂推理上均处于一线水准API 已于 2026 年 5 月 22 日永久降价至原价的四分之一。本方案的应用场景不仅限于 AI 助手功能。实际上任何基于网页的功能模块 —— 例如数据仪表盘、产品文档、统计报表、数据可视化图表等都可通过这种方式嵌入桌面应用程序中。