Home

NGi 中文使用手册

欢迎使用 MDC-NGi（NGi，Next Generation innovation）。NGi 用于识别影片、从多个来源获取元数据、整理媒体文件，并生成供媒体库使用的 NFO、海报、背景图和字幕。

本 Wiki 按实际操作组织，既可以从零开始部署，也可以按问题查找设置。近期变更核对日期：2026-11-06。公开最新应用 Release 为 26.3.3；尚未发布的新增“重新整理”模式与网络设置调整另作标注，详细边界见版本适用范围。

2026-11-06 补充：Emby / Magic Tools 联动刮削指南，包含安装、地址与路径映射、密钥管理、任务查看及排错；功能适用构建见该页说明。

近期更新与常用指南

• 26.3.1：Emby 联动提交影片刮削、分集合并与整组操作。
• 26.3.0：监控目录冲突和独立输出目录、中文片名与 Madouqu 搜索。
• 26.2.9：日亚商品码 OCR 与高清搜索。
• 开发新增，待发布：重新整理使用指南，包含按已有记录整理及可选图片重下。

第一次使用

1. 阅读功能特点，了解能完成哪些工作。
2. 按Docker 部署安装，或直接跟随快速开始。
3. 配置目录挂载与权限，创建登录账号。
4. 按首次配置与界面设置整理目录、来源、图片和命名。
5. 先用少量样本创建手动任务，核对结果。
6. 需要自动处理新文件时，再配置目录监控。

使用手册目录

主题	内容
功能特点	功能范围、处理流程、适用场景与技术组成
快速开始	从 Compose 到第一条成功记录
Docker 部署	完整 Compose、版本固定、启停和容器更新
目录挂载与权限	宿主与容器路径、持久目录、NAS、权限排查
首次配置与界面	登录、菜单、12 个设置标签与配置作用域
手动任务与文件管理	文件浏览、扫描、创建批次、独立配置
Emby / Magic Tools 联动刮削	从 Emby 影片菜单创建 NGi 任务、Docker/原生路径映射与独立密钥管理
目录监控	性能/兼容模式、检查周期、目录独立配置
刮削记录与重试	状态、详情、来源修正、重刮与重新整理
整理模式与覆盖策略	基础整理方式、新增重新整理模式、独立元数据目录、覆盖与失败处理
数据源与优先级	21 个来源、分类优先级、字段优先级与来源参数
元数据翻译与映射	字段校验、翻译、语言、演员表与标签表
自定义演员映射与 AVDB	自定义名字、别名、JSON 导出、AVDB 导入
命名规则	完整变量表、Jinja2、分类、分集、分辨率与预览
日亚商品码 OCR 与高清搜索	开启方法、查询顺序、数字校验、超时与回退
重新整理使用指南	记录操作与新模式的区别、文件移动及可选图片重下（待发布）
图片下载裁剪与水印	主图、高清海报、裁剪策略、水印与独立裁剪工具
字幕匹配与命名	同目录、本地库、在线下载、位置与覆盖
NFO 与媒体库	NFO 字段、标签、合集和 Emby/Plex 对接
网络代理与反爬	代理、Token、Cookie、FlareSolverr/Trawl
通知与 Webhook	事件、分类过滤、模板、请求头和测试
数据库与 PostgreSQL	连接测试、切库、持久存储和旧记录迁移
更新升级与回退	应用 OTA、基础镜像、健康回退与版本规则
备份恢复与迁移	整目录备份、PostgreSQL、加密备份、跨库恢复
日志与故障排查	任务日志、运行日志、常见报错和反馈材料
常见问题	按现象快速找到处理办法
场景配置示例	做种、网盘、旧媒体库、分类整理、分离元数据
配置参数参考	内置初始配置字段索引与默认值
版本适用范围	公开版本与开发功能边界、历史说明纠正

官方入口

• 项目与问题反馈
• 应用更新与版本说明
• Docker Hub 镜像
• Telegram 发布频道
• 支持维护者

NGi 是在原有 Movie Data Capture 工具基础上重构的项目。公开仓库主要承担更新、说明与问题反馈；安装包位于 Releases，Docker 镜像位于 Docker Hub。

---

文档核对：2026-11-06。功能可用性与开发新增项见版本适用范围。