Jump to content
MediaWiki

Rozšíření:ORES

From mediawiki.org
This page is a translated version of the page Extension:ORES and the translation is 100% complete.
Příručka k rozšířením MediaWiki
ORES
Stav rozšíření: stabilní
Popis Toto rozšíření integruje data z projektu ORES do zobrazení RecentChanges.
Autoři Kunal Mehta, Amir Sarabadani, Adam Roses Wight
MediaWiki >= 1.45
Změny v databázi Ano
Tabulky ores_classification
ores_model
Licence GNU General Public License 3.0 nebo novější
Stáhnout
  • $wgOresLiftWingMultilingualRevertRiskEnabled
  • $wgOresBaseUrl
  • $wgOresLiftWingAddHostHeader
  • $wgOresModelVersions
  • $wgORESRevertRiskAbuseFilterIntegrationEnabled
  • $wgOresAggregatedModels
  • $wgOresWikiId
  • $wgOresRevisionsPerBatch
  • $wgOresExcludeBots
  • $wgOresUseLiftwing
  • $wgORESDeveloperSetup
  • $wgOresFrontendBaseUrl
  • $wgOresCacheVersion
  • $wgOresLiftWingRevertRiskHosts
  • $wgOresEnabledNamespaces
  • $wgOresLiftWingBaseUrl
  • $wgOresFiltersThresholds
  • $wgOresModelClasses
  • $wgOresUiEnabled
  • $wgOresModels
Přeložte rozšíření ORES, používá-li lokalizaci z translatewiki.net
Vagrant role ores
Problémy Otevřené úkoly · Nahlásit chybu

Rozšíření ORES integruje data ze služby ORES do zobrazení RecentChanges.

V současné době je backendová služba ORES nastavena pouze pro wikiny Wikimedie. Její nastavení pro instalace MediaWiki od třetích stran by vyžadovalo značné úsilí.

Je nainstalován na několika stránkách Wikimedie, ale na nových již není nasazován. Novější práce o strojovém učení na Wikimedii viz Machine Learning/Modernization .

Snímky obrazovky

Změny, které "vyžadují kontrolu" a mohou být škodlivé, jsou zvýrazněny v sekci Special:RecentChanges.
Do legendy Special:RecentChanges je přidán příznak "needs review" (potřebuje kontrolu).

Instalace

  • Stáhněte soubor/y a vložte je do adresáře pojmenovaného ORES ve vaší složce extensions/.
    Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:
    cdextensions/
    gitclonehttps://gerrit.wikimedia.org/r/mediawiki/extensions/ORES
    
  • Na konec vašeho souboru LocalSettings.php přidejte následující kód:
    wfLoadExtension( 'ORES' );
    
  • Yes Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Po nasazení je potřeba spustit údržbový skript CheckModelVersions.php (a poté můžete spustit i PopulateDatabase.php).

Pokud chcete nastavit lokální vývojové prostředí pro rozšíření MediaWiki + ORES pomocí následujícího kódu ORES extension local development guide :


Konfigurační proměnné

Zde jsou konfigurační proměnné, jejich výchozí hodnoty a krátký popis.

// URL adresa služby ORES
$wgOresBaseUrl = 'https://ores.wikimedia.org/';
// Buď vyloučit úpravy provedené robotem pro skórování
$wgOresExcludeBots = true;
// Modely, které skórují
$wgOresModels = [
	'damaging' => [ 'enabled' => true ],
	'goodfaith' => [ 'enabled' => true ],
	'reverted' => [ 'enabled' => false ],
	'articlequality' => [
		'enabled' => false,
		'namespaces' => [ 0 ],
		'cleanParent' => true,
		'keepForever'=> true
	],
	'wp10' => [
		'enabled' => false,
		'namespaces' => [ 0 ],
		'cleanParent' => true,
		'keepForever'=> true
	],
	'draftquality' => [
		'enabled' => false,
		'namespaces' => [ 0 ],
		'types' => [ 1 ],
	],
];
// Nahradí ORES Lift Wing pro získávání skóre.
$wgOresUseLiftwing = false;
// URL pro Lift Wing – přeskočeno pokud null
$wgOresLiftWingBaseUrl = null;
// Prahové hodnoty různých citlivostí v ORES
$wgOresDamagingThresholds = [ 'soft' => 0.7, 'hard' => 0.5 ];
// Jmenné prostory, které by měl ORES hodnotit. Prázdné pole znamená všechny jmenné prostory.
// Pokud není prázdné, bude fungovat pouze na daných jmenných prostorech.
// Determine namespaces like [ 0 => true, 120 => true ].
$wgOresEnabledNamespaces = [];
// ID databáze pro službu ORES. Pokud není určen, použije se název databáze.
// Můžete zvolit 'testwiki', kde služba ORES odešle poslední dvě číslice rev_id převrácené.
// Například: https://ores.wikimedia.org/v1/scores/testwiki/damaging/12345
$wgOresWikiId = null;

Ladění nasazení rozšíření ORES

Po nasazení rozšíření s ORES nebo Lift Wing jako backendem můžeme použít kroky v bodě 1, abychom se ujistili, že funguje správně.

Odpovědi služby ORES

Rozšíření ORES je více než jen rozhraní ke službě ORES. Služba vrací pravděpodobnost poškození úprav takto (API v1):

{
"724030089":{
"damaging":{
"prediction":false,
"probability":{
"false":0.8917716518085119,
"true":0.10822834819148802
}
}
}
}

To znamená, že tato úprava (diff=724030089) s 10% pravděpodobností způsobila poškození. Upozorňujeme, že 90% pravděpodobnost neznamená, že 9 z deseti případů bude vandalismus. Výběr prahových hodnot by měl být proveden analýzou odhalitelnosti (procento vandalismu, které lze zachytit) nebo míry falešně pozitivních výsledků. V ORES je "měkká" hranice, když je vyzvednutí 75 % (což znamená, že bude zahrnovat 75 % všech škodlivých editací) a "tvrdá" hranice, když je vyzvednutí 90 %. Prahové hodnoty můžete získat z informací o modelu (příklad).

Schéma databáze

ORES extension introduces two new tables: ores_model and ores_classification. See the full database schema description.

Pracovní postup rozšíření

Skóre

Once an edit is made the extension triggers a job to hit the service and store the results in the ores_classification table. It means it will not include scores for edits made before the deployment. In order to fill the database you can run the maintenance script PopulateDatabase.php. It will hits the service and keeps the score for the last 5,000 edits. You can run it several times if needed.

Once a model gets updated to a newer version CheckModelVersions.php maintenance script needs to be ran to update the ores_model table which will cause to scores stored in the ores_classification table become deprecated. You can clean these obsolete scores by running PurgeScoreCache.php maintenance script.

Rozhraní

The extension won't show anything when deployed but it will add itself as a beta feature (Extension:BetaFeatures is a dependency of this extension) and once it's enabled by the user it will use hooks in ChangesList (RecentChanges, Watchlist, and RelatedChanges) in both old and enhanced mode and highlights when score exceeds the given threshold.

Toto rozšíření se používá na jednom nebo více projektech Wikimedia. Pravděpodobně to znamená, že rozšíření je stabilní a funguje dostatečně dobře, aby jej mohly používat weby s tak vysokou návštěvností. Vyhledejte tento název rozšíření v konfiguračních souborech CommonSettings.php a InitialiseSettings.php Wikimedie, abyste viděli, kde je nainstalováno. Úplný seznam rozšíření nainstalovaných na konkrétní wiki lze vidět na stránce wiki Special:Version.

AltStyle によって変換されたページ (->オリジナル) /