From c0531632b222b04e9c626489d09074675222b1a6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=90=AF=E8=88=AA?= <280645618@qq.com>
Date: Sun, 8 Mar 2026 19:54:41 +0800
Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9Eollama=E6=A8=A1=E5=9E=8B?=
 =?UTF-8?q?=E5=88=97=E8=A1=A8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../main/java/cn/qihangerp/erp/AiAgent.java   |   2 +-
 .../erp/controller/OllamaController.java      |  40 ++++++
 vue/src/api/ai/ollama.js                      |   9 ++
 vue/src/views/index.vue                       |  50 +++++---
 新手指南.md                                   | 115 ++++++++++++++++++
 5 files changed, 197 insertions(+), 19 deletions(-)
 create mode 100644 api/ai-agent/src/main/java/cn/qihangerp/erp/controller/OllamaController.java
 create mode 100644 vue/src/api/ai/ollama.js
 create mode 100644 新手指南.md

diff --git a/api/ai-agent/src/main/java/cn/qihangerp/erp/AiAgent.java b/api/ai-agent/src/main/java/cn/qihangerp/erp/AiAgent.java
index e5ddd0ef..0cbfd62b 100644
--- a/api/ai-agent/src/main/java/cn/qihangerp/erp/AiAgent.java
+++ b/api/ai-agent/src/main/java/cn/qihangerp/erp/AiAgent.java
@@ -13,7 +13,7 @@ import org.springframework.web.client.RestTemplate;
 //@EnableDiscoveryClient
 //@MapperScan("cn.qihangerp.oms.mapper")
 @EnableFeignClients(basePackages = "cn.qihangerp.erp")
-@EnableDiscoveryClient
+//@EnableDiscoveryClient
 @ComponentScan(basePackages={"cn.qihangerp"})
 @SpringBootApplication
 public class AiAgent {
diff --git a/api/ai-agent/src/main/java/cn/qihangerp/erp/controller/OllamaController.java b/api/ai-agent/src/main/java/cn/qihangerp/erp/controller/OllamaController.java
new file mode 100644
index 00000000..6d5ce0ba
--- /dev/null
+++ b/api/ai-agent/src/main/java/cn/qihangerp/erp/controller/OllamaController.java
@@ -0,0 +1,40 @@
+package cn.qihangerp.erp.controller;
+
+import lombok.AllArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.CrossOrigin;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.client.RestTemplate;
+
+import java.util.HashMap;
+import java.util.Map;
+
+@AllArgsConstructor
+@RestController
+@CrossOrigin
+public class OllamaController {
+
+    // 默认的Ollama API地址
+    private static final String OLLAMA_BASE_URL = "http://localhost:11434";
+
+    @GetMapping(value = "/ollama/models")
+    public ResponseEntity<?> getOllamaModels() {
+        try {
+            // 使用RestTemplate调用Ollama API获取模型列表
+            RestTemplate restTemplate = new RestTemplate();
+            String url = OLLAMA_BASE_URL + "/api/tags";
+            
+            // 调用Ollama API获取模型列表
+            Map<String, Object> models = restTemplate.getForObject(url, Map.class);
+            
+            return ResponseEntity.ok(models);
+        } catch (Exception e) {
+            Map<String, Object> errorResponse = new HashMap<>();
+            errorResponse.put("code", 500);
+            errorResponse.put("msg", "Error connecting to Ollama: " + e.getMessage());
+            return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(errorResponse);
+        }
+    }
+}
diff --git a/vue/src/api/ai/ollama.js b/vue/src/api/ai/ollama.js
new file mode 100644
index 00000000..f5d99b8e
--- /dev/null
+++ b/vue/src/api/ai/ollama.js
@@ -0,0 +1,9 @@
+import request from '@/utils/request'
+
+// 获取Ollama模型列表
+export function getOllamaModels() {
+  return request({
+    url: '/api/ai-agent/ollama/models',
+    method: 'get'
+  })
+}
diff --git a/vue/src/views/index.vue b/vue/src/views/index.vue
index 825c2201..2b7ba653 100644
--- a/vue/src/views/index.vue
+++ b/vue/src/views/index.vue
@@ -9,12 +9,8 @@
         </div>
         <div class="header-right">
           <el-select v-model="selectedModel" size="mini" style="width: 120px; margin-right: 10px;">
-            <el-option label="qwen3.5:2b" value="qwen3.5:2b"></el-option>
-            <el-option label="Llama 3" value="llama3"></el-option>
             <el-option label="DeepSeek" value="deepseek"></el-option>
-            <el-option label="Gemini" value="gemini"></el-option>
-            <el-option label="Claude" value="claude"></el-option>
-            <el-option label="Gemma" value="gemma"></el-option>
+            <el-option v-for="model in models" :key="model.value" :label="model.label" :value="model.value"></el-option>
           </el-select>
           <el-tag type="success" size="mini">在线</el-tag>
         </div>
@@ -132,6 +128,7 @@
 
 <script>
 import { todayDaily } from "@/api/report/report";
+import { getOllamaModels } from "@/api/ai/ollama";
 import { getToken } from "@/utils/auth";
 import MarkdownIt from 'markdown-it';
 
@@ -179,17 +176,34 @@ export default {
       clientId: '',
       isSseConnected: false,
       isLoading: false,
-      selectedModel: 'qwen3.5:2b'
+      selectedModel: 'deepseek',
+      models: []
     }
   },
   mounted() {
     this.loadSystemStats();
     this.initSse();
+    this.loadOllamaModels();
   },
   beforeDestroy() {
     this.closeSse();
   },
   methods: {
+    loadOllamaModels() {
+      getOllamaModels().then(response => {
+        if (response.models) {
+          this.models = response.models.map(model => ({
+            label: model.name,
+            value: model.name
+          }));
+          if(this.models&&this.models.length>0){
+            this.selectedModel = this.models[0].value
+          }
+        }
+      }).catch(error => {
+        console.error('获取模型列表失败:', error);
+      });
+    },
     initSse() {
       // 生成唯一客户端ID
       this.clientId = 'client_' + Date.now() + '_' + Math.random().toString(36).substr(2, 9);
@@ -342,18 +356,18 @@ export default {
         clearTimeout(this.messageTimeout);
         this.messageTimeout = null;
       }
-      
+
       // 移除所有data:前缀
       let messageContent = this.messageBuffer.replace(/^data:/gm, '');
       // 移除末尾的空行
       messageContent = messageContent.trim();
-      
+
       // 只有当消息内容不为空时才处理
       if (messageContent) {
         try {
           // 解析JSON数据
           const jsonData = JSON.parse(messageContent);
-          
+
           // 检查是否是包含action的响应
           if (jsonData.action) {
             // 处理导航动作
@@ -374,22 +388,22 @@ export default {
           } else {
             // 处理普通文本消息
             let textContent = jsonData.text || messageContent;
-            
+
             // 检查是否包含订单信息，转换为表格格式
             if (textContent.includes('订单号:') || textContent.includes('订单详情')) {
               // 提取订单信息并转换为表格
               textContent = this.convertOrderToTable(textContent);
             }
-            
+
             // 检查是否包含打开页面的指令
             this.checkOpenPageCommand(textContent);
-            
+
             // 移除正在思考的消息
             if (this.isLoading) {
               this.messages = this.messages.filter(msg => !msg.isLoading);
               this.isLoading = false;
             }
-            
+
             // 使用markdown-it将markdown格式转换为HTML
             const htmlContent = this.md.render(textContent);
             this.messages.push({
@@ -407,7 +421,7 @@ export default {
             this.messages = this.messages.filter(msg => !msg.isLoading);
             this.isLoading = false;
           }
-          
+
           // 使用markdown-it将markdown格式转换为HTML
           const htmlContent = this.md.render(messageContent);
           this.messages.push({
@@ -419,11 +433,11 @@ export default {
           this.scrollToBottom();
         }
       }
-      
+
       // 清空缓冲区
       this.messageBuffer = '';
     },
-    
+
     // 检查并处理打开页面的指令
     checkOpenPageCommand(text) {
       // 检查是否包含打开店铺管理页面的指令
@@ -433,7 +447,7 @@ export default {
       }
       // 可以在这里添加更多页面的打开指令
     },
-    
+
     // 将订单信息转换为markdown表格
     convertOrderToTable(text) {
       // 提取订单信息
@@ -442,7 +456,7 @@ export default {
       const customerMatches = text.match(/客户:\s*(\S+)/);
       const amountMatches = text.match(/金额:\s*(\S+)/);
       const statusMatches = text.match(/状态:\s*(\S+)/);
-      
+
       if (orderMatches && dateMatches && customerMatches && amountMatches && statusMatches) {
         // 构建markdown表格
         return `| 订单号 | 日期 | 客户 | 金额 | 状态 |
diff --git a/新手指南.md b/新手指南.md
new file mode 100644
index 00000000..58f7c18b
--- /dev/null
+++ b/新手指南.md
@@ -0,0 +1,115 @@
+# 启航电商ERP（开源版）新手指南
+
+面向第一次接触本项目的开发者，帮助你在本地快速跑通后端与前端，了解整体技术框架与模块划分，并定位常见问题。
+
+## 1. 项目简介
+- 仓库：qihang-ecom-erp-open（后端多模块 + 前端 Vue 项目）
+- 定位：电商企业数字化转型的订单/商品/库存等业务中台底座
+- 特性：多平台（淘宝、京东、拼多多、抖店、微信等）、多店铺、订单/售后/库存/采购/发货
+
+## 2. 技术框架与组件
+- 语言/运行时：Java 17
+- Spring 家族：
+  - Spring Boot 3.0.x
+  - Spring Cloud 2022.x，Spring Cloud Alibaba 2022.x（Nacos、Sentinel 等）
+- 数据访问：MyBatis-Plus 3.5.x
+- 数据库：MySQL 8.x
+- 缓存：Redis 7.x
+- 注册中心：Nacos 2.3.x
+- 流量治理：Sentinel 1.8.x（可选）
+- 网络/HTTP：OpenFeign、OkHttp
+- 鉴权与安全：Spring Security 6 + JWT
+- 前端：Vue 2 + Element-UI（Node.js 16）
+
+注意：oms-api 依赖本地 libs/open-sdk-2.1.12.jar（systemPath 方式），建议在 CI/CD 中明确提供或上传到私服后改为普通依赖。
+
+## 3. 模块结构概览
+- 顶层聚合：qihang-ecom-erp-open（pom packaging）
+  - api（微服务）
+    - gateway：API 网关（Spring Cloud Gateway + Sentinel）
+    - sys-api：系统域（用户/角色/菜单/字典/配置/任务、登录鉴权等）
+    - erp-api：ERP 核心域（商品、库存、入出库、采购、订单/发货/售后、报表等）
+    - oms-api：开放平台对接（淘宝/京东/拼多多/抖店/微信/快手等：授权、拉单、发货、商品同步）
+  - core（公共能力）
+    - common：通用工具、异常、返回封装、配置
+    - security：鉴权、安全、JWT、登录、权限校验
+    - interfaces：领域服务接口契约（与实现解耦）
+  - model：实体、DTO/VO/BO、查询与请求对象
+  - mapper：MyBatis-Plus Mapper 接口与 XML 映射
+  - service：业务服务实现（实现 interfaces，编排 mapper、领域逻辑）
+  - serviceImpl：历史/备用实现（现阶段以 service 为主）
+  - vue：前端（Vue2 + Element-UI）
+
+依赖关系（自上而下）：api -> service -> interfaces/mapper -> model；所有模块共享 core/common & core/security。
+
+## 4. 环境准备
+- 必备：JDK 17、Maven 3.8+、Node.js 16.x、MySQL 8、Redis 7、Nacos 2.3.x
+- 可选：Sentinel 1.8.7
+- 数据库：导入 docs/qihang-erp.sql 到新库 qihang-erp
+
+## 5. 快速启动
+1) 启动基础设施
+- MySQL、Redis 正常可用
+- 启动 Nacos（单机示例）：
+  - 下载 nacos-server 2.3.x，解压后
+  - Linux/Mac：`sh bin/startup.sh -m standalone`
+  - Windows：`bin\startup.cmd -m standalone`
+- 可选：启动 Sentinel 控制台
+
+2) 构建后端
+- 在仓库根目录执行
+  - `mvn clean install -DskipTests`
+  - `mvn clean package -DskipTests`
+- 依次启动微服务（本地 IDE 或 java -jar）：
+  - api/oms-api（开放平台服务）
+  - api/sys-api（系统服务）
+  - api/erp-api（ERP 服务）
+  - api/gateway（网关）
+
+3) 启动前端
+- 切换到 vue 目录，`npm install`，`npm run dev`
+- 浏览器打开：http://localhost:88
+- 默认账号：`admin` / `admin123`
+
+## 6. 配置要点
+- 数据库与 Redis、Nacos 等连接在各服务的 resources/application.yml|yaml 中配置
+- sys-api 使用 Spring Security + JWT，首次需 GET /captchaImage 再 POST /login 获取 token
+- oms-api 需确保 libs/open-sdk-2.1.12.jar 存在（用于平台 SDK 调用）；必要时替换为私服依赖
+
+## 7. 常见问题（FAQ）
+- 服务注册不到 Nacos
+  - 检查 Nacos 是否启动、地址配置是否正确（ip/端口/命名空间）
+- 启动报数据源/表不存在
+  - 确认已导入 docs/qihang-erp.sql 并与配置库名一致
+- 登录失败/权限问题
+  - 确认 Redis 正常、JWT 密钥与过期时间配置正确；使用 admin/admin123 测试
+- oms-api 调用平台接口报 SDK 相关错误
+  - 检查 open-sdk-2.1.12.jar 是否存在；或将 SDK 发布到私服并在 pom 中改为普通依赖
+- 构建失败报版本冲突
+  - 统一使用 api/pom.xml 中的 dependencyManagement 约束版本，避免子模块写死不一致版本
+
+## 8. 开发建议
+- 入口类：
+  - api/sys-api/src/main/java/.../SysApi.java
+  - api/erp-api/src/main/java/.../ErpApi.java
+  - api/oms-api/src/main/java/.../OmsApi.java
+  - api/gateway/src/main/java/.../Gateway.java
+- 推荐阅读顺序：Controller -> Service -> Mapper(XML) -> Model
+- 新增业务：先在 interfaces 定义契约，再在 service 实现，最终由 api 层 Controller 暴露
+- 日志：oms-api 引入 logstash-logback-encoder，可对接 ELK
+
+## 9. 目录速览（节选）
+- api/：各微服务
+- core/：公共库（common/security/interfaces）
+- model/：实体与 DTO/VO/BO
+- mapper/：DAO 与 XML 映射
+- service/：业务实现
+- vue/：前端工程
+- docs/：SQL/预览图/文档
+
+## 10. 后续提升建议
+- 将 oms-api 的 systemPath SDK 迁移到私服依赖
+- 在 api 父 POM 中统一 Spring Cloud 版本管理，减少子模块手动版本
+- 网关侧启用统一鉴权过滤（结合 core/security）
+
+祝你开发顺利，快速上手并跑通全链路！
\ No newline at end of file