目录: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-tool-pwsh-persistent |
|---|---|
| 分组 | G36 · Shell 执行 |
| 拓扑层 | Layer 6（层次遍历：被依赖方先于依赖方） |
| 源码路径 | packages/shell/tool-pwsh-persistent |
| 来源层 | L3 其余插件（独立于 bundle 装配的扩展/变体/示例） |
① 实现逻辑
向模型注册基于 PTY 的持久 pwsh 工具，与 tool-bash-persistent 逐调用对称：按 owner(Agent) 维护持久 PowerShell 会话，用 nonce 标记包裹命令（quoteForPwsh 转义反引号、引号、`$`、换行与 ESC）后发送并轮询 (src/index.ts:81-99, 308-402)。persistentShells() 负责按 owner 的会话创建/复用/重置与 fiber 处置清理；executeCommand 处理超时、abort、会话退出与 stdin_read 的提前返回 (src/index.ts:245-306, 331-401)。输出按上限截断并渲染退出码/重置/超时提示 (src/index.ts:57-243)。
内部结构动态 DAG（深色主题：橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件）
本插件
上游依赖
下游依赖
外部 seam
② 注册/提供（provides）
- 模型工具 pwsh (基于 owner 级 PTY 持久会话的持久 PowerShell，状态跨调用保持)
③ 依赖（depends_on · 上游前驱）
dsh-agentE1
以 Agent 为 owner 隔离持久 shell 并读取其会话 cwd
src/index.ts:11 import type { Agent }; package.json:29 peerDep
dsh-terminalE1+E2
经 owner 级 PTY 服务创建/发送/读取/终止持久 shell 会话
src/index.ts:13 import type { TerminalSessionId }; src/index.ts:453 inject ['terminals']; src/index.ts:279 ctx.terminals.spawn
dsh-toolsE1+E2
注册持久 pwsh 工具定义
src/index.ts:15 import defineTool; src/index.ts:453 inject ['tools']; src/index.ts:425 ctx.tools.register
④ 被依赖（dependents · 下游消费者）
无下游（叶子/被消费端）