为什么值得关注

提供完整且透明的工作流程，包含教练/专家模式、信心分数，且无需后端——所有数据保留在浏览器中。

适合谁使用

追求精准耗材配置的3D打印爱好者
Orca Slicer 或 Bambu Studio 用户
偏好逐步指导、无需外部资料的创客

典型使用场景

校准新耗材以获得最佳打印质量
为特定打印机-耗材组合创建标准化配置
快速设置多卷耗材的一致参数

项目优势

引导式工作流，包含教练模式与自适应故障排除
完全透明的计算过程，显示输入、公式与舍入
隐私优先：无需账户、无后端、所有数据本地存储
内置打印机数据库，自动填充多种型号规格

使用前须知

不支持直接导出切片机预设文件（需手动输入）
二维码链接到托管实例，不嵌入数据
照片仅存储但不自动分析

README 快速开始

PerfectFit — Filament Calibration Wizard

Create a perfectly calibrated filament profile for Orca Slicer or Bambu Studio in one guided workflow. No tutorials, no guesswork, no spreadsheets.

A local-first web app that walks you step by step through calibrating a filament profile for Orca Slicer (default) or Bambu Studio — temperature, flow ratio (two passes), pressure advance, retraction, max volumetric speed, and a final verification print — without tutorials, wikis, or guesswork.

Coach Mode: plain-language guidance, good/bad examples, "I'm not sure" decision helpers, confidence checks, adaptive troubleshooting.
Expert Mode: condensed flow — ranges, formulas, destinations.
No black boxes: every calculation shows inputs, formula, substitution, and rounding.
Signature features: calibration timeline, confidence score, smart retest recommendations, printable one-page calibration card with QR, printable full report, JSON backup/restore.
Privacy: no account, no backend, no analytics/telemetry. Everything (photos included) stays in your browser's local storage. External model links open third-party sites.

Requirements

Node.js 18+ (for development/build only — the built app is static files)

Install & run (development)

npm install
npm run dev          # http://localhost:5173

Tests

npm test             # vitest: formulas, ranges, numbering, margins, import/export, migration, validation

A human-workflow checklist lives in docs/MANUAL_TEST_CHECKLIST.md.

Production build

npm run build        # typechecks, then bundles to dist/
npm run preview      # serve the production bundle locally

dist/ is fully static and uses relative paths — it works from any folder or subpath.

Updating the Printer Database

The Add Printer screen lets users pick from a database of known printers, which auto-fills the machine specs (temperature limits, extruder type, build volume, supported nozzle sizes, chamber, firmware…). That database is generated from a human-editable spreadsheet and committed as JSON, so no build tooling or Excel is needed at runtime.

Source of truth: Printer_Database/Printer_Database.xlsx → worksheet Printer Specifications. Runtime data: [src/data/printers.json](s

项目描述

A tool to calibrate filaments in both Orca Slicer and Bambu Studios. For beginners to experts.

Filament_Calibration_Wizard