建议：给「跳转到某一轮」开一个对外接缝（scrollToTurn / turnOutline 已经有了）

[DDDMUC]

背景

我在写一个 Web GUI 插件，把"当前界面"同步进地址栏（#/session/<id>、#/panel/<panel>、#/settings/<分区> …），目标是让每个界面都能被链接。

现在 #/session/<id>/turn/<n> 这一层只能做反映（点击某一轮 → 地址栏记下轮号），驱动做不到：粘贴一个轮次链接时，我没有任何对外接缝能让会话滚到第 n 轮。

实测（0.2.0-rc.2）

• dsh-client-ui-chat 里有 turn rail（TurnNavigator：右侧 right:12px、28px 宽、虚拟化、hover 预览 prompt/response）
• 内部已有 scrollToTurn() / scrollToTurnAtOrAfter()，数据来自 turnOutline 投影（覆盖整个会话）
• 但都在包内部：
  • ctx.get('uiConversation') 在根插件 ctx 里是 undefined（实测；它属于会话作用域）
  • uiConversation.views 同样读不到；视图 tab 只能通过槽位 conversation.view 拿到 id 与顺序

请求

1. 一个服务：ctx.uiChat.scrollToTurn(turn: number)；
2. 或者一个窗口事件（生态里已有先例，例如任务看板的 dsh-taskboard-open-task）：

window.dispatchEvent(new CustomEvent('dsh-chat-scroll-to-turn', { detail: { sessionId, turn } }))

[PerryLink]

你的诉求成立 —— 滚动那一半确实没有对外接缝。但你的前提有两处错了，其中一处会直接影响你插件的写法，所以先纠正。

1. ⚠️ ctx.get('uiConversation') 拿到 undefined，不是因为它是会话作用域

uiConversation 是根级客户端服务，不是会话作用域服务：

• packages/client/ui-conversation/src/client/apply.ts:148-158 —— /** @param ctx - Client root context. */ 注释就写着，并且是用 root ctx 构造的：const uiConversation = new UiConversation(ctx, sessions)
• packages/client/ui-conversation/src/client/conversation/assembly.ts:185-192 定义 class UiConversation extends Service，:201 → super(ctx, 'uiConversation')
• packages/client/ui-conversation/src/client/index.ts:82-88 在 Context 上做了声明合并

而且至少 7 个官方插件就在同级 ctx 直接注入使用：ui-deliverables/src/client/index.ts:43、ui-trajectory/src/client/index.ts:41、ui-goal/src/client/index.ts:61、ui-plan/src/client/index.ts:52、ui-schedule/src/client/index.ts:78、ui-user-questions/src/client/index.ts:56、ui-tool/src/client/tool/toolviews/todo-row.tsx:83（inject: ['slots', 'uiConversation']）。

所以真实原因只有两种：

1. 你的插件没在 inject 里声明它 —— cordis 下未声明的 ctx.get 拿不到服务。修法：export const inject = ['slots', 'uiConversation', …]，然后用 ctx.uiConversation。
2. 查询时机早于 ui-conversation 激活 —— ui-conversation/tests/apply-wiring.client.spec.tsx:139-143 正是「插件 fiber 销毁后 ctx.get('uiConversation') 变 undefined」的断言。

顺带：uiConversation.views 读不到也是同一个原因 —— views 是 UiConversation 的 public readonly 字段（assembly.ts:190，旁边还有 events/groups），按 (1) 修好就能直接读。

真正是会话作用域的是 binding，不是服务：assembly.ts:237-258 的 binding(source) 返回 ConversationBinding 并挂 owner.ctx.effect(...) 做作用域。这一点对你后面设计接缝很重要（见第 4 节）。

2. 你说"内部已有 scrollToTurn()"—— 名字对，但那是两个不同的东西

• packages/client/ui-chat/src/client/chat/TurnNavigator.tsx:21-26 的 TurnNavigatorHandle.scrollToTurn(turn) —— 只滚轨道、不滚正文，它自己的注释写着 center in the rail without navigating the transcript（实现 :200-210）
• 真正滚正文的是 packages/client/ui-chat/src/client/chat/use-chat-viewport.ts:323 的 scrollToTurn(turn) 与 :335 的 scrollToTurnAtOrAfter(turn)（调用点 use-chat-navigation.ts:72,147,159）

两个都不在包的导出面里：packages/client/ui-chat/package.json:16-27 的 exports 只有 "." / "./client" / "./src/*" / "./package.json"，而 src/client/index.ts 除 apply/inject 外全是 export type（只有 isRunningTool/isSettledTool/EMPTY_CHAT_SNAPSHOT 三个值）。ui-chat 本身也不 provide 任何服务。

⇒ 所以你请求的接缝确实不存在 —— 这一点你是对的，只是理由（服务拿不到）说错了。把理由改对，报告的采纳率会完全不同。

3. 数据那一半已经是对外接缝了

turnOutline 是 ctx.sessionProjections 上注册的一个投影 unit：

• 定义：packages/session/session-turn-outline/src/projection.ts:85-86 → export const turnOutlineProjectionDefinition = { key: 'turnOutline', … }；注册在 src/index.ts:28
• 条目形状：src/types.ts:15-24 → TurnOutlineEntry { turn, seq, prompt, response }。:18 的注释很关键：seq 是该轮 turn/start 事件的 seq，用它往回翻页就能载入整轮
• hook 读法：packages/client/ui-chat/src/client/chat/ChatView.tsx:78 → useProjection('turnOutline')（任何 session 作用域 slot 子组件都能拿到）
• 命令式读法：packages/api/session-controller/src/client/contract/session.ts:59 → faceOf(key: string): ObservableSnapshot<unknown>，:67 的 readonly projections: ProjectionsFace

4. 关于你的两条建议

(1) 加一个服务 —— 方向可行，但名字与签名都要改。
ctx.uiChat 不存在：git grep -n "uiChat" origin/master -- packages 0 命中（全仓 26 处命中全在 .agents/notes 里指 TUI 的 createTuiChat）。合理落点是在 ui-chat 里新增一个 root 服务，并且必须带上 sessionId —— uiConversation 虽是根服务，但视图是 per-session 的（assembly.ts:237-258 的 binding 才是会话作用域），而 scrollToTurn 天然需要一个"当前会话"的 viewport 实例。所以签名更像 scrollToTurn(sessionId, turn) 而不是 scrollToTurn(turn)。

(2) window 自定义事件 —— 与 core 现状不符，建议改措辞。
你写"生态里已有先例 dsh-taskboard-open-task"，但 core 全仓 0 命中：git grep -n "CustomEvent(" origin/master -- packages 也是 0，window.addEventListener 全是 keydown/scroll/resize/blur/storage/pointer 等标准事件。core 里也没有任何地址栏 hash 路由（location.hash/hashchange/pushState/replaceState 在 packages/client + packages/bundle 下 0 命中）。
所以那不是本仓机制（应是第三方插件自己的约定）。要走这条路等于新增一种跨插件约定，建议按"请求新增约定"提，而不要按"已有先例"提 —— 后者会被一句"哪来的先例"挡回，还会牵连你另外那部分的可信度。

5. ⭐ 今天就能跑通的等效方案（纯公开 API，不用等新接缝）

// 前提：export const inject = ['slots', 'uiConversation', 'sessions', …]
const binding = ctx.uiConversation.binding(sessionId)
await binding.session.loadThrough(entry.seq)          // entry 来自 turnOutline
document.querySelector(`[data-chat-turn="${turn}"]`)
  ?.scrollIntoView({ block: 'start' })

依据：

• loadThrough(seq) 是公开的 slot 契约：packages/client/ui-chat/src/client/contract/slots.ts:301-302 → /** Jump loader: page history back through seq; resolves when the window covers it. */ loadThrough: (seq: SessionSeq) => Promise<void>（apply.ts:274 接到 session.loadThrough(seq)）—— 它已经处理了"该轮还没加载就先分页"的问题
• 选择器与 DSH 自己的视口查询用的是同一个：ChatNodeSeat.tsx:157 输出 data-chat-turn={turn}（分组行在 ChatGroupSeat.tsx:187），而 use-chat-viewport.ts:337 就是 querySelectorAll('[data-chat-turn]:not([hidden]):not([hidden] *)')

代价要说清：这样没有轨道（rail）的落点动画与游标居中，需要你自己处理高亮/居中；activateTurn 的语义也拿不到。

6. 结论口径建议

把报告改成三句话会更有效：① turnOutline 已是可用接缝（给两条读法）；② scrollToTurn / scrollToTurnAtOrAfter 是内部实现、不在导出面，ui-chat 也不 provide 服务 ⇒ 缺的正是"驱动"那一半；③ 请求在 ui-chat 新增 root 服务 scrollToTurn(sessionId, turn)，内部复用 use-chat-navigation.ts:147 已有的 scrollToTurnAtOrAfter 回退路径。至于 uiConversation 拿不到与 dsh-taskboard-open-task 先例这两条，建议删掉。

[DDDMUC]

谢谢，指正的两处都核实了，inject 那条确实是自己的问题（已修，uiConversation.views 现在能直读，视图层比之前稳了）。

按你第 6 节的口径重写诉求：

1. 数据侧已经是接缝 ✓：turnOutline 在 ctx.sessionProjections 上，session.projections.faceOf("turnOutline").getSnapshot() 可读，条目 {turn, seq, prompt, response}。
2. 缺的是"驱动"那一半 ✓：scrollToTurn(turn) / scrollToTurnAtOrAfter(turn) 在 use-chat-viewport.ts 内部、不在导出面；TurnNavigatorHandle.scrollToTurn 只滚轨道。ui-chat 也不 provide 服务。
3. 请求：在 ui-chat 新增 root 服务 scrollToTurn(sessionId, turn)，内部复用 use-chat-navigation.ts:147 已有的 scrollToTurnAtOrAfter 回退路径。

另外补一条我刚跑完的实测（也许对设计有参考）：根插件连"分页回去"都做不到 —— loadThrough(seq) 在 session 上，而 session 只在会话作用域内拿得到（ctx.sessions.binding(id) 在根 ctx 返回 undefined）。我试过官方家系插件的路子（给 session 作用域的 slot 挂条目、用 inject:(sessionId)=>），发现：

• conversation.chat.turnTail 是 chat 的 conversation.chat.node 条目通过 children 声明的，不是顶层 slot，在根插件里 inject 回调根本不触发；
• 顶层 session 作用域的 conversation.view 会触发，但每登记一颗条目就多一颗可见页签 —— 等于拿渲染换能力，不能用。

所以如果开缝，能顺带覆盖这个场景的是其中任意一种：① uiChat.scrollToTurn(sessionId, turn) 内部自己 loadThrough + 滚座位（最省插件方的事）；② 或者把 loadThrough/turnOutline 也开一个根级只读入口。

（#msg= 那条"生态先例"已删 —— 那是我与第三方插件私下约定，不是 core 机制，谢谢拦住。）