49 Commits

Author	SHA1	Message	Date
wangjia	bb5acb6c1e	feat(ds-flow): Phase 4.1 — 清 adaptive_menu 唯一裸 Material 色 ... adaptive_menu.dart shadowColor: Colors.black26(冷黑)→ PangolinColors.sand950 withValues(0.24)(暖近黑,对齐 §5 暖阴影铁律)。UI 层(widgets/screens/shell) 自此零裸 Material 色。flutter analyze 通过。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-08 01:11:11 +08:00
wangjia	0b86138b55	feat(client/update): 更新提示改 jiu 式顶部横条(非强制不再弹窗) ... 按需求去掉居中弹窗,改成不打断的顶部 banner(对照 jiu 黄条): - 非强制更新 → home_shell 顶部 UpdateBanner「发现新版本 vX + 立即更新 + ×」; 「立即更新」App 内下载安装,「×」忽略此版本(banner 隐藏,更新版本会重现) - 强制更新(force_update)→ 仍走不可关闭弹窗 showUpdateDialog - 忽略状态改 dismissedUpdateVersionProvider(按版本号,响应式);去掉 notifier 的 _dismissed - 设置页「检查更新」有更新时:清忽略版本→banner 显示 + toast,不再弹窗 - 新增 6 语「立即更新」文案。flutter analyze 仅 2 个既有 withOpacity info Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013nMthbVEmQquxBRKb9Fj8u	2026-07-07 19:19:05 +08:00
wangjia	c723bdd53e	feat(client/update): 启动自动检查 + App 内下载安装(不走浏览器) ... 参照 jiu 补齐,但比 jiu 多做了 Android 原生安装(jiu 的 App 内下载仅 Win/mac): - 启动自动检查:update_provider 改 AsyncNotifier,build() 延迟 3s 首查 + 每小时 轮询;home_shell watch 拉起、listen 弹更新框;_dismissed 防反复弹(轮询重置); 强制更新走不可关闭弹窗。设置页「检查更新」改 forceCheck()。 - App 内下载(core/update/app_updater.dart,http 流式带进度框,不再 launchUrl): · Android:下 APK → open_filex 拉起系统安装器(+ REQUEST_INSTALL_PACKAGES) · Windows:下 exe → Process.start(detached) → exit(0) 覆盖安装 · macOS :下 zip → open 解压 + 访达显示,提示手动拖入(带系统扩展不自动 swap) · iOS :降级外链(TestFlight/App Store) 失败降级浏览器下载。新增 6 语更新进度/失败/提示文案。 - 依赖 open_filex；flutter analyze 仅 2 个既有 withOpacity info。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013nMthbVEmQquxBRKb9Fj8u	2026-07-07 17:09:29 +08:00
wangjia	617b43083d	feat(client/i18n): B1 硬编码文案 6 语化 + B2 语言持久化 ... B2 持久化:localeProvider 由 StateProvider 改 StateNotifier(LocaleNotifier), 默认英文,选择存 shared_preferences(key pg_lang),重启保留;新增 appTextFor(lang) helper 供非 Consumer 场景复用。两处切换 .state= 改 .set()。 B1 硬编码 UI 文案 6 语化(AppLangMisc 扩展,exhaustive switch 不会漏): - 不可用 / 流媒体优化 / 节点未就绪 / 连接失败 / 加载失败 / 暂无设备 / 改邮箱 - 相对时间(刚刚/X分钟前/…)relativeTime(Duration) - 修 auth_screen 错误消息 bug:原 _errorZh 永远显示中文(连英文用户都中招)→ 按当前语言取 messageZh/En(非中文显英文) 仍回退英文(服务端数据,需服务端多语字段):节点/套餐名(nameZh/nameEn)、 API 错误消息(messageZh/En)。flutter analyze 仅 2 个既有 withOpacity info。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013nMthbVEmQquxBRKb9Fj8u	2026-07-07 14:32:13 +08:00
wangjia	6277e86d0f	feat(client): SSO 用户中心按钮 + 自动更新检查(镜像 jiu) ... SSO: web_launch.openWebUserCenter → POST /v1/auth/web-ticket → 打开 app.yanmeiai.com/sso?t=…; 设置页加「用户中心(网页)」入口。自动更新: update_provider 查 /version 语义比对 + update_dialog 「发现新版本」;设置页「检查更新」由空 onTap 接上。加 url_launcher(原缺)。flutter analyze 通过。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013nMthbVEmQquxBRKb9Fj8u	2026-07-07 00:13:50 +08:00
wangjia	a274cc40c8	fix(client): 额度卡「今日剩余」标签不再被省略 + 短「免费版」标签(1.0.45+46) ... 连接页额度卡头部一行放不下「今日剩余 X 分钟 + 免费版·每日10分钟」时,此前 Flexible 落在标签上,导致「今日剩余」被挤成「今日…」。改为:标签固定绝不省略,数值作最后收缩项; 右上角标签缩短为「免费版」(每日额度由卡片本身「今日剩余 X 分钟」表达,不再挤进胶囊)。 新增 planFreeTag l10n(zh 免费版 / en Free),quotaFree 仍保留供账户页 plan_badge_card。 golden 基线(quota_low/exhausted)在 Linux 权威环境重生成。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-02 01:40:50 +08:00
wangjia	b461a476a2	feat(client): 免费版连接倒计时 + 到点切断 + 灰按钮 + 看广告加时(#21 前端) ... 四端共享 Dart 实现,配合 #21 后端账户级卡控: - me.dart: 加 quota_cap_min(当日总额度 = daily + 看广告 bonus,进度条分母)。 - quota_provider: total 取 quotaCapMin;isExhausted;markExhausted(倒计时归零本地置耗尽 + 登录态拉 me 校准);watchAd() async 调 /ads/unlock(占位 ad_token=uuid)→ 刷新 me,返回 granted。 - connection_provider: 连接时锁定 _freeRemainingSec(会员 null 不倒计时);复用 elapsed 计时器 每 tick 算 freeCountdown,归零 → _onFreeQuotaExhausted(主动切断不报节点异常 + markExhausted); 倒计时用墙上时钟(后台漏跳回前台补上、准时切);连接遇后端 QUOTA_EXHAUSTED 兜底置耗尽。 - connect_button: enabled/onDisabledTap —— 额度耗尽 off 态灰化(锁图标),点击弹加时。 - quota_card: 三态(连接倒计时 mm:ss / 未连接剩余分钟 / 耗尽今日已用完);移动「看广告加时」、桌面「升级会员」。 - ad_reward_dialog(新): 移动端占位广告(播放中→3s→加时→奖励);桌面版硬 10 分钟提示去移动端/升级。 - l10n(zh/en): 倒计时/已用完/看广告加时/占位广告/桌面升级 双语。 - 测试: quota isExhausted/markExhausted;连接倒计时归零自动切断+置耗尽(注入时钟); 额度卡三态 widget;/me 契约含 quota_cap_min;golden 更新(Linux 权威基线 quota_low/exhausted)。 - 文档: docs/free-quota-ad.html + 登记 docs/index.html。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-02 00:33:21 +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	d0d39c93f6	fix(client): 设备列表离线时间改用 last_seen「最后在线」(原 last_login 不准) ... 设备列表对离线设备显示「最后登录 X 前」,取的是 last_login(会话创建那一刻)。一直在线 的设备断开后会错显成登录时间(如 13 小时前),与实际「最后活跃」不符。改用 last_seen (连接/用量上报/~15s 会话轮询都会刷新),标签相应改为「最后在线」/「Last online」。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 22:30:43 +08:00
wangjia	328d34a320	fix(client): 「我的」页加「设置」入口(我的设备下面)——iPad 竖屏/手机可达设置 ... iPad 竖屏回落 mobile 底 Tab(无侧栏),设置入口够不着。在账户页「我的设备」下面加一行 「设置」→ 下钻 SettingsScreen(复用桌面 SettingsPage + 移动返回栏)。与「联系我们」一致: desktop/tablet 侧栏 + 账户页都可进。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 21:48:54 +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	277d1c6e97	feat(client): toast 限定主显示区/自适应宽/上限80%/超长多行居中(1.0.26) ... 按真相源新规:toast 改为自定义 Overlay 实现(widgets/pangolin_toast.dart),完全控制布局—— 不覆盖左侧栏(left=侧栏宽 desktop204/tablet232/mobile0)、宽度自适应内容上限主区80%、超长文本 多行、主区内水平居中贴底、淡入轻起;仍走语义 token 明暗适配。自动连接改用 showPangolinToast。 同步 design/CONTRACT.md §2 toast 规格(canonical=showPangolinToast)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 19:50:33 +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	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	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	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	c550eea5d8	feat(client/auth): 登录/注册页 Enter 键导航与提交 ... 登录:邮箱框回车 → 跳到密码框;密码框回车 → 直接登录(校验条件同主按钮)。 注册:邮箱框回车 → 发送验证码并聚焦验证码框;验证码满 6 位回车 → 进入设密码步 并聚焦密码框;密码框(≥6 位)回车 → 直接注册。 经 TextField.onSubmitted + FocusNode.requestFocus 实现;桌面端回车即触发。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 22:44:34 +08:00
wangjia	25e8330e3b	fix(client): 修聚焦时输入框橙边漏出错位/被裁(登录·注册·搜索·兑换码) ... 主题 inputDecorationTheme 设了 focusedBorder: OutlineInputBorder(accent)， 而登录/注册的邮箱·密码·验证码、节点页搜索框、兑换码框这几处的 TextField 只写 border: InputBorder.none、未覆盖 focusedBorder —— 聚焦瞬间主题的橙色 OutlineInputBorder 漏到内层 TextField 上，与外层自定义容器圆角错位/左右被裁。 统一加共享 kBareInput 装饰(pangolin_theme.dart)关掉所有边框状态泄漏， 四处替换。只压边框、不动 filled/fillColor —— 未聚焦态外观与改前一致， 不动 golden；聚焦指示仍由外层容器自己的 Border.all(accent) 负责。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 22:21:50 +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	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	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	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	ac0fc774cb	Merge branch 'main' into feature/windows	2026-06-22 14:17:19 +08:00
wangjia	322d806876	fix+build(client/windows): 复查修缮——一键构建脚本 + 修 README dart-define 漏项 + 清 lint ... - 新增 client/windows/build.ps1：拉内核→带 --dart-define 构建→出安装包一键串联， 规避 Release 漏 --dart-define 导致默认连 localhost、登录「网络请求失败」的坑。 - README：Release 命令补回 --dart-define 并加显式警告，指向一键脚本。 - 清 4 个 lint warning：desktop_vpn_bridge 多余 cast→pattern match、去多余非空断言； nav_sidebar 删未用 import；vpn_bridge_mock 加 killSwitchEnabled getter。 - 同步 window_manager/tray_manager/screen_retriever 插件注册生成文件(win+macos)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-22 14:17:13 +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	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	9de3a6c743	feat(client): 登录/注册页重设计(居中卡片 + 暖光晕) ... - auth_screen.dart 整体重排:暖色径向光晕背景 + 居中卡片;hero 用 clay 渐变 app-icon(带光晕)+ 品牌 + 标语;胶囊分段 tab(滑块)替下划线;输入框聚焦态 (accent 边 + ring 光环);主按钮微光;进入错落淡入动效。全部走 token。 - 注册第二步:已验证邮箱胶囊 + 「改邮箱」返回 + 设密码;验证码框无占位点。 - 逻辑零回归:登录/注册两段式、发码、邮箱预填、密码显隐、错误提示全保留。 - design/preview/auth_redesign.html:HTML 视觉原型(评审用,不进构建)。 flutter analyze 0 error;114 tests passed(auth 不在 golden 集,无 golden 变化)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-19 08:10:33 +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	f35bbea0a0	fix(client): 连接后延迟用内核 urltest 实测 + 侧栏套餐到期日接真 ... - 延迟:TCP 探针在隧道开启时会被路由进隧道而测不到(显示 —)。改为连接后 (phase==on)取内核 statsStream 的 urltest delayMs 最小正值(代理真实 RTT), 未连接时仍用节点 TCP 探针。连接页 _SpeedRow/_NodePill/_CurrentNodeCard 与统计页平均延迟统一此口径。 - plan_badge_card(侧栏)接 me.expiresAt 显示真实到期日(原只显示「有效期至」 无日期);account_page 之外漏改的最后一处。 flutter analyze 0 error;114 tests passed。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-19 00:44:46 +08:00
wangjia	93ec421c41	fix(plans): /v1/plans 500 修复 — plans 表无 name_zh/name_en 列 ... ListPlans 历来 SELECT name_zh/name_en,但 plans 表从未有这两列(各迁移/seed 均无)→ 该端点一直 500(无 live 测试故未暴露)。改为不查名称列(套餐名是 UI 文案,客户端 PlansScreen 按 code 取 l10n:free/pro/team)。价格等真实字段保留。 已在节点实测:/v1/plans 200,返回 free ¥0 / pro ¥25 / team ¥99。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-19 00:32:40 +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	d341c1c6e5	fix(client/auth): 验证码字段去掉点状占位(hintText 改空) ... '······' 占位被误以为是已填/遮蔽;验证码本就明文输入,清空占位更清晰。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-18 09:23:12 +08:00
wangjia	6979411c1d	feat: 档2 接真后端 — mac app 真注册/登录/拉节点 ... dev 本机置备（新增 dev/）： - docker-compose.yml: MySQL :13306 + Redis :16379（避让本机已占的 3306/6379） - run-local.sh 一键: 起容器→openssl 生成密钥(dev/.local gitignore)→migrate→ seed→启动 server :18080(避让 8080)；LogMailer 把验证码打日志 - seed.sql(1 provider + 1 HK 节点)、run-local.md 手册、.gitignore 后端两处修复（本地无 gRPC 场景，注释意图与代码不符的 bug）： - main.go: 无 gRPC 时真正构造 Hub-only nodeSvc(原只建 hub 没赋值)，/v1/nodes 才能挂 - main.go: /me 改 Route 子路由根 Get，修 Get("/me")+Route("/me") 冲突致 404 客户端接真后端： - token_store: MacOsOptions(useDataProtectionKeyChain:false) 修 keychain -34018 - auth_screen: 删 dev 旁路(test 账户内存登录)，所有登录走真 API 验收: 后端 curl 端到端全通(验证码→注册→登录→/nodes→/me)； server go build/vet/test 通过, client analyze 0 + test 84 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-16 13:27:58 +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
wangjia	281a6261fb	feat(client): tablet 外壳 + 视觉 diff 工作流文档 ... - tablet_shell: 侧栏 232·4 项触控(minHeight 48, 字号 15) + 顶栏无主题切换 + 连接页双栏 对照 ui_kits/tablet/tabapp.jsx；home_shell 分发 tablet→TabletShell - nav_sidebar 加 dense 参数(desktop 紧凑 / tablet 触控) - content_top_bar 加 showThemeToggle + titleSize 参数 - tool/visual-diff.md: 截图 diff 工作流(design-distill 工具)+ 实现侧三路径 现状(golden 被 google_fonts 阻塞 / screencapture 受 macOS chrome 限制)+ 推荐 注: tablet 形态在 macOS 桌面平台不触发(只 desktop/mobile)，运行验证需 iPad。 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-16 09:38:18 +08:00
wangjia	4dc4127252	feat(client): 三端布局架构 + macOS 桌面端 + app 图标 ... 三端布局(mobile/tablet/desktop): - core/responsive/form_factor.dart 形态判定 + shell/ 分发器(home_shell→desktop/mobile) - desktop_shell 对照 ui_kits/desktop/dapp.jsx: 侧栏204·6项 + 套餐卡 + 顶栏(标题/状态/主题切换) + 连接页居中单列 - 新增组件 nav_sidebar / plan_badge_card / content_top_bar / bottom_tab_bar - 新增一级页 contact_page / settings_page; navigation_provider(NavView) - 删除旧 widgets/home_shell.dart(逻辑迁入 shell/) macOS 桌面端: - 窗口默认 920×600 + 最小 720×560(MainFlutterWindow.swift) - app 图标替换为穿山甲(AppIcon.appiconset 全套, 由 app-icon.svg 渲染) 其余(本会话): - Phase2 接线: auth_api/token_store/auth_provider/vpn_bridge_provider + 真实 connection/nodes - lucide_icons 兼容补丁(packages/lucide_icons_patched) 修复 IconData final 报错 - 测试修复: connect_passthrough(UTF-8) / harness / golden @Skip - l10n 新增 settingsTitle Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-16 09:23:20 +08:00
wangjia	bf1717a369	merge: 控制面联调 M6 [tsk_nuoKSM4Vt-zK] ... # Conflicts: # .gitignore # client/lib/widgets/home_shell.dart # client/lib/widgets/server_tile.dart # client/pubspec.yaml	2026-06-13 17:32:26 +08:00
wangjia	6f6cb97509	merge: Flutter 逐屏还原 + iPad 断点 [tsk_gpPXi-icyeOE] ... # Conflicts: # client/lib/widgets/connect_button.dart # client/lib/widgets/home_shell.dart # todo/todo.html # todo/todo.json	2026-06-13 17:30:36 +08:00
wangjia	c84b6ea7da	merge: maestro/tsk_iP5-_Ztq5THx [桥接 API 面 Channel 契约 + 三端原生骨架] [tsk_rcNKc3GQHBUd] ... 合并冲突补救：原分支从 merge base 7871512 分叉，仅修改 client/ 目录， 与 main 新增的 server/(apierr/idgen/CONVENTIONS.md) 完全不重叠， 无真实文件冲突，手动应用 feature branch 的全部 client/ 改动。 client 侧新增： - lib/bridge/vpn_bridge.dart — Dart↔原生通道契约（冻结） - lib/bridge/vpn_bridge_mock.dart — 假内核，UI 联调用 - lib/bridge/kernel_process.dart — 桌面子进程管理接口 - ios/PacketTunnel/{Info.plist,PacketTunnelProvider.swift} — NEPacketTunnel 骨架 - ios/Runner/VpnManager.swift — NETunnelProviderManager 封装 - android/.../PangolinVpnService.kt — VpnService 骨架 - android/.../VpnEventBus.kt — Application 级状态总线 - test/bridge/vpn_bridge_mock_test.dart — 桥接层单元测试 client 侧修改： - android/.../MainActivity.kt — 注册三通道（MethodChannel + 2×EventChannel） - android/.../AndroidManifest.xml — 声明 FOREGROUND_SERVICE + PangolinVpnService - ios/Runner/AppDelegate.swift — 注册通道 + VpnManager 初始化 - ios/Runner/Info.plist — 新增 NSVPNUsageDescription - ios/Runner.xcodeproj/project.pbxproj — 添加 PacketTunnel extension target - lib/widgets/connect_button.dart — VpnStatus 迁移到 bridge/vpn_bridge.dart - lib/widgets/home_shell.dart — error 状态 UI 分支补全	2026-06-13 14:58:38 +08:00
wangjia	f97ae8186b	feat(client): Flutter 逐屏还原 + iPad ≥900 断点 (tsk_gpPXi-icyeOE) ... 对照 design/ui_kits mobile+tablet 原型逐屏补齐 Flutter 客户端: - l10n 资源层(strings_zh/en,单显)+ Riverpod 状态层(连接状态机/免费额度/ 节点选择/语言/主题),UI 与数据解耦,mock 数据接 API 不动 UI。 - 连接键严格三态(off 虚线轨道环 / connecting 旋转弧 / on 满环+计时+光晕), 状态来自 connectionProvider,点击只派发事件——禁止乐观显示。 - 节点页置顶「智能选择」推荐卡(clay 渐变 zap + 推荐胶囊,默认选中); 免费额度卡(剩余分钟+进度条 ≤3 分钟切 warning + 看广告解锁变绿)。 - Tab 左右滑动切换(手势竞技场仲裁,子页滚动不误触发,200ms 方向感知滑入)。 - iPad/宽屏 ≥900 LayoutBuilder 切侧栏分栏(导航行高 ≥48,连接页双栏/节点双列网格), 复用同一批原子组件,不 fork 页面。 - 语义 token 零硬编码;文案全部走 l10n;套餐数字对齐 §7;无支付表单/emoji 国旗。 - CI 红线词扫描扩展到 client/lib;新增 Flutter analyze+test CI 任务。 - 测试:连接状态机/额度/节点单测、连接键三态与卡片组件测试、 golden(连接键三态/推荐卡/额度卡 × 明暗)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-13 14:32:36 +08:00
wangjia	bd8f974a25	feat(M6): 控制面联调 — mock connect server + 客户端 ConnectApi 透传 ... tsk_nuoKSM4Vt-zK ## 服务端（server/cmd/mockserver） - `main.go`（79 行）：独立 mock HTTP server，实现 POST /v1/nodes/:id/connect - 路径/请求体/响应体字段名与 §3.1 契约逐字一致 - Bearer token 鉴权（-token 参数，空值跳过，不入库） - 缺少 device_id → 400；未授权 → 401；非 POST → 405 - 返回完整 sing-box config JSON（tun + REALITY/Hy2 outbound + urltest + route/dns） - 注：mock 联调；待 #5/#6 真实 connect 接口就绪后替换 - `main_test.go`：6 项单测，覆盖 §3.1 结构校验、auth、method、path ## 客户端（client/） - `lib/services/connect_api.dart`：ConnectApi 类 - fetchConfig(nodeId, deviceId) → 原始响应体字符串（不做任何修改） - 错误路径：HTTP 非 200 / 超时 / 非法 JSON → ConnectApiException（含双语 message） - `lib/services/vpn_bridge.dart`：VpnBridge stub（M6 联调，libbox 绑定待 11C） - start(configJson) 原样存储，不修改；stop() 清空 - `lib/widgets/home_shell.dart`：_toggle/_pick 替换为真实 API 流程 - ConnectApi.fetchConfig → VpnBridge.start（透传，无中间变换） - 错误路径：ConnectApiException → SnackBar，status 回 off，无残留半开隧道 - API URL/token/deviceId 由 --dart-define 注入（不入库） - `lib/widgets/server_tile.dart`：ServerInfo 新增 nodeId 字段 - `pubspec.yaml`：新增 http: ^1.2.1 依赖 - `test/connect_passthrough_test.dart`：4 项透传断言单测 - 核心：fetchConfig 返回字符串 === VpnBridge.start 接收字符串（逐字节相等） - 空格/格式原样保留（不经 jsonEncode 重序列化） - HTTP 错误、非法 JSON 错误路径覆盖 ## 运行方式（M6 联调） ``` # 启动 mock server（无 auth） go run ./server/cmd/mockserver -addr :8081 # 启动客户端（指向 mock server） flutter run \ --dart-define=PANGOLIN_API_URL=http://localhost:8081 \ --dart-define=PANGOLIN_API_TOKEN=dev-mock-token \ --dart-define=PANGOLIN_DEVICE_ID=demo-device-001 ``` Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-13 14:16:29 +08:00
wangjia	526e7f2f33	feat(tsk_iRa5iBC4v7Tu): Flutter 客户端工程搭建(演示态) ... 基于 design/flutter/ 起步包在 client/ 下建立 Flutter 工程： - pubspec.yaml：flutter_svg / lucide_icons / google_fonts 依赖； SVG 资产注册；字体由 google_fonts 运行时加载，无需本地 ttf - lib/pangolin_theme.dart：完整设计令牌（色阶 / 间距 / 圆角 / 动效 / 文字阶），PangolinText 改用 GoogleFonts getter， PangolinTheme.light / .dark 开箱即用 - lib/main.dart：runApp + 明暗主题 + 登录 → 引导 → 主框架 RootFlow - lib/widgets/：全套组件雏形 pangolin_icons Lucide 图标映射 pangolin_button 胶囊按钮四态 country_code 国家码块 + 信号条 status_pill 色点胶囊 connect_button 核心连接键三态（off/connecting/on + 动画） server_tile 服务器列表行 plan_card 套餐卡（专业版渐变高亮） auth_screen 登录 / 注册（邮箱验证码 + 设密码） onboarding_screen 首次引导 PageView（3 屏可滑动 + 进度点） home_shell 底部 4 Tab（连接/节点/统计/账户 + 状态机） account_screens 套餐选择 / 设备管理 / 兑换 / 联系我们 pangolin_logo PangolinMark / BrandLockup / AppIcon（SVG） - assets/：logo-mark / logo-mark-white / logo-wordmark / app-icon（SVG） - android/：Kotlin 主 Activity + Manifest + Gradle 配置 - ios/：Runner.xcodeproj + xcscheme + Podfile + AppDelegate + storyboard 运行方式（cd client/）： flutter pub get && flutter run Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-13 02:15:42 +08:00