From 76ae3cbb5a138f75b546d7c75017f1083188153a Mon Sep 17 00:00:00 2001
From: Jowe <123822645+Selei1983@users.noreply.github.com>
Date: Mon, 23 Mar 2026 23:19:48 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E6=B7=BB=E5=8A=A0=20API=20=E5=AF=86?=
 =?UTF-8?q?=E9=92=A5=E8=8F=9C=E5=8D=95=E5=92=8C=E6=96=87=E6=A1=A3=E9=93=BE?=
 =?UTF-8?q?=E6=8E=A5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 侧边栏添加 API 密钥菜单项
- API 密钥列表页添加 API 文档链接
- 添加 /docs/ 路由服务文档文件

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 app.py                                  |  9 +++++++++
 templates/admin/apikey/list.html        | 22 +++++++++++++++++++++-
 templates/admin/components/sidebar.html |  6 ++++++
 3 files changed, 36 insertions(+), 1 deletion(-)

diff --git a/app.py b/app.py
index f9631d8..1a0ec9b 100644
--- a/app.py
+++ b/app.py
@@ -83,6 +83,15 @@ def create_app(config_name='default'):
             return AdminModel.query.get(int(user_id))
         return None
 
+    # ========== 文档路由 ==========
+    @app.route('/docs/<path:filename>')
+    def serve_doc(filename):
+        """服务文档文件"""
+        from flask import send_from_directory
+        import os
+        docs_dir = os.path.join(os.path.dirname(os.path.abspath(__file__)), 'docs')
+        return send_from_directory(docs_dir, filename)
+
     # ========== 前台路由 ==========
     @app.route('/')
     def index():
diff --git a/templates/admin/apikey/list.html b/templates/admin/apikey/list.html
index 933de83..0957962 100644
--- a/templates/admin/apikey/list.html
+++ b/templates/admin/apikey/list.html
@@ -1,6 +1,6 @@
 {% extends 'admin/model/list.html' %}
 
-{% block tail %}
+{% block head_css %}
 {{ super() }}
 <style>
     .api-key-cell {
@@ -13,5 +13,25 @@
     .api-key-masked {
         color: #6c757d;
     }
+    .api-doc-link {
+        margin-bottom: 15px;
+    }
+    .api-doc-link a {
+        color: #007bff;
+        text-decoration: none;
+    }
+    .api-doc-link a:hover {
+        text-decoration: underline;
+    }
 </style>
+{% endblock %}
+
+{% block list_cards %}
+{{ super() }}
+<div class="api-doc-link">
+    <a href="{{ url_for('serve_doc', filename='API_DOC.md') }}" target="_blank">
+        <span class="material-symbols-outlined" style="vertical-align: middle;">description</span>
+        查看 API 文档
+    </a>
+</div>
 {% endblock %}
\ No newline at end of file
diff --git a/templates/admin/components/sidebar.html b/templates/admin/components/sidebar.html
index 1455420..3877f40 100644
--- a/templates/admin/components/sidebar.html
+++ b/templates/admin/components/sidebar.html
@@ -47,6 +47,12 @@
                         <span class="nav-text">管理员</span>
                     </a>
                 </li>
+                <li class="nav-item {% if active_page == 'api_key' %}active{% endif %}">
+                    <a href="{{ url_for('api_keys.index_view') }}" class="nav-link">
+                        <span class="material-symbols-outlined nav-icon">key</span>
+                        <span class="nav-text">API密钥</span>
+                    </a>
+                </li>
             </ul>
         </div>