Session Reference zh

会话引用

上游跨会话引用系统——Edge 中未实现。

上游参考：会话引用文档

上游提供了什么

会话引用提供两个能力：

• 文件引用（dsh-file-reference）— 在 agent 工作目录内的可取消文件发现，返回按查询文本过滤的路径候选。驱动编辑器中的 @file 提及语法。
• 会话引用（dsh-session-reference）— 通过结构化 @session 提及实现跨会话上下文。列出按工作目录亲和度排名的引用候选，从多个被引用会话准备不可变的聚合上下文。

两个服务都暴露 Typert Remote 方法，客户端通过 ctx.remote.fileReference 和 ctx.remote.sessionReference 命名空间访问。

Edge 状态

未实现

Edge 的依赖中没有 dsh-file-reference 和 dsh-session-reference。没有安装宿主端插件。客户端的 Typert remote 贡献由 dsh-api-remotes（33 个客户端插件之一）挂载，但没有宿主端服务，Typert 网关对任何 RPC 调用返回 service-unavailable。

用户可见影响

• 编辑器中的 @file 提及不会产生文件补全建议
• @session 提及不会产生跨会话上下文引用
• 模型仍可通过 read/write 工具访问文件；仅缺少编辑器提及 UX

TODO

评估 file-reference 安装。FileReferenceService 通过文件系统发现文件。Edge 在 ctx.fs 上有 EdgeFileSystem，服务的依赖可能已满足。如果 inject 要求满足，安装它可以用零适配器代码启用 @file 提及——Typert 网关会自动路由 RPC。

评估 session-reference 安装。SessionReferenceResolver 读取其他 session 的记录。需要 ctx.sessions（已有）和可能的 ctx.sessionPersistence 用于冷 session 读取。可能需要类似投影缓存 cold-snapshot 路径的 Edge 专属冷读支持。