| name | upstream-absorb |
| description | 上游吸收流水线(Bun + servo)。扫描上游增量窗口 → 代码级核实分类 → 并行派工吸收 → BCE 文件 patch 重放 → 波末收口。当用户说"看看上游有什么可以吸收/吸收上游/upstream absorb/同步上游",或定期同步时使用。含真源路径、基线管理、假阳性教训、已知陷阱库。 |
上游吸收流水线(upstream-absorb)
Bao 是 Bun(Rust 层移植)+ servo(vendor)的下游。本 skill 固化增量吸收的完整流程,避免重新摸索。
0. 真源与基线(动手前先读)
| 上游 | 本地路径 | 注意 |
|---|
| Bun | ~/code/rust/bun | packages/bun-usockets/bun-uws 的 C 源在 Bao 仓库内(packages/ 目录,src/uws_sys/build.rs:14 编译) |
| servo | ~/code/tools/servo | 不是 ~/code/rust/servo(已失效,CLAUDE.md 曾错记) |
| mozjs | vendor/mozjs/(本仓库 vendor) | cargo 缓存的源可能被前人改过,取源先 diff pristine .crate |
基线真源:.claude/upstream-baseline.json(仓库内机器可读,含 bun/servo baseline hash+updated_at)。auto-memory 只保留方法论(陷阱/教训),不再存 hash;禁从 memory 读基线。波末收尾必须更新该文件并与 wave commit 同一提交。
BCE 定制文件清单:servo 侧 10 个文件(script_thread/script_runtime/dedicatedworkerglobalscope/constellation/event_loop/lock.rs/connector.rs 等)以"upstream 基底 + Bao patch 重放"维护,完整清单与锚点见 CLAUDE.md。任何触及它们的同步 = patch 重放,标高成本。
1. 扫描阶段(spawn explore-lsp agent,只读)
cd ~/code/rust/bun && git fetch origin && git log --oneline <BASELINE>..origin/main
cd ~/code/tools/servo && git fetch origin && git log --oneline <BASELINE>..origin/main
铁律:代码级特征字符串,禁用 commit message 措辞
扫描验证某修复是否已含时,grep 的特征串必须取自代码里的标识符/常量/条件(如 MAX_RESPONSE_HEADER_BUFFER、clear_hostname_on_redirect),不能用 commit 标题措辞(如 "Content-Length mismatch")——措辞只存在于 commit message,代码里是别的名字。本 session 曾因此把"已全吸收"误判为"缺失 7 项"。
第二铁律:名字 grep 有 ~90% 假阳性
JSC/jsc 会命中 JSContext/JSClass(SpiderMonkey API 名)。任何"残留/缺失"结论必须人工抽样核实命中上下文。
1.5 扫描自动化三招(第一道过滤器,先跑再人工)
- hash 前置检测:每个候选先
grep -rl "<hash>" src packages vendor —— Bao 有在注释里引用上游 hash 的惯例,命中即"已含"秒判。
- pre-fix 指纹比对:对 fix 类 commit 取 diff 的删除行(pre-fix 形状,如
value.len() > 1、const int eof = events & EPOLLHUP;),直接 grep Bao 对应目录——命中即"同 bug 确认",比读上下文快一个量级。不命中再看形状差异。
- 窗口规模校正:起手
git rev-list --count <BASELINE>..origin/main + 按目录分类 stat 汇总(install/CI/windows 类整批跳过)——禁用"约 N 个提交"的估算规划派工(本轮估算 15 实际 73)。
已知路径映射(上游 → Bao,避免每轮考古)
| 上游路径 | Bao 落点 |
|---|
packages/bun-usockets/* | packages/bun-usockets/(src/uws_sys/build.rs:14 编译;src/uws_sys/libuwsockets.cpp 是另一层桥、无事件循环,非吸收目标) |
src/http_jsc/websocket_client.rs | 未移植(src/http/websocket_http_client.rs 为空) |
src/runtime/server/RequestContext.rs + webcore/streams.rs | 无对应结构(Bao 用 servo 处理网络) |
src/runtime/*(JSC 钩子层) | 不适用(SM 替代,无 JSC 钩子) |
2. 分类判定(每项必须落到其一)
吸收律(用户裁决 2026-08-23 精化):消费面按指纹吸收;未消费面按问题域迁移审计——上游 commit 修的问题,Bao 自有实现是否有同款?禁为吸收破坏自有实现,禁制造无意义双实现。
| 判定 | 判据 |
|---|
| 吸收 | Bao 消费的上游代码(bun_*/vendor servo 承载面)且同 bug 确认(grep 到 pre-fix 形状)——修进承载代码 |
| 已含 | 代码级特征串在 Bao 命中 post-fix 形状 |
| 不适用(纯) | Bao 无对应结构且无问题域重叠(windows/darwin/test/ci/docs、上游独有 API 面)——注明理由 |
| 域审计 | Bao 未消费上游该部分,但自有实现处于同一问题域 → 禁移植上游代码、禁双实现;以自有 idiom 检查自有实现是否有同类 bug/缺口——有则立项修自有实现(引用上游 hash 作 oracle,不搬代码),无则记证据关闭;na 判定凡注明"Bao 自有实现"者必须落到本类并产出审计结论,不得只标 na 就走 |
| 需进一步判断 | 证据不足时不猜,标出来交主会话 |
C/Zig 文件:非 Rust 但 Bao 有对应 C 源(packages/bun-usockets 等)时仍可吸收;servo 的 .ini/WPT 测试期望默认跳过。
3. 派工吸收(并行 implementer,合同模板)
每个 E 的 prompt 必含(scope/completion/retry/stop),核心结构:
## 修复 N:<hash> <一句话>
- 上游:git show <hash>(先读 diff,禁凭记忆移植)
- Bao 位置:<file:line>(已核实 pre-fix 状态)
## scope: 允许改 <精确文件列表>;禁 vendor 其他文件/commit/push/全量 test
## completion: 落地 + cargo check -p <crate> --jobs 1 过(+ 单测如有)
## retry: 编译错修 1 次
## stop: 上游形状与 Bao 差异过大/语义不明 → 停,报告差异,不猜
并行原则:不同 Agent 的文件集零重叠;servo 的 BCE 文件与普通文件分开派。
4. 已知陷阱库(派工前过一遍)
- cargo 缓存源被污染:mozjs-0.21.4 缓存曾有方向写反的 patch(conversions.rs),必须 diff pristine
.crate
- rsync -a 保留旧 mtime → cargo 复用 stale proc-macro 产物(
crate::node 幽影错误);批量同步后 touch 全树
- webidl 联动:同步 servo DOM .rs 必须伴随
webidls/ 同步;codegen 由 script_bindings/build.rs 自动触发(无需 mach)
- 上游 WIP 断引:servo main 曾有
node/node.rs → crate::dom::context 不存在;逐文件验证,不盲信 HEAD 可编译
- bindgen namespace 陷阱:mozjs fork 的 C 声明若落
namespace JS 内,mangled link_name 与全局作用域定义不匹配(JS_NewEmulatesUndefinedFunction 踩过)
- 双路径同步:改 usockets 事件标记语义(如 EPOLLHUP 的 LIBUS_POLL_EOF/HUP)时,
src/bao_uloop/src/poll.rs 的 Rust epoll 路径必须同改,否则 JS 线程与 HTTPThread 语义分叉
- crate 名陷阱:目录
src/bao_runtime 的包名是 bun_runtime;bao_engine 测试编译用 cargo check -p bao_engine --tests
5. 收口(波末一次)
- 全部 Agent 报告后统一验证:
cargo check 相关 crate + 关键测试 binary
- 一个吸收 wave 一个 commit(message 列全部 hash + 判定摘要);push
- 更新 .claude/upstream-baseline.json 并入 wave commit
- "需进一步判断"残留项登记任务,不静默丢弃
- 发布闭包(用户裁决 2026-08-23:测试过的波必须发布,与 daily-ops 波同轨):wave push 后立即执行 crates.io 变更闭包发布(变更闭包 patch bump → dry-run → publish → curl 200 验证)+
git tag daily-<YYYYMMDD> + gh release create(notes 取 wave commit message)。完整协议:../daily-ops/references/publish.md(版本策略/发布序/限流/失败语义/CLI 永不发布)。禁只 commit 不发布——发布是波末收口的组成部分,不是可选项。
6. 历史成果参考
- 2026-08-13/14 大吸收:Bun P0 三项(bodyless/UAF/spawn stdin)+ fetch 链路根治 + JSC 清光 + mozjs 0.21.4 全量升级(7314→0)。方法论完整记录在各 commit message 与 memory。
