xiao-villamor/PrintStash

📦 PrintStash: Quản lý tài nguyên in 3D tự host, không cần nhớ tên mô hình nữa

Quản lý toàn bộ thư viện in 3D cá nhân: từ STL tới G-code, kể cả lịch sử in và chi phí nguyên liệu.

PrintStash là một ứng dụng web local-first, tự host, dùng để quản lý thư viện tệp in 3D bao gồm STL, 3MF, OBJ, STEP/STP và G-code. Người dùng có thể tải lên thủ công hoặc để OrcaSlicer tự động đẩy G-code mới sau mỗi lần cắt. Tìm kiếm nhanh theo tên mô hình, bộ sưu tập, thẻ, siêu dữ liệu slicer, vật liệu, máy in và lịch sử in.

✨ Điểm nổi bật

• Tải lên đa định dạng: Hỗ trợ STL, 3MF, OBJ, STEP/STP và G-code từ trình duyệt.
• Nhập URL và ZIP: Hỗ trợ nhập tệp qua URL hoặc lư trữ ZIP với chọn lọc từng tệp khi giải nén.
• Tích hợp OrcaSlicer: Hook hậu xử lý OrcaSlicer tự động đăng nhập và tải G-code lên thông qua JWT Bearer token.
• Nhóm bản ghi trùng lặp: Dựa trên hàm băm nội dung để gộp các phiên bản trùng lặp thành một mô hình logic.
• Đồng bộ thư mục chia sẻ: Chỉ định thư mục trên server hoặc NAS để lập chỉ mục trực tiếp mà không cần sao chép.
• Xem trước 3D trình duyệt: Viewer 3D hỗ trợ chế độ khối rỗng, xuyên tâm, và đường viền, kèm lưới build-plate.
• Xem trước G-code: Điều hướng từng lớp, ẩn/hiện đường di chuyển và hiển thị lớp nền từ hồ sơ máy in.
• Theo dõi máy in: Kết nối với máy in Moonraker/Klipper qua WebSocket, đồng bộ danh sách tệp và gửi lệnh in từ xa.
• Thống kê chi phí: Biểu đồ thời gian thực về tổng chi phí, lượt in, nguyên liệu tiêu thụ và thời gian in.
• Quản lý người dùng: Hệ thống người dùng, phân quyền truy cập và quản trị viên riêng biệt.

💡 Vì sao đáng chú ý

PrintStash khác biệt từ các giải pháp lưu trữ đơn thuần bằng cách kết hợp toàn diện quy trình làm việc từ lưu trữ, xem trước, cắt G-code cho đến theo dõi kết quả thực tế từ máy in. Đặc biệt, khả năng đồng bộ hai chiều với thư mục NAS và tích hợp sâu với OrcaSlicer cùng Moonraker giúp giảm thiểu thao tác thủ công. Dự án phù hợp với các bạn trại in 3D cá nhân hoặc nhỏ lẻ muốn tự quản lý toàn bộ thư viện và lịch sử in 3D mà không phụ thuộc vào dịch vụ đám mây.

#3DPrinting #SelfHosted #FastAPI #GCode #Moonraker #TiniX