DeepSeek Harness plugin

dsh-agent-shell

Agent shell tools (bash via Git Bash, cmd) with a live shell-record feed: every execution is recorded and served to the right-drawer Shell drawer over a loopback RPC channel. 对话右侧 Shell

Jump to install

Source facts

Repository
PastSheep/dsh-agent-shell
Latest update
Aug 17, 2026
Category
Workflow & Automation
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/PastSheep/dsh-agent-shell
Plugin: dsh-agent-shell
Author: PastSheep

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

@deepseek-ai/dsh-agent-shell

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

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),cmdcmd.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

工具说明
bashGit Bash 执行命令(POSIX 语法;workdir / timeoutMs / maxOutputBytes
cmdcmd.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