XXL-AI v1.1.1 发布｜ Desk 桌面客户端正式上线，云本结合再进一步

Release Notes

[云版（ Web 服务端）]

1 、 [优化] 项目合并部署：研发环节前后端分离，部署期前端产物内嵌进后端 Jar ，单进程单端口对外；
2 、 [新增] I18N 模块重构：前后端国际化逻辑优化，统一后端控制；标准化国际化资源文件结构，支持多语言配置，并优化前端国际化加载逻辑；
3 、 [优化] 模型 API 请求通参调整，设置 User-Agent: XXL-AI 便于供应商识别；
4 、 [优化] 供应商模型请求参数属性优化，支持格式检测与合法性检测；
5 、 [升级] 项目依赖升级最新版本；

[本地版（ Desk 桌面端）]

本地版（ Desk 桌面端）以·与云版零依赖、独立构建发布；详细安装与操作见官方文档。

1 、 [重点] Desk/客户端上线：基于 Electron + Vue3 + TypeScript 构建跨平台桌面客户端，支持 mac / win / linux 一键安装及应用，本地优先、开箱即用；
2 、 [新增] 多供应商模型接入：兼容 OpenAI 协议，供应商 + 模型本地配置；首次启动自动预置 OpenCodeGo / Ollama / Deepseek / 智谱 GLM ；
3 、 [架构] Agent 运行时进程隔离：Pi （pi-ai + pi-agent-core）运行于独立 utilityProcess，主进程仅做 IPC 网关与越界审批，长会话与工具重活不阻塞 UI ；
4 、 [新增] Plan / Build 模式：Plan 只读（仅只读文件与检索工具）、Build 全量读写，随会话持久化，默认 Build ；文件操作限定当前项目目录，越界弹原生对话框「允许本次 / 本会话允许 / 拒绝」；
5 、 [新增] 流式对话与执行过程可视化：流式输出思考过程 / 工具调用 / 回复内容；助手消息按片段发生顺序渲染时间线（思考 → 工具 → 正文交错），思考折叠、工具调用状态与耗时展示、Markdown 实时渲染与代码高亮；
6 、 [新增] 项目与会话管理：项目绑定本地磁盘目录，会话归属项目，支持搜索 / 重命名 / 删除 / 排序；会话与消息落本地 SQLite 单文件，运行时数据目录可自定义；
7 、 [新增] 本地系统能力：终端命令行（ node-pty + xterm ）；侧边任务面板含文件（目录树 + 编辑保存 + 预览 + 跟随本地变更）与浏览器（多标签 webview）；
8 、 [新增] 个性化设置：应用名称 / Slogan / 自定义指令，浅色（默认）/ 深色主题，中 / 英双语；
9 、 [优化] 性能与体验：会话落库增量 + 单事务、运行时增量合批、渲染端按需滚动；生成中切换会话不丢内容；退出时回收运行时与终端进程。
10 、 [强化] Desk 命令运行环境（ Node/Python ）支持自定义 PATH 设置，提升本地环境兼容性； Node 默认使用内置版本，降低本地环境依赖；
11 、 [强化] Desk 终端 locale 显示设置 UTF-8 ，解决中文乱码问题；
12 、 [新增] 客户端支持自动检测新版本，并引导升级；

一、简介

XXL-AI 是一个「云本结合」的 AI Agent 开发平台，提供两种同源同品牌、能力互补的交付形态，可按团队规模与使用场景独立选用，也可组合使用：

云版：以 Agent 编排为中枢，标准化扩展「 MCP + SKILL + RAG 」，配套多供应商、空间隔离、RBAC 权限与流式对话等工程化底座，可快速构建并一键发布 Agent 。开源、开箱即用，支持集群部署与生产落地。

本地版：跨平台桌面客户端：面向个人的本地工作台，围绕本机项目目录提供对话、文件读写、终端命令、文件 / 浏览器侧边任务等能力；安装即用、离线可用，数据仅落本地 SQLite 。

项	云版（ Web 服务端）	本地版（ Desk 桌面端）
形态	B/S Web 应用，浏览器访问	C/S 桌面应用，一键安装（ mac / win / linux ）
面向	团队——多用户、多业务空间（ Tenant ）	个人——单用户本地工作台
定位	Agent 编排、一键发布、权限治理	本地优先，直接操作本机项目与系统能力
扩展	MCP + SKILL + RAG ，多供应商，流式对话	本地文件 / 终端 / 浏览器面板，Plan / Build 模式
模块	`xxl-ai-api` + `xxl-ai-ui`（+ `xxl-ai-sample`）	`xxl-ai-desk`
依赖	MySQL + Redis + Milvus	零依赖（仅本地 SQLite ）

二、文档地址

中文文档：https://www.xuxueli.com/xxl-ai/
Github 地址：https://github.com/xuxueli/xxl-ai

三、架构设计

XXL-AI 采用「云本结合」：云版（ Web / 服务端）与本地版（ Desk 桌面端）同源互补。整体自上而下分为入口、前端、应用、运行时、支撑、外部六层：

┌──────────────────────────────────────────────────────────────────────────────────────────────────────┐
    │ 入口层   管理端 admin （浏览器） · 公开端访客 /#/chat/{uuid} · Desk 桌面客户端（ mac / win / linux ）   │
    ├──────────────────────────────────────────────────────────────────────────────────────────────────────┤
    │ 前端层   云版   xxl-ai-ui —— Vue3 + Vite + Element Plus + TS ；开发 :3000 ，生产内嵌进 API （ Hash 路由）│
    │          本地版 Desk Renderer —— Vue3 + Element Plus ； contextBridge → window.desk.*                  │
    ├──────────────────────────────────────────────────────────────────────────────────────────────────────┤
    │ 应用层   云版   xxl-ai-api —— SpringBoot + MyBatis + XXL-SSO ，:8080                                  │
    │                  framework：登录鉴权 · RBAC 菜单/按钮 · 系统管理 · 审计日志                          │
    │                  business：空间 · 供应商 · 知识库 · MCP · SKILL · Agent · Chat                       │
    │          本地版 Desk Main —— IPC 网关 · SQLite(Drizzle) 持久化 · Agent 托管 · 越界审批               │
    ├──────────────────────────────────────────────────────────────────────────────────────────────────────┤
    │ 运行时层 云版   harness —— llm · chat · rag · mcp · skill · supplier （运行时支撑，无 Controller ）    │
    │          本地版 Pi 运行时 —— pi-ai + pi-agent-core ，独立 utilityProcess                              │
    ├──────────────────────────────────────────────────────────────────────────────────────────────────────┤
    │ 支撑层   云版   MySQL （业务/平台） · Redis （登录态 + 对话流） · Milvus （向量库）                     │
    │          本地版 SQLite 单文件（零依赖） · 本地文件 / 终端 / 浏览器                                   │
    ├──────────────────────────────────────────────────────────────────────────────────────────────────────┤
    │ 外部层   OpenAI 兼容供应商（对话/嵌入） · 远程/本地 MCP 服务 · 示例 xxl-ai-sample （可选）            │
    └──────────────────────────────────────────────────────────────────────────────────────────────────────┘

四、安装部署

XXL-AI 是一个「云本结合」的 AI Agent 开发平台，提供两种同源同品牌、能力互补的交付形态，可按团队规模与使用场景选用合适版本安装和部署。

4.1 [云版（ Web 服务端）]

XXL-AI 云版项目，支持 Docker Compose 一键部署，部署脚本如下：


        # 第一步：代码 clone 本部 + 前往仓库目录
        git clone https://github.com/xuxueli/xxl-ai.git
        cd ./xxl-ai

        # 第二步：构建前端并同步产物（ npm run build 构建 dist ，npm run sync:dist 复制到 xxl-ai-api 静态资源目录）
        cd xxl-ai-ui && npm install && npm run build && npm run sync:dist && cd ..

        # 第三步：构建后端
        mvn clean package

        # 第四步：进入 docker 目录（支持自定义 .env 配置，如修改 MYSQL_PATH 配置设置 Mysql 数据持久化目录）
        cd ./docker/
        cat .env

        # 第五步：启动/停止项目
        docker compose up -d
        docker compose down

4.2 [本地版（ Desk 桌面端）]

XXL-AI 本地版项目，支持跨平台客户端一键安装，下载对应版本（如 mac/win ）安装程序即可。

下载地址：https://github.com/xuxueli/xxl-ai/releases

五、核心功能操作指南

5.1 [本地版（ Desk 桌面端）]

安装并打开 Desk 客户端

配置供应商模型

使用示例：Desk 客户端/Agent 通过本地系统能力（ Node/Python ）进行文件操作。

5.2 [云版（ Web 服务端）]

登录工作台

编排 Agent

发布 Agent

使用示例：Agent 调用 MCP 工具（网页抓取）汇总「今日热点社会新闻」