Eleven translated pages changed in English since the last release without matching updates: system requirements, the Lint tab, AI chat diff tools, collaboration with agents, design JSX imports and export fidelity, Storybook and live-app export, lint fixes, page navigation, and Checking Designs. Bring de, es, fr, it, pl, and ru up to date, add the sections the abridged translations lacked where a change landed, use each language's UI labels, and point the export page at documents list.
43 lines
2.9 KiB
Markdown
43 lines
2.9 KiB
Markdown
---
|
||
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 <kbd>Esc</kbd> 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.
|