@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 CHANGED
@@ -1,5 +1,17 @@
1
1
  # Changelog
2
2
 
3
+ ## [1.3.7] - 2026-11-09
4
+
5
+ - **Package size refinement and legacy asset pruning**: Eliminates redundant legacy components and unused multilingual dictionary keys across all supported languages, resulting in a cleaner and faster loading package.
6
+ - **Visual styling enhancement for quoted context tag**: Adapts the reference source badge in the side-question modal into an inline pill chip aligned with native theme primitives.
7
+ - **Settings list alignment polish**: Enhances layout and margin styling for plugin settings row summaries to ensure consistent visual harmony across hosts.
8
+
9
+ ## [1.3.6] - 2026-11-09
10
+
11
+ - **Full support for all 8 official DeepSeek Harness languages**: Natively provides faithful localized text for Chinese, English, Japanese, Spanish, French, German, Russian, and Portuguese (`zh`, `en`, `ja`, `es`, `fr`, `de`, `ru`, `pt`). From host `0.2.2-rc.1` onwards, the text-selection menu, side-ask bubbles, action buttons, and settings configuration card dynamically adapt to the selected language; earlier hosts safely fall back to Chinese and English.
12
+ - **Dedicated full-fidelity documentation for all 8 languages**: Ships comprehensive localized README documentation variants for all supported languages, covering quick-action tables, configuration rules, and development guidelines.
13
+ - **Plugin metadata enrichment and interface refinement**: Registers complete author information, keywords, and icon exports while pruning internal redundant properties to ensure responsive, lightweight interactions.
14
+
3
15
  ## [1.3.5] - 2026-11-06
4
16
 
5
17
  - Fix side questions failing to start when DSH is opened over a plain-HTTP LAN address: browsers do not expose `crypto.randomUUID` in a non-secure context, so asking a side question failed with an error. Request ids now come from a random source that works in every context, so LAN access behaves the same as local access (#25).
@@ -1,5 +1,17 @@
1
1
  # 更新日志
2
2
 
3
+ ## [1.3.7] - 2026-11-09
4
+
5
+ - **深度精简安装包体积并消除历史残留**:彻底清理历史迭代中遗留的孤岛组件与冗余多语言词条,使插件运行时与安装包制品更加轻量、纯粹与高效。
6
+ - **划选引用出处标签视觉优化**:划词弹窗中的「出处 · 引用原文」标签全面适配原生设计语言,以轻量圆角胶囊呈现,视觉层级更加精致协调。
7
+ - **设置面板摘要布局对齐**:补充插件设置行摘要的样式基准,确保在不同宿主主题下与设置列表其他插件条目自然对齐。
8
+
9
+ ## [1.3.6] - 2026-11-09
10
+
11
+ - **全量支持 DeepSeek Harness 官方 8 门内置语言**:深度适配官方多语言架构,完整支持中文、英语、日语、西班牙语、法语、德语、俄语与葡萄牙语(`zh`, `en`, `ja`, `es`, `fr`, `de`, `ru`, `pt`)。自宿主 `0.2.2-rc.1` 起,不论宿主切换为何种语言,划词旁问悬浮条、独立答案气泡、操作按钮与插件配置面板均自动以对应语言原生呈现;更早的宿主版本安全回退为中文与英文。
12
+ - **随附全套多语言专属用户指南**:为 8 门内置语言分别提供全保真、地道的多语言 README 用户文档,完整包含功能概览、操作速查表、放行工具与提示词设置规则以及本地开发说明。
13
+ - **完善插件元数据声明与界面清理**:补齐作者信息、技术分类与包图标声明;全面清理设置界面与内部冗余项,保持输入与旁问交互轻量敏捷。
14
+
3
15
  ## [1.3.5] - 2026-11-06
4
16
 
5
17
  - 修复在局域网明文 HTTP 地址访问 DSH 时旁问无法启动的问题:该环境下浏览器不提供生成请求标识所需的 `crypto.randomUUID`,点击旁问会直接报错;现改用任何上下文都可用的随机源生成请求标识,局域网访问与本地访问体验一致(#25)。
package/README.de.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
+ **Spontane Nebenfragen in der aktuellen DeepSeek Harness-Sitzung stellen: nur antworten, keine Tools ausführen**
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
+ [Benutzeroberfläche](#benutzeroberfläche) · [Installation](#installation) · [Nutzung](#nutzung) · [Änderungsprotokoll](CHANGELOG.md) · [Apache-2.0](LICENSE)
14
+
15
+ [![Lizenz: 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 ist ein von der Community gepflegtes DeepSeek Harness-Plugin und kein offizielles Produkt von DeepSeek AI. Geben Sie in der aktuellen Konversation `/btw Ihre Frage` ein, um eine kontextbezogene Antwort in einer separaten Sprechblase zu erhalten, ohne die Hauptaufgabe zu unterbrechen. Unterstützt DSH Web sowie Desktop-Apps, die DSH Web integrieren. Ab Version `1.0.0` werden nicht unterstützte Host-Versionen durch die Versionsschranke sicher abgefangen (installierte Konfigurationen und Konversationsdaten bleiben erhalten).
22
+
23
+ ## Funktionsübersicht
24
+
25
+ - **Kontextbezogene Nebenfragen**: Erklären Sie Konzepte, fassen Sie Ergebnisse zusammen oder klären Sie spontane Fragen zum aktuellen Chatverlauf.
26
+ - **Nur Antworten, keine Ausführung**: Liest keine neuen Dateien, ruft kein Internet auf, führt keine Befehle aus und ändert keinen Code.
27
+ - **Unabhängige Antwortblasen**: Unterstützt Markdown, mathematische Formeln, Kopieren, Einklappen, Ausklappen und Schließen. Mehrere Antworten können gleichzeitig betrachtet werden.
28
+ - **Hauptaufgabe ungestört weiterführen**: Nebenfragen werden separat beantwortet und standardmäßig nicht in den Hauptchat geschrieben.
29
+ - **Rückmeldung nur auf Wunsch**: Bitten Sie in Ihrer Frage explizit darum („Sende die Antwort an die Hauptkonversation zurück“), damit per `send_message` eine vollständige Antwort übertragen wird. Ohne Aufforderung erfolgt keine Rückübertragung.
30
+ - **Jederzeit abbrechen**: Das Schließen einer antwortenden Blase bricht diese Nebenfrage sofort ab.
31
+ - **Umfassende Lokalisierung & Themes**: Folgt dem hellen und dunklen DSH-Design. Ab Host `0.2.2-rc.1` werden alle 8 offiziellen Sprachen (Deutsch, Englisch, Chinesisch, Japanisch, Spanisch, Französisch, Russisch, Portugiesisch) nativ unterstützt; frühere Hosts `0.2.0`〜`0.2.1` fallen sicher auf Chinesisch und Englisch zurück.
32
+
33
+ ## Benutzeroberfläche
34
+
35
+ ### Nebenfragen im Standard-DSH
36
+
37
+ Die Hauptkonversation bleibt an ihrem Platz, während die Nebenfrage-Antwort direkt über dem Eingabefeld erscheint.
38
+
39
+ ![BTW Antwortblase in der Konversation](https://raw.githubusercontent.com/MichengAI/dsh-btw/2d8dd7752cec1b29dd705969eaa932635ba0bf4f/assets/screenshots/btw-conversation.png)
40
+
41
+ ### Befehlsmenü
42
+
43
+ Geben Sie `/` ein und wählen Sie `btw` unter Befehle oder tippen Sie direkt `/btw Ihre Frage`.
44
+
45
+ ![Der Befehl btw im offiziellen Menü](https://raw.githubusercontent.com/MichengAI/dsh-btw/2d8dd7752cec1b29dd705969eaa932635ba0bf4f/assets/screenshots/btw-command-menu.png)
46
+
47
+ ### Unabhängige Antwortblasen
48
+
49
+ Jede Nebenfrage besitzt eine eigene Blase mit Schaltflächen zum Kopieren, Einklappen/Ausklappen und Schließen in der oberen rechten Ecke.
50
+
51
+ ![Mehrere Antwortblasen mit Bedienelementen](https://raw.githubusercontent.com/MichengAI/dsh-btw/2d8dd7752cec1b29dd705969eaa932635ba0bf4f/assets/screenshots/btw-bubbles.png)
52
+
53
+ ### Einstellungen für Nebenfragen
54
+
55
+ Öffnen Sie **Plugins**, wählen Sie `@michengai/dsh-btw` aus und passen Sie Tool-Whitelist sowie Prompts direkt auf der Detailseite an.
56
+
57
+ ![Einstellungsformular für Nebenfragen](assets/screenshots/btw-settings-panel.png)
58
+
59
+ ### Diagramme in Nebenfragen zeichnen
60
+
61
+ Mit `pele_draw` auf der Whitelist kann eine Nebenfrage Diagramme generieren, ohne den Hauptchat zu verändern.
62
+
63
+ ![Diagrammerstellung mit pele_draw](assets/screenshots/btw-pele-draw.png)
64
+
65
+ ## DSH Produkt-Ökosystem
66
+
67
+ Für eine vollwertige Desktop-Workbench laden Sie [DSH Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop/releases) herunter. In bestehenden [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)-Umgebungen können Plugins nach Bedarf installiert werden. Im Folgenden sind 11 eigens entwickelte Plugins aufgeführt; der tatsächliche Lieferumfang der Desktop-Version richtet sich nach den entsprechenden Versionshinweisen und dem integrierten Katalog.
68
+
69
+ | Plugin | Zweck |
70
+ | --- | --- |
71
+ | [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | Projekte & Sitzungen organisieren, Aufgabensuche und Runden-Navigation |
72
+ | [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | Fachagenten je nach Aufgabe auswählen und aufrufen |
73
+ | [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) | Lokale Skills finden, aktivieren, erstellen und importieren |
74
+ | [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | Archivierte Sitzungen durchsuchen, wiederherstellen oder bereinigen |
75
+ | [IM Connect](https://github.com/MichengAI/dsh-im-connect) | Aufgaben über Messenger-Plattformen zuweisen und Antworten erhalten |
76
+ | [Automation](https://github.com/MichengAI/dsh-automation) | Geplante Aufgaben ausführen und Ausführungsverläufe einsehen |
77
+ | [BTW](https://github.com/MichengAI/dsh-btw) | Spontane Nebenfragen im Kontext stellen, ohne die Hauptaufgabe zu stören |
78
+ | [Simplify](https://github.com/MichengAI/dsh-simplify) | Git-Änderungsbereiche mit `/simplify` aufräumen und optimieren |
79
+ | [PUA](https://github.com/MichengAI/dsh-pua) | Agenten bei Fehlern anleiten, Ansätze zu korrigieren und Ergebnisse zu prüfen |
80
+ | [Code Review](https://github.com/MichengAI/dsh-code-review) | Unabhängige Code-Reviews mit `/review` starten und Berichte im Chat erhalten |
81
+ | [Codex Pet](https://github.com/MichengAI/dsh-codex-pet) | Sitzungsbenachrichtigungen, Tool-Genehmigungen und Antworten via Desktop-Pet |
82
+
83
+ ## Voraussetzungen
84
+
85
+ - DeepSeek Harness installiert.
86
+ - Host-Kompatibilitätsbereich: DeepSeek Harness `0.2.x`-Gesamtreihe (`>=0.2.0-rc.1 <0.3.0-0`), verifiziert mit `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`. Upgrades innerhalb derselben Generation erfordern keine neuen Plugin-Releases.
87
+ - Sprachunterstützung: Ab DeepSeek Harness `0.2.2-rc.1` sind alle 8 integrierten Sprachen nativ auswählbar. Auf `0.2.0`〜`0.2.1`-Hosts bleiben zusätzlich registrierte Sprachwörterbücher inaktiv und die Oberfläche fällt sicher auf Chinesisch und Englisch zurück.
88
+ - Ältere Hosts vor `0.2.0-rc.1` werden nicht mehr unterstützt. Destruktive Änderungen der `0.3.0`-Generation werden durch die Versionsschranke abgefangen. Benutzer von `0.1.x` sollten Version `0.1.24` installieren.
89
+ - Node.js 22+, Befehl `dsh` im Terminal verfügbar.
90
+
91
+ ## Installation
92
+
93
+ Die folgenden Befehle verwenden das Profil `web`. Bitte an die tatsächliche Umgebung anpassen. Deaktivieren Sie vor der Installation andere Plugins, die den Befehl `/btw` bereitstellen.
94
+
95
+ ### Installation durch Agenten (Empfohlen)
96
+
97
+ Senden Sie die folgende Anweisung an einen beliebigen Agenten mit Terminalzugriff:
98
+
99
+ ```text
100
+ Bitte installieren Sie das DSH-Plugin @michengai/dsh-btw im lokalen Web-Profil mit: dsh plugin --profile web add @michengai/dsh-btw@latest --registry=https://registry.npmjs.org/. Führen Sie danach dsh --profile web --dump-config aus, um sicherzustellen, dass michengai-btw enthalten ist, und erklären Sie mir, wie ich DSH neu lade und verwende.
101
+ ```
102
+
103
+ ### Manuelle Installation 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
+ ### Neu laden
113
+
114
+ Installieren oder aktualisieren Sie nach Abschluss laufender Aufgaben; Desktop-Anwendungen starten unter Umständen automatisch neu. Falls die Änderungen nicht wirksam werden, nutzen Sie die Neulade-Funktion der Desktop-App oder starten Sie den `dsh web`-Dienst neu. Das reine Neuladen im Browser genügt nicht.
115
+
116
+ Auf Hosts vor `0.2.0` sowie `0.2.1` alpha wird die Installation von `@latest` durch die Versionsschranke abgelehnt und das Plugin nicht ausgeführt. Für `0.1.x` installieren Sie bitte `0.1.24`. Bestehende Konfigurationen und Konversationsaufzeichnungen bleiben erhalten.
117
+
118
+ ## Nutzung
119
+
120
+ ### Ausgewählten Text befragen
121
+
122
+ Markieren Sie Text innerhalb einer Nachricht und wählen Sie in der Leiste darüber „Zu diesem Text fragen“. Geben Sie Ihre Frage ein und drücken Sie die Eingabetaste oder klicken Sie auf „Dies erklären“. Shift+Eingabe für einen Zeilenumbruch, Esc zum Abbrechen. Die Antwort erscheint in einer separaten BTW-Sprechblase; das Originalzitat kann ausgeklappt werden.
123
+
124
+ - Unterstützt Standardabsätze, Listen und Codeblöcke; bis zu 8.000 UTF-16-Codeeinheiten pro Zitat (inklusive Leerzeichen). Bei Überschreitung erfolgt ein Hinweis ohne Abschneiden des Textes.
125
+ - Das Zitat wird beim Markieren fixiert und ändert sich auch bei weiterer Textgenerierung nicht. Der restliche Kontext verwendet den beim Senden fertiggestellten Stand des Hauptchats.
126
+ - Verbraucht oder leert den Entwurf im Haupteingabefeld nicht; nachrichtenübergreifende Markierungen, Eingabefelder und Tool-Ausgaben bieten dieses Menü nicht an.
127
+ - Die Leiste bietet zudem „Zur Konversation hinzufügen“, womit das Zitat an den bestehenden Entwurf angehängt und das Eingabefeld fokussiert wird, ohne automatisch zu senden. Während des Sendens wird das Hinzufügen pausiert. Ein Rechtsklick behält das Browser-Standardmenü bei.
128
+ - Unterstützt Tastaturmarkierungen innerhalb von Textelementen; nach dem Loslassen von Shift wird die Leiste fokussiert. Browser ohne Popover-API-Unterstützung fallen auf ein fixiertes Overlay (fixed) zurück.
129
+ - Bereichstrennung zu `dsh-better-sidebar`: BTW verarbeitet ausschließlich den Chat-Körper; Dateivorschau und Editor behalten die ursprüngliche Option der Seitenleiste bei, wodurch doppelte Leisten vermieden werden.
130
+ - Neue Einstiegspunkte stützen sich auf Host-DOM-Markierungen. Bei nicht erkannten Layouts bleibt das reguläre Rechtsklick-Verhalten bestehen und `/btw` kann weiterhin genutzt werden.
131
+
132
+ ### Befehlsbasierte Nebenfrage
133
+
134
+ In einer Sitzung mit bestehendem Kontext:
135
+
136
+ ```text
137
+ /btw Fasse den vorherigen Lösungsansatz in einem einzigen Satz zusammen
138
+ ```
139
+
140
+ | Ziel | Aktion |
141
+ | --- | --- |
142
+ | Nebenfrage stellen | `/btw Ihre Frage` eingeben und senden oder `btw` aus dem Menü `/` wählen |
143
+ | Antwort ansehen | Warten, bis die unabhängige Blase über dem Eingabefeld antwortet |
144
+ | Antwort kopieren | Kopiersymbol in der oberen rechten Ecke der Blase anklicken |
145
+ | Ein- oder ausklappen | Falt-Symbol in der oberen rechten Ecke anklicken |
146
+ | Nebenfrage abbrechen | Blase während der Generierung schließen (Hauptaufgabe läuft weiter) |
147
+ | Blase entfernen | Abgeschlossene Blasen schließen |
148
+ | Weiter fragen | Erneut `/btw Ihre Frage` eingeben; jede Nebenfrage ist vollkommen unabhängig |
149
+
150
+ Falls Befehle ausgeführt, Code geändert oder die Hauptaufgabe fortgesetzt werden soll, senden Sie dies über die reguläre Konversation. BTW antwortet ausschließlich auf Basis des bestehenden Kontexts.
151
+
152
+ BTW akzeptiert ausschließlich Text. Sind im Eingabefeld Bilder oder Dateien angehängt, wird die Nebenfrage abgewiesen und Text sowie Anhänge bleiben erhalten; entfernen Sie die Anhänge und versuchen Sie es erneut.
153
+
154
+ ### Anwendungshinweise
155
+
156
+ - Jede Nebenfrage ist unabhängig und bezieht sich auf die beim Absenden abgeschlossenen Inhalte der Hauptsitzung; sie enthält keine gerade generierten Antworten oder vorherige Nebenfragen.
157
+ - Beim Aktualisieren der Seite bleiben die Sprechblasen nicht erhalten; kopieren Sie benötigte Antworten rechtzeitig.
158
+
159
+ ## Konfiguration
160
+
161
+ Die folgenden zwei Optionen sind optional. Bleiben beide leer, gilt das Standardverhalten: reine Textantworten unter Verwendung des integrierten Prompts.
162
+
163
+ Öffnen Sie **Plugins**, suchen Sie `@michengai/dsh-btw` und klicken Sie auf **Konfiguration**. Die Seite befindet sich an derselben Stelle wie bei `dsh-subagent-default-model`.
164
+
165
+ | Option | Funktion |
166
+ | --- | --- |
167
+ | **Erlaubte Tools** | Namen von Tools, die die Nebenfrage neben `send_message` aufrufen darf, eines pro Zeile (z. B. `pele_draw`). Leer erlaubt nur Text (Standardwert). |
168
+ | **Benutzerdefinierter Prompt** | Ersetzt den integrierten Prompt. Das Feld ist mit dem Standardtext vorbefüllt, sodass Sie ihn direkt anpassen können; unverändertes Speichern stellt den Standard wieder her. |
169
+
170
+ Hinweise:
171
+
172
+ - Die Whitelist erweitert ausschließlich die Aufrufmöglichkeiten der Nebenfrage und schränkt die Hauptkonversation niemals ein; die Angabe nicht existierender Tools bewirkt nichts.
173
+ - `send_message` kann nicht in die Whitelist eingetragen werden. Das Zurücksenden an die Hauptkonversation ist stets nur an die übergeordnete Sitzung der Nebenfrage erlaubt und kann nicht auf beliebige Agenten umgeleitet werden.
174
+ - Der benutzerdefinierte Prompt ersetzt nur das Instruktionspräfix; Berechtigungshinweise und Rückkanalbeschreibungen werden stets am Ende angehängt, um Missverständnisse des Modells zu vermeiden.
175
+ - Änderungen greifen ab der nächsten Nebenfrage sofort, ohne dass das Plugin neu geladen werden muss.
176
+ - Da erlaubte Tools namentlich aufgeführt werden, verändert eine erweiterte Whitelist den Prompt der Nebenfrage. Da dies zur abschließenden Benutzernachricht gehört, bleiben Tool-Definitionen und System-Prompts bytegenau mit der Hauptsitzung identisch, sodass die Wiederverwendung des Prompt-Caches unberührt bleibt.
177
+
178
+ ### Beispiel: Zeichnen in Nebenfragen
179
+
180
+ [`dsh-pele`](https://github.com/hesheng01/dsh-pele) stellt das Tool `pele_draw` bereit, um Mermaid-Quellcode als SVG-Diagrammkarten in der Sitzung zu rendern. Trägt man `pele_draw` in **Erlaubte Tools** ein, kann die Nebenfrage ebenfalls Diagramme erstellen.
181
+
182
+ > Hinweis: `dsh-pele` ist ein neues Plugin, das noch nicht auf npm veröffentlicht und nicht im Plugin-Marktplatz gelistet ist. Zur Installation klonen Sie das GitHub-Repository und fügen das Verzeichnis `plugin` Ihrem Profil hinzu:
183
+ >
184
+ > ```bash
185
+ > git clone https://github.com/hesheng01/dsh-pele.git
186
+ > dsh plugin --profile <profile> add <absoluter_pfad>/dsh-pele/plugin
187
+ > ```
188
+ >
189
+ > Beim ersten Einbinden ist ein Neustart des Hosts erforderlich.
190
+
191
+ ## Deinstallation
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
+ Wird nach dem Neuladen von DSH wirksam. Das Deaktivieren oder Aktualisieren löscht keine Daten der Hauptkonversation.
201
+
202
+ ## Lokale Entwicklung
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` führt Typprüfung, Tests und den Build aus.
212
+
213
+ Die Entwicklungs- und Build-Basislinie ist `0.2.2-rc.1`. `npm run test:compat` kompiliert mit dieser Basislinie und führt die Testsuite auf den isolierten Host-Versionen aus. DOM-Komponententests ersetzen keine manuelle Browserabnahme.
214
+
215
+ Sowohl GitHub als auch npm enthalten das ausführbare Verzeichnis `lib`; führen Sie nach Änderungen am Quellcode vor dem Commit `npm run build` aus.
216
+
217
+ Für die Installation aus dem Quellcode führen Sie im Projektverzeichnis `dsh plugin --profile web add . --ignore-scripts` aus und laden Sie DSH neu.
218
+
219
+ ## Lizenz
220
+
221
+ [Apache-2.0](LICENSE) © 2026 MichengAI.
package/README.en.md CHANGED
@@ -8,7 +8,9 @@
8
8
 
9
9
  **Ask a side question in DeepSeek Harness. Answers only, no tool execution.**
10
10
 
11
- [简体中文](README.md) · [Screenshots](#screenshots) · [Installation](#installation) · [Usage](#usage) · [Changelog](CHANGELOG.md) · [Apache-2.0](LICENSE)
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
+ [Screenshots](#screenshots) · [Installation](#installation) · [Usage](#usage) · [Changelog](CHANGELOG.md) · [Apache-2.0](LICENSE)
12
14
 
13
15
  [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
14
16
  [![DSH Web Plugin](https://img.shields.io/badge/DSH%20Web-Plugin-0f766e.svg)](https://github.com/deepseek-ai/deepseek-harness)
@@ -26,7 +28,7 @@
26
28
  - **Keep the main task going**: side questions are answered separately and by default do not add answers to the main conversation.
27
29
  - **Return on request**: when you want the conclusion available to the main conversation, ask for it in the question ("send the answer back to the main conversation") and the side ask uses `send_message` to deliver a self-contained answer to the main session. It does not send anything when you did not ask.
28
30
  - **Cancel anytime**: close a bubble while it is answering to cancel that question.
29
- - **Themes and languages**: follow DSH light and dark themes and switch between Chinese and English UI.
31
+ - **Full i18n & Themes**: follow DSH light and dark themes with complete native support for all 8 official DeepSeek Harness languages (English, Chinese, Japanese, Spanish, French, German, Russian, Portuguese) from host 0.2.2-rc.1 onwards; earlier 0.2.0–0.2.1 hosts safely fall back to Chinese and English.
30
32
 
31
33
  ## Screenshots
32
34
 
@@ -82,6 +84,7 @@ For a desktop workbench, download [DSH Codex Desktop](https://github.com/Micheng
82
84
 
83
85
  - An installed copy of DeepSeek Harness.
84
86
  - Host compatibility: Full DeepSeek Harness `0.2.x` line (`>=0.2.0-rc.1 <0.3.0-0`), verified with `0.2.0-rc.1`, `0.2.0-rc.2`, `0.2.1-rc.1`–`0.2.1-rc.5`, and `0.2.2-rc.1`, and forwards-compatible with subsequent `0.2.x` RC releases without requiring routine plugin version bumps.
87
+ - Language support: all 8 built-in languages are natively selectable from DeepSeek Harness `0.2.2-rc.1` onwards; on `0.2.0`–`0.2.1` hosts, extra registered locale dictionaries stay dormant and the UI safely falls back to English and Chinese.
85
88
  - Legacy hosts prior to `0.2.0-rc.1` are no longer supported. The version gate cleanly intercepts breaking changes in the `0.3.0` generation. Users on `0.1.x` hosts should install `0.1.24`.
86
89
  - Node.js 22+ and `dsh` available in your terminal.
87
90
 
@@ -208,7 +211,7 @@ npm run check
208
211
 
209
212
  `npm run check` runs type checking, tests, and a build.
210
213
 
211
- Development and builds target `0.2.1-rc.2`. `npm run test:compat` builds with that baseline and runs the test suite on each of the four isolated host versions, using a test model adapter. DOM component tests do not replace live-browser acceptance.
214
+ Development and builds target `0.2.2-rc.1`. `npm run test:compat` builds with that baseline and runs the test suite on each isolated host version, using a test model adapter. DOM component tests do not replace live-browser acceptance.
212
215
 
213
216
  GitHub and npm both include a ready-to-run `lib`; after changing source, run `npm run build` before committing.
214
217
 
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.