目录:ACP 协议API 网关与控制器附件启动与插件管理客户端运行时客户端 UI 包上下文压缩上下文注入核心运行时凭据与授权交付物文档处理实验特性宿主扩展反馈通道文件系统目标与计划工具守卫Hooks 扩展宿主服务交互命令作业调度LLM 适配LSP 集成MCP 协议规划模式Agent 预设代码执行运行时运行时诊断沙箱定时调度SDK 与协议会话核心会话检索设置Shell 执行技能溢出存储SSH 远程执行存储子代理子进程终端待办类型契约框架 vendorWeb 访问Webhook工作流工作区
依赖链 · 上游(该插件依赖的前驱):
依赖链 · 下游(依赖该插件的节点):
dsh-client-ui-deliverablesdsh-client-ui-sidebar-browserdsh-client-ui-sidebar-documentpreviewdsh-client-ui-sidebar-filesdsh-client-ui-sidebar-rightdsh-client-web
同一拓扑层(Layer 1,层次遍历层序):
插件信息
| 包名 | @deepseek-ai/dsh-client-ui-dockkit |
|---|---|
| 分组 | G06 · 客户端 UI 包 |
| 拓扑层 | Layer 1(层次遍历:被依赖方先于依赖方) |
| 源码路径 | packages/client/ui-dockkit |
| 来源层 | L3 其余插件(独立于 bundle 装配的扩展/变体/示例) |
① 实现逻辑
零 cordis 的停靠布局库:引擎层是纯 TS——applyOp/replay 与 Sequencer 记录可逆布局操作,DockController 每个方法都是 planner 调用加记录加一次通知,getSnapshot 的引用只在布局变化时改变 (src/engine/controller.ts:1-14, 54-80; src/index.ts:26-59)。组件层渲染布局快照并只回报每次手势的 settled intent,tab 的 kind 是不透明字符串,宿主概念(DockLabels/TabRenderer)全部由嵌入方注入 (src/index.ts:1-18, 62-70)。包内不注册任何槽位、没有 apply,只被其他客户端包以引擎/组件 API 消费。
内部结构动态 DAG(深色主题:橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件)
本插件
上游依赖
下游依赖
外部 seam
② 注册/提供(provides)
- 引擎 API:applyOp/replay、Sequencer/record/stepBack/stepForward/canStepBack/canStepForward、tree 查询 (getNode/getPane/findTabPane 等)
- 约束与几何:canSplit/clampSizes/DOCK_ZONES/MAX_DOCK_PANES、containsPoint/dividerSizes/floatRectAt/SPLIT_MINIMUMS
- 意图规划纯函数:planAddTab/planDropTab/planSplitPane/planResizeSplit/planFloatTab/planOpenContent 等
- DockController (每停靠面的状态化嵌入,subscribe+getSnapshot 可观察快照) 与 createIdMinter/createInitialState
- React 组件 DockSurface/DockLayout/FloatLayer 及外向契约 DockIntents/DockLabels/TabRenderer/TabMenuExtras
- 类型 LayoutState/LayoutOp/DockZone/PaneId/SplitId/TabId/LayoutNode 等
③ 依赖(depends_on · 上游前驱)
dsh-client-ui-primitivesE1
菜单/面板等基础组件
src/components/FloatLayer.tsx:19 + src/components/TabMenu.tsx:17-21 + src/components/TabPanel.tsx:26
④ 被依赖(dependents · 下游消费者)
dsh-client-ui-deliverables
review tab 的 TabId 类型
src/client/review-store.ts:8 import type TabId from @deepseek-ai/dsh-client-ui-dockkit
dsh-client-ui-sidebar-browser
复用 dock 标签/布局原语
src/client/browser/BrowserController.ts:3 import + src/client/browser/store.ts:3 import
dsh-client-ui-sidebar-right
dock 布局/标签 id 与纯规划器
src/client/contract/slots.ts:29 import (client) + src/client/index.ts:47 import type TabId