@michengai/dsh-im-connect 1.0.47 → 1.0.49

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,23 @@
1
1
  # Changelog
2
2
 
3
+ ## [1.0.49] - 2026-11-21
4
+
5
+ ### Sidebar Channel Sessions Grouped by Account Instance & Quick Settings (#78)
6
+
7
+ - **Account-level session grouping**: When multiple accounts are configured for the same messaging platform, sidebar sessions are neatly organized into dedicated groups per account instance, preventing conversations across accounts from mixing together.
8
+ - **Clear & intuitive group titles**: Displays a clean platform title (e.g., "WeChat", "WeCom") in single-account environments, and automatically appends account remarks or custom names (e.g., "WeChat · Support") in multi-account environments.
9
+ - **Direct account settings via context menu**: Right-clicking any channel group heading now opens the settings and diagnostics panel for that specific account directly, making it faster to adjust credentials and remarks.
10
+ - **Instant title refresh on remark change**: Updating an account's remark name immediately refreshes the sidebar group title in real time without requiring a reload or restart.
11
+ - **Context menu presentation cleanup**: Fixed an issue where right-clicking a channel group could inadvertently leave the menu item labeled as "Rename", and eliminated extraneous blank space and divider lines at the bottom of the menu for a cleaner look.
12
+
13
+ ## [1.0.48] - 2026-11-20
14
+
15
+ ### WeCom Custom WebSocket URL for On-Premise Deployments (#76)
16
+
17
+ - **Custom WebSocket URL support**: Added support for configuring a custom WebSocket URL (`ws://` or `wss://`) for WeCom (Work WeChat), enabling seamless connection to self-hosted gateway servers in on-premise environments.
18
+ - **Graceful fallback to official default**: When left blank during credential setup or in account settings, WeCom automatically falls back to the official default address (`wss://openws.work.weixin.qq.com`).
19
+ - **Dynamic configuration update & reconnection**: Existing WeCom accounts can inspect, modify, or clear the WebSocket URL at any time from the account settings panel, which automatically reconnects to apply changes upon saving.
20
+
3
21
  ## [1.0.47] - 2026-11-20
4
22
 
5
23
  ### Feishu & Lark Long Reasoning Display (#75)
@@ -1,5 +1,23 @@
1
1
  # 更新日志
2
2
 
3
+ ## [1.0.49] - 2026-11-21
4
+
5
+ ### 侧边栏频道会话按账号独立分组与快捷设置(#78)
6
+
7
+ - **账号独立分组展示**:同一聊天平台下绑定多个账号时,侧边栏会话列表自动按各账号实例独立成组,避免多账号消息混杂在同一组内。
8
+ - **清晰直观的分组标题**:单账号场景简洁呈现平台名称(如「微信」、「企业微信」);多账号场景自动追加账号备注名或自定义标识(如「微信 · 客服号」),账号归属一目了然。
9
+ - **右键菜单直达账号设置**:在侧边栏右键点击任意频道分组,可直接打开该具体账号的设置与诊断面板,修改备注或凭据更快捷。
10
+ - **备注变更即时刷新**:修改或保存账号备注名后,侧边栏分组标题即时同步更新,无需重启插件或刷新页面。
11
+ - **分组右键菜单体验优化**:修复右键点击频道分组时菜单项文案偶现残留为「重命名」的问题,并移除菜单底部残留的多余空白与分割线,保持快捷设置菜单干净整洁。
12
+
13
+ ## [1.0.48] - 2026-11-20
14
+
15
+ ### 企业微信私有化部署 WebSocket URL 支持(#76)
16
+
17
+ - **支持自定义长连接地址**:企业微信渠道新增支持配置自定义 WebSocket URL(支持 `ws://` 与 `wss://`),方便在企业私有化部署环境下连接自建长连接网关。
18
+ - **灵活的官方默认回退**:在绑定账号凭据或账号设置中若留空,则自动回落使用企业微信官方默认长连接地址(`wss://openws.work.weixin.qq.com`)。
19
+ - **账号设置动态更新与重连**:已绑定的企业微信账号可在设置面板中随时查看、修改或清空 WebSocket URL,保存后自动重新建立长连接生效。
20
+
3
21
  ## [1.0.47] - 2026-11-20
4
22
 
5
23
  ### 飞书与 Lark 思考过程长文本展示体验(#75)
package/README.de.md CHANGED
@@ -69,7 +69,7 @@ Eingehende Nachrichten werden anhand des Absenders geprüft, bevor Befehle oder
69
69
  | **🐦 Feishu** | QR-Code / Manuell | Long Polling / Events | Open API / Interaktive Nachrichten |
70
70
  | **🌐 Lark** | QR-Code / Manuell | Long Polling / Events | Open API / Interaktive Nachrichten |
71
71
  | **💬 WeChat** | QR-Code | Offizielles Synchron-Polling | Natives Synchronisationsprotokoll |
72
- | **🏢 WeCom** | QR-Code / Manuell | Interne Rückrufe | Webhook / Formatierte Karten |
72
+ | **🏢 WeCom** | QR-Code / Manuell / WebSocket-URL | Interne Rückrufe | Webhook / Formatierte Karten / On-Premise-Support |
73
73
  | **🐧 QQ** | QR-Code / Manuell | Offizielles WebSocket / Webhook | OpenAPI / Rich Markdown |
74
74
  | **✈️ Telegram** | Bot-Token | Long Polling (getUpdates) | Telegram Bot API / Einklappbare Zitate |
75
75
  | **🎮 Discord** | Bot-Token | Gateway-WebSocket | REST-API |
@@ -107,6 +107,17 @@ Erreichbar über die Verwaltung unter **Plugins → @michengai/dsh-im-connect**:
107
107
  - **Standard**: Deaktiviert (`false`)
108
108
  - **Funktion**: Wenn aktiviert, behalten Antwort-Threads in Feishu-Gruppen isolierte Sitzungen und Kontexte basierend auf der Root-Nachrichten-ID. Standardmäßig teilen alle Threads den Gruppenkontext.
109
109
 
110
+ ### 6. Benutzerdefinierte WeCom-WebSocket-URL (`wsUrl`)
111
+ - **Standard**: Offizielle URL (`wss://openws.work.weixin.qq.com`)
112
+ - **Funktion**: Erlaubt die Konfiguration einer benutzerdefinierten WebSocket-URL für lokale oder On-Premise-Bereitstellungen. Leer lassen, um die offizielle Standardadresse zu verwenden.
113
+ - **UI-Konfiguration**: Geben Sie die URL im Formular für manuelle Zugangsdaten ein oder passen Sie sie jederzeit in den Kontodetails an. Änderungen verbinden sich nach dem Speichern automatisch neu.
114
+ - **Beispiel** (Kontokonfiguration):
115
+ ```json
116
+ {
117
+ "wsUrl": "wss://custom.wecom.internal/ws"
118
+ }
119
+ ```
120
+
110
121
  ## Nutzung und Befehle
111
122
 
112
123
  Öffnen Sie **Einstellungen → IM-Assistent**, wählen Sie **Konto hinzufügen** und konfigurieren Sie Arbeitsbereich, Modell, Berechtigungen und Versandmodus.
package/README.en.md CHANGED
@@ -71,7 +71,7 @@ WeChat is QR-only and DM-only, so the same WeChat account that scanned can talk
71
71
  | 🐦 **Feishu** | ✅ Ready | QR, or App ID / App Secret; QR creates the bot automatically | Feishu account, or a self-built bot with App ID / Secret |
72
72
  | 🌐 **Lark** | ✅ Ready | QR, or App ID / App Secret | Lark account, or a self-built bot with App ID / Secret |
73
73
  | 💬 **WeChat** | ✅ Ready* | Official iLink QR | Dedicated account recommended; DM only |
74
- | 🏢 **WeCom** | ✅ Ready | QR (recommended), or Bot ID / Secret | WeCom intelligent bot |
74
+ | 🏢 **WeCom** | ✅ Ready | QR (recommended), or Bot ID / Secret / WebSocket URL | WeCom intelligent bot; supports custom WebSocket URL for on-premise deployments |
75
75
  | 🐧 **QQ** | ✅ Ready | QR, or AppID / AppSecret | QQ Open Platform bot, not a personal QQ account |
76
76
  | ✈️ **Telegram** | ✅ Ready | Bot Token only | `@BotFather`; do not enable Webhook on the same bot |
77
77
  | 🎮 **Discord** | ✅ Ready | Bot Token only | Official Developer Portal bot. Enable the Message Content Intent. The first mention in a text or announcement channel continues in a thread without another mention |
@@ -325,6 +325,17 @@ Native configuration options are provided here. Their values are persisted in `c
325
325
  }
326
326
  ```
327
327
 
328
+ ### 6. WeCom custom WebSocket URL (`wsUrl`)
329
+ - **Default**: official default (`wss://openws.work.weixin.qq.com`)
330
+ - **Description**: Configure a custom WebSocket URL for on-premise or private deployments; leave blank to fall back to the official default.
331
+ - **UI Configuration**: Enter the **WebSocket URL** in the manual credentials form when adding an account, or inspect, modify, or clear it anytime in the account settings panel. Changes reconnect automatically upon saving.
332
+ - **Example** (account configuration):
333
+ ```json
334
+ {
335
+ "wsUrl": "wss://custom.wecom.internal/ws"
336
+ }
337
+ ```
338
+
328
339
  ## Usage
329
340
 
330
341
  Open **Settings → IM Assistant**, select **Add account** under the target channel, then choose that account's workspace, model, permission, private-access mode, and send mode. To register a new workspace, click **Add workspace…** in the dropdown footer to invoke the system folder picker (manual path inputs are disallowed); hosts lacking native folder pickers show "This Host cannot create workspaces" (upgrade to one of the supported host releases listed in Requirements, or add via the host sidebar).
package/README.es.md CHANGED
@@ -69,7 +69,7 @@ Los mensajes entrantes se evalúan según el remitente antes de procesar comando
69
69
  | **🐦 Feishu** | Código QR / Manual | Long Polling / Eventos | Open API / Mensajes interactivos |
70
70
  | **🌐 Lark** | Código QR / Manual | Long Polling / Eventos | Open API / Mensajes interactivos |
71
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 |
72
+ | **🏢 WeCom** | Código QR / Manual / WebSocket URL | Callback interno | Webhook / Tarjetas de mensajes / Despliegue privado |
73
73
  | **🐧 QQ** | Código QR / Manual | WebSocket oficial / Webhook | OpenAPI / Markdown enriquecido |
74
74
  | **✈️ Telegram** | Bot Token | Long Polling (getUpdates) | Telegram Bot API / Citas plegables |
75
75
  | **🎮 Discord** | Bot Token | Gateway WebSocket | REST API |
@@ -107,6 +107,17 @@ Disponible desde el panel de administración en **Complementos → @michengai/ds
107
107
  - **Predeterminado**: Desactivado (`false`)
108
108
  - **Función**: Cuando está habilitado, los hilos de respuesta en grupos de Feishu mantienen sesiones y contextos independientes basados en el ID del mensaje raíz. De forma predeterminada, todos los hilos comparten el contexto del grupo.
109
109
 
110
+ ### 6. URL personalizada de WebSocket en WeCom (`wsUrl`)
111
+ - **Predeterminado**: URL oficial (`wss://openws.work.weixin.qq.com`)
112
+ - **Función**: Permite configurar una URL de WebSocket personalizada para despliegues locales o privados. Dejar en blanco para usar la dirección oficial predeterminada.
113
+ - **Configuración en interfaz**: Ingrese la URL en el formulario de credenciales manuales al añadir una cuenta, o edítela en cualquier momento en el panel de detalles de la cuenta. Los cambios se reconectan automáticamente al guardar.
114
+ - **Ejemplo** (configuración de cuenta):
115
+ ```json
116
+ {
117
+ "wsUrl": "wss://custom.wecom.internal/ws"
118
+ }
119
+ ```
120
+
110
121
  ## Uso y comandos
111
122
 
112
123
  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.
package/README.fr.md CHANGED
@@ -69,7 +69,7 @@ Chaque message entrant est authentifié avant le traitement des commandes ou l'a
69
69
  | **🐦 Feishu** | QR Code / Manuel | Long Polling / Événements | Open API / Messages interactifs |
70
70
  | **🌐 Lark** | QR Code / Manuel | Long Polling / Événements | Open API / Messages interactifs |
71
71
  | **💬 WeChat** | QR Code | Scrutation officielle | Protocole de synchronisation natif |
72
- | **🏢 WeCom** | QR Code / Manuel | Rappel interne | Webhook / Messages enrichis |
72
+ | **🏢 WeCom** | QR Code / Manuel / URL WebSocket | Rappel interne | Webhook / Messages enrichis / Déploiement privé |
73
73
  | **🐧 QQ** | QR Code / Manuel | WebSocket officiel / Webhook | OpenAPI / Markdown enrichi |
74
74
  | **✈️ Telegram** | Jeton de bot | Long Polling (getUpdates) | Telegram Bot API / Citations repliables |
75
75
  | **🎮 Discord** | Jeton de bot | Passerelle WebSocket | API REST |
@@ -107,6 +107,17 @@ Gérée depuis le panneau **Extensions → @michengai/dsh-im-connect** :
107
107
  - **Défaut** : Désactivé (`false`)
108
108
  - **Fonction** : Lorsqu'activé, les fils de réponse (threads) dans les groupes Feishu conservent des sessions et contextes indépendants basés sur l'ID du message racine. Par défaut, tous les fils partagent le contexte du groupe.
109
109
 
110
+ ### 6. URL WebSocket personnalisée WeCom (`wsUrl`)
111
+ - **Défaut** : URL officielle (`wss://openws.work.weixin.qq.com`)
112
+ - **Fonction** : Permet de configurer une URL WebSocket personnalisée pour les déploiements sur site ou privés. Laissez vide pour utiliser l'adresse officielle par défaut.
113
+ - **Configuration dans l'interface** : Saisissez l'URL dans le formulaire de saisie manuelle lors de l'ajout d'un compte, ou modifiez-la à tout moment dans le panneau de détails du compte. La reconnexion est automatique lors de l'enregistrement.
114
+ - **Exemple** (configuration de compte) :
115
+ ```json
116
+ {
117
+ "wsUrl": "wss://custom.wecom.internal/ws"
118
+ }
119
+ ```
120
+
110
121
  ## Utilisation et commandes
111
122
 
112
123
  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.
package/README.ja.md CHANGED
@@ -71,7 +71,7 @@ WeChat はQRコード連携のみでDMにのみ対応しているため、スキ
71
71
  | **🐦 Feishu** | QRコードスキャン / 手動凭証 | 長時間ポーリング / イベント | Open API / カードメッセージ |
72
72
  | **🌐 Lark** | QRコードスキャン / 手動凭証 | 長時間ポーリング / イベント | Open API / カードメッセージ |
73
73
  | **💬 WeChat** | QRコードスキャン | 公式同期ポーリング | 組み込み同期プロトコル |
74
- | **🏢 WeCom** | QRコードスキャン / 手動凭証 | 内部コールバック | Webhook / カードメッセージ |
74
+ | **🏢 WeCom** | QRコードスキャン / 手動凭証 / WebSocket URL | 内部コールバック | Webhook / カードメッセージ / オンプレミス対応 |
75
75
  | **🐧 QQ** | QRコードスキャン / 手動凭証 | 公式 WebSocket / Webhook | OpenAPI / リッチテキスト |
76
76
  | **✈️ Telegram** | Bot Token | 長時間ポーリング (getUpdates) | Telegram Bot API / 折畳引用 |
77
77
  | **🎮 Discord** | Bot Token | Gateway WebSocket | REST API |
@@ -165,6 +165,17 @@ dsh plugin --profile web add @michengai/dsh-im-connect --registry=https://regist
165
165
  - **機能**: 有効にすると、飛書グループ内のスレッド(Thread)ごとに独立したセッションとコンテキストが保持されます。無効時はグループ全体で1つのセッションを共有します。
166
166
  - **UI 設定**: 「設定 → IM アシスタント → 飛書 / Lark アカウント設定」から「スレッドセッション分離」を切り替えられます。
167
167
 
168
+ ### 6. WeCom オンプレミス WebSocket URL (`wsUrl`)
169
+ - **デフォルト**: 公式デフォルト (`wss://openws.work.weixin.qq.com`)
170
+ - **機能**: オンプレミスやプライベート展開環境でカスタム WebSocket URL を設定できます。空欄の場合は公式デフォルトが使用されます。
171
+ - **UI 設定**: 「アカウント追加」の手動設定フォームで「WebSocket URL」を入力するか、アカウント詳細設定パネルからいつでも確認・変更・クリアできます。保存後に自動再接続されます。
172
+ - **設定例**(アカウント設定):
173
+ ```json
174
+ {
175
+ "wsUrl": "wss://custom.wecom.internal/ws"
176
+ }
177
+ ```
178
+
168
179
  ## 使用方法
169
180
 
170
181
  「設定 → IM アシスタント」を開き、対象チャネルの「アカウント追加」を選択し、ワークスペース、モデル、権限、アクセスモード、送信方式を設定します。
package/README.md CHANGED
@@ -73,7 +73,7 @@
73
73
  | 🐦 **飞书** | ✅ 可用 | 扫码(自动创建机器人),或 App ID / App Secret | 飞书账号,或自建机器人凭据 |
74
74
  | 🌐 **Lark** | ✅ 可用 | 扫码,或 App ID / App Secret | Lark 国际版账号,或自建机器人凭据 |
75
75
  | 💬 **微信** | ✅ 可用* | 官方 iLink 扫码 | 建议专用小号;仅私聊 |
76
- | 🏢 **企业微信** | ✅ 可用 | 扫码(推荐),或 Bot ID / Secret | 企业微信智能机器人 |
76
+ | 🏢 **企业微信** | ✅ 可用 | 扫码(推荐),或 Bot ID / Secret / WebSocket URL | 企业微信智能机器人;支持私有化部署自定义长连接地址 |
77
77
  | 🐧 **QQ** | ✅ 可用 | 扫码,或 AppID / AppSecret | QQ 开放平台机器人,不是个人号 |
78
78
  | ✈️ **Telegram** | ✅ 可用 | 仅填 Bot Token | `@BotFather`;同一 Bot 不要同时开 Webhook |
79
79
  | 🎮 **Discord** | ✅ 可用 | 仅填 Bot Token | Developer Portal 的官方 Bot。打开 Message Content Intent;文字频道和公告频道第一次 @ 后在 Thread 中继续,不必重复 @ |
@@ -325,6 +325,17 @@ dsh --profile web --dump-config
325
325
  }
326
326
  ```
327
327
 
328
+ ### 6. 企业微信私有化长连接地址 (`wsUrl`)
329
+ - **默认状态**:官方默认地址(`wss://openws.work.weixin.qq.com`)
330
+ - **功能说明**:在企业微信私有化部署场景下,可配置自建服务的 WebSocket 长连接地址;留空保存自动回退使用官方默认地址。
331
+ - **界面配置**:在「添加账号」的手动凭据表单中可直接填写「WebSocket URL」;在已绑账号详情设置面板中可随时查看、修改或清空,修改保存后自动重新建立连接生效。
332
+ - **配置示例**(账号配置):
333
+ ```json
334
+ {
335
+ "wsUrl": "wss://custom.wecom.internal/ws"
336
+ }
337
+ ```
338
+
328
339
  ## 使用
329
340
 
330
341
  打开「设置 → IM助理」,在目标渠道点击「添加账号」,并为该账号选择工作区、模型、权限、私聊准入和发送方式。若需要新工作区,可展开工作区下拉列表点击底部的「添加工作区…」直接调起系统文件选择器(禁止手输路径);不支持原生目录选择器的宿主会提示「当前 Host 无法新增工作区」,请升级到「环境要求」中列出的受支持宿主版本,或直接在宿主侧栏添加工作区。
package/README.pt.md CHANGED
@@ -69,7 +69,7 @@ As mensagens recebidas são verificadas pelo remetente antes do processamento de
69
69
  | **🐦 Feishu** | QR Code / Manual | Long Polling / Eventos | Open API / Cartões interativos |
70
70
  | **🌐 Lark** | QR Code / Manual | Long Polling / Eventos | Open API / Cartões interativos |
71
71
  | **💬 WeChat** | QR Code | Sondagem oficial sincronizada | Protocolo de sincronização nativo |
72
- | **🏢 WeCom** | QR Code / Manual | Callback interno | Webhook / Cartões formatados |
72
+ | **🏢 WeCom** | QR Code / Manual / URL do WebSocket | Callback interno | Webhook / Cartões formatados / Suporte On-Premise |
73
73
  | **🐧 QQ** | QR Code / Manual | WebSocket oficial / Webhook | OpenAPI / Markdown avançado |
74
74
  | **✈️ Telegram** | Token de Bot | Long Polling (getUpdates) | Telegram Bot API / Citações expansíveis |
75
75
  | **🎮 Discord** | Token de Bot | Gateway WebSocket | REST API |
@@ -107,6 +107,17 @@ Acessível no painel em **Plugins → @michengai/dsh-im-connect**:
107
107
  - **Padrão**: Desativado (`false`)
108
108
  - **Função**: Quando ativado, os tópicos de resposta em grupos do Feishu mantêm sessões e contextos isolados baseados no ID da mensagem raiz. Por padrão, todos os tópicos compartilham o contexto do grupo.
109
109
 
110
+ ### 6. URL personalizada de WebSocket no WeCom (`wsUrl`)
111
+ - **Padrão**: URL oficial (`wss://openws.work.weixin.qq.com`)
112
+ - **Função**: Permite configurar uma URL personalizada de WebSocket para implantações locais ou privadas. Deixe em branco para usar o endereço padrão oficial.
113
+ - **Configuração na interface**: Insira a URL no formulário manual ao adicionar uma conta ou edite-a a qualquer momento nos detalhes da conta. As alterações reconectam automaticamente ao salvar.
114
+ - **Exemplo** (configuração de conta):
115
+ ```json
116
+ {
117
+ "wsUrl": "wss://custom.wecom.internal/ws"
118
+ }
119
+ ```
120
+
110
121
  ## Uso e comandos
111
122
 
112
123
  Abra **Configurações → Assistente IM**, clique em **Adicionar conta** e configure o espaço de trabalho, modelo, permissões e modo de envio.
package/README.ru.md CHANGED
@@ -69,7 +69,7 @@
69
69
  | **🐦 Feishu** | QR-код / Вручную | Long Polling / События | Open API / Интерактивные карточки |
70
70
  | **🌐 Lark** | QR-код / Вручную | Long Polling / События | Open API / Интерактивные карточки |
71
71
  | **💬 WeChat** | QR-код | Официальный опрос | Встроенный протокол синхронизации |
72
- | **🏢 WeCom** | QR-код / Вручную | Внутренний Callback | Webhook / Форматированные карточки |
72
+ | **🏢 WeCom** | QR-код / Вручную / WebSocket URL | Внутренний Callback | Webhook / Форматированные карточки / Поддержка On-Premise |
73
73
  | **🐧 QQ** | QR-код / Вручную | Официальный WebSocket / Webhook | OpenAPI / Markdown |
74
74
  | **✈️ Telegram** | Bot Token | Long Polling (getUpdates) | Telegram Bot API / Сворачиваемые цитаты |
75
75
  | **🎮 Discord** | Bot Token | Gateway WebSocket | REST API |
@@ -107,6 +107,17 @@
107
107
  - **По умолчанию**: Отключено (`false`)
108
108
  - **Назначение**: При включении ветки ответов (треды) в группах Feishu изолируются в отдельные сессии и контексты по идентификатору корневого сообщения. По умолчанию все треды используют общий контекст группы.
109
109
 
110
+ ### 6. Пользовательский WebSocket URL для WeCom (`wsUrl`)
111
+ - **По умолчанию**: Официальный URL (`wss://openws.work.weixin.qq.com`)
112
+ - **Назначение**: Позволяет настроить собственный адрес WebSocket URL для локальных или изолированных развертываний. Оставьте пустым для использования официального адреса.
113
+ - **Настройка в интерфейсе**: Укажите адрес в форме ручного ввода учетных данных или измените его в параметрах аккаунта. При сохранении соединение перезапускается автоматически.
114
+ - **Пример** (конфигурация аккаунта):
115
+ ```json
116
+ {
117
+ "wsUrl": "wss://custom.wecom.internal/ws"
118
+ }
119
+ ```
120
+
110
121
  ## Использование и команды
111
122
 
112
123
  Откройте **Настройки → IM-ассистент**, выберите **Добавить аккаунт** и укажите рабочую область, модель, права и режим отправки.
package/README.zh-CN.md CHANGED
@@ -73,7 +73,7 @@
73
73
  | 🐦 **飞书** | ✅ 可用 | 扫码(自动创建机器人),或 App ID / App Secret | 飞书账号,或自建机器人凭据 |
74
74
  | 🌐 **Lark** | ✅ 可用 | 扫码,或 App ID / App Secret | Lark 国际版账号,或自建机器人凭据 |
75
75
  | 💬 **微信** | ✅ 可用* | 官方 iLink 扫码 | 建议专用小号;仅私聊 |
76
- | 🏢 **企业微信** | ✅ 可用 | 扫码(推荐),或 Bot ID / Secret | 企业微信智能机器人 |
76
+ | 🏢 **企业微信** | ✅ 可用 | 扫码(推荐),或 Bot ID / Secret / WebSocket URL | 企业微信智能机器人;支持私有化部署自定义长连接地址 |
77
77
  | 🐧 **QQ** | ✅ 可用 | 扫码,或 AppID / AppSecret | QQ 开放平台机器人,不是个人号 |
78
78
  | ✈️ **Telegram** | ✅ 可用 | 仅填 Bot Token | `@BotFather`;同一 Bot 不要同时开 Webhook |
79
79
  | 🎮 **Discord** | ✅ 可用 | 仅填 Bot Token | Developer Portal 的官方 Bot。打开 Message Content Intent;文字频道和公告频道第一次 @ 后在 Thread 中继续,不必重复 @ |
@@ -325,6 +325,17 @@ dsh --profile web --dump-config
325
325
  }
326
326
  ```
327
327
 
328
+ ### 6. 企业微信私有化长连接地址 (`wsUrl`)
329
+ - **默认状态**:官方默认地址(`wss://openws.work.weixin.qq.com`)
330
+ - **功能说明**:在企业微信私有化部署场景下,可配置自建服务的 WebSocket 长连接地址;留空保存自动回退使用官方默认地址。
331
+ - **界面配置**:在「添加账号」的手动凭据表单中可直接填写「WebSocket URL」;在已绑账号详情设置面板中可随时查看、修改或清空,修改保存后自动重新建立连接生效。
332
+ - **配置示例**(账号配置):
333
+ ```json
334
+ {
335
+ "wsUrl": "wss://custom.wecom.internal/ws"
336
+ }
337
+ ```
338
+
328
339
  ## 使用
329
340
 
330
341
  打开「设置 → IM助理」,在目标渠道点击「添加账号」,并为该账号选择工作区、模型、权限、私聊准入和发送方式。若需要新工作区,可展开工作区下拉列表点击底部的「添加工作区…」直接调起系统文件选择器(禁止手输路径);不支持原生目录选择器的宿主会提示「当前 Host 无法新增工作区」,请升级到「环境要求」中列出的受支持宿主版本,或直接在宿主侧栏添加工作区。