shield_lock
JinDaGe
← Back to skills
extension
Category: OtherAPI key requirement unconfirmed

家用电子设备维修指导

家用电子设备维修指导技能。当用户要维修、更换、复活或升级电子设备（笔记本无线网卡、Switch 手柄摇杆、iPhone/iPad 电池与尾排、有线耳机、CD 随身听、计算器、鼠标、风扇遥控器、硬盘数据恢复、六类网线、电脑图标等）时，先识别设备与故障类型，匹配 references/ 下的内置手册（含 77 张实拍图），生成可预览的图文指导页并补充 1–3 个网络视频/图文参考，再逐步指导；若诉求超出内置手册范围，则联网搜索并明确标注「网络搜索手册，请谨慎操作」。This skill should be used when the user mentions repairing, replacing, upgrading, or troubleshooting a consumer electronic device and expects step-by-step guidance, preferably with photos or videos.

personAuthor: user_c01c51cehubcommunity
downloadDownload package

家用电子设备维修指导

目的

把抽象的"帮我修一下 X"转化为「识别设备 → 匹配手册 → 图文指导页 + 网络视频/图片补充」的确定流程。内置手册来自社区作者的实修记录（文本 + 实拍图），覆盖 13 类常见家电/数码设备，并随技能打包 77 张实拍图。命中内置手册时，除文字步骤外还输出可预览的图文指导页并补 1–3 个网络视频/图文参考；未命中时联网搜索，并强制标注风险警示。

何时使用

  • 用户明确要修/换/升级某件电子设备（如"iPhone 6S 充不进电""Switch 摇杆漂移""笔记本想升 wifi6"）。
  • 用户描述设备故障症状，希望得到可操作排查/维修步骤。
  • 触发词示例：维修、更换、复活、升级、数据恢复、故障定位、怎么做网线、电池鼓包、充电口坏了。

使用流程

第 1 步：识别维修对象（区分要修什么）

从用户消息中提取三类信息，不确定时再追问：

  1. 设备类别：笔记本 / iPhone / iPad / Switch / 鼠标 / 风扇遥控器 / 计算器 / CD 随身听 / 硬盘 / 网线 / 电脑图标。
  2. 具体型号：iPhone 6S、iPhone XS Max、iPad mini 4、ThinkPad T450 等。型号决定匹配哪本手册。
  3. 故障类型：电池 / 摇杆漂移 / 尾排(充电口) / 耳机 / 数据恢复 / 网卡升级 / 故障定位 / 制作。

若关键信息缺失（如只说"iPhone 电池"），用 AskUserQuestion 向用户确认型号与故障现象，避免给错手册。确认一次即可，不要连环提问。

第 2 步：匹配并加载内置手册

用下表将（设备 + 型号 + 故障）映射到 references/ 下的手册文件。

2A 读手册：用 Read 读取该手册全文（含 images/ 图片行），把手册里的安全提示转达用户（见「安全红线」）。

2B 生成图文指导页（必做，不要只发文字） 手册实拍图已随技能打包在 references/images/，但必须转成用户能看的图文页，否则用户只拿到文字：

python3 ~/.workbuddy/skills/home-electronics-repair/scripts/build_guide.py <手册编号或路径> -o /tmp/<设备>-图文指导.html
  • 脚本把每段说明按「步骤 N」编号，对应实拍图 base64 内嵌成单文件 HTML（离线可开、图片必显示），并自动附「安全红线」区块。
  • 生成后用 present_files 展示该 HTML（自动在预览面板打开），用户即可图文对照动手。
  • 再用 Read 打开 1–2 张关键步骤图（拆解位置 / 螺丝位 / 接头形态）确认真实画面，在对话里口头点出图中要点——多模态看图比转述文字可靠。

2C 联网补视频 / 图片（手册只有静态图时价值最高）

  • 用 WebSearch 补 1–3 个靠谱的视频或图文教程。来源优先级：
    1. iFixit（zh.ifixit.com 有中文分步图文；英文站 ifixit.com 图最全）
    2. 高播放量拆机视频（JerryRigEverything、B 站高赞拆机 UP）
    3. 其它垂直维修站（fixshop、lmlrepair 等）
  • 把结果追加进指导页（可重复传参），HTML 会自动生成「视频参考（网络来源，需谨慎）」区块：
python3 .../scripts/build_guide.py 02 --video "iFixit 中文图文步骤::https://zh.ifixit.com/Guide/..." \
                                     --video "JerryRigEverything 4 分钟拆机::https://..."
  • 对话中给出这些链接时必须标注「网络来源、非本技能内置、未经人工验证」。
  • 若本技能是以纯文字版安装的（SkillHub 发布包不能含图），references/images/ 缺失 → 跳过 2B 内嵌图，必须靠 2C 联网找图文/视频补足，并在指导页顶部注明图片来自网络。

| 命中关键词（命中任意一组即匹配） | 设备 | 故障 | 手册文件 | |---|---|---|---| | 笔记本 + 无线网卡 / 网卡 / wifi / 5G频段 / wifi6 / AX210 / AC9260 / ThinkPad | 笔记本 | 无线网卡升级 | references/00-升级笔记本无线网卡.md | | switch / joycon / 手柄 / 摇杆 / 漂移 / 任天堂 | Switch | 手柄摇杆漂移更换 | references/01-维修switch手柄摇杆.md | | iphone 6s + 尾排 / 充电口 / 排线 / 充不进电 / 电池 / 不开机 | iPhone 6S | 尾排(充电口)更换（兼电池） | references/02-更换iPhone6S尾排.md | | iphone 6s + 耳机 / 转接头 | iPhone 6S | 有线耳机复活 | references/03-复活iPhone6S有线耳机.md | | cd / 随身听 / 口香糖电池 / 松下 + 电池 / 接触点 / 除锈 | CD 随身听 | 口香糖电池 / 接触点除锈 | references/04-更换CD随身听口香糖电池.md | | 计算器 / 卡西欧 / casio + 不开机 / 断路 / 焊接 | 计算器 | 断路焊接维修 | references/05-维修计算器.md | | iphone xsmax / xs max + 电池 / 绿屏 | iPhone XS Max | 电池更换 | references/06-更换iPhoneXSmax电池.md | | 磁盘 / 硬盘 / 数据恢复 / 恢复数据 / raw 格式 | 硬盘 | 数据恢复 | references/07-恢复磁盘数据.md | | 图标 / ico / gimp + 电脑图标 | 电脑 | 制作图标 | references/08-制作电脑图标.md | | 网线 / 六类 / 水晶头 / 网线制作 | 网线 | 制作六类网线 | references/09-制作六类网线.md | | ipad mini4 / mini 4 + 电池 / 不开机 | iPad mini 4 | 电池更换 | references/10-更换iPadmini4电池.md | | 鼠标 + 故障 / 中断 / 断连 / 不连 | 鼠标 | 故障定位 | references/11-定位鼠标故障.md | | 风扇 + 遥控器 / 遥控器坏了 / 遥控失灵 | 风扇遥控器 | 故障定位 | references/12-定位风扇遥控器故障.md |

匹配优先级与冲突裁决（避免误匹配）：

  1. 型号 + 故障同时命中 → 最优先（最精确）。
  2. 仅设备型号命中、且故障属于该设备手册覆盖范围 → 命中。
  3. 设备关键词命中，但所述故障不在该设备任何手册覆盖范围内（如"iPhone 6S 屏幕碎了""iPad Air 电池"）→ 不强行匹配，转第 3 步联网搜索，或追问故障细节。
  4. 多行同时命中 → 以用户主诉的核心设备/故障为准；无法判断时问一句，不要猜。例："ThinkPad 鼠标"若主诉是鼠标故障走 11，主诉是网卡走 00。

歧义处理：iPhone 电池未带型号时，6S 走 02（尾排兼电池），XS Max 走 06；仅说"iPhone 电池"则先问型号。iPad 仅 mini 4、iPhone 仅 6S / XS Max 有内置手册，其它型号直接转第 3 步。

交互节奏（命中手册后如何指导）：

  • 开场先给三样东西：① 工具/配件清单（如 joycon 型号、尾排、电池型号）② 图文指导页（present_files 展示）③ 1–3 个网络视频/图文参考（标注网络来源）。之后才进入逐步讲解。
  • 分阶段输出：每步先讲"做什么 + 为什么 + 风险点"，不要一次性倾倒全文。
  • 在不可逆/高危步骤前（撕拉胶、撬电池、焊点、断开排线、通电测试）暂停，等用户确认再继续。
  • 手册未覆盖的子问题，诚实说明并转第 3 步，不编造步骤。

第 3 步：未命中 → 联网搜索（带强制警示）

若用户诉求不在上表任何一项：

  1. 用 WebSearch 检索该设备的维修方案，优先找带图/带视频的中文教程（zh.ifixit.com 中文图文、B 站高赞拆机视频、维修站分步图），综合多源提炼关键步骤。
  2. 输出开头必须加醒目警示，原文如下：

    ⚠️ 此维修手册来自网络搜索，非本技能内置官方手册，未经人工验证，请谨慎操作、自担风险。

  3. 给出检索到的步骤 + 参考链接（图文/视频），并提示用户：交叉验证多源、注意电池/静电/高温安全、复杂或高价设备建议送修。
  4. 如检索到的是结构化图文教程，可用 scripts/build_guide.py 把提炼后的步骤同样生成为图文指导页再展示（图片用网络链接或本地下载后内嵌）。
  5. 优质内容回流（自进化）：若本次搜索得到的维修方案完整、准确、可操作，且用户按此成功修复（或明确认可），则把它沉淀为技能内置手册，使下次同类诉求直接命中、不再走网络搜索：
    • 新建文件 references/NN-设备-故障.md（NN 取当前最大序号 +1，如 13-...），用纯文本写下「故障现象 → 所需工具 → 分步操作 → 注意事项」，并保留来源链接与作者署名，删除无关闲聊。
    • 在本文件匹配表中新增一行，命中关键词指向该新文件。
    • 写入前须先经用户确认（避免擅自改动技能）；确认后执行写入，并视需要重新打包（见下文「打包」）。
    • 新手册顶部统一加一行来源标注：> 来源：网络搜索（YYYY-MM-DD），原作者/链接：<url>，便于追溯与后续复核。

安全红线（指导任何维修前先传达）

  • 电池：拆前先放电（如 06 经验：把电量放光再拆，防刺穿/加热起火）；勿刺穿、弯折、靠近火源。
  • 焊接/烙铁：防烫伤、保持通风、远离易燃物。
  • 静电：拆精密设备前先释放静电（触摸接地金属）。
  • 数据恢复（07）：操作前不要向故障盘写入任何数据，优先做磁盘镜像再恢复；物理损坏建议专业机构。

反馈与迭代

  • 用户按手册操作后若发现步骤不准或缺失，记录具体偏差，更新对应 references/ 手册或本匹配表，使下次更准。
  • 经「第 3 步自进化」新增的 references/NN-*.md，写入后建议重新打包以分发：python3 /Applications/WorkBuddy.app/Contents/Resources/app.asar.unpacked/resources/plugins/workbuddy-builtin/skills/skill-creator/scripts/package_skill.py ~/.workbuddy/skills/home-electronics-repair <输出目录>。
  • 新增网络来源手册时，定期回看其顶部来源标注，若原链接失效或内容过时则复核更新。

发布到 SkillHub（重要约束）

  • 本技能只能本地保留图片；SkillHub 发布接口不接受任何图片文件（jpg/jpeg/png/webp/svg 均报 400 不允许的文件类型），且发布包**≤ 10MB**。
  • 发布前需生成纯文字版：复制 SKILL.md + references/*.md + scripts/，删除 references/images/，并去掉手册中的图片行（![...](images/...)）。
  • 纯文字版也必须保留 scripts/build_guide.py：安装者无内置图时，脚本仍可用于把「联网抓到的图 + 步骤」生成为图文指导页（把图片下载到本地后内嵌）。
  • 纯文字版的实际效果 = 文字步骤 + 必须走 2C 联网找图/视频；这一点要在技能说明里对安装者讲清。
  • 发布命令：skillhub publish <纯文字版目录> --changelog "..."（需先在 SkillHub 网页端完成实名认证）。成功凭证为返回 skillId。
  • 前端字段：SKILL.md frontmatter 需含 name / slug / version / displayName / description / agent_created。