更新 'repository.yaml'
This commit is contained in:
160
cloud189-auto-save/DOCS.md
Normal file
160
cloud189-auto-save/DOCS.md
Normal file
@@ -0,0 +1,160 @@
|
||||
# 天翼云盘自动转存系统
|
||||
|
||||
## 功能特点
|
||||
|
||||
- 支持多账号管理
|
||||
- 自动监控分享链接更新, 自动重命名
|
||||
- 支持企业微信、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机器人创建任务, 如果是老版本系统, 请取消常用目录所有后重新添加
|
||||
Reference in New Issue
Block a user