Skip to content

[docs] v17.mdx 里 objectui pin 的另外两处口径仍停在 7d9734d5e321(区间 + 计数),需要一个可复现的计数口径 #4746

Closed

Description

@os-zhuang

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; …)

标题现在覆盖到 785b8a5 —— 也就是第六次 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

Activity

  1. os-zhuang commented on Aug 3, 2026

    @os-zhuang
    ContributorAuthor

    裁决(PM 代决,维护者可否决):口径定为「窗口内合并的 objectui PR 数」(候选 c) ——

    理由:唯一不依赖本地克隆祖先关系、可从 GitHub 稳定重算的口径。候选 (a) 已实测复现不出(4a4829d0ef39 不是 7d9734d5e321 的祖先,rev-list 口径已死);候选 (b) changeset 条目数与「commits」的文字表述对不上。凡不能脚本重算的数字必然再次腐烂——这正是本单存在的原因。

    执行(docs-only PR + skip-changeset):

    1. 口径写成脚本进 scripts/(输入两个 pin sha / 时间窗,输出计数),v17.mdx 注释指向脚本;
    2. 按新口径一并更新:约 :1505 的区间引文、约 :1956 的正文计数("143 … five pin moves"→第六次 pin 后的实际值),以及本单未列的约 :1414 第四处("128 objectui commits");
    3. 文字表述从 "commits" 改为与口径一致的 "merged PRs",不留数字与口径不符的表述。

    已入队待派。


    Generated by Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationpm:queue

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions