mirror of
https://gitcode.com/waxgourd/addons
synced 2025-12-06 12:28:28 +08:00
161 lines
6.6 KiB
Markdown
161 lines
6.6 KiB
Markdown
# 天翼云盘自动转存系统
|
||
|
||
## 功能特点
|
||
|
||
- 支持多账号管理
|
||
- 自动监控分享链接更新, 自动重命名
|
||
- 支持企业微信、Telegram, Bark, Wxpusher 消息推送
|
||
- Web 界面管理，响应式布局, 操作便捷
|
||
- Docker 部署，方便维护
|
||
- 支持 STRM 文件生成
|
||
- 支持 Emby 媒体库自动刷新
|
||
- 支持自动清理回收站
|
||
|
||
## 快速开始
|
||
|
||
- 设置-加载项-加载项商店 安装cloud189-auto-save
|
||
- 启动-打开网页界面（WEB UI 浏览器访问）`http://homeassistant.local:3000`
|
||
- 默认账号密码为admin admin 登录后请在系统页修改密码
|
||
|
||
## 使用说明
|
||
|
||
### 1. 账号管理
|
||
- 支持账号密码登录和 Cookie 登录两种方式
|
||
- Cookie 登录步骤：
|
||
1. 打开天翼云盘官网登录界面
|
||
2. 打开浏览器的开发者工具(ctrl+f12), 勾选保留日志
|
||
3. 正常发起登录, 然后在开发者工具中选择网络(network)
|
||
4. 在请求中找到 loginSubmit.do, 点击打开详情
|
||
5. 获取 set-cookie 中的 SSON 值（只需要 SSON=xxxxx 中的 xxxxx 部分）
|
||
6. 填入账号创建中的 cookie 中即可
|
||
7. 可点击媒体目录和本地目录设置STRM的访问前缀
|
||
|
||
### 2. 任务管理
|
||
- 创建任务需填写：
|
||
- 选择账号
|
||
- 分享链接（支持加密链接，需填写访问码）
|
||
- 保存目录（支持目录树选择）
|
||
- 总集数（可选，用于追更进度统计）
|
||
- 文件名匹配规则（可选，用于过滤文件）
|
||
- 支持批量任务创建：首次创建时会自动识别分享链接中的目录结构
|
||
- 支持手动执行任务
|
||
- 支持删除任务（可选是否同时删除云盘文件）
|
||
|
||
### 3. 自动重命名
|
||
- 支持两种重命名方式：
|
||
- 正则表达式重命名：支持后续自动更新时应用同样的规则
|
||
- 顺序重命名：适合一次性重命名
|
||
- 操作步骤：
|
||
1. 点击任务的更新目录
|
||
2. 选择需要重命名的文件
|
||
3. 点击批量重命名按钮
|
||
4. 选择重命名方式并设置规则
|
||
5. 预览重命名效果
|
||
6. 确认保存
|
||
|
||
### 4. 系统设置
|
||
- 任务设置：
|
||
- 任务过期天数：超过指定天数未更新的任务自动标记完成
|
||
- 任务重试次数和间隔
|
||
- 定时检查时间（支持 Cron 表达式）
|
||
- 自动清空回收站（支持个人和家庭网盘）
|
||
- 媒体设置：
|
||
- STRM 文件生成：自动为媒体文件生成对应的 STRM 文件
|
||
- Emby 通知：支持自动刷新 Emby 媒体库
|
||
- 路径替换规则说明：
|
||
1. 示例场景：
|
||
- 天翼云盘中的文件路径：`/影视剧/电视剧/北上/Season 01/S01E01.mkv`
|
||
- Emby 媒体库中的路径：`/cloud/天翼云盘/电视剧`
|
||
- 账号中的Emby路径替换配置：`/影视剧:/cloud/天翼云盘`
|
||
|
||
2. 替换执行逻辑：
|
||
- 系统会优先尝试完整路径匹配：
|
||
`/cloud/天翼云盘/电视剧/北上/Season 01`
|
||
- 如果完整路径不存在，会逐级向上查找：
|
||
`/cloud/天翼云盘/电视剧/北上`
|
||
`/cloud/天翼云盘/电视剧`
|
||
- 如果所有层级都未找到匹配项，将执行全库扫描
|
||
- 消息推送：
|
||
- 企业微信
|
||
- Telegram
|
||
- Bark
|
||
- WxPusher
|
||
|
||
### 5. Telegram 机器人使用
|
||
- 配置说明：
|
||
1. 在 [@BotFather](https://t.me/BotFather) 创建机器人并获取 Token
|
||
2. 在系统设置中填入 Bot Token 并启用 Telegram 通知
|
||
3. 与机器人开始对话即可使用
|
||
|
||
- 可用命令：
|
||
- `/help` - 显示帮助信息
|
||
- `/accounts` - 显示账号列表
|
||
- `/tasks` - 显示任务列表
|
||
- `/execute_all` - 执行所有任务
|
||
- `/fl` - 显示常用目录列表
|
||
- `/fs` - 添加常用目录
|
||
- `/search_cs` - 搜索CloudSaver资源
|
||
- `/cancel` - 取消当前操作
|
||
|
||
- 任务操作命令：
|
||
- `/execute_[ID]` - 执行指定任务
|
||
- `/strm_[ID]` - 生成STRM文件
|
||
- `/emby_[ID]` - 通知Emby刷新
|
||
- `/dt_[ID]` - 删除指定任务
|
||
|
||
- 目录操作命令：
|
||
- `/df_[ID]` - 删除指定常用目录
|
||
|
||
- 使用流程：
|
||
1. 选择账号：使用 `/accounts` 命令查看并选择要使用的账号
|
||
2. 常用目录管理
|
||
- 使用 `/fl` 查看当前账号的常用目录列表
|
||
- 使用 `/fs` 进入目录树选择模式
|
||
- 在目录树中可以：
|
||
* 点击文件夹名称进入下级目录
|
||
* 点击返回按钮回到上级目录
|
||
* 点击确认按钮保存当前目录
|
||
* 已添加为常用目录的文件夹会显示 ✅ 标记
|
||
- 使用 `/df_[ID]` 可删除指定的常用目录
|
||
3. 创建转存任务
|
||
- 直接发送天翼云盘分享链接即可
|
||
- 支持以下格式：
|
||
* 普通链接：`https://cloud.189.cn/t/xxxxx`
|
||
* 带访问码链接：`https://cloud.189.cn/t/xxxxx（访问码：xxxx）`
|
||
- 发送链接后会显示常用目录列表
|
||
- 选择保存目录后即可创建任务
|
||
- 如目标位置已存在同名文件夹：
|
||
* 会询问是否覆盖
|
||
* 选择是则删除原文件夹后保存
|
||
* 选择否则取消任务创建
|
||
4. 任务管理
|
||
- 使用 `/tasks` 查看当前任务列表
|
||
- 可进行以下操作：
|
||
* `/execute_[ID]` 立即执行指定任务
|
||
* `/strm_[ID]` 为任务生成STRM文件
|
||
* `/emby_[ID]` 通知Emby刷新指定任务
|
||
* `/dt_[ID]` 删除指定任务（可选是否同时删除云盘文件）
|
||
- 使用 `/execute_all` 可执行所有未完成的任务
|
||
5. CloudSaver资源搜索
|
||
- 使用 `/search_cs` 进入搜索模式
|
||
- 直接输入关键字即可搜索
|
||
- 搜索结果支持点击复制链接
|
||
- 点击保存命令可直接创建任务
|
||
- 使用 `/cancel` 或 3分钟未操作会自动退出搜索模式
|
||
注意事项：
|
||
- 确保选择了正确的账号再进行操作
|
||
- 常用目录建议选择固定的存储位置
|
||
- 带访问码的链接请严格按照格式发送
|
||
- 任务创建后会自动执行，也可手动触发
|
||
- 搜索模式下仅响应搜索关键字，其他命令请先退出
|
||
|
||
## 注意事项
|
||
- 更新目录可以任意移动但不能被删除, 否则任务无法执行
|
||
- 数据库文件会持久化保存在宿主机的 data 目录
|
||
- 支持容器自动重启
|
||
- 推荐使用反向代理进行安全访问
|
||
- 媒体文件后缀配置会影响文件计数和过滤
|
||
- STRM 文件生成需要配置正确的访问前缀
|
||
- Emby 通知需要配置正确的服务器地址和 API Key
|
||
- 如需使用TG机器人创建任务, 如果是老版本系统, 请取消常用目录所有后重新添加
|