From 96cf49d3b7a7436973b3f4dda5b9db9f8b9df899 Mon Sep 17 00:00:00 2001
From: Zephyr <zerophyr@outlook.com>
Date: Mon, 1 Sep 2025 22:13:08 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E6=94=AF=E6=8C=81=E8=87=AA=E5=AE=9A?=
 =?UTF-8?q?=E4=B9=89API=E5=89=8D=E7=BC=80=E9=85=8D=E7=BD=AE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 添加 VITE_API_BASE_PREFIX 环境变量支持
- 教程页面优先使用自定义前缀，未配置时使用浏览器访问地址
- 更新 .env.example 添加配置说明
---
 web/admin-spa/.env.example               |  8 ++++++++
 web/admin-spa/src/views/TutorialView.vue | 10 +++++++++-
 2 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/web/admin-spa/.env.example b/web/admin-spa/.env.example
index e0f33e8b..d0bd7a97 100644
--- a/web/admin-spa/.env.example
+++ b/web/admin-spa/.env.example
@@ -23,6 +23,14 @@ VITE_APP_TITLE=Claude Relay Service - 管理后台
 # 格式：http://proxy-host:port
 #VITE_HTTP_PROXY=http://127.0.0.1:7890
 
+# ========== 教程页面配置 ==========
+
+# API 基础前缀（可选）
+# 用于教程页面显示的自定义 API 前缀
+# 如果不配置，则使用当前浏览器访问地址
+# 示例：https://api.example.com 或 https://relay.mysite.com
+# VITE_API_BASE_PREFIX=https://api.example.com
+
 # ========== 使用说明 ==========
 # 1. 复制此文件为 .env.local 进行本地配置
 # 2. .env.local 文件不会被提交到版本控制
diff --git a/web/admin-spa/src/views/TutorialView.vue b/web/admin-spa/src/views/TutorialView.vue
index b1d98e7c..76be3a98 100644
--- a/web/admin-spa/src/views/TutorialView.vue
+++ b/web/admin-spa/src/views/TutorialView.vue
@@ -1639,7 +1639,7 @@
 </template>
 
 <script setup>
-import { ref, computed } from 'vue'
+import {computed, ref} from 'vue'
 
 // 当前系统选择
 const activeTutorialSystem = ref('windows')
@@ -1653,6 +1653,14 @@ const tutorialSystems = [
 
 // 获取基础URL前缀
 const getBaseUrlPrefix = () => {
+  // 优先使用环境变量配置的自定义前缀
+  const customPrefix = import.meta.env.VITE_API_BASE_PREFIX
+  if (customPrefix) {
+    // 去除末尾的斜杠
+    return customPrefix.replace(/\/$/, '')
+  }
+
+  // 否则使用当前浏览器访问地址
   // 更健壮的获取 origin 的方法，兼容旧版浏览器和特殊环境
   let origin = ''