目录:ACP 协议API 网关与控制器附件启动与插件管理客户端运行时客户端 UI 包上下文压缩上下文注入核心运行时凭据与授权交付物文档处理实验特性宿主扩展反馈通道文件系统目标与计划工具守卫Hooks 扩展宿主服务交互命令作业调度LLM 适配LSP 集成MCP 协议规划模式Agent 预设代码执行运行时运行时诊断沙箱定时调度SDK 与协议会话核心会话检索设置Shell 执行技能溢出存储SSH 远程执行存储子代理子进程终端待办类型契约框架 vendorWeb 访问Webhook工作流工作区
依赖链 · 上游（该插件依赖的前驱）：
依赖链 · 下游（依赖该插件的节点）：
dsh-api-remotesdsh-api-session-controllerdsh-client-ui-conversationdsh-experimental-webworker-runtime
同一拓扑层（Layer 5，层次遍历层序）：
dsh-agent-default-modeldsh-agent-instructionsdsh-agent-loopdsh-agent-preset-registrydsh-agent-tool-presentationdsh-api-account-controllerdsh-api-settings-controllerdsh-api-terminal-controllerdsh-api-workspace-filesdsh-bash-sandboxdsh-client-file-uploaddsh-compaction-image-offloaddsh-compaction-tool-result-prunerdsh-cordis-host-runnerdsh-experimental-browser-use-chrome-devtools-mcpdsh-experimental-browser-use-playwright-mcpdsh-experimental-tool-agent-teamdsh-file-reference-localdsh-fs-sandboxdsh-fs-sshdsh-goaldsh-hooks-codexdsh-jobs-localdsh-llm-retrydsh-mcp-resourcesdsh-message-feedbackdsh-permission-presetsdsh-ptc-runtime-nodedsh-pwsh-sandboxdsh-repeat-tool-reminderdsh-sdk-jsonrpc-serverdsh-session-checkpoint-policydsh-session-referencedsh-session-title-all-prompts-llmdsh-session-title-first-prompt-llmdsh-spill-policydsh-terminaldsh-time-contextdsh-tmux-contextdsh-tool-bashdsh-tool-call-timeout-policydsh-tool-fsdsh-tool-fs-searchdsh-tool-jobsdsh-tool-lspdsh-tool-presentdsh-tool-pwshdsh-tool-session-querydsh-tool-skilldsh-tool-str-replace-editordsh-tool-tododsh-tool-webdsh-tool-workspace-dependenciesdsh-user-questionsdsh-web-search-deepseek
插件信息
| 包名 | @deepseek-ai/dsh-client-file-upload |
|---|---|
| 分组 | G05 · 客户端运行时 |
| 拓扑层 | Layer 5（层次遍历：被依赖方先于依赖方） |
| 源码路径 | packages/client/file-upload |
| 来源层 | L2 web-app bundle（base 之上装配） |
① 实现逻辑
Host 侧 `FileUploads extends TypertRemoteService` 承接待上传文件：`upload` 走 base64 编码路径、`uploadStream` 走原始字节流，均委托 `ctx.attachments` 落盘 (src/index.ts:105-131)，并在 Agent 会话作用域下以 receiptId 暂存，`bindPrompt`/`retirePrompt` 随 prompt 生命周期提交或回滚绑定 (src/index.ts:139-181)。它向 Connection 注册 `POST` 流式路由 `handleFileUploadHttp`，校验 content-type 与 sessionId 后把请求体转成 AsyncIterable (src/index.ts:72-80, src/http-route.ts:22-81)，并通过 `session/event` 观察 user/message 来退役已消费 receipt (src/index.ts:241-254)。
内部结构动态 DAG（深色主题：橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件）
本插件
上游依赖
下游依赖
外部 seam
② 注册/提供（provides）
- ctx.fileUploads (Host 侧文件上传存储与 Agent 级暂存 receipt 服务)
- 上传 HTTP 流式路由 (FILE_UPLOAD_PATH，application/octet-stream)
- CommandFileReceiptResolver 注册 (让命令层解析上传 receipt)
- ctx.fileUpload (浏览器侧后台上传服务 FileUploadRuntime)
③ 依赖（depends_on · 上游前驱）
dsh-agentE1+E2
以接收 Agent 及其 session 作为上传暂存的作用域与生命周期主体
src/index.ts:5 + src/index.ts:58 static inject 'agents' + src/index.ts:199 ctx.agents.get
dsh-client-connectionE1+E2
在 Connection 的 fetch 注册表上挂原始字节上传路由
src/index.ts:7 + src/index.ts:58 inject 'connection' + src/index.ts:73 ctx.connection.fetch.register
dsh-commandsE2
让命令 prompt 能解析上传 receipt 为文件引用
src/index.ts:8 + src/index.ts:58 inject 'commands' + src/index.ts:69 ctx.commands.registerFileReceiptResolver
dsh-sessionE1
以 SessionId 寻址会话并观察 session/event 退役 receipt
src/index.ts:10 + src/client/contract.ts:1 + src/http-route.ts:4
④ 被依赖（dependents · 下游消费者）
dsh-api-remotes
装配文件上传命名空间
src/client/index.ts:19 import remote + src/client/index.ts:51 import remote
dsh-api-session-controller
上传收据解析与 Agent 解析登记
src/index.ts:10 import + src/index.ts:140 ctx.fileUploads.registerAgentResolver
dsh-client-ui-conversation
浏览器 Worker 文件上传服务
src/client/contract/slots.ts:5 + src/client/service.ts:19
dsh-experimental-webworker-runtime
复用文件上传类型于 Worker 传输层
src/client/index.ts:12 import '@deepseek-ai/dsh-client-file-upload/types'