taiyi/CloudSync

Fork 0

taiyi 06a2ab71e6 修改远程文件无法显示的问题

2025-10-12 07:54:51 +08:00

5.5 KiB

Raw Blame History

📁 本地文件夹管理功能

CloudSync 现在支持管理多个本地文件夹，并自动保存使用历史记录！

✨ 主要功能

1. 多文件夹管理

✅ 同时管理多个本地同步文件夹
✅ 每个文件夹独立配置远程路径
✅ 可以启用/禁用特定文件夹的同步
✅ 批量同步所有启用的文件夹

2. 历史记录

📊 自动记录文件夹访问时间
📈 统计文件夹使用次数
🕐 按最近使用时间排序
🔥 按使用频率排序

3. 配置持久化

💾 自动保存文件夹列表到 ~/.cloudsync/folders.json
🔄 下次启动自动加载历史文件夹
📤 支持导出配置到文件
📥 支持从文件导入配置（合并或替换）

4. 智能管理

🧹 一键清理无效文件夹（路径不存在的）
🔍 文件夹状态显示（启用/禁用/最后访问时间）
✏️ 可以编辑文件夹的远程路径
❌ 移除文件夹不会删除本地文件

🎮 使用方法

添加文件夹

方法一：点击"浏览"按钮
- 在"当前文件夹"旁边点击"浏览"
- 选择要同步的本地文件夹
- 文件夹会自动添加到列表
方法二：点击"➕ 添加文件夹"按钮
- 在文件夹列表下方点击"➕ 添加文件夹"
- 选择要同步的本地文件夹
- 文件夹会添加到列表并自动选中

管理文件夹

在文件夹列表中显示的信息：

本地路径：文件夹在本地的完整路径
远程路径：同步到云盘的目标路径
状态：✅ 启用或 ❌ 禁用
最后访问：最后一次访问该文件夹的时间

文件夹操作

➖ 移除选中：从列表中移除选中的文件夹（不删除本地文件）
🔄 刷新列表：重新加载文件夹列表
🧹 清理无效：自动移除路径不存在的文件夹
📤 导出配置：将文件夹列表导出为JSON文件
📥 导入配置：从JSON文件导入文件夹列表

开始同步

添加一个或多个文件夹
确保要同步的文件夹状态为"✅ 启用"
点击"开始同步"按钮
系统会依次同步所有启用的文件夹

📊 配置文件格式

配置文件保存在：~/.cloudsync/folders.json

{
  "folders": [
    {
      "path": "/home/user/Documents",
      "remote_path": "/CloudSync/Documents",
      "enabled": true,
      "added_at": "2025-10-11T12:00:00",
      "last_accessed": "2025-10-11T15:30:00",
      "access_count": 5
    },
    {
      "path": "/home/user/Pictures",
      "remote_path": "/CloudSync/Pictures",
      "enabled": true,
      "added_at": "2025-10-11T12:05:00",
      "last_accessed": "2025-10-11T14:20:00",
      "access_count": 3
    }
  ],
  "last_updated": "2025-10-11T15:30:00"
}

🔧 高级功能

编程式使用

from cloudsync.utils.folder_manager import get_folder_manager

# 获取文件夹管理器实例
fm = get_folder_manager()

# 添加文件夹
fm.add_folder(
    path="/path/to/folder",
    remote_path="/CloudSync/MyFolder",
    enabled=True
)

# 获取所有文件夹
all_folders = fm.get_all_folders()

# 获取启用的文件夹
enabled_folders = fm.get_all_folders(enabled_only=True)

# 获取最近使用的5个文件夹
recent_folders = fm.get_recent_folders(limit=5)

# 获取最常用的10个文件夹
popular_folders = fm.get_most_used_folders(limit=10)

# 更新文件夹状态
fm.update_folder_enabled("/path/to/folder", enabled=False)

# 更新远程路径
fm.update_folder_remote_path("/path/to/folder", "/NewPath")

# 清理无效文件夹
removed_count = fm.clean_invalid_folders()

# 导出配置
fm.export_config("/path/to/backup.json")

# 导入配置（合并）
fm.import_config("/path/to/backup.json", merge=True)

# 导入配置（替换）
fm.import_config("/path/to/backup.json", merge=False)

💡 使用技巧

首次使用
- 添加常用的同步文件夹
- 系统会记住这些文件夹，下次打开自动加载
批量管理
- 导出配置文件保存到云盘或U盘
- 在另一台电脑上导入配置，快速恢复同步设置
性能优化
- 禁用暂时不需要同步的文件夹
- 定期清理无效文件夹
备份建议
- 定期导出文件夹配置
- 配置文件很小，可以包含在系统备份中

🚀 升级说明

从旧版本升级：

旧版本的单文件夹配置会自动迁移
不需要重新配置，所有设置都会保留
配置文件兼容性：向后兼容

❓ 常见问题

Q: 移除文件夹会删除本地文件吗？ A: 不会！移除只是从同步列表中删除，不会删除任何本地文件。

Q: 文件夹的访问记录有什么用？ A: 帮助你了解文件夹使用频率，下次打开时自动选中最近使用的文件夹。

Q: 如何临时禁用某个文件夹的同步？ A: 在文件夹列表中右键（或双击）可以切换启用状态（功能开发中）。

Q: 配置文件丢失了怎么办？ A: 如果有导出的备份文件，可以导入恢复。否则需要重新添加文件夹。

Q: 可以同步网络驱动器吗？ A: 可以！只要路径有效，支持任何可访问的目录。

📝 开发计划

文件夹分组功能
文件夹标签和颜色标记
同步策略自定义（文件过滤、排除规则）
文件夹右键菜单
文件夹拖拽排序
批量操作（批量启用/禁用/移除）
文件夹搜索和过滤
同步历史记录查看

🤝 反馈建议

如果您有任何建议或发现问题，欢迎反馈！

5.5 KiB Raw Blame History Unescape Escape