123FastRename
123云盘文件批量重命名助手，支持多种重命名模式和灵活的文件管理。
功能截图
✨ 功能特性
🔄 智能文件选择
- 全选支持：支持全选当前文件夹的所有文件
- 部分选择：支持手动选择特定文件进行重命名
- 取消选择：全选后可取消特定文件
- 自动隐藏：未选择文件时自动隐藏重命名按钮
- 面包屑监听：切换文件夹时自动清空选择
🚀 多种重命名模式
- 按序号重命名：自定义前缀、序号、后缀，自动生成序号
- 追加重命名：在文件名前后添加前缀或后缀
- 查找替换：查找并替换文件名中的特定内容
- 正则替换：使用正则表达式进行高级替换
- 格式替换：批量修改文件扩展名
🎨 用户界面
- 拖拽排序：支持拖拽调整文件顺序
- 实时预览：实时显示重命名后的文件名
- 过滤功能：支持过滤视频文件
- 统计信息：显示文件数量、总大小、重命名结果
- 响应式设计：适配不同屏幕尺寸
- 现代化UI：清晰的弹窗和操作流程
🔒 安全与隐私
- 本地运行：纯前端JavaScript实现，不依赖外部服务器
- 无数据上传：所有操作在本地完成，不上传任何数据
- 安全存储：使用Tampermonkey的安全存储机制
⚡ 性能优化
- 缓存机制：缓存文件列表，避免重复API请求
- 防抖处理：文件选择变化时使用防抖，减少不必要的更新
- 并行处理：重命名操作支持并行处理
- 状态管理：防止重复点击和并发请求
📦 安装方法
1. 安装浏览器扩展
首先需要安装用户脚本管理器扩展：
2. 安装脚本
- 下载本项目中的
123FastRename.js 文件
- 在浏览器中打开 Tampermonkey 扩展
- 点击「添加新脚本」
- 将
123FastRename.js 的内容复制粘贴到编辑器中
- 点击「文件」→「保存」或使用快捷键
Ctrl+S 保存脚本
🚀 使用方法
1. 选择文件
- 打开123云盘网站
- 浏览到要重命名的文件所在的文件夹
- 勾选要重命名的文件（支持单选、多选、全选）
- 点击界面中出现的「批量重命名」按钮
2. 排序文件
- 在弹出的排序对话框中查看选中的文件列表
- 如需调整顺序，可拖拽文件项进行排序
- 可使用「文件名升序/降序」按钮快速排序
- 可使用「过滤视频文件」按钮只显示视频文件
- 点击「下一步」进入重命名配置
3. 配置重命名
按序号重命名
- 在顶部选择「按序号」标签
- 输入前缀（可选）：如
视频_
- 输入序号（可选）：如
01，会自动递增
- 输入后缀（可选）：如
_高清
- 实时预览右侧的重命名结果
- 示例：
视频.mp4 → 视频_01_高清.mp4
追加重命名
- 在顶部选择「追加」标签
- 输入前缀（可选）：如
【合集】
- 输入后缀（可选）：如
.mp4
- 实时预览右侧的重命名结果
- 示例：
视频.mp4 → 【合集】视频.mp4
查找替换
- 在顶部选择「查找替换」标签
- 输入查找内容：如
old
- 输入替换内容：如
new
- 勾选「忽略大小写」（可选）
- 实时预览右侧的重命名结果
- 示例：
old_video.mp4 → new_video.mp4
正则替换
- 在顶部选择「正则替换」标签
- 输入正则表达式：如
(\d+)
- 输入替换内容：如
第$1集
- 实时预览右侧的重命名结果
- 示例：
123.mp4 → 第123集.mp4
格式替换
- 在顶部选择「格式」标签
- 输入新的扩展名：如
mkv
- 实时预览右侧的重命名结果
- 示例：
video.mp4 → video.mkv
4. 执行重命名
- 确认预览结果无误后，点击「确定」按钮
- 等待重命名完成
- 查看底部的统计信息：成功数量、失败数量、跳过数量
- 成功的文件显示绿色边框，失败的文件显示红色边框
- 点击「关闭」按钮关闭对话框
- 页面自动刷新，查看重命名结果
5. 其他操作
- 上一步：返回排序界面，可重新调整文件顺序
- 删除文件：在排序界面可删除不需要重命名的文件
- 取消：点击右上角或底部的「取消」按钮关闭对话框
🛠️ 技术架构
核心模块
- PanApiClient：123云盘API客户端，处理文件信息获取和重命名
- TableRowSelector：表格行选择器，监听文件选择变化
- SelectedFilesManager：选中文件管理器，处理文件列表缓存和更新
- UiManager：UI管理器，负责弹窗创建和事件处理
- Modal：模态框组件，提供统一的对话框界面
技术特点
- ES6+语法：使用现代JavaScript语法和特性
- Promise-based异步编程：使用Promise和async/await处理异步操作
- 模块化设计：清晰的代码结构和模块划分
- MutationObserver：用于监控DOM变化，实现动态元素注入
- 防抖机制：优化文件选择更新的性能
- 缓存策略：缓存文件列表，减少API请求
🔧 配置选项
开发模式
在代码中可以开启开发模式以查看详细日志：
const CONSTANTS = {
// ...
DEBUG_MODE: true // 开启开发模式，输出详细日志
};
生产环境建议关闭：
const CONSTANTS = {
// ...
DEBUG_MODE: false // 关闭开发模式，不输出日志
};
📝 常见问题
Q: 批量重命名按钮不显示？
A: 请检查以下几点：
- 是否已选择文件（至少选择一个文件）
- 文件类型是否正确（仅支持文件，不支持文件夹）
Q: 重命名失败怎么办？
A: 请检查以下几点：
- 网络连接是否正常
- 文件名是否包含非法字符
- 目标文件名是否已存在
- 123云盘API是否正常工作
Q: 如何跳过某些文件？
A: 在排序界面中，点击文件右侧的「×」按钮删除不需要重命名的文件。
Q: 序号如何递增？
A: 序号会根据文件在列表中的顺序自动递增，从1开始。如果输入 01，则从01开始。
Q: 如何取消重命名？
A: 重命名过程中无法取消，但完成后可以刷新页面恢复原文件名。
🔒 隐私声明
- 本脚本仅在本地运行，不会将您的文件信息发送到任何第三方服务器
- 所有API请求均直接发送到123云盘官方服务器
- 认证信息使用Tampermonkey的安全存储机制，不会明文存储
📄 许可证
本项目采用 Apache-2.0 许可证。详见 LICENSE 文件。
📞 反馈与支持
如果您在使用过程中遇到问题，或有任何建议，请通过以下方式反馈：
注意：本脚本仅用于个人文件管理，请勿用于任何违反相关服务条款的用途
Made with ❤️ by meguoe
