AFangTeam/PrintLab

项目介绍

PrintLab 是一个把想法做成实物的本地 3D 打印工作台与协作流程，面向 Mac / Windows、Codex 等具备终端能力的 Agent，以及拓竹（Bambu Lab）打印机。你描述需求，Agent 协助选外形、建模、比较切片，并把版本、材料、打印记录和实物反馈保存在同一个工作空间里。

工作台包含项目图册、真实 3D 模型预览与设计版本、Bambuddy 提供的设备/材料/已捕获打印历史、灵感收藏与个人偏好、跨项目配件清单与库存采购记录，以及绑定具体任务的打印包、材料映射、时间和用量确认。

快速使用

准备：Python 3.11+、Node.js 22+、git；设备功能需要单独安装 Bambuddy，通用工作台可独立启动。

git clone https://github.com/AFangTeam/PrintLab.git
cd PrintLab
bash scripts/setup.sh
bash scripts/start.sh

然后打开 http://127.0.0.1:8018。安装程序生成空工作空间和本机配置，重复运行会保留已有配置。系统 Python 较旧时用 PRINTLAB_PYTHON=/你的/python3 bash scripts/setup.sh 指定解释器，细节见安装指南。

也可以从最新 Release 下载 PrintLab.zip，或执行等价的 curl/unzip 流程。Windows 用户安装 Python 3.11+ 与 Node.js 22+ 后，在仓库目录的 PowerShell 中运行：

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\setup.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\start.ps1

README 还提供了 Agent 安装路径：把仓库链接和给定提示词发给具有本机终端、文件读写能力的 Codex，由它读取 README、AGENTS.md 和接手指南并完成安装与入门验收。首次设备信息通过配置访谈收集，聊天与网页分工示例见交互指南。

使用约束

• 支持 macOS 14+（推荐 Apple Silicon）和 Windows（原生 PowerShell 安装、命令行与浏览器工作台）。
• 设备状态与历史依赖单独安装的 Bambuddy；第三方项目、模型权重、Bambu 软件和插件从各自官方来源独立获取。
• 自动发送助手只覆盖 X2D、中文 Bambu Studio 02.08.02.61、0.4 mm、单主料 AMS、左主喷嘴、纹理 PEI 单盘；其他机型、版本和多材料路线需按现场情况核对。
• 本轮不包含安装前的 Bambu Cloud 历史与 MakerWorld 账号收藏导入；依赖 Handy、云打印或账号收藏的用户需在安装时说明。
• 原创源码和文档采用 PolyForm Noncommercial 1.0.0，允许非商业使用、修改与再发布并需保留许可和 NOTICE.txt 署名；商业用途需另行取得 AFangTeam 授权。
• 测试使用临时工作空间与合成设备，已安装设备的只读检查需显式设置 PRINTLAB_LIVE_TEST=1。

HotRepo 点评

PrintLab 在 2026-11-12 的 Python 新项目榜有记录，当天累计 109 Star、12 Fork，统计窗口内约 90 分钟新增 5 Star。观察时间很短，只能说明仓库早期获得了一定关注，不能据此判断长期趋势。项目看点在于把 Agent 工作流与具体硬件流程绑在一起；而已验证的自动发送配置只覆盖单一打印机与软件组合，使用其他设备或版本的读者可以把工作台当作可用起点，但自动打印路径需要按自身环境逐项确认。

项目源码与说明