Bot

Telegram 机器人

Telegram Bot 可以让您在手机或桌面 Telegram 中查看任务、选择账号、搜索 CloudSaver 资源、创建任务、追剧和查看订阅状态。

---

1. 接入配置

进入 系统 页，在 Telegram 机器人 中配置：

配置项	说明
Bot Token	从 @BotFather 获取
默认 Chat ID	默认交互和通知接收对象
反代 API 域名 (可选)	Telegram API 反代地址
允许使用的 Chat ID 列表	允许控制 Bot 的用户或群组
管理员 Chat ID 列表	可执行管理员操作的 Chat ID
成功通知	是否发送成功通知
失败通知	是否发送失败通知
刮削通知	是否发送刮削通知

配置完成后可以点击 测试配置。

如果服务器无法直接访问 Telegram，请同时配置 系统 页中的网络代理。

---

2. 基础使用流程

推荐顺序：

1. /accounts 选择账号。
2. /fl 查看常用目录。
3. 直接发送 cloud.189.cn 分享链接创建任务。
4. /search_cs 搜索 CloudSaver 资源。
5. /tasks 查看任务状态。

如果未选择账号，多数需要账号上下文的命令会提示：请先使用 /accounts 选择账号。

---

3. 常用命令

基础命令

命令	说明
/start	首次使用引导
/help	显示帮助信息
/accounts	查看并切换账号
/cancel	取消当前操作
/stats	查看系统统计
/logs	查看最近日志
/logs_<ID>	查看指定任务日志
/silent	设置静默模式

任务相关

命令	说明
/tasks	查看任务列表
/tasks_failed	查看失败任务
/tasks_pending	查看待执行任务
/tasks_processing	查看执行中任务
/execute_<ID>	执行指定任务
/execute_all	执行所有任务（管理员）
/detail_<ID>	查看任务详情
/retry_<ID>	重试失败任务（管理员）
/strm_<ID>	为指定任务生成 STRM
/emby_<ID>	通知 Emby 刷新
/dt_<ID>	删除指定任务（管理员）

目录相关

命令	说明
/fl	显示常用目录列表
/fs	添加常用目录
/df_<ID>	删除常用目录（管理员）

搜索与追剧

命令	说明
/search_cs	进入 CloudSaver 搜索模式
/series 剧名 [年份]	创建普通自动追剧任务
/lazy_series 剧名 [年份]	创建懒转存自动追剧任务
/tmdb 关键字 [年份]	搜索 TMDB 影视信息

订阅

命令	说明
/subs	查看订阅列表

---

4. 直接发送分享链接

Bot 支持直接接收 cloud.189.cn 分享链接。

正常模式下：

1. 发送分享链接。
2. Bot 解析资源名称。
3. Bot 弹出常用目录按钮。
4. 点击目录后创建任务。

如果当前账号没有常用目录，Bot 会提示先添加常用目录。

---

5. 静默模式

通过 /silent 可以开启或关闭静默模式。

开启后：

• Bot 处理分享链接时不再询问保存目录。
• 会直接使用当前账号的默认常用目录创建任务。

适合高频从 Telegram 转存资源的场景。

---

6. CloudSaver 搜索模式

发送 /search_cs 后进入搜索模式。

交互规则：

• 输入关键字进行搜索。
• 输入编号选择结果并转存。
• /cancel 退出搜索模式。
• 3 分钟无操作自动退出。
• 如果此时直接发送分享链接，Bot 会自动退出搜索模式并改为处理该分享链接。

---

7. 自动追剧

Bot 支持：

/series 剧名 年份
/lazy_series 剧名 年份

它会使用 系统 页中的自动追剧默认账号和默认保存目录，与 Web 端自动追剧逻辑一致。

---

8. 权限说明

• 只有 允许使用的 Chat ID 列表 中的对象可以控制 Bot。
• 某些危险操作仅管理员可用，例如：
  • /execute_all
  • /retry_<ID>
  • /dt_<ID>
  • /df_<ID>

---

使用建议

• 初次使用先配置一个默认账号和几个常用目录。
• 高频转存用户建议开启静默模式。
• 搜索不到资源时，优先确认 CloudSaver 配置是否正确。