MyWebDrive 使用指南

这套指南覆盖什么

MyWebDrive 是文件存储与分发平台。Core 管理身份、文件元数据、上传意图、配额、分享和发布；Storage 负责对象传输和后台处理；Next.js 页面经同源 Nginx 访问 API。旧拆分式 Auth、User、Metadata、Sharing、Gateway 已软退役，旧文档里的启动和迁移命令不适用于当前主线。

这些说明在 2026-09-07 对照公开主分支源码、公共 OpenAPI、组件和测试编写。源项目采用 MIT 许可证。仓库仍有未完成的历史敏感材料处理，因此这里提供经过检查的使用说明，暂不提供源码获取和仓库 Issue 链接；这不代表源码通过了安全审计。已有经维护者检查的源码副本可参考本地开发。

按使用目的阅读

| 目的 | 指南 | | --- | --- | | 第一次登录并上传一个文件 | 快速开始、登录与会话 | | 查看文件、版本和下载 | 文件与版本 | | 理解进度、失败重试和空间占用 | 上传、配额 | | 向指定接收者或公众分发文件 | 分享、公开发布 | | 管理用户、指标和通知 | 用户管理、仪表盘、通知 | | 开发接口或运维自己的实例 | API、本地开发、部署与恢复 | | 操作失败 | 排错 |

页面入口与能力边界

以下路径属于你正在使用的 MyWebDrive 实例，不是本说明站点：/signin 登录，/account 个人中心，/download 公开目录，/admin/overview 管理概览，/admin/users 用户管理，/admin/publish 发布，/admin/notifications 通知。

已实现 API 不一定有对应按钮。个人中心提供上传、文件列表、版本查看和下载；当前没有通用的重命名、移动、删除、回收站恢复或文件夹创建界面。分享管理和替换上传需调用 API，版本列表不代表提供恢复按钮。不要根据旧截图或文件夹类型字段推断操作可用。

验证范围

本文的功能说明来自固定源码的静态核对，网站文档、搜索和 AI 的测试与 MyWebDrive 实例的运行验收分开记录。实例能打开首页，不代表邮箱投递、真实上传、后台完成处理和下载已经通过。首次使用应按快速开始亲自完成一个无敏感内容的小文件往返测试。