赵师傅手机电脑互传 v1.5.2 使用说明 ==================================== 一、这是什么 电脑开一个小服务,手机扫码(或输地址)用浏览器就能: · 下载电脑共享的文件(大文件、断点续传、文件夹打包 zip) · 把手机里的照片/视频/文件上传到电脑(分块上传带进度) · 手机上删除文件(走电脑回收站,可还原) 手机端不用装任何 App,微信/浏览器扫码即用。 v1.5 起内置了 chfs(CuteHttpFileServer)作为 HTTP 内核 —— 就是那个 一直被大家夸"手机一开就连上"的软件。本工具的稳定性和它对齐了。 二、快速上手 1. 双击「赵师傅手机电脑互传_单文件版.exe」(首次运行解压约 28MB,几秒) 2. 点「添加文件夹」选择要共享的文件夹(可加多个,手机上分目录显示) 3. 点「启动服务」 4. 手机连同一个 WiFi,扫二维码或输入显示的地址 5. 用完点「停止服务」,或直接关窗口 三、v1.1 / v1.2 新增功能 1. 多共享目录:卡片①可添加/移除多个文件夹,手机打开先是目录列表, 点进哪个目录就浏览哪个(只共享一个目录时自动直达,不用选)。 2. 账户控制:卡片③「添加账户」后,手机打开会要求登录; 每个账户可单独勾选 下载 / 上传 / 删除 权限(双击单元格编辑)。 不设账户就是访客模式,按「访客权限」三个开关走; 访客三个权限全关时,手机打开必须登录账户才能用。 3. 开机自启:勾上「开机自启」后,电脑开机即自动在后台托盘运行; 「自启后自动开服务」勾着的话,开机后服务直接就绪,手机随时可连。 托盘图标:双击打开主界面,右键可启动/停止服务或退出。 4. 关窗缩托盘:勾上后点 × 窗口消失但服务继续跑(右键托盘退出)。 5. 配置记忆:目录/端口/账户/开关全部自动保存, 下次打开不用重新设置(存于 %APPDATA%\赵师傅手机电脑互传\config.json)。 6. 界面字体整体加大(v1.2 修正:之前误带了别家的 0.9 缩小系数)。 7. 横幅右上角新增「博客 / 抖音 / 关于」按钮(v1.2): 博客 dnzsf.com、抖音「装机日常」一键打开。 8. 首次启动弹出免责声明,点「我已阅读并同意」后不再打扰; 之后随时点「关于」可查看作者信息与免责声明(v1.2)。 9. 手机端页面底部也加了作者博客/抖音链接(v1.2)。 三·二、v1.3 新增(修复「手机打不开地址」) 1. 服务改为监听所有网卡(0.0.0.0): 之前只绑一个固定地址,电脑有多个网卡(网线+WiFi+虚拟网卡)、 换过网络、或网卡顺序变化时,手机就会连不上。现在都不会了。 2. 防火墙自动检测 + 一键修复: 之前首次启动时 Windows 防火墙弹窗如果点了「取消」,系统会悄悄 记一条「阻止」规则且不再弹窗——服务显示正常,手机永远连不上。 现在启动服务会自动查出这种死局,界面出现「一键修复防火墙」按钮, 点一下(UAC 确认)即自动删阻止规则并加放行规则。 3. 网络切换自愈:电脑换网络后,界面地址和二维码自动切到新地址, 不用手动停止再启动。 4. 启动自检:服务起来后本机自连一次验证真实可访问,结果写进日志。 5. 界面加「手机打不开?」排障提示(同一 WiFi / 防火墙 / AP 隔离)。 三·三、v1.4 新增(对着 chfs 找出「手机打不开」的根子) 参照同类工具 chfs(CuteHttpFileServer)对比后定位到两个真问题: · chfs 是「原生单个 exe、程序路径固定」,Windows 防火墙按程序放行 一次就长期有效,所以它一直好使; · 本工具是「自解包单文件」,防火墙授权方式不同,容易踩到"点过取消 留下阻止规则"和"端口探测失真"两个坑。 本版修法(比 chfs 多一层保险): 1. 默认端口改成 80(HTTP 默认端口): 手机浏览器里只输 "192.168.x.x" 就能打开,不用再记 ":8080"。 被 IIS/其它软件占用时自动退到 8080,再往上找,不影响可用。 2. 防火墙「按程序 + 按端口」双规则放行: 原来只加一条按端口的放行;现在同时加一条「按程序路径」的放行, 两条互为保险——换端口、换解包目录都能通。 启动时若查出任何阻止规则或两条放行都缺,会弹框提示一键修复。 3. 修掉「端口探测失真」的隐藏 bug: 旧代码探测空闲端口时用了 SO_REUSEADDR,Windows 上这会让 bind "抢注"已被别的进程占用的端口,于是新开的实例会把老实例的端口 悄悄抢走 —— 表现就是手机有时能开、有时打不开。 现在探测用独占绑定,端口被占就是被占,会老实换下一个。 4. 第二次双击启动时弹原生提示框(不再静默退出): 告诉用户"已经在后台跑了",并给出「去托盘找」和「用任务管理器 结束旧进程」两条具体指引(旧版是卡住/抢端口的根源之一)。 5. 启动时若设的端口被占,自动改用空闲端口并在日志里说明, 不再直接甩一个报错框给用户。 三·四、v1.5 新增(内置 chfs 内核,彻底解决「手机打不开」) 做法:不再自己写 HTTP 服务,直接把 chfs(CuteHttpFileServer 3.1) 这个原生单个 exe 内置进来当内核 —— 它一直被验证"手机一开就连上", 原因就是「程序路径固定、不依赖 Python、防火墙按程序放行一次永久有效」。 把这份稳定性整包拿过来,比继续打补丁靠谱。 1. 双内核,默认用 chfs: · chfs 内核(默认,推荐):原生单 exe,启动快、内存小、最稳; · 内置内核(回落):找不到 chfs.exe 时自动启用,功能最全 (删除进回收站、上传进度、中文手机页)。 两个内核在界面上都能用,共享目录/端口/访客权限/账户权限设置方式 完全一样,不用学新东西。 2. 防火墙改成「主程序 + chfs.exe」双程序放行: v1.4 只放行了主程序,但真正监听端口的是 chfs.exe, 少放行一个手机照样连不上。现在两个程序一起放行,再加按端口放行。 3. 权限改动即生效: 改权限/加减共享目录后,chfs 内核会自动重启一次(约 1 秒)让新 配置生效,不用手动停止再启动。 4. 内核能力差异(如实说明,不夸大): · 用 chfs 内核时:手机上点删除是直接删除(不进电脑回收站), 上传不显示分块进度,手机页面是 chfs 自带的(已适配手机)。 · 想要"删除进回收站 / 上传进度 / 中文页面",就把配置文件里的 "engine" 改成 "builtin" 切回内置内核。 5. 配置文件位置(想微调内核行为可以看这里,别删): %APPDATA%\赵师傅手机电脑互传\chfs\chfs.ini 里面有 port / path / rule / log 等项,改完重启服务即生效。 6. 界面小屏适配(老笔记本福音): 窗口默认 900x700,1366x768 / 1024x768 的老屏幕一屏显示完整, 不用再滚动。布局改成:共享目录在顶上,二维码和权限左右并排, 活动日志压成底部一条。字号保持大而醒目,只有控件变紧凑。 三·五、v1.5.1 新增(高分屏适配:800x600 到 4K 都显示正常) 客户反馈:4K 高分辨率 / 150%~200% 缩放的笔记本上,窗口被压小、 内容显示不全。本版彻底修复: 1. 开启 Qt High-DPI 缩放:150% / 200% / 125% 缩放下界面按系统 缩放等比放大,字迹清晰不发虚,内容不再被裁掉; 2. 窗口尺寸按屏幕自适应: · 800x600 / 1024x768 老屏:窗口自动缩到屏幕装得下, 内容放不下时出滚动条(不再整个窗口超屏); · 1366x768 / 1920x1080:默认 900x700~1040x760,一屏显示完整; · 2K / 4K(100% 缩放):窗口自动放大一号,看着不空。 其余功能与 v1.5.0 完全一致,配置互相兼容,直接覆盖使用。 三·六、v1.5.2 修复(旧版本没退出时,新版解压报「Permission denied」) 有客户在旧版本还在托盘运行时直接双击新单文件版,解压目录里的 libcrypto-1_1.dll 被旧进程锁死,弹「解压失败: [Errno 13] Permission denied」。本版修法: 1. 解压前自动检测:发现旧版本进程还在从解压目录里运行, 自动结束旧进程(只结束本工具自己的旧副本,不碰其他程序); 2. 解压中被占用自动重试(最多 3 次); 3. 实在解压不了(如杀毒软件锁定),弹窗给出明确的三步处理指引, 不再只甩一句英文报错。 高分屏适配(v1.5.1)照常保留。 四、安全说明 · v1.3 起服务监听局域网网卡(0.0.0.0),仍只服务局域网,外网访问不到; 不放行外网需要在路由器上映射端口,正常家用宽带默认不可从外网直达 · 删除永远是进回收站,不做硬删除 (例外:切到 chfs 内核时删除由 chfs 直接执行,不进回收站; 需要"删除可还原"请用默认之外的 builtin 内核) · 路径穿越攻击(../、伪造目录等)已在服务端全部拦截(自测覆盖) · 公共 WiFi 建议设置账户或关掉访客权限 五、命令行用法 xxx.exe 打开界面 xxx.exe --tray 托盘驻留(开机自启就是用这个参数) xxx.exe --selftest 端到端自测(报告写 selftest_report.txt) xxx.exe --headless [目录] 不开界面直接起服务(PE/命令行环境) xxx.exe --port 80 headless 起始端口(默认 80) xxx.exe --version 版本号 六、常见问题 Q: 手机打不开页面?(按顺序排查,绝大多数是第 2 条) A: 1) 手机和电脑连的是同一个 WiFi/热点,手机别开流量; 2) 首次启动时 Windows 防火墙弹窗点了「取消」——软件检测到会弹框 提示(界面也有「一键修复防火墙」按钮),点一下按提示确认即可; 3) 路由器开了「AP 隔离 / 访客网络 / 无线隔离」,到路由器里关掉; 4) 换了网络的话,会自动切新地址,看地址栏最新的那个。 Q: v1.5 之后还会"手机打不开"吗? A: 概率低很多:内核换成了 chfs(原生 exe、路径固定),防火墙按程序 放行一次就长期有效;再加一条按端口放行,两条互为保险。 真遇到问题,日志里会写清是内核没起来还是防火墙没过,照着提示修。 Q: 上传到一半断了? A: 分块上传,重开页面再传即可;已传完的分块不会重复占用。 (用 chfs 内核时上传由 chfs 自己处理,重传即可) Q: 删掉的文件去哪了? A: 内置内核:电脑回收站,右键还原即可。 chfs 内核:直接删除(不进回收站),删前请确认。 Q: 想换端口? A: 卡片①里改「端口」再点启动。默认 80(手机只输 IP 就能打开); 端口被占用时程序会自动改用空闲端口并在日志里说明。 Q: 同一台电脑开了两个? A: 程序有单实例锁,第二次启动会弹提示框告知已在运行, 并指引去托盘找窗口、或用任务管理器结束旧进程。 Q: 以前点过「取消」,现在怎么办? A: 直接启动服务,程序会检测出阻止规则并弹框,点「立即修复」、 确认 UAC 即可;或右键本工具「以管理员身份运行」再启动。 七、技术参数 · 单文件约 27~28 MB(内置 chfs 内核); 不用 UPX;32 位;兼容 Win7 SP1 / Win10 / Win11 · HTTP 内核:内置 chfs 3.1(原生 exe)+ 纯标准库内置内核(回落) · 界面 PySide2;二维码 segno · 自测全过(本机 57/57,含穿越攻击、账户权限、多目录、配置往返、注册表自启)(含穿越攻击、账户权限、多目录、配置往返、注册表自启) · 作者:商城县电脑赵师傅 · 博客 dnzsf.com · 抖音:装机日常 · 构建命令(改代码后): C:\Python38-x86\python.exe build.py # PyInstaller + 裁剪 C:\Python38-x86\python.exe build_stub.py # SFX 桩(必须 3.8 x86) C:\Python38-x86\python.exe make_sfx.py # 拼单文件 C:\Python38-x86\python.exe check_release.py dist_release\赵师傅手机电脑互传 build_sfx\ZhaoSFX.exe dist_single\赵师傅手机电脑互传_单文件版.exe MD5 见同目录 md5.txt(分发时请核对)。