<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>绿联工作笔记 on Last Stand</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/</link><description>Recent content in 绿联工作笔记 on Last Stand</description><generator>Hugo</generator><language>zh-cn</language><lastBuildDate>Wed, 04 Nov 2026 08:56:35 +0800</lastBuildDate><atom:link href="https://amatsuzero.github.io/LastStand/posts/ugreen-notes/index.xml" rel="self" type="application/rss+xml"/><item><title>UgreenHome 共享库 CI：依赖安全扫描与内网构建复盘</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/ugreenhome-shared-ci-sca/</link><pubDate>Wed, 04 Nov 2026 08:56:35 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/ugreenhome-shared-ci-sca/</guid><description>&lt;h2 id="背景"&gt;背景&lt;/h2&gt;
&lt;p&gt;UgreenHome 的 iOS / Android 两端共用一个 Kotlin Multiplatform（KMP）共享库 ugreenhome-shared。随着库里引入的开源与第三方 SDK 越来越多，安全与合规团队希望能定期知道「到底用了哪些包、什么版本、有没有已知漏洞」，而不是每次发版手工对账。这就是 SCA（软件成分分析）的诉求。&lt;/p&gt;
&lt;p&gt;SCA 的流程本身不复杂：先用 Gradle 导出依赖清单（SBOM），再用 Grype 之类的扫描器比对漏洞库，最后把结果写进内部 Wiki 并通知相关人。真正麻烦的是前面那一步——&lt;strong&gt;导出 SBOM 需要先完整编译&lt;/strong&gt;，而编译机在公司内网，连不上 Google Maven、Gradle Plugin Portal 这些外网源，公共镜像又经常抽风。于是这次工作的本质，就是打通「在内网里把依赖完整解析出来」这条链路。&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;说明：文中提到的 MR 编号（如 !87）、Pipeline 编号（如 7190）都是内网 GitLab 的内部标识，只当作叙事锚点，外部无法访问，也不附链接。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2 id="名词解释"&gt;名词解释&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;SBOM（Software Bill of Materials，软件物料清单）&lt;/strong&gt;：一次构建实际用到的全部依赖（含传递依赖）的清单，通常带版本与坐标，是安全扫描的比对基线。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;SCA（Software Composition Analysis，软件成分分析）&lt;/strong&gt;：对 SBOM 做漏洞 / 许可证扫描的过程。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;GAV&lt;/strong&gt;：Maven 坐标 group:artifact:version，例如 androidx.fragment:fragment-ktx:1.8.0，用来唯一定位一个依赖。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Nexus&lt;/strong&gt;：公司内网的私有仓库（Maven 代理 + 托管）。本次用到 maven-ugreenhome-release（正式包）、maven-ugreenhome-snapshot（内部 SNAPSHOT）、ugreenhome-group（聚合多个源）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Grype&lt;/strong&gt;：一款开源漏洞扫描 CLI，被放进 Nexus 的 raw 仓，CI 从内网下载。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;seed（镜像上传）&lt;/strong&gt;：在能连外网的机器上，把 Plugin Portal / Google Maven 上的包下载并上传到 Nexus，CI 再从内网拉。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;init.gradle&lt;/strong&gt;：Gradle 启动时执行的脚本，用来统一改写「去哪个仓库找包」的优先级。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="为什么-ci-里会下包失败"&gt;为什么 CI 里会「下包失败」&lt;/h2&gt;
&lt;p&gt;可以把 Gradle 在 CI 里的依赖来源想成三道独立的采购渠道，缺任何一道，构建都会在&lt;strong&gt;不同阶段&lt;/strong&gt;挂掉：&lt;/p&gt;</description></item><item><title>iOS MR 包体积分析实践：APPAnalyze、Link Map 与跨项目接入</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/ios-mr-app-size-analysis/</link><pubDate>Mon, 02 Nov 2026 18:24:53 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/ios-mr-app-size-analysis/</guid><description>&lt;h2 id="这个-job-解决什么问题"&gt;这个 job 解决什么问题&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;analyze_app_size_mr&lt;/code&gt; 是合并前的包体积预检：复用 &lt;code&gt;build_app&lt;/code&gt; 已构建的 App，回答「当前包有多大、代码与资源各占多少、哪些模块或资源最重、这笔 MR 相比目标分支是否增长」。分析结果自动出现在 MR 评论里，并附完整 HTML / JSON 报告，方便评审时定位增长来源。&lt;/p&gt;
&lt;p&gt;几个关键约定：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;不重新编译 App&lt;/strong&gt;：依赖 &lt;code&gt;build_app&lt;/code&gt; 的 Beta、iphoneos、无签名产物，分析阶段只做扫描、汇总和报告；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;APPAnalyze 看最终 .app&lt;/strong&gt;，二进制、资源和静态扫描问题；&lt;strong&gt;Link Map 补足主程序内部静态库的来源归因&lt;/strong&gt;；&lt;/li&gt;
&lt;li&gt;分支 push 的 &lt;code&gt;analyze_app_size&lt;/code&gt; 负责写入基线；MR 的 &lt;code&gt;analyze_app_size_mr&lt;/code&gt; 只读取目标分支基线；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;allow_failure: true&lt;/code&gt;：分析失败允许流水线继续；扫描提示用于评审参考，当前没有按体积阈值阻止合并。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="mr-的真实运行结果以-271-为例"&gt;MR 的真实运行结果（以 !271 为例）&lt;/h2&gt;
&lt;p&gt;MR !271 已合入；最终 Pipeline #7020 成功，源码 SHA 为 &lt;code&gt;e55c648b&lt;/code&gt;。&lt;code&gt;build_app #17094&lt;/code&gt; 成功（约 451.6 秒）；&lt;code&gt;analyze_app_size_mr #17108&lt;/code&gt; 成功（约 80.6 秒）。这是单次耗时证据，不能代表所有项目或冷缓存场景。&lt;/p&gt;
&lt;p&gt;&lt;code&gt;package_size.json&lt;/code&gt;：&lt;code&gt;.app&lt;/code&gt; 总计 357,058,497 B（357.1 MB），二进制 210,367,928 B（210.4 MB），资源 146,690,569 B（146.7 MB）。报告展示使用十进制 MB。&lt;/p&gt;</description></item><item><title>UgreenHome RN iOS 组件化与调试能力重建（阶段总结）</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/ugreenhome-rn-ios-modularization/</link><pubDate>Mon, 02 Nov 2026 18:12:04 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/ugreenhome-rn-ios-modularization/</guid><description>&lt;h2 id="背景与目标"&gt;背景与目标&lt;/h2&gt;
&lt;p&gt;2026-10-29 至 11-02，我接手了 UgreenHome 主工程里一套陈旧的 RN（React Native）依赖栈，把目标定为三件事：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;清理重复的实现入口与本地临时代码，统一走内网 Specs / GitLab / Nexus；&lt;/li&gt;
&lt;li&gt;把可复用逻辑按单一职责拆成独立组件；&lt;/li&gt;
&lt;li&gt;恢复原生符号调试与 Metro JS 调试，同时不破坏默认的离线与发布链路。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;明确的不变量：不再为内部库新增「Debug/Release × 静态/动态」四套制品；不覆盖已发布 tag；所有产品变更走 MR；主工程保留业务组合，不追求机械地搬空目录。&lt;/p&gt;
&lt;p&gt;本文是阶段收口记录。这里先说明一个原则：&lt;strong&gt;已发布、已合入、测试通过、真实设备运行通过，这四件事要分别记录，不能互相替代&lt;/strong&gt;。下面凡是说到「已合入」「已发布」，都不代表所有真机业务场景已逐项通过。&lt;/p&gt;
&lt;h2 id="推进路线"&gt;推进路线&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;先清理、再合入&lt;/strong&gt;：移除重复的 Runtime/Kit 接线与过时实验内容，清理无用分支、worktree、临时文件与部分缓存，保留未提交的业务改动。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;建立远端组件边界&lt;/strong&gt;：从 LocalPods / 主工程抽取可复用逻辑与资源，迁到 &lt;code&gt;home/rn&lt;/code&gt;；测试随实现进入 &lt;code&gt;test_spec&lt;/code&gt;，宿主只保留跨组件与设备集成测试。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;治理依赖图&lt;/strong&gt;：从显式 binary 选择推导传递 redirect，处理 Lottie、MMKVCore、ZIPFoundation 等同模块双实现问题，再扩展为调试源码闭包。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;恢复 RN_DEBUG&lt;/strong&gt;：统一安装入口、源码/Debug 变体选择、Metro 编译隔离与调试工具组件化。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;继续下沉&lt;/strong&gt;：通用 Debug 编辑器已发布，宿主 MR !262 已合入；&lt;code&gt;UGreenRNComponents 0.1.0&lt;/code&gt; 已发布，WebView / Lottie 两个 subspec 已由宿主 MR !273 消费，原实现已从主工程删除。&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id="阶段成果与真实边界"&gt;阶段成果与真实边界&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;依赖单一真源&lt;/strong&gt;：移除 &lt;code&gt;LocalPods/UGreenRNRuntime&lt;/code&gt; 等重复清单，以 Podfile 的 &lt;code&gt;rn_dependencies&lt;/code&gt; 统一维护版本与来源。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;组件化切片&lt;/strong&gt;：Platform、Transport、DeviceSettings、E-Ink、Debug 等职责已有独立组件。Transport 先下沉 HTTP callback gate / 取消策略，DeviceSettings 先下沉启动校验 / 手势 / codec，E-Ink 先下沉图片身份 / 重试 / 调度——不宣称整套 HTTP / MQTT / 业务桥已搬完。&lt;/p&gt;</description></item><item><title>UHPlayerSDK 打 tag 打包失败复盘</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/uhplayersdk-tag-build-failure/</link><pubDate>Mon, 26 Oct 2026 10:17:32 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/uhplayersdk-tag-build-failure/</guid><description>&lt;h2 id="概述"&gt;概述&lt;/h2&gt;
&lt;p&gt;10 月 26 日，UHPlayerSDK 打 &lt;code&gt;1.1.0.rc1&lt;/code&gt; tag 时，动态库真机 archive 在 &lt;code&gt;PrecompileModule&lt;/code&gt; 阶段失败，xcodebuild 退出码 65，甚至还没编到 SDK 源码。&lt;/p&gt;
&lt;p&gt;根因是 CI 的每日缓存清理脚本按文件年龄逐个删除 Xcode 编译缓存，把仍被后续构建引用的系统 module 对象拆掉了。这破坏了按内容寻址（CAS）缓存的正确性——不是简单的缓存未命中。&lt;/p&gt;
&lt;p&gt;本文记录现象、排查过程、根因，以及清理规则、发版 pin、launchd 路径三类修复。&lt;/p&gt;
&lt;h2 id="现象"&gt;现象&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;1.1.0.rc1&lt;/code&gt; 的 &lt;code&gt;release-ug-component&lt;/code&gt; 流水线失败。同一流水线里：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;job 14862：&lt;code&gt;git fetch&lt;/code&gt; 连接被重置（exit 128），属于网络抖动；&lt;/li&gt;
&lt;li&gt;重试后的 job 14863：才是真正的构建失败。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;失败点是动态库、真机 archive，xcodebuild 退出码 65，报错停在预处理系统 module：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;error: There was an error precompiling module .../ExplicitPrecompiledModules/_AvailabilityInternal-....scan
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;_AvailabilityInternal&lt;/code&gt; 是 Xcode SDK 里的系统 clang module。构建脚本把 xcodebuild 输出交给 &lt;code&gt;xcpretty&lt;/code&gt; 美化，底层 clang 的详细诊断被滤掉了，所以第一眼看不到根因。&lt;/p&gt;
&lt;h2 id="排查过程"&gt;排查过程&lt;/h2&gt;
&lt;p&gt;先排除了几类常见怀疑：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;源码没问题&lt;/strong&gt;：tag 指向的 &lt;code&gt;44b366aa&lt;/code&gt; 与 10 月 23 日 MR !12 成功 archive 的是同一棵树；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;依赖和工具链没变&lt;/strong&gt;：仍是 &lt;code&gt;RTCXSDK 1.7.0.7&lt;/code&gt;、&lt;code&gt;libopus 1.1&lt;/code&gt;，Xcode 仍是 26.5（17F42）；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;发版改写不是原因&lt;/strong&gt;：podspec 仍是 &lt;code&gt;1.0.5&lt;/code&gt;，发版脚本会改写成 tag 版本，&lt;code&gt;1.1.0&lt;/code&gt; 当时也是这么改写后 archive 成功的；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;磁盘/进程问题无关&lt;/strong&gt;：10 月 24 日磁盘写满（&lt;code&gt;No space left on device&lt;/code&gt;）和随后的 &lt;code&gt;maxUserProcs&lt;/code&gt; 耗尽是另一件事，UHPlayerSDK 当时并未写这份缓存。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;真正定位靠一句话：&lt;strong&gt;整份删掉 &lt;code&gt;compilation_cache/464&lt;/code&gt; 再编就通过了&lt;/strong&gt;。说明问题在缓存本身，而不是源码或依赖。&lt;/p&gt;</description></item><item><title>hf auth login 粘贴 token 崩溃排查与修复</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/hf-auth-login-token-crash/</link><pubDate>Sun, 25 Oct 2026 21:39:07 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/hf-auth-login-token-crash/</guid><description>&lt;h2 id="现象"&gt;现象&lt;/h2&gt;
&lt;p&gt;homebrew 安装的 &lt;code&gt;hf&lt;/code&gt; CLI（huggingface_hub 2.3.0，venv 基于 Python 3.15.1）执行 &lt;code&gt;hf auth login&lt;/code&gt;，粘贴 token 后立即崩溃，刷屏 Python traceback（&lt;code&gt;ImportError&lt;/code&gt;）。&lt;/p&gt;
&lt;h2 id="根因"&gt;根因&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;~/.zshenv&lt;/code&gt; 中无条件导出：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;export all_proxy&lt;span style="color:#f92672"&gt;=&lt;/span&gt;socks5://127.0.0.1:7897
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;这是 Clash Verge Rev 的混合端口，对所有 shell（包括子 shell）生效。&lt;code&gt;hf&lt;/code&gt; 粘贴 token 后调用 &lt;code&gt;whoami&lt;/code&gt; 校验，&lt;code&gt;huggingface_hub&lt;/code&gt; 创建 httpx 客户端时检测到 SOCKS 代理，需要 &lt;code&gt;socksio&lt;/code&gt; 包；而 homebrew 的 hf venv（&lt;code&gt;--without-pip --system-site-packages&lt;/code&gt; 创建）未打包 &lt;code&gt;socksio&lt;/code&gt;，于是：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;ImportError: Using SOCKS proxy, but the socksio package is not installed
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;之所以恰好在「粘贴 token 时」崩：那是整个登录流程中第一次发 HTTP 请求的时刻，&lt;code&gt;getpass&lt;/code&gt; 读输入本身不发网络请求。&lt;/p&gt;
&lt;h2 id="修复"&gt;修复&lt;/h2&gt;
&lt;p&gt;把 &lt;code&gt;socksio 1.0.0&lt;/code&gt; 装进 hf venv 自己的 site-packages（不污染共享的 &lt;code&gt;python@3.15&lt;/code&gt;）：&lt;/p&gt;</description></item><item><title>cc-switch 切 Codex 供应商「不生效」的排查</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/cc-switch-codex-provider/</link><pubDate>Thu, 22 Oct 2026 16:51:13 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/cc-switch-codex-provider/</guid><description>&lt;h2 id="现象"&gt;现象&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;cc-switch&lt;/code&gt; 里切换 Codex 供应商（官方 ↔ 自建）后，&lt;code&gt;codex&lt;/code&gt; 仍走原供应商，像没生效。&lt;/p&gt;
&lt;h2 id="根因三个独立问题"&gt;根因（三个独立问题）&lt;/h2&gt;
&lt;h3 id="1-daemon-不重读配置"&gt;1. daemon 不重读配置&lt;/h3&gt;
&lt;p&gt;&lt;code&gt;cc-switch&lt;/code&gt; 只改写 &lt;code&gt;~/.codex/config.toml&lt;/code&gt;；真正发请求的是常驻 managed daemon（&lt;code&gt;codex app-server --listen unix:// --managed-daemon&lt;/code&gt;，由 &lt;code&gt;pid-update-loop&lt;/code&gt; 守护、PPID=1 常驻后台），它只在启动时读一次 config，之后不重读。&lt;/p&gt;
&lt;p&gt;→ 切了文件但 daemon 没重启 = 没用。&lt;/p&gt;
&lt;h3 id="2-daemon-忽略-sigterm"&gt;2. daemon 忽略 SIGTERM&lt;/h3&gt;
&lt;p&gt;有客户端连接时 &lt;code&gt;kill(TERM)&lt;/code&gt; 返回成功但进程不死，必须 SIGKILL。早期 &lt;code&gt;codex-restart&lt;/code&gt;「没生效」就是这个坑。&lt;/p&gt;
&lt;h3 id="3-requires_openai_auth-残留最新发现"&gt;3. requires_openai_auth 残留（最新发现）&lt;/h3&gt;
&lt;p&gt;&lt;code&gt;cc-switch&lt;/code&gt; 切换是「合并」写 config：官方→自建时更新 &lt;code&gt;base_url&lt;/code&gt; / &lt;code&gt;bearer_token&lt;/code&gt;，却把上个官方配置里的 &lt;code&gt;requires_openai_auth=true&lt;/code&gt; 留了下来。&lt;code&gt;=true&lt;/code&gt; 会让 codex 用官方 OAuth 账号、忽略自建 &lt;code&gt;base_url&lt;/code&gt; → 仍走官方。自建时该行必须为 &lt;code&gt;false&lt;/code&gt;。（&lt;code&gt;cc-switch&lt;/code&gt; 里 UGreen 模板存的其实是 &lt;code&gt;false&lt;/code&gt;，但合并时没覆盖到。）&lt;/p&gt;
&lt;h2 id="daemon-是谁启动的"&gt;daemon 是谁启动的&lt;/h2&gt;
&lt;p&gt;不是 launchd 登录项（&lt;code&gt;launchctl&lt;/code&gt; / &lt;code&gt;~/Library/LaunchAgents&lt;/code&gt; 无 codex 任务），而是 codex 自己按需拉起：首次运行 codex CLI 或打开桌面版时 spawn &lt;code&gt;pid-update-loop&lt;/code&gt;（监督者）+ &lt;code&gt;app-server&lt;/code&gt;（daemon），之后常驻后台（脱离父进程、过继给 PID 1），只在被 kill 或注销 / 重启时死。&lt;/p&gt;</description></item><item><title>Jenkins iOS Agent 的 Git LFS Checkout 失败排查</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/ugreenhome-ios-jenkins-lfs/</link><pubDate>Thu, 22 Oct 2026 15:22:27 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/ugreenhome-ios-jenkins-lfs/</guid><description>&lt;h2 id="背景"&gt;背景&lt;/h2&gt;
&lt;p&gt;某 iOS 工程把约 132 个 vendored gem（iot/vendor/cache/*.gem）通过 git-filter-repo 迁到了 Git LFS 并 force-push。此前这些 gem 是普通 git blob，checkout 不触发 git-lfs。迁移后，Jenkins 的 iOS agent（由 launchd 拉起、无 GUI 会话）第一次 checkout 到含 LFS 内容的版本，问题才暴露。&lt;/p&gt;
&lt;p&gt;为什么会「以前没事、今天突然挂」：① 仓库是最近才引入 LFS 的，以前 checkout 根本不触发 git-lfs；② launchd agent 从一开始就没有 GUI 会话 / 完整 PATH，只是以前没被需要。&lt;/p&gt;
&lt;h2 id="名词解释"&gt;名词解释&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Git LFS&lt;/strong&gt;：Git 大文件存储，把大文件（此处是 gem 包）存到独立对象存储，工作区 checkout 时通过 smudge 过滤器按需下载。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;smudge / clean / filter-process&lt;/strong&gt;：LFS 的过滤器钩子；checkout 时的 smudge 负责把指针换成真实文件。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;osxkeychain&lt;/strong&gt;：macOS 系统级 Git 凭据助手，从登录钥匙串读凭据；无登录会话的后台进程读不到。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;credential.helper&lt;/strong&gt;：Git 的凭据获取机制；空值会清空下层继承的 helper。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="现象错误随修复逐层演进"&gt;现象（错误随修复逐层演进）&lt;/h2&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;轮次&lt;/th&gt;
&lt;th&gt;报错&lt;/th&gt;
&lt;th&gt;所属层面&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;td&gt;git-lfs: command not found&lt;/td&gt;
&lt;td&gt;agent PATH 不含 Homebrew&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2（手动配 filter 配坏）&lt;/td&gt;
&lt;td&gt;filter-process: command not found&lt;/td&gt;
&lt;td&gt;filter.lfs.process 配成裸 filter-process&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;3（改绝对路径后）&lt;/td&gt;
&lt;td&gt;failed to get: -60008&lt;/td&gt;
&lt;td&gt;osxkeychain 在 launchd 下读不了登录钥匙串&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;4（禁用 osxkeychain 后）&lt;/td&gt;
&lt;td&gt;batch response: too many authentication attempts&lt;/td&gt;
&lt;td&gt;git-lfs 拿不到 LFS 接口凭据&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;三层报错各不相同，是典型的「修好一层、暴露下一层」。&lt;/p&gt;</description></item><item><title>UgreenHome CocoaPods Specs / 镜像 tag 故障复盘</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/ugreenhome-cocoapods-spec-mirror/</link><pubDate>Wed, 21 Oct 2026 14:06:24 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/ugreenhome-cocoapods-spec-mirror/</guid><description>&lt;h2 id="背景与现象"&gt;背景与现象&lt;/h2&gt;
&lt;p&gt;主工程使用内部 CocoaPods Specs 仓库。某些源码 pod 的 source.git 指向内部 GitLab 镜像；另一些第三方依赖由 &lt;code&gt;*-bin&lt;/code&gt; spec 提供预编译 XCFramework。FCUUID-bin 的 spec 声明了对源码 pod UICKeyChainStore (~&amp;gt; 2.1.0) 的依赖，而主工程此前没有直接声明 UICKeyChainStore。&lt;/p&gt;
&lt;p&gt;删除 iot/Podfile.lock 后运行 &lt;code&gt;make -C iot pods&lt;/code&gt;，CocoaPods 重新解析传递依赖，选中了 Specs 中的 UICKeyChainStore 2.1.3。该 spec 指向镜像中不存在的 v2.1.1 tag，安装失败，典型报错是 &lt;code&gt;fatal: Remote branch v2.1.1 not found in upstream origin&lt;/code&gt;。这发生在依赖解析、源码获取阶段，尚未进入 App 链接。&lt;/p&gt;
&lt;p&gt;主工程 Podfile → FCUUID-bin 1.3.3.1 → UICKeyChainStore (~&amp;gt; 2.1.0) [传递源码依赖] → 无 lock 时选到 2.1.3 → source.tag = v2.1.1 [镜像不存在] → make pods 失败。&lt;/p&gt;</description></item><item><title>UDC 镜像仓库迁移踩坑记录</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/udc-mirror-migration/</link><pubDate>Wed, 21 Oct 2026 13:55:41 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/udc-mirror-migration/</guid><description>&lt;h2 id="背景"&gt;背景&lt;/h2&gt;
&lt;p&gt;一次把 UDC 相关仓库从外部 GitLab 源迁到内网 GitLab + Nexus 的迁移，踩了十来个坑。本文把每个坑的「现象 → 根因 → 修复」记下来，方便后续再做类似镜像同步时直接对照。迁移目标是：把外部源（记为 gitlab-cloud）的仓库改写成指向内网 GitLab 的 podspec，并同步 Maven 产物到内网 Nexus。&lt;/p&gt;
&lt;h2 id="名词解释"&gt;名词解释&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Pull Mirror（GitLab 原生镜像）&lt;/strong&gt;：GitLab 自带的仓库镜像功能，让镜像仓库与上游完全一致。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Nexus&lt;/strong&gt;：内网私有仓库（Maven / raw 等），用来托管同步过来的二进制与 Maven 产物。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Protected 变量&lt;/strong&gt;：GitLab CI 变量标记为 Protected 后，只在保护分支 / 标签上注入。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;members/all&lt;/strong&gt;：GitLab 查组成员接口，带 /all 才会包含从父组继承的成员。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="一gitlab-原生镜像根本没法用"&gt;一、GitLab 原生镜像根本没法用&lt;/h2&gt;
&lt;p&gt;一开始想直接用 GitLab 自带的 Repository Mirroring（pull mirror），结果它和「改写 podspec URL」的需求天然冲突：原生 pull mirror 会让镜像仓库与上游完全一致，等于把我们在内网侧做的 podspec URL 改写每次同步都覆盖回去。而且源仓库里的 podspec 仍带外部域名，我们用的同步 bot 是源项目的只读成员，push 回源会 403 &amp;ldquo;not allowed to upload code&amp;rdquo;——源仓库修不了。&lt;/p&gt;</description></item><item><title>GitLab macOS Runner 构建成功后卡死 27 分钟排查</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/gitlab-macos-runner-hang/</link><pubDate>Mon, 19 Oct 2026 16:48:13 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/gitlab-macos-runner-hang/</guid><description>&lt;h2 id="背景与现象"&gt;背景与现象&lt;/h2&gt;
&lt;p&gt;某条 iOS 主工程的 MR 流水线，构建 job 在 &lt;code&gt;Build Succeeded&lt;/code&gt; 之后，卡在 &lt;code&gt;Cleaning up project directory and file based variables&lt;/code&gt; 约 27 分钟，GitLab 页面一直显示 running（14:57 构建完成，15:24 才上报 success）。编译本身只花了约 8 分钟——卡的是 job 收尾阶段，而且最终自行成功，属于「假死」而非失败。&lt;/p&gt;
&lt;h2 id="名词解释"&gt;名词解释&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;GitLab Runner&lt;/strong&gt;：执行 CI job 的 agent 进程；&lt;code&gt;concurrent&lt;/code&gt; 控制同一台机器上能并行跑几个 job。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;DerivedData&lt;/strong&gt;：Xcode 的构建中间产物目录，体积大、文件多。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;CAS（Content Addressable Storage）&lt;/strong&gt;：Xcode 编译缓存，按内容寻址，默认无清理上限。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;launchd&lt;/strong&gt;：macOS 的系统服务管理器，相当于开机自启 + 定时任务（类似 cron，但睡眠错过会自动补跑）。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="排查过程逐层排除"&gt;排查过程（逐层排除）&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;磁盘 / inode&lt;/strong&gt;：盘仅 66% 使用、300G+ 可用、inode 充足 → 排除磁盘满。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;日志定位卡点&lt;/strong&gt;：日志尾部 &lt;code&gt;Build Succeeded → after_script → Saving cache&lt;/code&gt; 全部完成，最后沉默在收尾清理段 → 卡的是 runner 清理，不是编译。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;自研探针一次采齐&lt;/strong&gt;（gitlab-runner-probe.sh）：runner 配置 &lt;code&gt;concurrent = 3&lt;/code&gt;；builds 目录 131G（DerivedData 56G + 编译缓存 49G + checkout 22G）；项目 checkout 仅 2.4G / 6 万文件，清理对象本身很小；事发时 load average 16/26/25，空载后回落到 5.65 → 负载与 CI 活动强相关；swap used 1.8G → 内存曾吃紧；删除微基准：6 万小文件 &lt;code&gt;rm -rf&lt;/code&gt; 仅 2s → 排除文件系统删除吞吐问题。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;时间线对齐&lt;/strong&gt;：该 job 的清理窗口（14:58–15:24）与同 runner 上另一个 KMP 重构建 job（14:58–15:11）完全重叠。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="根因定位"&gt;根因定位&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;直接原因：同机并发超载。&lt;/strong&gt; &lt;code&gt;concurrent=3&lt;/code&gt; 下，KMP 链接等重 job 把 CPU / IO / 内存打满（load 25+、动用 swap），收尾清理这种秒级小活被拖成 27 分钟。&lt;/p&gt;</description></item><item><title>UG *-bin 重发与 BLFD 踩坑总结</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/ug-bin-resend-blfd/</link><pubDate>Sun, 18 Oct 2026 13:42:37 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/ug-bin-resend-blfd/</guid><description>&lt;h2 id="适用范围"&gt;适用范围&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;应用：&lt;code&gt;home/ios/ugreenhome&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;发布脚本：&lt;code&gt;home/cicd/ci&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;组件：&lt;code&gt;home/ios/components/*&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;时间跨度：从开启 &lt;code&gt;BUILD_LIBRARY_FOR_DISTRIBUTION&lt;/code&gt;（BLFD）开始，到 18 个 &lt;code&gt;*-bin&lt;/code&gt; 组件重发、真机验证、cicd 收口 MR 为止。&lt;/p&gt;
&lt;h2 id="0-什么是-blfd为什么要开"&gt;0. 什么是 BLFD，为什么要开&lt;/h2&gt;
&lt;p&gt;BLFD = &lt;code&gt;BUILD_LIBRARY_FOR_DISTRIBUTION = YES&lt;/code&gt;，是 Swift 的 Library Evolution / Module Stability 开关。开启后，编译器在生成二进制的同时输出一份 &lt;code&gt;.swiftinterface&lt;/code&gt; 文件，完整描述模块对外暴露的 API。Importer 编译时优先读取 &lt;code&gt;.swiftinterface&lt;/code&gt;，从而让一个预编译的 Swift 二进制框架可以被不同 Swift / Xcode 版本的 consumer 导入，避免小版本差异导致 ABI 破坏。&lt;/p&gt;
&lt;p&gt;UG 的 &lt;code&gt;*-bin&lt;/code&gt; 组件是通过 CocoaPods 分发的预编译二进制 framework，开发机、Runner CI、本地环境用的 Xcode / Swift 版本不可能完全一致。不开 BLFD 时，Swift 编译器小版本差异就可能让 consumer 在链接 / 运行时出现 &lt;code&gt;Symbol not found&lt;/code&gt; 或 &lt;code&gt;dyld: cannot load&lt;/code&gt;。开启后，一次发布即可跨多个 Xcode 版本使用，不用为每个 Xcode / Swift 版本各打一份二进制。&lt;/p&gt;</description></item><item><title>GitLab SAST 在 ARM64 Runner 上的故障复盘</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/gitlab-sast-arm64-runner/</link><pubDate>Fri, 16 Oct 2026 15:32:18 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/gitlab-sast-arm64-runner/</guid><description>&lt;h2 id="背景与目标"&gt;背景与目标&lt;/h2&gt;
&lt;p&gt;把 Semgrep SAST 接到 iOS 工程的 CI 上，原本的扫描 job 一直跑不通。本文记录从 Rosetta 崩溃到原生 ARM64 镜像上线的全过程，以及其间踩到的十几个坑。结论是：本机 / 流水线显示「非阻断成功」都不算验收通过，真正的完成标准是——正式 job 执行成功、新报告有效、GitLab 解析成功、目标分支配置一致。&lt;/p&gt;
&lt;h2 id="名词解释"&gt;名词解释&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;SAST（Static Application Security Testing，静态应用安全测试）&lt;/strong&gt;：不运行程序，靠扫描源码发现安全缺陷。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Semgrep&lt;/strong&gt;：一款开源的静态分析 / SAST 引擎，GitLab 官方 SAST analyzer 底层就用的它。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Rosetta&lt;/strong&gt;：Apple 在 ARM64 macOS 上转译运行 AMD64 二进制的兼容层；转译路径异常时会有看不懂的分配错误。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;ARM64 / AMD64&lt;/strong&gt;：两种 CPU 指令集架构。混用会导致需要转译，转译层出问题是本次故障根源。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;gl-sast-report.json&lt;/strong&gt;：GitLab SAST 的标准报告文件，有官方 schema 校验。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="最终结果验收口径"&gt;最终结果（验收口径）&lt;/h2&gt;
&lt;p&gt;修复后，正式 semgrep-sast job 切换到固定 digest 的原生 ARM64 镜像。正式 job（Runner 13 上）成功运行；285 条规则扫描 2209 个文件，产生 111 条原始发现；gl-sast-report.json 状态为 success 并通过官方 schema 校验；服务端确认扫描 SUCCEEDED、errors=[]。&lt;/p&gt;</description></item><item><title>把 GitHub 依赖迁移到内网 GitLab 的踩坑总结</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/gitlab-migration-pitfalls/</link><pubDate>Mon, 12 Oct 2026 10:13:41 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/gitlab-migration-pitfalls/</guid><description>&lt;h2 id="背景"&gt;背景&lt;/h2&gt;
&lt;p&gt;公司内网环境极差，外网访问几乎不可达，打包机几乎拉不到 GitHub 上的依赖，所以才把一部分依赖镜像到内网 GitLab，供打包机使用。加上部分仓库很大（如 Alamofire、lottie-ios），迁移过程中集中爆发了一批问题。&lt;/p&gt;
&lt;p&gt;补充两点前置配置经验：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;如果仓库是 Private 的，外部匿名拉取（不携带 token、cookie 等）会失败。需要在 General Settings - Visibility, project features, permissions - Package registry 下打开 &lt;strong&gt;Allow anyone to pull from Package Registry&lt;/strong&gt;；&lt;/li&gt;
&lt;li&gt;往 Pod Spec 仓库推送代码，需要 Maintainer 权限的账号，否则无法 push。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;对于超大仓库，在网络环境差的情况下 &lt;code&gt;git push --mirror&lt;/code&gt; 很容易出现 504 错误，只推我们用到的 tag 即可。&lt;/p&gt;
&lt;h2 id="本次迁移踩坑总结"&gt;本次迁移踩坑总结&lt;/h2&gt;
&lt;h3 id="1-shallow-clone-无法推送-tag"&gt;1. Shallow clone 无法推送 Tag&lt;/h3&gt;
&lt;p&gt;GitLab 报 &lt;code&gt;shallow update not allowed&lt;/code&gt;，需要先 &lt;code&gt;git fetch --unshallow&lt;/code&gt;，再推送标签。&lt;/p&gt;
&lt;h3 id="2-git-lfs-对象缺失"&gt;2. Git LFS 对象缺失&lt;/h3&gt;
&lt;p&gt;GitLab 会拒绝推送并提示 &lt;code&gt;LFS objects are missing&lt;/code&gt;，必须同步并执行 &lt;code&gt;git lfs push --all&lt;/code&gt;。&lt;/p&gt;</description></item><item><title>rn-runtime-ios Runtime 发布与接入踩坑复盘</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/rn-runtime-ios-publish/</link><pubDate>Wed, 07 Oct 2026 23:28:30 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/rn-runtime-ios-publish/</guid><description>&lt;h2 id="最终结果"&gt;最终结果&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Runtime 最终发布版本：&lt;code&gt;0.1.9.17&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Lottie 内网修订版本：&lt;code&gt;4.6.0.1&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Runtime 发布流水线：Pipeline 3740&lt;/li&gt;
&lt;li&gt;真机产物验证 Job：9486 成功&lt;/li&gt;
&lt;li&gt;Runtime MR !22 已合并并完成发布&lt;/li&gt;
&lt;li&gt;ugreenhome MR !8 已合并，Runtime 与 Lottie 依赖已同步升级&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;下面按「问题 → 根因 → 处理」的方式复盘，避免把教训写成流水账。&lt;/p&gt;
&lt;h2 id="1-依赖地址与-lottie-podspec"&gt;1. 依赖地址与 Lottie Podspec&lt;/h2&gt;
&lt;p&gt;依赖地址必须统一使用内网 GitLab 新域名，&lt;strong&gt;不能把 Runner 内部 IP（形如 192.168.x.x）写进 Podspec&lt;/strong&gt;。这会造成环境耦合、证书 / SNI 问题，也让开发机与 CI 行为不一致。&lt;/p&gt;
&lt;p&gt;Lottie 原始 &lt;code&gt;4.6.0&lt;/code&gt; 已经发布，不能移动或覆盖旧 Tag。保留源码不变，仅修复 Podspec URL 时，应发布新的修订版本 &lt;code&gt;4.6.0.1&lt;/code&gt;。&lt;/p&gt;
&lt;p&gt;Specs 仓库中的版本、&lt;code&gt;s.version&lt;/code&gt;、Git Tag 与 Runtime 依赖版本必须完全一致——这是后面一系列问题的总根。&lt;/p&gt;
&lt;h2 id="2-版本号与-tag"&gt;2. 版本号与 Tag&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;任何会影响发布产物或 Podspec 的修复都要递增版本号，不能复用已经发布的 Tag；&lt;/li&gt;
&lt;li&gt;Tag 应从已经合并且验证通过的 main 创建，不要从未合并提交直接打发布 Tag；&lt;/li&gt;
&lt;li&gt;发布前确认「Tag 规则、流水线 rules、版本文件」三者一致。「打了 Tag」不等于「publish-runtime 一定会触发」。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="3-publish-runtime-未随-tag-触发"&gt;3. publish-runtime 未随 Tag 触发&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;首先检查 &lt;code&gt;.gitlab-ci.yml&lt;/code&gt; 中 job 的 &lt;code&gt;rules/only&lt;/code&gt; 是否匹配当前 Tag；&lt;/li&gt;
&lt;li&gt;检查 Tag 是否属于 Protected Tag，以及触发者是否有对应权限；&lt;/li&gt;
&lt;li&gt;发布 job 与普通构建 job 是两条独立链路：普通 CI 绿色不能证明发布 job 已创建或已执行；&lt;/li&gt;
&lt;li&gt;修复后必须用新的版本和新 Tag 验证，不能移动旧 Tag 来「补跑」。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="4-specs-token-鉴权"&gt;4. Specs Token 鉴权&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;SPECS_GIT_PASSWORD&lt;/code&gt; 必须是对 Specs 仓库具备写权限的有效 Token，并正确配置到 Runtime 项目的 CI/CD Variables。变量还要检查 Protected / Masked / Environment scope——受保护 Tag 上运行时，未受保护变量可能不可见。&lt;/p&gt;</description></item><item><title>GitLab 上 KMP 二进制的发布链路与踩坑</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/gitlab-kmp-build/</link><pubDate>Tue, 22 Sep 2026 14:12:53 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/gitlab-kmp-build/</guid><description>&lt;h2 id="背景"&gt;背景&lt;/h2&gt;
&lt;p&gt;把 Kotlin Multiplatform 共享库以 XCFramework 形式发给 iOS 侧使用时，发布链路并不只是「编出来传上去」。它涉及 XCFramework 构建、二进制归档、私有 CocoaPods Specs 仓库、GitLab 包 registry，以及一连串的权限与凭据隔离问题。这里把一次完整发布踩过的坑整理成可复用的清单。&lt;/p&gt;
&lt;h2 id="推荐发布链路"&gt;推荐发布链路&lt;/h2&gt;
&lt;pre class="mermaid"&gt;
flowchart LR
A[构建 XCFramework] --&gt; B[打包 ZIP + SHA256]
B --&gt; C[生成二进制 Podspec]
C --&gt; D[上传 GitLab Generic Package]
D --&gt; E[匿名下载并校验 ZIP/SHA]
E --&gt; F[pod spec lint]
F --&gt; G[push Podspec 到私有 Specs Git]
G --&gt; H[重新 clone / readback]
H --&gt; I[干净 Podfile 执行 pod install]
&lt;/pre&gt;
&lt;h2 id="名词解释"&gt;名词解释&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;XCFramework&lt;/strong&gt;：Apple 的跨平台 / 多架构二进制分发格式，可同时携带真机与模拟器 slice。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Podspec&lt;/strong&gt;：CocoaPods 的依赖描述文件，声明版本、源码 / 二进制地址与校验和。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Specs 仓库&lt;/strong&gt;：存放 Podspec 的私有 Git 仓库，相当于私有 CocoaPods 源。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Generic Package Registry&lt;/strong&gt;：GitLab 提供的通用二进制包仓库，用来托管 ZIP 等任意产物。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Project Access Token&lt;/strong&gt;：GitLab 的项目级访问令牌，区别于个人令牌，可限定角色与权限范围。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="1-版本必须全链路一致"&gt;1. 版本必须全链路一致&lt;/h2&gt;
&lt;p&gt;以下字段必须保持一致：Git tag、VERSION_NAME、Podspec 的 version、Package Registry 路径、ZIP 文件名、checksum sidecar 文件名，以及 Specs 路径（如 UgreenHomeShared/1.7.0.4/UgreenHomeShared.podspec）。&lt;/p&gt;</description></item><item><title>Crash 收集治理：从吞异常到 iOS 27 CrashReportExtension</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/crash-collection-governance/</link><pubDate>Thu, 17 Sep 2026 17:33:05 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/crash-collection-governance/</guid><description>&lt;h2 id="现状崩溃根本送不到后台"&gt;现状：崩溃根本送不到后台&lt;/h2&gt;
&lt;h3 id="p0--崩溃根本送不到-sdk"&gt;P0 — 崩溃根本送不到 SDK&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;1. UHAvoidCrash 把 NSException 吞了（最严重）&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;code&gt;AppDelegate.swift:48&lt;/code&gt; 无条件调用 &lt;code&gt;AvoidCrash.makeAllEffective()&lt;/code&gt;。它 swizzle 了 &lt;code&gt;NSArray&lt;/code&gt; / &lt;code&gt;NSDictionary&lt;/code&gt; / &lt;code&gt;NSObject&lt;/code&gt; 系列方法并包在 &lt;code&gt;@try/@catch&lt;/code&gt; 里，异常被捕获后只发一个 &lt;code&gt;AvoidCrashNotification&lt;/code&gt;，永远不会走到任何 uncaught exception handler。数组越界、插 nil 这类 iOS 最高频的崩溃，Bugly 和 Crashlytics 都收不到。&lt;code&gt;AppDelegate.swift:182&lt;/code&gt; 的弹窗还是 &lt;code&gt;#if UGDEBUG&lt;/code&gt; 门控的，线上连痕迹都没有。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;2. UGLog 装了不链式的 uncaught handler&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;code&gt;UGLog.swift:212&lt;/code&gt; 的 &lt;code&gt;NSSetUncaughtExceptionHandler&lt;/code&gt; 在 &lt;code&gt;AppDelegate:61&lt;/code&gt; 安装，捕获后只写日志、不转发给前一个 handler。它是三者中最早装的，所以实际会被 Crashlytics / Bugly 覆盖；但 Bugly 在 &lt;code&gt;AppDelegate:274&lt;/code&gt; 最后启动，它是否把 handler 链回 Crashlytics，源码里看不出来。这意味着 Crashlytics 可能整条链路被 Bugly 顶掉。这个必须实测：Release 包强制崩一次，同时看两个后台。&lt;/p&gt;
&lt;h3 id="p1--bugly-数据基本不可用"&gt;P1 — Bugly 数据基本不可用&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;3. Bugly 没有 dSYM 上传&lt;/strong&gt;：全仓库只有 &lt;code&gt;${PODS_ROOT}/FirebaseCrashlytics/run&lt;/code&gt;（&lt;code&gt;project.pbxproj:692&lt;/code&gt;），没有任何 buglySymbol / 上传脚本。Bugly 上的堆栈会是纯地址。&lt;/p&gt;</description></item><item><title>RN Runtime：Xcode 26 ↔ 27 二进制不兼容的原因</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/rn-runtime-xcode26-27-incompat/</link><pubDate>Tue, 15 Sep 2026 19:33:46 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/rn-runtime-xcode26-27-incompat/</guid><description>&lt;h2 id="现象"&gt;现象&lt;/h2&gt;
&lt;p&gt;用 Xcode 27 编译主工程时，若本地 RN Runtime 仍是 Xcode 26.6 打的预编译包，链接阶段失败：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;Undefined symbols for architecture arm64:
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; method descriptor for Cxx.CxxPair.first.getter
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; method descriptor for Cxx.CxxPair.second.getter
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; 来源：NitroModules（AnyMap.o）
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;反向也成立：Xcode 27 的包拿到 Xcode 26.6 下去编，会缺另一组 &lt;code&gt;Iterable&lt;/code&gt; / &lt;code&gt;makeBorrowingIterator&lt;/code&gt; 相关符号。&lt;/p&gt;
&lt;h2 id="结论先看这个"&gt;结论（先看这个）&lt;/h2&gt;
&lt;p&gt;这不是某个编译参数（&lt;code&gt;-fxxx&lt;/code&gt; / &lt;code&gt;OTHER_SWIFT_FLAGS&lt;/code&gt; / &lt;code&gt;BUILD_LIBRARY_FOR_DISTRIBUTION&lt;/code&gt;）能补丁过去的问题。&lt;/p&gt;
&lt;p&gt;根因是：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;Swift 6.3.3（Xcode 26.6） → Swift 6.4（Xcode 27）
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;系统自带的 Swift–C++ 互通层（Cxx overlay）里，&lt;code&gt;CxxPair&lt;/code&gt; 协议的 ABI 变了。预编译的 NitroModules 已经写死了对「旧 method descriptor」的引用；消费端换编译参数，补不出这些符号。&lt;/p&gt;
&lt;p&gt;因此：&lt;strong&gt;同一套预编译 RN Runtime，不能跨 Xcode 大版本混用&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;官方有痕迹，但没有面向 App 开发者的点名预警。官方提前说的是「C++ 互通还在变，用兼容模式保源码」，没有提前说「Xcode 26 的 Swift–Cxx 预编译包不能给 27 链接」。这是语言演进的必然结果，不是未公开的私有变更；发行说明漏了二进制兼容这一层。&lt;/p&gt;</description></item><item><title>IoT 设备通信基础：配网、MQTT 与 P2P 穿透</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/iot-communication-basics/</link><pubDate>Thu, 10 Sep 2026 09:14:06 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/iot-communication-basics/</guid><description>&lt;h2 id="配网把-wi-fi-告诉设备"&gt;配网：把 Wi-Fi 告诉设备&lt;/h2&gt;
&lt;p&gt;配网的核心目的只有一个：&lt;strong&gt;安全地把家庭 Wi-Fi 的 SSID 和密码告诉硬件设备&lt;/strong&gt;。设备出厂时并不知道家庭网络，手机作为用户侧入口，承担「转交凭据」的角色。下面是几种主流方式，从最常见到更先进。&lt;/p&gt;
&lt;h3 id="1-ap-模式热点模式"&gt;1. AP 模式（热点模式）&lt;/h3&gt;
&lt;p&gt;最经典、最通用的备选方案。&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;设备首次通电后自身创建 Wi-Fi 热点（名称常类似 &lt;code&gt;XXX-Camera_XXXX&lt;/code&gt;）；&lt;/li&gt;
&lt;li&gt;手机在 Wi-Fi 列表里连上这个热点（提示「无法提供互联网访问」是正常的）；&lt;/li&gt;
&lt;li&gt;App 检测到已连设备，提供界面让用户选择家庭 Wi-Fi 并输入密码；&lt;/li&gt;
&lt;li&gt;App 通过这条临时本地连接把 SSID / 密码发给设备；&lt;/li&gt;
&lt;li&gt;设备关闭热点，用收到的密码去连家庭路由器，成功后配网完成。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;优点&lt;/strong&gt;：通用性强，几乎所有智能硬件都支持，不依赖路由器特殊功能，稳定性高。
&lt;strong&gt;缺点&lt;/strong&gt;：用户需手动切换 Wi-Fi，过程中手机无法上网，体验不流畅。&lt;/p&gt;
&lt;h3 id="2-smart-config一键配网"&gt;2. Smart Config（一键配网）&lt;/h3&gt;
&lt;p&gt;目前体验最好的主流方式。&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;设备通电后进入混杂模式，监听空气中所有无线数据包；&lt;/li&gt;
&lt;li&gt;用户在 App 输入家庭 Wi-Fi 密码后，手机用 &lt;strong&gt;UDP 广播&lt;/strong&gt;将 SSID / 密码加密后，打包在&lt;strong&gt;数据包的长度&lt;/strong&gt;里发送——像摩斯电码，通过长度变化传信息；&lt;/li&gt;
&lt;li&gt;设备虽无法解密内容，但能「听」到数据包的长度规律，从中破译出 SSID 和密码；&lt;/li&gt;
&lt;li&gt;设备主动去连家庭 Wi-Fi，并通知 App 配网成功。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;优点&lt;/strong&gt;：无需切换 Wi-Fi，全程在 App 内操作，体验极佳。
&lt;strong&gt;缺点&lt;/strong&gt;：无线环境复杂（干扰多、2.4G / 5G 同名）时成功率可能降低；安全性相对 AP 模式稍低（信息已加密，但存在被嗅探的理论风险）。&lt;/p&gt;
&lt;h3 id="3-声波配网"&gt;3. 声波配网&lt;/h3&gt;
&lt;p&gt;常见于无屏幕设备（智能音箱、家电）。手机把 Wi-Fi 信息编码成高频 / 低频声波，设备用麦克风接收解码。&lt;/p&gt;</description></item><item><title>网络 / 代理 / Gradle 问题修复记录</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/network-proxy-gradle-troubleshooting/</link><pubDate>Mon, 07 Sep 2026 23:14:45 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/network-proxy-gradle-troubleshooting/</guid><description>&lt;h2 id="环境"&gt;环境&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Clash Verge Rev（混合端口 7897），全局代理在 &lt;code&gt;~/.zshenv&lt;/code&gt;；&lt;/li&gt;
&lt;li&gt;两个机场订阅；&lt;/li&gt;
&lt;li&gt;涉及内网域名 &lt;code&gt;ugreeniot.com&lt;/code&gt;、&lt;code&gt;ugreensmart.com&lt;/code&gt;，以及一台内网 Gradle 私服（形如 &lt;code&gt;192.168.75.x&lt;/code&gt;）。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="问题与修复"&gt;问题与修复&lt;/h2&gt;
&lt;h3 id="1-android-studio-gradle-同步失败"&gt;1. Android Studio Gradle 同步失败&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;现象&lt;/strong&gt;：拉 &lt;code&gt;kotlin-compiler-embeddable-2.4.0.jar&lt;/code&gt;（57 MB）失败，走代理 3m19s 只下 5.79 MB（29 kB/s），直连仍 3m48s 失败。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;根因&lt;/strong&gt;：AS 的 HTTP Proxy 设置不影响 Gradle daemon（Gradle 只看 &lt;code&gt;gradle.properties&lt;/code&gt; / init script）。&lt;code&gt;repo.maven.apache.org&lt;/code&gt; 走 Cloudflare CDN，Gradle 并发 HTTP/2 在国内频繁 RESET。&lt;code&gt;curl&lt;/code&gt; 单连接 4.4 MB/s 正常，但 Gradle 不行。阿里云镜像 17.5 MB/s。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;修复&lt;/strong&gt;：新增 &lt;code&gt;init.d&lt;/code&gt; 脚本把 3 个仓库换阿里云镜像（只影响本机，不污染团队项目）。验证 &lt;code&gt;BUILD SUCCESSFUL&lt;/code&gt;。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;坑&lt;/strong&gt;：换源后报 &lt;code&gt;Could not find xxx.klib&lt;/code&gt;——镜像文件其实是全的（md5 一致），真因是之前超时留下的半截缓存（pom / module 下了，klib 没下）。解决：删 metadata + 坏 artifact 目录，保留 1.1 GB 有效文件，&lt;strong&gt;不要用 &lt;code&gt;--refresh-dependencies&lt;/code&gt; 或整个删 caches&lt;/strong&gt;。&lt;/p&gt;</description></item></channel></rss>