@xmanrui/dsh-im 4.24.1 → 4.26.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "4.24.1",
-  "description": "把十一种 IM 渠道和公网 AI Office 接入本机 DeepSeek Harness。 Connect eleven IM channels and a public AI Office to a local DeepSeek Harness.",
+  "version": "4.26.0",
+  "description": "把十二种 IM 渠道和公网 AI Office 接入本机 DeepSeek Harness。 Connect twelve IM channels and a public AI Office to a local DeepSeek Harness.",
   "keywords": [
     "deepseek-harness",
     "dsh",
@@ -21,6 +21,7 @@
     "discord",
     "whatsapp",
     "imessage",
+    "matrix",
     "ai-office"
   ],
   "author": "xmanrui (https://github.com/xmanrui)",
@@ -115,6 +116,7 @@
     "lib",
     "plugin-src",
     "scripts/verify-interface-language.mjs",
+    "scripts/verify-injected-context.mjs",
     "scripts/verify-lan-management.mjs",
     "scripts/verify-model-setting.mjs",
     "scripts/verify-package.mjs",
@@ -144,13 +146,9 @@
       "platform": "web"
     },
     "compatibility": {
-      "dsh": "0.1.2-alpha.4 || 0.1.2-alpha.5 || 0.1.2-rc.1 || 0.1.3-alpha.1 || 0.1.5-alpha.1",
+      "dsh": "0.1.7-alpha.1",
       "dshReleases": {
-        "0.1.2-alpha.4": "compatible",
-        "0.1.2-alpha.5": "compatible",
-        "0.1.2-rc.1": "compatible",
-        "0.1.3-alpha.1": "compatible",
-        "0.1.5-alpha.1": "compatible"
+        "0.1.7-alpha.1": "compatible"
       },
       "profiles": [
         "web"
@@ -166,6 +164,7 @@
     "node": ">=22.19"
   },
   "dependencies": {
+    "@matrix-org/olm": "3.2.15",
     "@tencent-connect/qqbot-connector": "1.2.0",
     "@tencent-connect/qqbot-nodejs": "1.0.4",
     "@wecom/aibot-node-sdk": "1.0.7",

package/plugin-src/client/channel-logos.js

@@ -155,6 +155,17 @@ export function IMessageLogoGlyph({ size } = {}) {
   }));
 }
 
+export function MatrixLogoGlyph({ size } = {}) {
+  return h('svg', {
+    ...dimensions(size), viewBox: '0 0 24 24', focusable: 'false',
+    'aria-hidden': 'true', 'data-im-channel-logo': 'matrix',
+  }, h('path', {
+    fill: 'currentColor',
+    'fill-rule': 'evenodd',
+    d: 'M4 4h16a2.4 2.4 0 0 1 2.4 2.4v8.2A2.4 2.4 0 0 1 20 17h-7.55l-4.2 3.3a.6.6 0 0 1-.98-.47V17H4A2.4 2.4 0 0 1 1.6 14.6V6.4A2.4 2.4 0 0 1 4 4Zm3 4.1a1.45 1.45 0 1 0 0 2.9 1.45 1.45 0 0 0 0-2.9Zm5.6 0a1.45 1.45 0 1 0 0 2.9 1.45 1.45 0 0 0 0-2.9Zm5.6 0a1.45 1.45 0 1 0 0 2.9 1.45 1.45 0 0 0 0-2.9Z',
+  }));
+}
+
 export function OfficeLogoGlyph({ size } = {}) {
   return h('svg', {
     ...dimensions(size),

package/plugin-src/client/channels/matrix/api.js

@@ -0,0 +1,11 @@
+import { TOKEN_BOT_ENDPOINTS, createTokenChannelApi } from '../shared/token-api.js';
+
+export const MATRIX_RPC_CHANNEL = '/matrix';
+export const MATRIX_ENDPOINTS = TOKEN_BOT_ENDPOINTS;
+
+const api = createTokenChannelApi('Matrix', ' CS API 长轮询');
+
+export const unwrapRpcResult = api.unwrapRpcResult;
+export const normalizeSnapshot = api.normalizeSnapshot;
+export const presentError = api.presentError;
+export { api as matrixClientApi };

package/plugin-src/client/channels/matrix/index.js

@@ -0,0 +1,151 @@
+import * as React from 'react';
+
+import { MatrixLogoGlyph } from '../../channel-logos.js';
+import { h } from '../../i18n.js';
+import { createTokenChannelSettings } from '../shared/token-channel.js';
+import { MATRIX_ENDPOINTS, matrixClientApi } from './api.js';
+import { installMatrixStyles } from './styles.js';
+
+const MATRIX_USER_ID_PATTERN = /^@[^:@\s]+:[^:@\s]+(?::\d{1,5})?$/u;
+
+function validHomeserver(value) {
+  if (!value || value.length > 2_048) return false;
+  try {
+    const url = new URL(value);
+    return (url.protocol === 'https:' || url.protocol === 'http:')
+      && !url.username && !url.password && !url.hash;
+  } catch {
+    return false;
+  }
+}
+
+export function MatrixCredentialPanel({ busy, error, onSubmit, onCancel }) {
+  const [homeserver, setHomeserver] = React.useState('');
+  const [accessToken, setAccessToken] = React.useState('');
+  const [userId, setUserId] = React.useState('');
+  const [password, setPassword] = React.useState('');
+  const headingId = React.useId();
+
+  const normalizedHomeserver = homeserver.trim();
+  const normalizedUserId = userId.trim();
+  const tokenMode = Boolean(accessToken.trim());
+  const loginMode = Boolean(normalizedUserId) && Boolean(password);
+  const canSubmit = validHomeserver(normalizedHomeserver)
+    && (tokenMode
+      ? (!normalizedUserId && !password && accessToken.trim().length >= 8)
+      : (!accessToken.trim() && MATRIX_USER_ID_PATTERN.test(normalizedUserId) && password.length >= 1));
+
+  const submit = (event) => {
+    event.preventDefault();
+    if (!canSubmit || busy) return;
+    void onSubmit?.(tokenMode
+      ? { homeserver: normalizedHomeserver, accessToken: accessToken.trim() }
+      : {
+        homeserver: normalizedHomeserver,
+        userId: normalizedUserId,
+        password,
+      });
+  };
+
+  return h('section', {
+    className: 'ddt-card dim-surfaceCard dim-credentialPanel dmt-setup',
+    'aria-labelledby': headingId,
+  },
+  h('h3', { id: headingId, className: 'dim-credentialTitle' }, '接入 Matrix 机器人'),
+  h('div', { className: 'dmt-guide' },
+    h('div', { className: 'dmt-guideCopy' },
+      h('strong', null, '连接你的 Matrix homeserver'),
+      h('p', null, '填写 homeserver 地址，并提供访问令牌，或者用户 ID 与密码的组合。机器人只访问该 homeserver，不连接第三方服务器。'))),
+  h('form', { className: 'dim-credentialForm dim-credentialFormSingle', onSubmit: submit },
+    h('div', { className: 'dmt-fields' },
+      h('label', { className: 'dim-credentialField dmt-fieldWide' },
+        h('span', null, 'Homeserver 地址'),
+        h('input', {
+          type: 'url',
+          value: homeserver,
+          onChange: (event) => setHomeserver(event.target.value),
+          placeholder: 'https://matrix.example.org',
+          maxLength: 2048,
+          autoCapitalize: 'none',
+          autoCorrect: 'off',
+          spellCheck: false,
+          disabled: busy,
+          required: true,
+        })),
+      h('label', { className: 'dim-credentialField dmt-fieldWide' },
+        h('span', null, '访问令牌（与用户 ID、密码二选一）'),
+        h('input', {
+          type: 'password',
+          value: accessToken,
+          onChange: (event) => setAccessToken(event.target.value),
+          placeholder: 'syt_…',
+          maxLength: 4096,
+          autoCapitalize: 'none',
+          autoCorrect: 'off',
+          spellCheck: false,
+          autoComplete: 'new-password',
+          disabled: busy,
+        })),
+      h('label', { className: 'dim-credentialField' },
+        h('span', null, '用户 ID（可选）'),
+        h('input', {
+          type: 'text',
+          value: userId,
+          onChange: (event) => setUserId(event.target.value),
+          placeholder: '@bot:example.org',
+          maxLength: 512,
+          autoCapitalize: 'none',
+          autoCorrect: 'off',
+          spellCheck: false,
+          disabled: busy,
+        })),
+      h('label', { className: 'dim-credentialField' },
+        h('span', null, '密码（可选）'),
+        h('input', {
+          type: 'password',
+          value: password,
+          onChange: (event) => setPassword(event.target.value),
+          maxLength: 1024,
+          autoComplete: 'new-password',
+          disabled: busy,
+        })),
+      h('p', { className: 'dmt-tokenHint' }, '访问令牌来自 Element 设置 → 帮助 → 编辑设置，或 homeserver 的登录接口；用户 ID 与密码方式会为本安装派生稳定设备会话。')),
+    error ? h('p', { className: 'dim-credentialError', role: 'alert' }, error.message ?? String(error)) : null,
+    h('div', { className: 'ddt-actions dim-viewActions dim-credentialActions' },
+      h('button', {
+        type: 'submit',
+        className: 'ddt-button',
+        'data-kind': 'primary',
+        disabled: busy || !canSubmit,
+      }, busy ? '正在验证并连接…' : '验证并连接'),
+      h('button', {
+        type: 'button',
+        className: 'ddt-button',
+        onClick: onCancel,
+        disabled: busy,
+      }, '取消'))));
+}
+
+const channel = createTokenChannelSettings({
+  channel: 'Matrix',
+  endpoints: MATRIX_ENDPOINTS,
+  api: matrixClientApi,
+  LogoGlyph: MatrixLogoGlyph,
+  installStyles: installMatrixStyles,
+  pageClass: 'dmt-page',
+  avatarClass: 'dmt-avatar',
+  connectionLabel: 'CS API 长轮询',
+  emptyTitle: '接入 Matrix 机器人',
+  emptyDescription: '填写 homeserver 地址与访问令牌，或者用户 ID 与密码，即可让机器人以 CS API 长轮询接收消息并以富文本回复。',
+  platformLabel: 'Matrix homeserver',
+  CredentialPanel: MatrixCredentialPanel,
+  credentialPayload: ({ homeserver, accessToken, userId, password }) => ({ homeserver, accessToken, userId, password }),
+  credentialAriaLabel: '使用 homeserver 与凭据接入 Matrix 机器人',
+  credentialOpenLabel: '接入机器人',
+  credentialCloseLabel: '收起接入',
+  credentialNoun: '访问令牌或用户 ID 与密码',
+  emptyActionLabel: '开始接入',
+});
+
+export const MatrixSettingsTab = channel.SettingsTab;
+export const MatrixAccountCard = channel.AccountCard;

package/plugin-src/client/channels/matrix/styles.js

@@ -0,0 +1,36 @@
+export const MATRIX_STYLE_ID = 'xmanrui-dsh-im-matrix-settings';
+
+const CSS = String.raw`
+.dmt-page { --ddt-accent: #1a8f6f; --ddt-accent-deep: #12654f; --ddt-accent-wash: #eef8f4; }
+.dmt-avatar { background: linear-gradient(145deg, #fff, #f6faf8); border: 1px solid #e2eae7; }
+.dmt-avatar svg { display: block; }
+.dim-logoMatrix { color: white; background: #0dbd8b; }
+.dim-logoMatrix svg { width: 22px; height: 22px; }
+.dmt-setup { display: grid; gap: 18px; }
+.dmt-guide { display: grid; grid-template-columns: minmax(0, 1fr) auto; align-items: start; gap: 18px; padding: 16px; border: 1px solid color-mix(in srgb, #1a8f6f 18%, var(--dsw-alias-border-l2, #e5e6eb)); border-radius: 11px; background: color-mix(in srgb, #1a8f6f 4%, var(--dsw-alias-bg-layer-1, #fff)); }
+.dmt-guideCopy { min-width: 0; }
+.dmt-guideCopy strong { display: block; margin-bottom: 5px; color: var(--dsw-alias-label-primary, #1f2329); font-size: 13px; }
+.dmt-guideCopy p { margin: 0; color: var(--dsw-alias-label-secondary, #646a73); font-size: 12px; line-height: 1.6; }
+.dmt-guideActions { display: flex; align-items: center; flex-wrap: wrap; justify-content: flex-end; gap: 8px; }
+.dmt-guideActions .ddt-button { white-space: nowrap; }
+.dmt-fields { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; }
+.dmt-fields .dmt-fieldWide { grid-column: 1 / -1; }
+.dmt-tokenHint { grid-column: 1 / -1; margin: -4px 0 0; color: var(--dsw-alias-label-tertiary, #8f959e); font-size: 11px; line-height: 1.55; }
+@container (max-width: 680px) {
+  .dmt-guide { grid-template-columns: minmax(0, 1fr); }
+  .dmt-guideActions { justify-content: flex-start; }
+  .dmt-fields { grid-template-columns: minmax(0, 1fr); }
+}
+`;
+
+export function installMatrixStyles() {
+  if (typeof document === 'undefined') return () => {};
+  const existing = document.querySelector(`style[data-plugin-css="${MATRIX_STYLE_ID}"]`);
+  if (existing) return () => {};
+  const style = document.createElement('style');
+  style.dataset.plugin = '@xmanrui/dsh-im';
+  style.dataset.pluginCss = MATRIX_STYLE_ID;
+  style.textContent = CSS;
+  document.head.appendChild(style);
+  return () => style.remove();
+}

package/plugin-src/client/global-settings.js

@@ -118,21 +118,33 @@ export function ImageInputSettings({ rpcCall }) {
     ['maxTotalMb', '模型图片总量上限 (MB)'],
     ['maxImages', '每条消息最多图片数'],
   ];
-  return h('section', { className: 'dim-globalSection', 'aria-label': '图片输入', 'aria-busy': phase === 'loading' || phase === 'saving' },
-    h('h3', null, '图片输入'),
-    h('p', null, '适用于支持图片的聊天渠道。原图按附件保留时长保存，发送给模型的副本会自动缩放或压缩；无法直接发送时交给模型按文件处理。'),
+  return h('section', { className: 'dim-globalSection dim-imageSettings', 'aria-label': '图片输入', 'aria-busy': phase === 'loading' || phase === 'saving' },
+    h('div', { className: 'dim-globalHead' },
+      h('div', { className: 'dim-globalHeadTitle' },
+        h('h3', null, '图片输入'),
+        h('div', { className: 'dim-globalTtlHelp' },
+          h('button', {
+            type: 'button',
+            className: 'dim-channelHelpButton dim-globalTtlHelpButton',
+            'aria-label': '查看图片输入说明',
+            'aria-describedby': `${id}-help`,
+          }, h('span', { 'aria-hidden': 'true' }, '?')),
+          h('div', { id: `${id}-help`, className: 'dim-globalTtlTooltip dim-imageSettingsTooltip', role: 'tooltip' },
+            '适用于支持图片的聊天渠道。原图按附件保留时长保存，发送给模型的副本会自动缩放或压缩；无法直接发送时交给模型按文件处理。')))),
     h('form', { onSubmit: save },
-      ...fields.map(([key, label]) => h('div', { className: 'dim-globalTtlRow', key },
-        h('label', { htmlFor: `${id}-${key}` }, label),
-        h('input', { id: `${id}-${key}`, className: 'dim-globalTtlInput', type: 'number', min: 1, step: 1,
-          value: values[key], disabled: phase !== 'ready',
-          onChange: (event) => { setValues((current) => ({ ...current, [key]: event.target.value })); setSaved(false); setError(null); },
-        }))),
-      h(GlobalButton, { type: 'submit', kind: 'primary', disabled: phase !== 'ready' }, phase === 'saving' ? '保存中…' : '保存图片设置'),
-      phase === 'error' ? h(GlobalButton, { onClick: () => void load() }, '重试') : null),
-    error ? h('p', { role: 'alert' }, error) : null,
-    saved ? h('p', { role: 'status' }, '已保存') : null,
-    phase === 'loading' ? h('p', { role: 'status' }, '正在读取图片设置…') : null);
+      h('div', { className: 'dim-imageSettingsFields' },
+        ...fields.map(([key, label]) => h('div', { className: 'dim-imageSettingsField', key },
+          h('label', { htmlFor: `${id}-${key}` }, label),
+          h('input', { id: `${id}-${key}`, className: 'dim-globalTtlInput', type: 'number', min: 1, step: 1,
+            value: values[key], disabled: phase !== 'ready',
+            onChange: (event) => { setValues((current) => ({ ...current, [key]: event.target.value })); setSaved(false); setError(null); },
+          })))),
+      h('div', { className: 'dim-imageSettingsActions' },
+        h(GlobalButton, { type: 'submit', kind: 'primary', className: 'dim-globalSaveButton', disabled: phase !== 'ready' }, phase === 'saving' ? '保存中…' : '保存图片设置'),
+        phase === 'error' ? h(GlobalButton, { className: 'dim-globalSaveButton', onClick: () => void load() }, '重试') : null)),
+    error ? h('p', { className: 'dim-globalInline dim-imageSettingsFeedback', 'data-tone': 'error', role: 'alert' }, error) : null,
+    saved ? h('p', { className: 'dim-globalInline dim-imageSettingsFeedback', role: 'status' }, '已保存') : null,
+    phase === 'loading' ? h('p', { className: 'dim-globalInline dim-imageSettingsFeedback', role: 'status' }, '正在读取图片设置…') : null);
 }
 
 export function GlobalSettingsPanel({ rpcCall }) {

package/plugin-src/client/i18n.js

@@ -108,6 +108,10 @@ const EN = Object.freeze({
   '当前版本': 'Current version',
   'DSH-IM 更新': 'DSH-IM update',
   '检查更新': 'Check for updates',
+  'DSH 版本兼容说明': 'DSH version compatibility',
+  'dsh-im 4.25.0 支持到 DSH v0.1.6-alpha.2。': 'dsh-im 4.25.0 supports DSH up to v0.1.6-alpha.2.',
+  'dsh-im 4.26.0 仅支持 DSH v0.1.7-alpha.1。': 'dsh-im 4.26.0 only supports DSH v0.1.7-alpha.1.',
+  '升级到 dsh-im 4.26.0 前，请先将 DSH 升级到 v0.1.7-alpha.1；使用旧版 DSH 请保留 dsh-im 4.25.0。': 'Before updating to dsh-im 4.26.0, upgrade DSH to v0.1.7-alpha.1. If you use an older DSH version, stay on dsh-im 4.25.0.',
   '重新检查': 'Check again',
   '刷新状态': 'Refresh status',
   '手工更新': 'Manual update',
@@ -671,6 +675,22 @@ const EN = Object.freeze({
   'Gateway 长连接': 'Gateway persistent connection',
   ' Socket Mode 长连接': ' Socket Mode persistent connection',
   'Socket Mode 长连接': 'Socket Mode persistent connection',
+  ' CS API 长轮询': ' CS API long polling',
+  'CS API 长轮询': 'CS API long polling',
+  '接入 Matrix 机器人': 'Connect a Matrix bot',
+  '连接你的 Matrix homeserver': 'Connect your Matrix homeserver',
+  '填写 homeserver 地址，并提供访问令牌，或者用户 ID 与密码的组合。机器人只访问该 homeserver，不连接第三方服务器。':
+    'Enter the homeserver URL plus an access token, or a user id with a password. The bot only talks to that homeserver and never to third-party servers.',
+  'Homeserver 地址': 'Homeserver URL',
+  '访问令牌（与用户 ID、密码二选一）': 'Access token (or user id + password)',
+  '用户 ID（可选）': 'User id (optional)',
+  '密码（可选）': 'Password (optional)',
+  '访问令牌来自 Element 设置 → 帮助 → 编辑设置，或 homeserver 的登录接口；用户 ID 与密码方式会为本安装派生稳定设备会话。':
+    'The access token comes from Element settings → Help → Advanced settings, or from the homeserver login API; the user id and password flow derives a stable device session for this installation.',
+  '填写 homeserver 地址与访问令牌，或者用户 ID 与密码，即可让机器人以 CS API 长轮询接收消息并以富文本回复。':
+    'Enter the homeserver URL with an access token, or a user id with a password, and the bot receives messages over the CS API long poll and replies with rich text.',
+  '使用 homeserver 与凭据接入 Matrix 机器人': 'Connect a Matrix bot with the homeserver and credentials',
+  '访问令牌或用户 ID 与密码': 'access token or user id with password',
   '接入 Telegram 机器人': 'Connect a Telegram bot',
   '先通过 @BotFather 获取 Bot Token，再在这里完成接入。': 'Get a Bot Token from @BotFather, then connect it here.',
   '填写 @BotFather 生成的 Bot Token': 'Enter the Bot Token from @BotFather',

package/plugin-src/client/index.js

@@ -15,6 +15,7 @@ import {
   WhatsappLogoGlyph,
   IMessageLogoGlyph,
   EmailLogoGlyph,
+  MatrixLogoGlyph,
 } from './channel-logos.js';
 import { DINGTALK_RPC_CHANNEL } from './channels/dingtalk/api.js';
 import { DingtalkSettingsTab } from './channels/dingtalk/index.js';
@@ -54,6 +55,9 @@ import { IMessageSettingsTab } from './channels/imessage/index.js';
 import { EmailSettingsTab, useEmailChannelEnabled } from './channels/email/index.js';
 import { installIMessageStyles } from './channels/imessage/styles.js';
 import { installEmailStyles } from './channels/email/styles.js';
+import { MATRIX_RPC_CHANNEL } from './channels/matrix/api.js';
+import { MatrixSettingsTab } from './channels/matrix/index.js';
+import { installMatrixStyles } from './channels/matrix/styles.js';
 import { en, h, IM_LOCALE_NAMESPACE, setImTranslator, zh } from './i18n.js';
 import {
   HOST_LANGUAGE_RPC_CHANNEL,
@@ -107,6 +111,7 @@ const CHANNELS = Object.freeze([
   { id: 'wecomApp', label: '企业微信应用', note: '（实验功能）' },
   { id: 'imessage', label: 'iMessage', note: '（实验功能）' },
   { id: 'email', label: '邮箱', note: '（实验功能）' },
+  { id: 'matrix', label: 'Matrix', note: '（实验功能）' },
   { id: 'office', label: 'AI Office', note: '（实验功能）' },
 ]);
 
@@ -167,6 +172,11 @@ function EmailLogo() {
     h(EmailLogoGlyph));
 }
 
+function MatrixLogo() {
+  return h('span', { className: 'dim-logo dim-logoMatrix', 'aria-hidden': 'true' },
+    h(MatrixLogoGlyph));
+}
+
 function OfficeLogo() {
   return h('span', { className: 'dim-logo dim-logoOffice', 'aria-hidden': 'true' },
     h(OfficeLogoGlyph));
@@ -185,6 +195,7 @@ function ChannelLogo({ channel }) {
   if (channel === 'whatsapp') return h(WhatsappLogo);
   if (channel === 'imessage') return h(IMessageLogo);
   if (channel === 'email') return h(EmailLogo);
+  if (channel === 'matrix') return h(MatrixLogo);
   return h(OfficeLogo);
 }
 
@@ -210,6 +221,7 @@ export function IMSettingsTab({
   feishuRpcCall,
   imessageRpcCall,
   emailRpcCall,
+  matrixRpcCall,
   qqRpcCall,
   slackRpcCall,
   telegramRpcCall,
@@ -275,6 +287,7 @@ export function IMSettingsTab({
     globalSettingsRpcCall,
     imessageRpcCall,
     emailRpcCall,
+    matrixRpcCall,
   }, {
     location: browserLocation,
     onRecovery: reportLoopbackRecovery,
@@ -287,6 +300,7 @@ export function IMSettingsTab({
     globalSettingsRpcCall,
     imessageRpcCall,
     emailRpcCall,
+    matrixRpcCall,
     officeRpcCall,
     qqRpcCall,
     reportLoopbackRecovery,
@@ -427,6 +441,8 @@ export function IMSettingsTab({
                             ? h(IMessageSettingsTab, { rpcCall: rpcCalls.imessageRpcCall })
                           : active.id === 'email'
                             ? h(EmailSettingsTab, { rpcCall: rpcCalls.emailRpcCall })
+                          : active.id === 'matrix'
+                            ? h(MatrixSettingsTab, { rpcCall: rpcCalls.matrixRpcCall })
                           : h(OfficeSettingsTab, { rpcCall: rpcCalls.officeRpcCall }))),
     ),
   ));
@@ -466,6 +482,7 @@ export function apply(ctx) {
       installWhatsappStyles(),
       installIMessageStyles(),
       installEmailStyles(),
+      installMatrixStyles(),
       installOfficeStyles(),
       installImStyles(),
     ];
@@ -496,6 +513,8 @@ export function apply(ctx) {
     callManagementRpc(ctx.connection, IMESSAGE_RPC_CHANNEL, endpoint, payload, signal);
   const emailRpcCall = (endpoint, payload, signal) =>
     callManagementRpc(ctx.connection, EMAIL_RPC_CHANNEL, endpoint, payload, signal);
+  const matrixRpcCall = (endpoint, payload, signal) =>
+    callManagementRpc(ctx.connection, MATRIX_RPC_CHANNEL, endpoint, payload, signal);
   const slackRpcCall = (endpoint, payload, signal) =>
     callManagementRpc(ctx.connection, SLACK_RPC_CHANNEL, endpoint, payload, signal);
   const officeRpcCall = (endpoint, payload, signal) =>
@@ -526,6 +545,7 @@ export function apply(ctx) {
     imessageRpcCall,
     officeRpcCall,
     emailRpcCall,
+    matrixRpcCall,
     updateRpcCall,
     deliveryRpcCall,
     globalSettingsRpcCall,

package/plugin-src/client/session-channel-logos.js

@@ -2,7 +2,7 @@ import { parseSessionChannelTitle } from '../../src/channels/shared/session-chan
 import {
   WeixinLogoGlyph, FeishuLogoGlyph, DingtalkLogoGlyph, WecomLogoGlyph, QqLogoGlyph,
   SlackLogoGlyph, TelegramLogoGlyph, DiscordLogoGlyph, WhatsappLogoGlyph, OfficeLogoGlyph,
-  IMessageLogoGlyph,
+  IMessageLogoGlyph, MatrixLogoGlyph,
 } from './channel-logos.js';
 
 const GLYPHS = Object.freeze({
@@ -16,6 +16,7 @@ const GLYPHS = Object.freeze({
   discord: [DiscordLogoGlyph, '#5865f2'],
   whatsapp: [WhatsappLogoGlyph, '#25d366'],
   imessage: [IMessageLogoGlyph, '#3478f6'],
+  matrix: [MatrixLogoGlyph, '#1a8f6f'],
   office: [OfficeLogoGlyph, '#f97316'],
 });
 const CHANNEL_ATTR = 'data-dsh-im-session-channel';

package/plugin-src/client/styles.js

@@ -60,7 +60,9 @@ const CSS = String.raw`
 .dim-updateButton:hover:not(:disabled) { border-color: #aeb3bb; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
 .dim-updateButton:focus-visible { outline: 2px solid var(--dsw-alias-state-business-primary, #3370ff); outline-offset: 2px; }
 .dim-updateButton:disabled { opacity: .55; cursor: default; }
-.dim-updateTrigger { white-space: nowrap; }
+.dim-updateAction { position: relative; display: inline-flex; flex: none; }
+.dim-updateTrigger { width: 30px; height: 30px; flex: none; padding: 0; }
+.dim-updateTrigger svg { display: block; }
 .dim-updateBackdrop { position: fixed; inset: 0; z-index: 1000; display: grid; place-items: center; padding: 24px; background: rgb(15 17 21 / 42%); }
 .dim-updateBackdrop, .dim-updateBackdrop * { box-sizing: border-box; }
 .dim-updateDialog { width: min(480px, 100%); max-height: calc(100vh - 48px); overflow-y: auto; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 16px; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-3, #fff); box-shadow: 0 20px 70px rgb(0 0 0 / 20%); text-align: left; }
@@ -97,8 +99,8 @@ const CSS = String.raw`
 .dim-githubLink svg { display: block; }
 .dim-githubLink:hover { border-color: #aeb3bb; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-interactive-bg-hover, #f7f8fa); }
 .dim-githubLink:focus-visible { outline: 2px solid color-mix(in srgb, var(--dim-blue) 70%, white); outline-offset: 2px; }
-.dim-githubTooltip { position: absolute; top: calc(100% + 8px); right: 0; z-index: 20; width: max-content; max-width: min(220px, 80vw); padding: 6px 9px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 7px; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-3, #fff); box-shadow: 0 8px 24px rgb(31 35 41 / 14%); font-size: 11px; line-height: 16px; font-weight: 500; white-space: nowrap; opacity: 0; visibility: hidden; transform: translateY(-3px); pointer-events: none; transition: opacity .15s ease, transform .15s ease, visibility .15s ease; }
-.dim-githubAction:hover .dim-githubTooltip, .dim-githubAction:focus-within .dim-githubTooltip { opacity: 1; visibility: visible; transform: translateY(0); }
+.dim-updateTooltip, .dim-githubTooltip { position: absolute; top: calc(100% + 8px); right: 0; z-index: 20; width: max-content; max-width: min(220px, 80vw); padding: 6px 9px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 7px; color: var(--dsw-alias-label-primary, #1f2329); background: var(--dsw-alias-bg-layer-3, #fff); box-shadow: 0 8px 24px rgb(31 35 41 / 14%); font-size: 11px; line-height: 16px; font-weight: 500; white-space: nowrap; opacity: 0; visibility: hidden; transform: translateY(-3px); pointer-events: none; transition: opacity .15s ease, transform .15s ease, visibility .15s ease; }
+.dim-updateAction:hover .dim-updateTooltip, .dim-updateTrigger:focus-visible + .dim-updateTooltip, .dim-githubAction:hover .dim-githubTooltip, .dim-githubAction:focus-within .dim-githubTooltip { opacity: 1; visibility: visible; transform: translateY(0); }
 .dim-generalSettingsAction { position: relative; display: inline-flex; flex: none; }
 .dim-generalSettingsButton { width: 30px; height: 30px; display: grid; place-items: center; flex: none; padding: 0; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 8px; color: var(--dsw-alias-label-secondary, #646a73); background: var(--dsw-alias-bg-layer-1, #fff); cursor: pointer; transition: border-color .15s ease, color .15s ease, background .15s ease, box-shadow .15s ease; }
 .dim-generalSettingsButton svg { display: block; }
@@ -611,6 +613,20 @@ const CSS = String.raw`
 .dim-generalSettingsTab:focus-visible { outline: 2px solid var(--dim-blue); outline-offset: -2px; border-radius: 5px; }
 .dim-generalSettingsTabPanel { min-width: 0; padding-top: 14px; }
 .dim-globalSection { min-width: 0; padding: 14px 16px; border: 1px solid var(--dsw-alias-border-l2, #dfe1e5); border-radius: 12px; background: var(--dsw-alias-bg-layer-3, #fff); }
+.dim-globalSection + .dim-globalSection { margin-top: 12px; }
+.dim-imageSettings { container-type: inline-size; }
+.dim-imageSettings .dim-globalHead { position: relative; }
+.dim-imageSettings .dim-globalTtlHelp { position: static; }
+.dim-globalTtlTooltip.dim-imageSettingsTooltip { width: min(320px, 100%); max-width: none; color: var(--dsw-alias-label-secondary, #646a73); font-size: 11px; line-height: 17px; white-space: normal; overflow-wrap: anywhere; }
+.dim-imageSettingsFields { min-width: 0; display: grid; gap: 12px; margin-top: 12px; }
+.dim-imageSettingsField { min-width: 0; display: grid; grid-template-columns: minmax(0, 220px) minmax(0, 160px); align-items: center; gap: 6px 16px; }
+.dim-imageSettingsField label { min-width: 0; color: var(--dsw-alias-label-secondary, #646a73); font-size: 13px; line-height: 20px; overflow-wrap: anywhere; }
+.dim-imageSettingsField .dim-globalTtlInput { width: 100%; min-width: 0; }
+.dim-imageSettingsActions { display: flex; align-items: center; flex-wrap: wrap; gap: 8px; margin-top: 16px; }
+.dim-globalInline.dim-imageSettingsFeedback { margin: 10px 0 0; }
+@container (max-width: 380px) {
+  .dim-imageSettingsField { grid-template-columns: minmax(0, 1fr); }
+}
 .dim-globalHead { min-width: 0; display: flex; align-items: center; }
 .dim-globalHeadTitle { min-width: 0; display: inline-flex; align-items: center; gap: 6px; }
 .dim-globalHead h3 { min-width: 0; overflow: hidden; margin: 0; color: var(--dsw-alias-label-primary, #1f2329); font-size: 15px; line-height: 22px; font-weight: 650; text-overflow: ellipsis; white-space: nowrap; }

package/plugin-src/client/update-panel.js

@@ -3,7 +3,7 @@ import { createPortal } from 'react-dom';
 import validSemver from 'semver/functions/valid.js';
 import compareVersionsDescending from 'semver/functions/rcompare.js';
 
-import { h } from './i18n.js';
+import { h, localizeText } from './i18n.js';
 import { createPollScheduler } from './lifecycle.js';
 
 export const UPDATE_RPC_CHANNEL = '/dsh-im';
@@ -240,6 +240,7 @@ function UpdateDialog({ children, onClose }) {
 }
 
 export function UpdatePanel({ rpcCall, clientVersion, onStatus }) {
+  const tooltipId = React.useId();
   const [snapshot, setSnapshot] = React.useState(null);
   const [action, setAction] = React.useState('status');
   const [error, setError] = React.useState(null);
@@ -409,19 +410,32 @@ export function UpdatePanel({ rpcCall, clientVersion, onStatus }) {
       : restartRequired ? '待手动重启'
         : snapshot?.canInstall ? '更新至'
           : '检查更新';
+  const buttonDescription = localizeText(buttonLabel) + (buttonLabel === '更新至' ? ` v${snapshot.latestVersion}` : '');
 
   return h(React.Fragment, null,
-    h('button', {
-      type: 'button',
-      className: 'dim-updateButton dim-updateTrigger',
-      disabled: busyAction,
-      'aria-haspopup': 'dialog',
-      onClick: () => {
-        setOpen(true);
-        if (restartRequired) void refreshStatus();
-        else if (!snapshot?.canInstall && !activeJob && !uncertainInstall) void check();
+    h('span', { className: 'dim-updateAction' },
+      h('button', {
+        type: 'button',
+        className: 'dim-updateButton dim-updateTrigger',
+        disabled: busyAction,
+        'aria-label': buttonDescription,
+        'aria-describedby': tooltipId,
+        'aria-haspopup': 'dialog',
+        onClick: () => {
+          setOpen(true);
+          if (restartRequired) void refreshStatus();
+          else if (!snapshot?.canInstall && !activeJob && !uncertainInstall) void check();
+        },
+      }, h('svg', {
+        width: 18, height: 18, viewBox: '0 0 24 24', fill: 'none',
+        stroke: 'currentColor', strokeWidth: 2.3, strokeLinecap: 'round', strokeLinejoin: 'round',
+        focusable: 'false', 'aria-hidden': 'true',
       },
-    }, buttonLabel, buttonLabel === '更新至' ? ` v${snapshot.latestVersion}` : null),
+      h('path', { d: 'M3 12a9 9 0 0 1 15.36-6.36L21 8' }),
+      h('path', { d: 'M21 3v5h-5' }),
+      h('path', { d: 'M21 12a9 9 0 0 1-15.36 6.36L3 16' }),
+      h('path', { d: 'M8 16H3v5' }))),
+      h('span', { id: tooltipId, className: 'dim-updateTooltip', role: 'tooltip' }, buttonDescription)),
     open ? h(UpdateDialog, { onClose: () => setOpen(false) },
       h('div', { className: 'dim-updateBody' },
         h('dl', { className: 'dim-updateVersions' },
@@ -453,6 +467,12 @@ export function UpdatePanel({ rpcCall, clientVersion, onStatus }) {
         versionsDiffer && !restartRequired ? h('p', { className: 'dim-updateHint' }, '页面版本与运行版本不同，请手动刷新页面；若仍不一致，请手动重启 Harness 或 Desktop。') : null,
         canConfirm ? h('p', { className: 'dim-updateHint' },
           '请在机器人空闲时安装；安装会修改当前 profile 的依赖，完成后需手动重启。') : null,
+        h('aside', { className: 'dim-updateHint', 'aria-label': 'DSH 版本兼容说明' },
+          h('strong', null, 'DSH 版本兼容说明'),
+          h('p', { className: 'dim-updateManualHint' }, 'dsh-im 4.25.0 支持到 DSH v0.1.6-alpha.2。'),
+          h('p', { className: 'dim-updateManualHint' }, 'dsh-im 4.26.0 仅支持 DSH v0.1.7-alpha.1。'),
+          h('p', { className: 'dim-updateManualHint' },
+            '升级到 dsh-im 4.26.0 前，请先将 DSH 升级到 v0.1.7-alpha.1；使用旧版 DSH 请保留 dsh-im 4.25.0。')),
         h(ManualUpdateCommand, {
           key: manualCommand ?? 'unavailable', command: manualCommand,
           disabled: busyAction || activeJob || uncertainInstall,

package/plugin-src/host/channels/matrix/index.mjs

@@ -0,0 +1,31 @@
+import { createProductionController } from './production.mjs';
+import { createMatrixRpcHandler, installMatrixRpc, MATRIX_RPC_CHANNEL } from './rpc.mjs';
+import { installProductionChannel } from '../shared/startup.mjs';
+
+export const name = 'dsh-im-matrix-host';
+export const inject = ['connection', 'credentials', 'typertGateway'];
+
+export async function apply(ctx, config = {}) {
+  if (config?.controller) return installMatrixRpc(ctx, config.controller, config.rpcAuthority);
+  return installProductionChannel(ctx, config, {
+    channel: 'matrix',
+    rpcChannel: MATRIX_RPC_CHANNEL,
+    createProduction: () => createProductionController(ctx, config, config.internals ?? {}),
+    createHandler: controller => createMatrixRpcHandler(controller),
+  });
+}
+
+export function createMatrixHostPlugin(config) {
+  return Object.freeze({ name, inject, apply: (ctx) => apply(ctx, config) });
+}
+
+export { createProductionController } from './production.mjs';
+export {
+  MATRIX_ENDPOINTS,
+  MATRIX_RPC_CHANNEL,
+  MATRIX_RPC_ENDPOINTS,
+  createMatrixRpcHandler,
+  installMatrixRpc,
+} from './rpc.mjs';
+export { MatrixController } from '../../../../src/channels/matrix/matrix-controller.mjs';
+export { MatrixRuntime } from '../../../../src/channels/matrix/matrix-runtime.mjs';