Genies IA

I Genies IA sono modelli di prompt che trasformano il tuo testo usando l'IA. Seleziona del testo, invoca un genie e revisiona le modifiche suggerite — tutto senza lasciare l'editor.

Avvio Rapido

1. Configura un provider IA in Impostazioni > Integrazioni (vedi Provider IA)
2. Seleziona del testo nell'editor
3. Premi Mod + Y per aprire il selettore genie
4. Scegli un genie o digita un prompt libero
5. Revisiona il suggerimento inline — accetta o rifiuta

Il Selettore Genie

Premi Mod + Y (o menu Strumenti > Genies IA) per aprire un overlay in stile Spotlight con un singolo input unificato.

Ricerca e prompt libero — Inizia a digitare per filtrare i genies per nome, descrizione o categoria. Se nessun genie corrisponde, l'input diventa un campo per prompt libero.

Chip Rapidi — Quando l'ambito è "selezione" e l'input è vuoto, appaiono pulsanti con un clic per azioni comuni (Rifinisci, Condensa, Grammatica, Riformula).

Prompt libero in due passaggi — Quando nessun genie corrisponde, premi Enter una volta per vedere un suggerimento di conferma, poi Enter di nuovo per inviare come prompt IA. Questo previene invii accidentali.

Ciclo ambito — Premi Tab per ciclare tra gli ambiti: selezione → blocco → documento → tutto.

Cronologia prompt — In modalità prompt libero (nessun genie corrispondente), premi ArrowUp / ArrowDown per ciclare tra i prompt precedenti. Premi Ctrl + R per aprire un menu a discesa con cronologia ricercabile. Il testo fantasma mostra il prompt corrispondente più recente come suggerimento grigio — premi Tab per accettarlo.

Feedback di Elaborazione

Dopo aver selezionato un genie o inviato un prompt libero, il selettore mostra un feedback inline:

• In elaborazione — Un indicatore di pensiero con contatore del tempo trascorso. Premi Escape per annullare.
• Anteprima — La risposta IA viene trasmessa in tempo reale. Usa Accetta per applicare o Rifiuta per scartare.
• Errore — Se qualcosa va storto, appare il messaggio di errore con un pulsante Riprova.

La barra di stato mostra anche i progressi dell'IA — un'icona girevole con il tempo trascorso durante l'esecuzione, un breve flash "Completato" al completamento, o un indicatore di errore con i pulsanti Riprova/Ignora. La barra di stato si mostra automaticamente quando l'IA è attiva, anche se in precedenza l'hai nascosta con F7.

Genies Integrati

VMark viene fornito con 13 genies in quattro categorie:

Modifica

Genie	Descrizione	Ambito
Polish	Migliora chiarezza e fluidità	Selezione
Condense	Rendi il testo più conciso	Selezione
Fix Grammar	Correggi grammatica e ortografia	Selezione
Simplify	Usa un linguaggio più semplice	Selezione

Creativo

Genie	Descrizione	Ambito
Expand	Sviluppa l'idea in una prosa più completa	Selezione
Rephrase	Di' la stessa cosa in modo diverso	Selezione
Vivid	Aggiungi dettagli sensoriali e immagini	Selezione
Continue	Continua a scrivere da qui	Blocco

Struttura

Genie	Descrizione	Ambito
Summarize	Riassumi il documento	Documento
Outline	Genera una scaletta	Documento
Headline	Suggerisci opzioni di titolo	Documento

Strumenti

Genie	Descrizione	Ambito
Translate	Traduci in inglese	Selezione
Rewrite in English	Riscrivi il testo in inglese	Selezione

Ambito

Ogni genie opera su uno dei tre ambiti:

• Selezione — Il testo evidenziato. Se non è selezionato nulla, ricade sul blocco corrente.
• Blocco — Il paragrafo o l'elemento blocco alla posizione del cursore.
• Documento — L'intero contenuto del documento.

L'ambito determina quale testo viene estratto e passato all'IA come .

TIP

Se l'ambito è Selezione ma non è selezionato nulla, il genie opera sul paragrafo corrente.

Revisione dei Suggerimenti

Dopo che un genie viene eseguito, il suggerimento appare inline:

• Sostituisci — Testo originale con barra, nuovo testo in verde
• Inserisci — Nuovo testo mostrato in verde dopo il blocco sorgente
• Elimina — Testo originale con barra

Ogni suggerimento ha pulsanti accetta (segno di spunta) e rifiuta (X).

Scorciatoie da Tastiera

Azione	Scorciatoia
Accetta suggerimento	Enter
Rifiuta suggerimento	Escape
Suggerimento successivo	Tab
Suggerimento precedente	Shift + Tab
Accetta tutti	Mod + Shift + Enter
Rifiuta tutti	Mod + Shift + Escape

Indicatore della Barra di Stato

Mentre l'IA genera, la barra di stato mostra un'icona scintillante girevole con un contatore del tempo trascorso ("Elaborazione... 3s"). Un pulsante di annullamento (×) ti permette di interrompere la richiesta.

Al completamento, un breve segno di spunta "Completato" lampeggia per 3 secondi. Se si verifica un errore, la barra di stato mostra il messaggio di errore con i pulsanti Riprova e Ignora.

La barra di stato si mostra automaticamente quando l'IA è attiva (in esecuzione, errore o completamento), anche se l'hai nascosta con F7.

---

Scrittura di Genies Personalizzati

Puoi creare i tuoi genies. Ogni genie è un singolo file Markdown con frontmatter YAML e un modello di prompt.

Dove Vivono i Genies

I genies sono memorizzati nella directory dei dati dell'applicazione:

Piattaforma	Percorso
macOS	~/Library/Application Support/com.vmark.app/genies/
Windows	%APPDATA%\com.vmark.app\genies\
Linux	~/.local/share/com.vmark.app/genies/

Apri questa cartella dal menu Strumenti > Apri cartella Genies.

Struttura delle Directory

Le sottodirectory diventano categorie nel selettore. Puoi organizzare i genies come preferisci:

genies/
├── editing/
│   ├── polish.md
│   ├── condense.md
│   └── fix-grammar.md
├── creative/
│   ├── expand.md
│   └── rephrase.md
├── academic/          ← la tua categoria personalizzata
│   ├── cite.md
│   └── abstract.md
└── my-workflows/      ← un'altra categoria personalizzata
    └── blog-intro.md

Formato del File

Ogni file genie ha due parti: frontmatter (metadati) e template (il prompt).

---
description: Improve clarity and flow
scope: selection
category: editing
---

You are an expert editor. Improve the clarity, flow, and conciseness
of the following text while preserving the author's voice and intent.

Return only the improved text — no explanations.

{{content}}

Il nome file polish.md diventa il nome visualizzato "Polish" nel selettore.

Campi del Frontmatter

Campo	Obbligatorio	Valori	Predefinito
description	No	Breve descrizione mostrata nel selettore	Vuoto
scope	No	selection, block, document	selection
category	No	Nome della categoria per il raggruppamento	Nome della sottodirectory
action	No	replace, insert	replace
context	No	1, 2	0 (nessuno)
model	No	Identificatore del modello per sovrascrivere il predefinito del provider	Predefinito del provider

Nome del genie — Il nome visualizzato è sempre derivato dal nome file (senza .md). Per esempio, fix-grammar.md appare come "Fix Grammar" nel selettore. Rinomina il file per cambiare il nome visualizzato.

Il Segnaposto

Il segnaposto è il nucleo di ogni genie. Quando un genie viene eseguito, VMark:

1. Estrae il testo in base all'ambito (testo selezionato, blocco corrente o intero documento)
2. Sostituisce ogni nel tuo template con il testo estratto
3. Invia il prompt compilato al provider IA attivo
4. Trasmette la risposta come suggerimento inline

Per esempio, con questo template:

Translate the following text into French.

{{content}}

Se l'utente seleziona "Hello, how are you?", l'IA riceve:

Translate the following text into French.

Hello, how are you?

L'IA risponde con "Bonjour, comment allez-vous ?" e appare come suggerimento inline che sostituisce il testo selezionato.

Il Segnaposto

Il segnaposto fornisce all'IA il testo circostante in sola lettura — così può abbinare tono, stile e struttura dei blocchi vicini senza modificarli.

Come funziona:

1. Imposta context: 1 o context: 2 nel frontmatter per includere ±1 o ±2 blocchi vicini
2. Usa nel tuo template dove vuoi iniettare il testo circostante
3. L'IA vede il contesto ma il suggerimento sostituisce solo

I blocchi composti sono atomici — se un vicino è un elenco, una tabella, una citazione o un blocco dettagli, l'intera struttura conta come un blocco.

Restrizioni dell'ambito — Il contesto funziona solo con l'ambito selection e block. Per l'ambito document, il contenuto è già l'intero documento.

Prompt liberi — Quando digiti un'istruzione libera nel selettore, VMark include automaticamente ±1 blocco circostante come contesto per gli ambiti selection e block. Nessuna configurazione necessaria.

Retrocompatibile — I genies senza funzionano esattamente come prima. Se il template non contiene , non viene estratto nessun testo circostante.

Esempio — cosa riceve l'IA:

Con context: 1 e il cursore sul secondo paragrafo di un documento a tre paragrafi:

[Before]
Contenuto del primo paragrafo qui.

[After]
Contenuto del terzo paragrafo qui.

Le sezioni [Before] e [After] vengono omesse quando non ci sono vicini in quella direzione (es. il contenuto è all'inizio o alla fine del documento).

Il Campo action

Per impostazione predefinita, i genies sostituiscono il testo sorgente con l'output dell'IA. Imposta action: insert per aggiungere l'output dopo il blocco sorgente invece.

Usa replace per: modifica, riformulazione, traduzione, correzioni grammaticali — qualsiasi cosa che trasformi il testo originale.

Usa insert per: continuare a scrivere, generare riassunti sotto il contenuto, aggiungere commenti — qualsiasi cosa che aggiunga nuovo testo senza rimuovere l'originale.

Esempio — azione insert:

---
description: Continue writing from here
scope: block
action: insert
---

Continue writing naturally from where the following text leaves off.
Match the author's voice, style, and tone. Write 2-3 paragraphs.

Do not repeat or summarize the existing text — just continue it.

{{content}}

Il Campo model

Sovrascrive il modello predefinito per un genie specifico. Utile quando vuoi un modello più economico per attività semplici o uno più potente per attività complesse.

---
description: Quick grammar fix (uses fast model)
scope: selection
model: claude-haiku-4-5-20251001
---

Fix grammar and spelling errors. Return only the corrected text.

{{content}}

L'identificatore del modello deve corrispondere a quello accettato dal tuo provider attivo.

Scrittura di Prompt Efficaci

Sii Specifico sul Formato dell'Output

Di' all'IA esattamente cosa restituire. Senza questo, i modelli tendono ad aggiungere spiegazioni, intestazioni o commenti.

<!-- Good -->
Return only the improved text — no explanations.

<!-- Bad — AI may wrap output in quotes, add "Here's the improved version:", etc. -->
Improve this text.

Assegna un Ruolo

Dai all'IA un personaggio per ancorare il suo comportamento.

<!-- Good -->
You are an expert technical editor who specializes in API documentation.

<!-- Okay but less focused -->
Edit the following text.

Limita l'Ambito

Di' all'IA cosa NON cambiare. Questo previene la sovraeditazione.

<!-- Good -->
Fix grammar and spelling errors only.
Do not change the meaning, style, or tone.
Do not restructure sentences.

<!-- Bad — gives the AI too much freedom -->
Fix this text.

Usa Markdown nei Prompt

Puoi usare la formattazione Markdown nei tuoi template di prompt. Questo aiuta quando vuoi che l'IA produca output strutturato.

---
description: Generate a pros/cons analysis
scope: selection
action: insert
---

Analyze the following text and produce a brief pros/cons list.

Format as:

**Pros:**
- point 1
- point 2

**Cons:**
- point 1
- point 2

{{content}}

Mantieni i Prompt Focalizzati

Un genie, un compito. Non combinare più attività in un singolo genie — crea invece genies separati.

<!-- Good — one clear job -->
---
description: Convert to active voice
scope: selection
---

Rewrite the following text using active voice.
Do not change the meaning.
Return only the rewritten text.

{{content}}

Genies Personalizzati di Esempio

Accademico — Scrivi un Abstract

---
description: Generate an academic abstract
scope: document
action: insert
---

Read the following paper and write a concise academic abstract
(150-250 words). Follow standard structure: background, methods,
results, conclusion.

{{content}}

Blog — Genera un Aggancio

---
description: Write an engaging opening paragraph
scope: document
action: insert
---

Read the following draft and write a compelling opening paragraph
that hooks the reader. Use a question, surprising fact, or vivid
scene. Keep it under 3 sentences.

{{content}}

Codice — Spiega il Blocco di Codice

---
description: Add a plain-English explanation above code
scope: selection
action: insert
---

Read the following code and write a brief plain-English explanation
of what it does. Use 1-2 sentences. Do not include the code itself
in your response.

{{content}}

Email — Rendi Professionale

---
description: Rewrite in professional tone
scope: selection
---

Rewrite the following text in a professional, business-appropriate tone.
Keep the same meaning and key points. Remove casual language,
slang, and filler words.

Return only the rewritten text — no explanations.

{{content}}

Traduzione — In Cinese Semplificato

---
description: Translate to Simplified Chinese
scope: selection
---

Translate the following text into Simplified Chinese.
Preserve the original meaning, tone, and formatting.
Use natural, idiomatic Chinese — not word-for-word translation.

Return only the translated text — no explanations.

{{content}}

Contestuale — Adattati all'Ambiente

---
description: Rewrite to match surrounding tone and style
scope: selection
context: 1
---

Rewrite the following content to fit naturally with its surrounding context.
Match the tone, style, and level of detail.

Return only the rewritten text — no explanations.

## Surrounding context (do not include in output):
{{context}}

## Content to rewrite:
{{content}}

Revisione — Verifica Fatti

---
description: Flag claims that need verification
scope: selection
action: insert
---

Read the following text and list any factual claims that should be
verified. For each claim, note why it might need checking (e.g.,
specific numbers, dates, statistics, or strong assertions).

Format as a bullet list. If everything looks solid, say
"No claims flagged for verification."

{{content}}

Limitazioni

• I genies funzionano solo in modalità WYSIWYG. In modalità sorgente, una notifica toast spiega questo.
• Un genie può essere eseguito alla volta. Se l'IA sta già generando, il selettore non avvierà un altro.
• Il segnaposto viene sostituito letteralmente — non supporta condizionali o cicli.
• I documenti molto grandi potrebbero raggiungere i limiti di token del provider quando si usa scope: document.

Risoluzione dei Problemi

"Nessun provider IA disponibile" — Apri Impostazioni > Integrazioni e configura un provider. Vedi Provider IA.

Il genie non appare nel selettore — Verifica che il file abbia un'estensione .md, un frontmatter valido con delimitatori --- e si trovi nella directory dei genies (non in una sottodirectory più profonda di un livello).

L'IA restituisce spazzatura o errori — Verifica che la tua chiave API sia corretta e che il nome del modello sia valido per il tuo provider. Controlla il terminale/console per i dettagli dell'errore.

Il suggerimento non soddisfa le aspettative — Perfeziona il tuo prompt. Aggiungi vincoli ("restituisci solo il testo", "non spiegare"), assegna un ruolo o restringi l'ambito.

Vedi Anche

• Provider IA — Configura provider CLI o API REST
• Scorciatoie da Tastiera — Riferimento completo delle scorciatoie
• Strumenti MCP — Integrazione IA esterna tramite MCP