插件应用市场
云枢云文件管理
云文件管理工具
项目概览
云枢 (YunShu) 是一款功能强大的多协议云文件管理工具，支持 WebDAV、SFTP、FTP/FTPS 等多种协议，为用户提供类似本地文件管理器的云端文件操作体验。
核心定位
多协议支持：支持 WebDAV、SFTP、FTP/FTPS 等多种协议
本地化操作体验：像操作本地文件一样管理云端文件
多账号管理：支持同时管理多个云存储服务器
高效传输：支持文件上传下载、自动重试、传输记录
在线预览：支持图片、文档、视频等多种文件格式预览
目标用户
私有云用户（Alist、群晖 NAS、坚果云等）
开发者和技术爱好者（SFTP、FTP 服务器管理）
需要管理多个云存储账号的用户
✨ 功能特性
1. 账号管理
✅ 多协议支持：支持 WebDAV、SFTP、FTP/FTPS 等协议
✅ 多账号支持：添加、编辑、删除多个云存储账号
✅ 快速切换：下拉菜单快速切换不同账号
✅ 连接测试：添加账号时自动测试连接
✅ 默认账号：设置默认启动账号
✅ 安全存储：账号信息本地加密存储
2. 文件管理
文件浏览
✅ 列表/网格视图：支持列表和网格两种显示模式
✅ 面包屑导航：清晰的路径导航
✅ 文件搜索：实时搜索文件和文件夹
✅ 排序功能：按名称、大小、修改时间排序
✅ 分页显示：支持大量文件的分页展示
文件操作
✅ 上传文件：点击上传或拖拽上传
✅ 下载文件：右键下载到本地
✅ 新建文件/文件夹：智能识别创建类型
✅ 重命名：快速重命名文件和文件夹
✅ 删除：删除文件和文件夹
✅ 复制/移动：跨文件夹复制和移动
✅ 批量操作：支持多选批量操作
文件预览
✅ 图片预览：支持 JPG、PNG、GIF、WebP 等格式
✅ 文档预览：支持 PDF、Word、Excel、PPT 等格式
✅ 视频播放：支持 MP4、WebM 等视频格式
✅ 音频播放：支持 MP3、WAV 等音频格式
✅ 文本查看：支持 TXT、MD、JSON、代码文件等
3. 传输管理
✅ 传输记录：记录所有上传和下载历史
✅ 传输状态：实时显示传输进度和状态
✅ 记录筛选：按类型筛选上传/下载记录
✅ 打开位置：双击文件名打开本地文件位置
✅ 清空记录：一键清空所有传输记录
4. 收藏夹
✅ 添加收藏：收藏常用文件和文件夹
✅ 快速访问：从收藏夹快速访问文件
✅ 取消收藏：管理收藏列表
5. 高级功能
传输优化
✅ 上传前确认：可选的上传确认对话框
✅ 下载前确认：可选的下载确认对话框
✅ 自动重试：失败时自动重试（可配置次数）
✅ 拖拽上传：支持拖拽文件到窗口上传
✅ 文件夹过滤：禁止文件夹拖拽上传
缓存系统
✅ 智能缓存：缓存文件列表提高加载速度
✅ 缓存过期：可配置缓存有效期（1-1440分钟）
✅ 缓存管理：查看缓存大小和项数
✅ 清除缓存：一键清除所有缓存
性能优化
✅ 请求超时：可配置请求超时时间（5-300秒）
✅ 紧凑模式：节省空间的紧凑显示模式
✅ 隐藏文件：显示/隐藏以点开头的隐藏文件
6. 界面设置
✅ 主题切换：浅色/深色主题
✅ 视图模式：列表/网格视图切换
✅ 默认排序：设置默认排序方式
✅ 分页大小：自定义每页显示数量
🚀 快速开始
安装
下载云枢安装包
双击安装
启动应用
添加第一个账号
点击右上角 设置 按钮
在 账号管理 标签页点击 添加账号
选择协议类型：
WebDAV ☁️：坚果云、Alist、群晖等
SFTP 🔐：SSH 文件传输协议
FTP/FTPS 📁：FTP 服务器
填写对应协议的配置信息
点击 测试连接 验证配置
点击 保存 完成添加
开始使用
在主界面选择账号
浏览文件列表
使用右键菜单进行文件操作
点击 上传 按钮上传文件
双击文件进行预览
📖 使用文档
文件操作指南
上传文件
方式一：点击上传
点击顶部 上传 按钮
选择要上传的文件
等待上传完成
方式二：拖拽上传
从文件管理器拖拽文件到窗口
释放文件开始上传
查看上传进度
注意事项：
✅ 支持多文件上传
✅ 支持大文件上传
❌ 不支持文件夹拖拽上传
下载文件
右键点击文件
选择 下载
文件自动下载到设置的下载路径
在传输记录中查看下载状态
新建文件/文件夹
点击顶部 新建 按钮
输入名称：
无后缀名：创建文件夹（如"新建文件夹"）
有后缀名：创建文件（如"文档.txt"）
点击 创建 完成
重命名
右键点击文件或文件夹
选择 重命名
输入新名称
点击 确定
删除
右键点击文件或文件夹
选择 删除
确认删除操作
复制/移动
右键点击文件或文件夹
选择 复制到 或 移动到
在弹出的文件夹选择器中选择目标位置
点击 确定 完成操作
批量操作
勾选多个文件或文件夹
右键点击选中项
选择批量操作（批量下载、批量删除等）
文件预览
图片预览
支持格式：JPG、PNG、GIF、WebP、BMP、SVG
功能：缩放、旋转、图片组浏览
文档预览
支持格式：PDF、DOC、DOCX、XLS、XLSX、PPT、PPTX
功能：在线查看、翻页
视频播放
支持格式：MP4、WebM、OGG
功能：播放、暂停、进度控制、音量调节
音频播放
支持格式：MP3、WAV、OGG、AAC
功能：播放、暂停、进度控制、音量调节
传输记录
查看传输记录
点击左侧 传输记录 菜单
选择标签页：
全部：查看所有记录
下载记录：仅查看下载记录
上传记录：仅查看上传记录
打开文件位置
在传输记录中找到文件
双击文件名
自动打开文件管理器并选中文件
注意： 仅支持本地路径存在的文件
清空记录
点击 清空记录 按钮
确认清空操作
所有传输记录将被删除
收藏夹
添加收藏
右键点击文件或文件夹
选择 添加到收藏夹
文件添加到收藏列表
访问收藏
点击左侧 收藏夹 菜单
查看所有收藏的文件
双击文件快速访问
取消收藏
在收藏夹中右键点击文件
选择 取消收藏
⚙️ 设置说明
账号管理
添加账号
WebDAV 账号
账号名称：自定义账号名称
服务器地址：WebDAV 服务器 URL
用户名：登录用户名
密码：登录密码
SFTP 账号
账号名称：自定义账号名称
服务器地址：SFTP 服务器地址
端口：SSH 端口（默认 22）
用户名：SSH 用户名
密码：SSH 密码
FTP 账号
账号名称：自定义账号名称
服务器地址：FTP 服务器地址
端口：FTP 端口（默认 21）
用户名：FTP 用户名
密码：FTP 密码
使用 FTPS：是否启用加密连接
编辑账号
修改账号信息
重新测试连接
保存更改
删除账号
删除不再使用的账号
需要确认操作
外观设置
主题
浅色主题：适合白天使用
深色主题：适合夜间使用
跟随系统：自动跟随系统主题
显示模式
列表视图：详细信息显示
网格视图：图标网格显示
紧凑模式：节省空间的紧凑显示
文件设置
默认视图
列表视图
网格视图
默认排序
按名称排序（升序/降序）
按大小排序（升序/降序）
按修改时间排序（升序/降序）
分页设置
每页显示数量：20/50/100/200
其他选项
显示隐藏文件：显示以点开头的隐藏文件
下载路径：设置默认下载位置
传输设置
确认选项
上传前确认：上传文件前显示确认对话框
下载前确认：下载文件前显示确认对话框
覆盖前确认：覆盖文件前显示确认对话框
重试设置
自动重试：失败时自动重试
重试次数：最多重试次数（1-10次）
重试策略：
第1次重试：等待 1 秒
第2次重试：等待 2 秒
第3次重试：等待 3 秒
以此类推...
缓存设置
缓存控制
启用缓存：缓存文件列表提高加载速度
缓存过期时间：缓存有效期（1-1440分钟）
缓存信息
缓存大小：当前缓存占用空间
缓存项数：缓存的文件列表数量
缓存管理
清除所有缓存：删除所有缓存数据
建议：
快速网络：缓存 10-15 分钟
正常网络：缓存 30 分钟（默认）
慢速网络：缓存 60-120 分钟
不稳定网络：缓存 120-300 分钟
高级设置
请求超时时间
范围：5-300 秒
默认：30 秒
建议：
快速网络：10-15 秒
正常网络：30 秒
慢速网络：60-120 秒
不稳定网络：120-300 秒
注意：当前版本暂未使用此设置
并发请求数
范围：1-10
默认：3
注意：当前版本暂未使用此设置
恢复默认设置
一键恢复所有设置到默认值
需要确认操作
❓ 常见问题
连接问题
Q: 无法连接到服务器？
A: 请检查：
协议类型是否选择正确
服务器地址和端口是否正确
用户名和密码是否正确
网络连接是否正常
防火墙是否阻止连接
对于 SFTP，检查 SSH 服务是否运行
Q: 连接超时怎么办？
A:
增加请求超时时间（设置 > 高级设置）
检查网络速度
尝试重新连接
上传问题
Q: 上传失败显示 405 错误？
A:
检查服务器是否允许上传
检查目标路径是否有写入权限
确认路径格式正确
Q: 为什么不能拖拽文件夹上传？
A: 当前版本不支持文件夹上传，只支持文件上传。
下载问题
Q: 下载的文件在哪里？
A:
查看设置中的下载路径
在传输记录中双击文件名打开位置
Q: 下载失败怎么办？
A:
检查下载路径是否存在
检查磁盘空间是否足够
启用自动重试功能
性能问题
Q: 文件列表加载很慢？
A:
启用缓存功能
减少每页显示数量
增加请求超时时间
Q: 如何清除缓存？
A: 设置 > 缓存设置 > 清除所有缓存
🛠 技术栈
前端框架
Vue 3：渐进式 JavaScript 框架
Vite：下一代前端构建工具
Naive UI：Vue 3 组件库
核心库
webdav：WebDAV 客户端库
ssh2-sftp-client：SFTP 客户端库
basic-ftp：FTP 客户端库
axios：HTTP 客户端
开发工具
TypeScript：类型安全
ESLint：代码检查
Prettier：代码格式化
📝 更新日志
v1.1.0 (2025-12-29)
🎉 多协议支持
新增协议
✅ SFTP 协议支持
✅ FTP/FTPS 协议支持
✅ 协议自动检测和动态注册
架构优化
✅ 协议工厂模式
✅ 桥接模式支持 Node.js 协议
✅ 统一的协议接口
v1.0.0 (2025-12-25)
🎉 首次发布
核心功能
✅ WebDAV 协议支持
✅ 多账号管理
✅ 文件浏览和操作
✅ 文件上传下载
✅ 文件预览
✅ 传输记录
✅ 收藏夹
传输优化
✅ 上传/下载前确认
✅ 自动重试机制
✅ 拖拽上传
✅ 传输记录管理
性能优化
✅ 智能缓存系统
✅ 请求超时控制
✅ 分页加载
界面优化
✅ 浅色/深色主题
✅ 列表/网格视图
✅ 紧凑模式
✅ 响应式设计
👨💻 开发者
chendimao
📄 许可证
MIT License
🙏 致谢
感谢所有使用云枢的用户！
如有问题或建议，欢迎反馈。
云枢云文件管理 - 让云端文件管理更简单
Made with ❤️ by chendimao
云枢 (YunShu) 是一款功能强大的多协议云文件管理工具，支持 WebDAV、SFTP、FTP/FTPS 等多种协议，为用户提供类似本地文件管理器的云端文件操作体验。
核心定位
多协议支持：支持 WebDAV、SFTP、FTP/FTPS 等多种协议
本地化操作体验：像操作本地文件一样管理云端文件
多账号管理：支持同时管理多个云存储服务器
高效传输：支持文件上传下载、自动重试、传输记录
在线预览：支持图片、文档、视频等多种文件格式预览
目标用户
私有云用户（Alist、群晖 NAS、坚果云等）
开发者和技术爱好者（SFTP、FTP 服务器管理）
需要管理多个云存储账号的用户
✨ 功能特性
1. 账号管理
✅ 多协议支持：支持 WebDAV、SFTP、FTP/FTPS 等协议
✅ 多账号支持：添加、编辑、删除多个云存储账号
✅ 快速切换：下拉菜单快速切换不同账号
✅ 连接测试：添加账号时自动测试连接
✅ 默认账号：设置默认启动账号
✅ 安全存储：账号信息本地加密存储
2. 文件管理
文件浏览
✅ 列表/网格视图：支持列表和网格两种显示模式
✅ 面包屑导航：清晰的路径导航
✅ 文件搜索：实时搜索文件和文件夹
✅ 排序功能：按名称、大小、修改时间排序
✅ 分页显示：支持大量文件的分页展示
文件操作
✅ 上传文件：点击上传或拖拽上传
✅ 下载文件：右键下载到本地
✅ 新建文件/文件夹：智能识别创建类型
✅ 重命名：快速重命名文件和文件夹
✅ 删除：删除文件和文件夹
✅ 复制/移动：跨文件夹复制和移动
✅ 批量操作：支持多选批量操作
文件预览
✅ 图片预览：支持 JPG、PNG、GIF、WebP 等格式
✅ 文档预览：支持 PDF、Word、Excel、PPT 等格式
✅ 视频播放：支持 MP4、WebM 等视频格式
✅ 音频播放：支持 MP3、WAV 等音频格式
✅ 文本查看：支持 TXT、MD、JSON、代码文件等
3. 传输管理
✅ 传输记录：记录所有上传和下载历史
✅ 传输状态：实时显示传输进度和状态
✅ 记录筛选：按类型筛选上传/下载记录
✅ 打开位置：双击文件名打开本地文件位置
✅ 清空记录：一键清空所有传输记录
4. 收藏夹
✅ 添加收藏：收藏常用文件和文件夹
✅ 快速访问：从收藏夹快速访问文件
✅ 取消收藏：管理收藏列表
5. 高级功能
传输优化
✅ 上传前确认：可选的上传确认对话框
✅ 下载前确认：可选的下载确认对话框
✅ 自动重试：失败时自动重试（可配置次数）
✅ 拖拽上传：支持拖拽文件到窗口上传
✅ 文件夹过滤：禁止文件夹拖拽上传
缓存系统
✅ 智能缓存：缓存文件列表提高加载速度
✅ 缓存过期：可配置缓存有效期（1-1440分钟）
✅ 缓存管理：查看缓存大小和项数
✅ 清除缓存：一键清除所有缓存
性能优化
✅ 请求超时：可配置请求超时时间（5-300秒）
✅ 紧凑模式：节省空间的紧凑显示模式
✅ 隐藏文件：显示/隐藏以点开头的隐藏文件
6. 界面设置
✅ 主题切换：浅色/深色主题
✅ 视图模式：列表/网格视图切换
✅ 默认排序：设置默认排序方式
✅ 分页大小：自定义每页显示数量
🚀 快速开始
安装
下载云枢安装包
双击安装
启动应用
添加第一个账号
点击右上角 设置 按钮
在 账号管理 标签页点击 添加账号
选择协议类型：
WebDAV ☁️：坚果云、Alist、群晖等
SFTP 🔐：SSH 文件传输协议
FTP/FTPS 📁：FTP 服务器
填写对应协议的配置信息
点击 测试连接 验证配置
点击 保存 完成添加
开始使用
在主界面选择账号
浏览文件列表
使用右键菜单进行文件操作
点击 上传 按钮上传文件
双击文件进行预览
📖 使用文档
文件操作指南
上传文件
方式一：点击上传
点击顶部 上传 按钮
选择要上传的文件
等待上传完成
方式二：拖拽上传
从文件管理器拖拽文件到窗口
释放文件开始上传
查看上传进度
注意事项：
✅ 支持多文件上传
✅ 支持大文件上传
❌ 不支持文件夹拖拽上传
下载文件
右键点击文件
选择 下载
文件自动下载到设置的下载路径
在传输记录中查看下载状态
新建文件/文件夹
点击顶部 新建 按钮
输入名称：
无后缀名：创建文件夹（如"新建文件夹"）
有后缀名：创建文件（如"文档.txt"）
点击 创建 完成
重命名
右键点击文件或文件夹
选择 重命名
输入新名称
点击 确定
删除
右键点击文件或文件夹
选择 删除
确认删除操作
复制/移动
右键点击文件或文件夹
选择 复制到 或 移动到
在弹出的文件夹选择器中选择目标位置
点击 确定 完成操作
批量操作
勾选多个文件或文件夹
右键点击选中项
选择批量操作（批量下载、批量删除等）
文件预览
图片预览
支持格式：JPG、PNG、GIF、WebP、BMP、SVG
功能：缩放、旋转、图片组浏览
文档预览
支持格式：PDF、DOC、DOCX、XLS、XLSX、PPT、PPTX
功能：在线查看、翻页
视频播放
支持格式：MP4、WebM、OGG
功能：播放、暂停、进度控制、音量调节
音频播放
支持格式：MP3、WAV、OGG、AAC
功能：播放、暂停、进度控制、音量调节
传输记录
查看传输记录
点击左侧 传输记录 菜单
选择标签页：
全部：查看所有记录
下载记录：仅查看下载记录
上传记录：仅查看上传记录
打开文件位置
在传输记录中找到文件
双击文件名
自动打开文件管理器并选中文件
注意： 仅支持本地路径存在的文件
清空记录
点击 清空记录 按钮
确认清空操作
所有传输记录将被删除
收藏夹
添加收藏
右键点击文件或文件夹
选择 添加到收藏夹
文件添加到收藏列表
访问收藏
点击左侧 收藏夹 菜单
查看所有收藏的文件
双击文件快速访问
取消收藏
在收藏夹中右键点击文件
选择 取消收藏
⚙️ 设置说明
账号管理
添加账号
WebDAV 账号
账号名称：自定义账号名称
服务器地址：WebDAV 服务器 URL
用户名：登录用户名
密码：登录密码
SFTP 账号
账号名称：自定义账号名称
服务器地址：SFTP 服务器地址
端口：SSH 端口（默认 22）
用户名：SSH 用户名
密码：SSH 密码
FTP 账号
账号名称：自定义账号名称
服务器地址：FTP 服务器地址
端口：FTP 端口（默认 21）
用户名：FTP 用户名
密码：FTP 密码
使用 FTPS：是否启用加密连接
编辑账号
修改账号信息
重新测试连接
保存更改
删除账号
删除不再使用的账号
需要确认操作
外观设置
主题
浅色主题：适合白天使用
深色主题：适合夜间使用
跟随系统：自动跟随系统主题
显示模式
列表视图：详细信息显示
网格视图：图标网格显示
紧凑模式：节省空间的紧凑显示
文件设置
默认视图
列表视图
网格视图
默认排序
按名称排序（升序/降序）
按大小排序（升序/降序）
按修改时间排序（升序/降序）
分页设置
每页显示数量：20/50/100/200
其他选项
显示隐藏文件：显示以点开头的隐藏文件
下载路径：设置默认下载位置
传输设置
确认选项
上传前确认：上传文件前显示确认对话框
下载前确认：下载文件前显示确认对话框
覆盖前确认：覆盖文件前显示确认对话框
重试设置
自动重试：失败时自动重试
重试次数：最多重试次数（1-10次）
重试策略：
第1次重试：等待 1 秒
第2次重试：等待 2 秒
第3次重试：等待 3 秒
以此类推...
缓存设置
缓存控制
启用缓存：缓存文件列表提高加载速度
缓存过期时间：缓存有效期（1-1440分钟）
缓存信息
缓存大小：当前缓存占用空间
缓存项数：缓存的文件列表数量
缓存管理
清除所有缓存：删除所有缓存数据
建议：
快速网络：缓存 10-15 分钟
正常网络：缓存 30 分钟（默认）
慢速网络：缓存 60-120 分钟
不稳定网络：缓存 120-300 分钟
高级设置
请求超时时间
范围：5-300 秒
默认：30 秒
建议：
快速网络：10-15 秒
正常网络：30 秒
慢速网络：60-120 秒
不稳定网络：120-300 秒
注意：当前版本暂未使用此设置
并发请求数
范围：1-10
默认：3
注意：当前版本暂未使用此设置
恢复默认设置
一键恢复所有设置到默认值
需要确认操作
❓ 常见问题
连接问题
Q: 无法连接到服务器？
A: 请检查：
协议类型是否选择正确
服务器地址和端口是否正确
用户名和密码是否正确
网络连接是否正常
防火墙是否阻止连接
对于 SFTP，检查 SSH 服务是否运行
Q: 连接超时怎么办？
A:
增加请求超时时间（设置 > 高级设置）
检查网络速度
尝试重新连接
上传问题
Q: 上传失败显示 405 错误？
A:
检查服务器是否允许上传
检查目标路径是否有写入权限
确认路径格式正确
Q: 为什么不能拖拽文件夹上传？
A: 当前版本不支持文件夹上传，只支持文件上传。
下载问题
Q: 下载的文件在哪里？
A:
查看设置中的下载路径
在传输记录中双击文件名打开位置
Q: 下载失败怎么办？
A:
检查下载路径是否存在
检查磁盘空间是否足够
启用自动重试功能
性能问题
Q: 文件列表加载很慢？
A:
启用缓存功能
减少每页显示数量
增加请求超时时间
Q: 如何清除缓存？
A: 设置 > 缓存设置 > 清除所有缓存
🛠 技术栈
前端框架
Vue 3：渐进式 JavaScript 框架
Vite：下一代前端构建工具
Naive UI：Vue 3 组件库
核心库
webdav：WebDAV 客户端库
ssh2-sftp-client：SFTP 客户端库
basic-ftp：FTP 客户端库
axios：HTTP 客户端
开发工具
TypeScript：类型安全
ESLint：代码检查
Prettier：代码格式化
📝 更新日志
v1.1.0 (2025-12-29)
🎉 多协议支持
新增协议
✅ SFTP 协议支持
✅ FTP/FTPS 协议支持
✅ 协议自动检测和动态注册
架构优化
✅ 协议工厂模式
✅ 桥接模式支持 Node.js 协议
✅ 统一的协议接口
v1.0.0 (2025-12-25)
🎉 首次发布
核心功能
✅ WebDAV 协议支持
✅ 多账号管理
✅ 文件浏览和操作
✅ 文件上传下载
✅ 文件预览
✅ 传输记录
✅ 收藏夹
传输优化
✅ 上传/下载前确认
✅ 自动重试机制
✅ 拖拽上传
✅ 传输记录管理
性能优化
✅ 智能缓存系统
✅ 请求超时控制
✅ 分页加载
界面优化
✅ 浅色/深色主题
✅ 列表/网格视图
✅ 紧凑模式
✅ 响应式设计
👨💻 开发者
chendimao
📄 许可证
MIT License
🙏 致谢
感谢所有使用云枢的用户！
如有问题或建议，欢迎反馈。
云枢云文件管理 - 让云端文件管理更简单
Made with ❤️ by chendimao