﻿局域网互传 · 使用说明
============================================================

手机和电脑连着同一个 WiFi，就能互相传文件。
不用数据线，不用微信，不用登录，不经过任何服务器。


【先挑一个版本】

  下载页上有三个，功能完全一样，挑一个就行：

    ① 局域网互传C版.exe      200 KB   ← 推荐
       不用装任何东西，双击就用；Win7 也能跑；打开最快。
       就一个文件，放桌面、放 U 盘、随便哪儿都行。

    ② 局域网互传.exe         7.5 MB
       也不用装东西，双击就用。启动比 C 版慢几秒（要先自解压）。
       系统要 Win8.1 或更新的。

    ③ 源码版（zip，或单个 .py）
       只有这一个需要电脑上装过 Python 3.7+。

  下面第 1 步说的「一键启动.bat」是源码版里的东西。
  如果你下的是 exe，直接双击那个 exe 就等于第 1 步，接着看第 2 步。


【怎么用】三步

  第 1 步   在电脑上双击运行

            源码版：双击「一键启动.bat」。
                    （它也认 exe —— 同一个文件夹里放着 C 版或免安装版 exe 时，
                      双击这个 bat 会直接跑 exe，不碰 Python。）

            exe 版：直接双击「局域网互传C版.exe」或「局域网互传.exe」。

            会弹出一个黑色窗口，同时自动打开浏览器页面。
            这个黑色窗口就是服务本身，用的时候别关它。

  第 2 步   手机连上同一个 WiFi，然后扫码打开
            电脑浏览器页面右上角有个「二维码」按钮，点一下，
            用手机相机或微信扫一扫。
            扫不了的话，直接在手机浏览器里输入黑窗口里那串地址，
            形如 http://192.168.1.104:8620

  第 3 步   互相拖文件
            手机、电脑都能上传，也都能下载。
            电脑上收到的文件，在「收件箱」文件夹里
            （就在你双击的那个程序旁边）。


【传文字】网页上还有一个「文字剪贴板」页签。
          适合传一段网址、验证码、地址、WiFi 密码这种小内容，
          在一边发送，另一边刷新就能看到，点一下复制走。

【文件多的时候，两个省事的功能】

  · 一次传一整个文件夹
      上传那块写着「选一个文件夹」的地方点一下，或者干脆把整个文件夹
      从资源管理器拖进网页。里面有多少层子文件夹都行。

      ★ 传上去的文件夹会「原样保留」：收件箱里只显示一行文件夹，
        点进去才看得到里面，里面的文件不会铺到外面来。
        上面有「收件箱 / 项目资料 / 图片」这样的面包屑，点哪一级回哪一级。
        传一个跟已有文件夹同名的进来，整个会变成「项目资料(1)」，不会合并。

      ★ 在文件夹里再散着传文件，就落在这个文件夹里，不会跳回收件箱根目录。

      ★ 每个文件夹行的右边也有一个「下载」按钮：点它就是把整个文件夹
        打成 zip 下下来（网页没法直接「下载一个文件夹」，只能打包），
        不用先去勾它再点上面的按钮。

      ★ 文件夹和文件的图标不一样，一眼分得清哪行能点进去。

      ★ 打包下载也保留目录：勾一个文件夹，解出来的 zip 里是
        项目资料/图片/照片1.jpg 这样的完整路径，不会被拍平。

      ★ 空文件夹装不进 zip（zip 里只能放文件），勾了会提示。

  · 一次下载好几个
      文件列表每行左边有个勾选框，勾完点上面的「打包下载 (N)」，
      浏览器就下下来一个 zip，解开就是那几个文件。
      点「全选」前面那个框可以一次勾上全部。

      ★ 只勾了一个的时候，会直接下那一个文件，不会多包一层 zip。

  · 打包出来的 zip 是「不压缩」的
      局域网传文件快慢看 WiFi，不看体积；照片视频本来也压不动。
      所以 zip 只是把选中的文件原样装进一个包里，包的大小约等于
      几个文件加起来的大小。

      三个版本都一样：一次最多 20000 个文件、加起来 4 GB，超了会提示分几次下。


【传上来的文件存在哪？】

  存在「跑这个程序的那台电脑」上，就在程序旁边的「收件箱」文件夹里 ——
  exe 版就是 exe 旁边，源码版就是那个 .bat / .py 旁边。
  手机不存东西（它只是个浏览器），服务器也不参与，不占任何云空间。

  想换个地方，启动时加 --inbox，比如：

      局域网互传C版.exe --inbox D:\我的下载

  占了多少，三个地方都写着：

      网页顶上      一行「共 N 个文件 · M MB」
      黑色窗口里    「已占用」那一行，旁边就是收件箱的完整路径
      超过 5 GB     会变成黄字提醒（只提醒，「不会」自动删）

  不想要了就在网页上勾着删掉。删文件夹要再确认一次（会告诉你里面有几个文件、
  多大），删掉就是真删，不进回收站。


【常见问题】

  · 手机打不开页面？
    1) 确认手机连的是同一个 WiFi（不是流量、也不是别的网段）
    2) 确认黑窗口还开着
    3) 第一次运行时 Windows 可能弹「防火墙」提示 —— 一定要点「允许访问」

  · 提示没找到 Python？
    这条只跟源码版有关。装一个 Python 3：https://www.python.org/downloads/
    安装时务必勾上「Add Python to PATH」，装完重新双击「一键启动.bat」。
    不想装 Python，就换上面 ① 或 ② 的 exe，双击就能用。

  · 第一次运行弹「防火墙」提示？
    点「允许访问」，专用网络和公用网络两个框都勾上，否则手机连不上。
    如果你以前用过源码版、现在换了 exe，会再弹一次 ——
    对 Windows 来说「python.exe」和「局域网互传C版.exe」是两个不同的程序，
    各弹各的，属正常。

  · 端口 8620 被占用了？
    会自己往后找一个能用的端口（8621、8622……），
    以黑窗口里打印的地址为准。
    也可以自己指定：一键启动.bat --port 8700

  · 想换个保存位置？
    一键启动.bat --inbox D:\我的下载
  · 勾了一堆文件点「打包下载」，进度条走到一半不动了？
    打包是先在系统盘上生成一个临时 zip 再发出去的，
    所以选的东西特别多时，系统盘（一般是 C 盘）要有对应的空闲空间。
    发完临时文件会立刻删掉。


  · 怎么停止？
    关掉那个黑色窗口，或者在窗口里按 Ctrl+C。


【安全说明】

  · 文件是在你自己的电脑和手机之间直传的，不经过互联网、不上传云端。
  · 同一个局域网里的人只要知道地址就能访问，公司/家里 WiFi 一般没问题。
  · 用完关掉窗口，服务就停了，别人也连不上了。


【用到的命令，备用】

  源码版（要先装 Python 3）：

    python 局域网互传.py                  默认端口 8620，自动开浏览器
    python 局域网互传.py --port 8700      指定端口
    python 局域网互传.py --no-open        不自动开浏览器
    python 局域网互传.py --inbox D:\下载   换收件目录
    python 局域网互传.py --ip 192.168.1.5 有多个网卡时，指定显示哪个 IP
    python 局域网互传.py --help           看全部用法

  exe 版：把上面的「python 局域网互传.py」换成 exe 的名字，参数一模一样。
          例如：

    局域网互传C版.exe --port 8700
    局域网互传C版.exe --inbox D:\下载
