@michengai/dsh-btw 1.3.3 → 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/README.es.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
+ **Preguntas secundarias rápidas en la sesión actual de DeepSeek Harness: solo responde, no ejecuta herramientas**
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-pantalla) · [Instalación](#instalación) · [Uso](#uso) · [Registro de cambios](CHANGELOG.md) · [Apache-2.0](LICENSE)
14
+
15
+ [![Licencia: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
16
+ [![DSH Web Plugin](https://img.shields.io/badge/DSH%20Web-Plugin-0f766e.svg)](https://github.com/deepseek-ai/deepseek-harness)
17
+ [![Node.js 22+](https://img.shields.io/badge/Node.js-22%2B-339933.svg?logo=node.js&logoColor=white)](https://nodejs.org/)
18
+
19
+ </div>
20
+
21
+ > DSH BTW es un plugin para DeepSeek Harness mantenido por la comunidad, no un producto oficial de DeepSeek AI. Escriba `/btw su pregunta` en la conversación actual para obtener una respuesta contextual en una burbuja independiente sin interrumpir la tarea principal. Admite DSH Web y las aplicaciones de escritorio que integran DSH Web. A partir de `1.0.0`, los hosts no incluidos en la lista compatible serán rechazados de forma segura mediante la barrera de versión (la configuración instalada y los registros de la conversación se conservan).
22
+
23
+ ## Características principales
24
+
25
+ - **Preguntas con contexto**: explique conceptos, resuma conclusiones o responda dudas puntuales sobre la conversación actual.
26
+ - **Solo responde, no ejecuta**: no lee archivos nuevos, no navega por la red, no ejecuta comandos ni modifica código.
27
+ - **Burbuja de respuesta independiente**: admite Markdown, fórmulas matemáticas, copiar, contraer, expandir y cerrar. Puede ver múltiples respuestas simultáneamente.
28
+ - **No interrumpe la tarea principal**: las preguntas secundarias se responden por separado y no se agregan a la conversación principal por defecto.
29
+ - **Reenvío bajo petición**: si desea la conclusión en el chat principal, solicite expresamente en la pregunta «enviar la respuesta al chat principal»; se utilizará `send_message` para enviar una respuesta completa y autosuficiente. No se reenviará si no se solicita.
30
+ - **Cancelación en cualquier momento**: cerrar la burbuja mientras responde cancela inmediatamente esa pregunta secundaria.
31
+ - **Internacionalización completa y temas**: sigue el tema claro u oscuro de DSH. A partir del host 0.2.2-rc.1 ofrece compatibilidad nativa con los 8 idiomas oficiales (español, inglés, chino, japonés, francés, alemán, ruso y portugués); en hosts anteriores 0.2.0〜0.2.1 recurre de forma segura al chino e inglés.
32
+
33
+ ## Capturas de pantalla
34
+
35
+ ### Pregunta secundaria en DSH nativo
36
+
37
+ La conversación principal permanece intacta y la respuesta secundaria aparece directamente sobre el cuadro de entrada.
38
+
39
+ ![Burbuja de respuesta independiente en la conversación](https://raw.githubusercontent.com/MichengAI/dsh-btw/2d8dd7752cec1b29dd705969eaa932635ba0bf4f/assets/screenshots/btw-conversation.png)
40
+
41
+ ### Menú de comandos
42
+
43
+ Escriba `/` y seleccione `btw` en Comandos, o escriba directamente `/btw su pregunta`.
44
+
45
+ ![Entrada btw en el menú oficial de comandos](https://raw.githubusercontent.com/MichengAI/dsh-btw/2d8dd7752cec1b29dd705969eaa932635ba0bf4f/assets/screenshots/btw-command-menu.png)
46
+
47
+ ### Burbujas de respuesta independientes
48
+
49
+ Cada consulta se muestra en su propia burbuja, con botones en la esquina superior derecha para copiar, contraer/expandir o cerrar.
50
+
51
+ ![Múltiples burbujas de respuesta con controles](https://raw.githubusercontent.com/MichengAI/dsh-btw/2d8dd7752cec1b29dd705969eaa932635ba0bf4f/assets/screenshots/btw-bubbles.png)
52
+
53
+ ### Configuración de preguntas secundarias
54
+
55
+ Abra **Plugins**, seleccione `@michengai/dsh-btw` y encontrará el formulario de configuración directamente en la página de detalles: herramientas permitidas e instrucciones personalizadas.
56
+
57
+ ![Formulario de configuración en la página de detalles](assets/screenshots/btw-settings-panel.png)
58
+
59
+ ### Dibujar diagramas en preguntas secundarias
60
+
61
+ Con `pele_draw` en la lista blanca, la pregunta secundaria también puede generar diagramas dentro de su propio panel sin alterar el chat principal.
62
+
63
+ ![Renderizado de diagramas con pele_draw](assets/screenshots/btw-pele-draw.png)
64
+
65
+ ## Ecosistema de productos DSH
66
+
67
+ Si desea utilizar la estación de trabajo de escritorio, descargue [DSH Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop/releases). Si ya cuenta con [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness), instale los complementos según sus necesidades. A continuación se enumeran 11 plugins desarrollados internamente; la inclusión real en la versión de escritorio depende de las notas de la versión y el catálogo integrado correspondientes.
68
+
69
+ | Plugin | Utilidad |
70
+ | --- | --- |
71
+ | [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | Organizar proyectos y sesiones, búsqueda de tareas y navegación |
72
+ | [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | Seleccionar e invocar especialistas según la tarea |
73
+ | [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) | Buscar, activar, crear e importar habilidades locales |
74
+ | [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | Buscar, restaurar y depurar sesiones archivadas |
75
+ | [IM Connect](https://github.com/MichengAI/dsh-im-connect) | Asignar tareas y recibir respuestas desde mensajería instantánea |
76
+ | [Automation](https://github.com/MichengAI/dsh-automation) | Ejecutar tareas programadas y ver historiales de ejecución |
77
+ | [BTW](https://github.com/MichengAI/dsh-btw) | Consultas contextuales rápidas sin interrumpir la tarea principal |
78
+ | [Simplify](https://github.com/MichengAI/dsh-simplify) | Limpiar y optimizar cambios de Git con `/simplify` |
79
+ | [PUA](https://github.com/MichengAI/dsh-pua) | Guiar al agente para rectificar enfoques en fallos y verificar resultados |
80
+ | [Code Review](https://github.com/MichengAI/dsh-code-review) | Iniciar revisiones de código independientes con `/review` |
81
+ | [Codex Pet](https://github.com/MichengAI/dsh-codex-pet) | Avisos de sesión, aprobaciones de herramientas y respuestas mediante mascota |
82
+
83
+ ## Requisitos previos
84
+
85
+ - DeepSeek Harness instalado.
86
+ - Rango de compatibilidad del host: serie completa DeepSeek Harness `0.2.x` (`>=0.2.0-rc.1 <0.3.0-0`), verificado con `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`. Las actualizaciones dentro de la misma generación no requieren esperar nuevos lanzamientos del plugin.
87
+ - Rango de compatibilidad de idiomas: los 8 idiomas integrados son seleccionables de forma nativa a partir de DeepSeek Harness `0.2.2-rc.1`. En hosts `0.2.0`〜`0.2.1`, los diccionarios adicionales registrados permanecen inactivos y la interfaz recurre de manera segura al chino e inglés.
88
+ - Los hosts anteriores a `0.2.0-rc.1` ya no son compatibles. Las modificaciones destructivas de la generación `0.3.0` serán interceptadas por la barrera de versión. Los usuarios de `0.1.x` deben instalar la versión `0.1.24`.
89
+ - Node.js 22+, capaz de ejecutar el comando `dsh` en la terminal.
90
+
91
+ ## Instalación
92
+
93
+ Los siguientes comandos usan el perfil `web`. Adáptelo a su entorno según corresponda. Desactive otros plugins que proporcionen el comando `/btw` antes de la instalación.
94
+
95
+ ### Instalación mediante un agente (Recomendado)
96
+
97
+ Envíe el siguiente mensaje a cualquier agente capaz de ejecutar comandos de terminal local:
98
+
99
+ ```text
100
+ Instale el plugin de DSH @michengai/dsh-btw en el perfil web local ejecutando: dsh plugin --profile web add @michengai/dsh-btw@latest --registry=https://registry.npmjs.org/. Tras la instalación, ejecute dsh --profile web --dump-config para comprobar que incluye michengai-btw y explíqueme cómo recargar DSH y comenzar a usarlo.
101
+ ```
102
+
103
+ ### Instalación manual desde 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
+ ### Recargar
113
+
114
+ Instale o actualice después de terminar las tareas en curso; la aplicación de escritorio puede reiniciarse automáticamente. Si el cambio no surte efecto, use la acción de recarga de la aplicación o reinicie el servicio `dsh web`. No basta con actualizar la ventana del navegador.
115
+
116
+ En hosts anteriores a `0.2.0` y en `0.2.1` alpha, la instalación de `@latest` será rechazada por la barrera de versión y el plugin no se ejecutará. Para `0.1.x` instale `0.1.24`. El rechazo no elimina las configuraciones existentes ni los registros de las sesiones principales.
117
+
118
+ ## Uso
119
+
120
+ ### Consultar texto seleccionado
121
+
122
+ Seleccione texto en el cuerpo de un mensaje de la conversación y elija «Preguntar sobre este texto» en la barra flotante superior. Ingrese su duda y presione Enter o pulse «Explicar esto». Shift+Enter para salto de línea, Esc para cancelar. La respuesta se mostrará en una burbuja independiente de BTW, permitiendo desplegar la cita original.
123
+
124
+ - Admite párrafos convencionales, listas y bloques de código; hasta 8.000 unidades de código UTF-16 por selección (incluidos espacios en blanco). Si se supera el límite se avisará sin truncar el texto.
125
+ - La cita se fija al seleccionarla y no cambiará aunque el mensaje continúe generándose. El resto del contexto utiliza el contenido finalizado en el chat principal al momento del envío.
126
+ - No ocupa ni limpia el borrador del cuadro de entrada principal; las selecciones entre múltiples mensajes, en cuadros de entrada o en salidas de herramientas no mostrarán este menú.
127
+ - La barra también ofrece «Añadir a la conversación», agregando la cita al borrador actual y enfocando el cuadro de entrada sin enviarla automáticamente. Durante el envío de mensajes la adición se suspende. El clic derecho conserva el menú nativo del navegador.
128
+ - Admite selecciones mediante teclado dentro del elemento de texto; al soltar Shift se enfoca la barra flotante. Los navegadores sin soporte de Popover API recurren a una capa fija (fixed), que puede verse afectada por recortes de diseño del host.
129
+ - Tratamiento diferenciado respecto a `dsh-better-sidebar`: BTW solo gestiona el cuerpo de la conversación; la vista previa de archivos y el editor conservan la opción original «Añadir a la conversación» del plugin lateral, evitando barras duplicadas.
130
+ - Las nuevas entradas dependen de los selectores DOM del texto del host. En diseños no reconocidos se conserva el comportamiento original del clic derecho y se puede seguir utilizando `/btw`.
131
+
132
+ ### Consultas mediante comando
133
+
134
+ En una conversación con contexto previo introduzca:
135
+
136
+ ```text
137
+ /btw Resume la solución anterior en una sola frase
138
+ ```
139
+
140
+ | Objetivo | Acción |
141
+ | --- | --- |
142
+ | Hacer una pregunta secundaria | Escriba `/btw su pregunta` y envíe, o elija `btw` en el menú `/` |
143
+ | Ver la respuesta | Espere a que la burbuja independiente sobre el cuadro de entrada devuelva la respuesta |
144
+ | Copiar la respuesta | Pulse el icono de copia en la esquina superior derecha de la burbuja |
145
+ | Contraer o expandir | Pulse el icono de pliegue o despliegue en la esquina superior derecha |
146
+ | Cancelar la consulta | Cierre la burbuja durante la generación (no cancela la tarea principal) |
147
+ | Cerrar la burbuja | Cierre las burbujas finalizadas |
148
+ | Continuar preguntando | Vuelva a escribir `/btw su pregunta`; cada consulta es totalmente independiente |
149
+
150
+ Si necesita ejecutar comandos, modificar código o continuar la tarea principal, envíela a través de la conversación ordinaria. BTW solo puede responder basándose en el contexto existente.
151
+
152
+ BTW solo acepta texto. Si el cuadro de entrada incluye imágenes o archivos adjuntos, rechazará la pregunta secundaria conservando el texto y los adjuntos; retire los archivos e inténtelo de nuevo.
153
+
154
+ ### Instrucciones de uso
155
+
156
+ - Cada consulta secundaria es independiente y toma como referencia el contenido ya completado de la sesión principal en el momento de preguntar; no incluye respuestas en generación ni consultas secundarias previas.
157
+ - Las burbujas no se conservan tras refrescar la página; copie con antelación las respuestas que necesite conservar.
158
+
159
+ ## Configuración
160
+
161
+ Las siguientes dos opciones son opcionales. Si ambas se dejan vacías se mantendrá el comportamiento predeterminado de fábrica: solo respuestas de texto plano con el prompt integrado.
162
+
163
+ Abra **Plugins**, busque `@michengai/dsh-btw` y pulse en **Configuración**. La ubicación de la página coincide con la de `dsh-subagent-default-model`.
164
+
165
+ | Parámetro | Función |
166
+ | --- | --- |
167
+ | **Herramientas permitidas** | Nombres de herramientas que la consulta secundaria puede invocar además de `send_message`, uno por línea (ej. `pele_draw`). Vacío restringe a solo texto (valor predeterminado). |
168
+ | **Prompt personalizado** | Sustituye el prompt integrado. El cuadro ya está precargado con el texto original para editarlo directamente; guardar sin cambios restaura el valor por defecto. |
169
+
170
+ Instrucciones:
171
+
172
+ - La lista blanca solo amplía el alcance de lo que la consulta secundaria puede invocar, sin restringir jamás el chat principal; indicar herramientas inexistentes equivale a no permitir nada.
173
+ - `send_message` no puede incluirse en la lista blanca. El reenvío al chat principal solo se permite hacia la sesión padre propia de la consulta secundaria, y la lista blanca no puede transformarlo en «enviar a cualquier agente».
174
+ - El prompt personalizado solo sustituye el prefijo de instrucciones; las aclaraciones sobre permisos de herramientas y canales de retorno se añaden siempre al final para evitar interpretaciones erróneas del modelo.
175
+ - Las modificaciones surten efecto en la siguiente consulta secundaria sin requerir recargar el plugin.
176
+ - Dado que las herramientas permitidas se detallan en el texto de permisos, ampliar la lista blanca altera el prompt de la consulta. Al formar parte del mensaje final del usuario, las definiciones de herramientas y el prompt del sistema permanecen idénticos byte a byte con la sesión principal, sin perjudicar la reutilización de la cache de prompts (prompt cache).
177
+
178
+ ### Ejemplo: dibujar diagramas en consultas secundarias
179
+
180
+ [`dsh-pele`](https://github.com/hesheng01/dsh-pele) proporciona la herramienta `pele_draw`, que renderiza código fuente Mermaid como tarjetas de diagramas SVG en la sesión. Al añadir `pele_draw` a **Herramientas permitidas**, la consulta secundaria también podrá generar diagramas.
181
+
182
+ > Nota: `dsh-pele` es un plugin reciente que aún no está publicado en npm ni figura en el mercado de plugins. Puede instalarse clonando el repositorio de GitHub y añadiendo el directorio `plugin` al perfil:
183
+ >
184
+ > ```bash
185
+ > git clone https://github.com/hesheng01/dsh-pele.git
186
+ > dsh plugin --profile <profile> add <ruta_absoluta>/dsh-pele/plugin
187
+ > ```
188
+ >
189
+ > La primera vinculación requiere reiniciar el Host.
190
+
191
+ ## Desinstalación
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 efecto tras recargar DSH. Desactivar o actualizar el plugin no elimina los registros de la conversación principal.
201
+
202
+ ## Desarrollo 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
+ `npm run check` ejecuta la comprobación de tipos, las pruebas y la compilación.
212
+
213
+ La línea base de desarrollo y compilación es `0.2.2-rc.1`. `npm run test:compat` compila con dicha línea base y ejecuta el conjunto de pruebas en cada una de las versiones de host aisladas. Los modelos emplean adaptadores de prueba. Las pruebas de componentes DOM no sustituyen la verificación real en navegadores.
214
+
215
+ Tanto GitHub como npm contienen el directorio `lib` ejecutable; tras modificar el código fuente ejecute `npm run build` antes de realizar una confirmación (commit).
216
+
217
+ Para instalar desde el código fuente ejecute `dsh plugin --profile web add . --ignore-scripts` en el directorio del proyecto y recargue DSH.
218
+
219
+ ## Licencia
220
+
221
+ [Apache-2.0](LICENSE) © 2026 MichengAI.
package/README.fr.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
+ **Posez des questions secondaires dans la session en cours de DeepSeek Harness : répond uniquement, sans exécuter d'outils**
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
+ [Aperçu](#aperçu-de-linterface) · [Installation](#installation) · [Utilisation](#utilisation) · [Journal des modifications](CHANGELOG.md) · [Apache-2.0](LICENSE)
14
+
15
+ [![Licence : Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
16
+ [![DSH Web Plugin](https://img.shields.io/badge/DSH%20Web-Plugin-0f766e.svg)](https://github.com/deepseek-ai/deepseek-harness)
17
+ [![Node.js 22+](https://img.shields.io/badge/Node.js-22%2B-339933.svg?logo=node.js&logoColor=white)](https://nodejs.org/)
18
+
19
+ </div>
20
+
21
+ > DSH BTW est un plugin DeepSeek Harness maintenu par la communauté, et non un produit officiel de DeepSeek AI. Saisissez `/btw votre question` dans la session en cours pour obtenir une réponse contextuelle dans une bulle autonome, sans interrompre la tâche principale. Compatible avec DSH Web et les applications de bureau intégrant DSH Web. À partir de la version `1.0.0`, les hôtes non pris en charge sont rejetés en toute sécurité par la barrière de version (la configuration installée et les données de conversation restent intactes).
22
+
23
+ ## Vue d'ensemble
24
+
25
+ - **Questions contextuelles** : obtenez l'explication d'un concept, un récapitulatif ou des clarifications sans perdre le fil.
26
+ - **Réponse uniquement, aucune exécution** : ne lit pas de nouveaux fichiers, ne navigue pas sur le web, n'exécute pas de commandes et ne modifie aucun code.
27
+ - **Bulles de réponse indépendantes** : prise en charge du Markdown, des formules mathématiques, de la copie, du repli, du déploiement et de la fermeture. Plusieurs réponses peuvent être consultées simultanément.
28
+ - **N'interrompt pas la tâche principale** : les questions secondaires sont traitées à part et ne sont pas ajoutées à la conversation principale par défaut.
29
+ - **Renvoi sur demande** : demandez explicitement dans votre question de « renvoyer la réponse à la conversation principale » pour que `send_message` transmette une réponse autonome à la session principale. Aucun renvoi n'est effectué sans demande expresse.
30
+ - **Annulation à tout moment** : fermer la bulle pendant la génération annule immédiatement la question secondaire.
31
+ - **Internationalisation complète & thèmes** : suit le thème clair/sombre de DSH. À partir de la version d'hôte 0.2.2-rc.1, les 8 langues officielles (français, anglais, chinois, japonais, espagnol, allemand, russe, portugais) sont prises en charge nativement ; les hôtes antérieurs 0.2.0〜0.2.1 basculent de manière sécurisée en chinois et anglais.
32
+
33
+ ## Aperçu de l'interface
34
+
35
+ ### Question secondaire dans DSH
36
+
37
+ La conversation principale reste à sa place et la réponse secondaire s'affiche au-dessus de la zone de saisie.
38
+
39
+ ![Bulle de réponse indépendante](https://raw.githubusercontent.com/MichengAI/dsh-btw/2d8dd7752cec1b29dd705969eaa932635ba0bf4f/assets/screenshots/btw-conversation.png)
40
+
41
+ ### Menu de commandes
42
+
43
+ Tapez `/` et choisissez `btw` dans le menu des commandes, ou tapez directement `/btw votre question`.
44
+
45
+ ![Entrée btw dans le menu de commandes](https://raw.githubusercontent.com/MichengAI/dsh-btw/2d8dd7752cec1b29dd705969eaa932635ba0bf4f/assets/screenshots/btw-command-menu.png)
46
+
47
+ ### Bulles de réponse autonomes
48
+
49
+ Chaque question secondaire dispose de sa propre bulle avec des boutons en haut à droite pour copier, réduire/développer et fermer.
50
+
51
+ ![Bulles de réponse multiples](https://raw.githubusercontent.com/MichengAI/dsh-btw/2d8dd7752cec1b29dd705969eaa932635ba0bf4f/assets/screenshots/btw-bubbles.png)
52
+
53
+ ### Configuration des questions secondaires
54
+
55
+ Ouvrez **Plugins**, sélectionnez `@michengai/dsh-btw` pour afficher directement le formulaire de configuration sur la page détaillée : liste blanche des outils et invite personnalisée.
56
+
57
+ ![Formulaire de configuration du plugin](assets/screenshots/btw-settings-panel.png)
58
+
59
+ ### Générer des diagrammes
60
+
61
+ En ajoutant `pele_draw` à la liste blanche, la question secondaire peut également générer des diagrammes Mermaid dans son propre panneau sans modifier la conversation principale.
62
+
63
+ ![Rendu de diagramme avec pele_draw](assets/screenshots/btw-pele-draw.png)
64
+
65
+ ## Écosystème DeepSeek Harness
66
+
67
+ Pour utiliser l'espace de travail sur bureau, téléchargez [DSH Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop/releases). Pour une installation existante de [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness), installez les plugins selon vos besoins. Voici 11 plugins développés en interne ; le contenu réel de la version de bureau dépend des notes de version et du catalogue intégré correspondants.
68
+
69
+ | Plugin | Description |
70
+ | --- | --- |
71
+ | [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | Gestion des projets, recherche de tâches et navigation par tour |
72
+ | [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | Sélectionner et invoquer des agents experts par tâche |
73
+ | [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) | Recherche, activation, création et importation de compétences |
74
+ | [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | Recherche, restauration et nettoyage des sessions archivées |
75
+ | [IM Connect](https://github.com/MichengAI/dsh-im-connect) | Assigner des tâches et recevoir les réponses via messagerie instantanée |
76
+ | [Automation](https://github.com/MichengAI/dsh-automation) | Exécution planifiée de tâches et historique des runs |
77
+ | [BTW](https://github.com/MichengAI/dsh-btw) | Questions annexes rapides sans interrompre la tâche principale |
78
+ | [Simplify](https://github.com/MichengAI/dsh-simplify) | Nettoyer et simplifier le code modifié avec `/simplify` |
79
+ | [PUA](https://github.com/MichengAI/dsh-pua) | Guider l'agent pour corriger ses approches et valider les résultats |
80
+ | [Code Review](https://github.com/MichengAI/dsh-code-review) | Lancer des revues de code indépendantes avec `/review` |
81
+ | [Codex Pet](https://github.com/MichengAI/dsh-codex-pet) | Alertes, approbations d'outils et réponses via un compagnon de bureau |
82
+
83
+ ## Prérequis
84
+
85
+ - DeepSeek Harness installé.
86
+ - Compatibilité de l'hôte : série complète DeepSeek Harness `0.2.x` (`>=0.2.0-rc.1 <0.3.0-0`), validée sur `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`. Les mises à niveau de la même génération ne nécessitent pas de nouvelles versions du plugin.
87
+ - Support linguistique : l'ensemble des 8 langues intégrées est nativement sélectionnable à partir de DeepSeek Harness `0.2.2-rc.1`. Sur les hôtes `0.2.0`〜`0.2.1`, les dictionnaires supplémentaires enregistrés restent dormants et l'interface bascule de façon sécurisée en chinois et anglais.
88
+ - Les hôtes antérieurs à `0.2.0-rc.1` ne sont plus pris en charge. Les modifications destructives de la génération `0.3.0` sont interceptées par la barrière de version. Les utilisateurs de versions `0.1.x` doivent installer la version `0.1.24`.
89
+ - Node.js 22+, avec la commande `dsh` disponible dans le terminal.
90
+
91
+ ## Installation
92
+
93
+ Les exemples ci-dessous utilisent le profil `web`. Adaptez-les selon votre environnement. Désactivez tout autre plugin fournissant la commande `/btw` avant l'installation.
94
+
95
+ ### Installation assistée par Agent (Recommandé)
96
+
97
+ Transmettez ce message à un agent ayant accès au terminal local :
98
+
99
+ ```text
100
+ Veuillez installer le plugin DSH @michengai/dsh-btw dans le profil web local en exécutant : dsh plugin --profile web add @michengai/dsh-btw@latest --registry=https://registry.npmjs.org/. Après l'installation, exécutez dsh --profile web --dump-config pour confirmer la présence de michengai-btw et expliquez-moi comment recharger DSH et commencer à l'utiliser.
101
+ ```
102
+
103
+ ### Installation manuelle 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
+ ### Rechargement
113
+
114
+ Installez ou mettez à jour après avoir terminé les tâches en cours. L'application de bureau peut se recharger automatiquement. Si les modifications ne s'appliquent pas, utilisez la fonction « Recharger » de l'application ou redémarrez le service `dsh web`. Actualiser le navigateur ne suffit pas.
115
+
116
+ Sur les hôtes antérieurs à `0.2.0` et sur `0.2.1` alpha, l'installation de `@latest` est rejetée par la barrière de version et le plugin ne s'exécutera pas. Pour `0.1.x`, installez `0.1.24`. Ce rejet ne supprime ni les configurations existantes ni l'historique des conversations.
117
+
118
+ ## Utilisation
119
+
120
+ ### Poser une question sur un texte sélectionné
121
+
122
+ Sélectionnez du texte dans un message de la conversation et cliquez sur « Poser une question sur ce texte » dans la barre flottante supérieure. Saisissez votre question et appuyez sur Entrée, ou cliquez sur « Expliquer cela ». Shift+Entrée pour un saut de ligne, Échap pour annuler. La réponse s'affiche dans une bulle dédiée BTW et la citation d'origine peut être dépliée.
123
+
124
+ - Prise en charge des paragraphes ordinaires, listes et blocs de code ; jusqu'à 8 000 unités de code UTF-16 par sélection (espaces compris). Tout dépassement est signalé sans tronquer le texte.
125
+ - La citation est figée lors de la sélection et ne change pas si la réponse continue de se générer. Le reste du contexte s'appuie sur le contenu finalisé au moment de l'envoi.
126
+ - Ne consomme ni ne vide le brouillon de la zone de saisie principale ; les sélections couvrant plusieurs messages, la zone de saisie ou les retours d'outils n'affichent pas ce menu.
127
+ - La barre propose également « Ajouter à la conversation », ajoutant la citation au brouillon existant et plaçant le focus sur la zone de saisie sans envoi automatique. L'ajout est suspendu pendant l'envoi d'un message. Le clic droit conserve le menu natif du navigateur.
128
+ - Prise en charge des sélections au clavier dans les éléments de texte ; relâcher Shift place le focus sur la barre. Les navigateurs sans support de l'API Popover basculent sur une couche fixe (fixed), susceptible d'être rognée par l'agencement de l'hôte.
129
+ - Séparation des zones avec `dsh-better-sidebar` : BTW ne traite que le corps de la conversation ; la prévisualisation de fichiers et l'éditeur conservent l'option d'origine « Ajouter à la conversation » du panneau latéral sans doublons.
130
+ - Les nouvelles entrées dépendent des balises DOM de l'hôte. Les agencements non reconnus conservent le comportement du clic droit d'origine et permettent toujours d'utiliser `/btw`.
131
+
132
+ ### Poser une question via une commande
133
+
134
+ Dans une conversation disposant d'un contexte préalable :
135
+
136
+ ```text
137
+ /btw Résume la solution précédente en une seule phrase
138
+ ```
139
+
140
+ | Objectif | Action |
141
+ | --- | --- |
142
+ | Poser une question secondaire | Tapez `/btw votre question` et validez, ou choisissez `btw` dans le menu `/` |
143
+ | Consulter la réponse | Attendez l'apparition de la bulle dédiée au-dessus de la saisie |
144
+ | Copier la réponse | Cliquez sur l'icône de copie en haut à droite de la bulle |
145
+ | Réduire ou développer | Cliquez sur l'icône de pliage ou de dépliage en haut à droite |
146
+ | Annuler la question | Fermez la bulle pendant la génération (la tâche principale continue) |
147
+ | Supprimer la bulle | Fermez les bulles finalisées |
148
+ | Poser une autre question | Tapez à nouveau `/btw votre question` ; chaque question est indépendante |
149
+
150
+ Pour exécuter des commandes, modifier du code ou poursuivre la tâche principale, utilisez la conversation principale. BTW ne répond que sur la base du contexte existant.
151
+
152
+ BTW n'accepte que du texte. Si des images ou des fichiers sont attachés à la saisie, la question secondaire est refusée tout en conservant le texte et les pièces jointes ; retirez-les et réessayez.
153
+
154
+ ### Instructions d'utilisation
155
+
156
+ - Chaque question secondaire est autonome et prend comme référence le contenu achevé de la session principale au moment de la demande ; elle n'inclut ni les réponses en cours ni les questions secondaires précédentes.
157
+ - Les bulles ne sont pas conservées après actualisation de la page ; copiez au préalable les réponses que vous souhaitez conserver.
158
+
159
+ ## Configuration
160
+
161
+ Les deux options suivantes sont facultatives. Laisser les deux vides conserve le comportement par défaut : réponses textuelles uniquement avec l'invite intégrée.
162
+
163
+ Ouvrez **Plugins**, trouvez `@michengai/dsh-btw` et cliquez sur **Configuration**. L'emplacement correspond à celui de `dsh-subagent-default-model`.
164
+
165
+ | Paramètre | Description |
166
+ | --- | --- |
167
+ | **Outils autorisés** | Noms des outils autorisés en plus de `send_message`, un par ligne (ex. `pele_draw`). Laisser vide restreint aux réponses textuelles (valeur par défaut). |
168
+ | **Invite personnalisée** | Remplace l'invite intégrée. Pré-remplie avec le texte par défaut pour faciliter les ajustements ; enregistrer sans modification rétablit la valeur par défaut. |
169
+
170
+ Remarques :
171
+
172
+ - La liste blanche élargit uniquement ce que la question secondaire peut exécuter sans jamais restreindre la conversation principale ; renseigner un outil inexistant équivaut à ne rien autoriser.
173
+ - `send_message` ne peut pas être ajouté à la liste blanche. Le renvoi est uniquement autorisé vers la session parente de la question secondaire et ne peut pas être détourné vers un autre agent.
174
+ - L'invite personnalisée ne remplace que le préfixe d'instructions ; les explications sur les autorisations d'outils et le canal de retour sont toujours ajoutées à la fin pour éviter que le modèle ne s'attribue des droits inexistants.
175
+ - Les modifications s'appliquent dès la question secondaire suivante sans nécessiter de rechargement.
176
+ - La mention des outils autorisés dans les permissions modifie légèrement l'invite de la question. Intégrée dans le dernier message utilisateur, elle laisse les définitions d'outils et l'invite système identiques à l'octet près avec la session principale, préservant ainsi la réutilisation du prompt cache.
177
+
178
+ ### Exemple : dessiner des diagrammes
179
+
180
+ [`dsh-pele`](https://github.com/hesheng01/dsh-pele) fournit l'outil `pele_draw`, qui convertit du code Mermaid en cartes de diagrammes SVG dans la session. En renseignant `pele_draw` dans les **Outils autorisés**, la question secondaire peut également produire des diagrammes.
181
+
182
+ > Remarque : `dsh-pele` est un plugin récent non publié sur npm et non répertorié sur le store. Il s'installe en clonant le dépôt GitHub et en ajoutant le dossier `plugin` à votre profil :
183
+ >
184
+ > ```bash
185
+ > git clone https://github.com/hesheng01/dsh-pele.git
186
+ > dsh plugin --profile <profile> add <chemin_absolu>/dsh-pele/plugin
187
+ > ```
188
+ >
189
+ > Un redémarrage du Host est nécessaire lors du premier ajout.
190
+
191
+ ## Désinstallation
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
+ Prend effet après rechargement de DSH. La désactivation ou la mise à jour ne supprime aucun historique de conversation principale.
201
+
202
+ ## Développement 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
+ `npm run check` exécute la vérification de types, les tests et le build.
212
+
213
+ La version de référence pour le développement est `0.2.2-rc.1`. `npm run test:compat` compile avec cette référence et exécute la suite de tests sur chaque version isolée de l'hôte. Les tests de composants DOM ne remplacent pas la validation sur un navigateur réel.
214
+
215
+ GitHub et npm contiennent tous deux le dossier `lib` directement exécutable ; après modification du code source, exécutez `npm run build` avant de valider votre commit.
216
+
217
+ Pour installer depuis les sources, exécutez `dsh plugin --profile web add . --ignore-scripts` dans le répertoire du projet puis rechargez DSH.
218
+
219
+ ## Licence
220
+
221
+ [Apache-2.0](LICENSE) © 2026 MichengAI.