📦 AllOurThings

AllOurThings 家庭与个人物品库存管理，依托本地或云端同步保险库（iCloud Drive、Dropbox、OneDrive 或任意文件夹）。

何时使用 ✅ 当用户询问以下内容时使用本技能：

• 个人财物、家庭物品
• 家电、电子设备、工具、家具、车辆、收藏品
• 保修——“我的电视还在保修期内吗？”、“哪些保修快到期？”
• 购买记录——“我什么时候买的洗衣机？”、“花了多少钱？”
• 寻找物品——“我把电钻放哪了？”、“我有标签机吗？”
• 添加或编目新物品
• 搜索库存——“列出所有 Bosch 电器”
• 附加或查看照片、收据、说明书、保修文件

何时不使用 ❌ 不使用本技能的情况：

• 用户询问一般产品信息或评测（无库存上下文）
• 问题涉及购物或购买新品（除非先检查现有库存）
• 未配置保险库——提示用户设置 ALLOURTHINGS_DATA_DIR

设置 用户必须将 ALLOURTHINGS_DATA_DIR 设为 AllOurThings 保险库文件夹路径。

示例——iCloud Drive 保险库 export ALLOURTHINGS_DATA_DIR="$HOME/Library/Mobile Documents/com~apple~CloudDocs/Documents/allourthings-vault"

示例——Dropbox export ALLOURTHINGS_DATA_DIR="$HOME/Dropbox/AllOurThings"

示例——本地文件夹 export ALLOURTHINGS_DATA_DIR="$HOME/Documents/AllOurThings"

添加到 shell 配置文件（~/.zshrc、~/.bashrc）以永久生效。 保险库为纯 JSON 文件文件夹——可随意创建，或指向现有文件夹立即开始编目。

可用工具 list_items：列出所有物品，可按类别、子类或标签过滤 search_items：全文搜索所有物品字段 get_item：按 ID 或名称获取单个物品 add_item：向保险库添加新物品 update_item：更新现有物品字段 delete_item：删除物品及其附件 get_item_fields：列出保险库中使用的所有字段名 add_attachment：附加照片、收据、说明书或保修文件 get_attachment：获取附件原始字节 attach_from_url：从 URL 下载文件并附加到物品 delete_attachment：从物品移除附件

示例交互 “我有哪些电子产品？” → list_items 类别：“Electronics” “我的洗碗机还在保修期内吗？” → search_items “dishwasher”，查看 warranty_expires “我刚花 £499 买了 Dyson V15 吸尘器” → add_item 填写名称、品牌、购买价格、日期 “显示我去年在 Amazon 买的所有东西” → search_items “Amazon” 或按零售商过滤 list_items “给 MacBook 附加收据” → add_attachment 类型 receipt

CLI AllOurThings 还提供独立 CLI（@allourthings/cli），用于 AI 会话外的脚本与自动化： npx @allourthings/cli list npx @allourthings/cli search "bosch" npx @allourthings/cli add --name "Dyson V15" --category "Appliances"

设置 ALLOURTHINGS_DATA_DIR 或使用 --data-dir 指向保险库。

备注

• 数据以纯 JSON 文件存储——完全可移植，无锁定
• 兼容任何暴露本地文件夹路径的同步服务（iCloud Drive、Dropbox、OneDrive 等）
• MCP 服务器与 CLI 使用相同保险库格式——可互换