程序启动与登录

程序成功启动后，可通过绑定的域名或服务器 IP 地址加端口 5000 访问（例如：http://127.0.0.1:5000）。首次登录时，请使用默认凭据：

• 用户名：admin
• 密码：123456

⚠️ 安全提示：登录后请立即修改默认密码，以保障系统安全。

进入主界面后，系统将自动检测当前访问域名或 IP 是否已获得有效授权。若未授权，部分功能将受限。如需获取授权，请联系开发者（微信：iluluink）。

---

主界面概览

程序主页分为三个主要区域：

• 顶部：显示当前授权状态；
• 中部：提供程序功能简介；
• 底部：展示服务器环境信息，包括操作系统、Python 版本、数据库地址及连接状态。

若有新版本可用，系统将在主页显著位置提示，并支持 一键在线更新。

核心功能模块

日志模块

日志模块实时记录系统运行状态，支持动态滚动刷新，始终聚焦最新日志内容。
对于定时任务，日志将以如下格式清晰标识：

[时间] [定时任务名称] [日志内容]

右上角提供 “清空日志” 按钮，便于快速清理历史记录，提升可维护性。

资源管理

资源列表

• 支持封面预览；
• 每项资源右侧提供 查看详情、删除 等操作入口。

资源搜索

在搜索框中输入资源名称，系统将实时匹配并高亮显示相关结果。

资源详情页

展示资源的完整元数据，包括：

• 基础信息（名称、分类、更新时间等）；
• 播放器配置；
• 剧集列表（支持点击直接播放）。

搜索框输入资源名称，对应的资源即可自动弹出

资源详情页面可以查看资源的详细信息，点击对应的剧集还可以直接播放。

资源采集

MacCMS Tools 内置一套智能高效的采集引擎，支持多源对接。

添加资源站

1. 点击右上角 “添加资源站”；
2. 填写任意名称，选择接口类型（如 MacCMS、苹果CMS 等），并输入 API 地址；
3. 点击 “添加” 完成配置。

鼠标悬停于资源站卡片时，右上角将显示 编辑 与 删除 按钮，并高亮标注其接口类型，便于识别。

资源站详情页

• 展示该站点所有可采集资源（含 ID、名称、最新剧集、分类、更新时间等）；
• 提供 分类筛选、关键词搜索、分类映射 及 单条入库 功能。

📌 重要步骤：首次采集前，请务必点击 “分类映射”，将远程分类同步至本地，否则无法正常入库。

手动采集

在搜索框中输入目标资源名称并回车，系统将返回匹配结果。点击 “入库” 即可立即将资源导入本地数据库。

鼠标移动到添加的资源站卡片上，卡片右上角会显示，编辑按钮和删除按钮，以及会在卡片右上角高亮这个资源站的接口类型，方便辨认。

点击卡片即可打开资源站的详细界面，界面包括资源站名字，资源站内的资源列表，id，名字，更新到了哪一集，分类，更新时间，采集按钮等等，分类选择，搜索，分类映射按钮等等。

点击你需要的分类，会显示对应分类下的资源

首选需要点击分类映射按钮，映射分类到本地，映射后即可采集对应分类下的资源

在搜索编辑框输入你要需要的资源回车后，即可查询出你需要的资源，点击入库即可立即入库

此时再点击资源列表会就会发现刚刚采集的资源，比如我刚刚采集到了一个叫东北雷神的资源。

定时任务

程序集成企业级调度引擎，支持灵活创建与管理自动化任务。

任务类型

• 定时采集任务：按设定周期自动拉取指定资源站的更新内容；
• 定时合并任务：执行数据库去重与清洗（详见下文）。

任务卡片

每个任务以独立卡片形式展示，包含：

• 任务名称；
• 上次执行时间；
• 下次计划执行时间；
• “立即执行” 按钮（用于手动触发）。

执行过程中的详细日志将实时输出至 日志模块，便于监控与排查。

点击创建任务按钮，可以选择创建任务类型，点击资源定时采集

此时目标资源站列表会显示，你创建的资源站列表，并且会显示该资源站的接口类型，用于辨认同名但不同接口类型的资源站。

采集时间范围，意思是采集该资源站，什么时间段的资源，1个小时就是采集该资源站，这个小时内更新的资源，1天则是当天更新的资源，以此类推。

点击保存即可保存该定时任务

数据去重与合并（核心亮点）

MacCMS Tools 内置高性能数据库清洗引擎，采用 轻量索引 + 相似度评分模型，非简单字段匹配，确保去重结果精准可靠。

性能表现

• 在 2核2G 低配服务器上，可高效处理 三十万级 数据；
• 实测：37万条记录（1.45GB）的数据库，45秒内完成全量去重；
• 首次建立索引后，后续增量去重可在 数秒内完成，即使面对百万级数据亦游刃有余。

此功能极大降低人工维护成本，保障数据一致性与系统性能。

播放器智能配置

程序支持 自动创建播放器，无需手动干预：

用户仍可通过播放器右侧的 “编辑” 按钮进行高级自定义（如解析接口、加密规则等）。

当采集的资源站使用本地未注册的播放器时，系统将在采集过程中 动态生成对应播放器配置；

点击播放器右侧的编辑按钮还可直接进行高级编辑。

系统设置

设置页面涵盖以下关键配置项：

表格

配置项	说明
后台密码	修改管理员登录凭证
自助换绑	更换授权域名（换绑后有 3天冷却期）
CMS 路径	必填项，格式如 /www/wwwroot/cms（以 / 开头，不以 / 结尾）
CMS 网页域名	若部署了 Web 前端，需填写完整 URL（含 http:// 或 https://）
去重权重	自定义各字段（如标题、演员、简介）在相似度计算中的权重
数据库配置	调整连接参数（通常无需修改）

⚠️ 首次安装必读：务必正确配置 CMS 安装路径 与 网页域名，否则可能导致播放器无法动态创建或解析失败。

CMS路径设置，路径必须以/开始不带/结束，比如/www/wwwroot/cms

CMS网页端域名，必须包含http://或https://

自助换绑，新的域名填写时不要包含http://或https://且换绑后会有三天的冷却，冷却时间内无法再次换绑。

关于页面

展示程序版权信息、当前版本号及授权状态，便于用户确认软件合法性与更新情况。

结语

MacCMS Tools 以 自动化、智能化、高性能 为核心设计理念，致力于为 MacCMS 用户提供一站式资源管理解决方案。无论是个人站长还是小型团队，均可通过本工具显著提升运维效率与数据质量。

如在使用过程中遇到问题，欢迎通过微信 iluluink 联系开发者获取支持。