dsh-agent-shell

@deepseek-ai/dsh-agent-shell

Agent Shell 工具 + Shell 抽屉（DeepSeek Harness Web / dsh 宿主）。提供 bash / cmd 命令执行工具，并实时观察外部 pwsh 执行；每次执行都会被记录并通过回环 RPC 通道推送到右侧 Shell 抽屉（需要配合 dsh-right-drawer 的 dockPanels 注册表）。

Agent shell tools (bash via Git Bash, cmd) plus a live Shell drawer for DeepSeek Harness Web: every execution is recorded and served to the right-drawer over a loopback RPC channel. Content is rendered by the dockPanels registry provided by dsh-right-drawer.

功能 Features

• bash / cmd 工具 — bash 走 Git Bash（D:\Program Files\Git\bin\bash.exe），cmd 走 cmd.exe /d /s /c；输出按字节上限截断、超限落到溢出文件（spillPath），超时强制终止进程树
• pwsh 观察 — 通过 tools/result 事件记录外部 pwsh 工具的执行，统一进抽屉
• Shell 抽屉 — 每条记录默认折叠，展示退出码 / 耗时 / stdout / stderr，支持展开、删除、清空
• 回环 RPC — /agent-shell 通道（get / set-open / remove / clear）只在本机 loopback 提供记录流，前端轮询增量刷新
• 免构建 — 手写 JS，file: 或 npm 安装均可直接使用

安装 Install

依赖 dsh-right-drawer（抽屉宿主），先安装它：

dsh plugin --profile web add @deepseek-ai/dsh-right-drawer
dsh plugin --profile web add @deepseek-ai/dsh-agent-shell

未发布时可用本地目录：

dsh plugin --profile web add file:C:/path/to/dsh-agent-shell

然后重启 DeepSeek Harness。安装后右侧出现竖排「Shell」标签，点击展开抽屉；执行 bash / cmd / pwsh 命令后记录自动进入抽屉。

卸载：

dsh plugin --profile web remove @deepseek-ai/dsh-agent-shell

工具 Tools

工具	说明
bash	Git Bash 执行命令（POSIX 语法；workdir / timeoutMs / maxOutputBytes）
cmd	cmd.exe 执行命令（/d /s /c）
shell_drawer	控制抽屉里的命令记录：list / open <id> / close <id> / toggle <id> / remove <id> / clear

架构 Architecture

• Node 半（lib/index.js）：注册工具 + /agent-shell RPC 通道，内存环形缓冲最多 200 条记录
• 浏览器半（lib/client.js）：通过 slots.inject('shell.overlay') 挂载，优先注册进 dockPanels，找不到时降级为独立覆盖层（standalone）
• 通信：connection.rpc.call('/agent-shell', ...)，仅 loopback 权威

License

MIT