v1.1.1

狐径 FoxPath v1.1.1 — 修复版：「检查更新」强制联网（不再被 6 小时缓存挡住）

下载

文件	说明
FoxPath.exe	主程序，绿色单文件，双击即用。版本号写在 exe 属性里（鼠标悬停 / 右键-属性-详细信息）
version.json	升级信息，已装用户点「检查更新」时读取。这个附件不能少，否则老版本拿不到升级提示

这一版修了什么

1. 「检查更新」被 6 小时缓存挡死（重大缺陷修复）

• 现象：用户按下「检查更新」，面板回"已是最新版"——但根本没下网络，读的是 6 小时内的缓存。
  后果一：新版发布后，老用户最长 6 小时毫无感知，自动升级同样被缓存挡住；
  后果二：刚升级完的实例读到升级前的旧缓存，面板误报"本地版本比线上新"。
• 根因：手动检查、立即升级的闸门与静默检查共用了 use_cache=True 的 6 小时 TTL。
• 修复：「检查更新」和「立即升级」强制联网；静默自动检查保留 6 小时节奏（不轰炸源站）。
  联网全失败时回读缓存，并在结论里明说"（联网失败，显示的是上次检查的结果）"——
  不再拿过期数据装现状。
• 已按用户路径做对照验证：植入"新鲜但过期"的假缓存（线上=1.0.5，_checked=现在），
  修复版点检查正确返回真实线上版本并把缓存刷成真值。

2. exe 下载支持多源回退（能力储备）

• version.json 的 exe 节点新增可选 mirrors[]：下载时按 url → mirrors 依次试错，
  只认 https；全失败时报出"共试 N 个源"。当前仍只发 Gitee 主源 + GitHub 镜像两个仓库，
  不新增平台；此字段为后续任何镜像留位。老版本读到 mirrors 自动忽略，无兼容风险。

3. 文档口径

• README/发行说明明确：升级源不通（检查更新长时间连不上）时，到 Gitee 发行页手动下载
  FoxPath.exe 覆盖安装即可，配置保留、无需卸载。

已知边界（照旧）

• 运营商如果按 SNI 掐断（TLS 握手里能看到域名），本地代理帮不上忙 —— 只能换网络或换方案。
• 线路分钟级抖动期间，主站可能"通几秒、堵几十秒"，体检与吞吐挑 IP 会如实反映。
• 只代理 GitHub 相关域名；不改 hosts、不改系统 DNS，退出时还原系统设置。
• 控制面板只监听 127.0.0.1，接口已做 Host/Origin 同源校验。

版本历史（近几版）

版本	日期	说明
v1.1.1	2026-10-12	修复「检查更新」6 小时缓存挡路（强制联网+过期明说）；exe 下载多源回退（mirrors[]）；手动下载口径进文档
v1.1.0	2026-10-12	重大更新：吞吐挑 IP、raw/pages IPv6 双池、IPv6 闸门、好 IP 复用+失败降权、头像域纳入代理、静默启动、PAC 总闸修正
v1.0.8	2026-10-10	升级链路加固与仓库治理（10-11 曾同版本号换过一次包）
v1.0.7	2026-10-09	升级护栏：拒绝降级、失败自动回滚、修「升级后起不来」真因
v1.0.6	2026-10-08	候选池扩到官方全量、IP 表三源依次试、raw 与发布附件加速
v1.0.5	2026-09-22	网页版在线升级（检查更新/立即升级/进度条/小助手）
v1.0.0	2026-09-19	首个版本：本地代理 + PAC、IP 体检、候选池刷新、全灭自愈、退出还原

反馈：GitHub Issues　·　Gitee Issues

---

维护约定（发版的人看）：这份文件的首行版本号就是当前线上版本。发新版前把它整篇换成新版本的说明
（或改用 --notes <文件>）；tools/publish.py 不带 --notes 时会读这份文件，并校验首行版本号与
要发的版本一致，不一致直接中止 —— 免得发行页挂着上一版的文案。