目录:ACP 协议API 网关与控制器附件启动与插件管理客户端运行时客户端 UI 包上下文压缩上下文注入核心运行时凭据与授权交付物文档处理实验特性宿主扩展反馈通道文件系统目标与计划工具守卫Hooks 扩展宿主服务交互命令作业调度LLM 适配LSP 集成MCP 协议规划模式Agent 预设代码执行运行时运行时诊断沙箱定时调度SDK 与协议会话核心会话检索设置Shell 执行技能溢出存储SSH 远程执行存储子代理子进程终端待办类型契约框架 vendorWeb 访问Webhook工作流工作区
依赖链 · 上游（该插件依赖的前驱）：
dsh-api-gatewaydsh-api-remotesdsh-api-workspace-filesdsh-client-localedsh-client-resourcesdsh-client-ui-dockkitdsh-client-ui-primitivesdsh-client-ui-rendererdsh-client-ui-sessiondsh-client-ui-settingsdsh-client-ui-sidebar-rightdsh-host-webserverdsh-office-to-pdfdsh-session
依赖链 · 下游（依赖该插件的节点）：
同一拓扑层（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-sidebar-documentpreview |
|---|---|
| 分组 | G06 · 客户端 UI 包 |
| 拓扑层 | Layer 15（层次遍历：被依赖方先于依赖方） |
| 源码路径 | packages/client/ui-sidebar-documentpreview |
| 来源层 | L2 web-app bundle（base 之上装配） |
① 实现逻辑
浏览器半把 `text` tab 类型注册进 `ctx.sidebarRightTabs`（src/client/index.ts:93），并新建 DocumentPreviewRegistry 经 `ctx.reflect.provide('documentPreviews', ...)` 暴露为扩展点 seam（src/client/index.ts:90-92、54-58）。主体经键控槽 `sidebar.right.pane.tab` 注册 TextPreview 并声明 document 系列子槽（src/client/index.ts:103-117），标题经 `sidebar.right.pane.tab.title` 注册 TextTitle（src/client/index.ts:118-121）。随后依次装配 text/markdown/html/image/pdf/office/excel/code 八类渲染器（src/client/index.ts:122-129），每类都把定义注册进 documentPreviews 并注册 keyed 文档主体（如 src/client/code/index.ts:15-25）。node half 在 `webserver/index-inject` 时把校验过的预览配置注入页面全局（src/index.ts:14-16）。
内部结构动态 DAG（深色主题：橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件）
本插件
上游依赖
下游依赖
外部 seam
② 注册/提供（provides）
- sidebarDocumentPreview locale 命名空间字典
- ctx.documentPreviews（文件扩展名 → 文档渲染器定义注册表 seam，供各内建/外部预览类型注册）
- sidebarRightTabs 注册 'text' tab 类型定义（并扩展 SidebarRightResourceParamsMap.file 参数，src/client/index.ts:64-69）
- sidebar.right.pane.tab 键控条目 key=TEXTPREVIEW_ID：文档预览 body，声明 sidebar.right.tab.document / document.actions / document.unpreviewable / document.action 子槽
- sidebar.right.pane.tab.title 键控条目 key=TEXTPREVIEW_ID：预览标签标题
- 内建 8 类文档渲染器（text / markdown / html / image / pdf / office / excel / code）
- Host 侧页面全局 __DSH_DOCUMENT_PREVIEW_CONFIG__（预览缓存配置）
③ 依赖（depends_on · 上游前驱）
dsh-api-remotesE1+E2
经 remote 面读取工作区文件字节与分页文本
src/client/failure-line.ts:8 import (client) + src/client/index.ts:98 ctx.remote
dsh-api-workspace-filesE1
工作区文件读取的类型与 remote 调用签名
src/client/index.ts:21-22 import (/remote, /client) + src/client/document/resource-group.ts:3 import (/types)
dsh-client-localeE1+E2
注册并绑定预览文案
src/client/failure-line.ts:9 import + src/client/index.ts:94 ctx.locale.register
dsh-client-resourcesE1+E2
借用资源模型登记/固定被预览的文件资源
src/client/document/resource-group.ts:2 import (client) + src/client/index.ts:100 ctx.resources
dsh-client-ui-primitivesE1
复用加载指示与代码高亮扩展名等共享原语
src/client/LoadingIndicator.tsx:4 import + src/client/code/index.ts:3 import
dsh-client-ui-settingsE1+E2
html 预览经设置服务注册其配置表单
src/client/html/index.ts:8 import (client) + src/client/html/index.ts:35 ctx.configForms
dsh-client-ui-sidebar-rightE1+E2
经两级公共路径把预览类型、body 与标题注册进右侧边栏
src/client/definition.ts:11 import (client) + src/client/index.ts:93 ctx.sidebarRightTabs.register
dsh-host-webserverE1+E2
Host 侧向浏览器页面注入预览配置全局
src/index.ts:3 type-only import + src/index.ts:14 ctx.on('webserver/index-inject')
dsh-office-to-pdfE1
office 文档转 PDF 渲染
src/client/office/cache.ts:2 import (/types) + src/client/office/index.ts:5 import (/remote)
④ 被依赖（dependents · 下游消费者）
dsh-client-ui-chat
文件行号导航参数类型
src/client/apply.ts:13 file 路由参数类型 + src/client/apply.ts:218 openResource
dsh-client-ui-open-in-app
使用文档预览声明的路径动作槽
src/client/index.ts:13 import type + src/client/index.ts:104 slots.inject('sidebar.right.tab.document.actions')