Documentazione
Panoramica
CADCAMFUN porta disegno, modellazione solida, percorsi utensile, cronologia del progetto e un assistente AI in un'applicazione desktop locale.
Tradotto automaticamente dall'inglese. Vedi l'originale in inglese
Prodotto
Il desktop combina un workbench SolidJS con una shell Tauri. L'ambiente di lavoro modifica disegni e modelli, visualizza la geometria in una finestra Three.js, gestisce le operazioni di lavorazione e visualizza in anteprima o esporta il codice G. I dati del progetto, gli strumenti, i materiali, le configurazioni della macchina e lo stato dell'assistente vengono gestiti da un sidecar Bun e archiviati localmente.
Il kernel computazionale è condiviso tra desktop e sidecar. La geometria interattiva può essere eseguita nella visualizzazione Web senza un round trip HTTP; le operazioni persistenti, le chiamate al fornitore, la cronologia del progetto e l'esecuzione del flusso di lavoro passano attraverso servizi collaterali. L'archiviazione locale non richiede un account dell'applicazione ospitata. I fornitori di intelligenza artificiale, le operazioni GitHub, i pagamenti e gli aggiornamenti software utilizzano i servizi di rete configurati.
Dalla progettazione alla lavorazione
- Crea o apri un progetto e prepara i suoi disegni, entità o scene solide. IL Riferimento CAD copre schizzi, geometria B-rep, tassellatura e formati di scambio.
- Scegli un'operazione, uno strumento, un materiale e una configurazione della macchina. Genera percorsi utensile con Servizi CAM e ispezionare il risultato nel viewport.
- Utilizzo configurazioni di lavorazione e documenti di programma per conservare l'ordine delle operazioni, i quadri di lavoro e le impostazioni del programma. Seleziona un post registrato per il controller desiderato.
- Esaminare il programma generato e i risultati della verifica prima dell'esportazione. Il kernel della geometria, il post-registro, le trasformazioni avanzate del codice G e la configurazione della macchina sono parti distinte di questo processo.
- Registra un'istantanea del progetto con storiao eseguire un account registrato flusso di lavoro per validazioni ed elaborazioni ripetute.
Il assistente richiama le azioni dell'applicazione tramite gli stessi adattatori di servizio utilizzati dall'app. IL compagno mobile si connette a un desktop associato; non esegue un secondo backend CAD/CAM sul telefono.
Componenti di esecuzione
apps/desktop- Il workbench SolidJS, gli adattatori di percorso, i moduli di funzionalità, il viewport e la shell Tauri nativa.
apps/sidecar- Gestori HTTP autenticati, repository, servizi di effetti, identità locale, integrazione AI, gateway complementare e ciclo di vita del database.
apps/mobile- Compagno Expo con trasporto di abbinamento nativo, visualizzazioni di progetti e cronologia e accesso assistente.
packages/web- Questo sito di documentazione Astro, esportazione Markdown, assistente alla documentazione, pagine di guida generate e Studio locale.
Il riferimento allo spazio di lavoro descrive ogni biblioteca, il suo punto di accesso pubblico e i suoi consumatori. IL mappa delle sorgenti punta ai file di implementazione per le modifiche comuni.
Inizia lo sviluppo
bun install
bun run desktop:dev
# Documentation and local Studio
bun run --filter @cadcamfun/web dev Il comando desktop compila il sidecar e copia le risorse di migrazione prima di avviare Tauri. Rust e i prerequisiti di build della piattaforma webview devono essere installati. Per eseguire il server di documentazione senza avviare l'API di Studio locale, utilizzare bun run --filter @cadcamfun/web start.
Seguire Avvio rapido per i prerequisiti e il primo avvio, oppure Sviluppo locale per sidecar isolati e loop client.
Contratti e persistenza
packages/api/src/index.ts compone il contratto HTTP schema-first. Quello del sidecar ServedApi seleziona i gruppi a cui serve e pubblica un documento OpenAPI in /api/openapi.json. La shell rileva la porta di loopback allocata dinamicamente da un evento di disponibilità e fornisce alla visualizzazione Web un endpoint e un token di connessione.
Il database del sidecar è cadcamfun.db nella directory dei dati configurata. Il livello del database abilita chiavi esterne e WAL, applica le migrazioni configurate ed esegue il backup di un file esistente prima di un aggiornamento in sospeso. Lo Studio della documentazione ha la propria selezione del percorso del database; non rileva automaticamente il file del sidecar in esecuzione.
Queste pagine descrivono l'implementazione in questo repository. Un'esportazione di pacchetto, un endpoint HTTP, un controllo desktop e un programma di installazione rilasciato sono superfici di integrazione diverse; consultare il riferimento pertinente per i comportamenti e i limiti supportati.
Scegli un percorso lavorativo
| Compito | Inizia qui | Cosa conservare |
|---|---|---|
| Modifica una parte | Geometria CAD e controlli della vista | La cronologia del disegno o della caratteristica modificabile, incluse le unità e il posizionamento. |
| Genera output di lavorazione | CAMMA e programmi salvati | La geometria, il grezzo, gli utensili, le impostazioni della macchina, i dati NC emessi e le prove di verifica applicabili acquisiti. |
| Esaminare una modifica | Storia del progetto | Il commit e la differenza strutturale, oltre agli attuali verdetti della revisione. |
| Automatizza un controllo ripetuto | Flussi di lavoro | Il file del flusso di lavoro impegnato, il riferimento selezionato, i passaggi registrati e i risultati dei singoli controlli. |
| Costruisci un'integrazione | Riferimento API | Il tipo di token corretto, il contratto esatto dell'endpoint e la gestione dei risultati/errori. |
I salvataggi del progetto, le versioni delle risorse, i commit dell'intero progetto, la sincronizzazione remota e gli artefatti della guida generati sono operazioni separate. Il salvataggio di un percorso utensile non lo impegna automaticamente e un push GitHub riuscito non ne verifica l'output di lavorazione.
Per una prima integrazione API seguire la richiedere la procedura dettagliata. Mostra l'indagine sulla salute pubblica, le chiamate protette, la creazione di progetti e l'archiviazione delle preferenze con le risposte del gestore acquisite.
Documentazione operativa
Il biblioteca di guide cammina attraverso compiti completi. Inizia con creazione del progetto e lavoro salvato, quindi utilizzare manifattura nativa prendere un progetto catturato attraverso la generazione e la persistenza del programma. Entrambi spiegano cosa viene salvato e cosa rimane nello stato derivato o non salvato.
Per il lavoro di integrazione, il Riferimento alla risorsa API copre ogni operazione dichiarata con schemi di richiesta e risposta. IL guida all'integrazione del cliente copre la costruzione di Promise and Effect, l'autenticazione, la cancellazione e la gestione degli errori. IL guida in streaming aggiunge il recupero della conversazione e la gestione interattiva di permessi/domande.
Per il funzionamento e il supporto, consultare configurazione in fase di esecuzione, diagnosi da tavolo, e abbinamento di compagni. Ciascuno mantiene distinti la shell nativa, il sidecar, il database, il provider, il gateway telefonico e la distribuzione della documentazione in modo che un errore possa essere analizzato al suo limite effettivo.
Per estensioni e lavoro di squadra, utilizzare creazione di plug-in e rami, revisioni e flussi di lavoro. Queste guide documentano le esportazioni dei moduli supportati, il comportamento attuale dell'host, le regole di unione strutturale, gli input del flusso di lavoro impegnati e gli effetti collaterali supportati dai servizi.
CADCAMFUN in numeri
| Misura | Valore |
|---|---|
| Versione dell'applicazione | 6.0.0 |
| Operazioni HTTP/gruppi di risorse | 270 / 34 |
| Tabelle/migrazioni del database | 60 / 4 |
| Spazi di lavoro | 10 pacchetti, 3 app |
| Obiettivi di rilascio desktop | 6 (macOS, Windows e Linux, ciascuno x64 e ARM64) |
| Dialetti postali del codice G | generico, GRBL, Fanuc, Haas (nome LinuxCNC riservato) |
| Strategie CAM native | faccia, adattativo, tasca, profilo, foro, foratura, filettatura, incisione, smusso, superficie |
| Affermazioni sulle prove del kernel | 10, dai dati di taglio alla riproduzione NC e allo sdoganamento della macchina |
Cosa c'è di nuovo
Lavoro recente sul ramo principale, riassunto dalla cronologia dei commit:
- Kernel esatto sul sidecar. A
cadExactgruppo (analyze,step,assembly) esegue un'analisi della scena condivisa dal nucleo: validità per solido, massa, fori, interferenza, distinta base e elementi di fissaggio mancanti. - Modellazione esatta. Sweep e sweep shell, loft con colonne rigate razionali, push-pull e accoppiamento su facce esatte e raccordi circa 2.5× più veloce.
- Sottoprogrammi NC. I percorsi utensile ripetuti vengono scritti una volta come incrementali
M98sottoprogramma; la riproduzione capisceO-programmi,M98/M99eG91. Cablato da un capo all'altro dall'istantanea allo switch del desktop. - CAM da B-rep. Il pianificatore legge fori, tasche e contorni da solidi esatti, comprese parti STEP e parti ruotate; L'asportazione volumetrica funziona lungo un asse utensile inclinato.
- Assistente indurimento. Every action declares its result schema; destructive tools always need a human; each turn is bound to its drawing with compare-and-swap writes; a durable background-task journal; kernel jobs in a worker.
- Documentazione. Questo sito Astro con un riferimento API generato per ogni operazione.
Prossimi passi
| Se lo desidera… | Vai a |
|---|---|
| Installa una build pubblicata | Scaricamento e Installare |
| Esegui l'app dall'origine | Avvio rapido, poi Sviluppo locale |
| Comprendere i processi | Architettura e Sidecar |
| Modellare una parte | CAD e Visualizzazione |
| Genera codice G | CAMMA e Produzione nativa |
| Chiama l'API | Visita dell'API e Client API |
| Estendi l'app | Creazione di plugin |
| Gestisci il tuo account | Studio e Conti |
| Contribuire | Contribuire |