34 lines
3.6 KiB
Markdown
34 lines
3.6 KiB
Markdown
|
# RFC：移除 `agent/steering` 镜像事件发射
|
|||
|
|
|
|||
|
|
[English](2026-07-04-remove-agent-steering-mirror.md) | 中文
|
|||
|
|
|
|||
|
|
Status: implemented
|
|||
|
|
|
|||
|
|
## 问题
|
|||
|
|
|
|||
|
|
`agent/steering` 是最后一个仍存在的、对持久会话事件的瞬态镜像。循环的 steering 排空逻辑先追加持久事件 `steering/message { turn, content, source }`，紧接着下一行就发射 `agent/steering(agent, turn, content, source)`——同一个事实以 fire-and-forget 事件的形式重复一遍（`packages/core/agent-loop/src/loop.ts`，`drainSteering`）。它在生产环境中没有任何监听者：唯一的订阅方是一个循环回归测试，断言该发射携带了 `source`——而这个事实在上一行的持久事件中已经记录。
|
|||
|
|
|
|||
|
|
`agent/steering` 以相同的 payload 复制了紧邻其前的持久事件 `steering/message`。`agent/queued` 则保留为纯 live 信号，因为它在持久化之前触发，覆盖了可能在进入日志前被取消的工作。
|
|||
|
|
|
|||
|
|
steering（中途引导）承载着真实的生产流量：钩子桥的轮次续行决策通过 `inbox.steer()` 注入原因，落地为持久的 `steering/message` 事件，钩子矩阵的 golden 文件固定了这些事件。所有这些消费方观察的都是持久事件，没有任何消费方观察镜像。
|
|||
|
|
|
|||
|
|
## 决策
|
|||
|
|
|
|||
|
|
`agent/steering` 从 agent 事件分类体系中移除：`packages/core/agent/src/types.ts` 中的声明（及其在 live-events JSDoc 列表中的提及）、`drainSteering` 中的发射（随之移除的还有当时已无用的 `ctx` 参数）、`packages/core/agent/README.md` 中的对应行，以及循环伪代码块中的发射行（`packages/core/agent-loop/src/loop.ts` 模块文档与 [architecture.md](../../../architecture.md)）；Cordis catalog 重新生成后不再包含它。唯一的回归测试改为在持久事件 `steering/message` 上固定 source 保持——它所固定的事实存在于日志中。
|
|||
|
|
|
|||
|
|
三份已实施的 RFC 曾声明保留该事件，每份均按 [implemented/AGENTS.md](../AGENTS.md) 修订，指向本 RFC 作为移除记录：[boundary RFC](2026-06-20-remove-agent-boundary-mirror-events.md) 的保留列表条目、[stream-chunk RFC](2026-07-02-remove-stream-chunk-mirror.md) 的范围条款，以及 [event-domain-semantics RFC](../architecture/2026-06-30-event-domain-semantics.md) 的瞬态发射枚举。
|
|||
|
|
|
|||
|
|
## 曾考虑的替代方案
|
|||
|
|
|
|||
|
|
### 为什么不保留？
|
|||
|
|
|
|||
|
|
"它是控制信号，不是边界事件"——但分类体系的实际区分维度是「镜像 vs 纯 live」，而非「控制 vs 边界」，而这个事件属于镜像。需要入队时通知的消费方有 `agent/queued`（带 steering flag）；需要排空时通知的消费方本质上是在请求 `steering/message` 被追加的那一刻，而 `session/event` 以相同 payload 加上持久性提供了这一点。被否决的 [retire-mid-turn-steering RFC](../../rejected/simplification/2026-06-20-retire-mid-turn-steering.md) 捍卫的是 steering **能力**——`steer()`、持久事件、续行强制——本次移除对这些全部不动。
|
|||
|
|
|
|||
|
|
## 验证
|
|||
|
|
|
|||
|
|
`agent/steering` 这一拼写仅存在于 RFC 行文中（本 RFC、上述三份修订后的 RFC，以及冻结的[被否决 steering 能力 RFC](../../rejected/simplification/2026-06-20-retire-mid-turn-steering.md)，其文本记录了它所拒绝的提案）；catalog 已重新生成；重定向后的测试在 `steering/message` 上固定 source 保持。
|
|||
|
|
|
|||
|
|
## 后果
|
|||
|
|
|
|||
|
|
没有需要迁移的生产监听者。两种 live 通知需求都保留了归属：入队时通知归 `agent/queued`（带 `steering` flag），排空时通知归 `session/event`（持久的 `steering/message` 落地时触发）。
|