docs: add nas paths and organization templates

README.md

@@ -479,6 +479,29 @@ docker compose up -d
 | 成人内容 | `/media/Adult` |
 | 下载入库 | `/downloads/Movies`、`/downloads/TV` 等 |
 
+#### NAS 绝对路径写法
+
+NAS、飞牛、绿联、群晖、威联通等系统里，媒体目录通常是系统绝对路径。compose 中必须写 `/vol1/...`、`/volume1/...`、`/mnt/...` 这类从根目录开始的路径，不要写成 `./vol1/...`。
+
+```yaml
+# 正确：宿主机绝对路径
+- /vol1/1000/Docker/moviepilot-v2/media:/media:ro
+- /vol1/1000/qBittorrent/downloads:/downloads
+
+# 错误：这是相对当前 compose 目录的路径
+- ./vol1/1000/Docker/moviepilot-v2/media:/media:ro
+- ./vol1/1000/qBittorrent/downloads:/downloads
+```
+
+也可以放到 `.env` 里统一管理：
+
+```env
+MEDIASTATION_MEDIA_DIR=/vol1/1000/Docker/moviepilot-v2/media
+MEDIASTATION_DOWNLOAD_DIR=/vol1/1000/qBittorrent/downloads
+```
+
+容器内路径仍然填写 `/media` 和 `/downloads`，例如媒体库添加 `/media/Movies`，下载器保存路径填写 `/downloads/Movies`。
+
 ### 下载器路径怎么填
 
 如果 qBittorrent 也运行在 Docker 中，必须让 qBittorrent 与 MediaStationGo 看到同一份下载目录。
@@ -752,6 +775,50 @@ tvshow.nfo
 episode.nfo
 ```
 
+### 整理与刮削命名模板
+
+整理规则建议按媒体类型拆分。剧集、动漫、综艺都属于连续剧集类，应保留剧名、年份、季目录、季集号和分集标题；电影类则保留片名、年份、分段和视频规格。
+
+剧集 / 动漫 / 综艺推荐模板：
+
+```jinja
+{{title}}{% if year %} ({{year}}){% endif %}/Season {{season}}/{{title}} - {{season_episode}}{% if part %}-{{part}}{% endif %}{% if episode %} - 第 {{episode}} 集{% endif %}{{fileExt}}
+```
+
+输出示例：
+
+```text
+孤独的美食家 (2024)/Season 01/孤独的美食家 - S01E01 - 第 1 集.mkv
+某动画 (2025)/Season 02/某动画 - S02E03 - 第 3 集.mkv
+某综艺 (2026)/Season 2026/某综艺 - S2026E01 - 第 1 集.mp4
+```
+
+电影推荐模板：
+
+```jinja
+{{title}}{% if year %} ({{year}}){% endif %}/{{title}}{% if year %} ({{year}}){% endif %}{% if part %}-{{part}}{% endif %}{% if videoFormat %} - {{videoFormat}}{% endif %}{{fileExt}}
+```
+
+输出示例：
+
+```text
+盗梦空间 (2010)/盗梦空间 (2010) - 1080p.mkv
+沙丘 (2021)/沙丘 (2021)-CD1 - 2160p.mkv
+```
+
+常用变量说明：
+
+| 变量 | 说明 |
+| --- | --- |
+| `title` | 媒体标题，优先使用本地 NFO / 在线元数据识别后的标题 |
+| `year` | 年份，存在时追加到目录和文件名中 |
+| `season` | 季号，剧集/动漫/综艺用于生成 `Season 01` 等目录 |
+| `season_episode` | 季集号，例如 `S01E01`、`S2026E01` |
+| `episode` | 分集序号，用于中文分集标题 |
+| `part` | 分段标记，例如 `CD1`、`Part1` |
+| `videoFormat` | 视频规格，例如 `1080p`、`2160p`、`WEB-DL` |
+| `fileExt` | 原始文件扩展名，例如 `.mkv`、`.mp4` |
+
 ---
 
 ## 🔎 发现、搜索与订阅下载

README_EN.md

@@ -348,6 +348,29 @@ then add libraries in the web UI using container paths:
 | Adult | `/media/Adult` |
 | Downloaded media | `/downloads/Movies`, `/downloads/TV`, etc. |
 
+#### NAS Absolute Path Syntax
+
+On NAS systems, media folders are usually absolute host paths. In compose, use paths starting from the filesystem root, such as `/vol1/...`, `/volume1/...`, or `/mnt/...`; do not use `./vol1/...` unless that directory really exists under the compose project directory.
+
+```yaml
+# Correct: absolute host paths
+- /vol1/1000/Docker/moviepilot-v2/media:/media:ro
+- /vol1/1000/qBittorrent/downloads:/downloads
+
+# Wrong: relative to the compose directory
+- ./vol1/1000/Docker/moviepilot-v2/media:/media:ro
+- ./vol1/1000/qBittorrent/downloads:/downloads
+```
+
+You can also keep the paths in `.env`:
+
+```env
+MEDIASTATION_MEDIA_DIR=/vol1/1000/Docker/moviepilot-v2/media
+MEDIASTATION_DOWNLOAD_DIR=/vol1/1000/qBittorrent/downloads
+```
+
+Inside MediaStationGo, still use container paths such as `/media/Movies` for libraries and `/downloads/Movies` for download targets.
+
 ### Download Client Paths
 
 If qBittorrent also runs in Docker, make sure qBittorrent and MediaStationGo share the same host directory and use consistent container paths.
@@ -620,6 +643,50 @@ tvshow.nfo
 episode.nfo
 ```
 
+### Organization and Scraping Naming Templates
+
+Use separate organization templates by media type. TV shows, anime, and variety shows should keep title, year, season folder, season/episode number, and episode title. Movies should keep title, year, part marker, and video format.
+
+Recommended template for TV / anime / variety:
+
+```jinja
+{{title}}{% if year %} ({{year}}){% endif %}/Season {{season}}/{{title}} - {{season_episode}}{% if part %}-{{part}}{% endif %}{% if episode %} - 第 {{episode}} 集{% endif %}{{fileExt}}
+```
+
+Example output:
+
+```text
+Some Show (2024)/Season 01/Some Show - S01E01 - 第 1 集.mkv
+Some Anime (2025)/Season 02/Some Anime - S02E03 - 第 3 集.mkv
+Some Variety (2026)/Season 2026/Some Variety - S2026E01 - 第 1 集.mp4
+```
+
+Recommended template for movies:
+
+```jinja
+{{title}}{% if year %} ({{year}}){% endif %}/{{title}}{% if year %} ({{year}}){% endif %}{% if part %}-{{part}}{% endif %}{% if videoFormat %} - {{videoFormat}}{% endif %}{{fileExt}}
+```
+
+Example output:
+
+```text
+Inception (2010)/Inception (2010) - 1080p.mkv
+Dune (2021)/Dune (2021)-CD1 - 2160p.mkv
+```
+
+Common variables:
+
+| Variable | Description |
+| --- | --- |
+| `title` | Media title, preferably from local NFO or online metadata |
+| `year` | Year, appended when available |
+| `season` | Season number, used for `Season 01` folders |
+| `season_episode` | Season/episode code, such as `S01E01` or `S2026E01` |
+| `episode` | Episode number, used for Chinese episode titles |
+| `part` | Part marker, such as `CD1` or `Part1` |
+| `videoFormat` | Video format, such as `1080p`, `2160p`, or `WEB-DL` |
+| `fileExt` | Original file extension, such as `.mkv` or `.mp4` |
+
 ---
 
 ## 🔎 Discovery, Search & Subscriptions