我的物品

要解决什么问题

家里、工位、冰箱里的东西越积越多，保质期、保修期和「到底花了多少钱」往往散落在备忘录或购物 App 里。换手机或重装系统后，本地清单更容易丢。这个技能把个人物品当成可查询、可统计的小型数据库，用对话完成录入和检索，数据落在用户家目录，与技能安装目录分离。

技能如何工作

核心是 item_cli.py 与自然语言意图映射：你说「买了个 XX」「列出护肤类」「哪些快过期了」，代理会落到 add、list --tag、expiring 等命令。

• 增删改查：名称、品牌、数量、位置、价格、标签、状态（active / consumed / discarded）等字段；列表会带总数与核心字段展示。
• 成本与到期：按购入天数算日均成本；有 expiry_date 时用进度条区分即将到期与已过期。
• 套装与子物品：主物品下可挂子物品（如替换装），各自独立管理。
• 历史：价格、数量、开封日、状态变更会写入历史，可用 item history 查看。
• 导出与报告：CSV / JSON / HTML；item report 生成可打印 HTML，浏览器 Ctrl+P 可存 PDF。
• 备份恢复：备份为纯 JSON，支持合并或完整恢复；item info 时应结合 item-management-cloud-config.json 说明云备份是否已配置。

数据路径因系统而异（如 Linux 下 ~/.local/share/item-management/），也可用 OPENCLAW_WORKSPACE 或 XDG_DATA_HOME 自定义。

适用边界与注意点

这是本地优先的个人台账，不是多人协作库存系统，也不替代专业资产管理。删除操作建议先确认；重要变更后应备份 JSON 并自行同步到网盘或邮箱。云备份依赖工作区下的配置文件，未配置时需在对话里明确「未配置」状态，避免用户误以为已上云。