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:
1 parent
b9affd9bef
commit
8785d7429d
4 files changed
+46
-3
No files matched your search
@@ -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 ``: 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._
|
||||
|
||||
Reference in new issue
Block a user