功能使用
• 识别
———————-
※ 自定义识别词（集偏移、替换+集偏移）
※ 集偏移
• 设置-自定义识别词
• 识别前偏移名称中的集数
• 识别名称中前后定位词之间的所有数字视为集数
• 偏移集数可进行运算
• EP代指集数，EP-1为向前偏移一集，2*EP为集数翻倍
※ 替换+集偏移
• 替换应用生效时，进行集偏移处理
• 替换应用未生效时，不进行集偏移处理
👉 频道目录
• 识别
———————-
※ 自定义识别词（集偏移、替换+集偏移）
※ 集偏移
• 设置-自定义识别词
• 识别前偏移名称中的集数
• 识别名称中前后定位词之间的所有数字视为集数
• 偏移集数可进行运算
• EP代指集数，EP-1为向前偏移一集，2*EP为集数翻倍
※ 替换+集偏移
• 替换应用生效时，进行集偏移处理
• 替换应用未生效时，不进行集偏移处理
👉 频道目录
功能使用
• 识别
———————-
※ 自定义识别词（导入、导出）
• 通过分享代码导入和导出自定义识别词
※ 导出
• 勾选要分享的自定义识别词
• 点击右上角导出，填写备注（应用的资源标题或文件名）
• 生成分享代码
※ 导入
• 点击右上角导入，填入分享代码进行解析
• 勾选要导入的自定义识别词进行导入
• 被替换词不可重复
• 前后定位词不可重复
👉 频道目录
• 识别
———————-
※ 自定义识别词（导入、导出）
• 通过分享代码导入和导出自定义识别词
※ 导出
• 勾选要分享的自定义识别词
• 点击右上角导出，填写备注（应用的资源标题或文件名）
• 生成分享代码
※ 导入
• 点击右上角导入，填入分享代码进行解析
• 勾选要导入的自定义识别词进行导入
• 被替换词不可重复
• 前后定位词不可重复
👉 频道目录
功能使用
• 转移
———————-
※ NASTool包含两种文件转移方法
• 下载软件监控
• 目录同步
• 建议两者二选其一
※ 下载软件监控
• 设置-下载器配置中开启
• 下载任务完成时，将文件从下载目录按分类转移至媒体库目录（设置-媒体库）
• 已处理的下载任务会添加已整理标签，删除该标签可重新处理该下载任务
• 下载目录可按分类及二级分类分别设置
• 下载保存目录：传递给下载器的种子保存目录
• 访问目录：NAStool（容器）访问下载保存目录的路径
※ 目录同步
• 设置-目录同步设置，注意同步方式若为硬链接则源目录和目的目录不能跨盘（群晖中，不同的共享文件夹会被系统认为是跨盘）
• 监控源目录中的文件，将新增文件转移至目的目录
• 硬链接则源目录和目的目录不能跨盘（群晖中，不同的共享文件夹会被系统认为是跨盘）
• 目的目录不要在源目录下
• 服务-清除转移缓存后，可以重新转移已转移过的文件
• QBittorrent下载器请在设置-下载中开启为不完整的文件添加扩展名.!qB
👉 频道目录
• 转移
———————-
※ NASTool包含两种文件转移方法
• 下载软件监控
• 目录同步
• 建议两者二选其一
※ 下载软件监控
• 设置-下载器配置中开启
• 下载任务完成时，将文件从下载目录按分类转移至媒体库目录（设置-媒体库）
• 已处理的下载任务会添加已整理标签，删除该标签可重新处理该下载任务
• 下载目录可按分类及二级分类分别设置
• 下载保存目录：传递给下载器的种子保存目录
• 访问目录：NAStool（容器）访问下载保存目录的路径
※ 目录同步
• 设置-目录同步设置，注意同步方式若为硬链接则源目录和目的目录不能跨盘（群晖中，不同的共享文件夹会被系统认为是跨盘）
• 监控源目录中的文件，将新增文件转移至目的目录
• 硬链接则源目录和目的目录不能跨盘（群晖中，不同的共享文件夹会被系统认为是跨盘）
• 目的目录不要在源目录下
• 服务-清除转移缓存后，可以重新转移已转移过的文件
• QBittorrent下载器请在设置-下载中开启为不完整的文件添加扩展名.!qB
👉 频道目录
功能使用
• 转移
———————-
※ 文件转移过滤
• 满足过滤规则的文件，在转移同步时忽略
• 设置-基础设置-媒体-文件转移忽略词/文件路径转移忽略词
• 使用;分隔
※ 文件转移忽略词
• 若文件名中包含忽略词，识别转移时忽略该文件
• 支持正则表达式，注意特殊字符转义
※ 文件路径转移忽略词
• 若文件路径中包含忽略词，识别转移时忽略该文件
• 支持正则表达式，注意特殊字符转义
👉 频道目录
• 转移
———————-
※ 文件转移过滤
• 满足过滤规则的文件，在转移同步时忽略
• 设置-基础设置-媒体-文件转移忽略词/文件路径转移忽略词
• 使用;分隔
※ 文件转移忽略词
• 若文件名中包含忽略词，识别转移时忽略该文件
• 支持正则表达式，注意特殊字符转义
※ 文件路径转移忽略词
• 若文件路径中包含忽略词，识别转移时忽略该文件
• 支持正则表达式，注意特殊字符转义
👉 频道目录
功能使用
• 转移
———————-
※ 二级分类及测试
• 根据TMDB的genres id（类型）分类
• 设置-基础设置-媒体-二级分类策略
※ 测试方法
• 服务-名称识别测试
• 类型（蓝色1）为一级分类（电影，电视剧，动漫）
• 类别（蓝色2）为一级分类下二级分类（根据分类策略）
• TMDB ID（绿色），季集（橙色）点击可跳转TMDB相应剧集页面验证识别结果
※ 电影按国家地区进行二级分类使用production_countries
👉 频道目录
• 转移
———————-
※ 二级分类及测试
• 根据TMDB的genres id（类型）分类
• 设置-基础设置-媒体-二级分类策略
※ 测试方法
• 服务-名称识别测试
• 类型（蓝色1）为一级分类（电影，电视剧，动漫）
• 类别（蓝色2）为一级分类下二级分类（根据分类策略）
• TMDB ID（绿色），季集（橙色）点击可跳转TMDB相应剧集页面验证识别结果
※ 电影按国家地区进行二级分类使用production_countries
👉 频道目录
功能使用
• 转移
———————-
※ 重命名格式化
• NASTool使用Python的format格式化
• 支持附加参数进行格式化输出
• 占位符{}的转义为{{}}，而不是加\
• {edition}包含WEB-DL等来源及HDR等效果两部分
※ 例如 季数补0至两位
• Season {season} ⇒ Season 1
• Season {season:0>2} ⇒ Season 01
※ 参考资料
• Python format 格式化函数
• Python format格式化输出方法详解
👉 频道目录
• 转移
———————-
※ 重命名格式化
• NASTool使用Python的format格式化
• 支持附加参数进行格式化输出
• 占位符{}的转义为{{}}，而不是加\
• {edition}包含WEB-DL等来源及HDR等效果两部分
※ 例如 季数补0至两位
• Season {season} ⇒ Season 1
• Season {season:0>2} ⇒ Season 01
※ 参考资料
• Python format 格式化函数
• Python format格式化输出方法详解
👉 频道目录
功能使用
• 转移
———————-
※ 文件管理（源文件、媒体库文件）
• 媒体整理-文件管理中查询删除硬链接文件
• 媒体整理-历史记录中删除源文件或媒体库文件
※ 丢失文件的下载任务通过自动删种任务处理
• QB：种子状态 missingFiles
• TR：错误信息 No data found
👉 频道目录
• 转移
———————-
※ 文件管理（源文件、媒体库文件）
• 媒体整理-文件管理中查询删除硬链接文件
• 媒体整理-历史记录中删除源文件或媒体库文件
※ 丢失文件的下载任务通过自动删种任务处理
• QB：种子状态 missingFiles
• TR：错误信息 No data found
👉 频道目录
功能使用
• 转移
———————-
※ 集数定位
• 手动识别/自定义识别-电视剧/动漫
• 单集识别转移时，可直接在集数定位处填写相应集数
• 多集批量识别转移时，主要有以下两种情况
※ 资源名称中只包含集数一个变量，例如
• 第01话.龙之家族.2022.1080P.H265.AAC.mkv
• 第02话.龙之家族.2022.1080P.H265.AAC.mkv
• 第03话.龙之家族.2022.1080P.H265.AAC.mkv
• 每一集的名称只有集数信息不同
• {ep}替换名称中的集数信息
• 将第{ep}话.龙之家族.2022.1080P.H265.AAC.mkv填入集数定位
※ 资源名称中包含集数等多个变量，如集名称，例如
• 第01话.龙的继承者.龙之家族.2022.1080P.H265.AAC.mkv
• 第02话.浪荡王子.龙之家族.2022.1080P.H265.AAC.mkv
• 第03话.伊耿二世.龙之家族.2022.1080P.H265.AAC.mkv
• 每一集的名称除了集数信息还有其他不同（如集名称）
• {ep}替换名称中的集数信息
• {a}等其他变量（只要不是ep皆可）替换名称中的除集数信息外的变化部分
• 将第{ep}话.{a}.龙之家族.2022.1080P.H265.AAC.mkv填入集数定位
👉 频道目录
• 转移
———————-
※ 集数定位
• 手动识别/自定义识别-电视剧/动漫
• 单集识别转移时，可直接在集数定位处填写相应集数
• 多集批量识别转移时，主要有以下两种情况
※ 资源名称中只包含集数一个变量，例如
• 第01话.龙之家族.2022.1080P.H265.AAC.mkv
• 第02话.龙之家族.2022.1080P.H265.AAC.mkv
• 第03话.龙之家族.2022.1080P.H265.AAC.mkv
• 每一集的名称只有集数信息不同
• {ep}替换名称中的集数信息
• 将第{ep}话.龙之家族.2022.1080P.H265.AAC.mkv填入集数定位
※ 资源名称中包含集数等多个变量，如集名称，例如
• 第01话.龙的继承者.龙之家族.2022.1080P.H265.AAC.mkv
• 第02话.浪荡王子.龙之家族.2022.1080P.H265.AAC.mkv
• 第03话.伊耿二世.龙之家族.2022.1080P.H265.AAC.mkv
• 每一集的名称除了集数信息还有其他不同（如集名称）
• {ep}替换名称中的集数信息
• {a}等其他变量（只要不是ep皆可）替换名称中的除集数信息外的变化部分
• 将第{ep}话.{a}.龙之家族.2022.1080P.H265.AAC.mkv填入集数定位
👉 频道目录
功能使用
• 转移
———————-
※ Rclone（移动、复制）
※ 设置配置
• 宿主机安装rclone
• 增加名为NASTOOL的网盘配置
• 映射rclone配置目录到容器内/nt/.config/rclone
• 或在容器内使用rclone添加配置
※ 设置转移
• 目录同步，目的目录填写网盘内路径
• 下载软件监控，媒体库目录填写网盘内路径
• 容器网络务必为bridge
• 网盘可以不用挂载到宿主机或者容器内
※ 转移报错
• 容器内使用rclone copy/move 命令进行排查
※ rclone参数设置
• 启动容器时，添加相关环境变量
• 如：-e RCLONE_TRANSFERS = 16
• 参考：官方文档
👉 频道目录
• 转移
———————-
※ Rclone（移动、复制）
※ 设置配置
• 宿主机安装rclone
• 增加名为NASTOOL的网盘配置
• 映射rclone配置目录到容器内/nt/.config/rclone
• 或在容器内使用rclone添加配置
※ 设置转移
• 目录同步，目的目录填写网盘内路径
• 下载软件监控，媒体库目录填写网盘内路径
• 容器网络务必为bridge
• 网盘可以不用挂载到宿主机或者容器内
※ 转移报错
• 容器内使用rclone copy/move 命令进行排查
※ rclone参数设置
• 启动容器时，添加相关环境变量
• 如：-e RCLONE_TRANSFERS = 16
• 参考：官方文档
👉 频道目录
功能使用
• 订阅
———————-
※ 自定义订阅（下载）
• 解析RSS链接获取的报文（粘贴到浏览器查看报文）
• 获取RSS报文中的资源信息（标题，下载磁链等）
• 将符合过滤条件的资源推送到下载器
※ 新建/编辑订阅-模板
• 从已有订阅中快速新建
※ 已下载历史记录
• 该订阅下载资源的历史记录
• 点击已处理数量（数字）显示
※ 报文预览
• 预览RSS链接获取的报文
• 状态为未处理，匹配，本地不存在的资源将会被下载
• 不想下载的资源可以设置为已处理
• 想要重新下载的资源可以设置为未处理
• 预览页面可以直接下载
• 自定义订阅也可用于其他类型资源下载（游戏，漫画等）
• 开启识别后，下载过的剧集会添加到订阅日历中
👉 频道目录
• 订阅
———————-
※ 自定义订阅（下载）
• 解析RSS链接获取的报文（粘贴到浏览器查看报文）
• 获取RSS报文中的资源信息（标题，下载磁链等）
• 将符合过滤条件的资源推送到下载器
※ 新建/编辑订阅-模板
• 从已有订阅中快速新建
※ 已下载历史记录
• 该订阅下载资源的历史记录
• 点击已处理数量（数字）显示
※ 报文预览
• 预览RSS链接获取的报文
• 状态为未处理，匹配，本地不存在的资源将会被下载
• 不想下载的资源可以设置为已处理
• 想要重新下载的资源可以设置为未处理
• 预览页面可以直接下载
• 自定义订阅也可用于其他类型资源下载（游戏，漫画等）
• 开启识别后，下载过的剧集会添加到订阅日历中
👉 频道目录
功能使用
• 订阅
———————-
※ 自定义订阅（订阅）
• 解析RSS链接获取的报文（粘贴到浏览器查看报文）
• 获取RSS报文中的剧集信息（剧集名、年份等）
• 识别剧集后，添加到电影/电视剧订阅
※ 订阅豆瓣、TMDB、IMDB片单
• 通过RSSHub等软件将豆瓣、TMDB、IMDB片单生成RSS订阅链接
• 添加RSS订阅链接到自定义订阅
👉 频道目录
• 订阅
———————-
※ 自定义订阅（订阅）
• 解析RSS链接获取的报文（粘贴到浏览器查看报文）
• 获取RSS报文中的剧集信息（剧集名、年份等）
• 识别剧集后，添加到电影/电视剧订阅
※ 订阅豆瓣、TMDB、IMDB片单
• 通过RSSHub等软件将豆瓣、TMDB、IMDB片单生成RSS订阅链接
• 添加RSS订阅链接到自定义订阅
👉 频道目录
功能使用
• 微信菜单命令
• 通知
———————-
※ 消息通知（微信）
※ 【NASTool工具设置教程】微信推送篇 （作者：Wu john）
※ nastool微信中转服务器搭建 （作者：Jin Jue）
※ nastool微信搭建vps详细教程（作者：skycc）
※ vps安装npm搭建微信转发（作者：大牛）
※ 强推vps一键搭建微信转发（作者：卖火柴的小男孩）
※ nastool微信代理服务器部署跳坑指北（作者：v）
※ vps一键搭建微信转发docker版（作者：卖火柴的小男孩）
※ 微信通知搭建Caddy代理超简单流程（作者：是我 果然）
※ 宝塔NGINX搭建企业微信中转服务代理（作者：冷曦）
👉 频道目录
• 微信菜单命令
• 通知
———————-
※ 消息通知（微信）
※ 【NASTool工具设置教程】微信推送篇 （作者：Wu john）
※ nastool微信中转服务器搭建 （作者：Jin Jue）
※ nastool微信搭建vps详细教程（作者：skycc）
※ vps安装npm搭建微信转发（作者：大牛）
※ 强推vps一键搭建微信转发（作者：卖火柴的小男孩）
※ nastool微信代理服务器部署跳坑指北（作者：v）
※ vps一键搭建微信转发docker版（作者：卖火柴的小男孩）
※ 微信通知搭建Caddy代理超简单流程（作者：是我 果然）
※ 宝塔NGINX搭建企业微信中转服务代理（作者：冷曦）
👉 频道目录
功能使用
• 通知
———————-
※ 消息通知（Slack）
※ 功能介绍
• 支持消息通知及远程交互
• 无网络环境要求且不限制IP
• 使用体验可保持与微信/Telegram一致
※ 使用指南
• 创建工作区
• 创建App应用，打开 Socket Mode
• 开启Event Subscriptions、Bots、Permissions
• Bot Token Scopes 赋于权限 chat:write、im:read、im:history 、channels:read、commands
• Subscribe to bot events 赋于权限 message.im、app_mention
• 按需维护Interactivity & Shortcuts菜单，类型为Global
• 菜单Callback ID需与项目主页说明一致
• 创建 App-Level Tokens 并赋于权限 connections:write
• Install App 到工作区
• 登录工作区将App添加到全体频道
• OAuth & Permissions 中 获取 Bot User OAuth Token
• Basic Information 中 获取 App-Level Tokens
• 填入NAStool，打开交互开关
• 重启NAStool生效
• 下载Slack客户端使用
• 应用需加入全体频道
※ 流程参考
※ 最新NASTOOL 3.X版本完整教程部署Slack(作者:skycc)
👉 频道目录
• 通知
———————-
※ 消息通知（Slack）
※ 功能介绍
• 支持消息通知及远程交互
• 无网络环境要求且不限制IP
• 使用体验可保持与微信/Telegram一致
※ 使用指南
• 创建工作区
• 创建App应用，打开 Socket Mode
• 开启Event Subscriptions、Bots、Permissions
• Bot Token Scopes 赋于权限 chat:write、im:read、im:history 、channels:read、commands
• Subscribe to bot events 赋于权限 message.im、app_mention
• 按需维护Interactivity & Shortcuts菜单，类型为Global
• 菜单Callback ID需与项目主页说明一致
• 创建 App-Level Tokens 并赋于权限 connections:write
• Install App 到工作区
• 登录工作区将App添加到全体频道
• OAuth & Permissions 中 获取 Bot User OAuth Token
• Basic Information 中 获取 App-Level Tokens
• 填入NAStool，打开交互开关
• 重启NAStool生效
• 下载Slack客户端使用
• 应用需加入全体频道
※ 流程参考
※ 最新NASTOOL 3.X版本完整教程部署Slack(作者:skycc)
👉 频道目录
功能使用
• 其他
———————-
※ 服务详解
※ 手动触发定时任务类
• RSS订阅
• 订阅搜索
• 下载文件转移
• 自动删种
• 站点签到
• 目录同步
• 豆瓣想看
※ 缓存清理类
• 清理转移缓存（重新目录同步）
• 清理RSS缓存（重新订阅下载）
※ 测试类
• 名称识别测试
• 过滤规则测试
• 网络连通性测试
※ 名称识别测试
• 根据输入的资源名称进行名称识别
• 测试结果：类型（蓝色），名称中剧集名和识别剧集名（红色），年份（橙色），tmdbid（绿色，此为识别成功的标志），视频信息（灰色），制作组/字幕组（黄色）
• 点击tmdbid（绿色），季集（橙色）可跳转相应tmdb页面
※ 过滤规则测试
• 根据输入的标题，大小，副标题进行规则测试
• 测试结果：是否匹配（绿色），命中规则组（橙色），命中规则在规则组内排序（蓝色）
• 若rss订阅或搜索时，日志中目标种子不符合过滤规则，建议进行过滤规则测试查找原因
👉 频道目录
• 其他
———————-
※ 服务详解
※ 手动触发定时任务类
• RSS订阅
• 订阅搜索
• 下载文件转移
• 自动删种
• 站点签到
• 目录同步
• 豆瓣想看
※ 缓存清理类
• 清理转移缓存（重新目录同步）
• 清理RSS缓存（重新订阅下载）
※ 测试类
• 名称识别测试
• 过滤规则测试
• 网络连通性测试
※ 名称识别测试
• 根据输入的资源名称进行名称识别
• 测试结果：类型（蓝色），名称中剧集名和识别剧集名（红色），年份（橙色），tmdbid（绿色，此为识别成功的标志），视频信息（灰色），制作组/字幕组（黄色）
• 点击tmdbid（绿色），季集（橙色）可跳转相应tmdb页面
※ 过滤规则测试
• 根据输入的标题，大小，副标题进行规则测试
• 测试结果：是否匹配（绿色），命中规则组（橙色），命中规则在规则组内排序（蓝色）
• 若rss订阅或搜索时，日志中目标种子不符合过滤规则，建议进行过滤规则测试查找原因
👉 频道目录
功能使用
• 其他
———————-
※ 自动删种（种子管理）
• 下载管理-自动删种中添加管理任务
• 支持Qbittorrent及Transmission
• 定时对满足设置规则的种子进行暂停/删除/删除及文件操作
• 可用于清理站点删种种子、缺失文件种子等
👉 频道目录
• 其他
———————-
※ 自动删种（种子管理）
• 下载管理-自动删种中添加管理任务
• 支持Qbittorrent及Transmission
• 定时对满足设置规则的种子进行暂停/删除/删除及文件操作
• 可用于清理站点删种种子、缺失文件种子等
👉 频道目录
功能使用
• 其他
———————-
※ 播放限速
• 媒体服务器进行外网媒体播放时，对下载器进行限速，停止播放后恢复
• 不限速地址进行媒体播放时，不进行限速
• 插件-播放限速中设置
• 媒体服务器需设置webhook，
• 如emby传入http://NAStool地址/emby
• webhook内容勾选播放开始与播放停止
👉 频道目录
• 其他
———————-
※ 播放限速
• 媒体服务器进行外网媒体播放时，对下载器进行限速，停止播放后恢复
• 不限速地址进行媒体播放时，不进行限速
• 插件-播放限速中设置
• 媒体服务器需设置webhook，
• 如emby传入http://NAStool地址/emby
• webhook内容勾选播放开始与播放停止
👉 频道目录
功能使用
• 其他
———————-
※ Jellyseerr/Overseerr调用
• 设定-通知-网络钩子
• URL填入https://NAStool地址/subscribe
• Authorization填入API密钥
👉 频道目录
• 其他
———————-
※ Jellyseerr/Overseerr调用
• 设定-通知-网络钩子
• URL填入https://NAStool地址/subscribe
• Authorization填入API密钥
👉 频道目录