使用 AI 应用

如果 NeoDownloader 无法从某个站点下载，或者下载的不是您要的内容，可以让 AI 应用来教它：应用研究站点并编写配方，也就是一段简短的说明，写明站点把文件放在哪里。NeoDownloader 没有内置 AI，但您的应用可以连接到它，程序窗口里把它称为智能体。连接通过 MCP 进行，这是 AI 应用与其他程序协作的通用方式。本页介绍这样做有什么用、如何连接应用、“AI 智能体”界面和“用 AI 修复”。

它有什么用

Crawler 是一个插件，它逐页浏览站点，并取走在页面上找到的文件。它按配方工作：配方告诉它站点把文件放在哪里，以及怎样逐页翻看。

对于它认识的站点，Crawler 有专门为该站点编写的配方。对于其他站点，它使用四个通用配方之一，每种页面类型一个，例如图库或论坛主题。通用配方对具体站点一无所知，所以不一定管用。

如果它什么也取不到，或者取到的不是您想要的，您的 AI 应用可以为这个站点编写配方。配方在站点改版后不再能找到文件时也一样：应用可以修好它。

配方只需制作一次。此后它在每个项目中处理它的站点，运行也不需要应用参与。应用本身不下载任何东西：它的试运行只列出文件，下载由您开始的项目完成。应用使用您的订阅，或者使用它自带的免费模型。

请先试试普通项目，因为 Crawler 的几种页面往往就能应付，几秒钟就能完成，而应用要花几分钟。如果您宁愿等我们而不想自己制作配方，请使用请我们为此网站制作配方。

只有 Crawler 读取配方。Video Downloader、Gallery Downloader 和直接链接不读取。

应用能看到什么、能做什么

应用的工作全程可见：每一步都是下面日志里的一条记录。它收到什么、不能做什么、它的回复可能发往哪里，请看您连接的 AI 应用。连接应用之前请先读一读，尤其是当您在 NeoDownloader 的浏览器中已登录站点时。

如果您在 OpenCode 中使用免费模型，请在使用前先看看模型。OpenCode 的列表写明了每个免费模型如何处理您的数据。在撰写本文时，DeepSeek V4.1 Flash Free 和 GLM-5.3-Flash Free 不保存任何内容，也不用它来训练，而其他模型可能保存 30 天或用于改进模型。

连接您的应用

还没有 AI 应用？从这里开始。

这件事只需做一次，在运行 NeoDownloader 的电脑上操作。

1. 点击左侧栏中的“AI 智能体”。
2. 点击界面第一行下方的“如何连接”。
3. 在“用 AI 制作配方”窗口的“连接你的 AI 应用”下面，从列表中选择您的应用。
4. 对于 Claude Desktop、ChatGPT / Codex 和 OpenCode，点击“添加到 Claude Desktop”、“添加到 ChatGPT / Codex”或“添加到 OpenCode”，NeoDownloader 会把条目写入应用的设置文件。对于其他应用，按窗口中的说明操作。“复制”可以复制文本，文本里已经写好了这台电脑上的路径。
5. 重新启动您的 AI 应用。NeoDownloader 本身不需要重新启动。

按钮不会改动文件的其他内容，并把旧文件留在旁边，文件名末尾加上 .before-neodownloader。如果无法读取文件，它不会改动文件，而是打开“手动添加”下面的文本。这个链接也可以单独使用。

应用工作时，NeoDownloader 必须处于运行状态。如果 NeoDownloader 已关闭，应用会得知这一点，并且应该会请您启动它。

文本放在哪里

窗口会显示可以直接粘贴的文本。下面列出它在各个应用中的位置和样子。这些示例里的 PROGRAM 代表 NeoDownloader 在您电脑上的路径，FOLDER 代表它的数据文件夹，所以请从窗口复制文本。

如果设置文件里已经列出了其他服务器，请把 neodownloader 条目放在它们旁边，放进同一个列表。这段文本不含密码或密钥：连接所需的内容会从 NeoDownloader 的数据文件夹读取。

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}

claude mcp add --scope user neodownloader -- PROGRAM --mcp --install-dir FOLDER

[mcp_servers.neodownloader]
command = "PROGRAM"
args = ["--mcp", "--install-dir", "FOLDER"]

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}

{
  "servers": {
    "neodownloader": {
      "type": "stdio",
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}

{
  "mcpServers": {
    "neodownloader": {
      "type": "local",
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"],
      "tools": ["*"]
    }
  }
}

{
  "mcp": {
    "neodownloader": {
      "type": "local",
      "command": ["PROGRAM", "--mcp", "--install-dir", "FOLDER"],
      "enabled": true
    }
  }
}

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}

{
  "context_servers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}

command: PROGRAM
args: --mcp --install-dir FOLDER

让应用制作配方

在应用的消息框里写下请求，例如：“为 example.com 制作一个 NeoDownloader 配方。”用您自己的话也可以，或者使用 NeoDownloader 准备好的那句话。

同一个窗口可以从三个地方打开：

• “配方”标签页顶部的“用 AI 制作配方”，在有应用连接之后出现。那里的句子为站点留了空：把地址填进去。
• “新建项目”向导中“文件从哪里来？”下面的“用 AI 为这个网站制作配方”。
• 项目上的“用 AI 修复”；参见下文。

有应用连接之后，上面的步骤会折叠成一行，例如“最近一次调用 NeoDownloader 的是 Claude Desktop：…”，“如何连接另一个”可以把它们重新展开。“告诉你的智能体”下面就是那句话，语言与 NeoDownloader 窗口相同。“复制”可以复制它。把它粘贴到您的应用中。

从向导打开的窗口最后写着“智能体保存配方后，向导会自动采用它。”请让向导保持打开。配方保存后，向导会重新询问各插件，并显示“你的智能体保存了一个配方，向导已重新检查这个地址。”

应用告诉您配方已保存后，用站点地址创建一个普通项目：现在 Crawler 会使用这个配方，项目会下载文件。配方也会出现在“配方”选项卡中。

“AI 智能体”界面

“AI 智能体”在左侧栏中，任何界面都能看到；窗口里把您连接的应用称为智能体。这一项上的圆点表示那里有新内容。NeoDownloader 绝不会自己把您带到那里。

左栏顶部显示应用正在做什么，下面是它的名称，例如“通过 Claude Desktop 1.2”：

日志

这一行下面是日志：应用的每一步占一条记录，最新的在最下面，语言与 NeoDownloader 窗口相同。每分钟的第一步旁边标有时间。应用名称改变时，会有一个标题写明接下来的应用。

• 失败的步骤在记录上有一个标记；鼠标指向标记可以看到原因：“被拒绝”、“已停止”、“耗时过长”或“失败”。
• “在草稿的网站之外”标记离开了配方所针对站点的步骤。
• 点击打开过页面的步骤，可以再次查看那个页面。
• 如果您向上滚动，日志会停在您所在的位置，“新的: 3”可以带您回到最新的步骤。
• “清空”会立即清空日志，不经询问。配方和草稿都会保留。

应用可能需要您在站点上登录或通过检查。它的请求会显示在日志里的“智能体询问您”下面，并带有“显示页面”。在页面上按它的要求操作，然后告诉应用。

页面和配方

日志右边有两个标签页。“页面”在应用打开着页面时出现，在 NeoDownloader 的浏览器中显示那个页面。“配方”列出您的配方。只有在您没有选择“配方”时，应用打开的新页面才会占用这个面板：您选择的标签页会保持不变。标签页上的圆点表示那里有新内容。

窄窗口里只有一栏，“日志”、“页面”和“配方”都是标签页。

配方

“配方”标签页列出您自己的配方：您的 AI 应用保存的，以及早期版本的配方编辑器保存的。目录中的配方不在这里列出。您自己的配方在每个项目中处理它的站点，优先于目录中的配方。

配方卡片上有名称、站点和保存时间，还可能带有这些标记：

• 由 AI 创建 - 由您的 AI 应用保存。
• 含代码 - 它旁边带有自己的代码。
• 无法读取 - NeoDownloader 会跳过它，直到它被修好；卡片上会说明问题所在。

“代替目录中的配方使用：…”说明这个配方取代了什么。

“删除”会先询问，并说明此后由什么来处理这些站点：目录中的配方，或者 Crawler 通用的几种页面。“副本保留在您的配方旁边的 .prev 文件夹中。”只有您能删除配方：应用不能。

允许 MCP

界面第一行下方的“允许 MCP”是应用的许可。关闭后，无论应用请求什么，NeoDownloader 都不再通过 MCP 响应 AI 应用，应用已开始的工作也会停止，包括它打开的页面。界面上显示“MCP 已关闭：在您重新允许 MCP 之前，AI 应用的每次调用都会被拒绝。”

重启后它仍保持关闭，直到您把它打开。如果想让应用从此不再与 NeoDownloader 打交道，还要从应用自己的设置中移除 NeoDownloader。

用 AI 修复

打开项目的“属性”标签页上有一张带“用 AI 修复”的卡片，位于项目属性和“删除项目”之间。它会打开“用 AI 制作配方”窗口，如果还没有应用连接过，窗口里还有连接应用的步骤。那句话要求什么，取决于项目的插件。

在 Crawler 项目上，这句话会写明站点、地址和最近一次运行带来的文件数，并要求应用找出配方不再工作的原因并修复它。

在其他插件的项目上，没有配方可修，所以会要求应用为这个地址制作一个新配方。卡片上也这样写：“配方是给 Crawler 用的，而这个项目用的是另一个插件。让你的 AI 智能体为这个网站制作一个配方，然后用 Crawler 为这个地址新建项目。”您原来的项目保持不变。

插件已不在的项目也有“用 AI 修复”，位于标签页顶部的警告中，同样是要求制作新配方。