13 Commits

Author	SHA1	Message	Date
wangjia	38be40a107	fix(client/ci): sing-box/wintun 境内镜像到 NAS(修 Windows 构建 GFW 失败) ... 根因:Windows CI 从 GitHub release 下 sing-box 压缩包被 GFW 限速超时(github.com 网页可达但 release 资产 CDN 被掐),build-windows 卡在 fetch-desktop-bin 早期。 修: - 二进制镜像到 NAS Gitea generic 包(v1.13.12/sing-box-*-windows-amd64.zip + wintun-0.14.1.zip),上传前后均 sha256 校验。 - fetch-desktop-bin.sh 加 DESKTOP_BIN_MIRROR(+可选 _TOKEN):设了先试镜像、 命中即用、未设/失败回退 GitHub/wintun.net;镜像文件照走现有 sha pin 校验(防 投毒/损坏)。修一处 macOS bash3.2 空数组 set -u unbound 坑。 - deploy-client.yml build-windows env 指向 NAS 镜像基址 + 复用现有 FORGEJO_TOKEN secret(匿名 GET 也行,token 仅备将来私有)。无新 secret、无硬编码、无入库二进制。 回归(mac bash3.2):无 mirror 走 GitHub ✓ / mirror 走 NAS 命中 ✓ / bogus mirror 回退 ✓。Windows 端到端待下个 client-v* tag 触发 CI 观察。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-08 09:53:38 +08:00
wangjia	4561ee4cc3	fix(ci): fetch-desktop-bin curl 加固(windows 外网 GFW 抖动) ... wintun.net / github 下载偶发超时(curl 28)。retry 3→8、加 --retry-all-errors + --retry-connrefused + --connect-timeout 20,拉长重试窗口以命中可达时刻。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013nMthbVEmQquxBRKb9Fj8u	2026-07-06 22:56:20 +08:00
wangjia	b23377acde	build(scripts): 各端 libbox 构建脚本修正 + 自动部署产物 ... 排查 Android 打包"libbox.aar not found / Unresolved reference nekohasekai"踩坑: - scripts/build-libbox.sh: · 构建后自动部署产物到工程引用位置(android→app/kernel/dist/android/libbox.aar; apple→client/{macos,ios}/Frameworks/Libbox.xcframework),不再留 /tmp 让人手动拷 · android 自动挑 NDK ≥28(未设 ANDROID_NDK_HOME 时):官方 build_libbox 拉 cronet-go, 其 libcronet.a 在 NDK 27 lld 链接报 unknown relocation(315)失败 · 头注释补全前置(NDK≥28 / JDK17 / gomobile 入 PATH)与产物路径 - app/kernel/build-android.sh:补 -javapkg io.nekohasekai —— 缺它产出默认包名 `libbox`, 与 Kotlin 的 io.nekohasekai.libbox 对不上、APK Kotlin 编译失败 - build.gradle:注释指明两条构建途径 + 包名必须 io.nekohasekai.libbox Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-01 07:53:35 +08:00
wangjia	2a8426c357	fix(android/kernel): 补 -checklinkname=0 ldflags + JDK 自动探测,构建出 40MB libbox.aar ... 对齐 sing-box build_libbox sharedFlags 的 -ldflags(含 -checklinkname=0 放行 badlinkname 的 //go:linkname;-trimpath/-buildvcs=false/版本戳); JDK 自动选 Android Studio JBR(macOS /usr/bin/javac 仅桩)。Task 2 完成: 三 ABI(arm64/armeabi-v7a/x86_64) libgojni.so 齐。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-22 18:59:14 +08:00
wangjia	f298b207fe	fix(android/kernel): gomobile 改用 SagerNet fork v0.1.12 + 补 linkname tags ... 原 pin golang.org/x/mobile@v0.0.0-20240604...70c4c5da7d30 是失效 revision; 对照 sing-box v1.13.12 go.mod 与 cmd/internal/build_libbox,官方用 github.com/sagernet/gomobile@v0.1.12;补 badlinkname,tfogo_checklinkname0 以适配 Go 1.24 的 //go:linkname 限制。Task 2 blocker 修复。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-22 18:48:58 +08:00
wangjia	86157dfc99	fix(kernel): fetch 脚本改内置 SHA pin(sing-box 停发 checksums.txt)+修正 wintun SHA ... - sing-box v1.13 起 Release 不再发布 checksums.txt,原脚本下载它 404,桌面内核 拉取全平台失效。改为脚本内置各压缩包 SHA256(case 表,版本不符即报错)。 - WINTUN_SHA256 原值(90a6c2..)错误,更正为 wintun-0.14.1.zip 官方哈希(07c256..)。 - 已在 macOS 验证 windows/amd64 全流程:sing-box.exe + wintun.dll 下载+校验+解压通过。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-22 07:58:03 +08:00
wangjia	53caaf54f0	docs: 同步 EC2 栈删除后的文档 ... - CLAUDE.md 重写:去掉 EC2/marzban 部署、架构、cutover/rollback 命令、自动部署 CD; 改为自有 VPS 自建方向(RackNerd Debian 12、ssh racknerd 免密、512MB→SQLite)、 补 server/ Go 后端与多数据库(DB_DRIVER)说明;保留设计 token 单源段 - 删 docs/回滚手册.md(EC2 edge 切换/回滚,脚本已删) - 删 docs/备份与灾备.md(EC2 MySQL/marzban xtrabackup→S3,backup 栈已删) - app/kernel/poc/README.md:REALITY 参数来源由 EC2 改为自建节点(single-node) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-18 07:01:13 +08:00
wangjia	83dd5369ab	feat(M4/M5): URLTest 自动选线 + Kill-switch + 弹性重连 [tsk_xAQhC1xuCd8x] ... M4 URLTest 自动选线： - ClashApiClient.getGroupDelay() — GET /group/<name>/delay 触发按需测速 - ClashApiClient.extractUrltestResults() — 从 /proxies 响应解析 URLTest 组成员最新延迟，填充 stats 帧的 urltestResults 字段 - DesktopKernelProcess._startStatsPoll() — 每秒并行拉取连接统计 + URLTest 延迟（_clashApi.getProxies()），URLTest 失败不影响主统计 - DesktopVpnBridge.selectOutbound(tag) — Clash API PUT /proxies/proxy， tag 可传节点 tag 或 urltest 组 tag（如 "auto-select"）恢复自动 - DesktopVpnBridge.getActiveOutbound() — GET /proxies 读 proxy.now - app/kernel/poc/reality_client.config.json.tmpl — 增加 urltest("auto-select") + selector("proxy") 出口组，route.final 改为 "proxy" M5 Kill-switch + 弹性重连： - DesktopVpnBridge.setKillSwitch({required bool on}) — 将 _killSwitchEnabled 写入 TUN inbound strict_route 字段（applyKillSwitchToConfig）；内核运行中 触发静默重载（kill → start(lastConfig)） - DesktopVpnBridge.applyKillSwitchToConfig() — static，killSwitch=true ↔ TUN strict_route=true，killSwitch=false ↔ strict_route=false - 自动退避重连：kernel 崩溃推 error → _scheduleReconnect() 退避序列 1s/2s/4s/8s/16s/30s（上限），stop() 取消，重连成功后重置计数器 - DesktopKernelProcess 意外退出清理 _clashApi（避免下次 spawn 残留） - app/pangolin/test/killswitch_checklist.md — 三端故障注入验收清单 （Desktop ✅，iOS/Android 欠账说明） 新增测试（client/test/bridge/desktop_vpn_bridge_m4m5_test.dart）： - M4: extractUrltestResults 解析/空/无 history 边界 - M4: getGroupDelay HTTP 请求格式验证 - M4: selectOutbound / getActiveOutbound Clash API 调用断言 - M5: applyKillSwitchToConfig 字段覆盖 + 无 TUN 边界 - M5: setKillSwitch 状态注入 + 同值幂等 - M5: 崩溃→error 不崩 / 首次重连在退避延迟内触发 / stop 后不再重连 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-16 00:11:09 +08:00
wangjia	be44ef1226	merge: iOS M3 PoC — PacketTunnelProvider + entitlement [tsk_nsobbj_rJdy0]	2026-06-15 20:56:46 +08:00
wangjia	3c6a8a517a	feat: 桌面端 PoC M1 — sing-box 子进程 TUN 接线 [tsk_SLCsjNgtmng3] ... 实现桌面端（macOS PoC）内核子进程管理，打通 sing-box TUN 模式全链路： ### client/lib/bridge/kernel_process.dart（完整实现，替换原有 stub） - ClashApiClient: HTTP 客户端，支持 /connections / /proxies / /traffic(SSE) / /traffic(plain) - Bearer Token 鉴权；getConnections 用于就绪探测与流量统计；getTraffic SSE 读首帧后断开 - KernelProcess 接口: 新增 statusStream / statsStream 至接口定义 - DesktopKernelProcess: - spawn(configPath): 解析 Clash API 端口/secret → sudo sing-box run（macOS PoC）→ 轮询 /connections 等待就绪（20s 超时）→ emit connecting→on - kill(): SIGTERM + 等待 gracePeriod(5s) → SIGKILL → emit off - 意外退出: emit error（UI 可一键重连，不崩溃） - 统计轮询: 每秒 GET /connections，差分算 uploadSpeed/downloadSpeed - 二进制解析: ENV > exe同目录 > macOS Bundle Resources > 开发目录 > /usr/local/bin - 辅助函数: generateClashApiPort（高位随机）、generateClashApiSecret（32B hex） ### client/lib/bridge/desktop_vpn_bridge.dart（新文件） - DesktopVpnBridge implements VpnBridge： - start(configJson): injectClashApi（注入随机端口+secret）→ writeConfig（0600）→ kernel.spawn - stop(): kernel.kill(5s) - statusStream / statsStream: 代理 KernelProcess 事件流 - selectOutbound: Clash API PUT /proxies/{group} - getActiveOutbound: 从 /proxies 读 now 字段 - configDirOverride: 测试注入支持 - injectClashApi: 静态方法，尊重已有 clash_api 配置，合并保留 experimental 其他字段 ### client/test/bridge/kernel_process_test.dart（新文件） - ClashApiClient 完整测试: headers / 解析 / PUT body / DELETE / 非 200 抛 HttpException - generateClashApiPort / generateClashApiSecret 生成范围和格式测试 - DesktopVpnBridge.injectClashApi: 注入 / 尊重已有 / 保留字段 / 保留其他 experimental / 非法 JSON - DesktopVpnBridge + FakeKernelProcess 集成: connecting→on / stop→off / statsStream / 意外退出 / spawn失败 ### app/kernel/poc/（新目录） - reality_client.config.json.tmpl: VLESS+REALITY+TUN 客户端配置模板 - TUN inbound: auto_route + strict_route（macOS kill-switch 基础保护） - DNS: 防泄露（remote via VPN + cn 直连） - experimental.clash_api: 随机端口 + secret 占位符 - gen-poc-config.sh: 渲染模板为可用 JSON（从环境变量读 REALITY 参数） - README.md: 完整 PoC 接线与 M1 验收步骤 提权说明（macOS PoC）: · sudo 提权（开发机需配 /etc/sudoers.d/pangolin-singbox 或有 sudo 缓存） · 正式版: SMJobBless Helper + 公证（BACKLOG-11D-HELPER） Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-13 17:53:50 +08:00
wangjia	e129f094c2	feat(ios): M3 PoC — PacketTunnelProvider + entitlement + 内存监控 [tsk_nsobbj_rJdy0] ... ### 新增文件 - client/ios/PacketTunnel/MemoryMonitor.swift 周期打点 NE 进程内存（os_proc_available_memory iOS13+ / mach_task_basic_info 兼容 iOS12）；每 10s 采样一次；availableMemory < 5MB 时输出 ⚠️ 警告；提供 summaryString() 供 handleAppMessage/getMemory IPC 返回。 - client/ios/PacketTunnel/PacketTunnel.entitlements Extension 的 NE + App Group entitlement 文件；申请说明写入注释。 - client/ios/Runner/Runner.entitlements 主 App 的 NE + App Group entitlement 文件；申请说明写入注释。 - doc/ne-entitlement-申请指引.md 完整申请操作手册：Bundle ID 清单、Apple Developer Portal 步骤、 专项审批英文申请文案（已脱敏，无红线词）、审批 lead time 说明。 ### 修改文件 - client/ios/PacketTunnel/PacketTunnelProvider.swift 完整 M3 实现（替换原骨架 TODO）： · startTunnel：解析 configJson（options/App Group 两路回退）→ buildNetworkSettings → setTunnelNetworkSettings → setupTunBridge → startLibbox → startPacketBridging → memoryMonitor.start() · stopTunnel：memoryMonitor.stop() → stopLibbox → closeTunBridge · handleAppMessage：JSON IPC 协议（getStatus/getMemory/selectOutbound） · LibboxPlatformInterface 扩展（#if canImport(Libbox)）： openTun 返回 socketpair libbox 侧 fd，autoDetectInterfaceControl no-op， writeLog 转 os.log，useProcFS 返回 false · packetFlow 双向桥接（readFromPacketFlow/writeToPacketFlow 循环） · parseTunAddress/parseDNSServers 从 JSON 提取网络参数 - client/ios/Runner/VpnManager.swift · localizedDescription "穿山甲 Pangolin VPN" → "Pangolin 加速"（红线词修复） · 新增 appGroup 常量（group.com.pangolin.pangolinVpn） · start() 写入 App Group UserDefaults 缓存 configJson - client/ios/Runner/Info.plist NSVPNUsageDescription "穿山甲使用 VPN…" → "Pangolin 使用网络加速通道…"（红线词修复） - client/ios/PacketTunnel/Info.plist CFBundleDisplayName "穿山甲 Tunnel" → "Pangolin 加速通道"（红线词修复） - client/ios/Runner.xcodeproj/project.pbxproj · Runner + PacketTunnel 所有 build config 添加 CODE_SIGN_ENTITLEMENTS · 新增 MemoryMonitor.swift 到 PacketTunnel Sources 构建阶段 · 新增 Runner.entitlements / PacketTunnel.entitlements / MemoryMonitor.swift 文件引用及分组 - app/kernel/build-ios.sh 添加 M3 内存裁剪决策记录：gVisor→grpc→QUIC 优先裁减顺序及内存估算， 等待真机 10min 压测结果后更新最终结论 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-13 17:44:11 +08:00
maestro	3be8b2c9bd	maestro(tsk_d8KmVEzJTCjl): app/kernel 构建管线(AAR/XCFramework/桌面二进制)	2026-06-13 14:31:14 +08:00
wangjia	618332906c	feat(kernel): 搭建 app/kernel/ 构建管线 (AAR/XCFramework/桌面二进制) ... 新增 app/kernel/ 目录，包含四个文件： - VERSION: 固定三个锚点 — sing-box v1.13.12、Go 1.24.3、 gomobile v0.0.0-20240604150348-70c4c5da7d30；禁止脚本内硬编码 - build-android.sh: gomobile bind → dist/android/libbox.aar targets: arm64-v8a / armeabi-v7a / x86_64，-androidapi 21 build tags: with_quic,with_utls,with_clash_api,with_gvisor（对齐 SFA） 裁剪注释保留，幂等+--force 支持 - build-ios.sh: gomobile bind → dist/ios/Libbox.xcframework targets: ios + iossimulator（device+sim 双 slice） build tags 对齐 SFI；含 iOS NE 内存上限敏感说明（裁 grpc/gvisor 指引） - fetch-desktop-bin.sh: 从 GitHub Release 下载桌面二进制 支持 linux/darwin/windows × amd64/arm64 从官方 checksums.txt 做 SHA256 校验；Windows 额外取 wintun.dll 幂等：产物+校验文件均存在则跳过 dist/ 和 .build/ 加入 gitignore；所有脚本通过 shellcheck -S warning 任务: tsk_d8KmVEzJTCjl Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-13 14:30:56 +08:00