openwebf-app-devserver-network

为实际设备上的 WebF 应用(Vite/Webpack)调试开发服务器可达性和 HMR:LAN IP 与 localhost,0.0.0.0/--host 绑定,防火墙/端口,以及 websocket/HMR (ws://) 问题。当用户提及 HMR、websocket、ws://、--host、0.0.0.0、LAN IP、防火墙,或可以加载 HTML 但不能加载资源/HMR 的设备时使用。

📖 中文导读:为实际设备上的 WebF 应用(Vite/Webpack)调试开发服务器可达性和 HMR:LAN IP 与 localhost,0.0.0.0/--host 绑定,防火墙/端口,以及 websocket/HMR (ws://) 问题。当用户提及 HMR、websocket、ws://、--host、0.0.0.0、LAN IP、防火墙,或可以加载 HTML 但不能加载资源/HMR 的设备时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: openwebf-app-devserver-network description: Troubleshoot dev server reachability and HMR for WebF apps on real devices (Vite/Webpack): LAN IP vs localhost, 0.0.0.0/--host binding, firewall/ports, and websocket/HMR (ws://) issues. Use when the user mentions HMR, websocket, ws://, --host, 0.0.0.0, LAN IP, firewall, or a device that can load HTML but not assets/HMR. allowed-tools: Read, Grep, Glob, Bash, Edit, Write, mcp__openwebf__docs_search, mcp__openwebf__docs_get_section, mcp__openwebf__docs_related

OpenWebF App: Dev Server & Network Troubleshooting

Instructions

  1. Collect the minimum facts: platform (desktop/iOS/Android), dev server URL, framework (Vite/Webpack), and exact error/symptom.
  2. Prioritize network reachability before app-level debugging:
    • LAN IP vs localhost
    • binding to interfaces (e.g. --host)
    • firewall/port rules
  3. If hot reload (HMR) is the issue, confirm the dev server is configured for network access and HMR websocket is reachable.
  4. Use MCP docs for authoritative steps and known pitfalls; keep changes minimal.

More: