目录:ACP 协议API 网关与控制器附件启动与插件管理客户端运行时客户端 UI 包上下文压缩上下文注入核心运行时凭据与授权交付物文档处理实验特性宿主扩展反馈通道文件系统目标与计划工具守卫Hooks 扩展宿主服务交互命令作业调度LLM 适配LSP 集成MCP 协议规划模式Agent 预设代码执行运行时运行时诊断沙箱定时调度SDK 与协议会话核心会话检索设置Shell 执行技能溢出存储SSH 远程执行存储子代理子进程终端待办类型契约框架 vendorWeb 访问Webhook工作流工作区
依赖链 · 上游（该插件依赖的前驱）：
dsh-api-remotesdsh-api-session-controllerdsh-client-localedsh-client-ui-input-triggerdsh-client-ui-primitivesdsh-client-ui-sidebar-rightdsh-session-reference
依赖链 · 下游（依赖该插件的节点）：
无下游（叶子/被消费端）
同一拓扑层（Layer 15，层次遍历层序）：
dsh-client-ui-agent-presetdsh-client-ui-brand-officialdsh-client-ui-commandsdsh-client-ui-directory-picker-browsedsh-client-ui-directory-picker-nativedsh-client-ui-plugin-managerdsh-client-ui-referencedsh-client-ui-scheduledsh-client-ui-sidebar-browserdsh-client-ui-sidebar-documentpreviewdsh-client-ui-sidebar-filesdsh-client-ui-sidebar-terminaldsh-client-ui-skilldsh-client-ui-subagentdsh-client-ui-workflow-rundsh-experimental-client-ui-agent-team
插件信息
| 包名 | @deepseek-ai/dsh-client-ui-reference |
|---|---|
| 分组 | G06 · 客户端 UI 包 |
| 拓扑层 | Layer 15（层次遍历：被依赖方先于依赖方） |
| 源码路径 | packages/client/ui-reference |
| 来源层 | L2 web-app bundle（base 之上装配） |
① 实现逻辑
注册一个 '@' 输入触发源：候选阶段先确保目标 Session 已 retain 且历史 open，再并行发起 fileReferences.list 与 sessionReferenceResolver.candidates（src/client/index.ts:60-76），失败通道降级为空集；随后分别映射文件候选（含目录 drill 语义与父目录描述，index.ts:212-242）与会话候选（区分子会话/普通会话并附工作区与相对时间，index.ts:244-260）。onPick 把候选 value 反解为 file/session：文件返回可插入引用文本，目录在 drill 动作下保留继续下钻（index.ts:96-135）；openReference 则经 sidebarRight.openResource 打开文件地址（index.ts:143-151）。最后经 inputTriggers.registerSource 挂载（index.ts:158）。
内部结构动态 DAG（深色主题：橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件）
本插件
上游依赖
下游依赖
外部 seam
② 注册/提供（provides）
- ctx.inputTriggers 的 '@' 参考源（@文件 / @会话统一候选、分组、相对时间与工作区标签）
- 目录下钻的面包屑 header 与 drill 继续语义
- 参考插入/剪贴板序列化 codec 与文件引用在右侧栏打开（openReference）
③ 依赖（depends_on · 上游前驱）
dsh-api-remotesE1+E2
文件与会话候选的 Remote 查询
src/client/index.ts:17 import type + src/client/index.ts:71 ctx.remote.fileReferences.list
dsh-api-session-controllerE1+E2
retain 会话并用 using() 挂参考候选数据源
src/client/index.ts:11 import type { ISessions } + src/client/index.ts:53 ctx.get('sessions')
dsh-client-localeE2
注册 reference 文案
src/client/index.ts:19 import type + src/client/index.ts:51 ctx.locale.register(NS)
dsh-client-ui-input-triggerE1+E2
注册 '@' 触发源并消费其 Source/Crumb 契约
src/client/index.ts:26 import type + src/client/index.ts:158 inputTriggers.registerSource
dsh-client-ui-sidebar-rightE1+E2
在右侧栏打开被引用的文件
src/client/index.ts:20 import type + src/client/index.ts:149 ctx.sidebarRight.openResource
④ 被依赖（dependents · 下游消费者）
无下游（叶子/被消费端）