PR #4744(docs-only,Fixes #4733)按单子要求只把 console 段标题的区间换成了 `4a4829d0ef39 → 785b8a5d432c`。落笔时发现同一页还有两处描述同一件事的文字**没**跟着动 —— 单子明文限定「一个新条目 + 一处区间替换,不顺手修别的段落」,所以按仓规单开一单记录,不在那个 PR 里改。 未认领,谁接谁 assign。 ## 现状(`content/docs/releases/v17.mdx`,以 #4744 合并后为准) **1. `## Landed since 17.0.0-rc.0` 开头的引文(约 :1468)** > …Console from the objectui pin advancing `4a4829d0ef39 → 7d9734d5e321`(79 commits, released as **objectui 17.1.0**)。 `.objectui-sha` 在 `main` 上已经是 `785b8a5d432cf009389a1a9180fdac2a8297543f`(#4732 合并),所以这个区间和标题段已经对不上了。 **2. console 段标题下的正文第一句(约 :1919,#4744 改完标题后紧跟着的一行)** > 143 objectui commits across five pin moves, released as **objectui 17.1.0**. > (The pin changesets enumerate 79 of them; …) 标题现在覆盖到 785b8a5d432c —— 也就是第**六**次 pin 移动 —— 正文却仍说 five pin moves / 143 commits。 ## 为什么 #4744 没有顺手改 不是遗漏,是**改不出可信的数**: - 本地 objectui 克隆里 `git merge-base --is-ancestor 4a4829d0ef39 7d9734d5e321` 判定**不是祖先**,`git rev-list --count 4a4829d0ef39..7d9734d5e321` 只有 3 —— 显然不是「79 commits」「143 commits」的来源口径。 - 所以原作者用的是别的计数方式(可能按 PR 数、按各次 pin changeset 枚举行数、或跨 objectui 的 PR 分支而非 `main` 线性历史),复不出来。 - 在复不出口径的前提下把「five」改成「six」、把 143 改成某个新数字,是凭空造数 —— 比留着旧数更糟,因为旧数至少还能追溯到当初那次写作。 ## 建议的处理方式(需要维护者定口径) 1. **先定口径**:这一族数字到底数什么?候选 —— (a) `.objectui-sha` 各次 pin 之间 objectui `main` 上的提交数;(b) 各次 pin changeset 枚举的条目数;(c) 该窗口内合并的 objectui PR 数。三者会给出三个不同的数,现在页面上「143 / 79 / five」三个数已经是两三种口径混着写。 2. **口径定了就让它可复现**:最好是一条脚本/命令写进注释或 `scripts/`,下一次 pin 移动时任何人(含 agent)都能重算,而不是每次靠人肉记账 —— 这一族数字每次 pin 刷新都会失真一次,它现在的失效频率就是「每次 pin 刷新」。 3. 然后一并把 :1468 的区间和正文计数更新到当前 pin。 同样是 docs-only,走独立 PR(CLAUDE.md 的 releases 页正门),`skip-changeset` 标签。 Refs #4733、PR #4744、PR #4732。 --- _Generated by [Claude Code](https://claude.ai/code/session_015Br2xsJsczFsTR9bvbh2Ny)_
Activity
os-zhuang commentedon Aug 3, 2026
裁决(PM 代决,维护者可否决):口径定为「窗口内合并的 objectui PR 数」(候选 c) ——
理由:唯一不依赖本地克隆祖先关系、可从 GitHub 稳定重算的口径。候选 (a) 已实测复现不出(
4a4829d0ef39不是7d9734d5e321的祖先,rev-list 口径已死);候选 (b) changeset 条目数与「commits」的文字表述对不上。凡不能脚本重算的数字必然再次腐烂——这正是本单存在的原因。执行(docs-only PR + skip-changeset):
scripts/(输入两个 pin sha / 时间窗,输出计数),v17.mdx 注释指向脚本;已入队待派。
Generated by Claude Code