更新 changelog

更新 changelog

CHANGELOG.md

@@ -7,18 +7,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 6 种更新类别：Added、Changed、Deprecated、Removed、Fixed、Security。
 
-## [0.1.5] - 2026-04-28
-
-### Added
-
-- 增加开关 FastAPI 内置文档功能的选项。在此前，文档功能一直默认开启。
-
-### Changed
-
-- WebUI 版本升级至 1.1.0
-    - 增加开关 FastAPI `/docs` 文档端点的设置项。
-    - 删除「重启」和「关闭」Suan API 的预留按钮，因为技术上这难以实现。
-
 ## [0.1.4] - 2026-04-26
 
 ### Fixed

README.md

@@ -12,18 +12,12 @@ NJUPT Suan API 是一个 FastAPI 项目，目标在于实现对 NJUPT（南京
 
 ## 功能
 
-| 计划功能（芒果画饼中）       | 支持进度 |
-|-------------------|------|
-| 教务系统 - 课程表获取      | ✅    |
-| 教务系统 - 课程获取       | ⌛️   |
-| 教务系统 - 成绩获取       | ⌛️   |
-| 教务系统 - 课程表 - 日历订阅 | ⌛️   |
-| 体育部系统 - 早锻炼获取     | ❌    |
-
-| 优化待办          | 支持进度 |
-|---------------|------|
-| 自定义课程表 CSS 样式 | ⌛️   |
-| 生成的静态资源有效期管理  | ⌛️   |
+| 计划功能（芒果画饼中）   | 支持进度          |
+|---------------|---------------|
+| 教务系统 - 课程表获取  | ✅             |
+| 教务系统 - 课程获取   | ⌛️            |
+| 教务系统 - 成绩获取   | ⌛️            |
+| 体育部系统 - 早锻炼获取 | ⌛️（等待体育部系统修复） |
 
 ## 运行
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "njupt-suan-api"
-version = "0.1.5"
+version = "0.1.3"
 description = "API and MCP server for NJUPT infomation ~"
 readme = "README.md"
 requires-python = ">=3.13"

src/njupt_suan_api/api/baselib/config.py

@@ -61,7 +61,6 @@ class Config:
         doc_system["port"] = 8000
         doc_system["reload"] = False
         doc_system["public_host"] = "http://127.0.0.1:8000"
-        doc_system["docs"] = True
 
         doc_schedule["playwright_headless"] = True
         doc_schedule["jwxt_login_method"] = "sso"

src/njupt_suan_api/router/webui_router.py

@@ -9,7 +9,7 @@ WEBUI_INDEX = STATIC_DIR / "index.html"
 SCHEDULE_INDEX = STATIC_DIR / "index-schedule.html"
 ASSETS_DIR = STATIC_DIR / "assets"
 
-webui_router = APIRouter(prefix="/webui", tags=["webui"])
+webui_router = APIRouter(prefix="/webui")
 
 
 @webui_router.get("/", response_class=HTMLResponse)

src/njupt_suan_api/server.py

@@ -24,36 +24,10 @@ from njupt_suan_api.router.enhance import ReturnDto, create_db_and_tables
 
 DATA_DIR = Path.cwd() / "data"
 
-description = """
-🚀 NJUPT Suan API 的 API 文档在此。你也可以直接在此处测试 API。
-
-**NJUPT Suan API** 是一个为南京邮电大学（NJUPT）开发的项目。
-
-**项目** -
-[GitHub](https://github.com/mangofanfan/njupt-suan-api) |
-[Mango Gitea](https://gitea.mangofanfan.cn/SuanDev/njupt-suan-api) |
-[文档](https://suan.mangofanfan.cn)
-
-**文档** - [SwaggerUI](/docs) | [Redoc](/redoc) | [openapi.json](/openapi.json)
-
-### 如果您是访客
-
-部分 **admin** 分组的端点需要身份验证才能调用，它们一般会被标记。
-
-你可以在这里查看所有端点的详细信息，如果你需要进行针对 Suan API 的开发的话，这一定会对你有所帮助。
-
-### 如果您是管理员
-
-文档功能作为 FastAPI 的特色功能默认开启。
-
-如果你需要，在 Suan API 的设置中可以选择关闭文档功能。
-"""
-
-config.sync_load_json()
-
 
 async def toml_watcher() -> None:
     """配置文件监听器"""
+    await config.load_json()
     async for change in awatch(DATA_DIR / "config.json"):
         logger.info(f"配置文件更新，重新加载 | {change=}")
         await config.load_json()
@@ -74,20 +48,7 @@ async def life_span(_: FastAPI) -> AsyncGenerator[None, None]:
         logger.info("配置文件监听任务已结束。")
 
 
-# 文档功能是对 FastAPI app 实例进行配置的
-enable_docs = config.get("system", "docs", True)
-logger.debug(f"FastAPI 文档功能状态 - {enable_docs=}")
-
-app = FastAPI(
-    title="njupt-suan-api",
-    lifespan=combine_lifespans(life_span, mcp_app.lifespan),
-    description=description,
-    docs_url="/docs" if enable_docs else None,
-    redoc_url="/redoc" if enable_docs else None,
-    openapi_url="/openapi.json" if enable_docs else None,
-    version=__version__,
-    license_info={"name": "MIT", "identifier": "MIT"},
-)
+app = FastAPI(lifespan=combine_lifespans(life_span, mcp_app.lifespan))
 
 
 @app.middleware("http")

uv.lock

@@ -701,7 +701,7 @@ wheels = [
 
 [[package]]
 name = "njupt-suan-api"
-version = "0.1.5"
+version = "0.1.3"
 source = { editable = "." }
 dependencies = [
     { name = "aiofiles" },

webui/components.d.ts

@@ -38,7 +38,6 @@ 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']
   }
@@ -72,7 +71,6 @@ 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']
 }

webui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webui",
-  "version": "1.1.0",
+  "version": "1.0.0",
   "private": true,
   "type": "module",
   "scripts": {

webui/src/App.vue

@@ -54,7 +54,6 @@ onMounted(async () => {
             <sidebar-nav />
           </div>
           <div id="center-content">
-            <div id="extra-control" />
             <div id="content-container">
               <router-view v-slot="{ Component }">
                 <keep-alive>
@@ -108,20 +107,13 @@ 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;
-        overflow: auto;
         height: 100%;
-        flex: 1;
+        overflow: auto;
       }
     }
   }

webui/src/pages/Config.vue

@@ -38,6 +38,13 @@ 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="系统设置">
@@ -66,25 +73,6 @@ 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="课表设置">
@@ -158,20 +146,12 @@ function varTag(code: string, description: string) {
       </n-collapse-item>
     </n-collapse>
 
-    <teleport v-if="extraVisible" defer to="#extra-control">
+    <teleport v-if="extraVisible" defer to="#center-container">
       <div class="header-card">
-        <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-flex vertical>
           <n-button
-            round
+            circle
             size="large"
-            style="margin-left: auto"
             type="success"
             @click="
               () => {
@@ -179,26 +159,14 @@ function varTag(code: string, description: string) {
                 MESSAGE.success('保存设置成功，后端会自动应用新的设置 ~')
               }
             "
-            >保存设置</n-button
+            >保存</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-button circle size="large" type="warning">重启</n-button>
+          <n-button circle size="large" type="error">关闭</n-button>
         </n-flex>
       </div>
     </teleport>
   </div>
 </template>
 
-<style scoped>
-div.header-card {
-  border: 1px solid #519f72;
-  border-radius: 10px;
-  padding: 10px;
-  margin-bottom: 10px;
-}
-</style>
+<style scoped></style>

webui/src/types/config.ts

@@ -3,7 +3,6 @@ export interface ConfigSystemDto {
   port?: number
   reload?: boolean
   public_host?: string
-  docs?: boolean
 }
 
 export interface ConfigScheduleDto {