3天精通Proxyee-down插件开发：从基础到发布的实战指南

2026-04-01 09:19:24作者：乔或婵

Proxyee-down作为一款强大的下载工具，其插件系统为用户提供了无限可能。本文将通过"基础认知→场景化实践→进阶拓展"的三段式结构，带你从零开始掌握Proxyee-down插件开发的核心技能，轻松实现下载规则定制和功能扩展。

一、基础认知：插件开发的核心原理

插件工作机制解析

Proxyee-down插件系统基于内容脚本和钩子脚本实现功能扩展，通过Java后端与JavaScript前端的协同工作，实现对网页内容的分析和下载过程的控制。插件的核心工作流程包括加载配置、注入脚本、事件监听和功能执行四个阶段。

核心类与接口

在main/src/main/java/org/pdown/gui/extension/目录下，包含了插件开发的核心类：

ExtensionConfig.java：管理插件的基本配置信息
ContentScript.java：处理网页内容脚本的注入和执行
HookScript.java：定义下载过程中的事件钩子

这些类构成了插件开发的基础框架，理解它们的作用是开发插件的第一步。

二、场景化实践：开发你的第一个下载插件

如何创建插件目录结构？

一个标准的Proxyee-down插件应包含以下文件结构：

extension/
├── meta.json       # 插件元信息配置
├── content/        # 内容脚本目录
│   └── video-rule.js  # 视频下载规则脚本
└── hook.js         # 下载事件钩子脚本

如何配置插件元信息？

meta.json是插件的核心配置文件，决定了插件的基本信息和运行方式。以下是一个视频下载插件的配置示例：

{
  "name": "video-downloader",
  "version": "1.2.0",
  "description": "自动识别视频网站的下载链接",
  "contentScripts": [
    {
      "matches": ["*://*.video-site.com/*"],
      "scripts": ["content/video-rule.js"]
    }
  ],
  "hookScript": {
    "events": ["EVENT_START", "EVENT_DONE", "EVENT_ERROR"],
    "script": "hook.js"
  }
}

如何让插件只在视频页面生效？

通过matches属性设置URL匹配规则，可以精确控制插件在哪些页面生效。例如，只匹配视频网站的播放页面：

"matches": [
  "*://*.video-site.com/watch/*",
  "*://*.video-site.com/play/*"
]

下载规则定制：提取视频链接

在content/video-rule.js中实现视频链接提取逻辑：

// 查找页面中的视频源URL
function extractVideoUrl() {
  // 检查常见的视频标签
  const video = document.querySelector('video');
  if (video && video.src) {
    return video.src;
  }
  
  // 检查页面脚本中的视频链接
  const scripts = document.querySelectorAll('script');
  for (let script of scripts) {
    const match = script.textContent.match(/"url":"(https?:\/\/.*?\.mp4)"/);
    if (match) {
      return match[1];
    }
  }
  
  return null;
}

// 获取视频标题
function getVideoTitle() {
  return document.title.replace(/ - 视频网站$/, '') || 'unknown-video';
}

// 发送下载请求
const videoUrl = extractVideoUrl();
if (videoUrl) {
  window.pdown.download({
    url: videoUrl,
    filename: `${getVideoTitle()}.mp4`,
    // 设置下载优先级
    priority: 2
  });
}

如何处理下载事件？

在hook.js中实现下载事件的处理逻辑：

// 下载开始时修改文件名
pdown.hook.on('EVENT_START', (task) => {
  console.log(`开始下载: ${task.url}`);
  
  // 如果是MP4文件，添加时间戳
  if (task.filename.endsWith('.mp4')) {
    const timestamp = new Date().toISOString().slice(0,10);
    task.filename = `${timestamp}-${task.filename}`;
  }
});

// 下载完成后显示通知
pdown.hook.on('EVENT_DONE', (task) => {
  console.log(`下载完成: ${task.filename}`);
  // 调用系统通知
  if (window.Notification) {
    new Notification('下载完成', {
      body: `文件已保存至: ${task.savePath}`,
      icon: '/icons/download.png'
    });
  }
});

// 处理下载错误
pdown.hook.on('EVENT_ERROR', (task, error) => {
  console.error(`下载失败: ${error.message}`);
  // 自动重试最多3次
  if (task.retryCount < 3) {
    pdown.retryTask(task.id);
  }
});