313 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
wangjia	0bc39ebeba	docs(claude): 更新节点信息 racknerd → pangolin1(已迁移) ... 线上节点已从 RackNerd 107.172.55.251(别名 racknerd)迁到 pangolin1 103.119.13.48(Debian12,2核/~1GB/2G swap),单机跑 server+agent+sing-box。旧别名/IP 标注作废。deploy 示例命令同步改名。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 22:54:11 +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	7dcbe04934	build(client/windows): 版本 bump 1.0.9 → 1.0.10(输入框聚焦橙边修复) ... Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 22:33:52 +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	1adf088c68	build(client/windows): 版本 bump 1.0.8 → 1.0.9(节点页刷新) ... Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 22:00:26 +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	51c171d815	build(client/windows): 版本 bump 1.0.7 → 1.0.8(节点 status 渲染等) ... Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 21:47:54 +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	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	e27bbbd384	build(client/windows): 版本 bump 1.0.6 → 1.0.7(我的入口纠正) ... Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 20:33:30 +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	09eab3b3b6	build(client/windows): installer 版本 bump 1.0.5 → 1.0.6(折线图/加载转圈/侧栏改版) ... Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 20:26:56 +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	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	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	ed22965d18	chore(todo): 合并本地 main 的 2 个 open 待办(golden 清理 + 协议选择) ... Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 19:28:08 +08:00
wangjia	0698dc6138	chore(todo): 更新 TODO 看板(stats-overhaul 收口期新增条目) ... Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 18:14:05 +08:00
wangjia	1a6eb7ac9a	docs(stats): stats-overhaul 计划/测试清单 + index 登记 ... - stats-overhaul 实现计划(md 真相源 + html 阅读版) - 功能×测试覆盖清单(feature-test-coverage-checklist.html) - docs/index.html 登记上述文档 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 18:13:49 +08:00
wangjia	b98ad9dce4	chore(design): stats-overhaul 设计 WIP — CONTRACT + ui_kits 统计页规格 ... stats-overhaul 的设计稿(CONTRACT.md + mobile/tablet/desktop ui_kits)。 注:这批 ui_kits 描述的是统计页「上聚合·下分设备」原方案;统计页后续已 重设计为「月/周/日 周期卡 + 设备下拉 + 两周折线」(见 client/lib/screens/ stats_page.dart)。设计稿与新页布局有出入,待更新到新布局(单列 TODO 跟踪)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 18:13:49 +08:00
wangjia	bf84492eef	feat(client/native): stats-overhaul Phase1 — 四端实时统计采集端 ... 各原生侧把 libbox/Clash 的实时上下行/延迟经冻结的 pangolin/vpn/stats channel 生产真实帧: - iOS/macOS 新增 StatsClient.swift(LibboxNewCommandClient,statusInterval 1s, uplink/downlink/总量 + urltest 延迟映射契约字段),VpnManager/VpnChannel 状态 观察驱动 start/stop,pbxproj 登记。 - Android PangolinVpnService.kt 延迟修复。 契约字段 uploadBytes/downloadBytes/uploadSpeed/downloadSpeed/urltestResults 不改。 真机验证(连接后实时跳动)为运行时步骤,见计划 Phase1 待办。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 18:13:48 +08:00
wangjia	636a3bbf2f	feat(server/stats): stats-overhaul Phase2 — 每设备归因 + GB 综合配额 ... 服务端记账从「账户」细到「每设备」(每设备独立 dp_uuid),配额单位分钟→GB 按账户综合卡控。000015_per_device_usage 迁移(mysql+sqlite 双份):devices.dp_uuid + usage_device_daily 表 + plans.daily_mb。handler_grpc 按 dp_uuid 回映射 (user_id,device_id) 双写账户+每设备;usage 服务/handler 暴露 /v1/usage(/devices)。 含 sqlite_per_device / usage handler 测试。 注:此迁移 prod 已 migrate up 运行、部署二进制已内嵌;本次补提交使 git 与线上一致。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 18:12:00 +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	6f480acad5	build(client/windows): installer 版本 bump 1.0.4 → 1.0.5(含统计页重设计) ... Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 17:47:46 +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	47147a1041	build(client/windows): installer 版本 bump 1.0.3 → 1.0.4(含节点国旗) ... Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 16:32:57 +08:00
wangjia	855d9e0e30	feat(client): 连接页桌面节点胶囊(_NodePill)加地域国旗 ... 桌面连接页「已连接」下的节点框是 _NodePill,此前只有文字「节点名·延时」+ 智能选择 zap,无国旗。在地域前加 CountryCode(size 20)国旗(无效码回退码块), 智能选择时国旗 + zap 并存。手机/平板的 _CurrentNodeCard 本已有旗。 桌面连接页非 golden 覆盖(含旋转动画),无 golden 变更。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 16:32:24 +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	4c1a289633	fix(nodes): 节点健康/connect 绑定 agent 在线状态,不再伪装连上 ... 本次 google 打不开暴露:agent 离线 6 天,节点却一直显示健康、还让客户端 "连上"(凭证推送失败被 _ = 吞掉),实际节点不认 UUID。三处收口: - Hub.IsOnline(nodeUUID):基于本地 agent 流注册的存活信号(单实例权威; 多实例需 Redis presence,另议)。 - ListNodes:effectiveNodeStatus 把 DB='up' 但 agent 离线的节点降级为 "down",不再永远显示健康(status 列只反映供给/调度,不反映 agent 死活)。 - ConnectNode:agent 离线即 503 ErrNodeUnavailable(凭证持久化留待 resync), 在线时 push 失败也 503——不再吞 pushErr、不再下发节点无法兑现的配置。 测试:TestHub_IsOnline(注册/结束/未注册)、TestEffectiveNodeStatus (up+离线→down 等)。新增 apierr.ErrNodeUnavailable(503)。 掉线告警 + 静默吞错全量审计另起 TODO。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 08:36:31 +08:00
wangjia	3527537c96	fix(connect): 4 处 500 记 slog.Error;加连接路径 schema 绑定测试 ... ConnectNode 四条 ErrInternal 路径(entitlement/配额/节点/配置渲染)此前只写 500 不记 err,导致「no such column: p.daily_mb」这种 SQL 错全静默 → 难排查。 改为各记 slog.Error(含 user/node/err)。 新增 store 层测试 TestSQLite_ConnectPathSchema:在跑过完整迁移(含 000015)的 真 SQLite 库上,跑连接路径依赖 015 schema 的三条查询——EntitlementForUser (断言 DailyMB 从 plans.daily_mb 取到 102400)、EnsureDeviceDpUUID(devices.dp_uuid)、 AccountDayBytes——任一引用了没有迁移建的列即 SQL 报错、测试变红,守住本次 「查询引用了未迁移列」一类回归。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 08:11:32 +08:00
wangjia	77ce809d48	fix(auth): SMTP 信封发件人用裸地址,修 501;发信失败记日志 ... 两个真问题,前者被后者掩盖: 1. mailer.go 把带显示名的 SMTP_FROM(「穿山甲 <noreply@x>」)直接当 SMTP 信封发件人(MAIL FROM)传给 smtp.SendMail,Resend 报 501 Bad sender address syntax → 验证码发不出。改用 net/mail 解析出裸地址作信封发件人,From: 头 仍保留完整显示名。 2. service.go 两处异步发信把错误静默吞了(_ = SendCode/SendAlreadyRegistered), 导致 SMTP 故障日志无痕、难排查(本次端口被封+501 都被吞)。改为失败时 slog.Error 记日志,邮箱经 maskEmail 打码,绝不记验证码(守 no-secret-in-logs)。 测试:TestEnvelopeFrom(显示名/裸址/unicode → 裸址)守 501 回归;TestMaskEmail 守日志脱敏。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-28 07:50:37 +08:00
wangjia	b12519be0a	fix(client/windows): runner 加 /utf-8 编译选项,根治 C4819 中文注释编译失败 ... win32_window.cpp 含中文注释(UTF-8 无 BOM),在 zh-CN 机器(代码页 936)+ 新版 MSVC 上报 C4819「字符无法用当前代码页表示」,叠加 runner 的 /WX 直接 error C2220 编译失败。APPLY_STANDARD_SETTINGS 加 /utf-8,让 MSVC 按 UTF-8 解析 所有 runner 源码,永久根治。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-27 20:49:36 +08:00
wangjia	8d3c5da7ee	fix(client/windows): installer 覆盖修复 — 装新版前静默卸载遗留 AppId 的 1.0.0 ... 1.0.0 的 AppId 是非法 GUID(...PANGOLIN0001),1.0.1 起改成合法 GUID。 AppId 不同 → Inno 视为两个独立产品 → 控制面板里 1.00/1.01 并排不覆盖。 当前 AppId 已稳定会原地升级;再在 ssInstall 前把遗留 AppId 的残留装 静默卸掉(/VERYSILENT),清掉已并存的 1.0.0 幽灵。版本 bump 1.0.2→1.0.3。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-27 20:42:54 +08:00
wangjia	e7b37d7719	test(ci): 刀3 — CI 单点韧性:runner 离线告警(缺口③) ... CI 整条吊在一台 mac,关机/掉线即全停且无人知道。新增 deploy/runner/runner-deadman.sh(仿 bootstrap/monitor/deadman-watch.sh): 放另一台常在线主机,每 3 分钟查 gitea Actions API 里 mac-pangolin-2 的 status, 连续 offline 到阈值 → Telegram 告警,恢复也通知;API 取不到时跳过不误报。 响应字段已对照真 gitea API 核验({"runners":[{"name":...,"status":"online"}]}), shellcheck 干净,实跑验证 online→不告警、缺失→进告警分支。 docs/ci-runner.md 增「韧性」节(告警部署 + cron/launchd)并标注持久化激活仍待 本机手动跑(pkill/launchctl,Claude 跑不了);验证段 job 数 9→10。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 23:04:35 +08:00
wangjia	75cdbf583f	test(server): 刀2 — v2ray 真实采集后端测试(缺口②) ... V2RayUsageSource 是「线上按租户记账」链路的源头(agent 读 sing-box v2ray_api StatsService per-user 计数器 → 聚合 → ReportUsage),此前零测试覆盖 (复查发现之前以为有单测是错的)。本刀按用户定的范围只补 CI 可跑的后端采集: - TestParseUserStat:表驱动,正常 uplink/downlink + 非 user/段数异常应 ok=false。 - TestV2RayCollect:起假 StatsService(loopback gRPC,ServiceName 与 client.go 的 规范全名一致),让真 Collect() 跑真链路,断言:按 dp_uuid 聚合 up/down 正确、 方向不串、全 0 用户与非 user 计数器被丢弃、SessionMinutes=1、且请求以 Reset_=true + pattern "user>>>" 发出(窗口取值清零语义)。 纯 go test、无 docker / 无真 sing-box;自动进 go-server job + 计入覆盖率闸。 真 sing-box 真出网 e2e 仍按计划留文档手测。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 23:01:27 +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	55d368d98b	docs(test): 测试架构补「⑩ 已知缺口/测试盲区」单一跟踪源 ... 把散在对话里的盲区收进架构文档,作为单一跟踪源(补一项划一项): - A 覆盖盲区:前端统计上屏数值未验证(诉求半覆盖)、真实流量数据路径 (注入非真出网,最大盲区)、原生隧道层零自动化、契约双份可能漂移。 - B 运维/工程缺口:CI 单点 mac(持久化未激活)、go-integration 裸宿主脆性、 analyze 严格化(B1)+ golden 全集(B2)被 stats-overhaul 耦合阻塞、 golden 本地难重生。 每项标严重度 + 现状为什么 + 何时怎么补;同步登记 docs/index.html。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 21:30:54 +08:00
wangjia	8356547c2f	test(ci): 第7刀 — CI 依赖缓存(C 效率) ... host-mode runner 宿主机持久,给四个拉依赖的 job 挂宿主缓存目录, 消掉每次全量下载: - go-server / e2e-smoke:挂 $HOME/.cache/pangolin-ci/{gomod,gobuild} → /go/pkg/mod + /root/.cache/go-build。 - flutter-client / golden:挂 $HOME/.cache/pangolin-ci/pubcache → /root/.pub-cache。 本地实测 go build:首次 204s(含全量 downloading)→ 二次 1s(0 downloading)。 testcontainers 镜像由 Docker Desktop 宿主层天然缓存,无需额外处理。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 21:25:38 +08:00
wangjia	f8f4ee0ce8	test(ci): 第6刀 — CI gate 补全(覆盖率闸 A1 + 集成测试 job A2) ... A 类「闸的完整性」: - A1 覆盖率闸(防断崖,非追高): · go-server job 加 -coverprofile,host 侧解析 total,< 30% 失败(当前 34.9%)。 · flutter-client job 加 --coverage,host 侧 awk 解析 lcov,< 28% 失败(当前 32.7%)。 阈值留 ~5% 缓冲,只拦回归断崖,不卡日常波动。 - A2 集成测试进 CI(新 go-integration job,Job 10): 真 mysql:8/redis 经 testcontainers 跑 -tags integration(跨库可移植/按租户 记账/配额/兑换/节点生命周期/migrate·时区——sqlite 单测覆盖不到的真库行为)。 · 在 host-mode runner 宿主机直接跑 go(不套 golang 容器):testcontainers 要真 docker,DooD 在 Docker Desktop(mac)上网络不通;依赖宿主 go + docker。 · -p 1 串行:一次只起一个 mysql 容器,避免并发压垮 Docker Desktop。 covers/ 覆盖率产物入 .gitignore。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 21:19:34 +08:00
wangjia	0fd3bce7a5	fix(server): 修复腐烂的集成测试套件 + devices 注册回填 last_seen ... 这批 -tags integration 测试(usage/auth/codes/devices/store)因依赖冲突 长期编译不过、从未进 CI 跑过,代码静默腐烂。本次逐层修复: - 依赖:testcontainers-go v0.34→v0.43(原 v0.34 配 docker v28.3.3 编译失败: archive.Compression/sockets.DialPipe undefined)。 - auth: LoginOutcome 重构成 Tokens 嵌套后,测试仍引用扁平 RefreshToken; users 测试 schema 缺 totp_enabled 列 → GetUserByEmail 报错 → SendCode 500。 - usage/auth/codes/devices: DSN 里 time_zone='+00:00' 作 URL query 透传时 '+' 被解码成空格 → MySQL Error 1298 ' 00:00';改百分号编码。 - store: 测试 DSN 缺 multiStatements=true → 多语句迁移 Error 1064; WithConfigFile("") 在 v0.43 被拒,改写真 my.cnf 设 +08:00 真正考验 UTC 覆盖。 - devices(产品 bug):insertDeviceTx 把 last_seen 写进库却没回填返回值, 刚注册的设备 API 响应 last_seen=null 与库不一致;TestFullChain 据此把关。 修复后完整 integration 套件 -p 1 串行全绿(25 包 + 5 testcontainers 包)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 21:19:10 +08:00
wangjia	97b2ac02f1	ci: pangolin runner launchd 持久化(start script + plist) ... mac-pangolin-2 从临时后台进程改成开机自启的 launchd 服务,仿 jiu 的 com.jiu.act-runner: - deploy/runner/act_runner_pangolin_start.sh:等 jiu relay(13000)就绪 → 起 daemon → 退出自重启;PATH 含 docker/node/go(host 模式 job 要用) - deploy/runner/com.pangolin.act-runner.plist:RunAtLoad + KeepAlive - docs/ci-runner.md:持久化章节改为实际部署步骤(cp + launchctl load) 复用 jiu 的 relay 13000(端口已占,不另起)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 20:06:21 +08:00
wangjia	034a585e3b	docs(ci): runner 设置记录(决定用 1 个 mac-pangolin-2 + 清理/持久化) ... 记录 pangolin CI 的 self-hosted runner:决定保留 1 个(mac-pangolin-2,项目级、 mac host 模式、label nas、复用 jiu 的 relay 13000),含 config、为何 host+mac、 relay 原因、已删 orphan(mac-pangolin id5)的清理命令、持久化(launchd)TODO。 登记进 docs/index.html。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 18:52:54 +08:00
wangjia	65bd7c381b	fix(test): e2e 去掉 /v1/usage/devices 断言(stats-overhaul WIP) ... CI 暴露:e2e smoke 断言 /v1/usage/devices 返 200,但该路由(deviceUsageHandler)是 未提交的 stats-overhaul WIP,committed server 没注册它 → 404 → assertStatus200 (t.Errorf 非致命)记错 → TestE2ESmoke FAIL(尽管 HTTP/enroll/ReportUsage 全 ✓)。 本地复现不了(工作区有 WIP、路由在)。去掉该断言,/v1/usage 保留。 这是第 4 个'测试依赖未提交 WIP'实例,与契约测试同源。待 stats-overhaul 合并后补。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 18:38:15 +08:00
wangjia	62a86c5c0e	fix(ci): shellcheck 去掉多余的 shellcheck 命令(预存 bug) ... koalaman/shellcheck 镜像 ENTRYPOINT 已是 shellcheck;ci.yml 命令又写了一遍, 变成 'shellcheck shellcheck -S warning …',把字面 'shellcheck' 当文件检查→ 'openBinaryFile: does not exist' 报错。去掉多余的 shellcheck 即可。 这是 CI 从没跑过、谁都没发现的预存 bug,首次真跑暴露。本地验证去掉后 exit 0。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 18:25:21 +08:00
wangjia	dc22328eb4	ci(debug): shellcheck 改挂整个 repo + 加 checkout 诊断 ... shellcheck 在 mac runner 上 $PWD/deploy 挂载为空(openapi 的 design/server 子路径却 能挂),怀疑 act host checkout 没拉 deploy。改挂 $PWD:/repo(codegen 已证整 repo 挂载 可用)+ 加 ls 诊断,定位 deploy 是否在 checkout 里。整 repo 挂载在 Linux 也对。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 18:21:29 +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	9a2d14adbe	fix(ci): 去掉误提交的 .claude/worktrees gitlink ... .claude/worktrees/iridescent-sleeping-lampson 是个 git worktree 目录,被误提交成 gitlink(mode 160000)。.gitignore 已有 .claude/worktrees/ 但它在那之前就提交了。 git rm --cached 去跟踪(不删磁盘 worktree)。修 actions/checkout 的 submodule 警告 (No url found for submodule path)+ 清理仓库。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 18:01:18 +08:00
wangjia	58e06708f4	test(ci): 闸2 Go go vet 进 CI(支柱-adjacent;golangci-lint 暂受 go1.25 阻) ... go-server job 加 go vet ./...(项目工具链,零版本摩擦): - golangci-lint(errcheck/depguard)暂用不了:其 go1.23 构建 < 项目 go1.25.10, 报版本错;待 golangci-lint 跟上 go1.25 再上 errcheck(支柱4)+ depguard(import 方向) - go vet 当前零违规,接进 go build+vet+test 链 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 13:51:41 +08:00
wangjia	945c2e2f8d	test(ci): 闸2 Dart 支柱4 lint 升 error 级(真守门) ... analyze 闸修好后(exit 0),把支柱4 两条规则提升为 error 级: - only_throw_errors / avoid_catching_errors → analyzer.errors: error - 即使 CI --no-fatal-infos,这俩违规仍致命(挡 merge);当前零违规 - 将来 throw 字符串 / catch Error → CI 红(支柱4:错误是有类型的值) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-25 13:45:31 +08:00