@michengai/dsh-btw 1.3.5 → 1.3.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +6 -0
- package/CHANGELOG.zh-CN.md +6 -0
- package/README.de.md +221 -0
- package/README.en.md +6 -3
- package/README.es.md +221 -0
- package/README.fr.md +221 -0
- package/README.ja.md +221 -0
- package/README.md +6 -3
- package/README.pt.md +221 -0
- package/README.ru.md +221 -0
- package/README.zh-CN.md +6 -3
- package/lib/client.js +766 -166
- package/lib/index.js +779 -138
- package/lib/types/client/SelectionAsk.d.ts +1 -4
- package/lib/types/client/trigger-source.d.ts +2 -2
- package/lib/types/locales/de.d.ts +2 -0
- package/lib/types/locales/en.d.ts +2 -0
- package/lib/types/locales/es.d.ts +2 -0
- package/lib/types/locales/fr.d.ts +2 -0
- package/lib/types/locales/ja.d.ts +2 -0
- package/lib/types/locales/pt.d.ts +2 -0
- package/lib/types/locales/ru.d.ts +2 -0
- package/lib/types/locales/zh.d.ts +97 -0
- package/lib/types/locales.d.ts +11 -99
- package/locale/de.json +7 -0
- package/locale/en.json +2 -1
- package/locale/es.json +7 -0
- package/locale/fr.json +7 -0
- package/locale/ja.json +7 -0
- package/locale/pt.json +7 -0
- package/locale/ru.json +7 -0
- package/locale/zh.json +2 -1
- package/package.json +23 -2
package/README.pt.md
ADDED
|
@@ -0,0 +1,221 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="https://raw.githubusercontent.com/MichengAI/dsh-btw/2d8dd7752cec1b29dd705969eaa932635ba0bf4f/assets/branding/dsh-btw-banner.png" alt="DSH BTW" width="100%">
|
|
3
|
+
</p>
|
|
4
|
+
|
|
5
|
+
<div align="center">
|
|
6
|
+
|
|
7
|
+
# DSH BTW
|
|
8
|
+
|
|
9
|
+
**Perguntas secundárias rápidas na sessão atual do DeepSeek Harness: apenas respostas, sem execução de ferramentas**
|
|
10
|
+
|
|
11
|
+
[简体中文](README.zh-CN.md) · [English](README.en.md) · [日本語](README.ja.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Русский](README.ru.md) · [Português](README.pt.md)
|
|
12
|
+
|
|
13
|
+
[Capturas](#capturas-de-tela) · [Instalação](#instalação) · [Uso](#uso) · [Registro de alterações](CHANGELOG.md) · [Apache-2.0](LICENSE)
|
|
14
|
+
|
|
15
|
+
[](LICENSE)
|
|
16
|
+
[](https://github.com/deepseek-ai/deepseek-harness)
|
|
17
|
+
[](https://nodejs.org/)
|
|
18
|
+
|
|
19
|
+
</div>
|
|
20
|
+
|
|
21
|
+
> O DSH BTW é um plugin para o DeepSeek Harness mantido pela comunidade, não um produto oficial da DeepSeek AI. Digite `/btw sua pergunta` na conversa atual para obter uma resposta contextual em um balão independente sem interromper a tarefa principal. Compatível com o DSH Web e aplicativos de desktop baseados nele. A partir da versão `1.0.0`, hosts fora da lista compatível são rejeitados com segurança pela barreira de versão (as configurações instaladas e o histórico de conversas são preservados).
|
|
22
|
+
|
|
23
|
+
## Principais Recursos
|
|
24
|
+
|
|
25
|
+
- **Perguntas com contexto**: esclareça conceitos, resuma conclusões ou tire dúvidas pontuais com base no histórico atual.
|
|
26
|
+
- **Apenas respostas, sem ferramentas**: não lê novos arquivos, não acessa a internet, não executa comandos nem edita código.
|
|
27
|
+
- **Balão de resposta independente**: suporta Markdown, equações matemáticas, cópia, recolhimento, expansão e fechamento. Várias respostas podem ser visualizadas simultaneamente.
|
|
28
|
+
- **Não interrompe a tarefa principal**: as perguntas secundárias são respondidas à parte e não afetam o diálogo principal por padrão.
|
|
29
|
+
- **Envio sob solicitação**: se desejar registrar a resposta no chat principal, peça explicitamente na pergunta «envie a resposta para o chat principal» para que `send_message` transmita uma resposta completa e autossuficiente. Nenhum envio é feito sem solicitação direta.
|
|
30
|
+
- **Cancele a qualquer momento**: fechar o balão enquanto a resposta está sendo gerada cancela imediatamente a pergunta secundária.
|
|
31
|
+
- **Internacionalização completa e temas**: acompanha os temas claro e escuro do DSH. A partir do host `0.2.2-rc.1`, há suporte nativo para todos os 8 idiomas oficiais (português, inglês, chinês, japonês, espanhol, francês, alemão e russo); em versões anteriores `0.2.0`〜`0.2.1`, o sistema recorre com segurança ao chinês e ao inglês.
|
|
32
|
+
|
|
33
|
+
## Capturas de tela
|
|
34
|
+
|
|
35
|
+
### Pergunta secundária no DSH padrão
|
|
36
|
+
|
|
37
|
+
A conversa principal continua no mesmo lugar, e o balão da pergunta secundária é exibido diretamente acima da área de entrada.
|
|
38
|
+
|
|
39
|
+

|
|
40
|
+
|
|
41
|
+
### Menu de comandos
|
|
42
|
+
|
|
43
|
+
Digite `/` e selecione `btw` no menu de comandos, ou digite diretamente `/btw sua pergunta`.
|
|
44
|
+
|
|
45
|
+

|
|
46
|
+
|
|
47
|
+
### Balões de resposta independentes
|
|
48
|
+
|
|
49
|
+
Cada pergunta é exibida em seu próprio balão, com controles no canto superior direito para copiar, recolher/expandir ou fechar.
|
|
50
|
+
|
|
51
|
+

|
|
52
|
+
|
|
53
|
+
### Configuração de perguntas secundárias
|
|
54
|
+
|
|
55
|
+
Abra **Plugins**, selecione `@michengai/dsh-btw` e o formulário de configuração estará disponível diretamente na página de detalhes: ferramentas permitidas e instruções personalizadas.
|
|
56
|
+
|
|
57
|
+

|
|
58
|
+
|
|
59
|
+
### Geração de diagramas
|
|
60
|
+
|
|
61
|
+
Com `pele_draw` na lista de permissões, a pergunta secundária também pode renderizar fluxogramas sem interferir no chat principal.
|
|
62
|
+
|
|
63
|
+

|
|
64
|
+
|
|
65
|
+
## Ecossistema de soluções DSH
|
|
66
|
+
|
|
67
|
+
Para obter um ambiente de trabalho completo em desktop, baixe o [DSH Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop/releases). Em ambientes já existentes do [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness), instale os plugins de acordo com suas necessidades. A seguir estão 11 plugins desenvolvidos internamente; o escopo real na versão desktop depende das notas da versão e catálogo integrado.
|
|
68
|
+
|
|
69
|
+
| Plugin | Finalidade |
|
|
70
|
+
| --- | --- |
|
|
71
|
+
| [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | Organização de projetos e sessões, busca de tarefas e navegação |
|
|
72
|
+
| [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | Escolher e invocar especialistas dedicados por tarefa |
|
|
73
|
+
| [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) | Localizar, ativar, criar e importar habilidades locais |
|
|
74
|
+
| [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | Buscar, restaurar e limpar conversas arquivadas |
|
|
75
|
+
| [IM Connect](https://github.com/MichengAI/dsh-im-connect) | Atribuir tarefas e receber respostas em plataformas de mensagens |
|
|
76
|
+
| [Automation](https://github.com/MichengAI/dsh-automation) | Executar tarefas agendadas e visualizar relatórios |
|
|
77
|
+
| [BTW](https://github.com/MichengAI/dsh-btw) | Perguntas contextuais rápidas sem interromper a tarefa principal |
|
|
78
|
+
| [Simplify](https://github.com/MichengAI/dsh-simplify) | Limpar e refatorar alterações do Git com `/simplify` |
|
|
79
|
+
| [PUA](https://github.com/MichengAI/dsh-pua) | Orientar o agente a corrigir rotas em falhas e validar resultados |
|
|
80
|
+
| [Code Review](https://github.com/MichengAI/dsh-code-review) | Iniciar revisões de código independentes com `/review` |
|
|
81
|
+
| [Codex Pet](https://github.com/MichengAI/dsh-codex-pet) | Alertas de sessão, aprovação de ferramentas e respostas via pet |
|
|
82
|
+
|
|
83
|
+
## Pré-requisitos
|
|
84
|
+
|
|
85
|
+
- DeepSeek Harness instalado.
|
|
86
|
+
- Intervalo de suporte do host: linha completa DeepSeek Harness `0.2.x` (`>=0.2.0-rc.1 <0.3.0-0`), verificado em `0.2.0-rc.1`, `0.2.0-rc.2`, `0.2.1-rc.1`〜`0.2.1-rc.5`, `0.2.2-rc.1`. Atualizações dentro da mesma geração não requerem aguardar novas versões do plugin.
|
|
87
|
+
- Suporte a idiomas: todos os 8 idiomas integrados são selecionáveis nativamente a partir do DeepSeek Harness `0.2.2-rc.1`. Em hosts `0.2.0`〜`0.2.1`, dicionários registrados adicionais permanecem inativos e a interface recorre de forma segura ao chinês e inglês.
|
|
88
|
+
- Hosts anteriores a `0.2.0-rc.1` não são mais suportados. Modificações destrutivas da geração `0.3.0` serão interceptadas pela barreira de versão. Usuários da versão `0.1.x` devem instalar a versão `0.1.24`.
|
|
89
|
+
- Node.js 22+, comando `dsh` funcional no terminal.
|
|
90
|
+
|
|
91
|
+
## Instalação
|
|
92
|
+
|
|
93
|
+
Os exemplos abaixo utilizam o perfil `web`. Adapte-os para o seu ambiente conforme necessário. Desative outros plugins que forneçam o comando `/btw` antes da instalação.
|
|
94
|
+
|
|
95
|
+
### Instalação por Agente (Recomendado)
|
|
96
|
+
|
|
97
|
+
Envie a seguinte instrução para qualquer agente com acesso ao terminal local:
|
|
98
|
+
|
|
99
|
+
```text
|
|
100
|
+
Instale o plugin DSH @michengai/dsh-btw no perfil web local executando: dsh plugin --profile web add @michengai/dsh-btw@latest --registry=https://registry.npmjs.org/. Após a instalação, execute dsh --profile web --dump-config para confirmar a presença de michengai-btw e me explique como recarregar o DSH e começar a usá-lo.
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
### Instalação manual via npm
|
|
104
|
+
|
|
105
|
+
```powershell
|
|
106
|
+
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
107
|
+
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
108
|
+
|
|
109
|
+
dsh plugin --profile web add @michengai/dsh-btw@latest --registry=https://registry.npmjs.org/
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### Recarregar
|
|
113
|
+
|
|
114
|
+
Instale ou atualize após finalizar as tarefas atuais; aplicativos de desktop podem ser reiniciados automaticamente. Se a alteração não surtir efeito, use a opção de recarregar do aplicativo desktop ou reinicie o serviço `dsh web`. Apenas atualizar a aba do navegador não é suficiente.
|
|
115
|
+
|
|
116
|
+
Em hosts anteriores a `0.2.0` e em `0.2.1` alpha, a instalação de `@latest` será rejeitada pela barreira de versão e o plugin não será executado. Para `0.1.x`, instale `0.1.24`. A rejeição não remove configurações existentes nem registros da conversa principal.
|
|
117
|
+
|
|
118
|
+
## Uso
|
|
119
|
+
|
|
120
|
+
### Pergunta sobre texto selecionado
|
|
121
|
+
|
|
122
|
+
Selecione um trecho de texto no corpo de uma mensagem da conversa e escolha «Perguntar sobre este texto» na barra flutuante superior. Digite sua pergunta e pressione Enter ou clique em «Explicar isso». Shift+Enter para nova linha, Esc para cancelar. A resposta será exibida em um balão BTW independente, e o texto original da citação poderá ser expandido.
|
|
123
|
+
|
|
124
|
+
- Suporta parágrafos normais, listas e blocos de código; até 8.000 unidades de código UTF-16 por citação (incluindo espaços). Se o limite for excedido, um aviso será exibido sem truncar o texto.
|
|
125
|
+
- A citação é fixada no momento da seleção e não será alterada caso a mensagem continue sendo gerada. O restante do contexto utiliza o conteúdo concluído na conversa principal no momento do envio.
|
|
126
|
+
- Não consome nem apaga o rascunho na caixa de entrada principal; seleções que cruzam múltiplas mensagens, campos de entrada ou saídas de ferramentas não exibirão esse menu.
|
|
127
|
+
- A barra também oferece a opção «Adicionar à conversa», anexando a citação ao rascunho existente e focando o campo de entrada sem envio automático. Durante o envio de mensagens, a adição fica suspensa. O clique com o botão direito mantém o menu padrão do navegador.
|
|
128
|
+
- Suporta seleções via teclado em elementos de texto; soltar a tecla Shift coloca o foco na barra flutuante. Navegadores sem suporte à API Popover recorrem a uma camada fixa (fixed).
|
|
129
|
+
- Separação de áreas com `dsh-better-sidebar`: o BTW processa exclusivamente o corpo da conversa; a visualização de arquivos e o editor preservam a opção original «Adicionar à conversa» da barra lateral sem duplicações.
|
|
130
|
+
- As novas opções dependem dos seletores de DOM do texto do host. Em layouts não reconhecidos, o comportamento original do botão direito é preservado e o comando `/btw` continua disponível.
|
|
131
|
+
|
|
132
|
+
### Pergunta por comando
|
|
133
|
+
|
|
134
|
+
Em uma conversa com contexto anterior:
|
|
135
|
+
|
|
136
|
+
```text
|
|
137
|
+
/btw Resuma a solução anterior em uma única frase
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
| Objetivo | Ação |
|
|
141
|
+
| --- | --- |
|
|
142
|
+
| Fazer pergunta secundária | Digite `/btw sua pergunta` e envie, ou escolha `btw` no menu `/` |
|
|
143
|
+
| Ver a resposta | Aguarde o balão independente surgir sobre a área de entrada |
|
|
144
|
+
| Copiar resposta | Clique no ícone de cópia no canto superior direito do balão |
|
|
145
|
+
| Recolher ou expandir | Clique no ícone de recolhimento/expansão no canto superior direito |
|
|
146
|
+
| Cancelar pergunta | Feche o balão durante a geração (a tarefa principal continua) |
|
|
147
|
+
| Fechar balão | Feche balões já finalizados |
|
|
148
|
+
| Fazer outra pergunta | Digite novamente `/btw sua pergunta`; cada consulta é 100% independente |
|
|
149
|
+
|
|
150
|
+
Caso precise executar comandos, modificar código ou continuar a tarefa principal, envie a solicitação na conversa normal. O BTW responde exclusivamente com base no contexto já existente.
|
|
151
|
+
|
|
152
|
+
O BTW aceita apenas texto. Se a mensagem contiver imagens ou arquivos anexados, a pergunta secundária será recusada mantendo o texto e os anexos intactos; remova os arquivos e tente novamente.
|
|
153
|
+
|
|
154
|
+
### Instruções de uso
|
|
155
|
+
|
|
156
|
+
- Cada pergunta secundária é autônoma e toma como referência o conteúdo finalizado da sessão principal no momento da solicitação; ela não inclui respostas em geração nem perguntas secundárias anteriores.
|
|
157
|
+
- Os balões não são preservados após a atualização da página; copie previamente as respostas que desejar manter.
|
|
158
|
+
|
|
159
|
+
## Configuração
|
|
160
|
+
|
|
161
|
+
As duas opções a seguir são opcionais. Se ambas ficarem em branco, o comportamento padrão será mantido: respostas puramente textuais com a instrução interna original.
|
|
162
|
+
|
|
163
|
+
Acesse **Plugins**, localize `@michengai/dsh-btw` e clique em **Configurações**. A página fica no mesmo local das configurações de `dsh-subagent-default-model`.
|
|
164
|
+
|
|
165
|
+
| Configuração | Descrição |
|
|
166
|
+
| --- | --- |
|
|
167
|
+
| **Ferramentas permitidas** | Nomes de ferramentas que a pergunta secundária pode invocar além de `send_message`, uma por linha (ex. `pele_draw`). Vazio restringe a apenas texto (padrão). |
|
|
168
|
+
| **Instrução personalizada** | Substitui a instrução integrada. Já vem pré-preenchida com o texto padrão para facilitar ajustes; salvar sem alterações restaura o padrão. |
|
|
169
|
+
|
|
170
|
+
Observações:
|
|
171
|
+
|
|
172
|
+
- A lista de permissões apenas expande o que a pergunta secundária pode chamar, sem jamais limitar a conversa principal; indicar ferramentas inexistentes equivale a não liberar nada.
|
|
173
|
+
- `send_message` não pode ser inserido na lista de permissões. O reenvio para o chat principal só é permitido para a própria sessão-mãe da pergunta secundária, e a lista não permite alterar o destino para outros agentes.
|
|
174
|
+
- A instrução personalizada substitui apenas o prefixo de instruções; as explicações sobre permissões de ferramentas e canal de retorno são sempre anexadas ao final para evitar alucinações de permissão pelo modelo.
|
|
175
|
+
- As alterações entram em vigor na próxima pergunta secundária sem necessidade de recarregar o plugin.
|
|
176
|
+
- Como as ferramentas liberadas são citadas no texto de permissões, expandir a lista altera a instrução da pergunta. Por fazer parte da mensagem final do usuário, as definições de ferramentas e as instruções do sistema continuam idênticas byte a byte à sessão principal, sem prejudicar o reaproveitamento do prompt cache.
|
|
177
|
+
|
|
178
|
+
### Exemplo: gerar diagramas em perguntas secundárias
|
|
179
|
+
|
|
180
|
+
O plugin [`dsh-pele`](https://github.com/hesheng01/dsh-pele) oferece a ferramenta `pele_draw`, que renderiza código Mermaid como cartões de diagramas SVG na sessão. Ao adicionar `pele_draw` em **Ferramentas permitidas**, a pergunta secundária também poderá desenhar diagramas.
|
|
181
|
+
|
|
182
|
+
> Observação: `dsh-pele` é um plugin recente ainda não publicado no npm nem catalogado no mercado de plugins. Para instalar, clone o repositório do GitHub e adicione a pasta `plugin` ao perfil:
|
|
183
|
+
>
|
|
184
|
+
> ```bash
|
|
185
|
+
> git clone https://github.com/hesheng01/dsh-pele.git
|
|
186
|
+
> dsh plugin --profile <profile> add <caminho_absoluto>/dsh-pele/plugin
|
|
187
|
+
> ```
|
|
188
|
+
>
|
|
189
|
+
> A primeira integração exige reiniciar o Host.
|
|
190
|
+
|
|
191
|
+
## Desinstalação
|
|
192
|
+
|
|
193
|
+
```powershell
|
|
194
|
+
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
195
|
+
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
196
|
+
|
|
197
|
+
dsh plugin --profile web remove @michengai/dsh-btw
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
Surte efeito após recarregar o DSH. Desativar ou atualizar não remove nenhum registro da conversa principal.
|
|
201
|
+
|
|
202
|
+
## Desenvolvimento local
|
|
203
|
+
|
|
204
|
+
```powershell
|
|
205
|
+
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
206
|
+
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
207
|
+
npm ci --ignore-scripts
|
|
208
|
+
npm run check
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
O comando `npm run check` executa verificação de tipos, testes e compilação.
|
|
212
|
+
|
|
213
|
+
A base de referência de desenvolvimento e compilação é `0.2.2-rc.1`. O comando `npm run test:compat` compila com essa base e executa a suíte de testes nas versões isoladas do host. Testes de componentes DOM não substituem a validação real em navegadores.
|
|
214
|
+
|
|
215
|
+
Tanto o GitHub quanto o npm contêm a pasta executável `lib`; após modificar o código-fonte, execute `npm run build` antes de fazer o commit.
|
|
216
|
+
|
|
217
|
+
Para instalar a partir do código-fonte, execute `dsh plugin --profile web add . --ignore-scripts` no diretório do projeto e recarregue o DSH.
|
|
218
|
+
|
|
219
|
+
## Licença
|
|
220
|
+
|
|
221
|
+
[Apache-2.0](LICENSE) © 2026 MichengAI.
|
package/README.ru.md
ADDED
|
@@ -0,0 +1,221 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="https://raw.githubusercontent.com/MichengAI/dsh-btw/2d8dd7752cec1b29dd705969eaa932635ba0bf4f/assets/branding/dsh-btw-banner.png" alt="DSH BTW" width="100%">
|
|
3
|
+
</p>
|
|
4
|
+
|
|
5
|
+
<div align="center">
|
|
6
|
+
|
|
7
|
+
# DSH BTW
|
|
8
|
+
|
|
9
|
+
**Уточняющие побочные вопросы в текущей сессии DeepSeek Harness: только ответы, без выполнения инструментов**
|
|
10
|
+
|
|
11
|
+
[简体中文](README.zh-CN.md) · [English](README.en.md) · [日本語](README.ja.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Русский](README.ru.md) · [Português](README.pt.md)
|
|
12
|
+
|
|
13
|
+
[Интерфейс](#интерфейс) · [Установка](#установка) · [Использование](#использование) · [История изменений](CHANGELOG.md) · [Apache-2.0](LICENSE)
|
|
14
|
+
|
|
15
|
+
[](LICENSE)
|
|
16
|
+
[](https://github.com/deepseek-ai/deepseek-harness)
|
|
17
|
+
[](https://nodejs.org/)
|
|
18
|
+
|
|
19
|
+
</div>
|
|
20
|
+
|
|
21
|
+
> DSH BTW — это поддерживаемый сообществом плагин для DeepSeek Harness, не являющийся официальным продуктом DeepSeek AI. Введите `/btw ваш вопрос` в текущем диалоге, чтобы получить контекстный ответ в отдельном независимом пузыре без прерывания основной задачи. Поддерживает DSH Web и десктопные приложения на базе DSH Web. Начиная с версии `1.0.0`, неподдерживаемые версии хоста безопасно отклоняются барьером версий (установленные конфигурации и история сессий сохраняются).
|
|
22
|
+
|
|
23
|
+
## Возможности
|
|
24
|
+
|
|
25
|
+
- **Вопросы с учетом контекста**: поясняйте концепции, подводите итоги или задавайте вопросы по текущему диалогу.
|
|
26
|
+
- **Только ответы, без выполнения действий**: не читает новые файлы, не выходит в сеть, не запускает системные команды и не правит код.
|
|
27
|
+
- **Автономные пузыри ответов**: поддержка Markdown, математических формул, копирования, сворачивания, разворачивания и закрытия. Можно просматривать несколько ответов одновременно.
|
|
28
|
+
- **Не прерывает основную задачу**: побочные вопросы обрабатываются отдельно и по умолчанию не засоряют основную ветку беседы.
|
|
29
|
+
- **Пересылка по требованию**: если результат нужен в основном диалоге, укажите в вопросе «отправь ответ в основной диалог», и через `send_message` будет передан цельный готовый ответ. Без прямого указания пересылка не выполняется.
|
|
30
|
+
- **Отмена в любой момент**: закрытие пузыря во время генерации немедленно прерывает выполнение побочного вопроса.
|
|
31
|
+
- **Полная локализация и темы оформления**: следует светлой и темной темам DSH. Начиная с версии хоста 0.2.2-rc.1 нативно поддерживаются все 8 официальных языков (русский, английский, китайский, японский, испанский, французский, немецкий, португальский); на более ранних версиях 0.2.0〜0.2.1 интерфейс корректно переключается на китайский и английский.
|
|
32
|
+
|
|
33
|
+
## Интерфейс
|
|
34
|
+
|
|
35
|
+
### Побочный вопрос в стандартном DSH
|
|
36
|
+
|
|
37
|
+
Основной диалог остается на месте, а ответ на побочный вопрос появляется над полем ввода.
|
|
38
|
+
|
|
39
|
+

|
|
40
|
+
|
|
41
|
+
### Меню команд
|
|
42
|
+
|
|
43
|
+
Введите `/` и выберите команду `btw`, либо напишите напрямую `/btw ваш вопрос`.
|
|
44
|
+
|
|
45
|
+

|
|
46
|
+
|
|
47
|
+
### Независимые пузыри ответов
|
|
48
|
+
|
|
49
|
+
Каждый вопрос выводится в отдельном блоке с кнопками копирования, сворачивания/разворачивания и закрытия в правом верхнем углу.
|
|
50
|
+
|
|
51
|
+

|
|
52
|
+
|
|
53
|
+
### Настройки побочных вопросов
|
|
54
|
+
|
|
55
|
+
Откройте **Плагины**, выберите `@michengai/dsh-btw` — форма настроек находится прямо на странице деталей: белый список инструментов и пользовательский промпт.
|
|
56
|
+
|
|
57
|
+

|
|
58
|
+
|
|
59
|
+
### Построение графиков и диаграмм
|
|
60
|
+
|
|
61
|
+
При добавлении `pele_draw` в белый список побочный вопрос сможет рендерить диаграммы прямо внутри своей панели, не затрагивая основной чат.
|
|
62
|
+
|
|
63
|
+

|
|
64
|
+
|
|
65
|
+
## Экосистема решений DSH
|
|
66
|
+
|
|
67
|
+
Для удобной работы на рабочем столе загрузите [DSH Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop/releases). Если у вас уже есть [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness), устанавливайте нужные плагины по отдельности. Ниже перечислены 11 собственных плагинов; фактический состав настольной версии определяется списком релиза и каталогом.
|
|
68
|
+
|
|
69
|
+
| Плагин | Назначение |
|
|
70
|
+
| --- | --- |
|
|
71
|
+
| [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | Организация проектов, поиск задач и навигация по репликам |
|
|
72
|
+
| [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | Выбор и вызов специализированных агентов под конкретную задачу |
|
|
73
|
+
| [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) | Поиск, управление, создание и импорт локальных навыков |
|
|
74
|
+
| [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | Поиск, восстановление и очистка архивированных диалогов |
|
|
75
|
+
| [IM Connect](https://github.com/MichengAI/dsh-im-connect) | Постановка задач и получение ответов через мессенджеры |
|
|
76
|
+
| [Automation](https://github.com/MichengAI/dsh-automation) | Выполнение задач по расписанию и просмотр отчетов |
|
|
77
|
+
| [BTW](https://github.com/MichengAI/dsh-btw) | Быстрые уточняющие вопросы в текущем контексте без прерывания задач |
|
|
78
|
+
| [Simplify](https://github.com/MichengAI/dsh-simplify) | Очистка и оптимизация кода в рамках изменений Git с помощью `/simplify` |
|
|
79
|
+
| [PUA](https://github.com/MichengAI/dsh-pua) | Направление агента на исправление ошибок и верификацию результатов |
|
|
80
|
+
| [Code Review](https://github.com/MichengAI/dsh-code-review) | Проведение независимого код-ревью с помощью `/review` |
|
|
81
|
+
| [Codex Pet](https://github.com/MichengAI/dsh-codex-pet) | Уведомления, подтверждение вызовов инструментов и ответы от питомца |
|
|
82
|
+
|
|
83
|
+
## Предварительные требования
|
|
84
|
+
|
|
85
|
+
- Установленный DeepSeek Harness.
|
|
86
|
+
- Поддерживаемые версии хоста: полная линейка DeepSeek Harness `0.2.x` (`>=0.2.0-rc.1 <0.3.0-0`), проверено на `0.2.0-rc.1`, `0.2.0-rc.2`, `0.2.1-rc.1`〜`0.2.1-rc.5`, `0.2.2-rc.1`. Обновления в рамках поколения не требуют ожидания нового релиза плагина.
|
|
87
|
+
- Поддержка языков: все 8 встроенных языков доступны для выбора начиная с DeepSeek Harness `0.2.2-rc.1`. На хостах `0.2.0`〜`0.2.1` дополнительные языковые словари остаются неактивными, а интерфейс безопасно переключается на китайский и английский.
|
|
88
|
+
- Ранние версии до `0.2.0-rc.1` не поддерживаются. Критические изменения ветки `0.3.0` блокируются барьером версий. Пользователям `0.1.x` следует установить версию `0.1.24`.
|
|
89
|
+
- Node.js 22+, доступная в консоли команда `dsh`.
|
|
90
|
+
|
|
91
|
+
## Установка
|
|
92
|
+
|
|
93
|
+
Приведенные команды используют профиль `web`. Замените его на целевой профиль. Перед установкой отключите другие плагины, предоставляющие команду `/btw`.
|
|
94
|
+
|
|
95
|
+
### Установка с помощью ИИ-агента (Рекомендуется)
|
|
96
|
+
|
|
97
|
+
Отправьте следующую инструкцию любому агенту, имеющему доступ к локальному терминалу:
|
|
98
|
+
|
|
99
|
+
```text
|
|
100
|
+
Установите плагин DSH @michengai/dsh-btw в локальный профиль web: dsh plugin --profile web add @michengai/dsh-btw@latest --registry=https://registry.npmjs.org/. После завершения выполните dsh --profile web --dump-config, чтобы убедиться в наличии michengai-btw, и расскажите, как перезагрузить DSH и начать работу.
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
### Ручная установка через npm
|
|
104
|
+
|
|
105
|
+
```powershell
|
|
106
|
+
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
107
|
+
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
108
|
+
|
|
109
|
+
dsh plugin --profile web add @michengai/dsh-btw@latest --registry=https://registry.npmjs.org/
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### Перезагрузка
|
|
113
|
+
|
|
114
|
+
Выполняйте установку или обновление после завершения текущих задач; настольное приложение может перезагрузиться автоматически. Если изменения не вступили в силу, используйте функцию перезагрузки приложения или перезапустите службу `dsh web`. Простого обновления страницы в браузере недостаточно.
|
|
115
|
+
|
|
116
|
+
На версиях до `0.2.0` и `0.2.1` alpha установка `@latest` блокируется барьером версий. Для `0.1.x` используйте `0.1.24`. Отклонение не удаляет существующие настройки и записи сессий.
|
|
117
|
+
|
|
118
|
+
## Использование
|
|
119
|
+
|
|
120
|
+
### Вопрос по выделенному тексту
|
|
121
|
+
|
|
122
|
+
Выделите фрагмент текста в сообщении диалога и нажмите «Спросить об этом фрагменте» на верхней всплывающей панели. Введите вопрос и нажмите Enter или кликните «Объяснить». Shift+Enter — перенос строки, Esc — отмена. Ответ отобразится в автономном пузыре BTW, а исходную цитату можно развернуть.
|
|
123
|
+
|
|
124
|
+
- Поддерживает обычные абзацы, списки и блоки кода; до 8 000 символов UTF-16 на цитату (включая пробелы). При превышении лимита выводится предупреждение без обрезки текста.
|
|
125
|
+
- Цитата фиксируется в момент выделения и не изменяется при дальнейшей генерации текста сообщения. Остальной контекст использует завершенные данные основной сессии на момент отправки.
|
|
126
|
+
- Не расходует и не очищает черновик в основном поле ввода; для выделений между несколькими сообщениями, в полях ввода и в выводе инструментов меню не отображается.
|
|
127
|
+
- Панель также содержит пункт «Добавить в диалог», который добавляет цитату в текущий черновик и переводит фокус на поле ввода без автоматической отправки. Во время отправки сообщений добавление приостанавливается. Правый клик мыши сохраняет системное меню браузера.
|
|
128
|
+
- Поддерживает выделение с клавиатуры внутри текстовых элементов; при отпускании Shift фокус переходит на панель. Браузеры без поддержки Popover API переключаются на фиксированный слой (fixed).
|
|
129
|
+
- Разделение зон с `dsh-better-sidebar`: BTW обрабатывает только тело сообщений; предпросмотр файлов и редактор сохраняют исходную функцию боковой панели «Добавить в диалог».
|
|
130
|
+
- Новые элементы зависят от DOM-разметки текста хоста. В нераспознанных макетах сохраняется стандартное поведение клика правой кнопкой мыши и команда `/btw` остается доступной.
|
|
131
|
+
|
|
132
|
+
### Вопрос через команду
|
|
133
|
+
|
|
134
|
+
В диалоге с существующим контекстом введите:
|
|
135
|
+
|
|
136
|
+
```text
|
|
137
|
+
/btw Опиши предыдущее решение одним предложением
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
| Задача | Действие |
|
|
141
|
+
| --- | --- |
|
|
142
|
+
| Задать побочный вопрос | Введите `/btw ваш вопрос` и отправьте, либо выберите `btw` в меню `/` |
|
|
143
|
+
| Просмотреть ответ | Дождитесь появления независимого пузыря над полем ввода |
|
|
144
|
+
| Скопировать ответ | Нажмите значок копирования в правом верхнем углу пузыря |
|
|
145
|
+
| Свернуть или развернуть | Нажмите значок сворачивания/разворачивания |
|
|
146
|
+
| Отменить вопрос | Закройте пузырь во время генерации (основная задача продолжится) |
|
|
147
|
+
| Закрыть пузырь | Закройте завершенные пузыри |
|
|
148
|
+
| Задать следующий вопрос | Снова введите `/btw ваш вопрос`; каждый запрос полностью автономен |
|
|
149
|
+
|
|
150
|
+
Если требуется запустить системную команду, изменить код или продолжить главную задачу, отправьте запрос в основном диалоге. BTW отвечает исключительно на базе имеющегося контекста.
|
|
151
|
+
|
|
152
|
+
BTW принимает только текст. Если к сообщению прикреплены изображения или файлы, побочный вопрос отклоняется с сохранением текста и вложений; удалите файлы и повторите попытку.
|
|
153
|
+
|
|
154
|
+
### Инструкции по использованию
|
|
155
|
+
|
|
156
|
+
- Каждый побочный вопрос автономен и ссылается только на завершенные реплики основной сессии на момент запроса; он не включает генерируемый в текущий момент ответ или предыдущие побочные вопросы.
|
|
157
|
+
- При обновлении страницы пузыри не сохраняются; скопируйте нужные ответы заранее.
|
|
158
|
+
|
|
159
|
+
## Конфигурация
|
|
160
|
+
|
|
161
|
+
Оба параметра ниже необязательны. Если оставить их пустыми, сохраняется стандартное поведение: ответы только текстом и встроенный системный промпт.
|
|
162
|
+
|
|
163
|
+
Откройте **Плагины**, найдите `@michengai/dsh-btw` и нажмите **Настройки**. Страница расположена там же, где и настройки `dsh-subagent-default-model`.
|
|
164
|
+
|
|
165
|
+
| Параметр | Назначение |
|
|
166
|
+
| --- | --- |
|
|
167
|
+
| **Разрешенные инструменты** | Имена инструментов, кроме `send_message`, доступные для вызова, по одному на строку (например, `pele_draw`). Пустое поле разрешает только текст (по умолчанию). |
|
|
168
|
+
| **Пользовательский промпт** | Заменяет встроенный промпт. Предзаполнен стандартным текстом для удобства правки; сохранение без изменений возвращает настройки по умолчанию. |
|
|
169
|
+
|
|
170
|
+
Примечания:
|
|
171
|
+
|
|
172
|
+
- Белый список только расширяет список инструментов для побочного вопроса и никогда не ограничивает основной диалог; указание несуществующих имен инструментов ни на что не влияет.
|
|
173
|
+
- `send_message` нельзя вносить в белый список. Пересылка ответа в основной чат разрешена только родительской сессии побочного вопроса и не может быть перенаправлена другому агенту.
|
|
174
|
+
- Пользовательский промпт заменяет только вводную часть инструкций; пояснения о правах инструментов и канале отправки всегда добавляются в конец, предотвращая ложные предположения модели о доступных возможностях.
|
|
175
|
+
- Изменения вступают в силу со следующего побочного вопроса без перезагрузки плагина.
|
|
176
|
+
- Так как разрешенные инструменты упоминаются в тексте ограничений, расширение белого списка изменяет промпт побочного вопроса. Поскольку он передается в конце сообщения пользователя, определения инструментов и системный промпт остаются побайтово идентичными основной сессии, не нарушая работу prompt cache.
|
|
177
|
+
|
|
178
|
+
### Пример: рисование диаграмм в побочном вопросе
|
|
179
|
+
|
|
180
|
+
Плагин [`dsh-pele`](https://github.com/hesheng01/dsh-pele) предоставляет инструмент `pele_draw`, который рендерит код Mermaid в виде SVG-карт в диалоге. Добавив `pele_draw` в **Разрешенные инструменты**, побочный вопрос также сможет строить диаграммы.
|
|
181
|
+
|
|
182
|
+
> Примечание: `dsh-pele` — новый плагин, еще не опубликованный в npm и каталоге плагинов. Для установки клонируйте репозиторий с GitHub и добавьте папку `plugin` в профиль:
|
|
183
|
+
>
|
|
184
|
+
> ```bash
|
|
185
|
+
> git clone https://github.com/hesheng01/dsh-pele.git
|
|
186
|
+
> dsh plugin --profile <profile> add <абсолютный_путь>/dsh-pele/plugin
|
|
187
|
+
> ```
|
|
188
|
+
>
|
|
189
|
+
> При первой привязке требуется перезапуск Host.
|
|
190
|
+
|
|
191
|
+
## Удаление
|
|
192
|
+
|
|
193
|
+
```powershell
|
|
194
|
+
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
195
|
+
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
196
|
+
|
|
197
|
+
dsh plugin --profile web remove @michengai/dsh-btw
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
Вступает в силу после перезагрузки DSH. Отключение или обновление не удаляет данные основных сессий.
|
|
201
|
+
|
|
202
|
+
## Локальная разработка
|
|
203
|
+
|
|
204
|
+
```powershell
|
|
205
|
+
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
206
|
+
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
207
|
+
npm ci --ignore-scripts
|
|
208
|
+
npm run check
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
Команда `npm run check` запускает проверку типов, тесты и сборку.
|
|
212
|
+
|
|
213
|
+
Базовой версией для разработки и сборки является `0.2.2-rc.1`. Команда `npm run test:compat` компилирует проект на этой базе и запускает набор тестов в изолированных средах поддерживаемых версий хоста. Тесты компонентов DOM не заменяют проверку в реальном браузере.
|
|
214
|
+
|
|
215
|
+
GitHub и npm содержат готовый исполняемый каталог `lib`; после изменения исходного кода перед коммитом выполните `npm run build`.
|
|
216
|
+
|
|
217
|
+
Для установки из исходников выполните в каталоге проекта `dsh plugin --profile web add . --ignore-scripts` и перезагрузите DSH.
|
|
218
|
+
|
|
219
|
+
## Лицензия
|
|
220
|
+
|
|
221
|
+
[Apache-2.0](LICENSE) © 2026 MichengAI.
|
package/README.zh-CN.md
CHANGED
|
@@ -8,7 +8,9 @@
|
|
|
8
8
|
|
|
9
9
|
**在 DeepSeek Harness 当前会话中随手旁问,只回答,不执行**
|
|
10
10
|
|
|
11
|
-
[English](README.en.md) · [
|
|
11
|
+
[简体中文](README.zh-CN.md) · [English](README.en.md) · [日本語](README.ja.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Русский](README.ru.md) · [Português](README.pt.md)
|
|
12
|
+
|
|
13
|
+
[界面预览](#界面预览) · [安装](#安装) · [使用](#使用) · [更新日志](CHANGELOG.zh-CN.md) · [Apache-2.0](LICENSE)
|
|
12
14
|
|
|
13
15
|
[](LICENSE)
|
|
14
16
|
[](https://github.com/deepseek-ai/deepseek-harness)
|
|
@@ -26,7 +28,7 @@
|
|
|
26
28
|
- **不打断主任务**:旁问单独作答,答案默认不会写入主会话。
|
|
27
29
|
- **需要时才回传**:想在主对话里拿到结论时,在问题中明确要求「把答案发回主对话」,旁问会用 `send_message` 把一份自足的答案发回主会话;没有要求时不会回传。
|
|
28
30
|
- **随时取消**:关闭正在回答的气泡即可取消该旁问。
|
|
29
|
-
-
|
|
31
|
+
- **全量国际化与主题**:跟随 DSH 浅色、深色主题;自宿主 0.2.2-rc.1 起完整支持官方 8 门内置语言(中文、英语、日语、西班牙语、法语、德语、俄语、葡萄牙语),在更早的 0.2.0~0.2.1 宿主下安全回退为中英双语。
|
|
30
32
|
|
|
31
33
|
## 界面预览
|
|
32
34
|
|
|
@@ -82,6 +84,7 @@
|
|
|
82
84
|
|
|
83
85
|
- 已安装 DeepSeek Harness。
|
|
84
86
|
- 宿主支持范围:DeepSeek Harness `0.2.x` 全系列(`>=0.2.0-rc.1 <0.3.0-0`),已验证兼容 `0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-rc.1`~`0.2.1-rc.5`、`0.2.2-rc.1`,并自动支持后续 `0.2.x` 的全部 0.2.x RC 版本,同代宿主升级无需重复等待发版。
|
|
87
|
+
- 语言支持范围:自 DeepSeek Harness `0.2.2-rc.1` 起原生可选全部 8 门内置语言;在 `0.2.0`~`0.2.1` 宿主下额外注册的语言保持惰性,界面安全回退为中文与英文。
|
|
85
88
|
- 不再支持 `0.2.0-rc.1` 之前的早期宿主,遇到 `0.3.0` 代际破坏性更新时将被版本门安全拦截。仍在使用 `0.1.x` 的用户请安装插件 `0.1.24`。
|
|
86
89
|
- Node.js 22+,可在终端执行 `dsh`。
|
|
87
90
|
|
|
@@ -207,7 +210,7 @@ npm run check
|
|
|
207
210
|
|
|
208
211
|
`npm run check` 执行类型检查、测试和构建。
|
|
209
212
|
|
|
210
|
-
开发与构建基线为 `0.2.
|
|
213
|
+
开发与构建基线为 `0.2.2-rc.1`。`npm run test:compat` 用该基线编译,再在各隔离宿主版本中分别运行测试集,模型使用测试适配器。DOM 组件测试不替代真实浏览器验收。
|
|
211
214
|
|
|
212
215
|
GitHub 与 npm 都包含可直接运行的 `lib`;改了源码后,提交前运行 `npm run build`。
|
|
213
216
|
|