Strojový překlad, nekontrolovaný rodilým mluvčím. Referenční je anglická verze.

API a integraceUpravit na GitHubuZdroj: docs/AGENTS.md

Použití Kshana z agenta AI

Pro agenta (nebo osobu, která ho řídí): který nástroj volat pro kterou otázku, co nástroje udělají a co neudělají a co ponechat u každé odpovědi. Povrchy a buňky, které na daném povrchu nejsou dostupné: SURFACES.md.

Připojení#

npx -y kshana-mcp@0.37.0            # or: uvx kshana-mcp==0.37.0, brew, scoop, winget, cargo, docker

Pasáž uvádějící klienty AI třetích stran je zde vynechána; je v docs/AGENTS.md na GitHubu.

Pravidlo pro každou odpověď#

Spusťte engine; čísla neodhadujte. Uveďte, co nástroj vrátil, s jednotkou a úrovní důkazů (VALIDATED proti vnějšímu orákulu, nebo MODELLED), scénářem, seedem a verzí enginu, aby bylo možné běh zopakovat. U každého výsledku ponechte jeho vlastní výhrady.

Který nástroj pro kterou otázku#

Otázka Nástroj (MCP) Příkaz s lomítkem
Spustit nebo vysvětlit scénář PNT (oběžné dráhy, GNSS, časování, fúze, Měsíc, optické spoje, ...) list_scenario_kinds, list_example_scenarios, get_example_scenario, validate_scenario, run_scenario, report_scenario, animate_scenario, export_sp3, export_omm, export_oem, export_interop, list_export_formats, export_table_csv /kshana-run
Byl tento záznam přijímače nebo NMEA tohoto plavidla důvěryhodný a kdy přestal být? assess_receiver_log (libovolný formát záznamu), assess_vessel_log (NMEA plavidla, dávka), assess_vessel_stream (omezený výňatek) /kshana-assess-receiver
Potřebuji syntetické NMEA s událostí rušení, odtržení odporu, podvržení času nebo přehrání pro trénink generate_training_nmea /kshana-training-scenario
Zobrazit skóre důvěryhodnosti plavidla v monitorovacích formátech nebo formátech SIEM (Prometheus, CEF, LEEF, OTLP) trust_telemetry /kshana-trust-telemetry
Ohodnotit záznam přijímače proti zveřejněnému plánu Jammertest (latence detekce, nezachycené poplachy, falešné poplachy, čas zotavení), nebo tento plán proměnit v události jammertest_score, jammertest_import /kshana-jammertest
Vytvořit záznam odolný proti manipulaci o tom, co engine řekl o okně záznamu plavidla, nebo takový záznam zkontrolovat create_evidence_pack, verify_evidence_pack, attach_evidence_timestamp /kshana-evidence-pack
Navigační data kterých družic Galileo tento proud přijímače ověřuje (OSNMA)? žádný: není na MCP. Použijte kshana osnma verify (CLI), kshana.osnma_verify (Python) nebo osnma_verify (WASM, karta OSNMA ve Studiu) není příkaz s lomítkem
Potřebuji pohyb vozidla a časy událostí scénáře k přehrání přes laboratorní simulátor GNSS export_test_bench /kshana-bench-export
Pro které řádky požadavků veřejných rámců tyto běhy podporují důkazy (supports evidence for) a jaká je mezera? compliance_report (z textu výsledku), compliance_mapping (tabulky, bez běhů) /kshana-compliance-report
Spustit bodovaný standardní balíček (testovací profily DHS RPCF, IMO MSC.1/Circ.1575, ICAO Doc 9849 Appendix F) proti prahům stanoveným před během? list_standards_packs, run_standards_pack (zprávu předejte nástroji compliance_report kvůli řádkům)
Zkontrolovat LunaNet Augmented Forward Signal (kódy, SB1, formát rámce) proti LNIS V5 / LSIS-AFS V1.0, nebo zkontrolovat proud symbolů? lunanet_afs_check (mode spec, symbols nebo generate); LDPC a CRC-24Q podrámců 2 až 4 nejsou ověřeny
Spojit laboratorní běh (scénář, uvedené podmínky testu, záznam přijímače, skóre) v jednom podepsaném balíčku? create_round_trip_pack po export_test_bench (docs/spec/TEST-CONDITIONS.md)
Ohodnotit odevzdání detekce nebo holdoveru proti souboru pravdy kshana-bench, nebo vykreslit soubory výsledků jako stránku žebříčku? score_benchmark, render_leaderboard —
Potřebuji scénář, který proletí trasu GeoJSON (terrain-nav, terrain-slam, gravity-map, combined-altpnt) import_route /kshana-import-route
Které družice vidí uživatel v ulici, v přístavu, ve fjordu nebo na kontejnerovém terminálu a jaké jsou DOP a elipsa chyby? sky_geometry (požadavek, nebo skyline_preset); sekce [skyline] scénáře přes run_scenario (orbit a integrity potřebují user_site) /kshana-run
Kde GNSS vypadalo zhoršeně a kolik z této trasy v tom leží? build_interference_map, potom route_exposure /kshana-interference-map
Záznamy IQ GNSS (scéna, akvizice, sledování, přijímací část, kampaně) nejprve iq_signals, potom nástroje iq_* /kshana-iq

Dovednosti (skills) vessel-receiver-trust, training-nmea-scenario, trust-telemetry, compliance-mapping, test-bench-export, gnss-iq a interference-map-route-exposure nesou níže uvedená pravidla pro agenty, kteří dovednosti načítají.

Co který nástroj neudělá#

  • Číst ani zapisovat soubory. Obsah je vložený: vstupy jsou text v požadavku, omezený na 4 MiB, a pole scénáře, které pojmenovává soubor, je odmítnuto. Pouze nástroje iq_* sahají do složky, a to jen do té pojmenované v KSHANA_MCP_IQ_DIR, přičemž každá cesta je do ní uzavřena.
  • Ověřovat OSNMA. Neexistuje nástroj MCP: vstupem je dlouhý surový proud přijímače (stránky I/NAV nebo záznam UBX), který se hodí pro CLI a Python, a nástroj, který by ho přijímal, by přidal povrch pro velké vstupy bez užitku. Odkažte uživatele na kshana osnma verify <file> --public-key ... --json (nebo Python osnma_verify). Ať výstup říká cokoli, ponechte slovo od slova poradní upozornění: pouze stav autentizace, nikoli služba integrity navigace, nikoli typově schválené navigační zařízení a žádné tvrzení o výkonu proti spoofingu; výsledek má smysl jen s kořenem Merkle nebo veřejným klíčem, který uživatel získal jinou cestou.
  • Spouštět proces. receiver-trust live jako běžící proud (s bránou a --listen), exportéry telemetrie (trust-telemetry: Prometheus, syslog, OTLP) a streamování tréninkového NMEA na adresu jsou pouze na příkazovém řádku. assess_vessel_stream ohodnotí výňatek týmž enginem a nezapisuje na žádný port. Nástroje pro výňatky vrací živé schéma JSON-lines 1,3 (výrok advisory a družicovou geometry u každé epochy, class u každé dedukce); CSV běhu plavidla začíná komentářovým řádkem # nesoucím tentýž výrok, proto ho čtěte s volbou pro komentáře. --udp a --listen tcp: se vážou na adresu loopback, pokud není řečeno jinak.
  • Zapisovat signál. export_test_bench vrací pohyb vozidla a označené intervaly událostí jako text; nic z toho, co vrací, není radiofrekvenční ani základopásmový signál, nemodeluje ho ani neřídí, a událost není návod, jak vytvořit interferenci. Předejte jeho notice spolu se soubory; simulátor a jeho provozovatel odpovídají za to, že je spouštějí jen tam, kde je to povoleno.
  • Říkat víc, než říká mapování. compliance_report uvádí, pro které řádky rámců sada běhů podporuje důkazy, s mezerou každého řádku. Nikdy neříká, že rámec je splněn nebo že produkt je hodnocen či schválen; statement ponechte slovo od slova a říkejte „podporuje důkazy pro (supports evidence for)“, nic silnějšího. Čte text výsledků a scénářů, který předáte, nikdy cestu.
  • Stahovat data. Stahování polygonů pevniny je pouze na příkazovém řádku a vyžaduje --allow-network. Soubor pevniny, je-li třeba, předejte jako text. Používejte jen data, k jejichž použití je uživatel oprávněn.
  • Cokoli vysílat nebo syntetizovat RF. Tréninkový generátor zapisuje text NMEA; vrstva IQ zapisuje soubory vzorků pro softwarové přijímače.

Co ponechat u odpovědi#

Výstup Ponechat
Geometrie družic a třídy dedukcí (0,36) Uveďte geometrii vedle skóre a třídu každé dedukce tak, jak byla vrácena: geometry znamená obloha (výrok o obloze, nikoli zjištění, že k žádnému útoku nedošlo), environment prostředí signálu, inconsistency důkaz podobný útoku. Říkejte „geometrie neznámá“, je-li stav unknown (v záznamu není GSV ani GSA); žádnou nedomýšlejte. Prahy jsou MODELLED s uvedeným původem.
Skóre důvěryhodnosti přijímače Pouze poradní charakter: nejde o typově schválené navigační zařízení (IEC 61108, IEC 61162); odpovědný zůstává provozovatel. MODELLED. Uveďte limity plavidla před během a práh nenaladěte podle výsledku. Vysoké skóre není důkazem pravé polohy; kontroly nevidí spoofer, který je konzistentní s každým dalším senzorem.
Balíček důkazů Technický záznam, nikoli právní stanovisko, zjištění skutečností ani schválení. Ověřte veřejným klíčem podepisujícího, který jste získali jinou cestou; bez něj je verdikt intact-signer-not-pinned, což dokazuje jen integritu proti klíči, který si balíček sám uvádí: říkejte „neporušeno, podepisující nezjištěn“, nikdy „ověřeno“. Nikdy nevracejte, nelogujte ani nežádejte seed podpisu v konverzaci, záleží-li na klíči: použijte CLI.
Tréninkové NMEA Pouze text, pro trénink a testování, nikdy pro živé navigační systémy plavidla. Vraťte seed a záznam instruktora.
Mapa interference, expozice trasy Způsob čtení kódů přesnosti a geometrie mřížky a trasy jsou VALIDATED proti nezávislým knihovnám na syntetických vstupech; prahy metody zůstávají MODELLED a to, že zhoršená buňka je interference, se nekontroluje: zhoršená buňka interferenci jako příčinu neurčuje. Nepozorovaná buňka není důkazem čisté trasy. Minulé zprávy, nikoli předpověď. Pouze agregáty: nepokoušejte se obnovovat identifikátory. Mapy ADS-B a AIS zůstávají oddělené.
Oblast zdroje rušení (interference-map locate) MODELLED: přípustná oblast při rádiové přímé viditelnosti, nikoli určení polohy. Uvádějte oblast na stanovené úrovni spolehlivosti s těžištěm a jeho elipsou, nikdy samotné těžiště; napište unconstrained, když data oblast nezúží; napište, že je podmíněna modelem (zkontrolováno jen na syntetických datech; předregistrované srovnání Jammertest proběhlo jednou a pro oba zdroje bylo NOT ASSESSABLE, takže se externě nic neověřovalo). Neutrální formulace: „odhadovaná oblast zdroje rušení“; nikdy nejmenujte ani nenaznačujte, kdo nebo co za zdrojem stojí, ať jde o stát, sílu či záměr. Pouze agregovaně; nepokoušejte se obnovovat identifikátory. Zveřejňování oblastí zdrojů rušení ve veřejné observatoři je vypnuto.
Geometrie oblohy, skyline MODELLED geometrie při uvedeném modelu chyb, pouze přímá viditelnost: žádný ohyb, vícecestné šíření ani příjem bez přímé viditelnosti. Předvolby jsou REPRESENTATIVE, nikoli zaměření; ponechte původ předvolby. Předvolené konstelace jsou reprezentativní obloha, nikoli obloha daného data. Elipsa škáluje uvedenou UERE: není to naměřená přesnost ani mez integrity. Ponechte advisory.
Dostupnost optického spoje (optical-atmosphere, 0,37) MODELLED, poradní. Oblačné klimatické podmínky jsou uvedené vstupy, nikoli datová sada, a nebyl porovnán žádný naměřený záznam dostupnosti: říkejte „za těchto předpokladů“, nikdy „dostupnost na tom místě“. Ponechte strop lokality (availability_ceiling_pct: co žádná rezerva nezvedne) vedle její dostupnosti a řekněte, které zisky technik jsou vstupy (Kshana adaptivní optickou smyčku nemodeluje). Numerika je zkontrolována proti nezávislému programu, což kontroluje implementaci vzorců, nikoli atmosféru.
Test holdoveru (holdover-test, 0,38) MODELLED, poradní. Říkejte „změřeno proti masce“, nikdy že hodiny nebo systém splňují doporučení či jsou podle něj schváleny. Dva časy (GNSS odebráno, GNSS obnoveno) jsou výrokem provozovatele: Kshana nic neodebrala ani neobnovila a nemůže je ověřit, proto je citujte tak, jak byly uvedeny. Maska, pro kterou je záznam příliš krátký, je INCOMPLETE, nikdy splnění. Záznam servo (linuxptp, chrony) je chyba pod servořízením, nikoli nezávislé měření proti UTC; řekněte, z kterého záznamu hodnoty pocházejí. Viz docs/TIMING-HIL.md.
Jakýkoli výsledek scénáře figure_tiers nebo label, které uvádí, a řádek původu.

Hranice#

Používejte syntetická nebo vlastní data uživatele. Ve výstupech nejmenujte osoby, plavidla ani organizace, které nebyly ve vstupu uživatele. Kshana je analytický a tréninkový nástroj, nikoli letový ani navigační produkt.