syscc/openlistsync repository overview

version: "3.8"
services:
  openlistsync:
    image: syscc/openlistsync:latest
    container_name: openlistsync
    restart: always
    network_mode: bridge
    ports:
      - "8023:8023"
    user: "1000:1001"
    environment:
      - WEBHOOK_DELAY=60 # Webhook延迟触发秒数 取决是否需要等MoviePilot刮削完成后同步，如果不需要可以设置为3
      # - WEBHOOK_APIKEY= # Webhook API Key；若设置，则请求必须包含 apikey 字段且值匹配；若留空则不校验
      # - WEBHOOK_OPENLIST_NAME=OpenList # Webhook 自动创建任务时使用的 OpenList 引擎备注名；若未配置或留空，默认使用第一个引擎
      - TVsource=/media/电视剧        # 电视剧源根目录
      - MOVsource=/media/电影        # 电影源根目录
      # DST开头变量适用于临时存放（如追新电视剧），整季完结后可删除并同步至SYNC路径，非必要不需要启用！
      # - DST_TV_TARGETS=/shanct/电视剧 # 优先同步电视剧到此集合；支持 ,;: 分隔
      # - DST_MOV_TARGETS=/shanct/电影  # 优先同步电影到此集合；支持 ,;: 分隔
      # - DST_REFRESH_TV=/media/电视剧,/videos/电视剧 # DST 同步时的刷新集合；支持 ,;: 分隔
      # - DST_REFRESH_MOV=/media/电影,/videos/电影    # DST 同步时的刷新集合；支持 ,;: 分隔
      - SYNC_TV_TARGETS=/115/videos/电视剧,/ODC/tv{max}/电视剧   # 回退电视剧同步集合；{max} → 自动匹配最大数字后缀目录
      - SYNC_MOV_TARGETS=/115/videos/电影,/ODC/mov{max}/电影     # 回退电影同步集合；{max} → 自动匹配最大数字后缀目录
      - SYNC_REFRESH_TV=/115/videos/电视剧,/ODC/tv{max}/电视剧,/videos/电视剧 # SYNC 同步时的刷新集合
      - SYNC_REFRESH_MOV=/115/videos/电影,/ODC/mov{max}/电影,/videos/电影   # SYNC 同步时的刷新集合
      - SECOND=true # 启用二级目录（从 webhook 文本“类别：xxx”解析为二级路径，电视剧与电影均支持）
    volumes:
      - ./data:/app/data

OpenlistSync/
├── main.py                         # Tornado 后端入口，注册 Web/API/静态资源路由
├── main_android.py                 # Android WebView 主进程入口
├── buildozer.spec                  # Android arm64-v8a/armeabi-v7a 构建配置
├── openlistsync.spec               # PyInstaller 与 StaticX 共用打包配置
├── logo*.png                       # Android 普通与自适应图标资源
├── requirements.txt                # Python 运行依赖
├── Dockerfile                      # 默认 Docker 镜像构建入口
├── docker-compose.yaml             # Docker Compose 示例
├── dockerfiles/                    # 多平台/不同构建方式的 Dockerfile
├── common/                         # 通用配置、数据库连接、日志、语言与工具方法
│   ├── config.py                   # 读取 data/config.ini、环境变量与默认配置
│   ├── httpApp.py                  # 桌面、容器与 Android 共用的 Tornado 路由工厂
│   ├── locales.py                  # YAML 语言包加载、语言识别与回退
│   ├── sqlBase.py                  # SQLite 基础访问封装
│   └── sqlInit.py                  # 数据库初始化与版本迁移
├── locales/                        # 后端简体中文与 English 语言包
├── controller/                     # Tornado API 控制器
│   ├── baseController.py           # 登录态校验与统一响应封装
│   ├── jobController.py            # 作业、任务与引擎接口
│   ├── mediaScrapingController.py  # 媒体名字刮削配置、浏览、预览、执行与任务接口
│   ├── notifyController.py         # 通知配置接口
│   ├── systemController.py         # 用户、语言、系统配置接口
│   └── webhookController.py        # Webhook 入口
├── mapper/                         # SQLite 数据访问层
│   ├── jobMapper.py                # 作业与任务数据
│   ├── mediaScrapingMapper.py      # 媒体名字刮削任务、执行日志与明细数据
│   ├── notifyMapper.py             # 通知配置数据
│   ├── openlistMapper.py           # OpenList 引擎数据
│   ├── systemConfigMapper.py       # 系统配置数据，如全局排除项和代理服务器
│   └── userMapper.py               # 用户数据
├── media_tools/                    # 媒体整理核心工具
│   └── openlist_media_renamer.py   # OpenList 媒体识别、TMDb 查询、命名预览与重命名执行
├── service/                        # 业务逻辑层
│   ├── main.py                     # Android 后台服务与本机日志页入口
│   ├── mediaScraping/              # 媒体名字刮削配置、预览、后台任务、日志与中止逻辑
│   ├── openlist/                   # OpenList API 客户端与引擎管理
│   ├── syncJob/                    # 作业调度、同步执行、任务统计
│   ├── notify/                     # 通知发送
│   ├── system/                     # 启动初始化、日志清理、用户与系统配置
│   └── webhook/                    # Webhook 解析、自动建作业与刷新
├── web/                            # 当前 Vue 3 + Vite 前端源码
│   ├── public/                     # 前端公共静态资源
│   ├── src/
│   │   ├── api/                    # 前端 API 封装
│   │   ├── router/                 # 前端路由
│   │   ├── store/                  # Pinia 状态
│   │   ├── utils/                  # 前端工具与枚举
│   │   └── views/                  # 页面与组件，含作业管理、媒体名字刮削和集中式系统设置等
│   ├── package.json                # 前端依赖与脚本
│   └── vite.config.js              # Vite 开发服务与代理配置
├── tests/                          # 后端迁移、配置、同步过滤与通知测试
├── README/                         # README 引用的截图资源
├── doc/                            # 文档与历史 changelog
└── data/                           # 源码启动脚本与本地运行数据
    ├── start.py                    # 源码模式安装依赖、启动、停止与重启脚本
    ├── openlistsync.db             # SQLite 数据库（本地生成，不提交）
    ├── config.ini                  # 可选运行配置
    ├── secret.key                  # Cookie 签名密钥
    └── log/                        # 运行日志