@xmanrui/dsh-im 0.1.0

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@xmanrui/dsh-im",
+  "version": "0.1.0",
+  "description": "通过扫码或机器人凭据把IM机器人接入DeepSeek Harness（支持飞书、微信、钉钉、企业微信、QQ、Telegram和Discord）。",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xmanrui/dsh-im.git"
+  },
+  "homepage": "https://github.com/xmanrui/dsh-im#readme",
+  "bugs": "https://github.com/xmanrui/dsh-im/issues",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "dsh-im": "./bin/dsh-im.mjs"
+  },
+  "main": "./lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "bin",
+    "cordis.patch.yml",
+    "lib",
+    "plugin-src",
+    "scripts",
+    "src",
+    "LICENSE",
+    "README.md",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-locale"
+      ],
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "build": "node plugin-src/client/build.mjs && node plugin-src/host/build.mjs",
+    "test": "node --test test/*.test.mjs test/channels/*/*.test.mjs",
+    "check": "npm test && npm run build && node scripts/verify-package.mjs"
+  },
+  "engines": {
+    "node": ">=22.19"
+  },
+  "dependencies": {
+    "@larksuiteoapi/node-sdk": "1.73.0",
+    "@tencent-connect/qqbot-connector": "1.2.0",
+    "@tencent-connect/qqbot-nodejs": "1.0.4",
+    "@wecom/aibot-node-sdk": "1.0.7",
+    "dingtalk-stream": "2.1.4",
+    "qrcode": "1.5.4"
+  },
+  "devDependencies": {
+    "esbuild": "0.25.9",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "react-test-renderer": "18.3.1"
+  }
+}

package/plugin-src/client/build.mjs

@@ -0,0 +1,38 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { build } from 'esbuild';
+
+const sourceDirectory = dirname(fileURLToPath(import.meta.url));
+const packageRoot = resolve(sourceDirectory, '../..');
+const outputPath = resolve(packageRoot, 'lib/client.js');
+const loaderId = process.env.DSH_IM_CLIENT_ID ?? '@xmanrui/dsh-im';
+
+const result = await build({
+  entryPoints: [resolve(sourceDirectory, 'index.js')],
+  bundle: true,
+  format: 'cjs',
+  platform: 'browser',
+  target: ['chrome100'],
+  external: ['react'],
+  write: false,
+  minify: process.env.NODE_ENV === 'production',
+  legalComments: 'none',
+});
+const bundled = result.outputFiles?.[0]?.text;
+if (!bundled) throw new Error('esbuild did not produce a client bundle');
+
+const wrapped = `window.__ModuleLoader__.load({
+  id: ${JSON.stringify(loaderId)},
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+${bundled}
+    return module.exports;
+  }
+});
+`;
+await mkdir(dirname(outputPath), { recursive: true });
+await writeFile(outputPath, wrapped, 'utf8');
+console.log(`Wrote ${outputPath}`);

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

@@ -0,0 +1,107 @@
+import * as React from 'react';
+
+const h = React.createElement;
+
+function dimensions(size) {
+  return size === undefined ? {} : { width: size, height: size };
+}
+
+export function WeixinLogoGlyph({ size } = {}) {
+  return h('svg', {
+    ...dimensions(size),
+    viewBox: '0 0 24 24',
+    focusable: 'false',
+    'aria-hidden': 'true',
+    'data-im-channel-logo': 'weixin',
+  }, h('path', {
+    fill: 'currentColor',
+    d: 'M8.691 2.188C3.891 2.188 0 5.476 0 9.53c0 2.212 1.17 4.203 3.002 5.55a.59.59 0 0 1 .213.665l-.39 1.48c-.019.07-.048.141-.048.213 0 .163.13.295.29.295a.326.326 0 0 0 .167-.054l1.903-1.114a.864.864 0 0 1 .717-.098 10.16 10.16 0 0 0 2.837.403c.276 0 .543-.027.811-.05-.857-2.578.157-4.972 1.932-6.446 1.703-1.415 3.882-1.98 5.853-1.838-.576-3.583-4.196-6.348-8.596-6.348zM5.785 5.991c.642 0 1.162.529 1.162 1.18a1.17 1.17 0 0 1-1.162 1.178A1.17 1.17 0 0 1 4.623 7.17c0-.651.52-1.18 1.162-1.18zm5.813 0c.642 0 1.162.529 1.162 1.18a1.17 1.17 0 0 1-1.162 1.178 1.17 1.17 0 0 1-1.162-1.178c0-.651.52-1.18 1.162-1.18zm5.34 2.867c-1.797-.052-3.746.512-5.28 1.786-1.72 1.428-2.687 3.72-1.78 6.22.942 2.453 3.666 4.229 6.884 4.229.826 0 1.622-.12 2.361-.336a.722.722 0 0 1 .598.082l1.584.926a.272.272 0 0 0 .14.047c.134 0 .24-.111.24-.247 0-.06-.023-.12-.038-.177l-.327-1.233a.582.582 0 0 1-.023-.156.49.49 0 0 1 .201-.398C23.024 18.48 24 16.82 24 14.98c0-3.21-2.931-5.837-6.656-6.088V8.89c-.135-.01-.27-.027-.407-.03zm-2.53 3.274c.535 0 .969.44.969.982a.976.976 0 0 1-.969.983.976.976 0 0 1-.969-.983c0-.542.434-.982.97-.982zm4.844 0c.535 0 .969.44.969.982a.976.976 0 0 1-.969.983.976.976 0 0 1-.969-.983c0-.542.434-.982.969-.982z',
+  }));
+}
+
+export function FeishuLogoGlyph({ size } = {}) {
+  return h('svg', {
+    ...dimensions(size),
+    viewBox: '0 0 24 24',
+    focusable: 'false',
+    'aria-hidden': 'true',
+    'data-im-channel-logo': 'feishu',
+  },
+  h('path', { fill: '#00D6B9', d: 'M7.2 4.5h7.6c1.2 0 2.1.55 2.7 1.58 1.05 1.8 1.55 3.45 1.58 4.95-2.04-.62-4.2-.15-6.22 1.45C11.3 9.7 9.42 7.04 7.2 4.5Z' }),
+  h('path', { fill: '#1456B8', d: 'M10.8 13.55c3.3-2.93 5.72-4.24 9.47-2.52-1.2 1.45-2.27 4.18-3.86 5.43-1.67 1.31-3.9.5-5.61-.64v-2.27Z' }),
+  h('path', { fill: '#3370FF', d: 'M4.4 8.35c3.47 3.61 7.25 6.1 10.33 5.7 1.06-.14 2.2-.72 3.4-1.72-1.04 2.65-2.6 4.8-5.06 6-2.46 1.2-5.56.52-7.42-.72A2.76 2.76 0 0 1 4.4 15.3V8.35Z' }));
+}
+
+export function DingtalkLogoGlyph({ size } = {}) {
+  return h('svg', {
+    ...dimensions(size),
+    viewBox: '0 0 48 48',
+    focusable: 'false',
+    'aria-hidden': 'true',
+    'data-im-channel-logo': 'dingtalk',
+  }, h('path', {
+    fill: 'currentColor',
+    d: 'M37.05 22.783c-6.758-5.216-14.378-12.128-22.73-19.538-.655-.585-1.242-.354-1.536.42-1.88 4.973-.058 9.386 2.889 11.932s7.368 4.912 10.058 6.155c.105.049.013.203-.093.163-4.953-2.182-8.397-3.765-13.07-7.368-.497-.388-1.01-.242-1.07.521-.384 4.748 2.657 8.483 6.058 9.745 2.1.781 4.398 1.212 6.53 1.474.109.015.084.178-.027.178-2.747.01-6.058-.654-8.935-1.751-.606-.233-.818.25-.722.633.491 2.008 2.974 5.076 6.926 5.73a12 12 0 0 0 2.228.115c.164 0 .208.089.154.217q-2.685 4.6-2.803 4.797c-.091.152-.036.275.156.275h3.543c.164 0 .264.106.18.246l-4.958 8.196c-.191.328.035.565.395.301s15.212-11.133 15.636-11.448c.195-.142.148-.327-.124-.327h-3.18c-.206 0-.252-.14-.111-.28.14-.141 3.602-3.594 4.837-4.888 1.283-1.35 1.938-3.825-.231-5.498',
+  }));
+}
+
+export function QqLogoGlyph({ size } = {}) {
+  return h('svg', {
+    ...dimensions(size),
+    viewBox: '0 0 24 24',
+    focusable: 'false',
+    'aria-hidden': 'true',
+    'data-im-channel-logo': 'qq',
+  }, h('path', {
+    fill: 'currentColor',
+    d: 'M21.395 15.035a40 40 0 0 0-.803-2.264l-1.079-2.695c.001-.032.014-.562.014-.836C19.526 4.632 17.351 0 12 0S4.474 4.632 4.474 9.241c0 .274.013.804.014.836l-1.08 2.695a39 39 0 0 0-.802 2.264c-1.021 3.283-.69 4.643-.438 4.673.54.065 2.103-2.472 2.103-2.472 0 1.469.756 3.387 2.394 4.771-.612.188-1.363.479-1.845.835-.434.32-.379.646-.301.778.343.578 5.883.369 7.482.189 1.6.18 7.14.389 7.483-.189.078-.132.132-.458-.301-.778-.483-.356-1.233-.646-1.846-.836 1.637-1.384 2.393-3.302 2.393-4.771 0 0 1.563 2.537 2.103 2.472.251-.03.581-1.39-.438-4.673',
+  }));
+}
+
+export function WecomLogoGlyph({ size } = {}) {
+  return h('svg', {
+    ...dimensions(size),
+    viewBox: '0 0 24 24',
+    focusable: 'false',
+    'aria-hidden': 'true',
+    'data-im-channel-logo': 'wecom',
+  },
+  h('path', {
+    fill: 'none',
+    stroke: '#3370FF',
+    strokeWidth: '2.35',
+    strokeLinecap: 'round',
+    strokeLinejoin: 'round',
+    d: 'M17.7 14.5c1.05-1.12 1.65-2.52 1.65-4.03 0-3.82-3.58-6.92-8-6.92s-8 3.1-8 6.92 3.58 6.92 8 6.92c1.17 0 2.28-.22 3.28-.62',
+  }),
+  h('path', { fill: '#07C160', d: 'M16.1 15.15c.7-.7 1.83-.7 2.53 0s.7 1.83 0 2.53-1.83.7-2.53 0-.7-1.83 0-2.53Z' }),
+  h('path', { fill: '#FFB800', d: 'M19.25 13.45a1.36 1.36 0 1 1 1.92 1.92 1.36 1.36 0 0 1-1.92-1.92Z' }),
+  h('path', { fill: '#FF7A00', d: 'M19.55 18.05a1.16 1.16 0 1 1 1.64 1.64 1.16 1.16 0 0 1-1.64-1.64Z' }),
+  h('path', { fill: '#3370FF', d: 'M15.25 18.75a.92.92 0 1 1 1.3 1.3.92.92 0 0 1-1.3-1.3Z' }));
+}
+
+export function TelegramLogoGlyph({ size } = {}) {
+  return h('svg', {
+    ...dimensions(size),
+    viewBox: '0 0 24 24',
+    focusable: 'false',
+    'aria-hidden': 'true',
+    'data-im-channel-logo': 'telegram',
+  }, h('path', {
+    fill: 'currentColor',
+    d: 'M23.95 4.57c-.36-1.45-1.43-1.76-2.82-1.24L1.5 10.9c-1.34.52-1.32 1.27-.24 1.6l5.03 1.57 11.66-7.36c.55-.34 1.05-.16.64.21l-9.44 8.52-.37 5.12c.54 0 .78-.24 1.08-.53l2.59-2.51 5.38 3.97c.99.55 1.7.27 1.95-.92L23.95 4.57Z',
+  }));
+}
+
+export function DiscordLogoGlyph({ size } = {}) {
+  return h('svg', {
+    ...dimensions(size),
+    viewBox: '0 0 24 24',
+    focusable: 'false',
+    'aria-hidden': 'true',
+    'data-im-channel-logo': 'discord',
+  }, h('path', {
+    fill: 'currentColor',
+    d: 'M20.32 4.37a19.8 19.8 0 0 0-4.89-1.51c-.21.38-.46.89-.63 1.29a18.4 18.4 0 0 0-5.59 0 13 13 0 0 0-.64-1.29c-1.71.29-3.36.8-4.89 1.52C.59 9.09-.25 13.68.17 18.2a19.9 19.9 0 0 0 6 3.04c.48-.66.91-1.36 1.28-2.1-.7-.26-1.37-.58-2-.96.17-.12.33-.25.49-.38 3.86 1.79 8.04 1.79 11.86 0 .16.13.32.26.49.38-.64.38-1.31.7-2.01.97.37.73.8 1.44 1.28 2.09a19.8 19.8 0 0 0 6-3.04c.49-5.24-.84-9.79-3.24-13.83ZM8.02 15.42c-1.16 0-2.11-1.07-2.11-2.38s.93-2.38 2.11-2.38c1.18 0 2.13 1.08 2.11 2.38 0 1.31-.93 2.38-2.11 2.38Zm7.95 0c-1.16 0-2.11-1.07-2.11-2.38s.93-2.38 2.11-2.38c1.18 0 2.13 1.08 2.11 2.38 0 1.31-.93 2.38-2.11 2.38Z',
+  }));
+}

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

@@ -0,0 +1,203 @@
+export const DINGTALK_RPC_CHANNEL = '/dingtalk';
+
+export const DINGTALK_ENDPOINTS = Object.freeze({
+  status: 'connection.status',
+  beginProvisioning: 'provision.begin',
+  pollProvisioning: 'provision.poll',
+  cancelProvisioning: 'provision.cancel',
+  bindCredentials: 'bot.bind-credentials',
+  reconnectBot: 'bot.reconnect',
+  deleteBot: 'bot.delete',
+});
+
+const ACCOUNT_STATES = new Set(['connected', 'connecting', 'offline', 'error']);
+const SNAPSHOT_STATES = new Set(['disconnected', 'offline', 'provisioning', 'connected', 'degraded']);
+const PROVISION_STATES = new Set([
+  'starting',
+  'pending',
+  'scanned',
+  'authorizing',
+  'creating',
+  'connecting',
+  'connected',
+  'expired',
+  'failed',
+  'cancelled',
+]);
+const HEALTH_STATES = new Set(['healthy', 'checking', 'degraded', 'offline']);
+const FORBIDDEN_ERROR_FIELDS = /(client[_-]?secret|secret[_-]?ref|device[_-]?code|app[_-]?secret|access[_-]?token|token)/i;
+const QR_DATA_URL = /^data:image\/(?:png|webp);base64,[a-z\d+/]+={0,2}$/i;
+const MAX_QR_SOURCE_LENGTH = 2 * 1024 * 1024;
+
+function isRecord(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+
+function optionalString(value, maxLength = 240) {
+  if (typeof value !== 'string') return undefined;
+  const trimmed = value.trim();
+  return trimmed ? trimmed.slice(0, maxLength) : undefined;
+}
+
+function opaqueId(value) {
+  const id = optionalString(value, 128);
+  return id && /^[a-z\d_-]+$/i.test(id) ? id : undefined;
+}
+
+function timestamp(value) {
+  if (typeof value === 'number' && Number.isFinite(value)) return value;
+  if (typeof value === 'string' && value.trim()) {
+    const parsed = Date.parse(value);
+    return Number.isNaN(parsed) ? undefined : parsed;
+  }
+  return undefined;
+}
+
+function nonNegativeInteger(value) {
+  const number = Number(value);
+  return Number.isSafeInteger(number) && number >= 0 ? number : 0;
+}
+
+function clamp(value, min, max, fallback) {
+  const number = Number(value);
+  return Number.isFinite(number) ? Math.min(max, Math.max(min, number)) : fallback;
+}
+
+function safeErrorCode(value, fallback) {
+  const code = optionalString(value, 80);
+  return code && /^[a-z][a-z\d_.:-]*$/i.test(code) && !FORBIDDEN_ERROR_FIELDS.test(code)
+    ? code
+    : fallback;
+}
+
+function sanitizeMessage(value, fallback) {
+  const message = optionalString(value, 480) ?? fallback;
+  if (FORBIDDEN_ERROR_FIELDS.test(message)) return fallback;
+  return message.replace(/([=:]\s*)[^\s,;，。]+/g, '$1••••••').slice(0, 240);
+}
+
+function normalizeError(value, fallbackCode, fallbackMessage) {
+  if (!isRecord(value)) return undefined;
+  return {
+    code: safeErrorCode(value.code, fallbackCode),
+    message: sanitizeMessage(value.message, fallbackMessage),
+  };
+}
+
+export function unwrapRpcResult(result) {
+  if (!isRecord(result) || typeof result.ok !== 'boolean') {
+    throw new Error('钉钉服务返回了无法识别的响应');
+  }
+  if (!result.ok) {
+    const error = new Error(sanitizeMessage(result.error?.message, '钉钉操作失败'));
+    error.code = safeErrorCode(result.error?.code, 'DINGTALK_RPC_ERROR');
+    throw error;
+  }
+  return result.value;
+}
+
+export function safeQrSource(value) {
+  if (typeof value !== 'string' || value.length > MAX_QR_SOURCE_LENGTH) return undefined;
+  return QR_DATA_URL.test(value) ? value : undefined;
+}
+
+export function normalizeProvisioning(value, now = Date.now()) {
+  const source = isRecord(value?.provisioning) ? value.provisioning : value;
+  if (!isRecord(source)) throw new Error('钉钉服务没有返回扫码绑定进度');
+  const attemptId = opaqueId(source.attemptId);
+  if (!attemptId) throw new Error('钉钉扫码服务没有返回有效的绑定任务');
+
+  const reportedStatus = optionalString(source.status, 32) ?? optionalString(source.state, 32);
+  const status = PROVISION_STATES.has(reportedStatus) ? reportedStatus : 'failed';
+  const expiresAt = timestamp(source.expiresAt)
+    ?? now + clamp(source.expiresIn, 1, 2 * 60 * 60, 10 * 60) * 1_000;
+  const result = {
+    attemptId,
+    status,
+    expiresAt,
+    pollIntervalMs: clamp(source.pollIntervalMs, 1_000, 10_000, 3_000),
+  };
+  const qrCodeDataUrl = safeQrSource(source.qrCodeDataUrl);
+  if (qrCodeDataUrl) result.qrCodeDataUrl = qrCodeDataUrl;
+  if (opaqueId(source.botId)) result.botId = opaqueId(source.botId);
+  if (source.alreadyConnected === true) result.alreadyConnected = true;
+  const error = normalizeError(
+    source.error,
+    'DINGTALK_PROVISION_FAILED',
+    '钉钉机器人没有接入完成',
+  );
+  if (error) result.error = error;
+  return result;
+}
+
+function normalizeBot(value) {
+  if (!isRecord(value)) return undefined;
+  const botId = opaqueId(value.botId);
+  if (!botId) return undefined;
+  const bot = isRecord(value.bot) ? value.bot : {};
+  const connected = value.connected === true;
+  const reportedState = ACCOUNT_STATES.has(value.state) ? value.state : 'offline';
+  const state = connected ? 'connected' : reportedState === 'connected' ? 'connecting' : reportedState;
+  const health = isRecord(value.health) ? value.health : {};
+  const stats = isRecord(value.stats) ? value.stats : {};
+  return {
+    botId,
+    state,
+    connected,
+    configured: value.configured !== false,
+    bot: {
+      name: optionalString(bot.name, 100) ?? '钉钉机器人',
+      clientIdMasked: optionalString(bot.clientIdMasked, 140) ?? '已安全保存',
+    },
+    health: {
+      status: HEALTH_STATES.has(health.status)
+        ? health.status
+        : connected ? 'healthy' : 'offline',
+      summary: optionalString(health.summary, 200)
+        ?? (connected ? '钉钉 Stream 长连接运行正常' : '钉钉连接尚未就绪'),
+      lastCheckedAt: timestamp(health.lastCheckedAt),
+      lastConnectedAt: timestamp(health.lastConnectedAt),
+    },
+    stats: {
+      messagesReceived: nonNegativeInteger(stats.messagesReceived),
+      messagesReplied: nonNegativeInteger(stats.messagesReplied),
+    },
+    error: normalizeError(value.error, 'DINGTALK_ACCOUNT_ERROR', '钉钉连接尚未就绪') ?? null,
+  };
+}
+
+export function normalizeSnapshot(value) {
+  const source = isRecord(value?.snapshot) ? value.snapshot : value;
+  if (!isRecord(source) || !Array.isArray(source.bots)) {
+    throw new Error('钉钉服务没有返回有效的机器人列表');
+  }
+  const seen = new Set();
+  const bots = source.bots.map(normalizeBot).filter((bot) => {
+    if (!bot || seen.has(bot.botId)) return false;
+    seen.add(bot.botId);
+    return true;
+  });
+  return {
+    schemaVersion: Number.isSafeInteger(source.schemaVersion) ? source.schemaVersion : 1,
+    revision: nonNegativeInteger(source.revision),
+    state: SNAPSHOT_STATES.has(source.state) ? source.state : 'offline',
+    bots,
+    totals: {
+      configured: bots.length,
+      connected: bots.filter((bot) => bot.connected).length,
+    },
+    provisioning: source.provisioning ? normalizeProvisioning(source.provisioning) : null,
+  };
+}
+
+export function presentError(error) {
+  return {
+    code: safeErrorCode(error?.code, 'DINGTALK_ERROR'),
+    message: sanitizeMessage(error?.message, '钉钉操作失败，请稍后重试'),
+  };
+}
+
+export function formatRemaining(milliseconds) {
+  const seconds = Math.max(0, Math.ceil(Number(milliseconds) / 1_000) || 0);
+  return `${String(Math.floor(seconds / 60)).padStart(2, '0')}:${String(seconds % 60).padStart(2, '0')}`;
+}