card-wifi-setup
Walk a user through provisioning Wi-Fi on their AI Desk Card device. After provisioning, device joins the user's home Wi-Fi, advertises via mDNS, and the daemon HTTP-pushes frames in ~0.2 s instead of USB's 32 s. Use whenever the user says "配 wifi" / "card 上 wifi" / "我想用 无线" / "怎么连 Wi-Fi" / when card-onboard's branch E recommends Wi-Fi.
Profile →npx skills add op7418/ai-desk-card --skill card-wifi-setup --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# card-wifi-setup — 把设备搬上 Wi-Fi 把 SSID + 密码喂到设备 NVS，设备自动连，daemon 通过 mDNS 发现 → 后续推帧 0.2 秒到位。 ## 先决条件 - 设备能跟 daemon 通信（USB serial OR BLE 已 pair）。如果两条路都没有， 先去 `/card-onboard`。 - daemon 在跑（`/card-status` 确认） ## 流程 ### 1) 跟用户要 SSID + 密码 **关键安全提示**先说： > 密码会通过本地 daemon 一次性写到设备 NVS。**不会**写进 daemon 日志、 > git 仓库、或者上传到任何远程服务。 然后问： > 告诉我你家 Wi-Fi 的名称（SSID）和密码。 **注意**：SSID 就是 Wi-Fi 名称 — 用户在手机 Wi-Fi 列表里看到的那个字符串。 **不是** MAC 地址、IP 地址、或者其他什么。如果用户给了一串看起来像 MAC （`xx:xx:xx:xx:xx:xx`），礼貌地纠正： > 那看起来像 MAC 地址。我要的是 Wi-Fi 名称 — 手机里看到的那串字。 ### 2) 推送 收到 SSID + password 后： ```bash $CLAUDE_PLUGIN_ROOT/scripts/wifi_setup.sh "<SSID>" "<password>" ``` 注意 SSID 一定要加双引号（可能含空格 / 中文 / 特殊字符）。脚本里走 daemon 的 `/provision-wifi` HTTP endpoint，daemon 转发为 `cmd:wifi_set` 给设备。 ### 3) 等 15-20 秒看结果 跑 probe： ```bash bash $CLAUDE_PLUGIN_ROOT/skills/card-onboard/scripts/probe.sh --quick ``` 期望 `mdns_peer != null`，里面有 IP。 或者直接看 daemon 日志： ```bash tail -20 "${TMPDIR:-/tmp}/ai_desk_card_daemon.log" | grep -i wifi ``` 成功的话有 `[dev<] {..."wifi_connected":true,"wifi_ip":"192.168.x.y",...}` 行。 ### 4) 重启 daemon 切到 Wi-Fi transport ```bash /card-stop && /card-start ``` 新 daemon 启动时会 mDNS 扫到 Wi-Fi peer，自动选 Wi-Fi。看到 `[transport] found Wi-Fi peer X.X.
- 先决条件
- 流程
- 1) 跟用户要 SSID + 密码
- 2) 推送
- 3) 等 15-20 秒看结果
- 4) 重启 daemon 切到 Wi-Fi transport
- 失败诊断
- 架构提示
- 不要做的事
bash $CLAUDE_PLUGIN_ROOT/skills/card-onboard/scripts/probe.sh --quick
tail -20 "${TMPDIR:-/tmp}/ai_desk_card_daemon.log" | grep -i wifiWhat does the card-wifi-setup skill do?
Walk a user through provisioning Wi-Fi on their AI Desk Card device. After provisioning, device joins the user's home Wi-Fi, advertises via mDNS, and the daemon HTTP-pushes frames in ~0.2 s instead of USB's 32 s. Use whenever the user says "配 wifi" / "card 上 wifi" / "我想用 无线" / "怎么连 Wi-Fi" / when card-onboard's branch E recommends Wi-Fi.
How do I install it?
Run `npx skills add op7418/ai-desk-card --skill card-wifi-setup --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From op7418/ai-desk-card, a repository with 136 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.