nsite-clay

nsite-clay

Nsite, ktorý sa upravuje sám. Jeden HTML súbor na Nostri, ktorý sa sám upraví aj znovu zverejní.

Zverejni stránku Napíš ju s AI Prečítaj si návod Vyskúšaj živé demo Zdrojový kód na GitHube
Nadpis zverejnenej stránky sa upravuje v prehliadači, otvorená je ponuka blokov
Úprava zverejnenej stránky. Nadpis je živý text, panel s nástrojmi pridáva runtime.

Čo to je

Otvor stránku, prihlás sa svojím kľúčom a píš do nej. Dokument si serializuje vlastný DOM, výsledné bajty pošle na Blossom server ako jeden blob adresovaný obsahom a znovu zverejní nsite manifest podľa NIP-5A, ktorý naň ukazuje. Komukoľvek inému sa stránka načíta ako obyčajný statický dokument, už aj s tvojimi zmenami.

V tejto slučke nie je žiadny server, ktorý by si musel prevádzkovať. Manifest držia relaye, bajty držia Blossom servery a zvyšok spraví prehliadač. Vlastníctvo je pár kľúčov, takže to, kto smie túto stránku upraviť, nie je riadok v cudzej databáze.

  1. 01 SNÍMKA

    Stránka si naklonuje vlastný DOM, upratie ho a serializuje celý dokument.

  2. 02 BLOSSOM

    Bajty idú na Blossom server ako blob adresovaný vlastným sha256.

  3. 03 MANIFEST

    Nahraditeľný nsite event priradí ceste tento hash. Zverejniť ho znamená nasadiť.

Stránka, ktorú práve čítaš, je jedným z tých dokumentov. Beží na nej nsite-clay a ukladá sa rovnako.

Pre Nostr geekov

Nsite je webhosting. Nie dlhé poznámky, ale celé HTML súbory. Nič viac za tým nie je.

nsite-clay k tomu pridáva jednu vec: stránka sa upravuje a aktualizuje sama, takže CMS sedí vnútri statického HTML, nie za ním.

Meníš DOM. Môžeš klikať po stránke a prepisovať ju, alebo si otvoriť inšpektor DOM v prehliadači a zmeniť ju tam. Stránke je to jedno. Nová verzia sa nahrá na tvoje Blossom servery a znovu sa zverejní jeden nahraditeľný event s tým, na ktorý Blossom hash teraz ukazuje / alebo /about-us. Vykreslí ju hociktorý nsite gateway.

Píš a upravuj s AI

V publikátore opíš, akú stránku chceš, a AI ju napíše: rozloženie, štýly, texty, ktoré môžeš upravovať, a prázdne rámčeky na tvoje vlastné fotky. Pozri si náhľad, požiadaj o zmeny a zverejni ju vlastným kľúčom.

Na už zverejnenej stránke stlač Upraviť s AI a povedz, čo sa má zmeniť, či celá stránka, alebo len časť, na ktorú si klikol. Kým výsledok neprijmeš, na stránke sa nič nezmení. Späť ho vráti a Uložiť ho zverejní.

Za AI môžeš platiť tromi spôsobmi.

  1. 01 PODPOR PROJEKT

    Predvolená možnosť. Zaplatíš jednu Lightning faktúru na 2000 satov a všetko funguje: 1000 satov podporí nsite-clay a 1000 sa stane tvojím AI kreditom na našom Routstr node. Kľúč sa uloží zašifrovaný na tvoje vlastné relaye, takže ho máš na každom zariadení, kde sa prihlásiš. Kredit, ktorý neminieš, si vieš vybrať späť.

  2. 02 VLASTNÝ ROUTSTR NODE

    V nastaveniach AI zadaj iný Routstr node a kredit si tam dobi cez Lightning alebo Cashu. Poplatky idú tomu, kto ten node prevádzkuje.

  3. 03 VLASTNÝ API KĽÚČ

    Použi akékoľvek API kompatibilné s OpenAI, ktoré prijíma požiadavky z prehliadača, s vlastným kľúčom a modelom podľa seba. Platby ostanú medzi tebou a tým poskytovateľom.

AI je navyše, všetko ostatné zostáva zadarmo. Editor, dvanásť šablón, skladanie z blokov aj zverejňovanie nikdy nepýtajú platbu. Vyber si šablónu, klikni do stránky a píš, presne ako doteraz.

Celá integrácia

Jeden atribút hovorí, komu súbor patrí, druhý označí, do čoho sa dá písať, a zvyšok spraví jeden script tag.

<!DOCTYPE html>
<html lang="sk" autosave nc:owner="npub1…">
<head><meta charset="utf-8"><title>Poznámky</title></head>
<body>
  <h1 editable="single-line">Moje poznámky</h1>
  <div editable>
    <p>Sem môžeš písať čokoľvek.</p>
  </div>
  <script src="/nsite-clay.js"></script>
</body>
</html>

Ulož a otvor si súbor v textovom editore: tvoje slová sú priamo v HTML. Databázou je DOM, takže stav nemá kde inde byť.

Úpravy

Označ kontajner ako editable. Vlastníkovi sa z neho stane formátovaný text, všetkým ostatným obyčajné HTML.

Enter začne nový odsek. Keď označíš text, vyskočí nad ním plávajúci panel a jeho prvý ovládač je ponuka blokov: odsek, nadpis 1 až 3, citát, blok kódu.

Klávesové skratky fungujú tak, ako čakáš, a # , -  alebo >  na začiatku riadka tiež.

Do súboru sa dostane taký kód, aký by človek napísal aj ručne. Panel s nástrojmi ani smetie, ktoré prehliadače pri úpravách vyrábajú, sa neukladá.

Šablóny ako appky

Šablóna nie je farebná schéma. Každá je malá aplikácia, ktorá je zhodou okolností jediný súbor: číta z relayov, má ovládanie a vo viacerých môže návštevník aj niečo urobiť. Stránka môže vyzerať hocijako, lebo pod ňou nie je nič, čo by určovalo, ako má stránka vyzerať.

Všetkých dvanásť šablón

Vyskúšaj si to s ozajstným kľúčom

Pod jednorazovým kľúčom je zverejnený živý dokument a ten kľúč je verejný naschvál. Otvor ho, stlač Prihlásiť sa, vlož nsec a uprav stránku. Tvoje uloženie prepíše ozajstný dokument všetkým.

Otvoriť demo

Tú stránku môže prepísať hocikto, takže čokoľvek tam nájdeš, sú zvyšky po iných. Kľúč, na ktorom ti záleží, nikdy nevkladaj do stránky, ktorú si nezverejnil ty sám.

Nasaď si vlastnú stránku

Publisher to vybaví celé v jednej karte prehliadača: vyberieš šablónu, prihlásiš sa kľúčom alebo si ho necháš vygenerovať a stránka je online. Ak chceš vidieť, ako to vyzerá, pozri si najprv návod so screenshotmi. Potom sa stránka ukladá sama a publisher už nikdy nepotrebuješ.

CLI robí to isté pre každého, kto by chcel radšej priečinok na disku a príkaz, ktorý spustí.

# vytvorí kostru stránky a vygeneruje k nej kľúč
npx nsite-clay init mysite

# zverejní ju
npx nsite-clay deploy mysite --sec=nsec1…

# alebo nechaj kľúč mimo tohto počítača a podpisuj cez bunker
npx nsite-clay deploy mysite --bunker="bunker://…"

Stránka pristane na https://<npub>.nsite.lol/. Pomenované stránky dostanú vlastnú subdoménu, každé uloženie založí trvalú verziu s vlastnou URL a tá istá stránka beží cez ľubovoľný NIP-5A gateway. Vďaka CNAME z vlastnej domény na tvoju npub subdoménu ju gateway podáva aj tam, HTTPS na tomto mene ale potrebuje gateway, ktorý preň vie vydať certifikát.

Súbory sa zverejňujú na cestách, ktoré nesú hash ich obsahu, a každý dokument sleduje vlastný manifest a sám sa načíta znova, keď sa objaví novšia verzia. Nikto nemusí vedieť, čo je tvrdý refresh.

Celý návod na nasadenie

Postavené pre agentov, lebo web už stavajú agenti

Väčšinu stránok, ktoré takto vzniknú, nepostaví človek ručne, ale agent, a tak preňho projekt rovno pribaľuje návod. Nasmeruj naň svojho agenta a povedz mu, akú stránku chceš.

Je v ňom, na čo sa ťa má spýtať, ako vybrať a prerobiť šablónu, ako stránku dostať online cez vzdialený signer namiesto holého kľúča, aj tá hŕstka vecí, čo sa pokazia. Dokumentáciu odkazuje, neprepisuje ju, a v projekte postavenom na nsite-clay poslúži ako AGENTS.md.

llms.txt Šablóny

Kde stránka beží

Gateway nájde tvoj manifest a vydá súbory. Všetky čítajú tie isté eventy, takže stránka nie je viazaná na žiadny z nich. Keď jeden nejde, vymeníš hostname.

Čo to nerobí

len na čítanie

Prihlás sa a uprav túto stránku

Znovu ju zverejní len podpis vlastníka. Všetci ostatní dostanú tú stránku, na ktorú sa práve pozeráš.

Kľúč zostane v pamäti tejto karty a nikam sa nezapíše, ale píšeš ho do stránky, ktorú ti podal gateway. Vzdialený signer kľúč z ruky nevydá.