From 04cc390fde6f4b4d5607818d23b71a4c56247876 Mon Sep 17 00:00:00 2001
From: chenhaodong <haodongchen@aliyun.com>
Date: Thu, 18 Jun 2026 21:29:45 +0800
Subject: [PATCH] =?UTF-8?q?=E5=89=8D=E7=AB=AF=E6=96=87=E4=BB=B6=E6=97=A5?=
 =?UTF-8?q?=E6=9C=9F=E5=88=92=E5=88=86?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 exam-vue/src/App.vue                                   |  5 +++++
 exam-vue/src/api/apply/apply.js                        | 10 +++++-----
 exam-vue/src/api/common.js                             |  5 +++++
 exam-vue/src/api/sys/bookgl/bookgl.js                  |  5 +++++
 exam-vue/src/api/sys/config/config.js                  |  5 +++++
 exam-vue/src/api/sys/dict/dict.js                      |  5 +++++
 exam-vue/src/api/sys/gggl/gggl.js                      |  5 +++++
 exam-vue/src/api/sys/grxxgl/grxxgl.js                  |  5 +++++
 exam-vue/src/api/sys/huanshu/huanshu.js                |  5 +++++
 exam-vue/src/api/sys/jieshu/jieshu.js                  |  5 +++++
 exam-vue/src/api/sys/liuyangl/liuyangl.js              |  5 +++++
 exam-vue/src/api/sys/role/role.js                      |  5 +++++
 exam-vue/src/api/sys/tj/tongji.js                      |  5 +++++
 exam-vue/src/api/sys/user/user.js                      |  5 +++++
 exam-vue/src/api/user.js                               |  5 +++++
 exam-vue/src/components/BackToTop/index.vue            |  5 +++++
 exam-vue/src/components/Breadcrumb/index.vue           |  5 +++++
 exam-vue/src/components/DataTable/index.vue            |  5 +++++
 exam-vue/src/components/DepartTreeSelect/index.vue     |  5 +++++
 exam-vue/src/components/ErrorLog/index.vue             |  5 +++++
 exam-vue/src/components/ExamSelect/index.vue           |  5 +++++
 exam-vue/src/components/FileUpload/index.vue           |  5 +++++
 exam-vue/src/components/FileUpload/local.vue           |  5 +++++
 exam-vue/src/components/Hamburger/index.vue            |  5 +++++
 exam-vue/src/components/HeaderSearch/index.vue         |  5 +++++
 exam-vue/src/components/MeetRole/index.vue             |  5 +++++
 exam-vue/src/components/Pagination/index.vue           |  5 +++++
 exam-vue/src/components/PanThumb/index.vue             |  5 +++++
 exam-vue/src/components/RepoSelect/index.vue           |  5 +++++
 exam-vue/src/components/RightPanel/index.vue           |  5 +++++
 exam-vue/src/components/Screenfull/index.vue           |  5 +++++
 exam-vue/src/components/SizeSelect/index.vue           |  5 +++++
 exam-vue/src/components/SvgIcon/index.vue              |  5 +++++
 exam-vue/src/components/ThemePicker/index.vue          |  5 +++++
 exam-vue/src/directive/clipboard/clipboard.js          |  5 +++++
 exam-vue/src/directive/clipboard/index.js              |  5 +++++
 exam-vue/src/directive/permission/index.js             |  5 +++++
 exam-vue/src/directive/permission/permission.js        |  5 +++++
 exam-vue/src/directive/sticky.js                       |  5 +++++
 exam-vue/src/directive/waves/index.js                  |  5 +++++
 exam-vue/src/directive/waves/waves.css                 |  5 +++++
 exam-vue/src/directive/waves/waves.js                  |  5 +++++
 exam-vue/src/filters/index.js                          |  5 +++++
 exam-vue/src/icons/index.js                            |  5 +++++
 exam-vue/src/layout/components/AppMain.vue             |  5 +++++
 exam-vue/src/layout/components/Navbar.vue              |  5 +++++
 exam-vue/src/layout/components/Settings/index.vue      |  5 +++++
 exam-vue/src/layout/components/Sidebar/FixiOSBug.js    |  5 +++++
 exam-vue/src/layout/components/Sidebar/Item.vue        |  5 +++++
 exam-vue/src/layout/components/Sidebar/Link.vue        |  5 +++++
 exam-vue/src/layout/components/Sidebar/Logo.vue        |  5 +++++
 exam-vue/src/layout/components/Sidebar/SidebarItem.vue |  5 +++++
 exam-vue/src/layout/components/Sidebar/index.vue       |  5 +++++
 exam-vue/src/layout/components/TagsView/ScrollPane.vue |  5 +++++
 exam-vue/src/layout/components/TagsView/index.vue      |  5 +++++
 exam-vue/src/layout/components/index.js                |  5 +++++
 exam-vue/src/layout/index.vue                          |  5 +++++
 exam-vue/src/layout/mixin/ResizeHandler.js             |  5 +++++
 exam-vue/src/main.js                                   |  5 +++++
 exam-vue/src/permission.js                             |  5 +++++
 exam-vue/src/router/index.js                           |  5 +++++
 exam-vue/src/settings.js                               |  5 +++++
 exam-vue/src/store/getters.js                          |  5 +++++
 exam-vue/src/store/index.js                            |  5 +++++
 exam-vue/src/store/modules/app.js                      |  5 +++++
 exam-vue/src/store/modules/errorLog.js                 |  5 +++++
 exam-vue/src/store/modules/permission.js               |  5 +++++
 exam-vue/src/store/modules/settings.js                 |  5 +++++
 exam-vue/src/store/modules/tagsView.js                 |  5 +++++
 exam-vue/src/store/modules/user.js                     |  5 +++++
 exam-vue/src/styles/btn.scss                           |  5 +++++
 exam-vue/src/styles/element-ui.scss                    |  5 +++++
 exam-vue/src/styles/element-variables.scss             |  5 +++++
 exam-vue/src/styles/index.scss                         |  5 +++++
 exam-vue/src/styles/login.scss                         |  5 +++++
 exam-vue/src/styles/mixin.scss                         |  5 +++++
 exam-vue/src/styles/sidebar.scss                       |  5 +++++
 exam-vue/src/styles/transition.scss                    |  5 +++++
 exam-vue/src/styles/variables-js.js                    |  5 +++++
 exam-vue/src/styles/variables.scss                     |  5 +++++
 exam-vue/src/utils/auth.js                             |  5 +++++
 exam-vue/src/utils/clipboard.js                        |  5 +++++
 exam-vue/src/utils/error-log.js                        |  5 +++++
 exam-vue/src/utils/get-page-title.js                   |  5 +++++
 exam-vue/src/utils/index.js                            |  5 +++++
 exam-vue/src/utils/open-window.js                      |  5 +++++
 exam-vue/src/utils/path.js                             |  5 +++++
 exam-vue/src/utils/permission.js                       |  5 +++++
 exam-vue/src/utils/request.js                          |  5 +++++
 exam-vue/src/utils/scroll-to.js                        |  5 +++++
 exam-vue/src/utils/validate.js                         |  5 +++++
 exam-vue/src/views/apply/input/index.vue               |  5 +++++
 exam-vue/src/views/dashboard/index.vue                 |  5 +++++
 exam-vue/src/views/error-log/components/ErrorTestA.vue |  5 +++++
 exam-vue/src/views/error-log/components/ErrorTestB.vue |  5 +++++
 exam-vue/src/views/error-log/index.vue                 |  5 +++++
 exam-vue/src/views/error-page/401.vue                  |  5 +++++
 exam-vue/src/views/error-page/404.vue                  |  5 +++++
 exam-vue/src/views/login/components/LoginLayout.vue    |  5 +++++
 exam-vue/src/views/login/index.vue                     |  5 +++++
 exam-vue/src/views/login/register.vue                  |  5 +++++
 exam-vue/src/views/profile/components/Account.vue      |  5 +++++
 exam-vue/src/views/profile/components/UserCard.vue     |  5 +++++
 exam-vue/src/views/profile/index.vue                   |  5 +++++
 exam-vue/src/views/redirect/index.vue                  |  5 +++++
 exam-vue/src/views/sys/bookgl/index.vue                |  5 +++++
 exam-vue/src/views/sys/config/index.vue                |  5 +++++
 exam-vue/src/views/sys/dict/index.vue                  |  5 +++++
 exam-vue/src/views/sys/gggl/index.vue                  |  5 +++++
 exam-vue/src/views/sys/huanshu/index.vue               |  5 +++++
 exam-vue/src/views/sys/jiehuanjilu/index.vue           |  5 +++++
 exam-vue/src/views/sys/jieshu/index.vue                |  5 +++++
 exam-vue/src/views/sys/liuyangl/index.vue              |  5 +++++
 exam-vue/src/views/sys/log/index.vue                   |  5 +++++
 exam-vue/src/views/sys/role/index.vue                  |  5 +++++
 exam-vue/src/views/sys/stugggl/index.vue               |  5 +++++
 exam-vue/src/views/sys/stuliuyan/index.vue             |  5 +++++
 exam-vue/src/views/sys/user/index.vue                  |  5 +++++
 118 files changed, 590 insertions(+), 5 deletions(-)

diff --git a/exam-vue/src/App.vue b/exam-vue/src/App.vue
index ec9032c..5d0eef4 100644
--- a/exam-vue/src/App.vue
+++ b/exam-vue/src/App.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 根组件，定义应用顶层结构与全局样式入口
+  @author D吕贺034244311
+  @date 20260615
+-->
 <template>
   <div id="app">
     <router-view />
diff --git a/exam-vue/src/api/apply/apply.js b/exam-vue/src/api/apply/apply.js
index 53b83c4..580009f 100644
--- a/exam-vue/src/api/apply/apply.js
+++ b/exam-vue/src/api/apply/apply.js
@@ -1,8 +1,8 @@
-<!--
-@Description 描述:
-@Author D吕贺034244311
-@Date 20260615
--->
+/**
+ * @description 申请模块 API 接口，定义申请提交与审核相关的请求
+ * @author D吕贺034244311
+ * @date 20260619
+ */
 import { post } from '@/utils/request'
 
 export function saveData(data) {
diff --git a/exam-vue/src/api/common.js b/exam-vue/src/api/common.js
index 77c2baf..3627d17 100644
--- a/exam-vue/src/api/common.js
+++ b/exam-vue/src/api/common.js
@@ -1,3 +1,8 @@
+/**
+ * @description 公共 API 接口模块，定义文件上传等通用请求接口
+ * @author D吕贺034244311
+ * @date 20260619
+ */
 import { post } from '@/utils/request'
 
 export function fetchList(url, query) {
diff --git a/exam-vue/src/api/sys/bookgl/bookgl.js b/exam-vue/src/api/sys/bookgl/bookgl.js
index da4ce60..1d86bf7 100644
--- a/exam-vue/src/api/sys/bookgl/bookgl.js
+++ b/exam-vue/src/api/sys/bookgl/bookgl.js
@@ -1,3 +1,8 @@
+/**
+ * @description 图书管理 API 接口，定义图书增删改查的后端请求
+ * @author D吕贺034244311
+ * @date 20260619
+ */
 import { post } from '@/utils/request'
 
 
diff --git a/exam-vue/src/api/sys/config/config.js b/exam-vue/src/api/sys/config/config.js
index b7bdc6b..c141671 100644
--- a/exam-vue/src/api/sys/config/config.js
+++ b/exam-vue/src/api/sys/config/config.js
@@ -1,3 +1,8 @@
+/**
+ * @description 系统配置 API 接口，定义配置参数的读写请求
+ * @author D吕贺034244311
+ * @date 20260619
+ */
 import { post } from '@/utils/request'
 
 // 获得用户协议详情，固定ID为0
diff --git a/exam-vue/src/api/sys/dict/dict.js b/exam-vue/src/api/sys/dict/dict.js
index 743a952..1fa797e 100644
--- a/exam-vue/src/api/sys/dict/dict.js
+++ b/exam-vue/src/api/sys/dict/dict.js
@@ -1,3 +1,8 @@
+/**
+ * @description 字典管理 API 接口，定义字典数据的增删改查请求
+ * @author D吕贺034244311
+ * @date 20260619
+ */
 import {post} from '@/utils/request'
 
 export function saveTypeData(data) {
diff --git a/exam-vue/src/api/sys/gggl/gggl.js b/exam-vue/src/api/sys/gggl/gggl.js
index 4d2015b..3e44412 100644
--- a/exam-vue/src/api/sys/gggl/gggl.js
+++ b/exam-vue/src/api/sys/gggl/gggl.js
@@ -1,3 +1,8 @@
+/**
+ * @description 公告管理 API 接口，定义公告发布与管理的请求
+ * @author D吕贺034244311
+ * @date 20260619
+ */
 import { post } from '@/utils/request'
 
 // 保存或更新公告信息
diff --git a/exam-vue/src/api/sys/grxxgl/grxxgl.js b/exam-vue/src/api/sys/grxxgl/grxxgl.js
index 966f46f..dff65e1 100644
--- a/exam-vue/src/api/sys/grxxgl/grxxgl.js
+++ b/exam-vue/src/api/sys/grxxgl/grxxgl.js
@@ -1,3 +1,8 @@
+/**
+ * @description 个人信息管理 API 接口，定义个人资料查看与修改请求
+ * @author D吕贺034244311
+ * @date 20260619
+ */
 import { post } from '@/utils/request'
 
 // 获取个人学生信息
diff --git a/exam-vue/src/api/sys/huanshu/huanshu.js b/exam-vue/src/api/sys/huanshu/huanshu.js
index 576aaf4..b2295c2 100644
--- a/exam-vue/src/api/sys/huanshu/huanshu.js
+++ b/exam-vue/src/api/sys/huanshu/huanshu.js
@@ -1,3 +1,8 @@
+/**
+ * @description 还书管理 API 接口，定义还书操作与记录查询请求
+ * @author D吕贺034244311
+ * @date 20260619
+ */
 import { post } from '@/utils/request'
 
 // 还书
diff --git a/exam-vue/src/api/sys/jieshu/jieshu.js b/exam-vue/src/api/sys/jieshu/jieshu.js
index b059500..844a3ca 100644
--- a/exam-vue/src/api/sys/jieshu/jieshu.js
+++ b/exam-vue/src/api/sys/jieshu/jieshu.js
@@ -1,3 +1,8 @@
+/**
+ * @description 借书管理 API 接口，定义借书操作与记录查询请求
+ * @author D吕贺034244311
+ * @date 20260619
+ */
 import { post } from '@/utils/request'
 
 
diff --git a/exam-vue/src/api/sys/liuyangl/liuyangl.js b/exam-vue/src/api/sys/liuyangl/liuyangl.js
index e5793f9..2821a4e 100644
--- a/exam-vue/src/api/sys/liuyangl/liuyangl.js
+++ b/exam-vue/src/api/sys/liuyangl/liuyangl.js
@@ -1,3 +1,8 @@
+/**
+ * @description 留存量管理 API 接口，定义留存量查询与设置请求
+ * @author D吕贺034244311
+ * @date 20260619
+ */
 import { post } from '@/utils/request'
 
 // 保存或更新公告信息
diff --git a/exam-vue/src/api/sys/role/role.js b/exam-vue/src/api/sys/role/role.js
index c6b0ad5..f2f8472 100644
--- a/exam-vue/src/api/sys/role/role.js
+++ b/exam-vue/src/api/sys/role/role.js
@@ -1,3 +1,8 @@
+/**
+ * @description 角色管理 API 接口，定义角色与权限操作的请求
+ * @author D吕贺034244311
+ * @date 20260619
+ */
 import { post } from '@/utils/request'
 
 export function fetchList() {
diff --git a/exam-vue/src/api/sys/tj/tongji.js b/exam-vue/src/api/sys/tj/tongji.js
index cfc073a..ebdb3c8 100644
--- a/exam-vue/src/api/sys/tj/tongji.js
+++ b/exam-vue/src/api/sys/tj/tongji.js
@@ -1,3 +1,8 @@
+/**
+ * @description 统计模块 API 接口，定义数据统计与报表查询请求
+ * @author D吕贺034244311
+ * @date 20260619
+ */
 import { post } from '@/utils/request'
 
 export function sjkctj() {
diff --git a/exam-vue/src/api/sys/user/user.js b/exam-vue/src/api/sys/user/user.js
index eefaeff..9369fe3 100644
--- a/exam-vue/src/api/sys/user/user.js
+++ b/exam-vue/src/api/sys/user/user.js
@@ -1,3 +1,8 @@
+/**
+ * @description 用户管理 API 接口，定义用户账号管理操作的请求
+ * @author D吕贺034244311
+ * @date 20260619
+ */
 import { post } from '@/utils/request'
 
 export function updateData(data) {
diff --git a/exam-vue/src/api/user.js b/exam-vue/src/api/user.js
index b3eb9b1..2aff989 100644
--- a/exam-vue/src/api/user.js
+++ b/exam-vue/src/api/user.js
@@ -1,3 +1,8 @@
+/**
+ * @description 用户相关 API 接口，封装用户信息的查询与更新请求
+ * @author D吕贺034244311
+ * @date 20260619
+ */
 import { post } from '@/utils/request'
 
 export function login(data) {
diff --git a/exam-vue/src/components/BackToTop/index.vue b/exam-vue/src/components/BackToTop/index.vue
index c721495..cf45997 100644
--- a/exam-vue/src/components/BackToTop/index.vue
+++ b/exam-vue/src/components/BackToTop/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 回到顶部组件，页面滚动超过阈值后显示悬浮按钮
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <transition :name="transitionName">
     <div v-show="visible" :style="customStyle" class="back-to-ceiling" @click="backToTop">
diff --git a/exam-vue/src/components/Breadcrumb/index.vue b/exam-vue/src/components/Breadcrumb/index.vue
index cc2ed81..a15f829 100644
--- a/exam-vue/src/components/Breadcrumb/index.vue
+++ b/exam-vue/src/components/Breadcrumb/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 面包屑导航组件，根据当前路由自动生成层级导航
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <el-breadcrumb class="app-breadcrumb" separator="/">
     <transition-group name="breadcrumb">
diff --git a/exam-vue/src/components/DataTable/index.vue b/exam-vue/src/components/DataTable/index.vue
index ea47125..f4ac32f 100644
--- a/exam-vue/src/components/DataTable/index.vue
+++ b/exam-vue/src/components/DataTable/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 数据表格组件，封装 Element UI Table 的通用配置与交互
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <div class="app-container">
 
diff --git a/exam-vue/src/components/DepartTreeSelect/index.vue b/exam-vue/src/components/DepartTreeSelect/index.vue
index ae2df86..d4ad445 100644
--- a/exam-vue/src/components/DepartTreeSelect/index.vue
+++ b/exam-vue/src/components/DepartTreeSelect/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 部门树形选择器，支持组织架构的层级选择
+  @author D吕贺034244311
+  @date 20260616
+-->
 <!-- 树状选择器 -->
 <template>
   <el-popover
diff --git a/exam-vue/src/components/ErrorLog/index.vue b/exam-vue/src/components/ErrorLog/index.vue
index 5e7d121..d1180e3 100644
--- a/exam-vue/src/components/ErrorLog/index.vue
+++ b/exam-vue/src/components/ErrorLog/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 错误日志展示组件，收集并展示前端运行时错误列表
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <div v-if="errorLogs.length>0">
     <el-badge :is-dot="true" style="line-height: 25px;margin-top: -5px;" @click="dialogTableVisible=true">
diff --git a/exam-vue/src/components/ExamSelect/index.vue b/exam-vue/src/components/ExamSelect/index.vue
index cea7fc1..a35873f 100644
--- a/exam-vue/src/components/ExamSelect/index.vue
+++ b/exam-vue/src/components/ExamSelect/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 考试选择器组件，提供考试项目的下拉选择功能
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
 
   <el-select
diff --git a/exam-vue/src/components/FileUpload/index.vue b/exam-vue/src/components/FileUpload/index.vue
index 2d57e17..2fde82a 100644
--- a/exam-vue/src/components/FileUpload/index.vue
+++ b/exam-vue/src/components/FileUpload/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 文件上传组件，封装文件选择、上传进度与结果回调
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <div>
     <file-upload-local v-model="fileUrl" :accept="accept" :tips="tips" :list-type="listType" />
diff --git a/exam-vue/src/components/FileUpload/local.vue b/exam-vue/src/components/FileUpload/local.vue
index 44865f6..2a1d48e 100644
--- a/exam-vue/src/components/FileUpload/local.vue
+++ b/exam-vue/src/components/FileUpload/local.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 本地文件上传组件，支持文件直接选择与本地预览
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <div class="content">
     <el-upload
diff --git a/exam-vue/src/components/Hamburger/index.vue b/exam-vue/src/components/Hamburger/index.vue
index 368b002..7fdfd90 100644
--- a/exam-vue/src/components/Hamburger/index.vue
+++ b/exam-vue/src/components/Hamburger/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 汉堡菜单按钮组件，控制侧边栏的展开与折叠切换
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <div style="padding: 0 15px;" @click="toggleClick">
     <svg
diff --git a/exam-vue/src/components/HeaderSearch/index.vue b/exam-vue/src/components/HeaderSearch/index.vue
index d353288..3b51cbf 100644
--- a/exam-vue/src/components/HeaderSearch/index.vue
+++ b/exam-vue/src/components/HeaderSearch/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 顶部搜索组件，支持页面路由的快速搜索与跳转
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <div :class="{'show':show}" class="header-search">
     <svg-icon class-name="search-icon" icon-class="search" @click.stop="click" />
diff --git a/exam-vue/src/components/MeetRole/index.vue b/exam-vue/src/components/MeetRole/index.vue
index 6bee04a..ad211b4 100644
--- a/exam-vue/src/components/MeetRole/index.vue
+++ b/exam-vue/src/components/MeetRole/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 角色匹配组件，根据用户角色显示对应的功能入口
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
 
   <el-select
diff --git a/exam-vue/src/components/Pagination/index.vue b/exam-vue/src/components/Pagination/index.vue
index 36bc880..e9d76b5 100644
--- a/exam-vue/src/components/Pagination/index.vue
+++ b/exam-vue/src/components/Pagination/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 分页组件，封装页码导航、每页条数切换等通用逻辑
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <div :class="{'hidden':hidden}" class="pagination-container">
     <el-pagination
diff --git a/exam-vue/src/components/PanThumb/index.vue b/exam-vue/src/components/PanThumb/index.vue
index 1bcf417..7b2d80e 100644
--- a/exam-vue/src/components/PanThumb/index.vue
+++ b/exam-vue/src/components/PanThumb/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 缩略图展示组件，用于图片的卡片式预览展示
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <div :style="{zIndex:zIndex,height:height,width:width}" class="pan-item">
     <div class="pan-info">
diff --git a/exam-vue/src/components/RepoSelect/index.vue b/exam-vue/src/components/RepoSelect/index.vue
index 2e78560..6dfd243 100644
--- a/exam-vue/src/components/RepoSelect/index.vue
+++ b/exam-vue/src/components/RepoSelect/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 题库选择器组件，提供题库资源的下拉选择功能
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
 
   <el-select
diff --git a/exam-vue/src/components/RightPanel/index.vue b/exam-vue/src/components/RightPanel/index.vue
index 7bcf382..0ee7282 100644
--- a/exam-vue/src/components/RightPanel/index.vue
+++ b/exam-vue/src/components/RightPanel/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 右侧滑出面板组件，用于设置面板等侧滑内容的展示
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <div ref="rightPanel" :class="{show:show}" class="rightPanel-container">
     <div class="rightPanel-background" />
diff --git a/exam-vue/src/components/Screenfull/index.vue b/exam-vue/src/components/Screenfull/index.vue
index ae7fe82..27a3c41 100644
--- a/exam-vue/src/components/Screenfull/index.vue
+++ b/exam-vue/src/components/Screenfull/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 全屏切换组件，控制浏览器全屏模式的进入与退出
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <div>
     <svg-icon :icon-class="isFullscreen?'exit-fullscreen':'fullscreen'" @click="click" />
diff --git a/exam-vue/src/components/SizeSelect/index.vue b/exam-vue/src/components/SizeSelect/index.vue
index 340d97b..e17c7d2 100644
--- a/exam-vue/src/components/SizeSelect/index.vue
+++ b/exam-vue/src/components/SizeSelect/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 尺寸选择组件，切换 Element UI 组件的全局尺寸规格
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <el-dropdown trigger="click" @command="handleSetSize">
     <div>
diff --git a/exam-vue/src/components/SvgIcon/index.vue b/exam-vue/src/components/SvgIcon/index.vue
index c7f33e9..c4b394f 100644
--- a/exam-vue/src/components/SvgIcon/index.vue
+++ b/exam-vue/src/components/SvgIcon/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description SVG 图标组件，统一渲染项目中引用的 SVG 图标
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <div v-if="isExternal" :style="styleExternalIcon" class="svg-external-icon svg-icon" v-bind="$attrs" />
   <svg v-else :class="svgClass" aria-hidden="true" v-bind="$attrs">
diff --git a/exam-vue/src/components/ThemePicker/index.vue b/exam-vue/src/components/ThemePicker/index.vue
index be875f4..270893c 100644
--- a/exam-vue/src/components/ThemePicker/index.vue
+++ b/exam-vue/src/components/ThemePicker/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 主题颜色选择器，支持运行时动态更换应用主题色
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <el-color-picker
     v-model="theme"
diff --git a/exam-vue/src/directive/clipboard/clipboard.js b/exam-vue/src/directive/clipboard/clipboard.js
index 9f2782c..7a1ba33 100644
--- a/exam-vue/src/directive/clipboard/clipboard.js
+++ b/exam-vue/src/directive/clipboard/clipboard.js
@@ -1,3 +1,8 @@
+/**
+ * @description 剪贴板指令逻辑实现，处理点击复制文本的交互行为
+ * @author D吕贺034244311
+ * @date 20260617
+ */
 // Inspired by https://github.com/Inndy/vue-clipboard2
 const Clipboard = require('clipboard')
 if (!Clipboard) {
diff --git a/exam-vue/src/directive/clipboard/index.js b/exam-vue/src/directive/clipboard/index.js
index 02c9816..81d543e 100644
--- a/exam-vue/src/directive/clipboard/index.js
+++ b/exam-vue/src/directive/clipboard/index.js
@@ -1,3 +1,8 @@
+/**
+ * @description 剪贴板指令注册入口，定义 v-clipboard 自定义指令
+ * @author D吕贺034244311
+ * @date 20260617
+ */
 import Clipboard from './clipboard'
 
 const install = function(Vue) {
diff --git a/exam-vue/src/directive/permission/index.js b/exam-vue/src/directive/permission/index.js
index e5dadd3..b948367 100644
--- a/exam-vue/src/directive/permission/index.js
+++ b/exam-vue/src/directive/permission/index.js
@@ -1,3 +1,8 @@
+/**
+ * @description 权限指令注册入口，定义 v-permission 自定义指令
+ * @author D吕贺034244311
+ * @date 20260617
+ */
 import permission from './permission'
 
 const install = function(Vue) {
diff --git a/exam-vue/src/directive/permission/permission.js b/exam-vue/src/directive/permission/permission.js
index f89fa59..b6d9530 100644
--- a/exam-vue/src/directive/permission/permission.js
+++ b/exam-vue/src/directive/permission/permission.js
@@ -1,3 +1,8 @@
+/**
+ * @description 权限指令逻辑实现，根据用户角色控制 DOM 元素的显示
+ * @author D吕贺034244311
+ * @date 20260617
+ */
 import store from '@/store'
 
 export default {
diff --git a/exam-vue/src/directive/sticky.js b/exam-vue/src/directive/sticky.js
index af98464..5ee1db3 100644
--- a/exam-vue/src/directive/sticky.js
+++ b/exam-vue/src/directive/sticky.js
@@ -1,3 +1,8 @@
+/**
+ * @description 粘性定位指令，实现元素滚动到指定位置后固定悬浮的效果
+ * @author D吕贺034244311
+ * @date 20260617
+ */
 const vueSticky = {}
 let listenAction
 vueSticky.install = app => {
diff --git a/exam-vue/src/directive/waves/index.js b/exam-vue/src/directive/waves/index.js
index 65f9b30..886d17e 100644
--- a/exam-vue/src/directive/waves/index.js
+++ b/exam-vue/src/directive/waves/index.js
@@ -1,3 +1,8 @@
+/**
+ * @description 水波纹指令注册入口，定义 v-waves 自定义指令
+ * @author D吕贺034244311
+ * @date 20260617
+ */
 import waves from './waves'
 
 const install = function(Vue) {
diff --git a/exam-vue/src/directive/waves/waves.css b/exam-vue/src/directive/waves/waves.css
index af7a7ef..096d949 100644
--- a/exam-vue/src/directive/waves/waves.css
+++ b/exam-vue/src/directive/waves/waves.css
@@ -1,3 +1,8 @@
+/* ========================================
+ * @description 水波纹动画样式，定义涟漪扩散的 CSS 关键帧
+ * @author D吕贺034244311
+ * @date 20260617
+ * ======================================== */
 .waves-ripple {
     position: absolute;
     border-radius: 100%;
diff --git a/exam-vue/src/directive/waves/waves.js b/exam-vue/src/directive/waves/waves.js
index ee5a9a3..86089ec 100644
--- a/exam-vue/src/directive/waves/waves.js
+++ b/exam-vue/src/directive/waves/waves.js
@@ -1,3 +1,8 @@
+/**
+ * @description 水波纹指令逻辑实现，为元素添加点击涟漪动画效果
+ * @author D吕贺034244311
+ * @date 20260617
+ */
 import './waves.css'
 
 const context = '@@wavesContext'
diff --git a/exam-vue/src/filters/index.js b/exam-vue/src/filters/index.js
index 223edb6..1466741 100644
--- a/exam-vue/src/filters/index.js
+++ b/exam-vue/src/filters/index.js
@@ -1,3 +1,8 @@
+/**
+ * @description 全局过滤器注册模块，定义日期格式化等通用 Vue 过滤器
+ * @author D吕贺034244311
+ * @date 20260615
+ */
 // import parseTime, formatTime and set to filter
 export { parseTime, formatTime } from '@/utils'
 
diff --git a/exam-vue/src/icons/index.js b/exam-vue/src/icons/index.js
index 1b11e2d..06849f7 100644
--- a/exam-vue/src/icons/index.js
+++ b/exam-vue/src/icons/index.js
@@ -1 +1,6 @@
+/**
+ * @description SVG 图标注册模块，批量导入 SVG 文件并注册为全局可用图标
+ * @author D吕贺034244311
+ * @date 20260615
+ */
 import 'virtual:svg-icons-register'
diff --git a/exam-vue/src/layout/components/AppMain.vue b/exam-vue/src/layout/components/AppMain.vue
index a897638..93e8be1 100644
--- a/exam-vue/src/layout/components/AppMain.vue
+++ b/exam-vue/src/layout/components/AppMain.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 主内容区域组件，承载路由视图的渲染与过渡动画
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <section class="app-main">
     <transition name="fade-transform" mode="out-in">
diff --git a/exam-vue/src/layout/components/Navbar.vue b/exam-vue/src/layout/components/Navbar.vue
index 43a6109..fcb9cb3 100644
--- a/exam-vue/src/layout/components/Navbar.vue
+++ b/exam-vue/src/layout/components/Navbar.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 顶部导航栏组件，包含面包屑、全屏切换、用户菜单等
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <div class="navbar">
     <hamburger id="hamburger-container" :is-active="sidebar.opened" class="hamburger-container" @toggleClick="toggleSideBar" />
diff --git a/exam-vue/src/layout/components/Settings/index.vue b/exam-vue/src/layout/components/Settings/index.vue
index 49d4968..0e5280f 100644
--- a/exam-vue/src/layout/components/Settings/index.vue
+++ b/exam-vue/src/layout/components/Settings/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 系统设置面板，提供主题色、侧边栏模式等运行时配置
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <div class="drawer-container">
     <div>
diff --git a/exam-vue/src/layout/components/Sidebar/FixiOSBug.js b/exam-vue/src/layout/components/Sidebar/FixiOSBug.js
index bc14856..f3c267d 100644
--- a/exam-vue/src/layout/components/Sidebar/FixiOSBug.js
+++ b/exam-vue/src/layout/components/Sidebar/FixiOSBug.js
@@ -1,3 +1,8 @@
+/**
+ * @description iOS 滚动 Bug 修复混入，解决侧边栏在 iOS 设备上的兼容问题
+ * @author D吕贺034244311
+ * @date 20260616
+ */
 export default {
   computed: {
     device() {
diff --git a/exam-vue/src/layout/components/Sidebar/Item.vue b/exam-vue/src/layout/components/Sidebar/Item.vue
index 45e772b..69df589 100644
--- a/exam-vue/src/layout/components/Sidebar/Item.vue
+++ b/exam-vue/src/layout/components/Sidebar/Item.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 侧边栏菜单项组件，递归渲染图标与标题
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <svg-icon v-if="icon" :icon-class="icon" />
   <span v-if="title">{{ title }}</span>
diff --git a/exam-vue/src/layout/components/Sidebar/Link.vue b/exam-vue/src/layout/components/Sidebar/Link.vue
index aaa1584..db1ecbe 100644
--- a/exam-vue/src/layout/components/Sidebar/Link.vue
+++ b/exam-vue/src/layout/components/Sidebar/Link.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 侧边栏链接组件，根据路由类型生成内部链接或外部链接
+  @author D吕贺034244311
+  @date 20260616
+-->
 
 <template>
   <a v-if="isExternal" :href="to" target="_blank" rel="noopener">
diff --git a/exam-vue/src/layout/components/Sidebar/Logo.vue b/exam-vue/src/layout/components/Sidebar/Logo.vue
index 45e89ec..25ef34a 100644
--- a/exam-vue/src/layout/components/Sidebar/Logo.vue
+++ b/exam-vue/src/layout/components/Sidebar/Logo.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 侧边栏 Logo 组件，展示系统标识与品牌图标
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <div :class="{'collapse':collapse}" class="sidebar-logo-container">
     <transition name="sidebarLogoFade">
diff --git a/exam-vue/src/layout/components/Sidebar/SidebarItem.vue b/exam-vue/src/layout/components/Sidebar/SidebarItem.vue
index e7bb332..5e6d271 100644
--- a/exam-vue/src/layout/components/Sidebar/SidebarItem.vue
+++ b/exam-vue/src/layout/components/Sidebar/SidebarItem.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 侧边栏菜单递归组件，支持多级嵌套菜单的渲染
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <div v-if="!item.hidden" class="menu-wrapper">
     <template v-if="hasOneShowingChild(item.children,item) && (!onlyOneChild.children||onlyOneChild.noShowingChildren)&&!item.alwaysShow">
diff --git a/exam-vue/src/layout/components/Sidebar/index.vue b/exam-vue/src/layout/components/Sidebar/index.vue
index 9b39a94..224d1ae 100644
--- a/exam-vue/src/layout/components/Sidebar/index.vue
+++ b/exam-vue/src/layout/components/Sidebar/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 侧边栏容器组件，管理导航菜单的渲染与折叠状态
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <div :class="{'has-logo':showLogo}">
     <logo v-if="showLogo" :collapse="isCollapse" />
diff --git a/exam-vue/src/layout/components/TagsView/ScrollPane.vue b/exam-vue/src/layout/components/TagsView/ScrollPane.vue
index 22aae24..5b0cfe7 100644
--- a/exam-vue/src/layout/components/TagsView/ScrollPane.vue
+++ b/exam-vue/src/layout/components/TagsView/ScrollPane.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 标签页横向滚动容器，支持鼠标滚轮与拖拽滚动
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <el-scrollbar ref="scrollContainer" :vertical="false" class="scroll-container" @wheel.prevent="handleScroll">
     <slot />
diff --git a/exam-vue/src/layout/components/TagsView/index.vue b/exam-vue/src/layout/components/TagsView/index.vue
index 9ab3191..b3578ba 100644
--- a/exam-vue/src/layout/components/TagsView/index.vue
+++ b/exam-vue/src/layout/components/TagsView/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 标签页导航视图，实现多页签切换与右键菜单操作
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <div id="tags-view-container" class="tags-view-container">
     <scroll-pane ref="scrollPane" class="tags-view-wrapper">
diff --git a/exam-vue/src/layout/components/index.js b/exam-vue/src/layout/components/index.js
index fa5558f..01bff53 100644
--- a/exam-vue/src/layout/components/index.js
+++ b/exam-vue/src/layout/components/index.js
@@ -1,3 +1,8 @@
+/**
+ * @description 布局子组件统一导出模块
+ * @author D吕贺034244311
+ * @date 20260616
+ */
 export { default as AppMain } from './AppMain.vue'
 export { default as Navbar } from './Navbar.vue'
 export { default as Settings } from './Settings/index.vue'
diff --git a/exam-vue/src/layout/index.vue b/exam-vue/src/layout/index.vue
index 72592c0..5b50991 100644
--- a/exam-vue/src/layout/index.vue
+++ b/exam-vue/src/layout/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 主布局组件，整合侧边栏、导航栏、标签页视图与主内容区
+  @author D吕贺034244311
+  @date 20260616
+-->
 <template>
   <div :class="classObj" class="app-wrapper">
     <div v-if="device==='mobile'&&sidebar.opened" class="drawer-bg" @click="handleClickOutside" />
diff --git a/exam-vue/src/layout/mixin/ResizeHandler.js b/exam-vue/src/layout/mixin/ResizeHandler.js
index 01a1cc7..a917228 100644
--- a/exam-vue/src/layout/mixin/ResizeHandler.js
+++ b/exam-vue/src/layout/mixin/ResizeHandler.js
@@ -1,3 +1,8 @@
+/**
+ * @description 窗口尺寸响应混入，自动切换侧边栏的展开/折叠状态
+ * @author D吕贺034244311
+ * @date 20260616
+ */
 import store from '@/store'
 
 const { body } = document
diff --git a/exam-vue/src/main.js b/exam-vue/src/main.js
index 2ca85f4..a14ea88 100644
--- a/exam-vue/src/main.js
+++ b/exam-vue/src/main.js
@@ -1,3 +1,8 @@
+/**
+ * @description Vue 应用入口，初始化 Vue 实例、注册全局插件与配置
+ * @author D吕贺034244311
+ * @date 20260615
+ */
 import { createApp } from 'vue'
 
 import Cookies from 'js-cookie'
diff --git a/exam-vue/src/permission.js b/exam-vue/src/permission.js
index 8482ab7..6154fd8 100644
--- a/exam-vue/src/permission.js
+++ b/exam-vue/src/permission.js
@@ -1,3 +1,8 @@
+/**
+ * @description 全局路由守卫，控制页面访问权限与动态路由加载
+ * @author D吕贺034244311
+ * @date 20260617
+ */
 import router from './router'
 import store from './store'
 import { ElMessage } from 'element-plus'
diff --git a/exam-vue/src/router/index.js b/exam-vue/src/router/index.js
index 4299f01..74bdac1 100644
--- a/exam-vue/src/router/index.js
+++ b/exam-vue/src/router/index.js
@@ -1,3 +1,8 @@
+/**
+ * @description 路由配置模块，定义应用所有页面的路由映射与导航守卫
+ * @author D吕贺034244311
+ * @date 20260620
+ */
 import { createRouter, createWebHashHistory } from 'vue-router'
 
 // 主要框架
diff --git a/exam-vue/src/settings.js b/exam-vue/src/settings.js
index 85572a2..faac3e0 100644
--- a/exam-vue/src/settings.js
+++ b/exam-vue/src/settings.js
@@ -1,3 +1,8 @@
+/**
+ * @description 全局应用配置，定义标题、主题、侧边栏、导航等基础设定
+ * @author D吕贺034244311
+ * @date 20260615
+ */
 export default {
   title: '图书管理系统-陈昊东',
 
diff --git a/exam-vue/src/store/getters.js b/exam-vue/src/store/getters.js
index 420e441..68b4e16 100644
--- a/exam-vue/src/store/getters.js
+++ b/exam-vue/src/store/getters.js
@@ -1,3 +1,8 @@
+/**
+ * @description Vuex 全局 Getters 定义，提供跨模块的便捷状态访问器
+ * @author D吕贺034244311
+ * @date 20260617
+ */
 const getters = {
   sidebar: state => state.app.sidebar,
   size: state => state.app.size,
diff --git a/exam-vue/src/store/index.js b/exam-vue/src/store/index.js
index 5b686fc..e5d9fd3 100644
--- a/exam-vue/src/store/index.js
+++ b/exam-vue/src/store/index.js
@@ -1,3 +1,8 @@
+/**
+ * @description Vuex Store 入口，注册所有状态模块并创建全局状态管理实例
+ * @author D吕贺034244311
+ * @date 20260617
+ */
 import { createStore } from 'vuex'
 import getters from './getters'
 
diff --git a/exam-vue/src/store/modules/app.js b/exam-vue/src/store/modules/app.js
index 45d89bb..3bf195c 100644
--- a/exam-vue/src/store/modules/app.js
+++ b/exam-vue/src/store/modules/app.js
@@ -1,3 +1,8 @@
+/**
+ * @description 应用状态模块，管理侧边栏折叠状态、设备类型等全局 UI 状态
+ * @author D吕贺034244311
+ * @date 20260617
+ */
 import Cookies from 'js-cookie'
 
 const state = {
diff --git a/exam-vue/src/store/modules/errorLog.js b/exam-vue/src/store/modules/errorLog.js
index 6b01f95..3a2d995 100644
--- a/exam-vue/src/store/modules/errorLog.js
+++ b/exam-vue/src/store/modules/errorLog.js
@@ -1,3 +1,8 @@
+/**
+ * @description 错误日志状态模块，存储与管理前端错误日志记录
+ * @author D吕贺034244311
+ * @date 20260617
+ */
 const state = {
   logs: []
 }
diff --git a/exam-vue/src/store/modules/permission.js b/exam-vue/src/store/modules/permission.js
index 65e00d4..fe93496 100644
--- a/exam-vue/src/store/modules/permission.js
+++ b/exam-vue/src/store/modules/permission.js
@@ -1,3 +1,8 @@
+/**
+ * @description 权限状态模块，根据用户角色动态生成可访问的路由列表
+ * @author D吕贺034244311
+ * @date 20260617
+ */
 import { asyncRoutes, constantRoutes } from '@/router'
 
 /**
diff --git a/exam-vue/src/store/modules/settings.js b/exam-vue/src/store/modules/settings.js
index fee1712..0ab25df 100644
--- a/exam-vue/src/store/modules/settings.js
+++ b/exam-vue/src/store/modules/settings.js
@@ -1,3 +1,8 @@
+/**
+ * @description 设置状态模块，管理主题色、布局模式等用户偏好设置
+ * @author D吕贺034244311
+ * @date 20260617
+ */
 import defaultSettings from '@/settings'
 import { fetchDetail } from '@/api/sys/config/config.js'
 
diff --git a/exam-vue/src/store/modules/tagsView.js b/exam-vue/src/store/modules/tagsView.js
index 57e7242..f8949b4 100644
--- a/exam-vue/src/store/modules/tagsView.js
+++ b/exam-vue/src/store/modules/tagsView.js
@@ -1,3 +1,8 @@
+/**
+ * @description 标签页状态模块，管理已打开页面标签的增删改查
+ * @author D吕贺034244311
+ * @date 20260617
+ */
 const state = {
   visitedViews: [],
   cachedViews: []
diff --git a/exam-vue/src/store/modules/user.js b/exam-vue/src/store/modules/user.js
index 4b940ad..7eb900c 100644
--- a/exam-vue/src/store/modules/user.js
+++ b/exam-vue/src/store/modules/user.js
@@ -1,3 +1,8 @@
+/**
+ * @description 用户状态模块，管理用户信息、Token、角色与登录/登出逻辑
+ * @author D吕贺034244311
+ * @date 20260617
+ */
 import { login, reg, logout, getInfo } from '@/api/user'
 import { initDict } from '@/api/sys/dict/dict'
 import { getToken, setToken, removeToken } from '@/utils/auth'
diff --git a/exam-vue/src/styles/btn.scss b/exam-vue/src/styles/btn.scss
index e6ba1a8..053eb11 100644
--- a/exam-vue/src/styles/btn.scss
+++ b/exam-vue/src/styles/btn.scss
@@ -1,3 +1,8 @@
+// ========================================
+// @description 按钮样式扩展，定义各类按钮变体的 SCSS 样式
+// @author D吕贺034244311
+// @date 20260615
+// ========================================
 @import './variables.scss';
 
 @mixin colorBtn($color) {
diff --git a/exam-vue/src/styles/element-ui.scss b/exam-vue/src/styles/element-ui.scss
index 955d3ca..64faa1a 100644
--- a/exam-vue/src/styles/element-ui.scss
+++ b/exam-vue/src/styles/element-ui.scss
@@ -1,3 +1,8 @@
+// ========================================
+// @description Element UI 组件样式覆盖与定制
+// @author D吕贺034244311
+// @date 20260615
+// ========================================
 // cover some element-ui styles
 
 .el-breadcrumb__inner,
diff --git a/exam-vue/src/styles/element-variables.scss b/exam-vue/src/styles/element-variables.scss
index 81f4d8b..fa0688d 100644
--- a/exam-vue/src/styles/element-variables.scss
+++ b/exam-vue/src/styles/element-variables.scss
@@ -1,3 +1,8 @@
+// ========================================
+// @description Element UI 主题变量定义，覆盖默认配色方案
+// @author D吕贺034244311
+// @date 20260615
+// ========================================
 /**
 * Element Plus theme variables
 **/
diff --git a/exam-vue/src/styles/index.scss b/exam-vue/src/styles/index.scss
index f67857c..fd8f4b5 100644
--- a/exam-vue/src/styles/index.scss
+++ b/exam-vue/src/styles/index.scss
@@ -1,3 +1,8 @@
+// ========================================
+// @description 全局样式入口，汇总引入所有 SCSS 样式模块
+// @author D吕贺034244311
+// @date 20260615
+// ========================================
 @import './variables.scss';
 @import './mixin.scss';
 @import './transition.scss';
diff --git a/exam-vue/src/styles/login.scss b/exam-vue/src/styles/login.scss
index 573d035..83d661d 100644
--- a/exam-vue/src/styles/login.scss
+++ b/exam-vue/src/styles/login.scss
@@ -1,3 +1,8 @@
+// ========================================
+// @description 登录页专属样式，定义登录界面布局与视觉效果
+// @author D吕贺034244311
+// @date 20260615
+// ========================================
 .login-box {
   width: 400px;
   background: #fff;
diff --git a/exam-vue/src/styles/mixin.scss b/exam-vue/src/styles/mixin.scss
index 06fa061..59459e9 100644
--- a/exam-vue/src/styles/mixin.scss
+++ b/exam-vue/src/styles/mixin.scss
@@ -1,3 +1,8 @@
+// ========================================
+// @description SCSS Mixin 集合，提供响应式断点、清除浮动等可复用混入
+// @author D吕贺034244311
+// @date 20260615
+// ========================================
 @mixin clearfix {
   &:after {
     content: "";
diff --git a/exam-vue/src/styles/sidebar.scss b/exam-vue/src/styles/sidebar.scss
index 3dad4c3..4ab55e7 100644
--- a/exam-vue/src/styles/sidebar.scss
+++ b/exam-vue/src/styles/sidebar.scss
@@ -1,3 +1,8 @@
+// ========================================
+// @description 侧边栏样式，定义导航菜单的展开、折叠与响应式布局
+// @author D吕贺034244311
+// @date 20260615
+// ========================================
 #app {
 
   .main-container {
diff --git a/exam-vue/src/styles/transition.scss b/exam-vue/src/styles/transition.scss
index ce4fdfb..54cfe46 100644
--- a/exam-vue/src/styles/transition.scss
+++ b/exam-vue/src/styles/transition.scss
@@ -1,3 +1,8 @@
+// ========================================
+// @description 过渡动画样式，定义页面切换、侧边栏展开等 CSS 过渡效果
+// @author D吕贺034244311
+// @date 20260615
+// ========================================
 // global transition css
 
 /* fade */
diff --git a/exam-vue/src/styles/variables-js.js b/exam-vue/src/styles/variables-js.js
index 44150f7..1b92bbb 100644
--- a/exam-vue/src/styles/variables-js.js
+++ b/exam-vue/src/styles/variables-js.js
@@ -1,3 +1,8 @@
+/**
+ * @description SCSS 变量 JS 导出模块，将样式变量桥接到 JavaScript 中使用
+ * @author D吕贺034244311
+ * @date 20260615
+ */
 // Variables exported as JS object for Vite compatibility
 // Original source: variables.scss :export block
 export default {
diff --git a/exam-vue/src/styles/variables.scss b/exam-vue/src/styles/variables.scss
index a19c27c..a9a8dfb 100644
--- a/exam-vue/src/styles/variables.scss
+++ b/exam-vue/src/styles/variables.scss
@@ -1,3 +1,8 @@
+// ========================================
+// @description 全局 SCSS 变量定义，包含颜色、尺寸、间距等设计令牌
+// @author D吕贺034244311
+// @date 20260615
+// ========================================
 // base color
 $blue:#324157;
 $light-blue:#3A71A8;
diff --git a/exam-vue/src/utils/auth.js b/exam-vue/src/utils/auth.js
index 08a43d6..c976051 100644
--- a/exam-vue/src/utils/auth.js
+++ b/exam-vue/src/utils/auth.js
@@ -1,3 +1,8 @@
+/**
+ * @description 认证工具函数，处理 Token 的读写与清除（基于 Cookies）
+ * @author D吕贺034244311
+ * @date 20260615
+ */
 import Cookies from 'js-cookie'
 
 const TokenKey = 'Admin-Token'
diff --git a/exam-vue/src/utils/clipboard.js b/exam-vue/src/utils/clipboard.js
index cf5b07a..ba581a1 100644
--- a/exam-vue/src/utils/clipboard.js
+++ b/exam-vue/src/utils/clipboard.js
@@ -1,3 +1,8 @@
+/**
+ * @description 剪贴板工具，封装文本复制到系统剪贴板的功能
+ * @author D吕贺034244311
+ * @date 20260615
+ */
 import Vue from 'vue'
 import Clipboard from 'clipboard'
 
diff --git a/exam-vue/src/utils/error-log.js b/exam-vue/src/utils/error-log.js
index 91bf432..c913a71 100644
--- a/exam-vue/src/utils/error-log.js
+++ b/exam-vue/src/utils/error-log.js
@@ -1,3 +1,8 @@
+/**
+ * @description 全局错误日志采集，捕获 JS 运行时异常与 Vue 组件错误
+ * @author D吕贺034244311
+ * @date 20260615
+ */
 import { getCurrentInstance } from 'vue'
 import store from '@/store'
 import { isString, isArray } from '@/utils/validate'
diff --git a/exam-vue/src/utils/get-page-title.js b/exam-vue/src/utils/get-page-title.js
index 0a34493..5cc9c1b 100644
--- a/exam-vue/src/utils/get-page-title.js
+++ b/exam-vue/src/utils/get-page-title.js
@@ -1,3 +1,8 @@
+/**
+ * @description 页面标题生成器，根据路由 meta 信息动态设置 document.title
+ * @author D吕贺034244311
+ * @date 20260615
+ */
 export default function getPageTitle(title, pageTitle) {
   if (pageTitle) {
     return `${pageTitle} - ${title}`
diff --git a/exam-vue/src/utils/index.js b/exam-vue/src/utils/index.js
index c233185..284469c 100644
--- a/exam-vue/src/utils/index.js
+++ b/exam-vue/src/utils/index.js
@@ -1,3 +1,8 @@
+/**
+ * @description 通用工具集，提供日期格式化、深拷贝、防抖、类型判断等基础函数
+ * @author D吕贺034244311
+ * @date 20260615
+ */
 /**
  * Created by PanJiaChen on 16/11/18.
  */
diff --git a/exam-vue/src/utils/open-window.js b/exam-vue/src/utils/open-window.js
index 1a655d7..c7a5e61 100644
--- a/exam-vue/src/utils/open-window.js
+++ b/exam-vue/src/utils/open-window.js
@@ -1,3 +1,8 @@
+/**
+ * @description 新窗口打开工具，封装 window.open 并处理兼容性
+ * @author D吕贺034244311
+ * @date 20260615
+ */
 /**
  *Created by PanJiaChen on 16/11/29.
  * @param {Sting} url
diff --git a/exam-vue/src/utils/path.js b/exam-vue/src/utils/path.js
index e0df47f..a2976f9 100644
--- a/exam-vue/src/utils/path.js
+++ b/exam-vue/src/utils/path.js
@@ -1,3 +1,8 @@
+/**
+ * @description 路径处理工具，提供路径拼接与解析功能
+ * @author D吕贺034244311
+ * @date 20260615
+ */
 /**
  * 简易路径解析工具，替代 Node.js path 模块（Vite 不提供 Node polyfill）
  * 用法: resolve('/sys', 'config') => '/sys/config'
diff --git a/exam-vue/src/utils/permission.js b/exam-vue/src/utils/permission.js
index 221d384..4d6d0c3 100644
--- a/exam-vue/src/utils/permission.js
+++ b/exam-vue/src/utils/permission.js
@@ -1,3 +1,8 @@
+/**
+ * @description 权限判断工具，校验当前用户是否拥有指定操作权限
+ * @author D吕贺034244311
+ * @date 20260615
+ */
 import store from '@/store'
 
 /**
diff --git a/exam-vue/src/utils/request.js b/exam-vue/src/utils/request.js
index cb74212..0786e78 100644
--- a/exam-vue/src/utils/request.js
+++ b/exam-vue/src/utils/request.js
@@ -1,3 +1,8 @@
+/**
+ * @description HTTP 请求封装，基于 axios 统一处理请求拦截、响应拦截与错误提示
+ * @author D吕贺034244311
+ * @date 20260615
+ */
 import axios from 'axios'
 import { ElMessageBox, ElMessage, ElLoading } from 'element-plus'
 import store from '@/store'
diff --git a/exam-vue/src/utils/scroll-to.js b/exam-vue/src/utils/scroll-to.js
index c5d8e04..62d59d1 100644
--- a/exam-vue/src/utils/scroll-to.js
+++ b/exam-vue/src/utils/scroll-to.js
@@ -1,3 +1,8 @@
+/**
+ * @description 平滑滚动工具，实现页面或元素的动画滚动效果
+ * @author D吕贺034244311
+ * @date 20260615
+ */
 Math.easeInOutQuad = function(t, b, c, d) {
   t /= d / 2
   if (t < 1) {
diff --git a/exam-vue/src/utils/validate.js b/exam-vue/src/utils/validate.js
index e32c6df..28380a8 100644
--- a/exam-vue/src/utils/validate.js
+++ b/exam-vue/src/utils/validate.js
@@ -1,3 +1,8 @@
+/**
+ * @description 表单验证工具集，提供邮箱、URL、手机号等正则校验函数
+ * @author D吕贺034244311
+ * @date 20260615
+ */
 /**
  * Created by PanJiaChen on 16/11/18.
  */
diff --git a/exam-vue/src/views/apply/input/index.vue b/exam-vue/src/views/apply/input/index.vue
index 01d541e..e6b07e5 100644
--- a/exam-vue/src/views/apply/input/index.vue
+++ b/exam-vue/src/views/apply/input/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 申请录入页面，实现申请信息的表单填写与提交
+  @author D吕贺034244311
+  @date 20260619
+-->
 <template>
   <div>
     <data-table ref="pagingTable" :options="options" :list-query="listQuery" @multi-actions="handleMultiAction">
diff --git a/exam-vue/src/views/dashboard/index.vue b/exam-vue/src/views/dashboard/index.vue
index 6a98e9b..b2b37df 100644
--- a/exam-vue/src/views/dashboard/index.vue
+++ b/exam-vue/src/views/dashboard/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 仪表盘首页，展示系统概览数据与快捷操作入口
+  @author D吕贺034244311
+  @date 20260620
+-->
 <template>
   <div class="app-container">
     <el-row :gutter="20">
diff --git a/exam-vue/src/views/error-log/components/ErrorTestA.vue b/exam-vue/src/views/error-log/components/ErrorTestA.vue
index 52654e0..b830517 100644
--- a/exam-vue/src/views/error-log/components/ErrorTestA.vue
+++ b/exam-vue/src/views/error-log/components/ErrorTestA.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 错误日志测试组件 A，用于模拟触发前端异常
+  @author D吕贺034244311
+  @date 20260620
+-->
 <template>
   <div>
     <!--error code-->
diff --git a/exam-vue/src/views/error-log/components/ErrorTestB.vue b/exam-vue/src/views/error-log/components/ErrorTestB.vue
index d796bee..ac5b7bf 100644
--- a/exam-vue/src/views/error-log/components/ErrorTestB.vue
+++ b/exam-vue/src/views/error-log/components/ErrorTestB.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 错误日志测试组件 B，用于模拟触发 Vue 组件渲染错误
+  @author D吕贺034244311
+  @date 20260620
+-->
 <template>
   <div />
 </template>
diff --git a/exam-vue/src/views/error-log/index.vue b/exam-vue/src/views/error-log/index.vue
index c1a20dd..4f935ad 100644
--- a/exam-vue/src/views/error-log/index.vue
+++ b/exam-vue/src/views/error-log/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 错误日志查看页面，展示前端运行时错误的详细信息
+  @author D吕贺034244311
+  @date 20260620
+-->
 <template>
   <div class="errPage-container">
     <ErrorA />
diff --git a/exam-vue/src/views/error-page/401.vue b/exam-vue/src/views/error-page/401.vue
index 81f82d1..4be0142 100644
--- a/exam-vue/src/views/error-page/401.vue
+++ b/exam-vue/src/views/error-page/401.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 401 未授权错误页面，展示无权限访问时的提示信息
+  @author D吕贺034244311
+  @date 20260620
+-->
 <template>
   <div class="errPage-container">
     <el-button class="pan-back-btn" @click="back">
diff --git a/exam-vue/src/views/error-page/404.vue b/exam-vue/src/views/error-page/404.vue
index 1791f55..4f47c4a 100644
--- a/exam-vue/src/views/error-page/404.vue
+++ b/exam-vue/src/views/error-page/404.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 404 页面未找到错误页，展示路由不存在时的提示与导航
+  @author D吕贺034244311
+  @date 20260620
+-->
 <template>
   <div class="wscn-http404-container">
     <div class="wscn-http404">
diff --git a/exam-vue/src/views/login/components/LoginLayout.vue b/exam-vue/src/views/login/components/LoginLayout.vue
index b5495b9..24bba83 100644
--- a/exam-vue/src/views/login/components/LoginLayout.vue
+++ b/exam-vue/src/views/login/components/LoginLayout.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 登录页布局组件，定义登录区域的背景与容器结构
+  @author D吕贺034244311
+  @date 20260617
+-->
 <template>
 
   <div class="login-container">
diff --git a/exam-vue/src/views/login/index.vue b/exam-vue/src/views/login/index.vue
index b8a4da2..0ef2e07 100644
--- a/exam-vue/src/views/login/index.vue
+++ b/exam-vue/src/views/login/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 登录页面，实现用户名密码登录表单与认证交互逻辑
+  @author D吕贺034244311
+  @date 20260617
+-->
 <template>
 
   <div>
diff --git a/exam-vue/src/views/login/register.vue b/exam-vue/src/views/login/register.vue
index c4aa6b2..a8a4c36 100644
--- a/exam-vue/src/views/login/register.vue
+++ b/exam-vue/src/views/login/register.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 用户注册页面，提供新用户的注册表单与提交逻辑
+  @author D吕贺034244311
+  @date 20260617
+-->
 <template>
   <div>
 
diff --git a/exam-vue/src/views/profile/components/Account.vue b/exam-vue/src/views/profile/components/Account.vue
index 2b7af52..7d32cca 100644
--- a/exam-vue/src/views/profile/components/Account.vue
+++ b/exam-vue/src/views/profile/components/Account.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 账号设置组件，实现密码修改与账号信息编辑
+  @author D吕贺034244311
+  @date 20260620
+-->
 <template>
   <el-form>
     <el-form-item label="用户名">
diff --git a/exam-vue/src/views/profile/components/UserCard.vue b/exam-vue/src/views/profile/components/UserCard.vue
index f877097..f97414a 100644
--- a/exam-vue/src/views/profile/components/UserCard.vue
+++ b/exam-vue/src/views/profile/components/UserCard.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 用户信息卡片组件，展示头像、昵称等个人资料摘要
+  @author D吕贺034244311
+  @date 20260620
+-->
 <template>
   <el-card style="margin-bottom:20px;">
     <template #header>
diff --git a/exam-vue/src/views/profile/index.vue b/exam-vue/src/views/profile/index.vue
index 41d6d03..ca5572e 100644
--- a/exam-vue/src/views/profile/index.vue
+++ b/exam-vue/src/views/profile/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 个人中心页面，展示当前用户的基本信息与操作入口
+  @author D吕贺034244311
+  @date 20260620
+-->
 <template>
   <div class="app-container">
     <div v-if="user">
diff --git a/exam-vue/src/views/redirect/index.vue b/exam-vue/src/views/redirect/index.vue
index 35e0960..780d086 100644
--- a/exam-vue/src/views/redirect/index.vue
+++ b/exam-vue/src/views/redirect/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 路由重定向中转页面，处理需要强制刷新的路由跳转
+  @author D吕贺034244311
+  @date 20260620
+-->
 <script>
 import { h } from 'vue'
 export default {
diff --git a/exam-vue/src/views/sys/bookgl/index.vue b/exam-vue/src/views/sys/bookgl/index.vue
index dcaf6e5..a62cf6d 100644
--- a/exam-vue/src/views/sys/bookgl/index.vue
+++ b/exam-vue/src/views/sys/bookgl/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 图书管理页面，实现图书信息的增删改查与列表展示
+  @author D吕贺034244311
+  @date 20260618
+-->
 
 <template>
 
diff --git a/exam-vue/src/views/sys/config/index.vue b/exam-vue/src/views/sys/config/index.vue
index aeb8fe7..f559df6 100644
--- a/exam-vue/src/views/sys/config/index.vue
+++ b/exam-vue/src/views/sys/config/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 系统配置页面，提供系统参数的查看与修改功能
+  @author D吕贺034244311
+  @date 20260618
+-->
 <template>
   <div class="app-container">
 
diff --git a/exam-vue/src/views/sys/dict/index.vue b/exam-vue/src/views/sys/dict/index.vue
index d477623..b3ba48d 100644
--- a/exam-vue/src/views/sys/dict/index.vue
+++ b/exam-vue/src/views/sys/dict/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 字典管理页面，维护系统数据字典的类型与键值对
+  @author D吕贺034244311
+  @date 20260618
+-->
 <template>
   <div>
     <data-table ref="pagingTypeTable" :options="typeOptions" :list-query="typeListQuery"
diff --git a/exam-vue/src/views/sys/gggl/index.vue b/exam-vue/src/views/sys/gggl/index.vue
index 5692f89..919073d 100644
--- a/exam-vue/src/views/sys/gggl/index.vue
+++ b/exam-vue/src/views/sys/gggl/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 公告管理页面，实现系统公告的发布、编辑与管理
+  @author D吕贺034244311
+  @date 20260618
+-->
 <!-- 毕业生信息管理-->
 <template>
 
diff --git a/exam-vue/src/views/sys/huanshu/index.vue b/exam-vue/src/views/sys/huanshu/index.vue
index 536f9ff..96ec1e6 100644
--- a/exam-vue/src/views/sys/huanshu/index.vue
+++ b/exam-vue/src/views/sys/huanshu/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 还书管理页面，处理图书归还操作与逾期校验
+  @author D吕贺034244311
+  @date 20260618
+-->
 <!-- 器材报修验收-->
 <!-- 库管员业务管理页面 这里操作报修验收  验收后设置状态为验收完成--><!--  管理员器材报修审核-->
 <template>
diff --git a/exam-vue/src/views/sys/jiehuanjilu/index.vue b/exam-vue/src/views/sys/jiehuanjilu/index.vue
index dc5a6b9..571d0f0 100644
--- a/exam-vue/src/views/sys/jiehuanjilu/index.vue
+++ b/exam-vue/src/views/sys/jiehuanjilu/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 借阅记录页面，展示图书借出与归还的历史记录
+  @author D吕贺034244311
+  @date 20260618
+-->
 
 <template>
 
diff --git a/exam-vue/src/views/sys/jieshu/index.vue b/exam-vue/src/views/sys/jieshu/index.vue
index 2f604f9..e9a7513 100644
--- a/exam-vue/src/views/sys/jieshu/index.vue
+++ b/exam-vue/src/views/sys/jieshu/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 借书管理页面，处理图书借出操作与库存校验
+  @author D吕贺034244311
+  @date 20260618
+-->
 
 <template>
 
diff --git a/exam-vue/src/views/sys/liuyangl/index.vue b/exam-vue/src/views/sys/liuyangl/index.vue
index 5cd4f55..8894df1 100644
--- a/exam-vue/src/views/sys/liuyangl/index.vue
+++ b/exam-vue/src/views/sys/liuyangl/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 留存量管理页面，管理图书的留存量设置与查询
+  @author D吕贺034244311
+  @date 20260618
+-->
 <!-- 毕业生信息管理-->
 <template>
 
diff --git a/exam-vue/src/views/sys/log/index.vue b/exam-vue/src/views/sys/log/index.vue
index 366764f..79f60e4 100644
--- a/exam-vue/src/views/sys/log/index.vue
+++ b/exam-vue/src/views/sys/log/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 系统日志页面，展示操作日志与系统运行日志列表
+  @author D吕贺034244311
+  @date 20260618
+-->
 <template>
 
   <div>
diff --git a/exam-vue/src/views/sys/role/index.vue b/exam-vue/src/views/sys/role/index.vue
index 522e8d5..abe349e 100644
--- a/exam-vue/src/views/sys/role/index.vue
+++ b/exam-vue/src/views/sys/role/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 角色管理页面，实现角色的创建、权限分配与列表管理
+  @author D吕贺034244311
+  @date 20260618
+-->
 <template>
 
   <div>
diff --git a/exam-vue/src/views/sys/stugggl/index.vue b/exam-vue/src/views/sys/stugggl/index.vue
index f0f5a62..1e760c2 100644
--- a/exam-vue/src/views/sys/stugggl/index.vue
+++ b/exam-vue/src/views/sys/stugggl/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 学生管理页面，实现学生信息的新增、编辑与查询管理
+  @author D吕贺034244311
+  @date 20260618
+-->
 <!-- 毕业生信息管理-->
 <template>
 
diff --git a/exam-vue/src/views/sys/stuliuyan/index.vue b/exam-vue/src/views/sys/stuliuyan/index.vue
index 6197cef..b6f8fa0 100644
--- a/exam-vue/src/views/sys/stuliuyan/index.vue
+++ b/exam-vue/src/views/sys/stuliuyan/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 学生留言管理页面，查看与管理学生的留言反馈
+  @author D吕贺034244311
+  @date 20260618
+-->
 <!-- 毕业生信息管理-->
 <template>
 
diff --git a/exam-vue/src/views/sys/user/index.vue b/exam-vue/src/views/sys/user/index.vue
index c88ec0a..c29b5ae 100644
--- a/exam-vue/src/views/sys/user/index.vue
+++ b/exam-vue/src/views/sys/user/index.vue
@@ -1,3 +1,8 @@
+<!--
+  @description 用户管理页面，实现用户账号的创建、编辑、禁用与权限配置
+  @author D吕贺034244311
+  @date 20260618
+-->
 <template>
 
   <div>