Initial commit with all files for baidu_drive_api

Dockerfile

@@ -0,0 +1,24 @@
+FROM python:3.9-slim
+
+WORKDIR /app
+
+# 安装依赖
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# 复制所有文件
+COPY . .
+
+# 设置环境变量
+ENV FUNUTIL_LOG_DISABLE=1
+ENV FUNUTIL_LOG_TO_FILE=0
+ENV PORT=7860
+
+# 暴露端口
+EXPOSE 7860
+
+# 设置启动脚本权限
+RUN chmod +x start.sh
+
+# 启动服务
+CMD ["/bin/bash", "start.sh"]

README.md

@@ -0,0 +1,93 @@
+# 百度网盘API服务
+
+这是一个基于Flask的百度网盘API服务，提供了百度网盘的主要功能的RESTful API接口。
+
+本服务支持两种模式：
+1. **真实模式**：如果环境中安装了fundrive[baidu]库，将使用真实的百度网盘API
+2. **模拟模式**：如果环境中没有安装fundrive[baidu]库，将使用模拟的API（仅用于演示）
+
+## 使用方法
+
+1. 在请求头中添加`X-Bduss`字段，值为百度网盘的BDUSS
+2. 调用相应的API端点
+
+## 获取BDUSS
+
+BDUSS可以从浏览器Cookie中获取：
+1. 登录百度网盘网页版
+2. 打开浏览器开发者工具（F12）
+3. 切换到"应用"或"Application"选项卡
+4. 在左侧找到"Cookies"，然后选择百度网盘的域名
+5. 在右侧找到名为"BDUSS"的Cookie，其值就是BDUSS
+
+## API端点
+
+### 1. 列出文件和目录
+
+```
+GET /api/files?path=/
+```
+
+### 2. 上传文件
+
+```
+POST /api/files
+```
+
+### 3. 获取文件的下载链接
+
+```
+GET /api/files/<file_path>
+```
+
+### 4. 删除文件
+
+```
+DELETE /api/files/<file_path>
+```
+
+### 5. 获取网盘配额信息
+
+```
+GET /api/quota
+```
+
+## 示例
+
+使用curl获取根目录文件列表：
+
+```bash
+curl -H "X-Bduss: YOUR_BDUSS_VALUE" https://your-space-name.hf.space/api/files
+```
+
+获取文件的下载链接：
+
+```bash
+curl -H "X-Bduss: YOUR_BDUSS_VALUE" https://your-space-name.hf.space/api/files/test.txt
+```
+
+## 注意事项
+
+1. BDUSS是敏感信息，请妥善保管，不要泄露给他人
+2. 下载链接的有效期较短，请尽快使用
+3. 服务默认限制上传文件大小为1GB
+
+## 当前服务状态
+
+本服务在Hugging Face上运行，可能会使用模拟模式。如果您需要使用真实的百度网盘API，可以将代码下载到本地运行。
+
+您可以通过访问 `/health` 端点来检查服务是否正常运行，以及当前使用的是真实模式还是模拟模式。
+
+## 源代码
+
+完整源代码和详细文档可在GitHub上获取：[百度网盘API服务](https://github.com/your-username/baidu-drive-api)
+
+## 关于模拟模式
+
+如果服务在模拟模式下运行，将会返回模拟的数据，而不是真实的百度网盘数据。这种模式下：
+
+1. 列出文件和目录将返回空列表
+2. 上传文件将返回成功，但实际上没有上传
+3. 获取下载链接将返回一个假的链接
+4. 删除文件将返回成功，但实际上没有删除
+5. 获取配额信息将返回固定的数据

app.py

@@ -0,0 +1,16 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+百度网盘API服务 - Hugging Face启动脚本
+"""
+
+# 导入应用程序
+from baidu_drive_api import app
+
+# 这个文件会被Hugging Face自动识别并运行
+if __name__ == "__main__":
+    # 使用环境变量中的端口（如果有），否则使用7860（Hugging Face的默认端口）
+    import os
+    port = int(os.environ.get('PORT', 7860))
+    app.run(host='0.0.0.0', port=port)

baidu_drive_api.py

@@ -0,0 +1,372 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+百度网盘HTTP API服务
+提供百度网盘功能的RESTful API接口
+"""
+
+import os
+import time
+import json
+import logging
+import tempfile
+import traceback
+from flask import Flask, request, jsonify, send_file, Response, send_from_directory
+from werkzeug.utils import secure_filename
+from functools import wraps
+
+# 设置HOME环境变量（如果不存在）
+if 'HOME' not in os.environ:
+    os.environ['HOME'] = os.environ.get('USERPROFILE', '')
+    print(f"已设置HOME环境变量为: {os.environ['HOME']}")
+
+# 禁用funutil库创建logsdir
+# 使用猴子补丁来防止os.makedirs创建'logs'目录
+original_makedirs = os.makedirs
+def patched_makedirs(name, *args, **kwargs):
+    if name == 'logs' or name.startswith('logs/'):
+        print(f"[警告] 已拦截对{name}目录的创建尝试")
+        return
+    return original_makedirs(name, *args, **kwargs)
+os.makedirs = patched_makedirs
+
+# 拦截文件打开操作
+original_open = open
+def patched_open(file, *args, **kwargs):
+    if file.startswith('logs/') or file == 'logs':
+        print(f"[警告] 已拦截对{file}文件的打开尝试")
+        # 创建一个内存中的空文件对象
+        import io
+        return io.StringIO()
+    return original_open(file, *args, **kwargs)
+open = patched_open
+
+# 禁用日志文件写入
+# 设置环境变量来尝试禁用日志文件
+os.environ['FUNUTIL_LOG_DISABLE'] = '1'
+os.environ['FUNUTIL_LOG_TO_FILE'] = '0'
+
+# 导入百度网盘API
+try:
+    print("尝试导入真实BaiDuDrive...")
+    from fundrive.drives.baidu.drive import BaiDuDrive
+    print("成功导入真实BaiDuDrive")
+    USE_REAL_API = True
+except Exception as e:
+    print(f"导入真实BaiDuDrive失败: {e}")
+    print("将使用模拟的BaiDuDrive类")
+
+    # 模拟百度网盘API
+    class BaiDuDrive:
+        def __init__(self):
+            self.drive = self
+            self.bduss = None
+            self.ptoken = None
+            print("创建了模拟的BaiDuDrive实例")
+
+        def login(self, bduss=None):
+            self.bduss = bduss
+            self.ptoken = "fake_ptoken"
+            print(f"模拟登录成功，bduss: {bduss[:10] if bduss else None}...")
+            return True
+
+        def get_file_list(self, path="/"):
+            print(f"模拟获取文件列表，路径: {path}")
+            return []
+
+        def get_dir_list(self, path="/"):
+            print(f"模拟获取目录列表，路径: {path}")
+            return []
+
+        def upload_file(self, local_path, remote_path):
+            print(f"模拟上传文件，本地路径: {local_path}，远程路径: {remote_path}")
+            return True
+
+        def delete(self, path):
+            print(f"模拟删除文件，路径: {path}")
+            return True
+
+        def get_quota(self):
+            print("模拟获取配额信息")
+            return {"total": 2199023255552, "used": 1073741824}
+
+        def download_link(self, path):
+            print(f"模拟获取下载链接，路径: {path}")
+            return "https://example.com/fake_download_link"
+
+    USE_REAL_API = False
+    print("成功创建模拟的BaiDuDrive类")
+
+# 配置日志 - 只输出到控制台
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
+    handlers=[
+        logging.StreamHandler()
+    ]
+)
+logger = logging.getLogger(__name__)
+
+app = Flask(__name__, static_folder='static')
+app.config['MAX_CONTENT_LENGTH'] = 1024 * 1024 * 1024  # 限制上传文件大小为1GB
+app.config['UPLOAD_FOLDER'] = tempfile.gettempdir()  # 使用临时目录存储上传的文件
+
+# 存储BDUSS和客户端实例的字典
+clients = {}
+
+# 身份验证装饰器
+def require_bduss(f):
+    @wraps(f)
+    def decorated(*args, **kwargs):
+        bduss = request.headers.get('X-Bduss')
+        if not bduss:
+            return jsonify({"error": "未提供BDUSS，请在请求头中添加X-Bduss"}), 401
+
+        # 检查是否已有客户端实例
+        if bduss not in clients:
+            try:
+                client = BaiDuDrive()
+                login_result = client.login(bduss=bduss)
+                if not login_result:
+                    return jsonify({"error": "BDUSS无效或已过期"}), 401
+                clients[bduss] = client
+                logger.info(f"创建新的客户端实例，BDUSS: {bduss[:10]}...")
+            except Exception as e:
+                logger.error(f"创建客户端实例失败: {str(e)}")
+                return jsonify({"error": f"创建客户端实例失败: {str(e)}"}), 500
+
+        # 将客户端实例传递给视图函数
+        return f(clients[bduss], *args, **kwargs)
+    return decorated
+
+@app.route('/')
+def index():
+    """API首页，显示简单的使用说明"""
+    # 如果存在static/index.html，则返回它
+    if os.path.exists(os.path.join(app.static_folder, 'index.html')):
+        return send_from_directory(app.static_folder, 'index.html')
+
+    # 否则返回JSON数据
+    return jsonify({
+        "name": "百度网盘API服务",
+        "version": "1.0.0",
+        "description": "提供百度网盘功能的RESTful API接口",
+        "endpoints": [
+            {"path": "/api/files", "method": "GET", "description": "列出文件和目录"},
+            {"path": "/api/files", "method": "POST", "description": "上传文件"},
+            {"path": "/api/files/<path:file_path>", "method": "GET", "description": "获取文件的下载链接"},
+            {"path": "/api/files/<path:file_path>", "method": "DELETE", "description": "删除文件"},
+            {"path": "/api/quota", "method": "GET", "description": "获取网盘配额信息"}
+        ],
+        "authentication": "在请求头中添加X-Bduss字段，值为百度网盘的BDUSS"
+    })
+
+@app.route('/api/files')
+@require_bduss
+def list_files(client):
+    """列出文件和目录"""
+    path = request.args.get('path', '/')
+
+    try:
+        # 获取文件列表
+        file_list = client.get_file_list(path)
+        # 获取目录列表
+        dir_list = client.get_dir_list(path)
+
+        # 合并文件和目录列表
+        all_items = []
+
+        # 处理目录
+        for item in dir_list:
+            item_data = {
+                "name": item.name if hasattr(item, 'name') else "未知",
+                "path": item.path if hasattr(item, 'path') else path + "/" + item.name,
+                "type": "directory",
+                "size": item.size if hasattr(item, 'size') else 0,
+                "size_formatted": f"{item.size / (1024 * 1024):.2f} MB" if hasattr(item, 'size') else "0.00 MB"
+            }
+            all_items.append(item_data)
+
+        # 处理文件
+        for item in file_list:
+            item_data = {
+                "name": item.name if hasattr(item, 'name') else "未知",
+                "path": item.path if hasattr(item, 'path') else path + "/" + item.name,
+                "type": "file",
+                "size": item.size if hasattr(item, 'size') else 0,
+                "size_formatted": f"{item.size / (1024 * 1024):.2f} MB" if hasattr(item, 'size') else "0.00 MB"
+            }
+            all_items.append(item_data)
+
+        return jsonify({
+            "path": path,
+            "items": all_items,
+            "total": len(all_items)
+        })
+    except Exception as e:
+        logger.error(f"列出文件时出错: {str(e)}\n{traceback.format_exc()}")
+        return jsonify({"error": f"列出文件时出错: {str(e)}"}), 500
+
+@app.route('/api/files', methods=['POST'])
+@require_bduss
+def upload_file(client):
+    """上传文件"""
+    if 'file' not in request.files:
+        return jsonify({"error": "未提供文件"}), 400
+
+    file = request.files['file']
+    if file.filename == '':
+        return jsonify({"error": "未选择文件"}), 400
+
+    remote_path = request.form.get('path', '/')
+    if not remote_path.endswith('/'):
+        remote_path += '/'
+
+    try:
+        # 保存上传的文件到临时目录
+        filename = secure_filename(file.filename)
+        temp_path = os.path.join(app.config['UPLOAD_FOLDER'], filename)
+        file.save(temp_path)
+
+        # 上传文件到百度网盘
+        remote_file_path = f"{remote_path}{filename}"
+        upload_result = client.upload_file(temp_path, remote_file_path)
+
+        # 删除临时文件
+        os.remove(temp_path)
+
+        if upload_result:
+            return jsonify({
+                "success": True,
+                "message": f"文件 {filename} 上传成功",
+                "path": remote_file_path
+            })
+        else:
+            return jsonify({
+                "success": False,
+                "error": f"文件 {filename} 上传失败"
+            }), 500
+    except Exception as e:
+        logger.error(f"上传文件时出错: {str(e)}\n{traceback.format_exc()}")
+        # 确保临时文件被删除
+        if os.path.exists(temp_path):
+            os.remove(temp_path)
+        return jsonify({"error": f"上传文件时出错: {str(e)}"}), 500
+
+@app.route('/api/files/<path:file_path>')
+@require_bduss
+def get_download_link(client, file_path):
+    """获取文件的下载链接"""
+    try:
+        # 确保文件路径以/开头
+        if not file_path.startswith('/'):
+            file_path = '/' + file_path
+
+        # 获取文件名
+        filename = os.path.basename(file_path)
+
+        # 使用底层API获取下载链接
+        try:
+            download_link = client.drive.download_link(file_path)
+
+            # 生成完整的下载信息
+            headers = {
+                "User-Agent": "softxm;netdisk",
+                "Connection": "Keep-Alive",
+                "Cookie": f"BDUSS={client.drive.bduss};ptoken={client.drive.ptoken}",
+            }
+
+            return jsonify({
+                "success": True,
+                "filename": filename,
+                "download_link": download_link,
+                "headers": headers,
+                "message": "下载链接获取成功",
+                "note": "注意：下载链接有效期较短，请尽快使用"
+            })
+        except Exception as e:
+            return jsonify({"error": f"获取下载链接失败: {str(e)}"}), 500
+    except Exception as e:
+        logger.error(f"获取下载链接时出错: {str(e)}\n{traceback.format_exc()}")
+        return jsonify({"error": f"获取下载链接时出错: {str(e)}"}), 500
+
+@app.route('/api/files/<path:file_path>', methods=['DELETE'])
+@require_bduss
+def delete_file(client, file_path):
+    """删除文件"""
+    try:
+        # 确保文件路径以/开头
+        if not file_path.startswith('/'):
+            file_path = '/' + file_path
+
+        # 删除文件
+        delete_result = client.delete(file_path)
+
+        if delete_result is None or delete_result:
+            return jsonify({
+                "success": True,
+                "message": f"文件 {file_path} 删除成功"
+            })
+        else:
+            return jsonify({
+                "success": False,
+                "error": f"文件 {file_path} 删除失败"
+            }), 500
+    except Exception as e:
+        logger.error(f"删除文件时出错: {str(e)}\n{traceback.format_exc()}")
+        return jsonify({"error": f"删除文件时出错: {str(e)}"}), 500
+
+@app.route('/api/quota')
+@require_bduss
+def get_quota(client):
+    """获取网盘配额信息"""
+    try:
+        # 获取配额信息
+        quota_info = client.get_quota()
+
+        if quota_info:
+            total_space = quota_info.get('total', 0) / (1024 * 1024 * 1024)  # 转换为GB
+            used_space = quota_info.get('used', 0) / (1024 * 1024 * 1024)    # 转换为GB
+
+            return jsonify({
+                "total": quota_info.get('total', 0),
+                "used": quota_info.get('used', 0),
+                "free": quota_info.get('total', 0) - quota_info.get('used', 0),
+                "total_formatted": f"{total_space:.2f} GB",
+                "used_formatted": f"{used_space:.2f} GB",
+                "free_formatted": f"{total_space - used_space:.2f} GB"
+            })
+        else:
+            return jsonify({"error": "获取配额信息失败"}), 500
+    except Exception as e:
+        logger.error(f"获取配额信息时出错: {str(e)}\n{traceback.format_exc()}")
+        return jsonify({"error": f"获取配额信息时出错: {str(e)}"}), 500
+
+@app.errorhandler(404)
+def not_found(error):
+    return jsonify({"error": "资源不存在"}), 404
+
+@app.errorhandler(500)
+def server_error(error):
+    return jsonify({"error": "服务器内部错误"}), 500
+
+@app.errorhandler(413)
+def request_entity_too_large(error):
+    return jsonify({"error": "上传的文件太大"}), 413
+
+# 添加健康检查端点
+@app.route('/health')
+def health_check():
+    mode = "real" if 'USE_REAL_API' in globals() and USE_REAL_API else "mock"
+    return jsonify({
+        "status": "ok",
+        "message": "Service is running",
+        "mode": mode,
+        "description": "使用真实百度网盘API" if mode == "real" else "使用模拟百度网盘API（仅用于演示）"
+    })
+
+if __name__ == '__main__':
+    # 使用环境变量中的端口（如果有），否则使用7860（Hugging Face的默认端口）
+    port = int(os.environ.get('PORT', 7860))
+    app.run(host='0.0.0.0', port=port, debug=True)

healthcheck.py

@@ -0,0 +1,44 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+百度网盘API服务健康检查脚本
+用于Hugging Face检查服务是否正常运行
+"""
+
+import os
+import sys
+import time
+import requests
+
+def check_health():
+    """检查服务是否正常运行"""
+    port = os.environ.get('PORT', 7860)
+    url = f"http://localhost:{port}/health"
+    
+    # 尝试连接服务
+    max_retries = 10
+    retry_interval = 3  # 秒
+    
+    for i in range(max_retries):
+        try:
+            response = requests.get(url, timeout=5)
+            if response.status_code == 200:
+                data = response.json()
+                if data.get('status') == 'ok':
+                    print(f"服务正常运行: {data}")
+                    return True
+            print(f"服务返回异常状态码: {response.status_code}")
+        except Exception as e:
+            print(f"尝试 {i+1}/{max_retries} 连接服务失败: {e}")
+        
+        if i < max_retries - 1:
+            print(f"等待 {retry_interval} 秒后重试...")
+            time.sleep(retry_interval)
+    
+    print("健康检查失败，服务可能未正常运行")
+    return False
+
+if __name__ == "__main__":
+    success = check_health()
+    sys.exit(0 if success else 1)

requirements.txt

@@ -0,0 +1,6 @@
+flask==2.0.1
+requests==2.26.0
+werkzeug==2.0.1
+gunicorn==20.1.0
+python-dotenv==0.19.1
+fundrive[baidu]

start.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+
+# 设置环境变量
+export FUNUTIL_LOG_DISABLE=1
+export FUNUTIL_LOG_TO_FILE=0
+export PORT=7860
+
+# 创建一个空的logs目录，防止fundrive库尝试创建它时失败
+mkdir -p logs
+touch logs/.gitignore
+
+# 启动服务
+gunicorn --bind 0.0.0.0:7860 --timeout 120 --workers 1 baidu_drive_api:app

static/index.html

@@ -0,0 +1,239 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>百度网盘API服务</title>
+    <style>
+        body {
+            font-family: Arial, sans-serif;
+            line-height: 1.6;
+            max-width: 800px;
+            margin: 0 auto;
+            padding: 20px;
+            color: #333;
+        }
+        h1, h2, h3 {
+            color: #1a73e8;
+        }
+        code {
+            background-color: #f5f5f5;
+            padding: 2px 5px;
+            border-radius: 3px;
+            font-family: monospace;
+        }
+        pre {
+            background-color: #f5f5f5;
+            padding: 10px;
+            border-radius: 5px;
+            overflow-x: auto;
+        }
+        .endpoint {
+            margin-bottom: 30px;
+            border-left: 3px solid #1a73e8;
+            padding-left: 15px;
+        }
+        .method {
+            display: inline-block;
+            padding: 3px 8px;
+            border-radius: 3px;
+            color: white;
+            font-weight: bold;
+            margin-right: 10px;
+        }
+        .get {
+            background-color: #4CAF50;
+        }
+        .post {
+            background-color: #2196F3;
+        }
+        .delete {
+            background-color: #F44336;
+        }
+        .status {
+            margin-top: 20px;
+            padding: 15px;
+            border-radius: 5px;
+            background-color: #f8f9fa;
+            border: 1px solid #ddd;
+        }
+        .status.loading {
+            background-color: #fff3cd;
+            border-color: #ffeeba;
+        }
+        .status.success {
+            background-color: #d4edda;
+            border-color: #c3e6cb;
+        }
+        .status.error {
+            background-color: #f8d7da;
+            border-color: #f5c6cb;
+        }
+        button {
+            background-color: #1a73e8;
+            color: white;
+            border: none;
+            padding: 8px 15px;
+            border-radius: 4px;
+            cursor: pointer;
+            font-size: 14px;
+        }
+        button:hover {
+            background-color: #0d62c9;
+        }
+        input[type="text"] {
+            padding: 8px;
+            border: 1px solid #ddd;
+            border-radius: 4px;
+            width: 300px;
+            font-size: 14px;
+        }
+    </style>
+</head>
+<body>
+    <h1>百度网盘API服务</h1>
+    
+    <div class="status" id="serviceStatus">
+        <p>正在检查服务状态...</p>
+    </div>
+
+    <p>这是一个基于Flask的百度网盘API服务，提供了百度网盘的主要功能的RESTful API接口。</p>
+    
+    <h2>使用方法</h2>
+    <p>1. 在请求头中添加<code>X-Bduss</code>字段，值为百度网盘的BDUSS</p>
+    <p>2. 调用相应的API端点</p>
+    
+    <h2>获取BDUSS</h2>
+    <p>BDUSS可以从浏览器Cookie中获取：</p>
+    <ol>
+        <li>登录百度网盘网页版</li>
+        <li>打开浏览器开发者工具（F12）</li>
+        <li>切换到"应用"或"Application"选项卡</li>
+        <li>在左侧找到"Cookies"，然后选择百度网盘的域名</li>
+        <li>在右侧找到名为"BDUSS"的Cookie，其值就是BDUSS</li>
+    </ol>
+    
+    <h2>API端点</h2>
+    
+    <div class="endpoint">
+        <h3><span class="method get">GET</span> /api/files</h3>
+        <p>列出指定路径下的文件和目录</p>
+        <p><strong>参数：</strong> <code>path</code> - 要列出内容的路径，默认为根目录（/）</p>
+        <pre><code>curl -H "X-Bduss: YOUR_BDUSS_VALUE" https://your-space-name.hf.space/api/files?path=/</code></pre>
+    </div>
+    
+    <div class="endpoint">
+        <h3><span class="method post">POST</span> /api/files</h3>
+        <p>上传文件到指定路径</p>
+        <p><strong>参数：</strong></p>
+        <ul>
+            <li><code>file</code> - 要上传的文件（multipart/form-data）</li>
+            <li><code>path</code> - 远程目录路径，默认为根目录（/）</li>
+        </ul>
+        <pre><code>curl -H "X-Bduss: YOUR_BDUSS_VALUE" -F "file=@local_file.txt" -F "path=/" https://your-space-name.hf.space/api/files</code></pre>
+    </div>
+    
+    <div class="endpoint">
+        <h3><span class="method get">GET</span> /api/files/&lt;file_path&gt;</h3>
+        <p>获取文件的下载链接</p>
+        <pre><code>curl -H "X-Bduss: YOUR_BDUSS_VALUE" https://your-space-name.hf.space/api/files/test.txt</code></pre>
+    </div>
+    
+    <div class="endpoint">
+        <h3><span class="method delete">DELETE</span> /api/files/&lt;file_path&gt;</h3>
+        <p>删除指定路径的文件</p>
+        <pre><code>curl -X DELETE -H "X-Bduss: YOUR_BDUSS_VALUE" https://your-space-name.hf.space/api/files/test.txt</code></pre>
+    </div>
+    
+    <div class="endpoint">
+        <h3><span class="method get">GET</span> /api/quota</h3>
+        <p>获取网盘配额信息</p>
+        <pre><code>curl -H "X-Bduss: YOUR_BDUSS_VALUE" https://your-space-name.hf.space/api/quota</code></pre>
+    </div>
+    
+    <h2>测试API</h2>
+    <p>输入您的BDUSS值，然后点击按钮测试API：</p>
+    <div>
+        <input type="text" id="bdussInput" placeholder="输入您的BDUSS值">
+        <button onclick="testAPI()">测试API</button>
+    </div>
+    <div class="status" id="testResult" style="display: none;"></div>
+    
+    <h2>注意事项</h2>
+    <ol>
+        <li>BDUSS是敏感信息，请妥善保管，不要泄露给他人</li>
+        <li>下载链接的有效期较短，请尽快使用</li>
+        <li>服务默认限制上传文件大小为1GB</li>
+    </ol>
+    
+    <script>
+        // 检查服务状态
+        async function checkServiceStatus() {
+            const statusDiv = document.getElementById('serviceStatus');
+            statusDiv.className = 'status loading';
+            statusDiv.innerHTML = '<p>正在检查服务状态...</p>';
+            
+            try {
+                const response = await fetch('/health');
+                const data = await response.json();
+                
+                if (data.status === 'ok') {
+                    statusDiv.className = 'status success';
+                    statusDiv.innerHTML = `
+                        <p><strong>服务状态：</strong> 正常运行</p>
+                        <p><strong>运行模式：</strong> ${data.mode === 'real' ? '真实模式' : '模拟模式'}</p>
+                        <p><strong>描述：</strong> ${data.description}</p>
+                    `;
+                } else {
+                    statusDiv.className = 'status error';
+                    statusDiv.innerHTML = '<p><strong>服务状态：</strong> 异常</p>';
+                }
+            } catch (error) {
+                statusDiv.className = 'status error';
+                statusDiv.innerHTML = `<p><strong>服务状态：</strong> 无法连接到服务 (${error.message})</p>`;
+            }
+        }
+        
+        // 测试API
+        async function testAPI() {
+            const bduss = document.getElementById('bdussInput').value.trim();
+            const resultDiv = document.getElementById('testResult');
+            
+            if (!bduss) {
+                resultDiv.className = 'status error';
+                resultDiv.style.display = 'block';
+                resultDiv.innerHTML = '<p>请输入BDUSS值</p>';
+                return;
+            }
+            
+            resultDiv.className = 'status loading';
+            resultDiv.style.display = 'block';
+            resultDiv.innerHTML = '<p>正在测试API...</p>';
+            
+            try {
+                const response = await fetch('/api/files', {
+                    headers: {
+                        'X-Bduss': bduss
+                    }
+                });
+                
+                const data = await response.json();
+                
+                resultDiv.className = 'status success';
+                resultDiv.innerHTML = `
+                    <p><strong>API测试结果：</strong> 成功</p>
+                    <p><strong>路径：</strong> ${data.path}</p>
+                    <p><strong>文件/文件夹数量：</strong> ${data.total}</p>
+                    <pre>${JSON.stringify(data, null, 2)}</pre>
+                `;
+            } catch (error) {
+                resultDiv.className = 'status error';
+                resultDiv.innerHTML = `<p><strong>API测试失败：</strong> ${error.message}</p>`;
+            }
+        }
+        
+        // 页面加载时检查服务状态
+        window.onload = checkServiceStatus;
+    </script>
+</body>
+</html>