Files
addons/cloud189-auto-save/DOCS.md
2025-11-06 20:07:43 +08:00

6.6 KiB
Raw Blame History

天翼云盘自动转存系统

功能特点

  • 支持多账号管理
  • 自动监控分享链接更新, 自动重命名
  • 支持企业微信、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 创建机器人并获取 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机器人创建任务, 如果是老版本系统, 请取消常用目录所有后重新添加