用户手册
欢迎使用 AsterDrive ✨
这一篇是给普通用户看的——拿到账号、登录进来、上传第一个文件、分享给别人、必要时找回回收站里的内容。整个手册按页面组织，不需要按顺序读完，登录后看到哪一块不清楚，直接翻对应章节就行。
如果你是管理员，建议先看一遍这一篇了解普通用户视角，再看 管理后台。
如果你打算挂载 WebDAV、给 Office 文件接外部编辑器，对应章节会专门讲。
我们对"好用"的定义
AsterDrive 不追求"功能最多的网盘"。我们想做的是这样一个东西：
- 常用的事不让你想 —— 上传、找文件、分享、误删恢复，都该是一次操作完成
- 不出意外的事不打扰你 —— 没必要的提示、没必要的对话框、没必要的"你确定吗"都尽量去掉
- 真出问题时给你清晰的信号 —— 错误码 + 中文提示 + 可操作的下一步建议
如果你用下来觉得哪里别扭，开个 issue 告诉我们——这是最直接的反馈方式。
登录和首次进入
登录页不需要你先决定"这是登录还是注册"。
输入用户名或邮箱后，页面会自动判断流程：
- 系统里还没有任何用户：创建管理员
- 输入的是已有账号：登录
- 输入的是新账号，而且管理员允许公开注册：注册普通账号
需要注意：
- 第一个创建成功的账号会自动成为管理员
- 后续新注册的普通账号，通常需要先点激活邮件才能登录
- 如果管理员关闭了公开注册，联系管理员给你创建账号
- 如果管理员已经配好邮件，可以在登录页直接申请密码重置邮件
先认识工作空间
登录后，左侧最上方会看到工作空间列表：
我的空间：你的个人文件、个人分享、个人回收站和 WebDAV 账号都在这里- 团队空间：只有你加入团队后才会出现；每个团队空间都有自己的文件、分享、回收站和任务列表
搜索、分享、任务和回收站都会跟着当前工作空间走。
要管理哪一组内容，先切到对应工作空间。
文件页面最常用的位置
- 左侧工作空间列表：切换个人空间或团队空间
- 左侧目录树：快速进入目标文件夹
- 顶部搜索框：搜索当前工作空间里的文件和文件夹
回收站：处理当前工作空间里的已删除内容我的分享：查看当前工作空间里已经发出去的链接任务中心：查看在线压缩、在线解压、打包下载等后台任务WebDAV：只在个人空间里出现，用来创建桌面客户端账号- 右上角用户菜单里的
设置：调整个人资料、界面、安全和团队相关设置
上传和整理文件
文件列表、右键菜单和顶部操作区可以完成大多数日常工作：
- 创建文件夹
- 创建空白文本文件
- 上传文件
- 上传文件夹
- 下载文件
- 重命名、复制、移动、删除文件和文件夹
- 查看详细信息
- 手动锁定或解锁文件
- 在线压缩、在线解压和文件夹打包下载
- 在列表视图和网格视图之间切换
- 按名称、大小、创建时间、更新时间或类型排序
你也可以直接拖拽：
- 把文件或文件夹拖到左侧目录树里的目标文件夹
- 把文件或文件夹拖到顶部面包屑里的上级目录
- 把文件或文件夹拖到左侧的回收站
搜索、多选和批量处理
顶部搜索框会在当前工作空间里按名称搜索文件和文件夹。
可以直接点搜索框，也可以用 Ctrl + K 打开搜索弹窗；弹窗里能切换“全部 / 仅文件 / 仅文件夹”，方向键选结果，Enter 打开。
文件页面里的搜索状态会跟着当前工作空间走。
你在团队空间里搜到的结果，不会混进个人空间的文件。
需要一次处理多个项目时，可以直接多选后批量执行：
- 批量移动
- 批量复制
- 批量删除
- 批量打包下载
在文件列表和回收站里都可以使用 Ctrl + A 或 Cmd + A 全选当前页。
文件或文件夹的“详细信息”会显示名称、大小、类型、创建时间、修改时间、锁定状态、分享状态和存储策略 ID 等信息。
排查“这个文件到底在哪条策略上”“是不是被锁住了”时，先看这里。
打开、预览和编辑
很多常见文件都可以直接在网页里打开，例如：
- 图片
- 音频和视频
- Markdown
- CSV / TSV
- JSON
- XML
- 纯文本和常见代码文件
文本类文件通常可以直接编辑。保存时，系统会自动：
- 检查这份文件在你打开之后有没有被别人改过
- 生成新的历史版本
- 释放编辑锁
如果管理员给站点配置了额外的在线预览或在线编辑能力，你在某些文件上还会看到额外的“打开方式”。
最常见的场景，就是把 Office 文件交给外部预览器或 WOPI 在线编辑器打开。
这类入口会不会出现，取决于管理员有没有给当前文件类型配置对应的预览应用。
如果你手上的 docx、xlsx 或 pptx 没有显示额外打开方式，通常说明当前站点还没把这类文件接到可用的外部服务。
版本历史怎么用
你可以在版本历史里：
- 查看旧版本
- 恢复某个旧版本
- 删除不需要的旧版本
恢复旧版本后，那个版本之后的新版本记录会被截断，所以恢复前先确认。
如果保存时出现冲突提示，通常说明这份文件在你打开后又被别人改过了。先刷新内容，再决定是否继续保存。
任务中心
当前界面里，最常见会进入 任务中心 的操作包括：
- 文件夹打包下载
- 选中一批文件或文件夹后在线压缩
- 对压缩包做在线解压
如果站点后续接入了其他后台文件任务，它们也会在这里按同样方式显示。
在 任务中心 里，你可以：
- 查看任务当前是排队中、处理中、已完成、已取消还是失败
- 查看创建时间、开始时间和完成时间
- 查看每一步的当前进度和状态说明
- 在任务完成后直接打开结果所在文件夹
- 在失败时重新排队
任务中心同样跟着当前工作空间走。
你在团队空间里发起的任务，要到对应团队空间的 任务中心 去看。
回收站
普通删除不会立刻彻底清除文件或文件夹，而是先进入回收站。
你可以在回收站中：
- 恢复项目
- 永久删除单个项目
- 清空整个回收站
- 批量恢复
- 批量永久删除
如果原来的父目录已经不存在，恢复时项目会回到根目录。
分享链接
分享会跟着当前工作空间走。
要分享团队空间里的文件，先切到对应团队空间再创建分享。
AsterDrive 支持文件分享和文件夹分享。创建分享时可以设置：
- 密码
- 过期时间
- 最大下载次数
需要注意的规则：
- 同一个文件或文件夹同一时间只能保留一条活跃分享
- 如果要改密码、过期时间或下载次数，不需要重建链接，去
我的分享里直接编辑即可 - 如果链接设置了密码，访问者在当前浏览器验证成功后，通常约 1 小时内不需要重复输入密码
如果你分享的是单个文件，弹窗里还可以切到 直链 模式。直链不支持密码、过期时间和下载次数限制，但会额外给出一个“强制下载链接”。默认直链更适合直接打开，强制下载链接则明确要求浏览器下载；当文件位于开启了 presigned 下载策略的第三方存储上时，这条强制下载链接可能会先跳转到一个短时效下载地址。
我的分享
左侧 我的分享 页面会列出当前工作空间里已经发出去的链接。
你可以在那里：
- 复制分享链接
- 打开公开页面
- 编辑密码、过期时间和下载次数限制
- 删除不再需要的分享
- 查看打开次数和下载次数
- 多选后批量移除分享
分享列表有分页。分享很多时，先确认当前页再批量操作，避免误以为一次会选中所有历史分享。
WebDAV
如果你希望在 Finder、Windows 资源管理器、rclone 或其他桌面工具里直接使用 AsterDrive，可以创建 WebDAV 专用账号。
WebDAV 账号只在个人空间里管理，不跟团队空间共用。
常见做法是：
- 每台设备一个独立账号
- 某台设备丢失时单独停用
- 把某个账号限制到根目录下某个文件夹
创建 WebDAV 账号时可以：
- 自定义用户名
- 自定义密码，或让系统自动生成
- 指定访问范围
密码只会在创建成功时显示一次，建议立刻保存。
默认 WebDAV 地址通常是：
https://你的域名/webdav/如果管理员修改了 WebDAV 前缀，请改用新的地址。
设置
从右上角用户菜单进入后，设置页分成四个部分。
个人资料
你可以修改：
- 展示名称
- 头像
头像支持这些常见做法：
- 上传头像并裁剪
- 使用根据邮箱生成的 Gravatar 头像
- 清除当前头像
用户名会显示在这里。
邮箱状态也会显示，但改绑邮箱要到 设置 -> 安全 里操作。
界面
你可以调整：
- 浅色 / 深色 / 跟随系统
- 主题颜色
- 显示语言
- 文件浏览器默认视图
- 单击还是双击打开文件和文件夹
- 是否开启实时同步文件变更
- 展示时区
这里的“实时同步文件变更”指网页端通过实时推送刷新当前视图。它不是桌面本地文件夹同步客户端，别把这两个东西混在一起。
安全
这里负责邮箱状态、邮箱改绑、密码和登录设备。
你可以看到：
- 当前邮箱是否已经验证
- 是否有一个“待确认的新邮箱”
如果当前邮箱已经验证，你可以：
- 输入一个新邮箱
- 发送确认邮件到新邮箱
- 在需要时重新发送确认邮件
新邮箱只有在你点开确认链接之后才会真正生效。
你也可以在这里修改登录密码。修改密码时需要先输入当前密码。
当前版本里，密码修改成功后，当前浏览器会话会继续保持登录，其他设备上的登录会失效，需要重新登录。
你还可以在 登录设备 里：
- 查看当前仍保持登录的设备
- 单独移除某台设备
- 一次退出其他设备
如果你移除的是当前设备，当前浏览器会立刻退出登录。
团队
设置 -> 团队 会列出你加入的团队。
你可以在这里：
- 查看团队名称、简介、成员数和空间占用
- 直接打开某个团队工作空间
- 进入团队管理页
- 查看已归档团队
如果你在团队里是管理员或所有者，还可以继续管理成员和查看团队审计。
如果你有对应权限，也可以恢复已归档团队。