使用 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 的電腦上操作。
- 點選左側欄中的「AI 智慧體」。
- 點選介面第一行下方的「如何連線」。
- 在「用 AI 製作配方」視窗的「連線你的 AI 應用」下面,從列表中選擇您的應用。
- 對於 Claude Desktop、ChatGPT / Codex 和 OpenCode,點選「新增到 Claude Desktop」、「新增到 ChatGPT / Codex」或「新增到 OpenCode」,NeoDownloader 會把項目寫入應用的設定檔案。對於其他應用,按視窗中的說明操作。「複製」可以複製文字,文字里已經寫好了這台電腦上的路徑。
- 重新啟動您的 AI 應用。NeoDownloader 本身不需要重新啟動。
按鈕不會改動檔案的其他內容,並把舊檔案留在旁邊,檔名末尾加上 .before-neodownloader。如果無法讀取檔案,它不會改動檔案,而是開啟「手動新增」下面的文字。這個連結也可以單獨使用。
應用工作時,NeoDownloader 必須處於執行狀態。如果 NeoDownloader 已關閉,應用會得知這一點,並且應該會請您啟動它。
文字放在哪裡
視窗會顯示可以直接貼上的文字。下面列出它在各個應用中的位置和樣子。這些範例裡的 PROGRAM 代表 NeoDownloader 在您電腦上的路徑,FOLDER 代表它存放資料的資料夾,所以請從視窗複製文字。
如果設定檔案裡已經列出了其他伺服器,請把 neodownloader 項目放在它們旁邊,放進同一個列表。這段文字不含密碼或金鑰:連線所需的內容會從 NeoDownloader 存放資料的資料夾讀取。
Claude Desktop
把以下內容新增到您的系統對應的檔案:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json - Mac:
~/Library/Application Support/Claude/claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"neodownloader": {
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
Claude Code
在終端中執行:
claude mcp add --scope user neodownloader -- PROGRAM --mcp --install-dir FOLDER
ChatGPT / Codex
把以下內容新增到 ~/.codex/config.toml,在 Windows 上是 %USERPROFILE%\.codex\config.toml:
[mcp_servers.neodownloader]
command = "PROGRAM"
args = ["--mcp", "--install-dir", "FOLDER"]
ChatGPT 桌面應用和 Codex 都讀取這個檔案。瀏覽器中的 ChatGPT 無法連線,請安裝桌面應用。
Cursor
把以下內容新增到 ~/.cursor/mcp.json,在 Windows 上是 %USERPROFILE%\.cursor\mcp.json:
{
"mcpServers": {
"neodownloader": {
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
VS Code
開啟 Command Palette > MCP: Open User Configuration,新增以下內容:
{
"servers": {
"neodownloader": {
"type": "stdio",
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
GitHub Copilot CLI
把以下內容新增到 ~/.copilot/mcp-config.json,在 Windows 上是 %USERPROFILE%\.copilot\mcp-config.json:
{
"mcpServers": {
"neodownloader": {
"type": "local",
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"],
"tools": ["*"]
}
}
}
OpenCode
把以下內容新增到 ~/.config/opencode/opencode.json,在 Windows 上是 %USERPROFILE%\.config\opencode\opencode.json:
{
"mcp": {
"neodownloader": {
"type": "local",
"command": ["PROGRAM", "--mcp", "--install-dir", "FOLDER"],
"enabled": true
}
}
}
Antigravity
把以下內容新增到 ~/.gemini/config/mcp_config.json,在 Windows 上是 %USERPROFILE%\.gemini\config\mcp_config.json:
{
"mcpServers": {
"neodownloader": {
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
Windsurf
開啟 Cascade > MCP > Open MCP config file,新增以下內容:
{
"mcpServers": {
"neodownloader": {
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
JetBrains AI Assistant
開啟 Settings | Tools | AI Assistant | Model Context Protocol (MCP) | Add,新增以下內容:
{
"mcpServers": {
"neodownloader": {
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
Zed
開啟 Command Palette > zed: open settings file,新增以下內容:
{
"context_servers": {
"neodownloader": {
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
Cline
開啟 MCP Servers > Configure > Configure MCP Servers,新增以下內容:
{
"mcpServers": {
"neodownloader": {
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
Roo Code
開啟 MCP > Edit Global MCP,新增以下內容:
{
"mcpServers": {
"neodownloader": {
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
Kiro
把以下內容新增到 ~/.kiro/settings/mcp.json,在 Windows 上是 %USERPROFILE%\.kiro\settings\mcp.json:
{
"mcpServers": {
"neodownloader": {
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
LM Studio
開啟 Program > Install > Edit mcp.json,新增以下內容:
{
"mcpServers": {
"neodownloader": {
"command": "PROGRAM",
"args": ["--mcp", "--install-dir", "FOLDER"]
}
}
}
其他
對於其他能透過 MCP 連線、並能在您電腦上啟動程式的應用,視窗會給出命令及其引數:
command: PROGRAM
args: --mcp --install-dir FOLDER
許多應用接受與 Cursor 相同的文字。只能存取網際網路上伺服器的應用無法連線,因為這個連線留在您的電腦上。
讓應用製作配方
在應用的訊息欄位裡寫下請求,例如:「為 example.com 製作一個 NeoDownloader 配方。」用您自己的話也可以,或者使用 NeoDownloader 準備好的那句話。
同一個視窗可以從三個地方開啟:
- 「配方」分頁頂部的「用 AI 製作配方」,在有應用連線之後出現。那裡的句子為站點留了空:把地址填進去。
- 「新建專案」精靈中「檔案從哪裡來?」下面的「用 AI 為這個網站製作配方」。
- 專案上的「用 AI 修復」;參見下文。
有應用連線之後,上面的步驟會摺疊成一行,例如「最近一次呼叫 NeoDownloader 的是 Claude Desktop:…」,「如何連線另一個」可以把它們重新展開。「告訴你的智慧體」下面就是那句話,語言與 NeoDownloader 視窗相同。「複製」可以複製它。把它貼到您的應用中。
從精靈開啟的視窗最後寫著「智慧體儲存配方後,嚮導會自動採用它。」請讓精靈保持開啟。配方儲存後,精靈會重新詢問各外掛,並顯示「你的智慧體儲存了一個配方,嚮導已重新檢查這個地址。」
應用告訴您配方已儲存後,用站點地址建立一個普通專案:現在 Crawler 會使用這個配方,專案會下載檔案。配方也會出現在「配方」選項卡中。
「AI 智慧體」介面
「AI 智慧體」在左側欄中,任何介面都能看到;視窗裡把您連線的應用稱為智慧體。這一項上的圓點表示那裡有新內容。NeoDownloader 絕不會自己把您帶到那裡。
左欄頂部顯示應用正在做什麼,下面是它的名稱,例如「透過 Claude Desktop 1.2」:
| 這一行顯示 | 含義 |
|---|---|
| AI 智慧體尚未連線 | 到目前為止,沒有應用呼叫過這個 NeoDownloader。 |
| AI 智慧體正在工作 | 應用在過去一分鐘內有過呼叫。 |
| AI 智慧體當前空閒 | 已有應用連線過,現在沒有動靜。 |
| AI 智慧體已停止 | 「允許 MCP」已關閉。 |
| 智慧體詢問您 | 應用正在等您。 |
日誌
這一行下面是日誌:應用的每一步佔一條記錄,最新的在最下面,語言與 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 修復」,位於分頁頂部的警告中,同樣是要求製作新配方。