64 Commits

Author	SHA1	Message	Date
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	00bec95255	chore(client): 清理 tablet golden 旧命名孤儿文件(#11) ... 删除 5 个旧命名(无 theme/lang 后缀)且无任何测试引用的 tablet golden: tablet_account/connect/connect_dark/servers/stats.png。当前 tablet_pages_golden_test 的 命名矩阵是 tablet_<view>_{light_zh,light_en,dark_zh}(12 个),孤儿是早期命名残留。 顺手清掉 test/golden/failures/(gitignored 的失败产物)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 22:47:39 +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	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	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	6249d5b2ea	refactor(client): 抽公用 PangolinFieldBox 统一输入框 + 根治填充两色接缝 ... 根因:主题 inputDecorationTheme 设了 filled:true/fillColor:bg,自定义容器里嵌 TextField 时内层自铺 bg 底,与容器底色(搜索框 bgSubtle / 登录 surface)不一致 → 两端一色中间另一色接缝(节点搜索框最明显,登录/兑换框也有隐患)。 - kBareInput 加 filled:false:内层 TextField 不再自铺底,底色统一交给外层容器。 - 新增 widgets/pangolin_field.dart:PangolinFieldBox(圆角容器 + 底色 + 可选描边/ 聚焦光环 + 标签 + 前置图标 + 后置 widget)+ bareInputDecoration() 助手。 - 三处输入框统一改用:节点搜索框、登录/注册字段(_field)、兑换码输入框。 - 重生成 auth_login(dark/light)+ desktop_redeem golden(均人工核对外观正确)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 12:29:53 +08:00
wangjia	ccb7a9bfe7	fix(client): 节点搜索框两色接缝 —— TextField filled:false 让外层 bgSubtle 统一铺底 ... 搜索框是双层:外层容器 c.bgSubtle(灰)+ 内层 TextField 继承主题 filled:true/ fillColor:bg(页面底色)。两色不一致 → 图标与左右内边距露出 bgSubtle、中间是 bg, 出现两端灰中间另一色的接缝。kBareInput 当初只压了边框、没动 filled(注释写明为避免 改 golden),遗留此泄漏。搜索框 decoration 加 filled:false,底色统一交给外层容器。 重生成 4 个节点页 golden(desktop/tablet × dark/light/zh/en)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 12:10:32 +08:00
wangjia	ddf8b1d4d8	feat(client): 智能选择卡也走切换确认(防误触) ... 把节点卡的"已连接时切换先弹确认"逻辑抽成 _onSelect(code,name),节点卡与智能 选择卡共用。点智能选择卡:未连接直接选,已连接/连接中弹确认("切换到「智能选择」?")。 node_connect_confirm_test 增"已连接点智能选择卡弹确认→取消不切"用例。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 11:52:11 +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	73da0bc9a2	feat(client): 节点列表防误触 — 已连接时切换节点先弹确认 ... 未连接(off)点节点直接选→跳连接页(无破坏性,不弹框);已连接/连接中点其他 节点会断开重连,先弹确认框(标题含目标节点名),取消则维持当前连接。新增 nodeSwitchTitle/Body/Confirm 三条文案 + node_connect_confirm_test 覆盖 off/on 两路。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 10:11:20 +08:00
wangjia	6788501e4a	feat(client): 通用自适应弹出菜单(按屏幕位置上/下弹,不挡触发器) ... 新增 AdaptiveMenuButton:GlobalKey 量触发器矩形,据上下剩余空间决定向下/向上 弹出、右对齐裁剪到屏内,Overlay 全屏 barrier + 淡入缩放动画。「我的设备」⋯ 菜单由 PopupMenuButton 换成它(重命名 + 强制退出/清除),修正小屏被遮挡问题。 devices_screen_test 同步改用 AdaptiveMenuButton 触发器断言。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 10:11:20 +08:00
wangjia	880fa32793	fix(devices): 本机也显示 ⋯ 菜单(只「重命名」)—— 修单设备无法改名(1.0.14) ... 之前 ⋯ 菜单对本机隐藏,而用户唯一设备就是本机 → 根本点不到、改不了名。 改:本机显示 ⋯ 菜单但只含「重命名」(自我强制退出/清除无意义,仍只对他设备)。 测试:本机菜单只有重命名断言;全量 flutter 绿。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 09:49:09 +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	8a1db07d19	fix(devices+stats): /v1/me/devices 401 修复 + 设备下拉接已登录设备 + 版本号 ... ① 「我的设备打不开」根因:devices handler 读 devices.CtxKeyUserID,而鉴权中间件 把 user id 写在 auth 的 key 下(类型不同→取不到)→ /v1/me/devices 一直 401。 改 handler 用 auth.UserIDFromContext(与 accountAPI 等一致)。 ② 统计页设备下拉改读 devicesProvider(已登录设备),不再只列有用量的设备 → windows 设备现在会出现。 ③ pubspec version 1.0.2+3 → 1.0.11+12,client_version 不再显示陈旧的 v1.0.2。 测试:devices_screen + stats_device_filter widget(下拉读 /v1/me/devices)+全量绿。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 08:37:11 +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	58526b09e6	feat(client): P6 DevicesScreen 重做 + DevicePlatform 枚举 ... 回应「状态码用枚举更好」:新增 DevicePlatform 枚举(线格式 fromWire 解析, UI 只碰枚举,穷尽 switch),Device.platformKind getter;platform 图标按枚举 switch。 DevicesScreen 按 §7 视觉稿重做:行内 名称+「本机」标 / 平台·客户端版本·最后登录 / 在线绿点光晕·离线灰点 + 行尾 ⋯ 菜单(强制退出 / 清除登录信息·危险红)+ 危险二次 确认弹窗;本机行不显示 ⋯(不自我踢)。l10n 新增在线/离线/最后登录/从未登录/强制 退出/清除登录信息/取消 + 确认文案(中英);「当前设备」改「本机」。 新图标 moreVertical/trash/alertTriangle。localDeviceIdProvider 供本机判定。 测试:devices_screen widget 3 例(本机标+在线/离线+版本渲染 / ⋯菜单→强制退出→ 确认→POST logout / 清除→DELETE);全量 flutter test 58 绿。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 06:10:37 +08:00
wangjia	2f298f0a0a	feat(devices): P2 sessions 表 + 在线/最后登录/客户端版本 ... migration 000016(mysql+sqlite,含 down):新增 sessions 表(绑 device+refresh JTI) + devices 加 client_version/totp_trusted_until。devices 唯一键改 + platform CHECK 加 linux(需 SQLite 表重建)拆出后续迁移,降风险。 后端:新 internal/sessions Store(Create/Rotate/Revoke/RevokeByDevice/ LastLoginByDevice);TokenManager 外露 refresh JTI(IssueWithJTI/RefreshWithJTI/ ParseRefreshJTI);auth.Service 注入 SessionStore——登录建会话、刷新轮换、登出吊销; DeviceRegistrar 返回 deviceID;ReportUsage 心跳 touch devices.last_seen(在线判定); devices.ListDevices 经 LastLoginSource 注入返回 online(last_seen<3min)/client_version/ last_login;RegisterIfAbsent 存 client_version。 客户端:Device model 加 online/clientVersion/lastLogin(fromJson 自动解析)。 测试:sessions store 3 例 + ListDevices 在线/最后登录 + device model 2 例 + migration v16;全量 go test/flutter test 绿。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 00:50:24 +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	3785fdf1c1	style(client/shell): 会员卡字体调小,有效期完整显示 ... 有效期行被 chevron 挤得截断。套餐名 12→11.5、有效期 10.5→9.5、chevron 15→14、 间距 10→9,让「有效期 YYYY-MM-DD」完整显示。golden 重生成。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 21:06:06 +08:00
wangjia	2c5e8785c0	fix(client/shell): 「我的」入口改到底部会员卡(非顶部品牌) ... 按反馈纠正:顶部品牌区改回静态;底部 PlanBadgeCard(套餐/会员卡)做成可点 → 打开「我的」,选中态高亮 + 末尾 chevron。桌面/平板页 golden 重生成。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 20:33:30 +08:00
wangjia	b1dd78fddd	feat(client/shell): 侧栏改版 — 我的移到顶部品牌按钮 + 联系放设置下面 ... - 顶部品牌区(logo+穿山甲)做成可点按钮 → 打开「我的」,选中态高亮; 从导航列表移除「我的」项(desktop+tablet) - desktop 导航顺序:…统计 → 设置 → 联系(联系移到设置下面) 桌面/平板页 golden 重生成(CI 闸 components/auth 未动)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 20:24:03 +08:00
wangjia	07f09a1600	feat(client/stats): 两周流量折线图加 Y轴刻度 + X轴日期 + 14个数据点 ... 之前折线太简单(只一条线+末点)。增强 UsageLineChart: - Y 轴:3 条网格 + 左侧 GB 刻度(max/mid/0) - X 轴:隔几天标一个日期(M/D,始终含末点) - 14 个数据点全画出(surface 光晕+accent 实心,末点加大) 传入每点日期(chartDates)。token 色经参数传入(axis=fg3/surface),零硬编码。 统计页 golden 重生成。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 20:12:30 +08:00
wangjia	4f9d2d2cf3	fix(client): 补提交 stats-overhaul 漏掉的 account_api/kernel_process WIP ... 同 device_usage:account_api.dart(deviceUsage/usage 方法)、kernel_process.dart 及对应测试一直未提交,本地有→analyze/test 过,但不在 git→Windows 构建报 「deviceUsage isn't defined」。补齐使提交树自洽可构建。 孤儿组件 device_stat_row/metric_card 已无人引用,不提交。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 17:53:56 +08:00
wangjia	a7c3795e5a	fix(client): 补提交漏掉的 device_usage 模型 + 测试(Windows 构建缺文件) ... device_usage.dart 一直是 untracked(stats-overhaul WIP 漏提交),本地有所以 analyze/test 过,但不在 git → bundle → Windows 构建报「找不到 device_usage.dart / DeviceUsage isn't a type」。account_providers/account_api/golden 测试都引用它,补提交。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 17:51:25 +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	8eb7d04fe1	feat(client): 节点地区图标改国旗(SVG 填满裁切),未知码回退码块 ... CountryCode 由 2 字母码块改为渲染真国旗:country_flags 包按 region 码出 SVG 旗(BoxFit.cover 填满裁切),全平台含 Windows 都显示(emoji 国旗在 Windows 不渲染,故走 SVG)。FlagCode 判定无效码(AUTO/占位/非地区码)时回退原码块; 选中态由 accent 底色改为 accent 边框环。 CountryCode 共享于节点列表/连接页/统计页,故三处节点图标统一变国旗, 对应 tablet_servers/connect/stats + desktop_stats golden 已 Mac 重生成 (这些页非 CI golden 闸;CI 闸的 components/auth 基线未动)。 依赖:country_flags ^3.1.0(解析 3.3.0)。analyze 干净,非 golden 测试全过。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 16:25:48 +08:00
wangjia	60daa6b399	test(client): 刀1 — 统计页「上屏数值对不对」widget 断言(缺口①) ... 闭合最初诉求「统计准不准」的前端那一半:后端记账已 L4 e2e,前端此前只到 解析单测(解析对 ≠ 渲染对)。新测试把真实形态的后端响应(/v1/me·/v1/usage· /v1/usage/devices)经真 ApiClient→AccountApi→provider 链(连带测 JSON 解析) 喂给 StatsPage,断言: - 指标卡:本月流量 ΣgbTotal=3.0、本月时长 Σmin/60=2.0、未连接延迟=节点 ping 42 - 周柱:7 根来自 me.weekly_gb(取唯一值核对) - 分设备:2 行,每行流量/时长正确 注入 MockClient 不打真网络;用 find.byWidgetPredicate 匹配 MetricCard/DeviceStatRow 公共字段,无需改生产代码。改坏期望值已验证转红(非永真)。自动并入 flutter-client job。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 22:59:05 +08:00
wangjia	eb1bd11439	fix(test): 契约测试解耦 stats-overhaul WIP(CI 抓到的真问题) ... CI 暴露:我的契约测试引用了未提交的 stats-overhaul 文件,本地能过(文件在工作区)、 CI checkout 已提交代码就崩: - api_contract_test.dart import device_usage.dart(?? 未提交)→ flutter analyze 报 'Target of URI doesn't exist' - usage/contract_test.go 引用 DeviceUsagePoint/deviceUsageResponse(HEAD service.go/ handler.go 均无)→ go-server 编译失败 摘掉 /v1/usage/devices(DeviceUsage)契约,保留 /v1/me + /v1/usage(已提交)。 待 stats-overhaul 合并后再补 DeviceUsage 契约。 验证:flutter analyze test/contract 'No issues';go vet usage 无错。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 18:13:27 +08:00
wangjia	bb2688cede	test(ci): L3 golden 进 CI(components+auth 子集,Linux 权威基线) ... L3 视觉回归真进 CI(此前卡 docker daemon 未起 + dirty 纠缠;现启 Docker 落地干净子集): - 在 ghcr.io/cirruslabs/flutter 容器重生成 components+auth 的 14 张 Linux 权威基线 (auth_login/connect 三态/quota/smart_card;mac 渲染与 CI Linux 不一致,故钉死 Linux), 容器内 --update-goldens 后无 flag 复跑幂等通过 - ci.yml 新增 golden job(第9个):flutter test components_golden_test + auth_redesign_golden_test - 解耦干净:这俩只 import clean widget;stats-overhaul 的 l10n 改动纯新增(现有键未动) → 渲染不受影响、不裹挟 dirty;tablet/desktop-stats golden 仍耦合 stats-overhaul,待合并后并入 - docs/test-architecture.html:L3 状态更新为「已进 CI(子集)」 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 13:20:55 +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	95fad37989	test(client): L2 登陆/重启续登/登出 流程(真 AuthNotifier) ... 驱动真实 AuthNotifier(非桩),仅在可注入接缝 TokenStore 处换内存实现,覆盖最初诉求: - 登陆:saveTokens → isLoggedIn + 令牌持久化 - 重启续登:新 AuthNotifier 从同一 store 恢复登录态(无需重输密码) - 登出:logout → 未登录 + store 清空,再重启仍未登录 - 3 用例全过 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 12:10:52 +08:00
wangjia	cb6fc25bc9	test(client): L1 数值格式化纯函数单测 + 从 widget 抽出(支柱3) ... - lib/util/format.dart:抽出 formatSpeed/formatDuration(原私有于 connect_page _speed / connect_button _fmt,混在 widget 里没法单测) - connect_page/connect_button 改用公共纯函数(渲染输出不变) - test/unit/format_test.dart:10 用例覆盖速率 B/s→GB/s 各单位边界 + 时长 HH:MM:SS 补零/小时不封顶/取模 60 - 验证:format 10 + widget 8 全过、analyze 无 error/warning Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 12:06:34 +08:00
wangjia	64f96fe018	refactor(api): /v1/me 收敛 expire_at → 只发 expires_at(无 web 用户中心) ... 之前后端同时发 expire_at + expires_at(分别给 app + web 用户中心)。现已无 web 端, 双发是纯冗余,统一只用 expires_at: - account.go:meResponse 删 ExpireAt 字段 + GetMe handler 不再赋值 - client me.dart:fromJson 删 (expires_at ?? expire_at) 别名回退 - 两端契约快照同步:Go meResponse 冻结集去 expire_at(12→11 key)、删 Dart 别名测试 - 验证:go test httpapi 绿、flutter test contract(14)绿、analyze EXIT 0、e2e 全链路绿 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 10:08:50 +08:00
wangjia	dbd183ee00	fix(ci): 修 flutter analyze 闸长期 exit 1(形同虚设) ... 发现:CI flutter analyze 退出码 1(1204 个 info,0 error/warning),其中 1191 来自 第三方 vendored 包 lucide_icons_patched —— 这道闸一直红/无效。 - analysis_options.yaml:exclude packages/lucide_icons_patched/**(去 1191 噪音) - ci.yml:flutter analyze --no-fatal-infos(info 是建议级不该硬挡 merge; error/warning 仍致命)→ analyze EXIT 0、闸真正可用 - 顺手清 11 个 clean 文件 info:auth_api 删 >>>AUTHLOG 调试 print 残留(+unused sw)、 account_page/plan_card withOpacity→withValues、vpn_bridge where(is Map)→whereType、 测试文件删多余 import + final→const - 剩 2 个 info 在 stats-overhaul dirty 文件(stats_page/device_stat_row),留其合并清 - 验证:flutter analyze --no-fatal-infos EXIT 0(1204→2)、flutter test 48 全过 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 07:39:14 +08:00
wangjia	149aa90cfa	test(contract): 第2刀b Dart 契约快照(stats + /v1 API 字段面冻结) ... 支柱 2(契约单源)守门 — 堵 mac-stats-0 一类跨进程契约悄悄分叉: - test/contract/stats_contract_test.dart：冻结 pangolin/vpn/stats payload 字段面 + status 四值,改契约即测试红、逼同步原生产出端 + 文档 - test/contract/api_contract_test.dart：冻结 /v1/me、/v1/usage、 /v1/usage/devices 的 snake_case 字段面 - ci.yml：flutter job 测试纳入 test/contract;本地 15 用例全过 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-24 23:32:00 +08:00
wangjia	e25649cd27	feat(client/ios): iPad tablet 正式适配——断点≥900 对齐设计源 + tablet golden 回归闸 ... - form_factor 触屏 tablet 阈值 600→900,对齐 design/ui_kits/tablet(1180×820 横屏 侧栏):iPad 横屏/12.9″竖屏走侧栏,标准/11″竖屏回落 mobile 底 Tab,避免双栏挤压 - form_factor_test 补全断点边界(900/899)与各 iPad 尺寸用例 - 新增 tablet_pages_golden_test:四视图×明暗×中英 12 张 golden,注入演示数据 (6 节点/周流量/30 天用量)让 2 列网格与周柱满渲染,作回归闸 - design/CONTRACT.md:tablet 像素契约(取自 tabapp.jsx)+ 逐屏验收清单 - 真机 iPad mini 6 视觉签核通过;141 测试全绿 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-23 10:00:14 +08:00
wangjia	99695e8861	test(client): 锁定 form_factor 断点(iPad→tablet, iPhone→mobile)	2026-06-22 20:51:34 +08:00
wangjia	6fc032bac8	feat(client): 字体改本地打包(拉丁全量 + Noto Sans SC GB2312 子集) ... 生产 PangolinFonts.useBundled=true,离线可用,不再运行时拉 google_fonts; 中文经 fontFamilyFallback=[Noto Sans SC] 兜底,子集外字符再兜系统 CJK 字体。 - 拉丁:Sora/Manrope/JetBrains Mono 静态权重(复用 test/fonts)。 - 中文:Noto Sans SC 变量字体 instance 到 Regular + subset 到 GB2312 6763 字 (单权重,粗体引擎合成),client/fonts 合计约 3.4MB。 - tools/fonts/make-cjk-subset.sh 可复现生成(GB2312 字表无需联网)。 - 新增 test/unit/fonts_test.dart 锁定接线;golden 因 notdef 占位字形微调已更新。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-22 07:48:21 +08:00
wangjia	7827660a36	fix(client): 登录页 tab 滑块塌陷 + 滚动弹性(design-distill 校准) ... - 胶囊 tab 活动滑块高度塌成 0(FractionallySizedBox 缺 heightFactor)→ 活动态 不可见、和背景糊一起。补 heightFactor:1.0,滑块正常填满。 - 列表无弹性回弹:SingleChildScrollView 改 ClampingScrollPhysics,大窗口放得下 就不滚(无上下拖动/滚动条),仅窗口过矮才滚。 - 加 auth_redesign golden(900x700 明/暗),按 design-distill 截图 diff 校准: 与原型 design/preview/auth_redesign.html 对比,结构/位置/尺寸零偏移 (残余差异为 headless 测试缺 CJK 字体的豆腐块,真 app 字体正常)。 flutter analyze 0 error;测试通过。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-19 08:25:56 +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