dsh-run
DSH Web 插件：Session 标题栏新增一个分割按钮，可运行工作区 package.json 中的一个 npm 脚本（默认选择 dev，否则选择 start，再否则选择第一个声明的脚本）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:albertgranados/dsh-run#f41d9524d871c0054e7bb06afd61313785096ce3Run 以 dsh-run 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Plugin del DeepSeek Harness que añade, arriba a la derecha de la cabecera de
sesión (junto al botón Open in…), un botón compuesto para los scripts de
npm del proyecto abierto.
┌──────────────────────┬─┐
│ ▶ npm run dev │▾│ ← el botón principal ejecuta el script por defecto
└──────────────────────┴─┘ ← la flecha despliega TODOS los scripts del package.json
English: a DeepSeek Harness web plugin. The Session header grows a split button (play + chevron) that runs one script from the workspace's
package.json: the main button runs the default (dev, elsestart, else the first declared), the chevron lists and runs every script and makes it the new default. It renders nothing when the workspace has nopackage.jsonscripts, turns into a stop button while a script is alive, and shows the failure output when a launch dies early. See English at the end.
package.json del directorio de trabajo de la sesión (el cwd).package.json con scripts. Sin manifiesto, o sin
scripts, el botón no se renderiza: no queda ni un hueco vacío.npm run dev). Al pulsarlo, lo ejecuta. Mientras corre, el icono cambia a
stop y un segundo clic detiene el proceso (grupo de procesos completo:
npm → sh → el servidor).npm run <script>.
Al elegir uno, se ejecuta y pasa a ser el nuevo por defecto del botón
de play. La elección se recuerda por proyecto en el navegador
(localStorage, clave dsh-run.defaults).dev; si no existe, start; si tampoco, el
primer script del manifiesto.| Ruta | Qué hace |
|---|---|
GET /dsh-run/scripts?cwd=<abs> | Scripts del package.json, el defecto automático y la tabla de ejecuciones de ese proyecto. |
POST /dsh-run/run | { cwd, script } → npm run <script> en ese directorio. |
POST /dsh-run/stop | { cwd, script } → termina el grupo de procesos de esa ejecución. |
GET /dsh-run/log?cwd=&script=&bytes= | Cola de salida recogida (stdout/stderr) de una ejecución. |
Todas pasan primero por el filtro de confianza del harness
(connection.requestRejection): mismo cerco Host/Origin y misma cookie de
sesión que el resto de la API. Además, cada ruta con cuerpo valida el JSON en el
borde y vuelve a resolver el proyecto en el host: el directorio debe ser
absoluto y existir, y el script pedido debe estar declarado en su propio
package.json.
Los procesos se lanzan por el servicio subprocess del harness, así que
terminate() alcanza a todo el grupo de procesos, la salida queda legible
después de salir y descargar el plugin detiene lo que él mismo arrancó.
# desde GitHub (público)
dsh plugin --profile web add github:albertgranados/dsh-run
# o desde un checkout local (queda enlazado: editar y reiniciar)
dsh plugin --profile web add /ruta/a/dsh-run
# y reinicia el harness
El paquete declara dsh.bundle.patch, así que el propio dsh plugin
reconcilia dsh.profile.bundles solo: no hay que editar package.json ni
cordis.patch.yml a mano. No hay build: lib/index.js y lib/client.js van
compilados a mano en el repo (el cliente se sirve crudo al navegador, no pasa
por ningún bundler).
Tras reiniciar, recarga la página del navegador (http://127.0.0.1:3080). El
botón solo aparece en sesiones cuyo workspace tenga un package.json.
dsh plugin --profile web remove dsh-run
# ¿está la fila del plugin en el árbol del perfil?
dsh --profile web --dump-config | grep -A2 dsh-run
# con el harness en marcha (necesita la cookie del navegador para las rutas)
curl -s "http://127.0.0.1:3080/dsh-run/scripts?cwd=$PWD" | head
npm run <script>; npm se resuelve por el mismo
mundo de ejecución que usa el resto del harness (subprocess.resolveExecutable).DSH_*), más
FORCE_COLOR=0 / NO_COLOR=1 para que el log no lleve secuencias ANSI./dsh-run/log).A DeepSeek Harness web plugin: a Session-header split button for the workspace's npm scripts.
npm run dev) runs the
default script — dev, else start, else the first one declared. While a run
is alive it turns into a stop button, and a second click terminates the whole
npm process group (npm → sh → the dev server).package.json as npm run <script>.
Picking one runs it and makes it the new default for that workspace, remembered
in the browser (localStorage, key dsh-run.defaults).package.json scripts, or before
the host answers.Install:
dsh plugin --profile web add github:albertgranados/dsh-run
# restart the harness, then reload the browser page
Host routes (all behind the harness's Host/Origin fence and login cookie):
| Route | Purpose |
|---|---|
GET /dsh-run/scripts?cwd=<abs> | Scripts, auto-picked default, live run table. |
POST /dsh-run/run | { cwd, script } → npm run <script>. |
POST /dsh-run/stop | { cwd, script } → terminate that run's process group. |
GET /dsh-run/log?cwd=&script=&bytes= | Collected stdout/stderr tail. |
MIT licensed.