openpencil/packages/docs/it/programmable/collaboration.md
Danila Poyarkov b9753aa016
docs: sync translations with documentation changes since v0.15.1 (#886)
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.
2026-10-04 16:38:35 +00:00

2.9 KiB
Raw Blame History

title description
Collaborazione 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.