目录:ACP 协议API 网关与控制器附件启动与插件管理客户端运行时客户端 UI 包上下文压缩上下文注入核心运行时凭据与授权交付物文档处理实验特性宿主扩展反馈通道文件系统目标与计划工具守卫Hooks 扩展宿主服务交互命令作业调度LLM 适配LSP 集成MCP 协议规划模式Agent 预设代码执行运行时运行时诊断沙箱定时调度SDK 与协议会话核心会话检索设置Shell 执行技能溢出存储SSH 远程执行存储子代理子进程终端待办类型契约框架 vendorWeb 访问Webhook工作流工作区
依赖链 · 上游(该插件依赖的前驱):
无依赖(基础插件)
依赖链 · 下游(依赖该插件的节点):
同一拓扑层(Layer 0,层次遍历层序):
cordis-plugin-loadercordis-plugin-logger-consolecordis-plugin-timerdsh-attachment-localdsh-bash-localdsh-client-resourcesdsh-client-ui-primitivesdsh-credentials-localdsh-deepseek-llm-api-extensionsdsh-experimental-api-speech-to-textdsh-experimental-ptc-runtime-pythondsh-experimental-speech-to-text-sensevoicedsh-fs-localdsh-fs-observation-policydsh-host-directory-picker-browsedsh-host-directory-picker-nativedsh-host-webserverdsh-invariantsdsh-lsp-stdiodsh-pwsh-localdsh-sandbox-localdsh-sandbox-sshdsh-shell-envdsh-spill-localdsh-storagedsh-subprocess-localdsh-typert-registrydsh-workspace-changesschemastery
Layer 0↓ Layer 1(13 插件)
插件信息
| 包名 | @deepseek-ai/dsh-bash-local |
|---|---|
| 分组 | G36 · Shell 执行 |
| 拓扑层 | Layer 0(层次遍历:被依赖方先于依赖方) |
| 源码路径 | packages/shell/bash-local |
| 来源层 | L3 其余插件(独立于 bundle 装配的扩展/变体/示例) |
① 实现逻辑
实现 shell 能力 seam 的本地 bash 执行器 ctx.shell:resolve() 用配置补齐 workdir/timeout/输出上限并夹取超时,spawnSpec() 组装带 ENV_OVERRIDES 的 subprocess spawn 规格 (src/index.ts:120-174)。execute() 以 bash -c 运行,executeArgv() 负责 deadline/取消分类('kill' 与 'none' 两臂)、输出读取、stdout/stderr 模型友好合并、kill 与 result 投影 (src/index.ts:187-389)。实际进程经 ctx.subprocess 管理、输出有界并可溢出到 spill 文件,替身未产出进程时以 settled-killed 形态收敛 (src/index.ts:97-107, 156-185, 251-341)。
内部结构动态 DAG(深色主题:橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件)
本插件
上游依赖
下游依赖
外部 seam
② 注册/提供(provides)
- ctx.shell (本地 bash 执行器实现,经 ctx.subprocess 以 bash -c 运行命令)
③ 依赖(depends_on · 上游前驱)
无依赖(基础插件)
④ 被依赖(dependents · 下游消费者)
dsh-bash-sandbox
复用本地 bash 的执行生命周期、输出与 deadline 机制
src/index.ts:25-26 import LocalBashExecutor 及 Config; src/index.ts:45 class extends LocalBashExecutor; package.json:31 peerDep