Praca z aplikacją AI

Jeśli NeoDownloader nie może pobrać z jakiegoś serwisu albo pobiera z niego nie to, co trzeba, aplikacja AI może go tego nauczyć: poznaje serwis i pisze przepis, krótki opis tego, gdzie serwis trzyma pliki. NeoDownloader nie ma wbudowanej sztucznej inteligencji, ale twoja aplikacja może się z nim połączyć, a w oknie programu nazywa się ona agentem. Łączy się przez MCP, czyli typowy sposób, w jaki aplikacje AI pracują z innymi programami. Ta strona omawia, do czego to się przydaje, łączenie aplikacji, ekran Agent AI i Napraw z AI.

Do czego to służy

Crawler to wtyczka, która przechodzi przez strony serwisu i pobiera znalezione na nich pliki. Działa według przepisów: przepis mówi, gdzie serwis trzyma swoje pliki i jak przechodzić przez kolejne strony z nimi.

Dla serwisów, które zna, Crawler ma przepis napisany właśnie dla danego serwisu. Dla pozostałych bierze jeden z czterech przepisów ogólnych, po jednym na każdy rodzaj strony, na przykład galerię albo wątek na forum. Taki przepis nic nie wie o konkretnym serwisie, więc nie zawsze wystarcza.

Jeśli nic nie przynosi albo przynosi nie to, czego chcesz, twoja aplikacja AI może napisać przepis dla tego serwisu. Tak samo, gdy przepis przestał znajdować pliki po zmianach w serwisie: aplikacja go naprawi.

Przepis powstaje raz. Od tej pory obsługuje swój serwis w każdym projekcie, a przebiegi nie potrzebują aplikacji. Sama aplikacja niczego nie pobiera: jej przebieg testowy tylko wymienia pliki, a pobieraniem zajmuje się projekt, który uruchamiasz. Aplikacja działa w ramach twojej subskrypcji albo na bezpłatnym modelu, jeśli go ma.

Najpierw spróbuj zwykłego projektu, bo rodzaje stron Crawlera często dają sobie radę, i to w kilka sekund tam, gdzie aplikacja potrzebuje minut. Jeśli wolisz poczekać na nas, niż robić przepis, użyj Poproś nas o przepis dla tej witryny.

Przepisy czyta tylko Crawler. Video Downloader, Gallery Downloader i Bezpośrednie odnośniki tego nie robią.

Co aplikacja widzi i co może zrobić

Aplikacja pracuje jawnie: każdy krok to wiersz w dzienniku opisanym niżej. Co otrzymuje, czego nie może zrobić i dokąd mogą trafić jej odpowiedzi, opisuje część Połączona aplikacja AI. Przeczytaj ją, zanim połączysz aplikację, przede wszystkim jeśli masz sesje logowania w serwisach w przeglądarce NeoDownloadera.

Jeśli pracujesz z bezpłatnym modelem w OpenCode, przyjrzyj się mu przed użyciem. Lista OpenCode podaje, co każdy bezpłatny model robi z twoimi danymi. W chwili pisania DeepSeek V4.1 Flash Free i GLM-5.3-Flash Free niczego nie przechowują i nie uczą się na nich, a inne mogą je przechowywać 30 dni albo używać do ulepszania modelu.

Połącz swoją aplikację

Nie masz jeszcze aplikacji AI? Zacznij tutaj.

Robisz to raz, na komputerze, na którym działa NeoDownloader.

1. Kliknij Agent AI na pasku po lewej.
2. Kliknij Jak połączyć, pod pierwszym wierszem ekranu.
3. W oknie Utwórz przepis z AI, w części Połącz swoją aplikację AI, wybierz swoją aplikację z listy.
4. W przypadku Claude Desktop, ChatGPT / Codex i OpenCode kliknij Dodaj do Claude Desktop, Dodaj do ChatGPT / Codex albo Dodaj do OpenCode: NeoDownloader sam zapisze wpis w pliku ustawień aplikacji. W każdej innej aplikacji zrób to, co podaje okno. Przycisk Kopiuj kopiuje tekst, w którym są już ścieżki twojego komputera.
5. Uruchom ponownie swoją aplikację AI. Samego NeoDownloadera nie trzeba uruchamiać ponownie.

Przycisk nie zmienia niczego więcej w pliku i zostawia stary plik obok, z .before-neodownloader na końcu nazwy. Jeśli nie może odczytać pliku, nie rusza go i otwiera tekst pod Dodaj ręcznie. Ten odnośnik działa też samodzielnie.

Podczas pracy aplikacji NeoDownloader musi być uruchomiony. Jeśli jest zamknięty, aplikacja dostaje taką informację i powinna poprosić cię o jego uruchomienie.

Gdzie trafia tekst

Okno pokazuje tekst gotowy do wklejenia. Poniżej podano, gdzie trafia w każdej aplikacji i jak wygląda. W tych przykładach PROGRAM oznacza ścieżkę NeoDownloadera na twoim komputerze, a FOLDER jego folder danych, więc kopiuj tekst z okna.

Jeśli plik ustawień wymienia już inne serwery, umieść wpis neodownloader obok nich, na tej samej liście. Tekst nie zawiera hasła ani klucza: połączenie odczytuje to, czego potrzebuje, z folderu danych NeoDownloadera.

{
  "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

Poproś o przepis

Napisz do aplikacji w polu wiadomości, na przykład: „Utwórz przepis NeoDownloadera dla example.com.” Wystarczą też twoje własne słowa albo zdanie, które przygotowuje NeoDownloader.

To samo okno otwiera się z trzech miejsc:

• Utwórz przepis z AI na górze karty Przepisy, gdy aplikacja już się połączyła. Zdanie ma tam puste miejsce na serwis: wstaw w nie adres.
• Utwórz przepis dla tej witryny z AI w kreatorze Nowy projekt, pod Skąd biorą się pliki?
• Napraw z AI w projekcie; zobacz niżej.

Gdy aplikacja już się połączyła, powyższe kroki zwijają się do wiersza takiego jak Ostatnio z NeoDownloader łączył się Claude Desktop: …, a Jak połączyć kolejną otwiera je ponownie. Pod Powiedz to agentowi jest zdanie w języku okna NeoDownloadera. Przycisk Kopiuj je kopiuje. Wklej je do swojej aplikacji.

Okno otwarte z kreatora kończy się zdaniem Gdy twój agent zapisze przepis, kreator sam go uwzględni. Zostaw kreator otwarty. Gdy przepis zostanie zapisany, kreator ponownie pyta wtyczki i podaje Twój agent zapisał przepis, a kreator ponownie sprawdził adres.

Gdy aplikacja powie, że przepis jest zapisany, utwórz zwykły projekt z adresem serwisu: teraz Crawler korzysta z tego przepisu, a projekt pobiera pliki. Przepis pojawi się też na karcie Przepisy.

Ekran Agent AI

Agent AI jest na pasku po lewej, na każdym ekranie, a okno nazywa połączoną aplikację agentem. Kropka przy tej pozycji oznacza, że jest tam coś nowego. NeoDownloader nigdy sam cię tam nie przenosi.

Na górze lewej kolumny widać, co robi aplikacja, a pod tym jej nazwę, na przykład przez Claude Desktop 1.2:

Dziennik

Pod tym wierszem jest dziennik: jeden wiersz na każdy krok aplikacji, najnowszy na dole, w języku okna NeoDownloadera. Godzina stoi przy pierwszym kroku każdej minuty. Gdy nazwa aplikacji się zmienia, nagłówek podaje nazwę następnej.

• Krok, który się nie powiódł, ma znacznik w swoim wierszu; wskaż znacznik, aby zobaczyć przyczynę: Odrzucono, Zatrzymano, Trwało za długo albo Nie powiodło się.
• Poza witryną szkicu oznacza krok, który wyszedł poza serwis, dla którego powstaje przepis.
• Kliknij krok, który otworzył stronę, aby zobaczyć ją ponownie.
• Jeśli przewiniesz w górę, dziennik zostaje w tym miejscu, a Nowe: 3 przenosi do najnowszych kroków.
• Wyczyść od razu opróżnia dziennik, bez pytania. Przepisy i szkice zostają.

Aplikacja może cię potrzebować do zalogowania albo sprawdzenia w serwisie. Jej prośba stoi w dzienniku pod Agent cię prosi, z przyciskiem Pokaż stronę. Zrób na stronie to, o co prosi, a potem powiedz o tym aplikacji.

Strona i przepisy

Po prawej stronie dziennika są dwie karty. Strona jest tam, dopóki aplikacja ma otwartą stronę, i pokazuje ją w przeglądarce NeoDownloadera. Przepisy wymienia twoje przepisy. Nowa strona aplikacji zajmuje panel tylko wtedy, gdy nie wybrano karty Przepisy: wybrana karta zostaje. Kropka na karcie oznacza, że pojawiło się tam coś nowego.

W wąskim oknie jest jedna kolumna z kartami Dziennik, Strona i Przepisy.

Przepisy

Karta Przepisy wymienia twoje własne przepisy: te, które zapisała twoja aplikacja AI, i te zapisane przez edytor przepisów wcześniejszej wersji. Przepisów z katalogu tu nie ma. Twój własny przepis obsługuje swoje serwisy w każdym projekcie, przed przepisem z katalogu.

Kafelek przepisu ma jego nazwę, jego serwisy i datę zapisania, a może też nosić te oznaczenia:

• Utworzony przez AI - zapisała go twoja aplikacja AI.
• Z kodem - ma obok siebie własny kod.
• Nie da się odczytać - NeoDownloader pomija go, dopóki nie zostanie naprawiony; kafelek pokazuje, co jest nie tak.

Używany zamiast przepisu z katalogu: … podaje, co ten przepis zastępuje.

Usuń najpierw pyta i podaje, co obsłuży te serwisy później: przepis z katalogu albo ogólne rodzaje stron Crawlera. Kopia zostaje obok twoich przepisów, w folderze .prev. Tylko ty możesz usunąć przepis: aplikacja tego nie potrafi.

Zezwól na MCP

Zezwól na MCP, pod pierwszym wierszem ekranu, to zezwolenie dla aplikacji. Po wyłączeniu NeoDownloader przestaje odpowiadać aplikacjom AI przez MCP, o cokolwiek prosi aplikacja, a to, co rozpoczęła, zatrzymuje się, łącznie z jej otwartą stroną. Ekran podaje MCP wyłączony: każde wywołanie aplikacji AI jest odrzucane, dopóki znowu nie zezwolisz na MCP.

Po ponownym uruchomieniu zostaje wyłączone, dopóki go nie włączysz. Aby aplikacja na stałe przestała pracować z NeoDownloaderem, usuń też NeoDownloadera z jej własnych ustawień.

Napraw z AI

Kafelek z Napraw z AI znajduje się na karcie Właściwości otwartego projektu, między właściwościami projektu a Usuń projekt. Otwiera okno Utwórz przepis z AI, z krokami łączenia aplikacji, jeśli żadna jeszcze się nie połączyła. To, o co prosi zdanie, zależy od wtyczki projektu.

W projekcie Crawlera zdanie podaje serwis, adres i liczbę plików przyniesionych przez ostatni przebieg oraz prosi aplikację, żeby ustaliła, dlaczego przepis przestał działać, i go naprawiła.

W projekcie innej wtyczki nie ma przepisu do naprawienia, więc aplikacja jest proszona o utworzenie nowego dla tego adresu. Kafelek to podaje: Przepisy są dla wtyczki Crawler, a ten projekt pobiera inną wtyczką. Poproś swojego agenta AI, by utworzył przepis dla tej witryny, a potem utwórz nowy projekt dla tego adresu we wtyczce Crawler. Projekt, od którego zaczęto, zostaje bez zmian.

Projekt, którego wtyczki już nie ma, też ma Napraw z AI, w ostrzeżeniu na górze karty, i także prosi o nowy przepis.