From 123cbf1dbb6908c3825b859b6e51adf2de32f34b Mon Sep 17 00:00:00 2001
From: MangoFanFanw <mangofanfanw@icloud.com>
Date: Tue, 28 Apr 2026 20:03:22 +0800
Subject: [PATCH] =?UTF-8?q?WebUI=20=E6=9B=B4=E6=96=B0=E8=87=B3=201.1.0=20?=
 =?UTF-8?q?=E7=89=88=E6=9C=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

1. 移除重启和关闭 Suan API 的按钮，因为按照目前的设计，这在技术上难以实现。
2. 增加 FastAPI docs 的配置选项。
---
 webui/components.d.ts      |  2 ++
 webui/package.json         |  2 +-
 webui/src/App.vue          | 10 ++++++-
 webui/src/pages/Config.vue | 60 +++++++++++++++++++++++++++++---------
 webui/src/types/config.ts  |  1 +
 5 files changed, 59 insertions(+), 16 deletions(-)

diff --git a/webui/components.d.ts b/webui/components.d.ts
index 89524f4..5a29d9a 100644
--- a/webui/components.d.ts
+++ b/webui/components.d.ts
@@ -38,6 +38,7 @@ declare module 'vue' {
     NSwitch: typeof import('naive-ui')['NSwitch']
     NTag: typeof import('naive-ui')['NTag']
     NText: typeof import('naive-ui')['NText']
+    NTooltip: typeof import('naive-ui')['NTooltip']
     RouterLink: typeof import('vue-router')['RouterLink']
     RouterView: typeof import('vue-router')['RouterView']
   }
@@ -71,6 +72,7 @@ declare global {
   const NSwitch: typeof import('naive-ui')['NSwitch']
   const NTag: typeof import('naive-ui')['NTag']
   const NText: typeof import('naive-ui')['NText']
+  const NTooltip: typeof import('naive-ui')['NTooltip']
   const RouterLink: typeof import('vue-router')['RouterLink']
   const RouterView: typeof import('vue-router')['RouterView']
 }
\ No newline at end of file
diff --git a/webui/package.json b/webui/package.json
index b0017ec..7404b06 100644
--- a/webui/package.json
+++ b/webui/package.json
@@ -1,6 +1,6 @@
 {
   "name": "webui",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "private": true,
   "type": "module",
   "scripts": {
diff --git a/webui/src/App.vue b/webui/src/App.vue
index 56eff99..7a379e4 100644
--- a/webui/src/App.vue
+++ b/webui/src/App.vue
@@ -54,6 +54,7 @@ onMounted(async () => {
             <sidebar-nav />
           </div>
           <div id="center-content">
+            <div id="extra-control" />
             <div id="content-container">
               <router-view v-slot="{ Component }">
                 <keep-alive>
@@ -107,13 +108,20 @@ onMounted(async () => {
     #center-content {
       flex: 1;
       min-height: 0;
+      display: flex;
+      flex-direction: column;
+
+      #extra-control {
+        flex: 0;
+      }
 
       #content-container {
         border: 1px solid #519f72;
         border-radius: 10px;
         padding: 10px;
-        height: 100%;
         overflow: auto;
+        height: 100%;
+        flex: 1;
       }
     }
   }
diff --git a/webui/src/pages/Config.vue b/webui/src/pages/Config.vue
index 4499334..feea52d 100644
--- a/webui/src/pages/Config.vue
+++ b/webui/src/pages/Config.vue
@@ -38,13 +38,6 @@ function varTag(code: string, description: string) {
 <template>
   <div id="config-container">
     <n-h2 prefix="bar">酸酸设置</n-h2>
-    <n-alert title="设置注意" type="info">
-      <n-p class="no-margin">
-        <n-text strong type="warning">系统设置</n-text>
-        - 需要完全重新启动 Suan API 才能应用；
-      </n-p>
-      <n-p class="no-margin">其他的设置可以即时生效。</n-p>
-    </n-alert>
 
     <n-collapse v-if="CONFIG.dataStatus" style="margin-top: 1rem">
       <n-collapse-item name="system" title="系统设置">
@@ -73,6 +66,25 @@ function varTag(code: string, description: string) {
             show-input
             title="外部域名 / 主机名"
           />
+          <setting-card
+            v-model:boolean-value="CONFIG.data.system.docs"
+            show-switch
+            title="Fast API 文档功能"
+          >
+            <n-p>
+              FastAPI 提供
+              <n-code inline>/docs</n-code>
+              和
+              <n-code inline>/redoc</n-code>
+              两个文档端口，以及一个
+              <n-code inline>/openapi.json</n-code>
+              结构化 API 数据文件。
+            </n-p>
+            <n-p
+              >如果你需要深入研究 Suan API，这是来自 FastAPI
+              的赠礼；如有安全方面顾虑也可以关闭。</n-p
+            >
+          </setting-card>
         </n-flex>
       </n-collapse-item>
       <n-collapse-item name="schedule" title="课表设置">
@@ -146,12 +158,20 @@ function varTag(code: string, description: string) {
       </n-collapse-item>
     </n-collapse>
 
-    <teleport v-if="extraVisible" defer to="#center-container">
+    <teleport v-if="extraVisible" defer to="#extra-control">
       <div class="header-card">
-        <n-flex vertical>
+        <n-flex align="center">
+          <n-alert type="info">
+            <n-p class="no-margin">
+              <n-text strong type="warning">系统设置</n-text>
+              需要完全重新启动 Suan API 才能应用；其他的设置可以即时生效。
+            </n-p>
+          </n-alert>
+
           <n-button
-            circle
+            round
             size="large"
+            style="margin-left: auto"
             type="success"
             @click="
               () => {
@@ -159,14 +179,26 @@ function varTag(code: string, description: string) {
                 MESSAGE.success('保存设置成功，后端会自动应用新的设置 ~')
               }
             "
-            >保存</n-button
+            >保存设置</n-button
           >
-          <n-button circle size="large" type="warning">重启</n-button>
-          <n-button circle size="large" type="error">关闭</n-button>
+
+          <n-popover placement="bottom" trigger="hover">
+            <template #trigger>
+              <n-button round size="large" type="tertiary">重启 Suan API</n-button>
+            </template>
+            <n-p>由于技术限制，无法从 WebUI 重启 Suan API 应用。</n-p>
+          </n-popover>
         </n-flex>
       </div>
     </teleport>
   </div>
 </template>
 
-<style scoped></style>
+<style scoped>
+div.header-card {
+  border: 1px solid #519f72;
+  border-radius: 10px;
+  padding: 10px;
+  margin-bottom: 10px;
+}
+</style>
diff --git a/webui/src/types/config.ts b/webui/src/types/config.ts
index 755caca..fafb134 100644
--- a/webui/src/types/config.ts
+++ b/webui/src/types/config.ts
@@ -3,6 +3,7 @@ export interface ConfigSystemDto {
   port?: number
   reload?: boolean
   public_host?: string
+  docs?: boolean
 }
 
 export interface ConfigScheduleDto {