README: uso con il frontend agent-wiki-ui; figure incorporate come immagini Markdown

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
davideandClaude Sonnet 5.5 committed 2026-10-20 14:43:40 +02:00
1 parent b9affd9bef
commit 8785d7429d
4 files changed
+46 -3

No files matched your search

+40 -1
View File
@@ -64,7 +64,7 @@ scripts/ gen_figures.py, gen_bibliografia.py, lint.py
## Come si usa
1. Clona il repository e aprilo con un agente a riga di comando: **Claude Code**, **Codex** o **Antigravity CLI**. Skill e file di schema (`CLAUDE.md`, `AGENTS.md`) vengono trovati da soli. Obsidian è facoltativo, serve solo per sfogliare la wiki.
1. Clona il repository e aprilo con un agente a riga di comando (**Claude Code**, **Codex** o **Antigravity CLI**) oppure con il frontend grafico [agent-wiki-ui](#interfaccia-grafica-agent-wiki-ui). Skill e file di schema (`CLAUDE.md`, `AGENTS.md`) vengono trovati da soli. Obsidian è facoltativo, serve solo per sfogliare la wiki.
2. Fai una domanda in italiano, per esempio:
- «Perché il PCL evita l'ACQ allo stato solido?»
- «Confronta il band gap elettrochimico dei campioni bottle brush e mostrami i voltammogrammi.»
@@ -74,6 +74,45 @@ scripts/ gen_figures.py, gen_bibliografia.py, lint.py
La wiki è usata **in sola lettura**: l'agente non la modifica salvo richiesta esplicita. Lo schema di manutenzione (ingest, riallineamento, lint) resta nella cronologia git di `CLAUDE.md`, fino al commit `eb672df`.
## Interfaccia grafica (agent-wiki-ui)
Per interrogare la wiki senza terminale si può usare **[agent-wiki-ui](https://santantonio.sytes.net/davide/agent-wiki-ui.git)** come frontend: un eseguibile C# (.NET 10, Windows e Linux) con una chat in stile claude.ai, che lancia **Claude Code** (`claude -p`) o **Codex** (`codex exec`) nella cartella in cui si trova l'eseguibile. _Antigravity non è ancora supportato dal frontend._
```mermaid
flowchart LR
U["Utente<br/>chat della GUI"] -->|"domanda"| G["agent-wiki-ui<br/>nella radice del repo"]
G -->|"claude -p / codex exec"| E["Motore<br/>Claude Code o Codex"]
E -->|"legge schema e skill"| S["CLAUDE.md / AGENTS.md<br/>.agents/skills/"]
E -->|"consulta"| W["wiki/ e raw/"]
E -->|"risposta in Markdown<br/>con immagini"| G
G -->|"testo e figure"| U
classDef fonte fill:#dbeafe,stroke:#1e40af,color:#111
classDef wiki fill:#dcfce7,stroke:#166534,color:#111
classDef regole fill:#fef9c3,stroke:#854d0e,color:#111
classDef agente fill:#fce7f3,stroke:#9d174d,color:#111
classDef script fill:#e5e7eb,stroke:#374151,color:#111
class U,E agente
class G script
class S regole
class W wiki
```
_Il frontend è un semplice contenitore: non ha logica propria sulla wiki. Passa la domanda al motore, che lavora nella radice del repo e quindi trova da solo schema, skill e wiki, poi mostra la risposta._
**Come configurarlo**
1. **Motore.** Installa e autentica `claude` e/o `codex` nel PATH (guida: `docs/INSTALL.md` nel [repository del frontend](https://santantonio.sytes.net/davide/agent-wiki-ui.git)).
2. **Eseguibile.** Ottienilo dal repository del frontend (serve il .NET SDK 10 per compilarlo: `scripts/publish.sh` su Linux/macOS/WSL, `scripts/publish.ps1` su Windows; risultato in `dist/<sistema>/agent-wiki-ui[.exe]`).
3. **Posizione.** Copia l'eseguibile **nella radice di questo repository**, accanto a `CLAUDE.md` e `AGENTS.md`. È fondamentale: il motore parte nella cartella dell'eseguibile, non in quella da cui lo avvii. Gli eseguibili in radice sono ignorati da git.
4. **Avvio.** Doppio clic (Windows) o `./agent-wiki-ui` (Linux, serve X11 o XWayland). Senza argomenti si apre la chat; con argomenti funziona da riga di comando (`./agent-wiki-ui "domanda"`, `--engine codex` per Codex).
**Cose da sapere**
- **Modello e effort.** All'avvio e a ogni cambio di motore il frontend sceglie il modello più piccolo ed effort `low`, per risposte rapide ed economiche. Per le risposte **approfondite e complete** che questo schema richiede, scegli nel riquadro **Impostazioni** un modello più capace e un effort più alto. Le impostazioni non sono salvate su disco: vanno ripetute a ogni avvio.
- **Figure.** Le risposte incorporano le immagini con `![descrizione](raw/immagini/<hash>.<ext>)`: il frontend le mostra se il file è locale e leggibile (png, jpg, gif, webp, bmp; fino a 20 MB). Gli URL web non vengono caricati.
- **Sola lettura.** Il frontend lancia Codex con sandbox in sola lettura; Claude Code parte senza bypass dei permessi. Coerente con la wiki usata in sola lettura.
- **Chat.** Una chat usa un solo motore; cambiare motore apre una nuova chat. Le conversazioni sono salvate su disco e l'ultima si riapre all'avvio. La risposta compare a fine generazione (nessuno streaming).
- **Stato del frontend.** È un MVP dichiarato tale nel suo repository: i test automatici sono ancora da scrivere e la GUI non è provata su Windows nativo.
- **Non verificato qui.** Non ho provato l'insieme frontend e questo repo: né l'avvio, né che Codex riesca a guardare le immagini in sola lettura.
## Come è costruito
_Il diagramma segue il materiale dal documento originale alla wiki, in quattro passi da sinistra a destra._