How qvarcy/printguardian works
PrintGuardian is a local-first Windows desktop pre-flight tool for Bambu Studio/OrcaSlicer 3MF projects. Its main workflow opens or drops a project, inspects its archive and settings, surfaces attention points, compares it with a trusted profile, lets the user choose supported changes, then rebuilds and verifies a separate export. The graph also preserves profile/history state and the documented update capability. Relationships are based on excerpts, SOURCE INDEX references, or README statements; unsampled feature implementations are represented only at their documented subsystem level.
Main entry points: App.tsx Application shell · safeThreeMfExporter.ts Verified exporter · threeMfInspector.ts 3MF inspector · GuidedProjectReview.tsx Guided review
Components 26
Project workflow
- Application shell
src/App.tsx - Project drop
src/components/DropZone.tsx - 3MF inspector
src/lib/threeMfInspector.ts - ZIP reader
src/lib/zip.ts - Settings bridge
src/lib/projectSettingsBridge.ts - Project workspace
src/components/ProjectWorkspace.tsx - Workspace plan
src/lib/workspacePlan.ts
Profiles and decisions
- Guided review
src/components/GuidedProjectReview.tsx - Profile comparison
src/components/ProfileDiffPanel.tsx - Saved profiles
src/components/PrintProfilesPanel.tsx - Trusted baseline
src/lib/baselineProfile.ts - Profile library
src/lib/printProfiles.ts - Profile diff
src/lib/profileDiff.ts - Decision plan
src/lib/profileDecisionPlan.ts
Safe export
- Build preview
src/components/SafeBuildPreviewPanel.tsx - Safe build preview
src/lib/safeThreeMfBuildPreview.ts - Verified exporter
src/lib/safeThreeMfExporter.ts - ZIP writer
src/lib/zipWriter.ts - New 3MF copy
Local state
- Project history
src/lib/projectHistory.ts - Recent project
src/lib/recentProject.ts
Desktop services
- Update centre
src/components/UpdateCentreButton.tsx - Update service
src/lib/updateCenter.ts - Feature discovery
src/lib/featureDiscovery.ts - Desktop runtime
src/lib/desktopRuntime.ts
Other components
- Project user
Connections 30
- Project user → Project drop: opens or drops
- Project drop → Application shell: selects project
src/App.tsx - Application shell → 3MF inspector: inspects project
src/App.tsx - 3MF inspector → ZIP reader: reads archive
src/lib/threeMfInspector.ts - 3MF inspector → Settings bridge: captures settings
src/lib/threeMfInspector.ts - Application shell → Project workspace: shows inspection
src/App.tsx - Project workspace → Workspace plan: persists choices
src/components/ProjectWorkspace.tsx - Application shell → Project history: loads history
src/App.tsx - Application shell → Recent project: saves recent project
src/App.tsx - Application shell → Profile library: adds profile
src/App.tsx - Application shell → Trusted baseline: creates baseline
src/App.tsx - Project user → Profile comparison: compares profiles
- Saved profiles → Profile library: manages profiles
src/components/PrintProfilesPanel.tsx - Profile comparison → Profile diff: shows differences
src/components/ProfileDiffPanel.tsx - Profile diff → 3MF inspector: uses inspection data
src/lib/profileDiff.ts - Guided review → Trusted baseline: saves trusted baseline
src/components/GuidedProjectReview.tsx - Guided review → Decision plan: restores decisions
src/components/GuidedProjectReview.tsx - Guided review → Verified exporter: requests verified export
src/components/GuidedProjectReview.tsx - Project user → Build preview: reviews changes
- Build preview → Safe build preview: builds preview
src/components/SafeBuildPreviewPanel.tsx - Build preview → Verified exporter: requests export
src/components/SafeBuildPreviewPanel.tsx - Safe build preview → Settings bridge: maps setting values
src/lib/safeThreeMfBuildPreview.ts - Verified exporter → ZIP writer: rebuilds archive
src/lib/safeThreeMfExporter.ts - Verified exporter → ZIP reader: checks archives
src/lib/safeThreeMfExporter.ts - Verified exporter → 3MF inspector: reinspects output
src/lib/safeThreeMfExporter.ts - Verified exporter → New 3MF copy: produces new copy
- Update centre → Update service: checks updates
src/components/UpdateCentreButton.tsx - Application shell → Feature discovery: discovers features
src/App.tsx - Feature discovery → Update service: checks feature updates
src/lib/featureDiscovery.ts - Update centre → Desktop runtime: reads runtime info
src/components/UpdateCentreButton.tsx