[Fartown]

	Files	Added	Deleted	Net
Test	788	$\color{#1a7f37}{\Huge{\mathbf{+}}}$​37532	$\color{#cf222e}{\Huge{\mathbf{−}}}$​61619	$\color{#cf222e}{\Huge{\mathbf{−}}}$​24087
Prod	2212	$\color{#1a7f37}{\Huge{\mathbf{+}}}$​110259	$\color{#cf222e}{\Huge{\mathbf{−}}}$​185754	$\color{#cf222e}{\Huge{\mathbf{−}}}$​75495

把上游 stablyai/orca 从 2eae220b2e 同步到 8cd6a7e5ee，共 3216 个上游提交，所有已登记的 fork 功能都保留。这次同步主要是为了带进上游 stablyai#36315：手机端从历史恢复一个正被聊天占用的会话时，不再只留下一个空终端。

Important

合并时不要 squash，也不要 rebase，否则上游合并提交会丢，下次同步会重新冲突一遍。CI 通过后用 merge commit 合入，或者把同一批提交直接快进推到 fork/integration。

冲突怎么解的

• 179 个冲突（其中 15 个是 fork 改过、上游删掉的），按功能分 7 组解完。之后 pnpm sync:upstream 又无冲突地自动合进了两批上游提交。
• 下线 cli-writer-login-shell：上游现在只在确认 CLI 写入进程还活着时才拒绝。
• 上游搬走的接缝已重新登记，并同步更新了架构策略。
• 11 个超出行数上限的上游文件，把其中的 fork 代码移进了功能自己的模块。
• 各功能检查里有些测试因上游的有意改动而过时，已按功能逐个修正，每个功能一个提交。

推送前的复核

对每个冲突文件，比较旧基准、合并前的 fork、上游、最新上游和合并结果，找出 fork 新增后来没了的行、上游新增后来没了的行。84 个文件有疑似丢失，逐个核对后确认两处真丢了，都已修好：

• fix(session-tabs-publication-lineage)：浏览器标签退役时改用上游 fix(mobile): keep unmounted desktop browser tabs visible and closable stablyai/orca#31665 的 epoch 规则。之前合并保留了 fork 的旧写法，丢了上游对 headless 发布的处理。
• ci(integration-builds)：上游新加的两个缓存预热任务用了 blacksmith runner 却没判断仓库，在 fork 的定时任务里会一直排队。现在只有 stablyai/orca 才用 blacksmith。

其余都是代码搬了位置、改了写法，或已被上游的同类实现取代。

推送前跑 check:changed 时，又发现两处是上游新加的约束碰上了 fork 已有的代码，也已修好：

• fix(local-tasks)：上游新加了「memo 组件里的翻译要订阅语言版本」的规则，LocalTaskList 和 LocalTaskRow 没有订阅，切换语言后文字不刷新。
• fix(terminal-launch-diagnostics)：上游新加的单测要求冷恢复重试的工作量有上限，fork 的启动诊断每次重试都扫两遍全部标签。现在每个窗格只扫一次，上游文件里的这段调用也从 11 行收成了 1 行。

验证

• pnpm tc、check:fork-features、check:fork-docs、check:architecture-policies 通过。
• 桌面端 3 项、手机端 2 项本地化门禁通过，运行时英文目录检查也通过。
• 各功能登记的检查共 46 条，45 条通过。唯一失败的 win32-test-lane-registration 是被本机 git 忽略的 tmp/tasks 干扰，CI 上没有这个目录。
• 用当前上游复查过，这次合并没有丢掉上游测试。
• 以 Fartown/main 为基准跑了一遍 check:changed，范围是 fork 相对上游改动的 1575 个文件：
  • 通过：类型检查、格式、oxlint、各项 ratchet、本地化。
  • 代码质量：报出 132 条类型断言和设计系统规则的问题。逐行追溯过，每条都是同步之前就有的 fork 代码，没有一条是这次引入的。PR 里 fork 专用的那步扫描不包含这两类规则。
  • 单测：跑满 30 分钟上限被截断，没有全部跑完。修掉上面那条重试工作量的问题之后，剩下的失败都在不涉及 fork 代码的测试里：编出来的 CLI 是 10 月的旧产物、macOS 启动器、开发模式重编译监听。另有两条是负载下超时，单独重跑能过。全量单测以本 PR 的 CI 为准。
• 最后一次修改后，又对最新提交增量跑了 check:changed，29 项全部通过。
• 上游新加的全量 lint 本机也跑过。它的 ast-grep 那项已被后面的修正提交修好；代码质量那项就是上面这批同步前就有的问题。

还没做

• 打包后逐屏截图（富文本回退横幅、本地任务标签、手机端圆角等），以及在 SSH 主机上实机验证。
• 全量单测由本 PR 的 CI 来跑。
• 上游已经覆盖了一部分作用、是否下线待定的功能：mobile-terminal-surface-recovery、remote-host-path-open。
• 疑似问题，需要实机确认：合并后，remote-host-path-open 打开的标签读文件用的是 fork 的 grant，保存时会换成上游新发的 grant。保存后再用旧 grant 读，可能因为文件已变而失效。
• feat(local-tasks): 统一任务工作流、总管与会话速览 #76 合入前需要基于新的 fork/integration 更新。

🤖 Generated with Claude Code