@xmanrui/dsh-im 4.14.0 → 4.16.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "4.14.0",
-  "description": "把九种 IM 机器人和公网 AI Office 接入本机 DeepSeek Harness。 Connect nine IM channels and a public AI Office to a local DeepSeek Harness.",
+  "version": "4.16.0",
+  "description": "把十种 IM 机器人和公网 AI Office 接入本机 DeepSeek Harness。 Connect ten IM channels and a public AI Office to a local DeepSeek Harness.",
   "keywords": [
     "deepseek-harness",
     "dsh",
@@ -35,6 +35,10 @@
     {
       "name": "Chan-0312",
       "url": "https://github.com/Chan-0312"
+    },
+    {
+      "name": "BuvkB",
+      "url": "https://github.com/BuvkB"
     }
   ],
   "license": "MIT",

package/plugin-src/client/access-policy-settings.js

@@ -33,6 +33,12 @@ export const ACCESS_CHANNEL_DEFINITIONS = Object.freeze({
     groupUserLabel: '群成员用户 ID',
     groupPlaceholder: '填写 userid',
   }),
+  wecomApp: Object.freeze({
+    directUserLabel: '企业微信用户 ID',
+    directPlaceholder: '填写 userid',
+    groupUserLabel: '群成员用户 ID',
+    groupPlaceholder: '填写 userid',
+  }),
   qq: Object.freeze({
     directUserLabel: 'QQ User Open ID',
     directPlaceholder: '填写 user_openid',

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

@@ -310,7 +310,7 @@ function QrPane({ provision, now, onRefresh, onCancel, busy }) {
               ? "使用飞书确认群消息权限"
               : "使用飞书扫码创建机器人"),
         h("p", null, repairing
-          ? "扫码会更新现有飞书应用，增量补充当前缺少的卡片按钮回调、读取用户消息内图片或文件所需的 im:message:readonly（飞书显示为“获取单聊、群组消息”）、上传机器人图片或文件所需的 im:resource，以及原生命令面板所需的 application:app_slash_command:read / write；不会创建新应用。确认页只显示当前缺少项，完成后此机器人会短暂重连，其他机器人不受影响。"
+          ? "扫码会更新现有飞书应用，增量补充当前缺少的卡片按钮回调、读取用户消息内图片或文件所需的 im:message:readonly（飞书显示为“获取单聊、群组消息”）、上传机器人图片或文件所需的 im:resource、接收群内其他机器人 @ 当前机器人所需的 im:message.group_at_msg.include_bot:readonly，以及原生命令面板所需的 application:app_slash_command:read / write；不会创建新应用。确认页只显示当前缺少项，完成后此机器人会短暂重连，其他机器人不受影响。"
           : grantingGroupMessages
             ? "扫码会更新现有飞书应用，只增量开通“获取群组中所有消息”权限；不会创建新应用。确认后会自动启用“响应所有群消息”，其他机器人不受影响。"
             : "扫码只会新增一个机器人，已接入的机器人会继续正常收发消息。"),
@@ -467,6 +467,7 @@ function RemoveConfirmation({ bot, busy, onConfirm, onCancel }) {
 /** Toggle row for 分步直推, mirroring the group-topic reply toggle pattern. */
 function StepPushEditor({ value = false, disabled = false, onSave }) {
   const titleId = React.useId();
+  const helpId = `${titleId}-help`;
   const current = value === true ? "on" : "off";
   const [saving, setSaving] = React.useState(false);
   const [error, setError] = React.useState(null);
@@ -490,7 +491,20 @@ function StepPushEditor({ value = false, disabled = false, onSave }) {
     "aria-labelledby": titleId,
   },
   h("div", { className: "dim-feishuGroupControlHeader" },
-    h("h3", { id: titleId }, "分步直推"),
+    h("div", { className: "dim-presetTitle" },
+      h("h3", { id: titleId }, "分步直推"),
+      h("span", { className: "dim-presetHelp" },
+        h("button", {
+          type: "button",
+          className: "dim-presetHelpButton",
+          "aria-label": "查看分步直推说明",
+          "aria-describedby": helpId,
+        }, h("span", { "aria-hidden": "true" }, "?")),
+        h("span", {
+          id: helpId,
+          className: "dim-presetTooltip",
+          role: "tooltip",
+        }, "开启后逐步推送工具调用与过程说明"))),
     saving
       ? h("span", { className: "dim-feishuGroupControlStatus", role: "status" }, "保存中…")
       : null),
@@ -503,8 +517,6 @@ function StepPushEditor({ value = false, disabled = false, onSave }) {
   },
   h("option", { value: "off" }, "关闭（保持流式卡模式）"),
   h("option", { value: "on" }, "开启（逐步推送工具调用与过程说明）")),
-  h("p", { className: "dim-feishuGroupHelp" },
-    "开启后逐步推送工具调用与过程说明"),
   error ? h("p", {
     className: "dim-feishuGroupError",
     role: "alert",

package/plugin-src/client/channels/wecom-app/api.js

@@ -0,0 +1,124 @@
+import { normalizeAgentPresetCatalog, normalizeAgentPresetId, SET_AGENT_PRESET_ENDPOINT } from '../../agent-preset.js';
+import { normalizeModelCatalog, normalizeModelSelection, SET_MODEL_ENDPOINT } from '../../model-setting.js';
+import { normalizeLastMessageError } from '../../last-message-error.js';
+import { normalizeAccessPolicy } from '../../../../src/channels/shared/access-policy.mjs';
+import { normalizeContextEnhancementConfig } from '../../../../src/channels/shared/context-enhancement.mjs';
+
+export const WECOM_APP_RPC_CHANNEL = '/wecom-app';
+
+export const WECOM_APP_ENDPOINTS = Object.freeze({
+  status: 'connection.status',
+  bindApp: 'bot.bind',
+  updateSettings: 'bot.settings.update',
+  resetCallbackSecret: 'bot.callback-secret.reset',
+  reconnectBot: 'bot.reconnect',
+  deleteBot: 'bot.delete',
+  setWorkspace: 'bot.workspace.set',
+  setModel: SET_MODEL_ENDPOINT,
+  setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
+  setContextEnhancement: 'bot.context-enhancement.set',
+  setAccessPolicy: 'bot.access-policy.set',
+});
+
+const ACCOUNT_STATES = new Set(['connected', 'connecting', 'offline', 'error']);
+
+function isRecord(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+
+function text(value, fallback, max = 240) {
+  return typeof value === 'string' && value.trim() ? value.trim().slice(0, max) : fallback;
+}
+
+function id(value) {
+  const result = text(value, '', 128);
+  return /^[a-z\d_-]+$/i.test(result) ? result : undefined;
+}
+
+function optionalUrl(value) {
+  const raw = text(value, '', 512);
+  return /^https?:\/\//iu.test(raw) ? raw : null;
+}
+
+function timestamp(value) {
+  if (typeof value === 'number' && Number.isFinite(value)) return value;
+  const parsed = typeof value === 'string' ? Date.parse(value) : Number.NaN;
+  return Number.isNaN(parsed) ? undefined : parsed;
+}
+
+function normalizeTestMessage(value) {
+  if (!isRecord(value)) return null;
+  if (value.sent === true) return { sent: true };
+  if (value.sent !== false) return null;
+  const code = value.code === 'test-target-unavailable'
+    ? 'test-target-unavailable'
+    : 'test-message-failed';
+  return { sent: false, code };
+}
+
+export function unwrapRpcResult(result) {
+  if (!isRecord(result) || typeof result.ok !== 'boolean') throw new Error('企业微信应用服务返回了无法识别的响应');
+  if (!result.ok) {
+    const error = new Error(text(result.error?.message, '企业微信应用操作失败'));
+    error.code = text(result.error?.code, 'WECOM_APP_RPC_ERROR', 80);
+    throw error;
+  }
+  return result.value;
+}
+
+function normalizeBot(value) {
+  if (!isRecord(value) || !id(value.botId)) return undefined;
+  const connected = value.connected === true;
+  const state = ACCOUNT_STATES.has(value.state) ? value.state : 'offline';
+  return {
+    botId: id(value.botId),
+    connected,
+    state: connected ? 'connected' : state,
+    workspace: text(value.workspace, '', 4_096),
+    model: normalizeModelSelection(value.model),
+    agentPreset: normalizeAgentPresetId(value.agentPreset),
+    contextEnhancement: normalizeContextEnhancementConfig(value.contextEnhancement),
+    ...(Object.hasOwn(value, 'accessPolicy')
+      ? { accessPolicy: normalizeAccessPolicy(value.accessPolicy) }
+      : {}),
+    bot: {
+      name: text(value.bot?.name, '企业微信应用', 100),
+      corpIdMasked: text(value.bot?.corpIdMasked, '企业 ID 已保存', 140),
+      agentId: text(value.bot?.agentId, '', 32),
+      apiBaseUrl: optionalUrl(value.bot?.apiBaseUrl) ?? '',
+      callbackBaseUrl: optionalUrl(value.bot?.callbackBaseUrl) ?? '',
+      streamEnabled: value.bot?.streamEnabled !== false,
+      callbackUrl: optionalUrl(value.bot?.callbackUrl) ?? '',
+    },
+    health: {
+      summary: text(value.health?.summary, connected ? '企业微信应用回调通道就绪' : '企业微信应用连接尚未就绪'),
+      lastCheckedAt: timestamp(value.health?.lastCheckedAt),
+    },
+    lastMessageError: normalizeLastMessageError(value.lastMessageError),
+    error: isRecord(value.error) ? {
+      code: text(value.error.code, 'WECOM_APP_ACCOUNT_ERROR', 80),
+      message: text(value.error.message, '企业微信应用连接尚未就绪'),
+    } : null,
+  };
+}
+
+export function normalizeSnapshot(value) {
+  const source = isRecord(value?.snapshot) ? value.snapshot : value;
+  if (!isRecord(source) || !Array.isArray(source.bots)) throw new Error('企业微信应用服务没有返回有效的机器人列表');
+  const bots = source.bots.map(normalizeBot).filter(Boolean);
+  return {
+    revision: Number.isSafeInteger(source.revision) ? source.revision : 0,
+    bots,
+    totals: { configured: bots.length, connected: bots.filter((bot) => bot.connected).length },
+    testMessage: normalizeTestMessage(source.testMessage),
+    agentPresetCatalog: normalizeAgentPresetCatalog(source.agentPresetCatalog),
+    modelCatalog: normalizeModelCatalog(source.modelCatalog),
+  };
+}
+
+export function presentError(error) {
+  return {
+    code: text(error?.code, 'WECOM_APP_ERROR', 80),
+    message: text(error?.message, '企业微信应用操作失败，请稍后重试'),
+  };
+}