本轮实测

为验证先给开发库种了最小内容(走真实 MCP 路径,server/discover 回 2026-07-28、46 工具): Notes 一分类 + 一系列 + 三章(含置顶 README)、Skills 一包两文件、About 全套。 章节正文刻意覆盖多级标题 / 代码块 / 宽表 / 行内 mono / 引用块。

• 桌面零改动(1280×800):导航条 44 flex、Tab Bar none、移动壳未挂载(只有一份 SSE)、 侧栏 260、右栏 428 —— 全是原值
• 硬约束:viewport 五项齐 / manifest 与三张图标全 200 / theme-color 明暗两条 / 玻璃走支持分支 / 输入框 16px / overscroll-behavior-y:none
• 每一屏都量过 body.scrollWidth === innerWidth === 390(页面永不横滚)
• 4e Sheet 高 422.57 = 视口 50%、圆角 20、实底白、投影与画板一致
• 4m 进度线 top:44 z:5(贴功能条底缘)、正文 15/1.75、h2 19、h3 17、 代码块横滚 784>353、宽表横滚
• 4h 四组网格、2 列 174×2、Sheet 与页面都不横滚
• 4p chip 条 [90x32 153x32] overflowX:auto、安装命令横滚 403>244、INSTALL r16 border0
• 4t 404 页四格字重 400,400,400,400、色全 #6b7280;导航回 /notes 后恢复 400,600,400,400
• tsc --noEmit 通过、bun test lib 21 通过

实现期发现并修掉的缺陷

1. 内联 display 盖过 .m-show-narrow —— 桌面上也冒出底部 Tab Bar。显隐一律交给 CSS。
2. SegmentedControl 的 font:"inherit" 简写把 fontSize/fontWeight 一起冲掉。
3. inset grouped 的行必须透明:画板里卡是 #f5f5f5、行不设背景;做成白底等于把卡盖住, 单行分组时完全看不出边界。同一错误在两个 Sheet 里各有一份。
4. .m-series-head 改 column 后必须显式 align-items:stretch —— 内联是 flex-start, 整宽主按钮只有 129px。
5. 移动端没法切主题(自己引入的回归):桌面导航条整条 display:none,而主题按钮在上面。 按 4r 搬进 About。
6. <label> 包受控 checkbox 会双触发 —— onChange 跑两次,classList.toggle 与 setDark 不同相,表现是「主题真的切了但开关视觉停在原位」。改 <button role="switch">。
7. .md-chapter 选择器选不中:components/Markdown 不套容器类,正文元素直接落在 .m-chapter-body 下。

待所有者审核 / 裁定

• ICP 备案号在移动端的位置,画板没画。当前:给内容区套一层定位容器,Tab Bar 贴它的底, 备案条在下面照旧可见,桌面因内外层 flex 属性一致而完全透明。要不要换位置请裁定。
• 安卓微信 fetch + resp.body.getReader() 的真机验证没做(需要真机)。按二次裁定 已不为微信优化,但 Runtime 的流式在任何移动浏览器上都该实测一次。
• 主题开关的像素态没确认 已查清并销项:getComputedStyle 读回关闭色不是 bug,是测量假象。 判据三步:① 直接用 JS 写 track.style.background 后 computed 仍不变,而无 transition 的 outline 立刻跟随 → 不是渲染器整体冻结,是带 transition 的属性卡住;② 窗口隐藏时不产生 动画帧,transition 时间线冻结,computed 因此永远停在起始值(等 700ms 也一样); ③ 临时 transition:none 强制回流后,旋钮 computed = matrix(1,0,0,1,20,0) 即 translateX(20px), 正是开启位(旋钮全程没被探针碰过,证据干净)。开关的功能与视觉都正确。 顺带得到一条通用教训:窗口不可见时,凡是带 transition 的属性都不能用 getComputedStyle 验, 要么读 style 属性、要么临时去掉 transition。
• 三条既有问题已记 rounds/BACKLOG.md:全站 ghost 按钮字号 14≠设计稿 12、 /skills/[name] 在 dev 下卡加载骨架(已排除是本轮改动)、各页 generateMetadata。

代码审查(codex,5 轮,收口 PASS)

前两轮全量 branch diff against main,第 3 轮起 --base <上一轮已审提交> 只审整改 diff (CLAUDE.md 的审查范围约定)。共 17 条 findings:16 条采纳整改、1 条实证不采纳; high 级为零,末两轮零 findings。

第 1 轮(8 条,全部采纳)

两条 P1 都会让移动端核心交互不可用:①输入栏被软件键盘整条盖住(iOS 只缩 visualViewport 不改布局视口)——这是 impl-prompt.md §3.3 早就写明、我却漏做的; ②输入栏与内容留白没计入 safe-bottom,而 Tab Bar 实际高度是 49 + safe-bottom, 34px Home Indicator 机型上重叠且 Tab Bar 的 z-index:5 盖住输入框下半部。 根因是我到处写裸的 49,已抽出 --m-top-inset / --m-bottom-inset 从源头堵住。 六条 P2:缩放拦截没有视口条件(吃掉了 macOS Safari 的触控板捏合,违反规则 7)、 --safe-top 无消费者、内容页底部只留 24px 被 Tab Bar 遮住、移动 RSS 仍是桌面弹层、 目录 Sheet 档位写着 61% 却传 50%、chip 条没有吸附。

第 2 轮(7 条,6 采纳 + 1 不采纳)

不采纳的那条(P1「Sheet 被滚动容器裁切/偏移」)—— 实证证伪,不加 portal。 用与站点完全同构的合成 DOM 测两次:①容器滚 800px 后 Sheet 相对外层仍是 200..400, 不随滚动偏移;②Sheet top:400 远超容器 200 可视高时 elementFromPoint 仍命中它, 未被裁切。原因是它的 containing block(布局层 position:relative 的外层)是滚动容器的 祖先 —— CSS 2.1 §11.1.1 的既定行为。

采纳的六条里有三条是我没读透画板:会话列表应是左侧滑出抽屉(画板 4j 标题就写着 「(左侧滑出)」,宽 84%、右两角 r20、右侧留 16% 露出被压暗的会话区,而我做成了 92% 全宽的 底部 Sheet,位置感与画板相反)、下拉刷新(画板明写「刷新图标 → 下拉刷新手势」, 并强调它「是移动端固有的交互原语,不是新功能」——所以不适用「非阻塞性 findings 不许新增机制」那条)、文件树丢了目录节点(scripts/run.py 与 references/run.py 会双双显示成无法区分的 run.py)。

第 3 轮(2 条 P2)

chip 骨架在 320 下把整页顶出横滚(346 塞进 288)。修法不是给骨架加横滚 —— 画板 4s 明写「加载态里没有真实内容,横滚容器留到内容到达后再出现」,并给了正解 「320/430 吸收差值 = 所有 width 用 % 的骨架条」。另一条:加载功能条中间槽空着, 而画板裁定原话是「omSpin(功能条中间的「正在取…」)」。

第 4 轮(零 findings,但自查另修一处)

复审零 findings,但它的推理轨迹里出现过 Confirming span-div invalid nesting 却没写进 findings。自己复核确认属实:DOM 里存在 DIV > SPAN > DIV —— 第 3 轮我用 <span className="m-hide-narrow"> 包了返回 <div> 的 LoadingNote。浏览器解析器 对 span > div 不像 <p> 那样自动闭合,所以没当场炸,但那是侥幸不是正确、且是水合隐患。 改为给 LoadingNote 加 className。审查没报不等于没问题。

收口门禁

dev.ps1 test 全绿(api 28 文件 564 用例 + web 21 用例)、apps/web tsc --noEmit 通过(门禁不跑它)、桌面四 tab 零改动实测通过。

生产发版(2026-09-08,be6c074)

所有者裁定「两件都没问题,打包上生产,我来验收移动端」—— 两件即上面留给裁定的 ICP 备案号在移动端的位置(画板没画,现按定位容器 + Tab Bar 贴其底、备案条在下方照旧可见) 与真机流式(只能靠真机)。当日合并 main(--no-ff)并发版。

• 改动面:相对生产在跑的 d9fefb4,apps/api / runner/ / deploy/ / tools/ 四处零改动,diff 只有 apps/web 38 个文件 + 文档 → 零迁移(15→15)、 部署资产重传同内容未 reload caddy、.env 只改 IMAGE_TAG(diff 核到全文件仅此一行)。 api 603 MB 与 runner 269 MB 全缓存命中,web 359 MB;tar 218.8 MB,ship 一次成功。
• 发版前先跑了一次基线冒烟,让本轮新增的 7 项判据全部 FAIL(manifest 与三枚图标 404、 viewport 还是 initial-scale=1、无 theme-color / rel=manifest);发版后同一脚本 33/33 全 PASS。这组正向对照不是形式:apps/web/Dockerfile 的 COPY /app/public ./public 是 R6 删 /admin 时连带删掉的,缺了不会构建失败 —— 站点照常起、只是图标 404, 除了这 7 项判据没有任何东西会报警。
• 容器复核 22 项 0 失败(容器随 up -d 重建,故照旧全查):bun 1.4.0 / 无真 node / none 档四项隔离 / egress 档三项 / 双向 403 network_mismatch / docker inspect 六项 / 宿主 xray-egress-filter enabled+active。 两处脚本自身的坑记下来:① api 容器里没有 curl,探 unix socket 要用 bun -e 的 fetch(url, { unix });② api 容器 ReadonlyRootfs=true, docker compose cp 进去会被拒(container rootfs is marked read-only),只能 -e 内联。
• 生产实测:移动 390×845 四个 Tab 全部 body.scrollWidth === innerWidth = 390、 Tab Bar 挂载、About 主题开关在位;桌面 1280×800 导航条可见 h44、左栏 260、右面板 428、 移动壳未挂载、Tab Bar display:none —— 与本轮之前逐项一致。
• 仍未验:真机(iOS Safari / 各家 webview)上的流式与手势,交所有者验收。

留证与完整口径见 docs/releases.md 的 be6c074 行。

发版后所有者验收报障一处(2026-09-08,0db08dd 修复)

会话抽屉选中行没划开就露着红色「删除」按钮,行内时间与 chevron 压在「删除」二字上。 根因是那一行的背景 rgba(37,99,235,0.06) 有 94% 透光,而删除按钮是常驻的绝对定位元素、 靠本行盖住它再用 translateX 露出来;未选中行的 var(--bg) 不透明所以正常。 改为 linear-gradient(实色叠加), var(--bg),渲染色不变、明暗主题各自跟 --bg 走。

值得记的不是这行样式,是它暴露的验收缺口:本轮移动端的自动化判据全是 与状态无关的整屏几何量(body.scrollWidth === innerWidth、Tab Bar 挂载、控件在位), 查不出「某一种状态下某一行画错了」。选中态只有在库里有会话且那一行进入视野时才出现, 跑过的几屏恰好没有。codex 五轮也没报 —— diff 里那一行单看语法与色值都对, 要发现它得同时接上「删除按钮常驻、靠这一行遮住」的上下文。

同类位置一并核过:SkillDetail.tsx:269 用同一色值做文件树选中态,底下没有被遮元素,不受影响。