Homelab 资产技能

管理本地 JSON 格式的家庭实验室硬件清单。所有数据存储在 ~/.openclaw/workspace/homelab-assets/inventory.json 中。

脚本

所有脚本位于 scripts/ 目录下。使用 python3 scripts/<脚本名>.py [参数] 运行。在任何脚本后添加 --help 可查看完整用法。

add_asset.py — 添加硬件资产

python3 scripts/add_asset.py \
--name 树莓派 4 \
--type server \
--brand 树莓派基金会 \
--model Pi 4 Model B 8GB \
--purchase-date 2023-06-15 \
--purchase-price 85.00 \
--warranty-months 12 \
--power-watts 8 \
--location 机架层板 2 \
--serial ABC123 \
--notes 运行 Home Assistant

必填项：--name、--type。其他均为可选。UUID 自动生成。
类型：server（服务器）、switch（交换机）、router（路由器）、ups（UPS）、drive（硬盘）、cable（线缆）、accessory（配件）、other（其他）

update_asset.py — 更新现有资产

python3 scripts/update_asset.py --id --status retired --location 储物箱 A
python3 scripts/update_asset.py --search Pi 4 --notes 改用作 DNS 服务器 --power-watts 6

通过 --id（精确 UUID）或 --search（模糊名称匹配）定位目标。可更新字段：--status、--location、--notes、--power-watts。
状态：active（在用）、retired（退役）、sold（已售）、rma（返修）

inventory.py — 列出资产

python3 scripts/inventory.py
python3 scripts/inventory.py --type server --status active
python3 scripts/inventory.py --location 机架 --warranty-expiring 90
python3 scripts/inventory.py --output json

筛选条件：--type、--status、--location（子字符串匹配）、--warranty-expiring <天数>。输出格式：表格（默认）或 --output json。

report.py — 生成完整资产报告

python3 scripts/report.py
python3 scripts/report.py --kwh-rate 0.14 --output report.md

生成 Markdown 格式报告，包含：资产总数、总投资额、预估当前价值（按5年直线折旧）、总功耗、月度电费估算、保修提醒（90天内到期）、按类型统计资产、按位置统计资产。可配置 --kwh-rate（默认值：0.12）。

search.py — 跨所有字段模糊搜索

python3 scripts/search.py raspberry
python3 scripts/search.py rack shelf --output json

搜索范围包括名称、品牌、型号、位置、备注、序列号、类型。对所有文本字段进行不区分大小写的子字符串匹配。

数据位置

默认路径：~/.openclaw/workspace/homelab-assets/inventory.json
通过环境变量覆盖：HOMELABASSETSPATH=/path/to/inventory.json

参考文档

常见家庭实验室设备功耗估算请参见 references/power-estimates.md。
示例资产结构请参见 assets/inventory.example.json。