Skip to content

About

面向 USSA VAULT 模块化收纳系统的非官方组装工作台。

Resources

Stars

40 stars

Watchers

0 watching

Forks

Repository files navigation

Vault Workbench

简体中文 | English

USSA VAULT 的非官方本地组装工作台。选择尺寸,核对零件和五金,预览模型,再整理成打印清单。

原生 HTML / CSS / JavaScript,无需安装前端依赖。STL、说明书和文件夹索引在本地处理,原始资源包需自行准备。

Vault Workbench:尺寸配置、顶盖选择与提手五金提示

快速开始

  1. 下载并解压本仓库,保留 index.html、assets/ 和 scripts/ 的相对位置。
  2. 用桌面 Chrome 打开 index.html,页面右上角可切换中英文。
  3. 点击 选择 Vault 文件夹,选中已解压的资源包根目录。
  4. 按 文件夹 → 选配置 → 核对零件 → 打印清单 操作。没有资源包时,也可以先浏览规格。

只想找某个文件?连接文件夹后,打开 全部模型,输入 S3 导轨、handle 或 L6 隔板,即可预览模型、复制路径或保存副本。中文和英文可以混合搜索,无需切换界面语言。

资源目录示例(保留原包的目录和文件名):

My Vault/
├── 01. DRAWERS/
├── 02. SUSTAINERS/
├── 03. MODIFICATIONS/
├── 01_Instructions Manual.pdf
└── …其他说明书与图片

使用本地启动脚本

需要在全部模型列表或 3D 预览中 定位到原始文件 时,安装 Python 3.8+,再运行对应脚本:

系统 启动方式
macOS 双击 启动预览.command
Windows 双击 启动预览.bat
终端 python3 scripts/preview-server.py

默认地址为 http://127.0.0.1:8765/index.html。资源包放在项目目录或上一级;其他位置可指定路径,并在页面选择同一个文件夹:

python3 scripts/preview-server.py --resource-root "/path/to/Vault"

「定位到文件」会在 Finder / 文件资源管理器中选中原始 STL。直接打开 HTML 时不显示此按钮。

功能一览

功能 可以做什么
分步配置 选择抽屉或收纳盒,设置尺寸、顶盖、内部布局和适用的选装方案
全部模型 索引实际文件夹中的全部 STL;支持中英文模糊搜索、用途与规格筛选、分页、复制路径和单独预览
分类核对 按主体、机构、顶盖、内部收纳分组,默认展开;显示文件数、打印份数和备注
五金与安装 列出规格、每套用量、用途和说明书页码;网格顶盖提手联动加入 2 颗 M6 × 50 mm 螺丝
3D 预览 旋转、缩放、核对模型尺寸、保存副本;脚本模式支持定位原文件
配件与改造 查看适配的底板、隔板和替代件;按 8 类用途浏览底座、轮组、提手等改造件
说明书 按用途选择 5 本指南,查看本地可用状态,跳转相关安装页面;按编号、标题和语言识别不同命名的版本,缺少当前语言时自动回退
打印清单 保存多个方案,按套数汇总 STL 和五金,填写隔板用量,记录进度,导出 CSV 或 自动分盘 3MF

界面预览

截图来自当前版本的中文界面,点击可查看原图。

全部模型:中英文搜索、系统分类和单个文件操作

分类核对零件与五金 本地 STL 预览
分类核对:主体、滑动机构、顶盖提手及配套五金 3D 预览:查看模型、尺寸及定位到文件按钮
按用途选择改造件 说明书与安装指南
八类选配改造件及对应文件数量 五本说明书、当前配置推荐与本地 PDF 阅读
查看打印清单截图

打印清单:方案、套数与零件汇总

使用说明

  • 搜索范围:全部模型以实际文件夹为准,新加入或暂未分类的 STL 也会显示,同名文件按完整路径区分。尺寸筛选使用已知适配关系;规格未确认的文件可通过名称或路径搜索。搜索与筛选会随工作区保存,文件有变化时需重新扫描。
  • 数量怎么算:文件数量与打印份数分开显示。×2 表示打印两份 STL;文件内自带的成对零件不再翻倍。隔板等按布局决定的用量需要手动填写,不需要的填 0,填齐后才能导出。
  • 选装如何计入:「使用此方案」更新当前配置,之后需点击「加入打印清单」。浏览配件不会自动加入,已保存方案也不会随当前选择被改写。
  • 五金的范围:抽屉和收纳盒的五金随方案套数累计;改造件的五金按轮组、支脚等单独展示参考。原说明未明确的安装用量标为待核对,并保留在对应方案和 CSV 提示中。
  • 说明书版本:文件名不需要完全一致。工作台按文件名中的编号(01–05)、中英标题关键词和语言标记识别版本,兼容大小写、空格/下划线、(1)/副本 等差异,以及中文版、英文版和中英对照版并存的情况。显示顺序为当前语言 → 中英对照版 → 另一语言 → 其他语言,并在界面上标注实际显示的版本。只有当前语言的官方文件名才沿用页码;对照版、改名版和翻译版从第 1 页打开。
  • 保存与恢复:浏览器存储可用时,语言、配置和清单保存在当前浏览器。支持目录访问的浏览器可记住文件夹,必要时点击「重新连接」授权;不支持时需重新选择。资源更新后点击「重新扫描」,主动断开会清除目录记忆。
  • 数据边界:不同浏览器、打开方式或端口使用不同的浏览器存储;清除浏览器数据可能丢失清单。建议导出 CSV 留存,目前不支持 CSV 导入。「保存副本」不会覆盖原文件。
浏览器、端口与文件问题
  • 已验证桌面 Chrome;其他浏览器尚未完成同等验证。3D 预览需要 WebGL 2,尺寸按毫米解释。
  • PDF 无法内嵌显示时,可以新窗口打开或下载。
  • 一次选择一份资源包。缺失或重名冲突的文件会显示提示;请保留原包结构,说明书建议保留编号和语言标记,便于识别不同版本。
  • 端口被占用时,使用 --port 其他端口。旧端口下的清单不会自动迁移,可用 --port 原端口 回到原地址查看或导出。
  • 更新工作台代码后刷新页面;如果旧脚本仍在运行,先关闭旧服务再重新启动。

自动分盘 3MF

连接 Vault 文件夹后,在打印清单的单个方案中点击「自动分盘 3MF」。工作台按本方案的模块数量导出全部零件实例,并自动分配到多个打印盘,保存在同一个 3MF 项目中。在 Bambu Studio 中选择「打开项目」,不要仅导入几何模型,否则可能丢失分盘信息。

  • 按 P1S 的 256 × 256 mm 平台排布,避开左前角 18 × 28 mm 切刀禁区;保留至少 5 mm 边距和 6 mm 零件间距。
  • 使用矩形包围盒排布,优先尝试 0° / 90°,单件放不下时尝试斜向排布;不改变原始 STL 的 Z 轴打印朝向、比例和坐标精度,不保证盘数最少。
  • 默认高度按官方切片预设的 250 mm 检查。单件放不下时显示文件名和尺寸,不会缩小模型或静默漏件。
  • 这是排盘项目,配置名称以 Vault … layout 标识,不提供校准后的打印参数。打开后请重新选择实际的 P1S 打印机/喷嘴、工艺和耗材预设,并检查支撑、裙边和擦料塔;它们额外占用的区域不包含在模型包围盒中,必要时在切片软件内重新排布。
  • 隔板份数须填齐,不需要的填 0;缺失文件会阻止导出。五金不包含在模型中。
  • 每个项目最多 36 盘、1 万个实例;逐个读取和压缩 STL,不对整套方案的三角面总数设上限。单个 STL 不超过 128 MiB / 1200 万个三角面。超限时减少模块数量分批导出,或分别处理 STL。

验证:真实 S3 抽屉导出为 2 盘 / 18 个实例,经本机 Bambu Studio 02.08.02.61 CLI 导入再导出,分盘和份数保持一致。没有发送打印任务。

开发与测试

项目无需构建即可运行。3D 预览使用 Three.js 和 Web Worker;测试需要支持全局 File、Blob、fetch 的 Node.js,以及 Python 3。

在仓库根目录运行:

node --test tests/*.test.cjs
python3 -m unittest discover -s tests -p 'test_*.py'

安装 agent-browser 后,可运行浏览器回归(使用隔离的临时浏览器配置):

node tests/assembly-readiness.browser.cjs /path/to/agent-browser

其他场景见 tests/:模型搜索、配置引导、配件、说明书、清单编辑和文件夹恢复。真实资源校验自动查找当前目录或上一级,也可设置 VAULT_RESOURCE_ROOT;未提供资源包时跳过对应校验。

修改 assets/stl-worker.js 后,按 预览引擎构建脚本 中的说明重新打包。反馈问题时,请附上浏览器、打开方式、配置规格和复现步骤。

来源与许可

本项目与 USSA Design 无隶属关系。VAULT 模型、说明书及产品图片来源于 USSA Design,原始 STL 和 PDF 不随仓库分发,截图中的原始设计内容归其权利人所有。

第三方许可:Three.js · Geist。项目代码暂未提供独立许可证。

fflate 0.8.2 (MIT)

分盘规则参考:P1S 官方规格 · Bambu Studio 多盘实现 · 3MF 读写实现。

About

面向 USSA VAULT 模块化收纳系统的非官方组装工作台。

Resources

Stars

40 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages