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