局域网资源分发助手

解决的问题

当多台设备处于同一局域网时，常见需求并不是“上传到云端再下载”，而是把当前目录或单个文件临时交给另一台电脑/手机访问。手工配置端口、防火墙、IP 往往打断这个流程；而跨网或依赖公网服务又引入不必要的网络路径。这个技能把任务收敛为：在本地网络内快速暴露一个只面向当前网络的共享服务，并用二维码完成发现。

工作方式与边界

技能启动后会提供三种模式：主站模式用于共享目录并给出访问链接；单文件模式用于指定 FILE 的直接分发；从站模式用于发现并连接已有主站。默认端口为 8989，默认共享目录为 ./qclaw_shared，也可用 --dir 指定桌面或项目目录。首次运行会自动检查 flask、qrcode、pillow、werkzeug 等依赖；若 GUI 环境不可用，可改用 --no-gui 并手动访问控制台链接。使用时应确认收发设备在同一局域网，且防火墙未阻止端口；若二维码无法显示，优先检查桌面环境；若端口冲突，更换端口即可。它适合临时文件交接、本地演示和离网调试，不适合替代长期文件服务器、权限管理或加密传输方案。