--- title: Collaborazione description: Modifica P2P in tempo reale tramite WebRTC e Yjs, senza server centrale. --- # Collaborazione OpenPencil permette a più persone di modificare un documento in tempo reale. Le modifiche passano direttamente tra i partecipanti tramite WebRTC. ## Avviare una sessione Apri il menu di collaborazione, crea una stanza e condividi il link. L’identificatore usa casualità crittografica e non contiene dati del documento. ## Dati condivisi - **Documento:** forme, testo, proprietà e disposizione; - **Presenza:** nome, colore, selezione e pagina attiva; - **Cursori:** posizione di ogni partecipante; - **Vista:** possibilità di seguire l’inquadratura di un’altra persona; - **Agenti:** la chat AI integrata compare come cursore sui livelli che sta modificando, con un’etichetta contornata che mostra una scintilla e un nome in codice come *Fern*. Cursore e contorno hanno il colore di chi lo esegue, così si capisce a chi appartiene l’agente. Vengono condivisi solo nome, tipo, modello, stato, pagina, posizione e livelli modificati, mai richieste o risposte. ## Modalità di seguito Fai clic sull’avatar di un partecipante nella barra superiore per seguire la sua inquadratura. L’area di lavoro si sposta e cambia zoom come la sua vista, e una cornice del suo colore con una barra «Stai seguendo …» indica chi stai seguendo. Per smettere, fai di nuovo clic sull’avatar, premi Esc oppure fai clic, scorri, cambia zoom o pagina. Un avatar conta gli agenti eseguiti da quella persona. Passaci sopra il puntatore per vedere ogni agente, cosa sta facendo e su quale pagina, e fai clic su **Segui** accanto a un agente per tenere in vista la pagina e i livelli che sta modificando; il seguito continua tra una risposta e l’altra e termina quando l’agente se ne va. Il pulsante dopo gli avatar elenca tutti i presenti nella stanza con i rispettivi agenti e funziona anche da tastiera. Il tuo avatar elenca i tuoi agenti (fai clic su uno per rinominarlo) e contiene **Esci dalla stanza**. Il pannello di condivisione elenca tutti i presenti nella stanza con gli agenti che eseguono, cosa fa ciascun agente e su quale pagina. Segui un agente allo stesso modo per tenere in vista la pagina e i livelli che sta modificando. Fai doppio clic su un tuo agente per rinominarlo. ## Architettura Yjs mantiene lo stato condiviso con un CRDT. Trystero individua i partecipanti e stabilisce le connessioni WebRTC. Un server di segnalazione aiuta ad avviare la connessione, ma non trasmette il documento. Non servono account o infrastruttura propria. La qualità dipende dalla rete e dalla possibilità di stabilire WebRTC. ## Privacy Il contenuto non viene archiviato su un server OpenPencil. Ogni partecipante conserva una copia locale. Condividi il link solo con persone fidate. ## Terminare Alla chiusura della sessione, partecipanti remoti e cursori vengono rimossi. Le modifiche già sincronizzate restano nel documento locale.