目录:ACP 协议API 网关与控制器附件启动与插件管理客户端运行时客户端 UI 包上下文压缩上下文注入核心运行时凭据与授权交付物文档处理实验特性宿主扩展反馈通道文件系统目标与计划工具守卫Hooks 扩展宿主服务交互命令作业调度LLM 适配LSP 集成MCP 协议规划模式Agent 预设代码执行运行时运行时诊断沙箱定时调度SDK 与协议会话核心会话检索设置Shell 执行技能溢出存储SSH 远程执行存储子代理子进程终端待办类型契约框架 vendorWeb 访问Webhook工作流工作区
依赖链 · 上游（该插件依赖的前驱）：
依赖链 · 下游（依赖该插件的节点）：
同一拓扑层（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-tool-present |
|---|---|
| 分组 | G11 · 交付物 |
| 拓扑层 | Layer 5（层次遍历：被依赖方先于依赖方） |
| 源码路径 | packages/deliverables/tool-present |
| 来源层 | L3 其余插件（独立于 bundle 装配的扩展/变体/示例） |
① 实现逻辑
函数插件在 agent scope 注册模型可见工具 `present`，让模型把已存在的文件声明为最终交付物（src/index.ts:38-99）。`execute` 先校验存在 open turn（经 sessionProjections 的 `turnBoundary`）、文件数 1..maxFiles，再用 `ctx.fs.lstat/resolve/stat` 确认每个路径都是常规文件，否则报错（src/index.ts:76-97）。成功结果经 `tools/result` 监听器把 `deliverables/presented` 事件追加进 Session，文件内容仍留在源路径不被复制（src/index.ts:100-108、src/types.ts:12-16）。
内部结构动态 DAG（深色主题：橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件）
本插件
上游依赖
下游依赖
外部 seam
② 注册/提供（provides）
- 工具 present (声明已存在文件为最终交付物)
- Session 事件 deliverables/presented
③ 依赖（depends_on · 上游前驱）
dsh-agentE1
取得调用 Agent 及其 Session
src/index.ts:6 import type {} from '@deepseek-ai/dsh-agent' + src/index.ts:77 exec.agent
dsh-llmE1
事件 payload 使用品牌化 ToolCallId
src/types.ts:2 import ToolCallId from '@deepseek-ai/dsh-llm/brand'
dsh-sessionE1
把交付声明持久化为 Session 事件
src/index.ts:8 import type { Session } + src/index.ts:105 session.append
dsh-session-projectionE1+E2
读取当前 open turn 与 turn 号
src/index.ts:7 import type {} from '@deepseek-ai/dsh-session-projection' + src/index.ts:26 inject + src/index.ts:78 stateOf(..., 'turnBoundary')
dsh-toolsE1+E2
注册工具并订阅 tools/result
src/index.ts:5 import defineTool + src/index.ts:26 inject ['tools','fs','sessionProjections'] + src/index.ts:38 ctx.tools.register