📡 局域网二维码文件共享技能

> 零配置 · 跨设备 · 生命周期同步 · 扫码即用

通过二维码实现局域网内快速文件共享，无需互联网、无需账号、无需手动配置IP。支持主站网关、单文件直传、从站自动发现三种工作模式。

🤖 Agent 执行指令

执行本技能后，代理必须：

1. 启动服务（如用户未指定目录，默认共享桌面）

# 共享桌面（推荐）
python local_network_server_skill.py --master --dir "%USERPROFILE%\Desktop"

# 共享自定义目录
python local_network_server_skill.py --master --dir "D:\资料"

2. 显示连接信息

• 主站模式：展示访问链接 + 告知二维码已弹出
• 从站模式：列出发现的主站列表

3. 确认服务状态

• 明确告知用户服务已启动
• 标注访问地址、端口、共享目录

4. 提供操作指引

• 手机端：扫码 → 浏览器打开 → 上传/下载
• 电脑端：浏览器访问链接
• 关闭服务：关闭窗口或按 Ctrl+C

5. 异常处理

• 端口冲突：提示更换 --port 参数
• 依赖缺失：脚本会自动尝试安装
• 访问失败：检查防火墙设置

🚀 快速开始

方式一：共享桌面文件夹

python local_network_server_skill.py --master --dir "%USERPROFILE%\Desktop"

方式二：共享指定文件夹

python local_network_server_skill.py --master --dir "D:\工作资料"

方式三：单文件直传

python local_network_server_skill.py --single "C:\Users\xxx\Documents\report.pdf"

方式四：从站发现（连接他人的共享）

python local_network_server_skill.py --slave

📋 命令行参数

🔧 依赖说明

自动安装：脚本首次运行时会自动检查并安装依赖（flask, qrcode, pillow, werkzeug）

手动安装（如自动失败）：

pip install flask qrcode[pil] pillow werkzeug

🐛 故障排查

问题：手机扫描二维码无法访问

• 确认手机和电脑在同一 WiFi 网络
• 检查防火墙是否阻止了 8989 端口

问题：服务启动报 "端口已被占用"

• 换一个端口：--port 8990

问题：二维码不显示

• 使用 --no-gui 参数，然后手动访问控制台输出的链接

📝 更新日志

• v1.3.0：增加自动安装依赖、修复 Windows 编码问题
• v1.2.0：修复版，支持自定义共享目录
• v1.0.0：初始版本