123 助手（123-helper.user.js）

123 助手是一个 Tampermonkey 用户脚本，运行在 123 云盘网页端与公开分享页，增强文件管理、媒体整理、分享与秒传搬运能力；与 123Cloud 桌面客户端配合使用时，还可以在网页端一键投稿、随时搜索客户端影库并转存。

• 适用于 123pan.com / .cn 及 123684 / 123865 / 123912 / 123635 等官方域名的网页端、user. 登录域名与公开分享页；
• 版本号见脚本头部 @version，随 123Cloud 仓库同步更新。

功能

文件页

• 全盘搜索：不受当前目录限制，直接搜索整个云盘
• 批量重命名、媒体整理、文件清理、秒传工具箱、批量分享，均从右键菜单或工具栏进入
• 文件套同名文件夹：把散落的文件一键包进同名文件夹
• 纯净模式：隐藏网页端推广元素；紧凑表格行、隐藏「备份」文件夹
• 液态玻璃主题：跟随系统 / 浅色 / 深色

批量重命名

• 规则链组合：查找替换（支持正则、区分大小写）、模板编号（{name} / {n}、起始编号与位数、前后缀）、删除指定文本或位置范围、字符移动、大小写与全角半角转换、空格清理
• 实时预览、保留扩展名、只改文件或只改文件夹
• 常用组合保存与载入、重命名历史恢复
• 选中项按文件名自然排序，预览与编号不随勾选点击顺序错乱

TMDB 媒体整理

• 自动识别电影 / 剧集，按标题或 TMDB ID 搜索，海报墙预览、媒体分组
• TMDB 替代源：无法直连 api.themoviedb.org 时，在「设置 → TMDB」填写第三方反代地址（填到含 /3 为止，只填域名自动补 /3），API 请求全部改走替代源
• 整理策略（每个剧集分组一键切换）：

• 默认策略：按文件名 / 文件夹正常识别季集
• 单季顺序拆多季：适用「龙珠Z」类动画，按 TMDB 各季集数顺序拆分重编号，超出总集数顺延到最后一季
• 单季跳序拆多季：适用「海贼王」类动画，绝对集号不变，只按 TMDB 季范围改季号
• 多季合并一季：适用「名侦探柯南」类动画，多季合并为一季、集号累加，同名分组连续编号
• TMDB 剧集组：按官方剧集组（DVD 顺序、绝对顺序、故事线）整理，支持原始季集 / 绝对集号 / 播出日期匹配

文件清理

• 条件清理：后缀名 + 关键词 + 大小范围组合筛选，实时容量统计
• 空目录清理：递归检测当前目录或全盘
• 扫描阶段不修改云盘，确认后才执行

操作记录与一键还原

• 媒体整理与批量重命名执行成功后自动记录，按刮削文件夹名聚合，列表自然排序
• 记录详情可展开文件清单：原文件名、新文件名、目标路径、校准季集、状态
• 一键还原：改名 + 移动反向重放，被清空的来源目录自动重建；已还原的跳过、被再次动过的标注跳过，不碰手动整理过的文件
• 回收站还原：整理时清理进回收站的旁挂文件同样可还原
• 入口：油猴菜单「打开 123 助手操作记录」

秒传工具箱

• 生成秒传：导出 123FastLink 标准 JSON 与 123FLCPV2 链接（Base62 ETag），文件夹递归
• 转存：支持 123FastLink JSON、V1 / V2 秒传文本、.123share、二级秒传短链，保留目录结构导入当前目录；路径自动清理（连续空格折叠、非法字符删除），点开头的隐藏文件等无法处理的条目跳过并计数，不再因个别坏条目中止整包
• 大文件流式转存：本地秒传 JSON 按块流式解析，GB 级、千万级条目不卡死页面；转存断点分片存档，中断后重跑自动跳过已完成项
• 导入线路直连（可选）：秒传设置开启后，导入 / 导出请求直连 api.123278.com（实测 16~24 线程约 150 次/秒），请求失败自动回退默认域名
• 导入并发：默认线路固定 32 起（实测 85 req/s 零频控），直连线路上「写入并发」设置 ≥16 生效、否则默认 24
• 二级秒传：整包内容上传为云盘种子文件，对外只分享一条短链；对方转存时自动还原全部文件。种子默认存当前目录，可在秒传设置里固定文件夹
• 扫描断点续传：导出扫描进度实时落盘，中断、刷新后自动续接；抢救导出剔除缺 Etag 的文件（进度 7 天过期）
• 工具栏常驻「秒传」按钮：无勾选点击打开工具箱，勾选秒传种子文件时点击直接转存
• 分享链接生成 JSON：粘贴 123 分享链接递归生成秒传 JSON，支持批量；分享目录请求直连 www.123865.com 全速扫描，撞限流自动冷却续扫
• 拆分 JSON：按目录层级、文件数量或季集 / 剧名拆分大秒传文件
• 格式转换：.123share 与标准 JSON 本地互转
• 影库搜索：连接 123Cloud 客户端影库接口，按分类浏览、模糊搜索、整部作品一键转存或勾选单文件转存
• 过滤设置：生成 / 转存时按扩展名跳过 nfo、图片、字幕等
• 仅保存链接：把秒传链接文本保存为云盘文本文件

分享与投稿

• 批量分享：每个顶层项单独创建分享（相同分享自动复用），永久有效 + 随机口令，一键复制全部链接
• 一键投稿：分享创建后自动推送到 123Cloud 客户端——别人的分享进入搬运队列，自己的分享生成投稿草稿
• 分享页导出 CSV：导出自己的分享列表（限流时自动退避重试）

登录会话复用

同一账号在多个浏览器登录会在 123 云盘新增多台设备。脚本支持把一个浏览器里的登录会话导出，在其余浏览器导入，全部浏览器共用同一会话：

1. 前提：运行 123Cloud 客户端，脚本「设置 → 分享与秒传」填好影库接口地址（与影库访问令牌）；
2. 推送：在已登录的浏览器里，通过油猴菜单「推送登录会话到客户端」把会话存档到客户端；
3. 拉取：在其他浏览器打开 123 云盘任意页面（含 user.123pan.cn 登录页，未登录状态即可），通过油猴菜单「从客户端拉取登录会话」——脚本会自动跳到推送来源的网盘页（如 yun.123pan.cn）写回登录；在网盘页拉取则直接生效；
4. 会话过期后在已登录浏览器重新推送一次即可。入口只有油猴菜单（Tampermonkey 扩展图标里），设置面板不设会话 UI——登录页 user.123pan.cn 没有面板，菜单在所有页面都可用。

公开分享页

• 隐藏顶部拉新横幅与会员广告
• 「生成秒传 JSON」按钮：无需登录 123 账号，递归读取公开分享生成秒传文件（加密分享需先输提取码）

使用方式

安装

1. 浏览器安装 Tampermonkey；
2. 任选其一：

• 从 Greasy Fork 安装（推荐，自动更新）：打开脚本主页点「安装此脚本」；
• 把 123-helper.user.js 拖入浏览器，由 Tampermonkey 接管安装；
• 或在 Tampermonkey 面板新建脚本，粘贴 123-helper.user.js 全部内容保存。

更新

用新版 123-helper.user.js 覆盖安装后刷新页面。Greasy Fork 安装的会自动更新；本地覆盖安装的以脚本头部 @version 为准。

基本使用

1. 访问 123 云盘网页版，文件页工具栏出现「秒传」「设置」等入口；
2. 批量操作：勾选文件后右键，或使用工具栏按钮，均先预览再执行；
3. 秒传工具箱：工具栏「秒传」按钮打开，按页签使用生成 / 转存 / 二级秒传 / 拆分 / 互转 / 影库搜索；
4. 设置：文件页工具栏「设置」或油猴菜单「打开 123 助手设置」；
5. 会话复用：见上文「登录会话复用」一节。

与 123Cloud 客户端联动（可选）

1. 安装并保持 123Cloud 客户端运行，「设置 → 服务端口」固定一个端口；
2. 一键投稿：脚本设置页「投稿地址」填 http://127.0.0.1:<端口>/api/submission/submit；
3. 影库搜索：脚本设置页「影库接口地址」填 http://127.0.0.1:<端口>，客户端影库设置了访问令牌时填同一串令牌；
4. 客户端「影库」页导入影库数据后，即可在网页端随时搜索转存。

注意事项与已知限制

• 投稿 / 影库接口只监听 127.0.0.1，脚本与客户端必须在同一台电脑上；建议固定客户端服务端口。
• 二级秒传的种子文件删除后对应短链失效；可在秒传设置里固定到专门文件夹。
• 扫描断点进度 7 天后过期；抢救导出会剔除缺 Etag 的文件而非整体报错。
• 跨域请求（TMDB、客户端接口、镜像线路）首次使用时 Tampermonkey 可能弹权限确认，选「总是允许」。
• 网盘登录态只存在各网盘页域名（www/yun.* 官方域名）自己的 localStorage 里，登录页/其他页面写入无效；拉取时脚本自动跳到推送来源的网盘页完成写入（会话暂存 10 分钟内有效）。
• 「推送/拉取到客户端」需要运行 123Cloud 客户端并填好影库接口地址；会话存档在客户端本机，鉴权与影库访问令牌同门。客户端的 123 OpenAPI token 与网页端会话不互通（官方无转换通道），因此客户端只能中转会话、不能凭空生成网页登录态。
• 只支持 123 云盘网页端，不覆盖官方桌面 / 移动客户端；官方页面改版后个别功能可能需要适配。
• TMDB 识别与海报需要能访问 api.themoviedb.org（或配置替代源）。
• 版本号遵循 Greasy Fork 规则：在上一个已发布版本基础上 +1，不跳号、不回退。

常见问题

• 装了脚本页面没反应？ 确认 Tampermonkey 与脚本开关已启用、域名在适用列表内，刷新页面，排查其他 123 相关脚本冲突。
• 一键投稿后客户端没出现草稿？ 确认客户端在运行、投稿地址端口与客户端「服务端口」一致、地址带完整路径 /api/submission/submit。
• 影库搜索连不上？ 确认客户端影库已导入数据、接口地址端口一致、访问令牌填写一致。
• 转存中断 / 部分失败？ 重跑同一内容，断点续传自动跳过已成功项。
• 重命名改错了？ 设置里的「重命名历史」可以恢复。
• 导入秒传 JSON 提示跳过了很多条？ 脚本会自动清理路径（连续空格折叠、非法字符删除）并跳过无法处理的条目（点开头隐藏文件、坏 Etag、坏大小），结果页有分类统计；只影响坏条目，其余文件正常导入。

反馈

问题与建议请到 123Cloud Issues 提交。