目录: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-terminal |
|---|---|
| 分组 | G43 · 终端 |
| 拓扑层 | Layer 5(层次遍历:被依赖方先于依赖方) |
| 源码路径 | packages/terminal/terminal |
| 来源层 | L3 其余插件(独立于 bundle 装配的扩展/变体/示例) |
① 实现逻辑
owner 作用域的持久 PTY 注册表:TerminalSessionService 注册 ctx.terminals(src/index.ts:105-118),管理 backend 注册(src/index.ts:125-137)、按精确 Agent owner 隔离的会话发布(src/index.ts:154-224)与 awaited 清理(src/index.ts:423-454)。服务只拥有 ids、发布、授权与清理,把终端机制留给 backend(src/types.ts:166-171),并以机器可路由的 TerminalError 暴露失败(src/index.ts:55-71)。
内部结构动态 DAG(深色主题:橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件)
本插件
上游依赖
下游依赖
外部 seam
② 注册/提供(provides)
- ctx.terminals(持久 PTY 会话 seam:backend 注册、owner 隔离 id、send/read/signal/close 与 awaited 清理)
③ 依赖(depends_on · 上游前驱)
dsh-agentE1+E2
以精确 Agent 作为会话 owner,并绑定其生命周期做 cleanup
package.json:30 peerDep + src/index.ts:8 import Agent + src/index.ts:319 ctx.get('agents')
④ 被依赖(dependents · 下游消费者)
dsh-terminal-bash
向 PTY seam 注册 backend 并复用其类型与 TerminalError
package.json:31 peerDep + src/index.ts:10-11 import + src/index.ts:237 ctx.terminals.registerBackend
dsh-tool-bash-persistent
经 owner 级 PTY 服务创建/发送/读取/终止持久 shell 会话
src/index.ts:11 import type { TerminalSessionId }; src/index.ts:441 inject ['terminals']; src/index.ts:257 ctx.terminals.spawn
dsh-tool-pwsh-persistent
经 owner 级 PTY 服务创建/发送/读取/终止持久 shell 会话
src/index.ts:13 import type { TerminalSessionId }; src/index.ts:453 inject ['terminals']; src/index.ts:279 ctx.terminals.spawn
dsh-tool-terminal
调用 ctx.terminals 的会话操作
package.json:35 peerDep + src/index.ts:11-12 import + src/index.ts:28 inject ['terminals']