XXL-AI v1.4.0 공개, 로컬판에 SKILL 마켓·Git 지원 추가

Release Notes

【로컬 버전 (Desk 데스크톱)】

- 1、【추가】인간-기계 상호작용 흐름 통일: Agent가 작업을 수행하는 과정에서 사용자 확인 작업이 필요할 경우, 능동적으로 인간-기계 상호작용 요청을 개시하여 인간과 기계가 협력해 작업을 완료;

- 2、【추가】인간-기계 상호작용 표준 컴포넌트: 권한 확인, 사용자 다중 선택 항목 선택, 사용자 입력 등 표준화된 인간-기계 상호작용 컴포넌트를 제공하며, Agent가 통합하여 자동으로 활성화;

- 3、【추가】Agent 관측 가능성: 개발자 모드를 지원하여 Trace 관측 기능을 제공하며, Agent 실행 과정의 Session 대화, 도구 호출, 모델 API 상호작용, 메모리 조작 등 Trace 세부 정보를 조회할 수 있어 Agent 동작의 디버깅과 최적화에 용이;

- 4、【추가】Git 도구: 프로젝트 공간 단위의 Git 변경 검토, 푸시 등의 조작을 지원;

- 5、【추가】SKILL 마켓 및 설치: GitHub에서 설치하는 방식을 지원; 설치 단계의 로직은 SKILL 마켓 / skills.sh와 통일; 다중 SKILL 인식, 저장소 파일 캐시 및 만료 정리 등을 지원;

- 6、【추가】Agent 사용자 정의: Agent 지시문 설정, Agent 메모리 시작/중지 및 메모리 관리를 지원;

- 7、【추가】Agent 사전 설정 지시문: 다중 Agent 사전 설정 지시문을 제공하며, 빠른 선택 및 설정을 지원;

- 8、【최적화】SKILL 및 MCP 가져오기 최적화: 불필요한 파일과 크기 제한을 제거하여 가져오기 효율과 호환성 향상;

- 9、【강화】파일 컴포넌트 강화: 선택한 파일에 우클릭 단축키를 지원하여 기본 앱으로 열기, 해당 폴더 열기, 삭제, 경로 복사;

- 10、【리팩터링】도구 컴포넌트 통일: 터미널, 브라우저, 파일 컴포넌트를 오른쪽 패널로 통일;

- 11、【최적화】SKILL 권한 최적화: 소프트웨어 데이터 디렉터리 하위의 SKILL 콘텐츠에 대해 대화 읽기 시 통과시키고 권한 차단을 하지 않음;

- 12、【체험】UI 레이아웃 최적화: 대화 작업 영역을 SessionWorkspace로 재구성하여 대화, 도구, 터미널을 포괄; 또한 대화 간 작업 영역 내용 격리;

- 13、【최적화】Markdown 렌더링 최적화: 글꼴, 코드 하이라이트, 표, 목록, 인용, 수식 렌더링 최적화;

- 14、【최적화】Thinking 렌더링 최적화: 단일 사고 과정 렌더링에 최대 높이를 제한하고, 스크롤 시 하단에 고정되어 최신 내용을 표시;

- 15、【체험】외관 테마: 다크 모드, 라이트 모드 및 사용자 정의 다중 테마 설정을 지원하여 사용자 경험 향상;

- 16、【체험】대화 영역 체험 최적화: 대화 영역 레이아웃, 상호작용 조정으로 체험성 업그레이드;

보충 설명: macOS에서 「파일 손상」 알림이 뜨는 것은 실제 손상이 아니라, macOS Gatekeeper가 서명되지 않은 앱에 격리 표시를 했기 때문이며, 사용자가 터미널 명령으로 격리 표시를 제거하여 문제를 해결할 수 있습니다. 처리 방법: 1. 설치 프로그램을 더블클릭하여 설치하고, App을 /Applications에 드래그(먼저 실행하지 않음); 2. 터미널에서 격리 표시 제거 (sudo는 비밀번호 입력 필요): sudo xattr -rd com.apple.quarantine "/Applications/XXL-AI-Desk.app" ; 3. App을 더블클릭하여 실행 및 사용;

【클라우드 버전 (Web 서버 측)】

- 1、【조정】홈페이지 리포트 테넌트 격리: 리포트 데이터를 테넌트 공간 간에 데이터 격리하여 데이터 유출 방지; From PR-5;

- 2、【수정】Milvus 벡터 모델 캐시: MilvusVectorStore 캐시 Key에 모델 지문 정보를 추가하여 모델 변경 시 캐시 업데이트가 제때 이루어지지 않는 문제 방지; From PR-6;

- 3、【최적화】Agent 모델 변경 실효성: 모델 객체를 정기적으로 만료 갱신(5min)하고, Agent 구성 지문 정보(업데이트 시간 MD5)와 결합하여 능동적으로 업데이트;

- 4、【최적화】Markdown 렌더링 최적화: 글꼴, 코드 하이라이트, 표, 목록, 인용, 수식 렌더링 최적화;

- 5、【최적화】Thinking 렌더링 최적화: 단일 사고 과정 렌더링에 최대 높이를 제한하고, 스크롤 시 하단에 고정되어 최신 내용을 표시;

一、소개

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만)

二、문서 주소

- 중국어 문서: www.xuxueli.com/xxl-ai/

- Github 주소: github.com/xuxueli/xxl…

三、아키텍처 설계

XXL-AI는 「 클라우드-로컬 결합 」을 채택: 클라우드 버전 (Web / 서버 측)과 로컬 버전 (Desk 데스크톱)은 동일 소스로 상호 보완적입니다. 전체는 위에서 아래로 진입, 프런트엔드, 애플리케이션, 런타임, 지원, 외부의 6개 계층으로 나뉩니다:

┌──────────────────────────────────────────────────────────────────────────────────────────────────────┐ │ 진입 계층 관리측 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(벡터 DB) │ │ 로컬 버전 SQLite 단일 파일(제로 의존성) · 로컬 파일/터미널/브라우저 │ ├──────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ 외부 계층 OpenAI 호환 공급자(대화/임베딩) · 원격/로컬 MCP 서비스 · 예시 xxl - ai - sample(선택) │ └──────────────────────────────────────────────────────────────────────────────────────────────────────┘

4. 설치 및 배포

XXL-AI는 「클라우드·로컬 결합」의 AI Agent 개발 플랫폼으로, 동일 소스·동일 브랜드이면서 역량이 상호 보완적인 두 가지 전달 형태를 제공하며, 팀 규모와 사용 시나리오에 맞춰 적합한 버전을 선택해 설치 및 배포할 수 있습니다.

4.1 【클라우드 버전(Web 서버 측)】

XXL-AI 클라우드 버전 프로젝트는 Docker Compose 원클릭 배포를 지원하며, 배포 스크립트는 다음과 같습니다:

1단계: 코드 clone(본부) + 저장소 디렉터리로 이동 git clone https://github.com/xuxueli/xxl-ai.git cd ./xxl-ai # 2단계: 프런트엔드 빌드 및 산출물 동기화(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 .. # 3단계: 백엔드 빌드 mvn clean package # 4단계: docker 디렉터리로 이동(사용자 정의 .env 설정 지원, 예: MYSQL_PATH 설정 변경으로 Mysql 데이터 영속화 디렉터리 지정) cd ./docker/ cat . env # 5단계: 프로젝트 시작/중지 docker compose up -d docker compose down

4.2 【로컬 버전(Desk 데스크톱 측)】

XXL-AI 로컬 버전 프로젝트는 크로스 플랫폼 클라이언트 원클릭 설치를 지원하며, 해당 버전(예: mac/win)의 설치 프로그램을 다운로드하면 됩니다.

- 다운로드 주소 : github.com/xuxueli/xxl…

5. 핵심 기능 조작 가이드

5.1 【클라우드 버전(Web 서버 측)】

워크벤치 로그인

Agent 오케스트레이션

Agent 게시

사용 예시: Agent가 MCP 도구(웹 페이지 스크래핑)를 호출해 「오늘의 핫이슈 사회 뉴스」를 요약

5.2 【로컬 버전(Desk 데스크톱 측)】

Desk 클라이언트 설치 및 실행

공급자 모델 설정

사용 예시: Desk 클라이언트/Agent가 로컬 시스템 기능(Node/Python)을 통해 파일 작업 수행.

쉬쉐리

엔지니어 @따중띠엔핑(大众点评)

100

글

59k

읽음

270

팔로워