HomeBox项目CSV导入功能详解-优快云博客

HomeBox项目CSV导入功能详解

homebox Homebox is the inventory and organization system built for the Home User 项目地址: https://gitcode.com/gh_mirrors/ho/homebox

前言

HomeBox作为一个开源的家庭资产管理工具，提供了强大的CSV导入功能，帮助用户快速批量添加物品信息。本文将全面解析HomeBox的CSV导入机制，帮助用户高效管理个人资产。

CSV导入的优势

批量处理能力：相比手动添加，CSV导入可以一次性处理大量物品数据
数据标准化：通过预定义的字段格式，确保数据的一致性和准确性
灵活性强：支持自定义字段和多种数据类型
更新机制：通过引用标识可以更新现有物品而非重复创建

准备工作

文件格式选择

HomeBox支持两种分隔符格式：

CSV：使用逗号(,)作为分隔符
TSV：使用制表符(\t)作为分隔符

文件扩展名不影响格式识别，系统会根据实际分隔符自动判断。

核心字段详解

特殊字段

引用标识(HB.import_ref)

作用：用于识别和去重物品
格式要求：最大100字符的字符串
最佳实践：建议为每个物品设置唯一标识符，便于后续更新管理

位置信息(HB.location)

特点：支持层级结构，使用"/"作为分隔符
示例："家/书房/书桌"会创建三级位置结构

标签系统(HB.labels)

格式：多个标签用分号(;)分隔
特点：自动去重，已存在的标签会被复用

自定义字段(HB.field.{field_name})

命名规则：必须以"HB.field."开头
灵活性：支持创建任意数量的自定义字段

标准字段说明

| 字段名 | 数据类型 | 说明 | 注意事项 | |--------|----------|------|----------| | HB.quantity | 整数 | 物品数量 | 必须大于0 | | HB.name | 字符串 | 物品名称 | 最大255字符 | | HB.asset_id | 资产ID | 资产编号 | 格式000-000 | | HB.description | 字符串 | 物品描述 | 最大255字符 | | HB.insured | 布尔值 | 是否投保 | 接受true/false/yes/no/1/0 | | HB.serial_number | 字符串 | 序列号 | | | HB.model_number | 字符串 | 型号 | | | HB.manufacturer | 字符串 | 制造商 | | | HB.notes | 字符串 | 备注 | 最大1000字符 | | HB.purchase_from | 字符串 | 购买地点 | | | HB.purchase_price | 浮点数 | 购买价格 | | | HB.purchase_time | 日期 | 购买日期 | YYYY-MM-DD格式 | | HB.lifetime_warranty | 布尔值 | 是否终身保修 | | | HB.warranty_expires | 日期 | 保修到期日 | | | HB.warranty_details | 字符串 | 保修详情 | | | HB.sold_to | 字符串 | 售出对象 | | | HB.sold_time | 日期 | 售出日期 | | | HB.sold_price | 浮点数 | 售出价格 | | | HB.sold_notes | 字符串 | 售出备注 | 最大1000字符 |