From 3fc4a5cb5c229e595c6ab7ad1b618f499d1a945e Mon Sep 17 00:00:00 2001 From: jxxghp Date: Sun, 11 Oct 2026 12:29:53 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E7=94=A8=E6=9C=89=E6=95=88=E6=A0=87?= =?UTF-8?q?=E7=AD=BE=E7=AD=9B=E9=80=89=E7=BB=9F=E4=B8=80=E9=87=87=E9=9B=86?= =?UTF-8?q?=E5=99=A8=E4=B8=8B=E8=BD=BD=E5=85=A5=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/ISSUE_TEMPLATE/feature_request.yml | 2 +- README.md | 2 +- docs/development-setup.md | 2 +- docs/site-adapter-capture.md | 2 +- docs/site-adapter-collector-release.md | 6 +++--- docs/v2-to-v3-overview.md | 2 +- scripts/collect-site-adapter.sh | 2 +- 7 files changed, 9 insertions(+), 9 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml index 9dc8afef0..9a43c905e 100644 --- a/.github/ISSUE_TEMPLATE/feature_request.yml +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -8,7 +8,7 @@ body: value: | 请说明你希望添加的功能。 - 站点适配请求请从 [采集器独立 Release](https://github.com/jxxghp/MoviePilot/releases?q=site-adapter-collector-v&expanded=true) 下载最新采集器，再按 [站点适配采集说明](https://github.com/jxxghp/MoviePilot/blob/v3/docs/site-adapter-capture.md) 生成脱敏 ZIP，并在下方附加。Issue 及附件是公开内容，提交前必须解压预览四个文件。不要上传 Cookie、Authorization、通行密钥、会话字段或任何原始数据。 + 站点适配请求请从 [采集器独立 Release](https://github.com/jxxghp/MoviePilot/releases?q=tag%3Asite-adapter-collector-v1&expanded=true) 下载最新采集器，再按 [站点适配采集说明](https://github.com/jxxghp/MoviePilot/blob/v3/docs/site-adapter-capture.md) 生成脱敏 ZIP，并在下方附加。Issue 及附件是公开内容，提交前必须解压预览四个文件。不要上传 Cookie、Authorization、通行密钥、会话字段或任何原始数据。 - type: input id: version attributes: diff --git a/README.md b/README.md index 7232db13f..dc233c794 100644 --- a/README.md +++ b/README.md @@ -62,7 +62,7 @@ curl -fsSL https://raw.githubusercontent.com/jxxghp/MoviePilot/v3/scripts/bootst - 开发环境与本地源码运行：[docs/development-setup.md](docs/development-setup.md) - 测试说明：[docs/testing.md](docs/testing.md) - 新站点适配采集与 Feature Request 提交：[docs/site-adapter-capture.md](docs/site-adapter-capture.md) -- 站点采集器下载：[独立 Release](https://github.com/jxxghp/MoviePilot/releases?q=site-adapter-collector-v&expanded=true)，仅在采集器变化时递增版本并发布。 +- 站点采集器下载：[独立 Release](https://github.com/jxxghp/MoviePilot/releases?q=tag%3Asite-adapter-collector-v1&expanded=true)，仅在采集器变化时递增版本并发布。 - REST API 文档：https://api.movie-pilot.org - 插件开发说明：https://wiki.movie-pilot.org/zh/plugindev diff --git a/docs/development-setup.md b/docs/development-setup.md index 663915d22..b7d3a05b0 100644 --- a/docs/development-setup.md +++ b/docs/development-setup.md @@ -234,7 +234,7 @@ Docker 镜像直接基于官方基础镜像构建，只安装应用运行所需 报告，不自动更新基线。普通主仓改动不要求额外检出插件仓或运行观察任务。宿主架构门禁和 changed-file Pylint 由 `v3` PR/push 的 GitHub Actions 执行，`app/` 全量 Pylint 是建议性报告。 -站点采集器使用独立的 `site-adapter-collector-v1.0.x` Release，仅在采集器发布输入变化时递增版本并构建，不跟随后端 Release。下载入口为 [采集器独立 Release](https://github.com/jxxghp/MoviePilot/releases?q=site-adapter-collector-v&expanded=true)，自动版本和手动测试构建规则见 [采集器发布说明](site-adapter-collector-release.md#维护者发布流程)。 +站点采集器使用独立的 `site-adapter-collector-v1.0.x` Release，仅在采集器发布输入变化时递增版本并构建，不跟随后端 Release。下载入口为 [采集器独立 Release](https://github.com/jxxghp/MoviePilot/releases?q=tag%3Asite-adapter-collector-v1&expanded=true)，自动版本和手动测试构建规则见 [采集器发布说明](site-adapter-collector-release.md#维护者发布流程)。 Ruff/Mypy 基线只允许收紧，不接受新增诊断或类型错误增长；受治零错误文件由 `mypy.ini` 的 `files=` 维护。Mypy 完整 ratchet 固定按 Linux/Python 3.14 分析。Coverage job 在 `v3` PR/push diff --git a/docs/site-adapter-capture.md b/docs/site-adapter-capture.md index 6e8a2f476..4840a6032 100644 --- a/docs/site-adapter-capture.md +++ b/docs/site-adapter-capture.md @@ -6,7 +6,7 @@ 普通用户只需准备两样东西：目标站点账号，以及已安装的 Chrome、Edge 或 Chromium。无需安装 Python、Git、MoviePilot、Docker，也不需要查看 HTML、复制 Cookie 或填写 User-Agent。 -1. 从官方 [站点采集器独立 Release](https://github.com/jxxghp/MoviePilot/releases?q=site-adapter-collector-v&expanded=true) 选择最新采集器版本，下载与 Windows、macOS 或 Linux 对应的程序；各系统文件名见下方下载说明。 +1. 从官方 [站点采集器独立 Release](https://github.com/jxxghp/MoviePilot/releases?q=tag%3Asite-adapter-collector-v1&expanded=true) 选择最新采集器版本，下载与 Windows、macOS 或 Linux 对应的程序；各系统文件名见下方下载说明。 2. 运行采集器，只输入站点首页地址，例如 `https://tracker.example.com`。 3. 程序会打开一个临时浏览器窗口。在这个窗口里正常登录站点，搜索一个能返回至少 3 条结果的常见关键词，并保持搜索结果页打开。 4. 回到采集器按回车。程序会自动识别搜索地址、关键词、Cookie 和 User-Agent，完成本地裁剪与脱敏后生成 ZIP。 diff --git a/docs/site-adapter-collector-release.md b/docs/site-adapter-collector-release.md index 254d0ee04..40cd065ac 100644 --- a/docs/site-adapter-collector-release.md +++ b/docs/site-adapter-collector-release.md @@ -1,10 +1,10 @@ # 站点适配采集器下载说明 -普通用户优先使用 [站点采集器独立 Release](https://github.com/jxxghp/MoviePilot/releases?q=site-adapter-collector-v&expanded=true) 提供的单文件采集器，选择列表中最新版本。采集器使用 `site-adapter-collector-v1.0.x` 独立标签，与 MoviePilot 后端版本分开发布。单文件已经包含 Python 和采集器依赖，不需要安装 Python、pip、Git、MoviePilot 后端，也不需要下载源码。电脑只需已安装 Chrome、Edge 或 Chromium 浏览器。 +普通用户优先使用 [站点采集器独立 Release](https://github.com/jxxghp/MoviePilot/releases?q=tag%3Asite-adapter-collector-v1&expanded=true) 提供的单文件采集器，选择列表中最新版本。采集器使用 `site-adapter-collector-v1.0.x` 独立标签，与 MoviePilot 后端版本分开发布。单文件已经包含 Python 和采集器依赖，不需要安装 Python、pip、Git、MoviePilot 后端，也不需要下载源码。电脑只需已安装 Chrome、Edge 或 Chromium 浏览器。 ## 选择下载文件 -请只从官方 [站点采集器独立 Release](https://github.com/jxxghp/MoviePilot/releases?q=site-adapter-collector-v&expanded=true) 下载与系统匹配的文件；MoviePilot 主程序 Release 不再提供采集器附件： +请只从官方 [站点采集器独立 Release](https://github.com/jxxghp/MoviePilot/releases?q=tag%3Asite-adapter-collector-v1&expanded=true) 下载与系统匹配的文件；MoviePilot 主程序 Release 不再提供采集器附件： | 系统 | 下载文件 | 用户侧运行环境 | |---|---|---| @@ -27,7 +27,7 @@ chmod +x moviepilot-site-collector-linux ## 系统安全提示 -当前自动构建产物尚未接入 Windows 或 Apple 代码签名。Windows SmartScreen 或 macOS Gatekeeper 可能因此显示安全提示。仅在文件来自官方 [站点采集器独立 Release](https://github.com/jxxghp/MoviePilot/releases?q=site-adapter-collector-v&expanded=true)，且校验摘要一致时运行；不要从聊天、网盘或第三方站点接收采集器。 +当前自动构建产物尚未接入 Windows 或 Apple 代码签名。Windows SmartScreen 或 macOS Gatekeeper 可能因此显示安全提示。仅在文件来自官方 [站点采集器独立 Release](https://github.com/jxxghp/MoviePilot/releases?q=tag%3Asite-adapter-collector-v1&expanded=true)，且校验摘要一致时运行；不要从聊天、网盘或第三方站点接收采集器。 如果系统阻止运行，可改用随 MoviePilot 源码提供的本地采集脚本；该方式需要 Python 3.14+ 及完整后端依赖，不适合作为普通用户的首选路径。 diff --git a/docs/v2-to-v3-overview.md b/docs/v2-to-v3-overview.md index 8218fd9fc..2f6984534 100644 --- a/docs/v2-to-v3-overview.md +++ b/docs/v2-to-v3-overview.md @@ -399,7 +399,7 @@ MoviePilot/app/application/site - 后端用户数据解析器可以自动探测 Gazelle、NexusPHP 等站点变种。 - 解析模板支持更完整的标题、文件名、标签和可选字段回退。 - 构建产物覆盖 Linux、Windows、macOS、x86_64、Arm64，以及 V3t 所需的 Python 3.14t ABI。 -- [站点采集器独立 Release](https://github.com/jxxghp/MoviePilot/releases?q=site-adapter-collector-v&expanded=true) 提供生成脱敏样本的程序，维护者可通过自动化流程匹配模板并创建待审核的适配 PR。 +- [站点采集器独立 Release](https://github.com/jxxghp/MoviePilot/releases?q=tag%3Asite-adapter-collector-v1&expanded=true) 提供生成脱敏样本的程序，维护者可通过自动化流程匹配模板并创建待审核的适配 PR。 ### 7.4 用户遇到站点问题时应如何判断 diff --git a/scripts/collect-site-adapter.sh b/scripts/collect-site-adapter.sh index 074ab865b..798f62f40 100644 --- a/scripts/collect-site-adapter.sh +++ b/scripts/collect-site-adapter.sh @@ -86,7 +86,7 @@ main() { fi if ! project_runtime_ready; then - echo "本地 Python 环境缺少采集器依赖，请下载采集器独立 Release：https://github.com/jxxghp/MoviePilot/releases?q=site-adapter-collector-v&expanded=true" >&2 + echo "本地 Python 环境缺少采集器依赖，请下载采集器独立 Release：https://github.com/jxxghp/MoviePilot/releases?q=tag%3Asite-adapter-collector-v1&expanded=true" >&2 exit 1 fi COLLECTOR_PATH="$PROJECT_ROOT/scripts/site_adapter_collector.py"