docs(changeset): C5 收敛的 changeset 补上与 #4664 placement 的区分说明 (#4653)

[os-zhuang]

跟进 #4653 / PR #4662(已合并为 65ca83a58)。Changeset-only,零代码改动。

为什么有这个 PR

协调者要求在 changeset 里交代「#4664 退的五个 key 与 activationEvents 是否有语义交叉」(参照 C8 对 mapping.errorPolicy 的处理)。我查出了一个确实容易被误读的near-miss 并写好了说明,但那次编辑还处于未提交状态时 PR #4662 就被合并、worktree 随即被清理,这段文字因此没能随 #4662 落地。补上。

补的是什么

同窗口的 #4664 退休了 app.contextSelectors[].placement,其退休说明里写着「location 曾是 placement 的别名」。而 Studio 插件的面板贡献点恰好也有一个 location 键:

	被 #4664 退休的	C5 未动的
键	ui/App.contextSelectors[].placement(别名 location)	studio/PanelContribution.location
语义	app 上下文选择器渲染在哪(sidebar_header / topbar)	Studio 插件辅助面板停靠在哪(bottom / right / modal)
状态	已删除	原样保留,仍是可作者化键

对着 v17 release notes 逐条读的插件作者很容易把两件事连起来,以为 contributes.panels[].location 也要跟着改 —— 实际不需要。changeset 主动挡掉这个误解。

同时记下:另外四个退休键(mapping.extractQuery / mapping.errorPolicy / mapping.batchSize / app.contextSelectors[].includeAll)以及 #4668(ADR-0119 D2 migration journal)与 activationEvents 均无语义交叉(已逐一核过,#4668 全 diff 对 ActivationEvent / activationEvents 零命中)。

时效

.changeset/pre.json 仍是 mode: pre / tag: rc,converge-activation-event-schema.md 尚未被消费,所以这段文字仍能进入 v17 release notes。changeset pre exit 之后就来不及了。

顺带汇报:main 上 C5 的落地状态已复核,健康

PR #4662 经合并队列 rebase 后落在 main 为 65ca83a58(SHA 与我推的 52a5de34a 不同,内容一致)。队列替我解了 authorable-surface.json / api-surface.json 两个生成物的冲突 —— 我在 main 上重新验了一遍:

• 字节级 round-trip:build → gen:schema → gen:api-surface 后 git diff 空,即 main 上这两个生成物确实是生成器的输出,队列的自动解决没有产生漂移(这正是我在 authorable-surface.json 在 main 上不是 gen:schema 的输出 —— 基线手编的字节级实锤(#4650 加固建议) #4663 里建议的那条检查)。
• 三方内容都在:我的 studio/ActivationEvent:pattern / :type 在;feat(spec)!: 退役五个「lint 永远无法告警」的键，并接通 doc.tags (#4509) #4664 退的五个键正确缺席;feat(core,platform-objects,spec): ADR-0119 D2 — the migration-journal runner (#4617) #4668 的 system/Migration* 键在。总计 8260 个 key。
• check:dual-source-exports → 21 accepted dual-source,基线文件 21 行。
• 两个被 pin 的测试文件 58/58 绿。

---

🤖 Generated with Claude Code

https://claude.ai/code/session_01M9uWvoEp9CoLzYjNExj9sL

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
objectstack	Ignored		Aug 2, 2026 4:36pm