52 Commits

Author	SHA1	Message	Date
wangjia	0a70a24cdb	feat: 连接设备上限 backstop — 兜住"已登录的超限设备"(#16) ... 登录挡板只拦新登录,已登录的超限会话(如 pro 已连 5 台)永远不被提示 → 限制形同虚设。 补服务端连接卡点:超限账户连接直接拒,兜住已登录设备(下次一连即被拦,无需重登)。 服务端: - Entitlement 加 MaxDevices(EntitlementForUser 查 p.max_devices;free 默认 1) - NodeStore.CountActiveDevices(近 30d 活跃)+ SQLNodeStore/mock 实现 - ConnectNode:activeCount > MaxDevices → 403 {code:DEVICE_LIMIT_EXCEEDED, max_devices} 客户端: - ConnectApiException 解析 code/max_devices(结构化错误体) - _connect 遇 DEVICE_LIMIT_EXCEEDED → 置 deviceLimitProvider → 顶层路由弹「移除设备」页 (设备列表走 devicesProvider),移除到上限内自动放行 后端 go test(store/nodes/httpapi/devices)全过;前端 analyze 干净 + 66 测试过。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-01 22:11:13 +08:00
wangjia	34d980d875	feat(client): 设备数超限挡板 DeviceLimitScreen(#16 前端) ... 登录响应带 device_limit 时,顶层路由把用户挡在「移除设备」页,降到上限内才进主界面。 - auth_api.dart:AuthTokens 解析 device_limit;新增 DeviceLimit/DeviceBrief 模型 - auth_provider.dart:deviceLimitProvider(挡板状态);auth_screen 登录后置入 - main.dart:isLoggedIn 后若 deviceLimit!=null → DeviceLimitScreen(挡 HomeShell) - screens/device_limit_screen.dart(新):设备列表(本机标注不可删)+ 每台移除 + 一键「移除最久未用」+ 退出登录;降到上限内自动清挡板放行(复用 devicesProvider.remove) - l10n:deviceLimitTitle/Desc/RemoveOldest(zh/en);顺带修 devicesSub 文案 5→3 台 analyze 干净;client 全量测试 161 通过。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-01 19:25:14 +08:00
wangjia	58211d2fb8	fix(client): 连接时长按墙上时钟算,切后台/锁屏不漏计 ... iOS 锁屏/切后台后连接页时长少算:elapsed 原来靠每秒 +1 的 Timer 累加,后台 isolate 被挂起、Timer 停跳 → 后台那段时长漏掉。改为记 _connectedAt 起点, elapsed = now - _connectedAt(墙上时钟),与 timer 是否跳无关;回前台(resumed) 立即 _refreshElapsed 补上。_connectedAt 用 ??= 保留同一会话起点,断开才清。 测试:新增「切后台 300s 时长不漏计」回归(前台 10s + 后台 300s = 310s);全 8 例过。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-01 09:53:49 +08:00
wangjia	37c1724b67	fix(client): 切后台停看门狗 — 后台 urltest 被限流不再误判节点死断连 ... 真机(Honor/MagicOS)复现:连上后切后台 ~1min 必断,报「当前节点异常」。 logcat 铁证:进程存活、Dart 看门狗后台照跑, [Watchdog] urltest stale 59s → upstream dead → unhealthy → doStop 根因:后台(Doze)把 urltest 主动探测限流 → urltest 停更,但 speed 帧仍在流 → statsLive=true + urltest 陈旧 → 路径A 误判上游死,把正常隧道断掉。上次的 statsLive 闸只挡「stats 整体停」(macOS 睡眠),挡不住「speed 在流、只 urltest 停」。 修:看门狗是前台 UX 功能(发现节点死好让用户换),后台无 UI 可响应、urltest 必被限流 → AppLifecycleListener 在 paused/hidden 停看门狗,resumed 且仍连接则重启(基准由 _onStats 首帧/gap 重置)。真·内核掉线(路径A',事件驱动)不受影响,仍上报。 测试:connection_watchdog 新增「切后台停看门狗」回归(后台 speed 在流+urltest 停 >45s 不切节点);全 7 例过。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-01 08:54:16 +08:00
wangjia	07861ea04b	fix(client): 看门狗后台唤醒不再误判节点死→假重连 (#18) ... 现象:app/Mac 后台或睡眠一段时间再打开,出现"重连过程"但 VPN 没掉。 根因:连通看门狗路径A(urltest stale)用墙上时钟算陈旧度,挂起期 stats 停更、 _lastUrltestOk 冻住;唤醒时一算 >45s 即判上游死 → _onNodeUnhealthy 触发 disconnect+connect(智能模式还自动切节点),但隧道一直好好的。 修(connection_provider.dart 一处): - _onStats 记 _lastStatsAt(任意 stats 帧时刻);stats 出现 >10s 长间断(挂起/唤醒) 时把 _lastUrltestOk 前移到现在,给节点新的 45s 窗口自证 - 看门狗路径A 增加 statsLive 闸:仅在 stats 确实在流(距今 <10s)且 urltest 停 ≥45s 时才判节点死;stats 整体停(挂起未恢复)则跳过本轮 - 加可注入时钟 _now(默认 DateTime.now),使时间驱动的 path A 可单测 测试:connection_watchdog_test 新增两例 —— ① stats 在流但 urltest 停≥45s 仍正常判死 切节点(path A 未被削弱);② 挂起 60s 唤醒不假重连(无 statsLive 闸则会误切,真回归)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-01 07:10:34 +08:00
wangjia	7add0259b4	chore(client/macos): 清理延迟排查的诊断打点 + debug 注入(最终干净版) ... 延迟显示已修通。移除排查期的临时诊断:扩展侧 Log 客户端/klog 捕获、log.level=debug 注入、 diag 字段/setDiag;主 app StatsClient 每5帧的 dl/ul/urltest 打印;Dart 侧 [Stats]/[Ping] 打点。 保留全部修复:clash_api 注入取 urltest、sendProviderMessage 统计通道、/proxies history+active 缓存、共享广播流、_onStats 回退 effectiveNode、连接态跳过直连实测。 CURRENT_PROJECT_VERSION 52→53。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 18:03:30 +08:00
wangjia	e6e7d5db10	diag(client): _onStats 顶部无条件打点 + 订阅打点,确认是否被调用 ... Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 17:47:16 +08:00
wangjia	d14f7a0ec5	diag(client): _onStats/setLivePing 打点,定位延迟为何不回写 node.ping ... Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 17:26:56 +08:00
wangjia	dbe657f997	fix(client): 自动连接到已运行隧道时延迟显示 — —— _onStats 回退 effectiveNode ... 连接页延迟一直 —:自动连接/重连到「已在跑的隧道」时不走 _connect → _connectedNode 为 null → _onStats 提前 return,内核 urltest 实测(已确认到达 app:reality-out=579)无处回写 node.ping。与看门狗 _checkHealth/_probe 一致,回退到 effectiveNode(当前/智能所选节点)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 17:17:57 +08:00
wangjia	6809e0a377	fix(client): 连接态延迟只认内核 urltest,跳过直连实测(对齐 Windows 方法) ... 连接页延迟显示 ~3ms:连接态下 _measure 的直连 TCP 实测被全局 TUN 在本地接住, connect() 几毫秒即返回(假值),覆盖了内核 urltest 经 setLivePing 回写的真实 RTT (macOS system 栈 TUN 尤其明显)。Windows 端延迟本就取 sing-box urltest(clash API /proxies 的 history delay),macOS 经 libbox writeGroups 的 item.urlTestDelay 同源。 修复:_measure 在 connectionProvider.phase==on 时直接返回,不做直连实测——连接态延迟 只认 urltest(与 Windows 一致),断开后再恢复直连实测。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 12:18:32 +08:00
wangjia	8680131b3d	fix(client): 登出(主动/被强退/会话过期)一律断开隧道 ... bug:logout() 只清 token,不碰隧道 → 被强制下线/正常退出后 VPN 还连着、继续用数据面。 修:ConnectionController 监听 authProvider,isLoggedIn 由 true→false 时断开隧道(_disconnect)。 一处覆盖所有登出路径(设置页登出/会话轮询强退/token 续期失败登出);token 续期仍登录不触发。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 09:00:00 +08:00
wangjia	d192d96d95	fix(client): 设备页每 15s 静默刷新列表,其他设备状态变化 ~15s 内可见 ... 原设备列表打开时加载一次就不动(感觉十几分钟才同步)。加透传式轮询包装器 _DevicesAutoRefresh:在设备页期间每 15s 调 DevicesNotifier.refresh()(静默、不闪 loading、 失败保留旧列表)。配合服务端会话轮询刷 last_seen + 90s 窗口,其他设备上/下线 ~15s 内反映。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 08:05:32 +08:00
wangjia	7f070a0693	fix(client): 看门狗 path A 仅在「连上(on)后掉线」触发,排除 connecting 握手瞬态 ... macOS NE 连接序列是 off→connecting→off→connecting→on,connecting 期有瞬态 off。原 path A 条件 wasActive 含 connecting → 一连接就在握手瞬态 off 上误报「节点异常」(实际连上了)。 改:仅 phase==on(真正连上过)再非用户主动掉线才判节点异常;connecting→off(握手抖动/ 连接失败)不触发。跨端修复(桌面也更稳)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 07:01:13 +08:00
wangjia	b99d6d71ae	fix(client): 修 _disposed 潜伏 bug + build 只 watch isLoggedIn,根治延迟冻成 — ... 根因:1.0.36 的 401 自愈触发 auth token 续期 → authProvider 状态变 → nodesProvider.build() 重跑 → Riverpod 先调上一轮 ref.onDispose(()=>_disposed=true),新 build 没复位 → _disposed 永久 true → setLivePing/_measure 开头的 if(_disposed)return 让 urltest 回写/延迟实测全部静默 → 延迟冻在 —。修:① build 开头 _disposed=false 复位;② build 改 watch authProvider.select ((s)=>s.isLoggedIn),token 续期(accessToken 变但仍登录)不再重建 nodesProvider、不清延迟。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 01:32:15 +08:00
wangjia	15133b8a72	feat(client/macos): 开机自启隐藏到托盘(--autostart),与 Windows 对齐 ... macOS 登录项(launch_at_startup)注册时带 args:['--autostart'];main() 读该参数 windowManager.hide();MainFlutterWindow.awakeFromNib 检测到 --autostart 时 orderOut 兜底(避免 storyboard Visible At Launch 闪窗)。常规启动无参数,正常显示窗口。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 01:27:30 +08:00
wangjia	a03de6c06a	fix(client): 节点拉取 401 自愈+失败不清空列表;看门狗 path A 跨端(urltest 陈旧判活) ... bug:周期刷新拿到 401(token 过期)时 _fetchNodes return const [] → 把节点列表清空, 用户「看不到节点」误以为 server 挂。修:① 非 200 抛异常,refresh 失败保留旧列表(绝不清空); ② 401 用 refresh token 续期重试一次自愈,续期失败才登出。 看门狗 path A 全平台统一:不再只靠原生报 off/error(libbox/NE 行为不一),改用内核 urltest 陈旧度(经 proxy 探测,四端都有 stats)——urltest 超 45s 未成功即判上游死 → _onNodeUnhealthy。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 01:23:13 +08:00
wangjia	795082066e	fix(client): 刷新节点列表时保留已有 ping,修延迟被 refresh 清成 — 的根因 ... 日志实证:urltest 回写正常(best=561ms→setLivePing),但看门狗/节点页每15s refresh() 重拉服务端列表、解析时 ping=0(占位),state=result 把刚写进去的延迟清零 → 显示 —, 下一帧 setLivePing 又写回 → 来回闪。修:refresh 用 _mergePings 按 uuid 保留已有 ping (ping 是客户端实测,服务端列表不带)。去掉诊断日志。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 00:50:58 +08:00
wangjia	a06bfda45c	diag(client): _onStats 加 urltest 诊断日志,定位延迟显示 — 根因 ... Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 23:50:48 +08:00
wangjia	16af1c9f02	fix(client): 连接态把内核 urltest 回写连接节点 ping,修延迟显示 — + 保持同源一致 ... 1.0.32 纯 direct node.ping 的代价:auto-connect 太快连上、没有断开窗口让 direct TCP 量到 延迟 → node.ping 一直 0 → 显示 —。修:ConnectionController 订阅 stats,连接态把内核 urltest 最小正延迟回写连接节点的 node.ping(setLivePing)。连接页与节点列表都读 node.ping → 同一个数; 连接节点有实时 urltest 值、其余节点保留 direct 实测。断开态仍 direct TCP。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 23:35:40 +08:00
wangjia	d08b908e1f	fix(client): 节点列表延迟探测失败时保留旧值,修连接后整列延迟消失 ... 返工引入的回归:看门狗连接态周期 refresh→_measure 重测所有节点 TCP ping,但连接态 全局 TUN 把到节点的握手接住→probeAll 返回 0→pings[uuid]??n.ping 因 0 非 null 覆盖成空。 改:探测返回 0 时保留旧 ping。连接态保留上次延迟,断开态正常刷新。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 23:26:19 +08:00
wangjia	d9378b6729	fix(client): 看门狗返工 — 意外掉线捕获+服务端down轮询,撤销TUN下假阳性的TCP探测 ... 测试暴露:全局TUN下App的socket到节点IP被本地TUN当场接住(假1ms),客户端TCP探数据口 不可行;且节点死时内核先掉线、提示被kernel off覆盖、节点页status不刷新显示绿色。返工: - 撤销 DataPlaneProber/livePingMs;延迟改回内核urltest(sing-box经REALITY真实直连数据面 探出的RTT,唯一可靠口径),连接态urltest=0→显示—不回退旧ping。 - 看门狗两条可靠路径:A 捕获「非用户主动的内核掉线」→置「节点异常」+刷列表; B 连接态周期刷/v1/nodes,所连节点被判down→智能切/手动断。 - _offNotice 让显式断开与kernel off读同一提示字段,不再互相覆盖(修「断开但没报错」)。 - 节点页周期15s刷新,让服务端down状态浮现(tile已按isDown置灰)。 返工测试:意外掉线提示/服务端down切/断/健康保持,全过。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 23:21:09 +08:00
wangjia	554708a092	fix(client): 看门狗+延迟统一到数据面 IP TCP 探测 + 消费服务端 down 信号 ... 修复:数据面挂了客户端无感。原看门狗探 generate_204,会被分流判 direct 走本地 出网假阳性,永不触发。改为三路融合判活,针对「实际所连节点」(_connectedNode, 非会随 ping 漂移的 effectiveNode): ① 客户端→数据口 TCP 握手(节点 host:443,TUN 内必 direct→直奔真实节点,不被分流糊弄); ② 延迟同源:①的 RTT 回填连接页延迟(ConnectionState.livePingMs),挂了掉成 —; ③ 服务端权威:刷 /v1/nodes,所连节点被判 down(dp_healthy=0/agent掉线/运维下线)即处理。 看门狗即时首测 + 周期 15s;连续 3 次握不上 / 服务端 down → 智能切节点 / 手动告警断开。 连接页延迟改读 livePingMs(删除内核 urltest 取数)。补信号③测试。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 21:27:49 +08:00
wangjia	49bef2fb27	feat(client): 开机自启拉起直接最小化到托盘(--autostart 标志)(1.0.28) ... 计划任务 /tr 命令带 --autostart;main() 检测到该参数在首帧前 windowManager.hide() 隐藏主窗口到托盘,自动连接逻辑照常跑。手动打开(无参数)仍正常显示窗口。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 20:11:36 +08:00
wangjia	e89f3de748	feat(client): 记住上次选择的节点 + 自动连接 toast(1.0.24) ... - selectedNodeCodeProvider 改为持久化 StateNotifier(select() 落盘、启动恢复,默认智能 AUTO); 自动连接复用上次选择:智能就智能、具体就具体。 - 自动连接门控加等「选中节点已恢复」(controller.loaded),避免用到未恢复的默认值。 - 自动连接触发时弹 toast「正在自动连接到 X」(全局 ScaffoldMessenger key)。 - 测试:选中节点 select 落盘 + 重启恢复(具体/智能)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 19:31:01 +08:00
wangjia	f2891ff2f9	fix(client): 自动连接门控改判生效节点就绪 + _connect 诊断日志(1.0.23) ... 自动连接已正确触发,但 _connect 撞 node.uuid.isEmpty 报「节点尚未就绪」:门控用的是 nodes.any(uuid),而 _connect 用 effectiveNode。改门控直接判 effectiveNode.uuid 非空(与 _connect 同一判据)。_connect 加一行日志记录 node/uuid/selected/nodes 便于确认。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 19:15:39 +08:00
wangjia	28f8e5ebcd	fix(client): 自动连接竞态真因 — 等设置加载完再判(1.0.22) ... 日志实证:节点就绪(~450ms)与设置加载几乎同时完成,节点回调早 1ms 读到还没加载完的 autoConnect=false → 不连。AppSettings 加 loaded 标志(_load 完成置 true,失败也置); _maybeAutoConnect 同时监听 nodes + settings,二者都就绪(settings.loaded && 节点 uuid 非空) 才决策一次。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 19:08:49 +08:00
wangjia	f734126eb6	chore(client): 1.0.19 — 自动连接诊断日志 ... 排查「自动连接没生效」:在 _RootFlow 自动连接路径(HomeShell 显示 / 节点就绪 / autoConnect/phase 判定 / 触发) 与 Settings(_load 读到的 autoConnect、setAutoConnect 落盘)加 logLine 日志,定位卡在哪一步。诊断完移除。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 18:26:47 +08:00
wangjia	8584f0459e	feat(client): 自动连接开关 + Windows 开机自启改任务计划程序 ... - 新增「自动连接」设置开关(默认关,持久化):启动 app 进登录态主界面后,等节点就绪 自动连一次(_RootFlowState 一次性 listenManual nodesProvider → toggle())。全平台生效。 - Windows 开机自启改用 schtasks /rl highest 登录触发任务:本应用 requireAdministrator, 原注册表 Run 键(非提权)开机会弹 UAC/起不来 → 任务计划静默提权拉起。macOS/Linux 仍用 launch_at_startup 登录项。 - 设置页功能组加「自动连接」行;新增 autoConnect/autoConnectSub 文案。 - _load 加 mounted 守卫(异步初始化期间已 dispose 不再写 state)。 - 测试:autoConnect 默认关 / _load 读持久化 / setAutoConnect 落盘。 注:移动端真·常连(Android Always-on + iOS/iPad On-Demand,无 UI 自连)是更大的原生活, 已单列 todo #14 后续做;本轮移动端只有「打开 app 自动连接」。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 17:46:06 +08:00
wangjia	2080062d8c	feat: 数据面故障韧性 — 节点健康上报(控制面) + 客户端连通看门狗 ... 盲区:节点 status 只看 agent 的 gRPC 在线,sing-box 数据面坏了(崩/配置坏/数据口不通) 而 agent 仍在线时,节点仍显示 up、connect 放行、客户端「已连接」但流量全失败,且不自愈。 控制面: - agent 每心跳探 sing-box clash_api /version(2s 超时,连续 2 次失败才报不健康,防抖), 经新增 HeartbeatRequest.data_plane_healthy 上报(手写 agentv1 契约 + proto 同步;JSON codec)。 - NodeLoad 加 DataPlaneHealthy(随 load 写 Redis;字段缺失默认 healthy 防滚动期误杀)。 - effectiveNodeStatus 扩为 (dbStatus, agentOnline, dataPlaneHealthy);ListNodes 与 ConnectNode 统一改用它 → 数据面坏的节点列表置灰 + connect 返回 404 拦截。 客户端(connection_provider 连通看门狗): - 连上后每 15s 经隧道 HTTP 探海外 generate_204(可注入),连续 3 次失败判当前节点不可用。 - 智能选择 → 自动切到其他最优可用节点重连;手动选定 → 断开并提示「节点异常」(尊重用户选择)。 - 新增 nodeUnhealthySwitched/nodeUnhealthyError 文案。 测试:agent 健康探测防抖、effectiveNodeStatus 真值表、dataPlaneHealthy 助手、看门狗 智能切/手动断/健康不触发;go test ./... 与 flutter test 全绿。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 13:19:22 +08:00
wangjia	29a6aa9112	fix(client): refresh token single-flight — 修跨平台「放久了/更新后被踢下线」 ... refresh token 是单次使用+轮换(服务端每次刷新 DEL 旧 JTI 发新的)。冷启动/进 页面会并发打多个接口,access(15min)过期后同时多次 401,各自拿同一个旧 refresh token 去刷新:第一个成功轮换,其余拿已作废的 JTI 必被拒 → 误触发 logout 把用户 踢回登录页。与平台无关(共用 auth 逻辑),表现为「放久了/覆盖更新后要重新登录」。 修法:AuthNotifier.refresh() 用共享 in-flight future(single-flight)合并并发刷新, 旧 token 只被消费一次。新增 auth_refresh_singleflight_test 覆盖并发只刷一次 + 刷新后可再刷。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 11:05:16 +08:00
wangjia	315c343ed5	feat(devices): 设备默认名「平台简写·主机名」+ 支持重命名(1.0.13) ... ① 默认名:DeviceIdentity 改「平台简写(Win/Mac/Linux/iOS/Andr)·主机名」,主机名截 到 8、总长≈12(替代裸主机名,更短)。 ② 重命名:新端点 POST /v1/me/devices/{uuid}/rename(Service.RenameDevice 校验归属+ 截 64);store.UpdateName;客户端 account_api.renameDevice + provider.rename + 「我的设备」⋯ 菜单加「重命名」+ 输入弹窗;l10n(zh/en)。 ③ 版本 1.0.13。 测试:server RenameDevice(归属/空名/404)+ 客户端 rename widget;全量 go/flutter 绿。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 09:12:36 +08:00
wangjia	e333f59cb3	feat(stats): #10 第②层 —— 统计页按设备过滤(per-device 本地日曲线) ... 镜像账户级时区曲线到「按设备」: - migration 000018 `usage_device_hourly`(每设备 UTC 小时桶,稀疏)。 - ReportUsage deviceID>0 时加 AccumulateDeviceHourly;NodeStore 接口+impl+mock。 - usage.Store.DeviceHourlyRange(JOIN devices 校验归属+解析 uuid→id);UsageCurve 增 deviceUUID 形参:空=账户级,非空=该设备本地日曲线(分桶逻辑复用)。 - /v1/usage?device=<uuid>;客户端 account_api.usage(device)、usageProvider key 改 记录 (days,device)、stats_page 接 statsDeviceProvider → 选设备即重取该设备曲线。 测试:per-device 曲线隔离+归属校验(A的设备不进B)、UsageCurve(deviceUUID)、 migration v18、客户端 widget(选设备→/v1/usage 带 device=)。全量 go/flutter 绿。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 08:04:33 +08:00
wangjia	bcc114088c	feat(devices): P3 强制退出 + 清除增强(per-device 凭证吊销) ... 后端:新端点 POST /v1/me/devices/{uuid}/logout(ForceLogout:吊销该设备会话+ 丢 Redis JTI,设备留列表)。DeleteDevice 增强:先吊销会话再删设备(FK ON DELETE CASCADE 清理会话行)+ 按 dp_uuid 吊销数据面凭证。CredentialRevoker 接口改 per-device RevokeDevice(dpUUID),由 nodes.Service 实现(查 connect_credentials 持有节点→推 CommandTypeRevoke + 删凭证行),main 注入替 NoopRevoker;devices 注入 SessionPort/JTIRevoker。修 SQLite 跨连接死锁(会话吊销移到 delete tx 之前)。 migration 000016 sessions FK 加 ON DELETE CASCADE。 客户端:account_api.forceLogout + devicesProvider.forceLogout(UI 留 P6)。 测试:ForceLogout(吊销会话+JTI+设备保留+403/404)+ DeleteDevice(级联+按 dp_uuid 吊销);NoopRevoker 改 dp_uuid;全量 server/flutter 测试绿。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 06:01:41 +08:00
wangjia	c0c4b94e29	feat(devices): P1 设备注册打通 —— 登录/注册即写 devices 表 ... 后端:auth.Service 加 DeviceMeta + DeviceRegistrar 接口(consumer-side 解耦), Login/Register 成功签发后 best-effort 注册设备(不强制设备上限,避免免费档重装 churn 锁死用户);handler 加 device 请求体;main 用 authDeviceRegistrar 适配 devices.Service 注入;normalizePlatform 加 linux。 客户端:新 device_identity.dart(SecureKV 接缝 + 稳定 UUIDv4 device_id 持久化 + 名称/平台/版本);弃用硬编码 'mac-001';auth_api login/register + connect 携带 device 元数据。加 uuid + device_info_plus 依赖。 测试:auth 设备注册(触发/best-effort/空 meta) + device_identity(生成/持久/ 读失败不重生成/UUIDv4 形态);normalizePlatform linux=true。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 00:28:13 +08:00
wangjia	0542ff027f	feat(client/nodes): 节点页刷新 — 下拉刷新 + 刷新按钮 + 进页刷新 + 10s 限流 ... - nodesProvider.refresh:10s 限流(下拉/按钮/进页多次触发只打一次远端); 不清空当前列表(后台拉、好了再换,失败保留旧数据),避免进页/下拉闪空 - nodes_page:initState 进页自动刷一次;RefreshIndicator 下拉刷新(移动端); 搜索框右侧 _RefreshButton 点击刷新(刷新中 spinner) servers 页 golden 重生成(搜索行加按钮);CI 闸 golden 未动。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 22:00:26 +08:00
wangjia	8049659660	feat(client): 节点 status=down 在列表置灰+「不可用」+禁选(#7 客户端侧) ... #7 服务端已在 agent 离线时把节点判 down,但客户端 Node 模型没读 status、 列表照常显示。补:Node.status 字段 + 解析 /v1/nodes 的 status;ServerTile/ _NodeGridTile 在 isDown 时 Opacity 置灰 + 末尾「不可用」+ onTap 禁用。全平台 共享(lib/widgets+screens)。up 节点 Opacity 1.0 无变化,golden 不动。加 down 状态 widget 测试。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 21:35:52 +08:00
wangjia	f0832ccfcb	fix(client): 修 pro 会员启动闪广告/统计闪 0 — 加载门覆盖 auth 加载窗口 ... 之前 meLoadingProvider=isLoading&&!hasValue 漏了两段:启动时 auth 异步读 token 期间 isLoggedIn=false → me 同步返回免费默认(广告);token 到后 me 拉真实值时 hasValue 已是免费默认 → !hasValue 不成立、仍不转圈。改为: - meLoadingProvider:auth.isLoading 时转圈;未登录不转;已登录看 me.isLoading - 统计页 loading:auth.isLoading || usageProvider.isLoading 未登录(确定访客)/golden(settle 后)不转圈,golden 不受影响。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 21:12:24 +08:00
wangjia	ea1af967a0	fix(client): 统计页/连接页 加载时整页转圈,先拉数据再渲染(不闪默认态) ... 之前 .valueOrNull ?? 默认 → 数据没到时先渲染默认态(统计 0 / 连接页免费广告), me/usage 到了再跳真实态,闪烁体验差。改为关键 provider 首拉(loading 且无缓存)时 整页 CircularProgressIndicator: - 统计页:gate on usageProvider(30) - 连接页:gate on 新增 meLoadingProvider(me 是常驻 Notifier,只首启转一下) 未登录/golden 场景 me 同步返回默认=不加载,不影响 golden。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 20:17:39 +08:00
wangjia	01ebafc05e	feat(client/stats): 统计页重设计 — 月/周/日周期卡 + 设备下拉 + 两周折线 + 修刷新 ... 布局重做(对照确认稿): - 3 张周期卡(本月/本周/今日),每张 = ↓下行 · ↑上行 · 使用时长(PeriodCard) - 右上设备下拉(_DeviceDropdown,先只挂「全部」;每设备归因打通后填设备名,见 TODO #9/#10) - 柱状图 → 折线图:最近两周(14 天)按天流量(UsageLineChart,CustomPainter 零依赖) 数据源统一 + 修刷新(根治「本月流量冻住」): - 月/周/日 + 折线全从单一源 usageProvider(30) 聚合(取最后 N 天点求和,末点即今日, 避开 UTC/本地日期坑);不再 me.weekly + usage 两条管线 - usageProvider/deviceUsageProvider 改 autoDispose(进页重取)+ 下拉刷新(invalidate) + 刷新连带 meProvider.refresh。后端每 60s 更新,无需更勤 UI 全走 PangolinColors/Text/Spacing token 单源、零硬编码;中英 l10n key 补齐。 widget 数值断言测试(刀1)按新结构重写并通过;统计/连接页 golden 重生成 (非 CI 闸;components/auth 基线未动)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 17:43:14 +08:00
wangjia	76dbdcfa83	test(client): L2 点连接能连上 流程 + ConnectApi 注入(支柱1) ... - connection_provider:加 connectApiFactoryProvider(原内部 new ConnectApi 改成 可注入工厂,支柱1 接缝即接口)——默认行为不变 - test/unit/flow_connect_test.dart:真 toggle → fetchConfig(注入 MockClient 回占位 config)→ bridge.start → statusStream 确认 → on → 再 toggle → off; 验证「非乐观翻转」红线(on 必由 bridge 确认) - 全量 unit/widget 47 全过(重构不破坏) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 12:13:40 +08:00
wangjia	447f3f494e	feat(client/macos): P1 原生隧道——PacketTunnel 系统扩展可加载 + libbox 运行 ... 经长链路排查(同机对照可工作的 Tailscale),修复 macOS 系统扩展 realize 失败(OSSystemExtensionErrorDomain code=4)与 libbox 运行时崩溃,使内嵌 sing-box 的系统扩展能在 macOS 15 上激活并启动隧道。 系统扩展 realize(三个叠加根因): - 扩展自包含:PacketTunnel 加 OTHER_LDFLAGS="" 切断对项目级 CocoaPods 链接 标志的继承(原会把 flutter_secure_storage 链进扩展);Libbox.xcframework 改纯 Link(静态),从 Embed Frameworks 移除冗余内嵌 - bundle 名 = 标识符:PRODUCT_NAME 设为 com.pangolin.pangolin.PacketTunnel - 扩展 Info.plist 补 NSSystemExtensionUsageDescription(网络扩展类别强制要求) - App Group 改 macOS 原生格式 BYL4KQHMTN.com.pangolin.pangolin;NEMachServiceName 以其为前缀;扩展补 network.client/server;get-task-allow=false + 签名加 --timestamp - CFBundleVersion 随构建递增(否则 sysextd 视为同版本不更新) libbox 运行时: - startOrReloadService(options:) 传 nil 致空指针 SIGSEGV → 传 LibboxOverrideOptions() - 默认接口监控阻塞到首个 path 更新再返回,修 "no available network interface" 配套: - scripts/local_test.sh:build/sign/notarize/copy/run 一条龙(Developer ID + 公证) - client/macos/sign_libbox.sh:构建期以 Developer ID 重签内嵌 Libbox - VpnChannel:401 自动刷新 token、详尽 os_log;auth/api 统一走 kApiBaseUrl - docs/macos-sysext-realize-troubleshooting.html:完整踩坑复盘 WIP / 临时(后续清理): - 隧道运行时仍在排查:剥离远程 rule-set 后 sing-box 启动卡点未定位 - 含临时诊断代码:main.swift stderr 重定向、box.log 输出、rule-set 剥离、debug 日志 - api_config 仍指向联调节点,发版前还原 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01JEHzjEcFzvGwgbxT6Wbt6c	2026-06-21 21:18:33 +08:00
wangjia	43b25c8aa0	feat: 国内流量直连分流(geoip-cn / geosite-cn)— #5 ... 国内 IP/域名直连(不走隧道)→ 省流量 + 国内访问快;非国内走代理。 - clientconfig.go: BuildClientConfig 加 ClientConfigOpts{SplitCN,RulesBaseURL}; 开启时 route 加 {rule_set:[geoip-cn,geosite-cn]→direct} + 定义 rule_set (remote .srs,download_detour:direct 直连下载) - rules.go: 控制面静态服务 /v1/rules/{name}.srs(白名单防穿越)——自托管避免 GitHub 在国内被墙的鸡生蛋;客户端反正连控制面,可达性有保证 - nodes.go ConnectNode: 读 ?split_cn → opts;NodeAPI 加 rulesBaseURL (PANGOLIN_PUBLIC_URL);main.go 挂 /v1/rules 路由 + RulesHandler - 客户端: connect_api splitCN→?split_cn=1;connection_provider 传 smartRoute 偏好 - deploy/single-node: 拉 geoip-cn/geosite-cn.srs 到 $DATA_DIR/rules + 设 PANGOLIN_PUBLIC_URL/PANGOLIN_RULES_DIR 验证:go test(splitCN 开/关渲染 + RulesHandler 白名单/404)+ flutter analyze + shellcheck;不需要节点。订阅链接暂用默认 opts、DNS 分流为后续增强。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-19 20:34:00 +08:00
wangjia	aee9ba7b72	feat(client): 登录体验 — 记住邮箱 + 密码显隐 + 7天免登陆 ... 1. 记住邮箱:登录页预填上次邮箱(TokenStore.saveLastEmail,登录/注册成功时存, 退出登录不清除)。 2. 密码显隐:登录/注册密码框加眼睛按钮切换明文(PangolinIcons.eye/eyeOff)。 3. 7天免登陆:RootFlow 改为响应 authProvider——启动时有有效会话直接进主界面; AuthNotifier.refresh() 在服务端拒绝(refresh 过期/超 7 天)时 logout 回登录页, 网络错误则保留会话。会话恢复期间显示极简启动屏。 flutter analyze 0 error;114 tests passed。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-19 06:28:49 +08:00
wangjia	6ee7114ff8	feat(client): P6 设置项落地真实行为(#6 6F,本地部分) ... - settings_provider:三开关 shared_preferences 持久化 + 副作用落地: killSwitch→VpnBridge.setKillSwitch(on:);autostart→桌面原生登录项 (launch_at_startup);smartRoute 持久化为偏好(连接时作 split_cn,见 #5)。 - settings_page → ConsumerWidget,开关接 settingsProvider;协议标签 WireGuard→REALITY/Hysteria2;版本号取 pubspec(package_info_plus)。 - 新依赖:shared_preferences / package_info_plus / launch_at_startup。 flutter analyze 0 error;114 tests passed;settings golden 重生成。 待办:#5 智能分流的 server 端 geoip-cn 下发 + autostart 真机验证(需 release .app)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-19 00:13:41 +08:00
wangjia	ce5155d4ca	feat(client): P5 连接页实时速度 + 连接错误冒泡 UI(#6 6E,并入 #4) ... - vpnStatsProvider:暴露内核 statsStream(上/下行瞬时速率);连接页速度行 下/上行改用实时数据(B/s→Mb/s),不再硬编码 86.4/12.1;延迟用实测节点 ping。 - ConnectionState 加 error 字段;_connect 失败不再静默回 off,而是按语言 冒泡 ConnectApiException 文案;节点未就绪(无 uuid)给出提示并删除旧 1.2s mock 连接路径。 - 连接页 caption 下/桌面 pill 上方显示错误文案(红)。 - 重写 connection_controller_test 适配(无网络:未就绪→off+error)。 flutter analyze 0 error;114 tests passed。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-19 00:09:31 +08:00
wangjia	f20eddad55	feat(client): P4 节点实测延迟/设备/套餐价/兑换/统计接真(#6 6D) ... - latency_probe.dart:并行 TCP 握手实测各节点 per-client RTT(服务端无法代知)。 - nodes_provider:解析 /v1/nodes 的 host/port,后台测延迟回填 Node.ping;智能选择 按实测最小;去掉 8 个伪造演示节点(空列表用中性占位,不再伪造服务器)。 - Node:+host/port/copyWith/pingLabel(未测显示 —);各端 ping 显示改 pingLabel。 - account_screens:PlansScreen 接 /v1/plans(价格 priceLabel + me 标当前档); DevicesScreen 接 /v1/me/devices + 移除 DELETE + last_seen;RedeemScreen 接 /v1/redeem(成功刷新 me,失败显示后端文案)。 - stats_page:周柱接 me.weekly_gb,本月流量/时长接 usage(30),延迟用生效节点实测。 - 顺带补登记早前 log_time.dart 的删除(log.dart 重构遗漏 stage)。 flutter analyze 0 error;115 tests passed;受影响 4 golden 重生成。 本机设备高亮 + 真实 device id 随 P6(device_info_plus)落地。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-19 00:04:25 +08:00
wangjia	bb39b36d84	feat(client): P3 账号/套餐视角/配额接真(#6 6C) ... - account_providers:新增 meProvider(GET /v1/me,登录态变化自动重取)、 plansProvider、usageProvider(family by days)。 - isFreePlanProvider 改为派生自 meProvider.plan(去掉可写演示开关)。 - quotaProvider:总额取 plans free.daily_minutes,今日剩余取 me.quota_today_min (后端已算好);adUnlocked 保留本地态(ad SDK 未接)。 - account_page:邮箱/套餐/到期接 me;删「演示:免费版视角」开关 + kDemoEmail; 协议标签 WireGuard→REALITY/Hysteria2。 - 重写 quota_controller_test 为 provider 驱动;account/quota golden 重生成。 flutter analyze 0 error;113 tests passed。统计页(weekly/月流量/延迟)随 P4 一并接(其均延迟依赖 P4 实测探针)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-18 23:51:28 +08:00
wangjia	ba53a0d478	feat(client): P1 真实数据接入地基(#6 6A) ... - api_config.dart:API 基址单源(消除各处重复 _kApiUrl) - api_client.dart:统一鉴权 HTTP 客户端,401→AuthNotifier.refresh→重试一次, 错误统一 AuthApiException;+ 单测覆盖 401 刷新重试 - 模型 me/device/plan/usage_point(对齐后端 snake_case 契约) - account_api.dart:/v1/me、/v1/plans、/v1/me/devices(列表+删)、/v1/usage、 /v1/redeem、/v1/ads/unlock 封装 - auth_provider:注入 AuthApi + refresh();account_providers 装配 ApiClient/AccountApi - 顺带修复 onboarding 提交遗留的测试 stub(_NullTokenStore 缺 isOnboarded/markOnboarded) flutter analyze 0 error;114 tests passed。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-18 23:32:57 +08:00
wangjia	f3cc2dfc2d	fix(client): 去 dev 旁路 + 修 macOS keychain -34018 [tsk__bm21nctbhWF] ... 1. 去 dev 旁路：删除 auth_screen.dart 中 test@pangolin.dev 预填 + devLogin 跳过后端分支，以及 auth_provider.dart 的 devLogin() 方法。 2. 修 keychain -34018（errSecMissingEntitlement）： 在 DebugProfile.entitlements / Release.entitlements 中添加 keychain-access-groups（$(AppIdentifierPrefix)com.pangolin.pangolinVpn）， 使 flutter_secure_storage 的 Data Protection Keychain API 获得正确 entitlement。 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-16 13:21:38 +08:00
wangjia	fe16f89bc3	feat(client): 账户子页 desktop 内容区下钻（档1） ... - desktop 上套餐选择/兑换购买/设备管理改为内容区下钻（侧栏保留、shell 顶栏带 返回箭头），不再全屏 push 盖住侧栏；mobile/tablet 仍全屏 push - _SubScaffold 加 embedded 参数(true 只返回内容)，PlansScreen/DevicesScreen/ RedeemScreen 透传；NavView 加 devices + kAccountSubViews 集合 - desktop_shell 渲染子页(embedded) + 顶栏 onBack→account；account_page 按 formFactor 选下钻(切 navView)或 push - desktop 整页 golden 补 套餐/兑换/设备 三子页(共 8 页) 测试: flutter test 84 通过(+3 子页 golden), analyze 0 error Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-16 12:36:14 +08:00