From e648e513402dc0fab82af16e54f5db1bb3fdda83 Mon Sep 17 00:00:00 2001
From: qian <wuchengqian5@163.com>
Date: Wed, 2 Sep 2026 22:47:21 +0800
Subject: [PATCH] =?UTF-8?q?feat(ui):=E7=AE=A1=E7=90=86=E5=90=8E=E5=8F=B0?=
 =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E6=96=87=E6=A1=A3=E7=BD=91=E7=AB=99=E5=85=A5?=
 =?UTF-8?q?=E5=8F=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 web/admin/src/views/AdminLayout.vue | 55 +++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)

diff --git a/web/admin/src/views/AdminLayout.vue b/web/admin/src/views/AdminLayout.vue
index b3a505a..e0e4ceb 100644
--- a/web/admin/src/views/AdminLayout.vue
+++ b/web/admin/src/views/AdminLayout.vue
@@ -34,6 +34,7 @@ import {
   IconLayers,
   IconHome,
   IconUser,
+  IconBook,
   IconCheckCircleFill,
 } from '@arco-design/web-vue/es/icon'
 import { useAuthStore } from '@/stores/auth'
@@ -690,6 +691,17 @@ onUnmounted(() => {
         </div>
 
         <div class="admin-header__right">
+          <!-- 帮助文档：新窗口打开文档站 -->
+          <a
+            class="admin-header__docs-btn"
+            href="https://docs.team-api.net"
+            target="_blank"
+            rel="noopener noreferrer"
+            title="帮助文档"
+          >
+            <IconBook class="admin-header__docs-icon" />
+            <span class="admin-header__docs-text">帮助文档</span>
+          </a>
           <div class="admin-header__user-wrapper" style="position: relative;">
             <div class="admin-header__user" @click.stop="toggleUserMenu">
               <div class="admin-header__avatar">{{ displayLabel.charAt(0) }}</div>
@@ -1144,6 +1156,49 @@ onUnmounted(() => {
   flex-shrink: 0;
 }
 
+/* ===== 帮助文档胶囊入口 ===== */
+.admin-header__docs-btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  height: 34px;
+  margin-right: 12px;
+  padding: 0 14px;
+  border: 1px solid var(--ta-border);
+  border-radius: 999px;
+  color: var(--ta-text-secondary);
+  font-size: 13px;
+  font-weight: 500;
+  text-decoration: none;
+  white-space: nowrap;
+  transition: all var(--ta-duration-fast) var(--ta-ease);
+}
+
+.admin-header__docs-btn:hover {
+  color: var(--ta-primary);
+  border-color: var(--ta-primary);
+  background: rgba(13, 148, 136, 0.06);
+}
+
+.admin-header__docs-icon {
+  flex-shrink: 0;
+  font-size: 15px;
+}
+
+/* 窄屏收起文字，退化为纯图标小胶囊（与右侧用户名在移动端隐藏的处理一致） */
+@media (max-width: 480px) {
+  .admin-header__docs-btn {
+    width: 34px;
+    padding: 0;
+    justify-content: center;
+    margin-right: 8px;
+  }
+
+  .admin-header__docs-text {
+    display: none;
+  }
+}
+
 .admin-header__user {
   display: flex;
   align-items: center;