目录:ACP 协议API 网关与控制器附件启动与插件管理客户端运行时客户端 UI 包上下文压缩上下文注入核心运行时凭据与授权交付物文档处理实验特性宿主扩展反馈通道文件系统目标与计划工具守卫Hooks 扩展宿主服务交互命令作业调度LLM 适配LSP 集成MCP 协议规划模式Agent 预设代码执行运行时运行时诊断沙箱定时调度SDK 与协议会话核心会话检索设置Shell 执行技能溢出存储SSH 远程执行存储子代理子进程终端待办类型契约框架 vendorWeb 访问Webhook工作流工作区
依赖链 · 上游（该插件依赖的前驱）：
依赖链 · 下游（依赖该插件的节点）：
无下游（叶子/被消费端）
同一拓扑层（Layer 6，层次遍历层序）：
dsh-agent-presetdsh-command-goaldsh-compaction-basicdsh-experimental-auto-reviewdsh-goal-round-driverdsh-host-plugin-inventorydsh-mcp-clientdsh-office-to-pdfdsh-plan-modedsh-plugin-package-inventory-deepseekdsh-subagentdsh-terminal-bashdsh-tool-ask-userdsh-tool-bash-persistentdsh-tool-cordisdsh-tool-goaldsh-tool-pwsh-persistentdsh-tool-terminal
插件信息
| 包名 | @deepseek-ai/dsh-terminal-bash |
|---|---|
| 分组 | G43 · 终端 |
| 拓扑层 | Layer 6（层次遍历：被依赖方先于依赖方） |
| 源码路径 | packages/terminal/terminal-bash |
| 来源层 | L3 其余插件（独立于 bundle 装配的扩展/变体/示例） |
① 实现逻辑
本地持久 shell PTY backend：BashTerminalBackend 经 ctx.subprocess.spawnTerminal 拉起 bash/pwsh 交互会话（src/index.ts:201-230），并注册到 ctx.terminals（src/index.ts:237）。它结合 sandboxPolicy 生成 argv（src/index.ts:100-109）、设置受控提示符 PS1/PROMPT_COMMAND（src/index.ts:64-89），用 LocalPtySession 做有界输出、就绪判定与终端协议回复（src/session.ts:1-60）。
内部结构动态 DAG（深色主题：橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件）
本插件
上游依赖
下游依赖
外部 seam
② 注册/提供（provides）
- ctx.terminals 的 shell 后端（TerminalBackend 实现，默认 type shell，注册于 src/index.ts:237）
③ 依赖（depends_on · 上游前驱）
dsh-agentE1+E2
以会话 owner Agent 及其 session 做沙箱模式护栏
package.json:30 peerDep + src/index.ts:8 import Agent + src/index.ts:37 ensureSandboxModeFence(owner)
dsh-pwsh-localE1
pwsh 方言的可执行路径解析与 UTF-8 前置
package.json:41 dep + src/config.ts:4 import resolvePwshPath + src/index.ts:16 import ENCODING_PREAMBLE
dsh-sandbox-policyE1+E2
解析当前会话的沙箱执行策略
package.json:33 peerDep + src/index.ts:14 type-only import + src/index.ts:27 inject ['sandboxPolicy']
dsh-sessionE1
订阅 session/event 校验 sandbox 模式切换
package.json:34 peerDep + src/index.ts:9 import Session/SessionEvent
dsh-session-projectionE1+E2
读取 sandboxMode 投影以校验模式切换
package.json:37 peerDep + src/index.ts:15 type-only import + src/index.ts:27 inject ['sessionProjections']
dsh-terminalE1+E2
向 PTY seam 注册 backend 并复用其类型与 TerminalError
package.json:31 peerDep + src/index.ts:10-11 import + src/index.ts:237 ctx.terminals.registerBackend
④ 被依赖（dependents · 下游消费者）
无下游（叶子/被消费端）