📖 网盘超级说明书

💡 使用技巧

文件操作技巧

• 点击文件名或图标可打开文件详情弹窗
• 鼠标悬停在文件上会显示操作按钮
• 支持复选框批量选择文件

🔄 文件覆盖更新

• 功能说明：上传文件时，如果目标位置已存在同名文件，系统会弹出冲突处理对话框
• 冲突处理策略：
  • 更新（覆盖）：用新文件替换旧文件，旧文件内容将丢失
  • 跳过：保留原文件，跳过本次上传
  • 重命名：为新文件自动添加序号后缀（如 file(1).txt）
• 触发场景：
  • 拖拽上传时文件名冲突
  • 点击上传按钮上传同名文件
  • 批量上传时部分文件冲突

📁 新建文件夹和文件

• 新建文件夹：
  • 点击工具栏的「📁 新建文件夹」按钮
  • 在弹出的对话框中输入文件夹名称
  • 点击「创建」按钮完成创建
• 新建文件：
  • 点击工具栏的「📄 新建文件」按钮
  • 在弹出的对话框中输入文件名
  • 从下拉框选择常见后缀（.html, .txt, .css, .js, .json, .xml, .php, .md, .py）
  • 如果需要的格式不在列表中，可选择「其他」后手动输入后缀
  • 也可以直接在文件名中输入带后缀的名称（如 index.html）
  • 点击「创建」按钮完成创建
  • 创建成功后可选择立即编辑或稍后编辑
• 注意事项：
  • 文件夹/文件名称不能为空
  • 同一目录下不能有同名文件夹/文件
  • 支持中文文件名

📁 批量操作功能

• 批量选择：勾选文件前的复选框，可同时选择多个文件
• 批量删除：选择多个文件后，点击删除按钮一次性删除
• 合并为压缩包：选择多个文件后，点击「合并为压缩包」按钮，将选中文件打包下载
• 操作提示：顶部会显示已选择的文件数量

链接类型说明

• 下载链接：强制触发文件下载，URL 包含 api.php?action=download
• 原始链接：直接访问文件，由浏览器决定处理方式

快捷键

• 刷新页面：F5
• 打开新标签页：Ctrl+T
• 关闭当前标签页：Ctrl+W

📝 日志系统说明

📊 日志系统概述

本网盘系统配备完整的日志记录系统，用于追踪所有文件操作，便于系统维护和问题排查。

📁 日志文件类型

• upload_log.txt：记录所有文件上传操作，包括普通上传和分块上传
• operation_log.txt：记录除上传外的其他操作，如删除、重命名、新建等

📋 日志记录内容

🧹 日志自动清理机制

• 自动清理：每次写入日志时自动触发清理操作
• 保留天数：默认保留最近 30 天的日志
• 清理范围：同时清理 upload_log.txt 和 operation_log.txt
• 清理逻辑：根据日志中的 timestamp 字段判断是否超过保留期限

🔍 日志格式说明

所有日志均采用 JSON 格式存储，便于解析和查询：

{
    "timestamp": "2026-05-20 14:45:43",
    "operation": "create_file",
    "path": "documents/readme.txt",
    "server_os": "Linux/Unix",
    "php_version": "8.1.32",
    "remote_ip": "192.168.1.100",
    "user_agent": "Mozilla/5.0...",
    "success": true,
    "message": "文件创建成功",
    "file_size": 0
}
            

⚠️ 日志安全说明

• 日志文件包含客户端IP地址和浏览器信息
• 建议定期检查日志文件权限，确保只有管理员可访问
• 日志文件存储在网站根目录下，文件名以 .txt 结尾

🔧 核心逻辑说明

📁 文件路径处理逻辑

• 路径编码：所有文件路径使用 URL 编码处理，支持中文路径
• 路径格式：使用相对路径，基于 wp 目录
• 路径获取：通过 URL 参数传递，使用 urldecode 解码
• 安全处理：防止路径遍历攻击，限制在允许的目录范围内

🔌 API 调用流程

• 请求方式：GET 或 POST，根据操作类型决定
• 参数传递：通过 URL 参数或表单数据传递
• 响应格式：统一 JSON 格式，包含 success、message、data 字段
• 错误处理：统一的错误消息返回，便于前端处理

🔗 链接生成逻辑

• generateDirectLink：生成下载链接（强制下载）
• generateRawLink：生成原始链接（直接访问）
• basePath 计算：基于当前页面 URL 动态计算基础路径
• 特殊字符处理：路径中的特殊字符单独编码

👁️ 预览流程

1. 用户点击预览按钮
2. 前端根据预览类型生成对应的链接
3. 打开预览页面（preview.html 或直接访问）
4. 预览页面加载文件并显示
5. 新预览 API：无法预览时自动触发下载

✏️ 编辑流程

本网盘提供两个版本的编辑器，用户可以根据需求选择：

编辑器对比

编辑操作流程

1. 用户在文件列表或详情弹窗中点击编辑按钮
2. 选择编辑器版本：
   • ✨ 新版编辑器：打开 wz.html?path=文件路径（高级功能）
   • 🚀 升级版编辑器：打开 wz1.php?path=文件路径（现代化UI）
   • 📄 旧版编辑器：打开 wz.php?path=文件路径（简洁快速）
3. 编辑器调用 api.php?action=edit_file 读取文件内容
4. 用户编辑内容（新版支持语法高亮等高级功能）
5. 点击保存时调用 api.php?action=save_file 保存内容
6. 返回保存结果并更新界面
7. 编辑器之间可互相切换（点击工具栏中的切换按钮）：
   • wz.html ↔ wz1.php（新版与升级版互切）
   • wz1.php ↔ wz1.html（升级版与在线版互切）
   • wz1.php ↔ wz.php（升级版与旧版互切）

📤 上传流程

1. 用户点击上传按钮打开上传弹窗
2. 选择文件后通过 FormData 发送
3. 调用 api.php?action=upload 处理上传
4. 上传成功后刷新文件列表

🗑️ 删除流程

1. 用户点击删除按钮
2. 弹出确认对话框
3. 确认后调用 api.php?action=delete
4. 删除成功后刷新文件列表

📤 分块上传流程（核心功能）

分块上传是本网盘的核心功能之一，用于支持大文件上传。

前端分块逻辑

1. 文件选择：用户选择要上传的文件
2. 分块计算：根据文件大小计算分块数量，默认分块大小为 10MB
3. 生成唯一标识：创建 fileId（时间戳 + 随机数）用于标识本次上传
4. 逐块上传：循环切割文件，每块单独上传
5. 上传参数：每个分块包含 chunk（文件块）、fileName、chunkIndex、totalChunks、fileId、path
6. 调用接口：POST 请求 api.php?action=chunk_upload
7. 进度更新：实时显示上传进度和速度
8. 完成判断：根据返回的 completed 字段判断是否全部上传完成

后端合并逻辑

1. 接收分块：接收前端上传的分块数据
2. 临时存储：将每个分块保存到临时目录（temp/chunks/fileId/）
3. 记录状态：记录已上传的分块索引
4. 检查完整性：判断是否所有分块都已上传
5. 合并文件：如果所有分块都已上传，按顺序合并成完整文件
6. 移动文件：将合并后的文件移动到目标目录
7. 清理临时文件：删除临时分块文件
8. 返回结果：返回上传成功或失败的状态

分块上传的优势

• 支持大文件：突破 PHP 默认上传大小限制
• 断点续传：支持中断后继续上传（需额外实现）
• 容错性强：单个分块失败只需重新上传该块
• 进度可控：实时显示上传进度

关键参数说明