Filament Vault

filament-vault 是本地 3D 打印耗材库存管理工具：用 python3 脚本添加或更新线材卷，记录消耗克数与余量，按材料、颜色、品牌筛选并提示低库存，生成总重量、总价值、按材料分布和月度支出报表，数据存于本地 JSON 文件。

newageinvestments25-byte

热度 43.55

最近更新 2026-05-11 17:38:19

分类：生活依赖：代码执行 / 读写文件应用场景：报告撰写 / 个人理财 / 数据处理

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add filament-vault

Metadata

name: filament-vault
description: Track 3D printing filament inventory locally. Add spools, log usage, check stock levels, and generate spending reports. Use when: filament, spool, 3d print inventory, filament stock, what filament do I have, printing materials, filament vault, filament inventory, low stock filament.

filament-vault

Local filament inventory tracker. All data stored in JSON at ~/.openclaw/workspace/filament-vault/inventory.json.

Scripts

All scripts live in scripts/. Run with python3 scripts/<script>.py [args].

Add a Spool

python3 scripts/add_spool.py --brand "Bambu" --material PLA --color "Matte Black" --weight 1000 --cost 19.99 --location "Shelf A"

Options: --brand, --material (PLA/PETG/ABS/TPU/Nylon/ASA/other), --color, --weight (grams, default 1000), --cost (USD), --location, --notes

Update / Use a Spool

python3 scripts/update_spool.py --search "matte black" --used 150
python3 scripts/update_spool.py --id <uuid> --finished --notes "Ran out mid-print"

Options: --id (UUID), --search (partial match), --used (grams consumed), --finished (mark empty), --notes

List Inventory

python3 scripts/inventory.py
python3 scripts/inventory.py --material PLA --low-stock
python3 scripts/inventory.py --json

Filters: --material, --color, --brand, --low-stock (under threshold, default 100g), --threshold <g>, --json

Generate Report

python3 scripts/report.py
python3 scripts/report.py --threshold 200

Shows: total spools, total weight, total value, by-material breakdown, low-stock alerts, monthly spending.

Search

python3 scripts/search.py "bambu"
python3 scripts/search.py "black petg" --json

Fuzzy search across all fields (brand, color, material, location, notes).

References

See references/materials.md for filament material properties and guidance.