From e20b01183514239a6d9f1964baaf57561a89ae73 Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 2 Aug 2026 16:35:58 +0000 Subject: [PATCH] =?UTF-8?q?docs(changeset):=20C5=20=E6=94=B6=E6=95=9B?= =?UTF-8?q?=E7=9A=84=20changeset=20=E8=A1=A5=E4=B8=8A=E4=B8=8E=20#4664=20`?= =?UTF-8?q?placement`=20=E7=9A=84=E5=8C=BA=E5=88=86=E8=AF=B4=E6=98=8E=20(#?= =?UTF-8?q?4653)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit PR #4662 合并时,这段说明还在未提交状态(worktree 被清理时一并丢失), 故补一个 changeset-only 的跟进。无代码改动。 同窗口的 #4664 退休了 `app.contextSelectors[].placement`,而它的退休说明 里写着「`location` 曾是 `placement` 的别名」。Studio 插件的面板贡献点恰好 也有一个 `location` 键(`studio/PanelContribution.location`),两者在不同 schema 上、取值域不同、互不相关 —— 但对着 v17 release notes 逐条读的作者 很容易把两件事连起来,以为 `contributes.panels[].location` 也要改。 changeset 里主动写清这个区分,挡掉误解;同时记下另外四个退休键与 #4668 与 `activationEvents` 均无语义交叉。 Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_01M9uWvoEp9CoLzYjNExj9sL --- .changeset/converge-activation-event-schema.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/.changeset/converge-activation-event-schema.md b/.changeset/converge-activation-event-schema.md index 836c0b6989..d9c93300c7 100644 --- a/.changeset/converge-activation-event-schema.md +++ b/.changeset/converge-activation-event-schema.md @@ -70,6 +70,20 @@ enum 取**两侧 v17 前词表的并集**,共 9 个值: 手工迁移步骤:按上表把每个字符串改写成 `{ type, pattern }`。**漏改会在 parse 处响亮失败** —— `StudioPluginManifestSchema` 是 `strictObject`,字符串遇到对象 schema 直接抛错,不存在静默吞掉或强制转换。 +## 不要与同窗口的 #4509 / #4664 退休项混淆 + +v17 同窗口的 #4664 退休了五个键。其中 **`app.contextSelectors[].placement`** 与本条变更**毫无关系**,但很容易被读成有关系 —— 那条退休说明里写着「`location` 曾是 `placement` 的别名」,而 Studio 插件的面板贡献点**恰好也有一个 `location` 键**: + +| | 被 #4664 退休的 | 本次变更**未动**的 | +|:--|:--|:--| +| 键 | `ui/App.contextSelectors[].placement`(`location` 是它的别名) | `studio/PanelContribution.location` | +| 语义 | app 的上下文选择器渲染在哪(`sidebar_header` / `topbar`) | Studio 插件的辅助面板停靠在哪(`bottom` / `right` / `modal`) | +| 状态 | 已删除 | **原样保留**,仍是可作者化键 | + +两者在不同 schema 上、取值域不同、互不相关。写 Studio 插件的作者**不需要**因为 #4664 去动 `contributes.panels[].location`。 + +其余四个退休键(`mapping.extractQuery` / `mapping.errorPolicy` / `mapping.batchSize` / `app.contextSelectors[].includeAll`)与 `activationEvents` 无任何语义交叉;同窗口的 #4668(ADR-0119 D2 migration journal)亦然。 + ## 其它影响 - `@objectstack/spec/studio` 现在**额外导出** `ActivationEvent` 类型(此前只有 schema),与 `./kernel` 指向同一份声明。