名称： device-assistant
版本： 1.0.0
描述： "个人设备与家电管理器，支持错误代码查询和故障排除。可追踪您所有的设备（家电、电子产品、软件），记录型号、手册和保修信息。当设备出现故障时，只需告知错误代码即可获得即时解决方案。使用场景：设备报错、需要手册、保修查询、添加新设备、维护提醒。触发词：/device, /geräte, 'mein Geschirrspüler', 'Fehler E24', 'Fehlermeldung', device problems, appliance issues。"
作者： clawdbot
许可证： MIT
元数据：
clawdbot:
emoji: "🔧"
triggers: ["/device", "/geräte"]
requires:
bins: ["jq", "curl"]
tags: ["devices", "appliances", "troubleshooting", "maintenance", "home", "warranty"]

设备助手 🔧

个人设备管理器，提供错误代码查询、故障排除和维护追踪功能。

功能特性

• 设备注册表：记录所有设备的型号、序列号、购买信息
• 错误代码查询：即时获取错误代码解释
• 故障排除：提供分步解决方案
• 手册链接：快速访问设备文档
• 保修追踪：掌握保修到期时间
• 维护提醒：滤芯更换、系统更新等提醒

命令列表

自然语言理解

本技能支持自然语言查询：

• "我的洗碗机显示 E24"
• "洗衣机发出奇怪的声音"
• "Thermomix 的说明书在哪里？"
• "电视的保修什么时候到期？"

设备类别

处理器命令

handler.sh status $WORKSPACE                     # 概览
handler.sh list [category] $WORKSPACE            # 列出设备
handler.sh add <json> $WORKSPACE                 # 添加设备
handler.sh info <device-id> $WORKSPACE           # 设备详情
handler.sh error <device-id> <code> $WORKSPACE   # 错误代码查询
handler.sh troubleshoot <device-id> <problem> $WS # 获取帮助
handler.sh manual <device-id> $WORKSPACE         # 手册链接
handler.sh warranty $WORKSPACE                   # 保修概览
handler.sh maintenance $WORKSPACE                # 即将进行的维护
handler.sh update <device-id> <json> $WORKSPACE  # 更新设备信息
handler.sh remove <device-id> $WORKSPACE         # 移除设备
handler.sh search <query> $WORKSPACE             # 搜索设备
handler.sh log <device-id> <note> $WORKSPACE     # 添加维护日志

数据结构

设备条目

{
  "id": "dishwasher-1",
  "name": "Geschirrspüler",
  "nickname": "Spüli",
  "category": "kitchen",
  "manufacturer": "Siemens",
  "model": "SN658X06TE",
  "serialNumber": "ABC123456",
  "purchaseDate": "2022-03-15",
  "purchasePrice": 899,
  "warranty": {
    "expires": "2025-03-15",
    "type": "manufacturer",
    "notes": "3 Jahre Siemens"
  },
  "manualUrl": "https://...",
  "supportUrl": "https://...",
  "location": "Küche",
  "notes": "Salz alle 2 Monate nachfüllen",
  "maintenance": [
    {"task": "Filter reinigen", "interval": "monthly", "lastDone": "2026-01-01"}
  ],
  "errorHistory": [],
  "addedAt": "2024-01-01"
}

错误代码查询

本技能通过以下方式搜索错误代码：

1. 内置数据库：针对常见制造商
2. 网络搜索：针对特定型号 + 错误代码
3. 手动提取：如果存储了手册链接

常见错误代码模式

使用示例

用户：我有一台新的洗碗机

机器人：🔧 添加新设备：

     您有哪些信息？
     • 制造商？
     • 型号？
     • 序列号？（可选）
     • 购买日期？

用户：Siemens SN658X06TE，购买于 2022年3月15日

机器人：✅ 已保存！

     📦 洗碗机 (Siemens SN658X06TE)
     📅 购买日期：2022-03-15
     🛡️ 保修期：至 2025-03-15（已过期）
     📄 手册：[已找到链接]

     要起个昵称吗？（例如 "Spüli"）

用户：我的洗碗机显示 E24

机器人：🔧 Siemens SN658X06TE — 错误 E24

     ⚠️ 含义：排水问题
     水未能正常排出。

     🔨 解决方案：
     1. 关闭设备电源
     2. 检查并清洁底部滤网
     3. 检查排水管是否弯折
     4. 检查虹吸管连接
     5. 重新启动设备

     📄 详情：手册第 45 页

     [问题已解决] [获取更多帮助]

数据文件

存储在 $WORKSPACE/memory/device-assistant/ 目录下：

保修提醒

本技能可在保修到期前提醒您：

⚠️ 保修提醒：

以下设备的保修即将到期：
• 三星电视（还剩 30 天）
• 洗衣机（还剩 45 天）

提示：现在检查设备是否一切正常！

系统要求

• jq（JSON 处理）
• curl（网络查询）
• 互联网连接（用于错误代码搜索）