dsh-approval-notifier

DSH — Aviso de aprovação

Extensão do Chrome (Manifest V3) que mostra uma notificação nativa — no Windows, um toast do sistema — quando o DeepSeek Harness está bloqueado esperando uma decisão sua na conversa.

Imagem ilustrativa (tools/make-preview.ps1). O visual real segue o tema do seu Windows.

Quando dispara

A extensão observa os painéis que assumem o compositor do chat. Cada um publica um atributo estável, então nada depende de classes CSS geradas:

Comportamento:

• Uma notificação por pedido. Mutações repetidas do DOM não duplicam o aviso.
• Fecha sozinha quando você responde, ou quando o painel sai da tela.
• Lembrete se ninguém responder: o toast reaparece a cada ~90s, no máximo três vezes, e para quando você responde ou fecha o aviso.
• Badge no ícone com quantos pedidos esperam decisão — visível mesmo com o popup fechado.
• Bipe curto junto com o toast, liberado só depois de um gesto seu na página (exigência de autoplay do Chrome).
• Título da aba ganha um ⚠ enquanto houver algo pendente.
• Clicar na notificação foca a aba do DSH.
• Horário de silêncio opcional (ver configuração): fora da janela o aviso é segurado e entregue quando ela termina — ou descartado, se você responder antes. Aprovações podem furar a janela, porque travam o agente.
• Funciona em qualquer porta de 127.0.0.1 e localhost, inclusive o DSH Desktop, que escolhe uma porta livre a cada execução.

Instalação

1. Abra chrome://extensions.
2. Ative o Modo do desenvolvedor.
3. Clique em Carregar sem compactação e selecione a pasta da extensão.
4. Recarregue a aba do DSH (F5) — o content script só entra em páginas carregadas depois da instalação.
5. Clique no ícone da extensão e use Enviar notificação de teste.

Há uma release com .zip pronto em Releases — basta descompactar e carregar a pasta.

A extensão fica instalada enquanto a pasta existir. Se mover ou apagar a pasta, remova e carregue de novo.

Configuração (popup)

• Ativar avisos — liga/desliga sem remover a extensão.
• Só quando a janela não estiver em foco — evita o aviso redundante quando você já está olhando o chat. Se um pedido chegar com a janela em foco, ele ainda avisa no momento em que você troca de janela.
• Horário de silêncio — janela de "não perturbe" (padrão 22:00–08:00, desligada). Pode atravessar a meia-noite. O aviso que cair na janela fica em espera, aparece no badge e é entregue no fim dela; se você responder antes, nada é entregue.
• Aprovações furam o silêncio — ligado por padrão: uma aprovação bloqueia o agente, então vale acordar; pergunta e revisão de plano esperam a janela.

Se a notificação não aparecer

1. chrome://settings/content/notifications → libere o site 127.0.0.1 (a porta do DSH não importa: a extensão casa com qualquer porta em 127.0.0.1 e localhost).
2. Windows → Configurações → Sistema → Notificações: permita o Chrome e desative o Assistente de Foco durante o horário de trabalho.
3. Confirme que a página do harness está mesmo em 127.0.0.1 ou localhost (o DSH Desktop, por exemplo, sobe em portas aleatórias como 58426).
4. Se um aviso laranja aparecer no canto da página dizendo Aviso de aprovação inativo, a extensão foi recarregada depois da página: aperte F5. O popup também mostra há quanto tempo foi o último aviso e se há alguma aba conversando com a extensão.

Limitações

• Precisa da aba aberta. A extensão observa o DOM; com o navegador fechado não há aviso (também não haveria onde responder).
• Só a página do DSH. Não interfere em outras abas nem em outros sites.
• Não é um canal de aprovação. Ela avisa; a decisão continua no painel do chat, e cada aprovação vale uma única vez.

Plugin nativo do DSH

Existe também uma versão como plugin de cliente, em plugin/: em vez de observar o DOM, ela assina o snapshot de status das sessões (ctx.uiSession.sessionStatus). Não depende da porta 3080 nem da aba aberta e, por seguir a convenção de bundles do ecossistema, pode ser instalada pelo dsh plugin add e cadastrada nos catálogos da comunidade.

Ainda não publicado no npm — veja o estado em plugin/README.md.

Desenvolvimento

node test/content.test.mjs          # 23 verificações, DOM + chrome simulados
pwsh -File tools/build-release.ps1  # gera dist/dsh-approval-notifier-<versão>.zip

O workflow .github/workflows/test.yml roda esses testes a cada push e pull request.

Privacidade

A extensão não coleta nem transmite dados. Detalhes em PRIVACY.md.

Publicação

Materiais para a Chrome Web Store ficam em store/ e os textos de lançamento em marketing/.

Licença

MIT — veja LICENSE.

---

DSH — Approval notifier

Chrome extension (Manifest V3) that fires a native notification — a Windows toast on Windows — whenever DeepSeek Harness is blocked waiting for your decision in the conversation.

When it fires

It watches the panels that take over the chat composer. Each one publishes a stable attribute, so nothing depends on generated CSS classes:

• One notification per request, no duplicates on repeated DOM mutations.
• Auto-clears when you answer or the panel leaves the screen.
• Short beep, only after a user gesture on the page (Chrome autoplay rule).
• Tab title gets a ⚠ prefix while something is pending.
• Clicking the notification focuses the DSH tab.

Install

1. Open chrome://extensions.
2. Enable Developer mode.
3. Click Load unpacked and select the extension folder.
4. Reload the DSH tab (F5).
5. Open the popup and press Enviar notificação de teste.

A packaged .zip is available under Releases.

Troubleshooting

If an orange banner shows Aviso de aprovação inativo, the extension was reloaded after the page: press F5. The popup also reports how long ago the last notification happened and whether any tab is talking to the extension.

Settings (popup)

• Ativar avisos — on/off without removing the extension.
• Só quando a janela não estiver em foco — stay quiet while you are already looking at the chat; still alerts the moment you switch away.

Known limitations

• Needs the tab open. It observes the DOM; with the browser closed there is nothing to alert (and nowhere to answer either).
• DSH page only. It does not touch other tabs or sites.
• Not an approval channel. It only notifies; the decision still happens in the chat panel, and every approval is one-shot.

Native DSH plugin

A client-plugin version lives in plugin/: instead of observing the DOM, it subscribes to the session status snapshot (ctx.uiSession.sessionStatus). It does not depend on port 3080 or an open tab, and it follows the ecosystem bundle convention, so it can be installed with dsh plugin add and listed in community catalogs.

Not published to npm yet — see the state in plugin/README.md.

License

MIT — see LICENSE.