@michengai/dsh-btw 1.3.5 → 1.3.7
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 +12 -0
- package/CHANGELOG.zh-CN.md +12 -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 +694 -171
- package/lib/index.js +703 -142
- package/lib/types/client/SelectionAsk.d.ts +1 -4
- package/lib/types/client/styles.d.ts +1 -1
- package/lib/types/client/trigger-source.d.ts +1 -8
- package/lib/types/client/user-quote-chip.d.ts +0 -7
- 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 +87 -0
- package/lib/types/locales.d.ts +11 -99
- package/lib/types/server/tool-guard.d.ts +0 -8
- 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/lib/types/client/QuoteDock.d.ts +0 -27
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
|
+
[](LICENSE)
|
|
16
|
+
[](https://github.com/deepseek-ai/deepseek-harness)
|
|
17
|
+
[](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
|
+

|
|
40
|
+
|
|
41
|
+
### Menu de commandes
|
|
42
|
+
|
|
43
|
+
Tapez `/` et choisissez `btw` dans le menu des commandes, ou tapez directement `/btw votre question`.
|
|
44
|
+
|
|
45
|
+

|
|
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
|
+

|
|
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
|
+

|
|
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
|
+

|
|
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.
|
package/README.ja.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
|
+
- **回答のみ・ツール実行なし**:ファイルの読み込み、Web 検索、コマンド実行、コード変更は一切行いません。
|
|
27
|
+
- **独立した回答バブル**:Markdown、数式、コピー、折りたたみ、展開、閉じる操作に対応。複数のサイド質問を同時に確認できます。
|
|
28
|
+
- **メインタスクを妨げない**:サイド質問は単独で回答され、デフォルトでメインセッションに結果が書き込まれることはありません。
|
|
29
|
+
- **必要なときだけ結果を送信**:メインの会話に結論を残したい場合は、質問内で「回答をメイン会話に送信して」と明示的に指示すると、`send_message` を使って自己完結した回答をメインセッションに返送します。指示がない限り返送しません。
|
|
30
|
+
- **いつでもキャンセル可能**:生成中の回答バブルを閉じるだけで、そのサイド質問を即座にキャンセルできます。
|
|
31
|
+
- **全言語対応とテーマ**:DSH のライト・ダークテーマに追従。ホスト 0.2.2-rc.1 以降では公式の全 8 門言語(日本語、英語、中国語、スペイン語、フランス語、ドイツ語、ロシア語、ポルトガル語)をネイティブサポートし、それ以前の 0.2.0〜0.2.1 ホストでは安全に中英 2 言語にフォールバックします。
|
|
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) 環境がある場合は、各プロジェクトの README に従って個別にインストールできます。以下に 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) | `/simplify` を使って Git 変更範囲内のコードをクリーンアップ |
|
|
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
|
+
- 言語サポート範囲:DeepSeek Harness `0.2.2-rc.1` 以降で全 8 門の組み込み言語がネイティブに選択可能。`0.2.0`〜`0.2.1` ホストでは追加登録された言語は不活性のままとなり、UI は安全に中英 2 言語にフォールバックします。
|
|
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
|
+
- 通常の段落、リスト、コードブロックに対応。1回の引用につき最大 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 今の設計案を1行で要約して
|
|
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
|
+
以下の 2 項目はいずれも任意です。両方とも空欄にしておくと、デフォルトの純粋なテキスト回答と組み込みプロンプトが使用されます。
|
|
162
|
+
|
|
163
|
+
**プラグイン** を開き、`@michengai/dsh-btw` の行にある **設定** をクリックします。設定ページの位置は `dsh-subagent-default-model` の設定ページと同じです。
|
|
164
|
+
|
|
165
|
+
| 設定項目 | 説明 |
|
|
166
|
+
| --- | --- |
|
|
167
|
+
| **許可ツール** | `send_message` 以外にサイド質問で呼び出しを許可するツール名(1行に1つ、例: `pele_draw`)。空欄の場合はテキストのみ許可(デフォルト)。 |
|
|
168
|
+
| **カスタムプロンプト** | 組み込みプロンプトを上書きします。組み込み文言があらかじめ入力されているため直接変更可能。元に戻して保存するとデフォルトに戻ります。 |
|
|
169
|
+
|
|
170
|
+
説明:
|
|
171
|
+
|
|
172
|
+
- ホワイトリストはサイド質問が呼び出せる範囲を広げるだけであり、メインの会話を制限することは一切ありません。存在しないツール名を記述しても何も許可されません。
|
|
173
|
+
- `send_message` をホワイトリストに記述することはできません。回答をメイン会話へ返送する宛先は、サイド質問自身の親セッションのみに限定されており、ホワイトリストによって「任意の agent に送信」へ変更することはできません。
|
|
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.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
|
|