dsh-goal-pause-guard
DSH 插件：在暂停正在运行的目标前，通过模态框请求确认。确认后会暂停目标，同时中止当前轮次，使正在运行的子任务立即停止；取消则不执行任何操作。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:frederico-kluser/dsh-goal-pause-guard#da751ec533cb0b484377fea152aff90b45702625Goal Pause Guard 以 dsh-goal-pause-guard 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Plugin para o DeepSeek Harness: modal de confirmação antes de pausar uma atividade rodando.
Pausar uma goal não é um gesto pequeno: ela interrompe a rodada atual e todas as subtarefas em execução na hora. O plugin pede confirmação antes.
No harness, pausar uma goal armada dispara uma cascata (motorizada no
goal-round-driver, goal/changed → agent.cancel, keepInbox):
resume humano.É exatamente esse efeito que o plugin coloca atrás de um portão: um clique acidental no botão de pause não pode desligar uma atividade que está rodando.
clique em "Pause goal" (clique humano, trusted)
│
▼
┌──────────────┐ captura no document (capture phase, antes do React)
│ GUARD │ isPauseButton? ── não ──► o clique passa (fail-open)
└──────┬───────┘
▼ sim
MODAL DE CONFIRMAÇÃO (pt-BR / en / zh, tema claro-escuro do host)
├── Cancelar / Esc / fundo ──► nada acontece
└── Confirmar ──► re-clique UNTRUSTED no botão de pause ATUAL
│ (passa pelo guard sem re-gate)
▼
GoalBar → goals.pause (Remote RPC)
▼
host: goal paused + rodada abortada + subtasks param
aria-label
localizado (Pause goal / 暂停目标, os dois dicionários da barra de goal)
ou pelo path SVG do ícone de pause (IconPauseOutline16), sempre dentro
de [data-goal-bar] (o marcador que o próprio e2e oficial usa).apply vazio (mesmo padrão do @deepseek-ai/dsh-client-ui-goal): nenhum
estado do harness é tocado.Como bundle do profile web — o dsh.bundle.patch do pacote ativa a camada
sozinho (insert próprio, sem colidir com nenhum outro id):
dsh plugin --profile web add /caminho/para/dsh-goal-pause-guard
dsh web # reinicie a instância; plugins entram no boot
Desinstalar: remova a linha do bundle do ~/.dsh/profiles/web/package.json
(dsh plugin --profile web remove dsh-goal-pause-guard) e reinicie.
Toda a verificação roda isolada — nenhum teste toca uma instância real do
DSH (nem a porta 3080, nem o $DSH_HOME):
pnpm install
pnpm run typecheck # tsc estrito
pnpm run build # dist/ (host) + lib/client.js (browser, closure-factory)
pnpm test # 23 testes: detector + comportamento + e2e do artefato
| Camada | Prova |
|---|---|
| Detector (unit, jsdom) | os dois canais de identificação; rejeição de todo o resto (resume/edit/clear, botões fora da barra, ícones estrangeiros, prefixos parecidos) |
| Comportamento (jsdom) | clique humano abre o modal e nunca chega ao app; confirmar re-clica UMA vez como untrusted; cancelar/Esc/fundo não pausam; segundo clique engolido; botão removido/desabilitado no confirm não dispara; disposer remove tudo |
| E2E do artefato | o lib/client.js enviado é carregado como o harness carrega (window.__ModuleLoader__.load({id, factory})) e o fluxo inteiro é dirigido sobre ele |
O screenshot acima é real: capturado num boot isolado ( $DSH_HOME
temporária + porta própria) com Chromium headless, clicando no botão de pause
de verdade (evento trusted via CDP) — o guard abriu o modal e o cancelamento
não enviou pausa nenhuma.
dsh-goal-pause-guard/
├── package.json # dsh.bundle.patch + dsh.client (platform web) + exports["./client"]
├── cordis.patch.yml # camada 1 (bundle): insert próprio, sem !!js, sem config
├── src/index.ts # host half: apply vazio (entrada do Loader)
├── client/
│ ├── guard-core.ts # TODA a lógica: detector, textos, modal, install (0 imports)
│ ├── index.ts # plugin body: inject [] + apply(ctx) via ctx.effect
│ ├── guard.css # modal com tokens --dsw-* (claro/escuro), classes gpg-
│ └── client.d.ts # declaração do subpath ./client
├── scripts/build-client.mjs # esbuild → lib/client.js (closure-factory, CSS embutido)
├── test/ # jsdom + node:test, offline por projeto
└── dist/, lib/ # produtos do build (host half / browser bundle)
Verificado contra DSH 0.1.5-alpha.2 (a linha viva instalada, bootada do
source). O detector ancora em dois fatos estáveis da superfície — data-goal-bar
e o aria-label do action.pause do dicionário goal. Se o harness mudar os
dois ao mesmo tempo, o guard fica fail-open (pause sem modal) — nunca quebrado.
MIT © Frederico Kluser