@michengai/dsh-im-connect 1.0.31 → 1.0.33

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,20 @@
1
1
  # Changelog
2
2
 
3
+ ## [1.0.33] - 2026-11-09
4
+
5
+ ### Clean header navigation & documentation streamlining
6
+
7
+ - Two-tier navigation layout: split the README header links into two clean rows — the top row focuses on 8-language switching, while the second row clearly presents the Changelog and License.
8
+ - Prune internal handover links: remove internal development handover links from public documentation for a cleaner and more professional presentation.
9
+
10
+ ## [1.0.32] - 2026-11-09
11
+
12
+ ### Full multi-language README documentation & language navigation
13
+
14
+ - Dedicated documentation across 8 languages: provide comprehensive native README files for Japanese (`README.ja.md`), Spanish (`README.es.md`), French (`README.fr.md`), German (`README.de.md`), Russian (`README.ru.md`), and Portuguese (`README.pt.md`).
15
+ - Accurate localized detail display: plugin marketplace and details view now match the host's active locale with its dedicated native manual.
16
+ - Header language switcher: add an 8-language switcher navigation bar at the top of all README files for quick access.
17
+
3
18
  ## [1.0.31] - 2026-11-09
4
19
 
5
20
  ### Full 8-language i18n & streamlined plugin management
@@ -1,5 +1,20 @@
1
1
  # 更新日志
2
2
 
3
+ ## [1.0.33] - 2026-11-09
4
+
5
+ ### 文档导航布局优化与内部入口精简
6
+
7
+ - 导航栏分排排布:将 README 顶部的多语言切换链接与文档入口拆分为两排,第一排专注 8 门语言快速切换,第二排独立展示更新日志与开源协议。
8
+ - 精简内部迭代链接:移除仅供开发阶段使用的历史迭代交接入口,保持对外文档的纯净与专业。
9
+
10
+ ## [1.0.32] - 2026-11-09
11
+
12
+ ### 全语言 README 使用手册与导航互链
13
+
14
+ - 全套官方语言使用说明:新增日语(`README.ja.md`)、西班牙语(`README.es.md`)、法语(`README.fr.md`)、德语(`README.de.md`)、俄语(`README.ru.md`)与葡萄牙语(`README.pt.md`)完整独立使用手册。
15
+ - 详情与市场文档精准展示:插件市场与详情页与当前宿主语言 100% 对应展示对应语种的 README 手册,告别非中英语种下的文档回退。
16
+ - 头部快速语言导航:在全部 8 门语言 README 顶部提供一键切换语言导航栏,方便全球开发者无缝查阅。
17
+
3
18
  ## [1.0.31] - 2026-11-09
4
19
 
5
20
  ### 全语言国际化支持与插件中心体验对齐
package/README.de.md ADDED
@@ -0,0 +1,173 @@
1
+ <p align="center">
2
+ <img src="assets/branding/dsh-banner.png" alt="DSH IM Connect" width="100%">
3
+ </p>
4
+
5
+ <div align="center">
6
+
7
+ # DSH IM Connect
8
+
9
+ **Verbinden Sie Feishu, Lark, DingTalk, WeCom, WeChat, QQ, Telegram, Discord und Slack mit Ihrem lokalen DeepSeek Harness-Agenten**
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
+ [Änderungsprotokoll](CHANGELOG.md) · [Lizenz](LICENSE)
14
+
15
+ [![Lizenz: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
16
+ [![npm-Paket](https://img.shields.io/npm/v/%40michengai%2Fdsh-im-connect.svg?label=npm%20package)](https://www.npmjs.com/package/@michengai/dsh-im-connect)
17
+ [![npm-Downloads](https://img.shields.io/npm/dt/%40michengai%2Fdsh-im-connect.svg?label=npm%20downloads)](https://www.npmjs.com/package/@michengai/dsh-im-connect)
18
+ [![DSH Web Plugin](https://img.shields.io/badge/DSH%20Web-Plugin-0f766e.svg)](https://github.com/MichengAI/dsh-im-connect)
19
+ [![Node.js 22 oder neuer](https://img.shields.io/badge/Node.js-22%20or%20later-339933.svg?logo=node.js&logoColor=white)](https://nodejs.org/)
20
+ [![Kanäle](https://img.shields.io/badge/channels-9-238636.svg)](#-unterstützte-kanäle)
21
+ </div>
22
+
23
+ > DSH IM Connect ist ein von der Community gepflegtes Plugin für DeepSeek Harness (DSH) und kein offizielles Produkt von DeepSeek AI.
24
+
25
+ ## Funktionsübersicht
26
+
27
+ Auch wenn Sie nicht am Computer sitzen, können Sie über Ihren gewohnten Messenger Aufgaben an Ihr lokales DSH übergeben, Antworten erhalten, Rückfragen beantworten und Werkzeug-Genehmigungen direkt im Chat durchführen.
28
+
29
+ - **Unterstützung führender Messenger**: DingTalk, Feishu, Lark, WeChat, WeCom, QQ, Telegram, Discord und Slack.
30
+ - **Individuelle Kontenverwaltung**: Fügen Sie mehrere Konten pro Dienst hinzu und konfigurieren Sie Arbeitsbereich, Modell, Denkaufwand, Berechtigungen und Versandmodi individuell.
31
+ - **Mobile Aufgabensteuerung**: Aufgaben senden, Antworten lesen und Auswahlen treffen. Autorisierte Benutzer können Tool-Aufrufe direkt in privaten Chats genehmigen oder ablehnen.
32
+ - **Isolierte Sitzungen**: Jeder Messenger-Chat ist einer eigenen Sitzung zugeordnet und im Web-Arbeitsbereich unter „Kanäle“ einsehbar.
33
+ - **Einfache Verbindung via QR-Code oder Anmeldedaten**: Schnell eingerichtet unter „Einstellungen → IM-Assistent“ mit vollständiger Kontrolle über den Nachrichtenempfang.
34
+ - **Präzise Zugriffskontrolle**: Gruppenchats reagieren auf @Erwähnungen; Direktnachrichten folgen den hinterlegten Richtlinien.
35
+
36
+ ## Wer kann den Assistenten steuern?
37
+
38
+ Eingehende Nachrichten werden anhand des Absenders geprüft, bevor Befehle oder Werkzeug-Genehmigungen ausgeführt werden.
39
+
40
+ | Anwendungsfall | Verhalten |
41
+ |---|---|
42
+ | Gruppe ohne @Erwähnung des Bots | Wird ignoriert; keine Antwort oder Genehmigungsanfrage. Erwähnungen anderer Mitglieder lösen nichts aus |
43
+ | Gruppe mit expliziter @Erwähnung | Keine Kopplung erforderlich: Jedes Gruppenmitglied kann Aufgaben anstoßen |
44
+ | Direktnachricht vom QR-Scanner | Nutzer von WeChat, Feishu, Lark und QQ, die den QR-Code gescannt haben, landen automatisch auf der Whitelist |
45
+ | Direktnachricht von anderen Nutzern | Landet in der Warteliste der Einstellungen, bis ein Administrator die Freigabe erteilt |
46
+ | Direktnachricht nach QR-Kopplung ohne Identität | QR-Kopplungen bei DingTalk und WeCom liefern nur Bot-Zugangsdaten; der Nutzer muss freigegeben werden |
47
+ | Direktnachricht mit manuellen Anmeldedaten | Telegram, Discord, Slack sowie manuell konfigurierte Konten erfordern für jeden privaten Chat eine Freigabe |
48
+ | Direktnachricht ohne userId | Wird abgewiesen |
49
+ | Werkzeug-Genehmigung | Antworten Sie mit `Genehmigen` oder `Ablehnen` (`Approve` / `Deny`) im verknüpften Chat. Erfolgt innerhalb von 5 Minuten keine Antwort, wird die Aktion sicher abgebrochen |
50
+ | Interaktive Auswahl | Antworten Sie mit der Ziffer oder dem Text der gewünschten Option. Bei Gruppenchats darf nur der Aufgabeninitiator antworten |
51
+
52
+ ## 📡 Unterstützte Kanäle
53
+
54
+ <p align="center">
55
+ <code>🔔 DingTalk</code>&nbsp;
56
+ <code>🐦 Feishu</code>&nbsp;
57
+ <code>🌐 Lark</code>&nbsp;
58
+ <code>💬 WeChat</code>&nbsp;
59
+ <code>🏢 WeCom</code>&nbsp;
60
+ <code>🐧 QQ</code>&nbsp;
61
+ <code>✈️ Telegram</code>&nbsp;
62
+ <code>🎮 Discord</code>&nbsp;
63
+ <code>💬 Slack</code>
64
+ </p>
65
+
66
+ | Kanal | Kopplungsmethode | Empfang | Versand |
67
+ |---|---|---|---|
68
+ | **🔔 DingTalk** | QR-Code / Manuell | Webhook | Webhook / Interaktive Karten |
69
+ | **🐦 Feishu** | QR-Code / Manuell | Long Polling / Events | Open API / Interaktive Nachrichten |
70
+ | **🌐 Lark** | QR-Code / Manuell | Long Polling / Events | Open API / Interaktive Nachrichten |
71
+ | **💬 WeChat** | QR-Code | Offizielles Synchron-Polling | Natives Synchronisationsprotokoll |
72
+ | **🏢 WeCom** | QR-Code / Manuell | Interne Rückrufe | Webhook / Formatierte Karten |
73
+ | **🐧 QQ** | QR-Code / Manuell | Offizielles WebSocket / Webhook | OpenAPI / Rich Markdown |
74
+ | **✈️ Telegram** | Bot-Token | Long Polling (getUpdates) | Telegram Bot API / Einklappbare Zitate |
75
+ | **🎮 Discord** | Bot-Token | Gateway-WebSocket | REST-API |
76
+ | **💬 Slack** | Bot-Token & App-Token | Socket Mode WebSocket | Web-API / Block Kit |
77
+
78
+ ## Bild- und Dateiverarbeitung
79
+
80
+ Senden Sie Screenshots, Diagramme oder Dokumente direkt in den Chat. Das Vision-Modell von DSH verarbeitet sie unmittelbar zusammen mit Ihren Arbeitsanweisungen. Generierte Ergebnisse (ZIP-Archive, Berichte, Bilder) werden als herunterladbare Dateien zurückgesendet.
81
+
82
+ ## Schnelles Aktionsmenü
83
+
84
+ Geben Sie `/menu` im Chat ein, um interaktive Schaltflächen aufzurufen, mit denen Sie Sitzungen wechseln oder Modelle mit einem Fingertipp anpassen können.
85
+
86
+ ## Plugin-Konfiguration
87
+
88
+ Erreichbar über die Verwaltung unter **Plugins → @michengai/dsh-im-connect**:
89
+
90
+ ### 1. Position der Verknüpfung (`location`)
91
+ - **Standard**: Nur Einstellungen (`settings`)
92
+ - **Optionen**: `both` (Seitenleiste & Einstellungen), `sidebar` (nur Seitenleiste) oder `settings` (nur globales Einstellungsmenü).
93
+
94
+ ### 2. IM-Sitzungen im Aufgabenbaum anzeigen (`taskTreeSessions`)
95
+ - **Standard**: Deaktiviert (`false`)
96
+ - **Funktion**: Filtert Messenger-Chats aus der Hauptbaumansicht heraus, um die Übersichtlichkeit im täglichen Entwicklungsalltag zu wahren.
97
+
98
+ ### 3. Update-Sperre über Cordis-Konfiguration (`updater` / `onlineUpdate`)
99
+ - **Standard**: Nicht gesperrt (`undefined`)
100
+ - **Funktion**: Für isolierte Unternehmensnetzwerke kann der interne Update-Endpunkt über `cordis.patch.yml` dauerhaft deaktiviert werden:
101
+ ```yaml
102
+ - id: im-connect
103
+ config:
104
+ updater: false # oder onlineUpdate: false
105
+ ```
106
+ Nach der Sperrung liefert der Endpunkt HTTP 403 und überlässt die Versionsverwaltung vollständig dem offiziellen DSH-Paketmanager.
107
+
108
+ ### 4. Auslöserichtlinie für Telegram-Gruppen (`mentionPolicy` / `freeChatGroups`)
109
+ - **Standard**: `addressed` (reagiert nur auf @Erwähnungen oder direkte Antworten).
110
+ - **Funktion**: Erlaubt die Festlegung von Whitelist-Gruppen für die direkte Kommunikation ohne @Erwähnung.
111
+
112
+ ### 5. Einklappbare Denkprozess-Anzeige (`thinkingDisplay`)
113
+ - **Standard**: Aus (`off`)
114
+ - **Funktion**: Übermittelt den Denkprozess des Modells auf Telegram als einklappbaren Zitatblock (`<blockquote expandable>`).
115
+
116
+ ## Nutzung und Befehle
117
+
118
+ Öffnen Sie **Einstellungen → IM-Assistent**, wählen Sie **Konto hinzufügen** und konfigurieren Sie Arbeitsbereich, Modell, Berechtigungen und Versandmodus.
119
+
120
+ | Ziel | Aktion | Hinweise |
121
+ | --- | --- | --- |
122
+ | Konto hinzufügen | Auf **Konto hinzufügen** unter dem gewünschten Kanal klicken | Mehrere Konten pro Kanal möglich |
123
+ | Einstellungen bearbeiten | Auf „Einstellungen“ in der Kontozeile klicken | Sofort wirksam |
124
+ | Empfang anhalten | Schalter **Nachrichten empfangen** deaktivieren | Zugangsdaten bleiben erhalten |
125
+ | Neue Sitzung | `/new` oder `/clear` senden | Startet eine frische Sitzung |
126
+ | Status / Hilfe | `/status` oder `/help` senden | Zeigt aktive Sitzung und Befehle |
127
+ | Agenten-Voreinstellungen | `/presets`, `/preset <Nummer/ID>` | Wechselt das Agentenprofil |
128
+ | Modell & Denkaufwand | `/models`, `/model <Name>`, `/reasoning [Stufe]` | Passt das Modell zur Laufzeit an |
129
+ | Sitzungsverwaltung | `/sessions`, `/session <Nummer/ID>`, `/rename <Titel>`, `/fork` | Sitzungen auflisten, wechseln, umbenennen oder forken |
130
+ | Zustellwiederherstellung | `/delivery`, `/delivery retry <ID>` | Sendet unterbrochene Nachrichten erneut |
131
+
132
+ ### Automatische Telegram-Themenbenennung
133
+
134
+ Foren-Themen in Telegram werden automatisch anhand des ersten Antworttitels benannt. Eine manuelle Synchronisation ist jederzeit über `/rename <Titel>` möglich.
135
+
136
+ ### Segmentierte Antworten
137
+
138
+ Ermöglicht das Aufteilen langer Antworten in mehrere aufeinanderfolgende kurze Nachrichten für bessere Lesbarkeit auf Smartphones (derzeit auf QQ aktiv).
139
+
140
+ ### Automatische Sitzungsrotation
141
+
142
+ Wenn seit der letzten Nachricht eine konfigurierte Zeitspanne vergangen ist (z. B. 1 Stunde, 6 Stunden), startet die nächste Nachricht automatisch eine neue Sitzung.
143
+
144
+ ### Slack-Anbindung
145
+
146
+ 1. Erstellen Sie eine App unter Slack API (`api.slack.com/apps`).
147
+ 2. Unter **OAuth & Permissions → Bot Token Scopes** Berechtigungen für Nachrichten, Dateien, Reaktionen und Erwähnungen erteilen.
148
+ 3. Installieren Sie die App und kopieren Sie das Bot-Token (`xoxb-`).
149
+ 4. Aktivieren Sie den **Socket Mode** und generieren Sie ein App-Level-Token (`xapp-`).
150
+ 5. Hinterlegen Sie beide Token in DSH für eine sichere WebSocket-Verbindung.
151
+
152
+ ## Sicherheit und Zugriffsgrenzen
153
+
154
+ - **Verwaltungs-API**: Läuft unter `/api/dsh-im-connect` mit nativer Sitzungsauthentifizierung.
155
+ - **Schlüsselspeicher**: Anmeldedaten werden verschlüsselt im Tresor des Hosts verwaltet.
156
+ - **Werkzeug-Genehmigung**: Erlaubt die sichere Autorisierung direkt im Chat ohne Browser-Wechsel.
157
+
158
+ ## Entwicklung und Tests
159
+
160
+ ```powershell
161
+ [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
162
+ $OutputEncoding = [System.Text.Encoding]::UTF8
163
+ git clone https://github.com/MichengAI/dsh-im-connect.git
164
+ cd dsh-im-connect
165
+ npm install
166
+ npm test
167
+ dsh plugin --profile web add .
168
+ ```
169
+
170
+ ## Lizenz
171
+
172
+ Sicherheitsrichtlinien finden Sie unter [SECURITY.md](SECURITY.md).
173
+ Lizenziert unter [Apache License 2.0](LICENSE).
package/README.en.md CHANGED
@@ -8,7 +8,9 @@
8
8
 
9
9
  **Connect Feishu, Lark, DingTalk, WeCom, WeChat, QQ, Telegram, Discord, and Slack to local DeepSeek Harness**
10
10
 
11
- [简体中文](README.md) · [Changelog](CHANGELOG.md) · [QQ reference notes](docs/01-当前工作/I022-QQ直接引用接入/00-迭代总览.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
+ [Changelog](CHANGELOG.md) · [License](LICENSE)
12
14
 
13
15
  [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
14
16
  [![npm package](https://img.shields.io/npm/v/%40michengai%2Fdsh-im-connect.svg?label=npm%20package)](https://www.npmjs.com/package/@michengai/dsh-im-connect)
package/README.es.md ADDED
@@ -0,0 +1,173 @@
1
+ <p align="center">
2
+ <img src="assets/branding/dsh-banner.png" alt="DSH IM Connect" width="100%">
3
+ </p>
4
+
5
+ <div align="center">
6
+
7
+ # DSH IM Connect
8
+
9
+ **Conecte Feishu, Lark, DingTalk, WeCom, WeChat, QQ, Telegram, Discord y Slack a su instancia local de 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
+ [Registro de cambios](CHANGELOG.md) · [Licencia](LICENSE)
14
+
15
+ [![Licencia: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
16
+ [![Paquete npm](https://img.shields.io/npm/v/%40michengai%2Fdsh-im-connect.svg?label=npm%20package)](https://www.npmjs.com/package/@michengai/dsh-im-connect)
17
+ [![Descargas npm](https://img.shields.io/npm/dt/%40michengai%2Fdsh-im-connect.svg?label=npm%20downloads)](https://www.npmjs.com/package/@michengai/dsh-im-connect)
18
+ [![DSH Web Plugin](https://img.shields.io/badge/DSH%20Web-Plugin-0f766e.svg)](https://github.com/MichengAI/dsh-im-connect)
19
+ [![Node.js 22 o superior](https://img.shields.io/badge/Node.js-22%20or%20later-339933.svg?logo=node.js&logoColor=white)](https://nodejs.org/)
20
+ [![Canales](https://img.shields.io/badge/channels-9-238636.svg)](#-canales-compatibles)
21
+ </div>
22
+
23
+ > DSH IM Connect es un complemento para DeepSeek Harness (DSH) mantenido por la comunidad, no un producto oficial de DeepSeek AI.
24
+
25
+ ## Resumen de características
26
+
27
+ Incluso cuando esté lejos de su ordenador, envíe tareas a su DSH local a través de su aplicación de mensajería habitual, reciba respuestas, conteste preguntas y gestione la aprobación de herramientas en el mismo chat.
28
+
29
+ - **Conecte plataformas populares**: DingTalk, Feishu, Lark, WeChat, WeCom, QQ, Telegram, Discord y Slack.
30
+ - **Configuración individual por cuenta**: Añada múltiples cuentas en la misma plataforma; configure por separado el espacio de trabajo, modelo, nivel de razonamiento, permisos, acceso privado y método de envío.
31
+ - **Interacción directa desde el móvil**: Envíe instrucciones, lea respuestas y responda preguntas de opción única o múltiple; los usuarios aprobados pueden autorizar o rechazar la ejecución de herramientas directamente en chats privados.
32
+ - **Gestión independiente de sesiones**: Cada conversación de mensajería cuenta con una sesión aislada, consultable en la pestaña "Canales" del espacio de trabajo web.
33
+ - **Vinculación rápida por código QR o credenciales**: Conéctese fácilmente desde "Configuración → Asistente IM" y controle la recepción de mensajes por cuenta.
34
+ - **Control de acceso flexible**: Los grupos responden mediante menciones directas (@), mientras que los mensajes directos siguen las reglas de admisión configuradas.
35
+
36
+ ## ¿Quién puede interactuar con el asistente?
37
+
38
+ Los mensajes entrantes se evalúan según el remitente antes de procesar comandos, aprobaciones de herramientas o inyecciones de contexto.
39
+
40
+ | Caso de uso | Comportamiento |
41
+ |---|---|
42
+ | Grupo sin mención (@) al bot | Se ignora sin responder ni generar solicitudes de aprobación; mencionar a otros miembros tampoco activa el bot |
43
+ | Grupo con mención explícita (@) al bot | No requiere vinculación previa: cualquier participante del grupo puede enviar tareas |
44
+ | Mensaje directo del usuario que escaneó el QR | Los usuarios de WeChat, Feishu, Lark y QQ que hayan escaneado el código QR se añaden automáticamente a la lista blanca |
45
+ | Mensaje directo de otros usuarios | Aparecen en la lista de espera de configuración hasta que un administrador los apruebe |
46
+ | Mensaje directo tras vinculación QR sin identidad de usuario | La vinculación rápida de DingTalk y WeCom solo devuelve credenciales del bot, por lo que el usuario debe ser aprobado en configuración |
47
+ | Mensaje directo mediante credenciales manuales | Telegram, Discord, Slack y vinculaciones manuales de DingTalk, WeCom y QQ requieren aprobación previa para cada chat privado |
48
+ | Mensaje directo sin identificador (userId) | Se rechaza automáticamente |
49
+ | Aprobación de herramientas | Responda `Aprobar` o `Rechazar` (`Approve` / `Deny`) directamente en el chat vinculado; válido en grupos y privados sin necesidad de abrir la interfaz web. Si no se responde en 5 minutos, la acción se cancela de forma segura |
50
+ | Selección interactiva | Responda con el número de opción o el texto en la conversación correspondiente; para selección múltiple use comas. En grupos, solo el iniciador de la tarea puede responder |
51
+
52
+ ## 📡 Canales compatibles
53
+
54
+ <p align="center">
55
+ <code>🔔 DingTalk</code>&nbsp;
56
+ <code>🐦 Feishu</code>&nbsp;
57
+ <code>🌐 Lark</code>&nbsp;
58
+ <code>💬 WeChat</code>&nbsp;
59
+ <code>🏢 WeCom</code>&nbsp;
60
+ <code>🐧 QQ</code>&nbsp;
61
+ <code>✈️ Telegram</code>&nbsp;
62
+ <code>🎮 Discord</code>&nbsp;
63
+ <code>💬 Slack</code>
64
+ </p>
65
+
66
+ | Canal | Método de vinculación | Recepción | Envío |
67
+ |---|---|---|---|
68
+ | **🔔 DingTalk** | Código QR / Manual | Webhook | Webhook / Tarjetas interactivas |
69
+ | **🐦 Feishu** | Código QR / Manual | Long Polling / Eventos | Open API / Mensajes interactivos |
70
+ | **🌐 Lark** | Código QR / Manual | Long Polling / Eventos | Open API / Mensajes interactivos |
71
+ | **💬 WeChat** | Código QR | Sondeo oficial sincronizado | Protocolo de sincronización nativo |
72
+ | **🏢 WeCom** | Código QR / Manual | Callback interno | Webhook / Tarjetas de mensajes |
73
+ | **🐧 QQ** | Código QR / Manual | WebSocket oficial / Webhook | OpenAPI / Markdown enriquecido |
74
+ | **✈️ Telegram** | Bot Token | Long Polling (getUpdates) | Telegram Bot API / Citas plegables |
75
+ | **🎮 Discord** | Bot Token | Gateway WebSocket | REST API |
76
+ | **💬 Slack** | Bot Token & App Token | Socket Mode WebSocket | Web API / Block Kit |
77
+
78
+ ## Entrada de imágenes y archivos
79
+
80
+ Envíe capturas de pantalla, fotos o documentos (PDF, código, texto) directamente a la conversación. El modelo de visión de DSH los procesará automáticamente junto con sus instrucciones. Si DSH genera archivos (ZIP, texto, imágenes), se enviarán de vuelta a la conversación como archivos adjuntos nativos.
81
+
82
+ ## Menú de acciones y comandos
83
+
84
+ Escriba `/menu` en el chat para desplegar botones interactivos que permiten cambiar de sesión, crear nuevas tareas o modificar modelos con un solo toque.
85
+
86
+ ## Configuración del complemento
87
+
88
+ Disponible desde el panel de administración en **Complementos → @michengai/dsh-im-connect**:
89
+
90
+ ### 1. Ubicación del acceso (`location`)
91
+ - **Predeterminado**: Solo configuración (`settings`)
92
+ - **Opciones**: `both` (barra lateral y ajustes), `sidebar` (solo barra lateral), o `settings` (solo en el menú de configuración global).
93
+
94
+ ### 2. Mostrar sesiones de IM en el árbol de tareas (`taskTreeSessions`)
95
+ - **Predeterminado**: Desactivado (`false`)
96
+ - **Función**: Oculta las conversaciones de mensajería del árbol de tareas principal para evitar saturar el espacio de desarrollo diario.
97
+
98
+ ### 3. Bloqueo de actualizaciones por configuración Cordis (`updater` / `onlineUpdate`)
99
+ - **Predeterminado**: Sin bloqueo (`undefined`)
100
+ - **Función**: Para entornos corporativos o sin conexión a Internet, deshabilite los puntos de enlace de actualización declarándolo en `cordis.patch.yml`:
101
+ ```yaml
102
+ - id: im-connect
103
+ config:
104
+ updater: false # o onlineUpdate: false
105
+ ```
106
+ Al bloquearse, el punto de actualización del complemento responde con HTTP 403, delegando el ciclo de vida al gestor oficial de DSH.
107
+
108
+ ### 4. Política de activación en grupos de Telegram (`mentionPolicy` / `freeChatGroups`)
109
+ - **Predeterminado**: `addressed` (solo responde a menciones @ o respuestas directas al bot).
110
+ - **Función**: Configure si desea que el bot responda a todos los mensajes o defina una lista blanca de grupos sin necesidad de mención.
111
+
112
+ ### 5. Mensaje de pensamiento plegable (`thinkingDisplay`)
113
+ - **Predeterminado**: Desactivado (`off`)
114
+ - **Función**: Envía la cadena de pensamiento del modelo en Telegram dentro de un bloque de cita plegable (`<blockquote expandable>`).
115
+
116
+ ## Uso y comandos
117
+
118
+ Abra **Configuración → Asistente IM**, elija **Añadir cuenta** en el canal deseado y configure el espacio de trabajo, modelo, permisos y modo de envío.
119
+
120
+ | Objetivo | Acción | Notas |
121
+ | --- | --- | --- |
122
+ | Añadir cuenta | Seleccione **Añadir cuenta**, elija las preferencias y escanee o ingrese credenciales | Múltiples cuentas permitidas por canal |
123
+ | Modificar ajustes | Haga clic en Configuración en la fila de la cuenta | Cambios aplicados de inmediato |
124
+ | Pausar recepción | Desactive el interruptor **Recibir mensajes** | Las credenciales se conservan |
125
+ | Nueva sesión | Envíe `/new` o `/clear` | Inicia una sesión limpia en el canal |
126
+ | Estado / Ayuda | Envíe `/status` o `/help` | Muestra la sesión actual y comandos disponibles |
127
+ | Presets de agente | `/presets`, `/preset <número/ID>` | Cambia el perfil de agente activo |
128
+ | Modelo y razonamiento | `/models`, `/model <nombre>`, `/reasoning [nivel]` | Ajusta el modelo y esfuerzo de razonamiento |
129
+ | Gestión de sesiones | `/sessions`, `/session <número/ID>`, `/rename <título>`, `/fork` | Lista, cambia, renombra o bifurca sesiones |
130
+ | Recuperación de entregas | `/delivery`, `/delivery retry <ID>` | Reenvía mensajes que fallaron por desconexión |
131
+
132
+ ### Nombres automáticos de temas en Telegram
133
+
134
+ Los temas de foros en Telegram se nombran automáticamente a partir del primer título de la sesión. Puede sincronizarlos manualmente con `/rename <título>`.
135
+
136
+ ### Respuestas segmentadas
137
+
138
+ Permite dividir respuestas extensas en varios mensajes cortos sucesivos para una lectura más natural (activo actualmente en QQ).
139
+
140
+ ### Rotación por inactividad
141
+
142
+ Si transcurre un período prolongado desde el último mensaje (ej. 1 hora, 6 horas), el siguiente mensaje iniciará automáticamente una nueva sesión.
143
+
144
+ ### Conexión con Slack
145
+
146
+ 1. Cree una aplicación en Slack API (`api.slack.com/apps`).
147
+ 2. En **OAuth & Permissions → Bot Token Scopes**, añada los permisos de lectura, escritura, archivos y menciones.
148
+ 3. Instale la app en su espacio de trabajo y obtenga el Bot Token (`xoxb-`).
149
+ 4. Active **Socket Mode** y cree un App-Level Token (`xapp-`).
150
+ 5. Configure ambos tokens en DSH para conectar mediante WebSocket nativo.
151
+
152
+ ## Permisos y seguridad
153
+
154
+ - **API de gestión**: Utiliza `/api/dsh-im-connect` bajo las políticas de autenticación y protección de sesión nativas de DSH.
155
+ - **Almacenamiento de secretos**: Los tokens se resguardan de forma segura en las credenciales protegidas del host.
156
+ - **Aprobación de herramientas**: Permite autorizar comandos directamente en el chat sin exponer la consola web.
157
+
158
+ ## Desarrollo y pruebas
159
+
160
+ ```powershell
161
+ [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
162
+ $OutputEncoding = [System.Text.Encoding]::UTF8
163
+ git clone https://github.com/MichengAI/dsh-im-connect.git
164
+ cd dsh-im-connect
165
+ npm install
166
+ npm test
167
+ dsh plugin --profile web add .
168
+ ```
169
+
170
+ ## Licencia
171
+
172
+ Consulte las directrices de seguridad en [SECURITY.md](SECURITY.md).
173
+ Distribuido bajo la [Licencia Apache 2.0](LICENSE).
package/README.fr.md ADDED
@@ -0,0 +1,173 @@
1
+ <p align="center">
2
+ <img src="assets/branding/dsh-banner.png" alt="DSH IM Connect" width="100%">
3
+ </p>
4
+
5
+ <div align="center">
6
+
7
+ # DSH IM Connect
8
+
9
+ **Connectez Feishu, Lark, DingTalk, WeCom, WeChat, QQ, Telegram, Discord et Slack à votre agent local 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
+ [Journal des modifications](CHANGELOG.md) · [Licence](LICENSE)
14
+
15
+ [![Licence : Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
16
+ [![Paquet npm](https://img.shields.io/npm/v/%40michengai%2Fdsh-im-connect.svg?label=npm%20package)](https://www.npmjs.com/package/@michengai/dsh-im-connect)
17
+ [![Téléchargements npm](https://img.shields.io/npm/dt/%40michengai%2Fdsh-im-connect.svg?label=npm%20downloads)](https://www.npmjs.com/package/@michengai/dsh-im-connect)
18
+ [![DSH Web Plugin](https://img.shields.io/badge/DSH%20Web-Plugin-0f766e.svg)](https://github.com/MichengAI/dsh-im-connect)
19
+ [![Node.js 22 ou supérieur](https://img.shields.io/badge/Node.js-22%20or%20later-339933.svg?logo=node.js&logoColor=white)](https://nodejs.org/)
20
+ [![Canaux](https://img.shields.io/badge/channels-9-238636.svg)](#-canaux-pris-en-charge)
21
+ </div>
22
+
23
+ > DSH IM Connect est une extension pour DeepSeek Harness (DSH) maintenue par la communauté, et non un produit officiel de DeepSeek AI.
24
+
25
+ ## Aperçu des fonctionnalités
26
+
27
+ Même loin de votre poste de travail, assignez des tâches à votre DSH local via votre application de messagerie préférée, suivez les réponses, répondez aux questions et gérez l'approbation des outils au sein du même fil de discussion.
28
+
29
+ - **Prise en charge des plateformes majeures** : DingTalk, Feishu, Lark, WeChat, WeCom, QQ, Telegram, Discord et Slack.
30
+ - **Gestion multicompte indépendante** : Ajoutez plusieurs comptes sur un même service en configurant individuellement l'espace de travail, le modèle, l'effort de raisonnement, les autorisations et le mode de transmission.
31
+ - **Interactions fluides sur mobile** : Envoyez des instructions, consultez les résultats et répondez aux choix multiples. Les utilisateurs autorisés peuvent valider ou rejeter l'exécution des outils en message direct.
32
+ - **Sessions isolées et organisées** : Chaque conversation est rattachée à une session dédiée, consultable dans l'onglet « Canaux » de l'interface web.
33
+ - **Connexion rapide par QR code ou identifiants** : Gérez vos accès dans « Paramètres → Assistant IM » et pilotez la réception des messages par compte.
34
+ - **Contrôle d'accès rigoureux** : Déclenchement par mention (@) dans les groupes et politique d'admission personnalisée pour les messages privés.
35
+
36
+ ## Qui peut piloter l'assistant ?
37
+
38
+ Chaque message entrant est authentifié avant le traitement des commandes ou l'approbation des outils.
39
+
40
+ | Cas d'usage | Comportement |
41
+ |---|---|
42
+ | Groupe sans mention (@) du bot | Message ignoré sans réponse ni notification d'approbation ; mentionner d'autres membres ne déclenche rien |
43
+ | Groupe avec mention explicite (@) du bot | Aucune liaison préalable requise : tout participant peut assigner une tâche |
44
+ | Message privé de l'utilisateur ayant scanné le QR | Les utilisateurs de WeChat, Feishu, Lark et QQ ayant scanné le QR code sont automatiquement ajoutés à la liste blanche |
45
+ | Message privé d'autres utilisateurs | Placé en file d'attente d'approbation dans les paramètres jusqu'à validation par un administrateur |
46
+ | Message privé après liaison QR sans identité transmise | Les liaisons QR de DingTalk et WeCom ne renvoient que les accès bot ; une validation dans les paramètres reste nécessaire |
47
+ | Message privé via identifiants manuels | Telegram, Discord, Slack ainsi que DingTalk, WeCom et QQ configurés manuellement nécessitent une approbation par utilisateur |
48
+ | Message privé sans identifiant (userId) | Rejeté systématiquement |
49
+ | Approbation d'outils | Répondez simplement `Approuver` ou `Refuser` (`Approve` / `Deny`) dans la conversation liée ; fonctionne en groupe comme en privé. Sans réponse sous 5 minutes, l'action est annulée en toute sécurité |
50
+ | Sélection interactive | Répondez avec le numéro de l'option ou son libellé ; séparez par des virgules pour les sélections multiples. En groupe, seul l'initiateur peut répondre |
51
+
52
+ ## 📡 Canaux pris en charge
53
+
54
+ <p align="center">
55
+ <code>🔔 DingTalk</code>&nbsp;
56
+ <code>🐦 Feishu</code>&nbsp;
57
+ <code>🌐 Lark</code>&nbsp;
58
+ <code>💬 WeChat</code>&nbsp;
59
+ <code>🏢 WeCom</code>&nbsp;
60
+ <code>🐧 QQ</code>&nbsp;
61
+ <code>✈️ Telegram</code>&nbsp;
62
+ <code>🎮 Discord</code>&nbsp;
63
+ <code>💬 Slack</code>
64
+ </p>
65
+
66
+ | Canal | Méthode de liaison | Réception | Envoi |
67
+ |---|---|---|---|
68
+ | **🔔 DingTalk** | QR Code / Manuel | Webhook | Webhook / Cartes interactives |
69
+ | **🐦 Feishu** | QR Code / Manuel | Long Polling / Événements | Open API / Messages interactifs |
70
+ | **🌐 Lark** | QR Code / Manuel | Long Polling / Événements | Open API / Messages interactifs |
71
+ | **💬 WeChat** | QR Code | Scrutation officielle | Protocole de synchronisation natif |
72
+ | **🏢 WeCom** | QR Code / Manuel | Rappel interne | Webhook / Messages enrichis |
73
+ | **🐧 QQ** | QR Code / Manuel | WebSocket officiel / Webhook | OpenAPI / Markdown enrichi |
74
+ | **✈️ Telegram** | Jeton de bot | Long Polling (getUpdates) | Telegram Bot API / Citations repliables |
75
+ | **🎮 Discord** | Jeton de bot | Passerelle WebSocket | API REST |
76
+ | **💬 Slack** | Bot Token & App Token | Socket Mode WebSocket | Web API / Block Kit |
77
+
78
+ ## Entrée d'images et de fichiers
79
+
80
+ Transmettez captures d'écran, schémas ou pièces jointes (PDF, code, texte) directement dans la discussion. Le modèle de vision DSH les exploitera immédiatement. Les fichiers produits par vos tâches (archives ZIP, rapports, images) vous sont renvoyés sous forme de fichiers téléchargeables.
81
+
82
+ ## Menu d'actions rapides
83
+
84
+ Saisissez `/menu` dans la conversation pour faire apparaître des boutons d'action permettant de basculer de session ou d'ajuster les modèles en un clic.
85
+
86
+ ## Configuration de l'extension
87
+
88
+ Gérée depuis le panneau **Extensions → @michengai/dsh-im-connect** :
89
+
90
+ ### 1. Emplacement du raccourci (`location`)
91
+ - **Défaut** : Paramètres uniquement (`settings`)
92
+ - **Options** : `both` (barre latérale et paramètres), `sidebar` (barre latérale seule), ou `settings` (menu des paramètres uniquement).
93
+
94
+ ### 2. Afficher les sessions IM dans l'arbre des tâches (`taskTreeSessions`)
95
+ - **Défaut** : Désactivé (`false`)
96
+ - **Fonction** : Isole les échanges de messagerie de l'arborescence principale de développement pour préserver la lisibilité de vos projets.
97
+
98
+ ### 3. Verrouillage des mises à jour via Cordis (`updater` / `onlineUpdate`)
99
+ - **Défaut** : Déverrouillé (`undefined`)
100
+ - **Fonction** : Dans les réseaux d'entreprise ou isolés, désactivez les points de mise à jour dans `cordis.patch.yml` :
101
+ ```yaml
102
+ - id: im-connect
103
+ config:
104
+ updater: false # ou onlineUpdate: false
105
+ ```
106
+ Une fois verrouillé, le point d'accès renvoie HTTP 403 et délègue l'intégralité du cycle de vie au gestionnaire officiel de DSH.
107
+
108
+ ### 4. Règle de déclenchement dans les groupes Telegram (`mentionPolicy` / `freeChatGroups`)
109
+ - **Défaut** : `addressed` (répond uniquement aux mentions @ et aux réponses directes).
110
+ - **Fonction** : Définissez une liste blanche de groupes pour autoriser les échanges continus sans mention explicite.
111
+
112
+ ### 5. Affichage repliable de la réflexion (`thinkingDisplay`)
113
+ - **Défaut** : Désactivé (`off`)
114
+ - **Fonction** : Transmet le cheminement de pensée du modèle sous forme de bloc de citation repliable Telegram (`<blockquote expandable>`).
115
+
116
+ ## Utilisation et commandes
117
+
118
+ Ouvrez **Paramètres → Assistant IM**, cliquez sur **Ajouter un compte** et configurez l'espace de travail, le modèle, les droits et le mode d'envoi.
119
+
120
+ | Objectif | Action | Remarques |
121
+ | --- | --- | --- |
122
+ | Ajouter un compte | Cliquez sur **Ajouter un compte** sous le canal souhaité | Plusieurs comptes autorisés |
123
+ | Modifier les réglages | Cliquez sur Paramètres sur la ligne du compte | Prise en compte immédiate |
124
+ | Pause de la réception | Désactivez le commutateur **Recevoir les messages** | Les identifiants sont conservés |
125
+ | Nouvelle session | Envoyez `/new` ou `/clear` | Démarre une session propre sur ce canal |
126
+ | État / Aide | Envoyez `/status` ou `/help` | Affiche la session active et les commandes |
127
+ | Profils d'agent | `/presets`, `/preset <numéro/ID>` | Bascule vers un profil prédéfini |
128
+ | Modèle et raisonnement | `/models`, `/model <nom>`, `/reasoning [niveau]` | Ajuste dynamiquement le modèle |
129
+ | Gestion des sessions | `/sessions`, `/session <numéro/ID>`, `/rename <titre>`, `/fork` | Liste, bascule, renomme ou duplique une session |
130
+ | Récupération des envois | `/delivery`, `/delivery retry <ID>` | Réexpédie les messages interrompus |
131
+
132
+ ### Titrage automatique des sujets Telegram
133
+
134
+ Les sujets de forums Telegram sont automatiquement titrés à partir de la première réponse de l'assistant. Vous pouvez synchroniser le titre à tout moment avec `/rename <titre>`.
135
+
136
+ ### Réponses fragmentées (Segments)
137
+
138
+ Permet de découper les longues réponses en plusieurs messages successifs pour une lecture plus naturelle sur smartphone (actuellement disponible sur QQ).
139
+
140
+ ### Rotation de session après inactivité
141
+
142
+ Si aucun échange n'a eu lieu depuis une durée définie (ex. 1h, 6h), le message suivant ouvre automatiquement une nouvelle session propre.
143
+
144
+ ### Intégration de Slack
145
+
146
+ 1. Créez une application sur Slack API (`api.slack.com/apps`).
147
+ 2. Dans **OAuth & Permissions → Bot Token Scopes**, octroyez les droits pour les messages, fichiers, réactions et mentions.
148
+ 3. Installez l'application dans votre espace de travail et copiez le Bot Token (`xoxb-`).
149
+ 4. Activez le **Socket Mode** et générez un jeton applicatif (`xapp-`).
150
+ 5. Renseignez les deux jetons dans DSH pour établir une connexion WebSocket sécurisée.
151
+
152
+ ## Sécurité et limites d'accès
153
+
154
+ - **API de gestion** : Déployée sur `/api/dsh-im-connect` sous l'authentification native de DSH.
155
+ - **Stockage des secrets** : Les jetons sont chiffrés et protégés dans les coffres système de l'hôte.
156
+ - **Validation des outils** : Autorisez les actions d'un simple message sans basculer sur la console web.
157
+
158
+ ## Développement et tests
159
+
160
+ ```powershell
161
+ [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
162
+ $OutputEncoding = [System.Text.Encoding]::UTF8
163
+ git clone https://github.com/MichengAI/dsh-im-connect.git
164
+ cd dsh-im-connect
165
+ npm install
166
+ npm test
167
+ dsh plugin --profile web add .
168
+ ```
169
+
170
+ ## Licence
171
+
172
+ Consultez les recommandations de sécurité dans [SECURITY.md](SECURITY.md).
173
+ Distribué sous [Licence Apache 2.0](LICENSE).