# LongMarchLLM

**Repository Path**: signalxh2006/LongMarchLLM

## Basic Information

- **Project Name**: LongMarchLLM
- **Description**: 自己之前开发的长征AI大模型2.0升级版
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-07
- **Last Updated**: 2026-06-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 长征AI大模型 2.0 (LongMarch LLM)

**长征AI大模型V2.0 - 桌面端智能助手**
![用户端主界面](mdImg/用户端0.png)

Windows 环境下的界面如图所示
![Linux服务端和用户端](mdImg/linux服务端和用户端.png)

Linux 环境下的服务端控制面板与用户端对话界面。
基于智谱AI GLM-4-Flash模型的桌面端AI对话应用，采用 Electron + Go + React 混合架构开发。

> 开发者：xinhao（董昕昊）

---

## 项目概述

长征AI大模型是一款跨平台（Windows / Linux / macOS）的本地AI助手应用，集成了 Go 语言编写的后端代理服务器和 React 前端对话界面，提供流畅的AI对话体验。

### 核心特性

- 双窗口架构（控制面板 + 对话窗口）
- 基于智谱AI GLM-4-Flash免费模型
- 流式响应，打字机效果实时输出
- Markdown富文本渲染
- 实时统计监控
- 红色革命风格UI设计

---

## 技术架构

### 技术栈

| 分类 | 技术 |
|------|------|
| 前端框架 | React 18.2.0 + TypeScript 5.3.0 |
| 构建工具 | Vite 5.0.0 |
| 桌面框架 | Electron 28.0.0 |
| 后端语言 | Go 1.21 |
| Web框架 | Gin 1.9.1 |
| AI模型 | 智谱AI GLM-4-Flash |

### 项目结构

```
LongMarchLLM/
├── electron/           # Electron主进程
│   ├── main.js       # 窗口管理、IPC通信
│   └── preload.js   # 安全上下文隔离
├── src/              # React前端源码
│   ├── components/  # UI组件
│   ├── hooks/       # 业务逻辑
│   ├── data/        # 静态数据
│   └── types/       # 类型定义
├── handlers/         # Go后端处理器
├── middleware/       # Go中间件
└── public/          # 静态资源
```

---

## 快速开始

### 开发环境要求

- Node.js 18+
- Go 1.21+
- npm 9+

### 安装依赖

```bash
npm install
```

### 开发模式

```bash
# 构建Go服务端（Windows）
npm run server:build:win

# 启动Electron开发模式
npm run electron:dev

# 或单独启动前端
npm run dev

# 或单独启动Go后端
npm run server
```

### 生产打包

```bash
# 打包Windows + Linux
npm run electron:build

# 全平台打包
npm run electron:build:all
```

---

## 功能说明

### 1. 双窗口架构

- **Launcher（控制面板）**：服务启停、实时日志、粒子动画
- **Chat Window（对话窗口）**：AI对话界面、Markdown渲染

### 2. AI对话

- 流式响应输出
- 多轮对话上下文记忆
- 会话持久化存储
- Markdown富文本渲染（代码块、表格、列表等）
- 代码块一键复制

### 3. 服务管理

- 一键启动/停止Go后端
- 实时日志流式展示
- 自动健康检查
- 后端离线自动重连

### 4. 统计监控

- 请求总数与错误计数
- 平均响应时间与QPS
- ECharts可视化图表

---

## 安装与运行

### Windows

双击安装程序进行安装，或直接从 `win-unpacked/` 文件夹运行免安装版。

### Linux

```bash
unzip linux-unpacked.zip
cd linux-unpacked
chmod +x longmarch-llm
./longmarch-llm --no-sandbox --disable-gpu
```

### macOS

双击 `.dmg` 文件拖入 Applications，或解压 `.zip` 后运行。

---

## API接口

| 路由 | 方法 | 说明 |
|------|------|------|
| `/health` | GET | 健康检查 |
| `/stats` | GET | 服务统计 |
| `/v1/chat/completions` | POST | 聊天补全 |
| `/v1/models` | GET | 模型列表 |

---

## 许可证

本项目为个人开源项目，仅供学习交流使用。

---

## 鸣谢

- 智谱AI - 提供GLM-4-Flash免费模型API
- Electron - 跨平台桌面应用框架
- React & Vite - 前端开发工具链
- Gin - Go Web框架