@xmanrui/dsh-im 3.1.0 → 3.2.0

package/plugin-src/host/channels/dingtalk/rpc.mjs

@@ -1,4 +1,5 @@
 import QRCode from 'qrcode';
+import { SET_CONTEXT_ENHANCEMENT_ENDPOINT, validContextEnhancementPayload } from '../shared/context-enhancement-rpc.mjs';
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
 import { publicWorkspaceError, SET_WORKSPACE_ENDPOINT, validWorkspacePayload } from '../shared/workspace-rpc.mjs';
 import { SET_AGENT_PRESET_ENDPOINT, validAgentPresetPayload } from '../shared/agent-preset-rpc.mjs';
@@ -18,6 +19,7 @@ export const DINGTALK_ENDPOINTS = Object.freeze({
   deleteBot: 'bot.delete',
   setWorkspace: SET_WORKSPACE_ENDPOINT,
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
+  setContextEnhancement: SET_CONTEXT_ENHANCEMENT_ENDPOINT,
   approveSender: 'bot.sender.approve',
   revokeSender: 'bot.sender.revoke',
 });
@@ -94,6 +96,10 @@ function payloadFailure(endpoint, payload) {
     return validAgentPresetPayload(payload)
       ? null : '请选择 Agent Preset。';
   }
+  if (endpoint === DINGTALK_ENDPOINTS.setContextEnhancement) {
+    return validContextEnhancementPayload(payload)
+      ? null : '请提交有效的上下文增强设置。';
+  }
   if (endpoint === DINGTALK_ENDPOINTS.approveSender) {
     return exactKeys(payload, ['botId', 'requestId', 'confirm'])
       && validId(payload.botId)
@@ -251,6 +257,11 @@ export function createDingtalkRpcHandler(controller, { encodeQr = qrDataUrl } =
           await controller.updateWorkspace(payload.botId, payload.workspace),
           cachedEncode,
         );
+      } else if (endpoint === DINGTALK_ENDPOINTS.setContextEnhancement) {
+        if (typeof controller.updateContextEnhancement !== 'function') throw new Error('Context enhancement update is unavailable');
+        value = await controller.updateContextEnhancement(
+          payload.botId, payload.config, (status) => publicStatus(status, cachedEncode),
+        );
       } else if (endpoint === DINGTALK_ENDPOINTS.setAgentPreset) {
         if (typeof controller.updateAgentPreset !== 'function') throw new Error('Agent preset update is unavailable');
         value = await publicStatus(

package/plugin-src/host/channels/feishu/production.mjs

@@ -98,6 +98,8 @@ export async function createProductionController(ctx, config = {}, internals = {
         workspaces,
         method: 'removeBot',
         botIdFromRemoved: (removed) => removed.id,
+        saveMethod: 'saveBot',
+        botIdFromSave: (bot) => bot?.id,
       })
     : configStore;
   // State is lazy per bot. A corrupt legacy file can therefore fail only the
@@ -167,6 +169,7 @@ export async function createProductionController(ctx, config = {}, internals = {
         ownerOpenIds: botConfig.ownerOpenIds ?? [botConfig.ownerOpenId],
         harness: workspaceScope.harness,
         state: workspaceScope.state,
+        contextEnhancement: { botId: id, getSettings: () => workspaces.contextEnhancementFor(id) },
         replyTimeoutMs: config.replyTimeoutMs ?? 600_000,
         ...(wsAgent ? { wsAgent } : {}),
         logger: {

package/plugin-src/host/channels/feishu/rpc.mjs

@@ -8,6 +8,8 @@ import { publicMessageFailure } from '../../../../src/channels/shared/message-fa
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
 import { publicWorkspaceError, validWorkspacePayload } from '../shared/workspace-rpc.mjs';
 import { validAgentPresetPayload } from '../shared/agent-preset-rpc.mjs';
+import { validContextEnhancementPayload } from '../shared/context-enhancement-rpc.mjs';
+import { normalizeContextEnhancementConfig } from '../../../../src/channels/shared/context-enhancement.mjs';
 import {
   isFeishuGroupResponseMode,
   normalizeFeishuGroupResponseMode,
@@ -276,6 +278,7 @@ function publicBotEntry(entry) {
     connected,
     configured: source.configured === true,
     agentPreset: normalizeAgentPresetId(source.agentPreset),
+    contextEnhancement: normalizeContextEnhancementConfig(source.contextEnhancement),
     groupResponseMode: normalizeFeishuGroupResponseMode(source.groupResponseMode),
     groupMessagePermissionGranted: source.groupMessagePermissionGranted === true,
     bot: publicBot(source.bot),
@@ -415,6 +418,10 @@ function validPayload(endpoint, payload) {
     return validAgentPresetPayload(payload)
       ? null : '请选择 Agent Preset。';
   }
+  if (endpoint === FEISHU_ENDPOINTS.setContextEnhancement) {
+    return validContextEnhancementPayload(payload)
+      ? null : '请提交有效的上下文增强设置。';
+  }
   if (endpoint === FEISHU_ENDPOINTS.setGroupResponseMode) {
     return hasOnlyKeys(payload, new Set(['botId', 'groupResponseMode']))
       && safeOpaqueId(payload.botId)
@@ -666,6 +673,12 @@ export function createFeishuRpcHandler(controller, { encodeQr = qrCodeDataUrl }
           await controller.updateWorkspace(payload.botId, payload.workspace),
           { encodeQr: cachedEncodeQr },
         );
+      } else if (endpoint === FEISHU_ENDPOINTS.setContextEnhancement) {
+        if (typeof controller.updateContextEnhancement !== 'function') throw new Error('Context enhancement update is unavailable');
+        value = await controller.updateContextEnhancement(
+          payload.botId, payload.config,
+          (status) => toPublicFeishuStatus(status, { encodeQr: cachedEncodeQr }),
+        );
       } else if (endpoint === FEISHU_ENDPOINTS.setAgentPreset) {
         if (typeof controller.updateAgentPreset !== 'function') throw new Error('Agent preset update is unavailable');
         value = await toPublicFeishuStatus(

package/plugin-src/host/channels/qq/production.mjs

@@ -100,6 +100,7 @@ export async function createProductionController(ctx, config = {}, internals = {
         appSecret,
         harness: workspaceScope.harness,
         state: workspaceScope.state,
+        contextEnhancement: { botId, getSettings: () => workspaces.contextEnhancementFor(botId) },
         replyTimeoutMs: config.replyTimeoutMs ?? 600_000,
         connectTimeoutMs: config.connectTimeoutMs ?? 20_000,
         logger: {

package/plugin-src/host/channels/qq/rpc.mjs

@@ -3,6 +3,7 @@ import {
   connectionTestTargetUnavailable,
   publicConnectionTestResult,
 } from '../../../../src/channels/shared/connection-test.mjs';
+import { SET_CONTEXT_ENHANCEMENT_ENDPOINT, validContextEnhancementPayload } from '../shared/context-enhancement-rpc.mjs';
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
 import { publicWorkspaceError, SET_WORKSPACE_ENDPOINT, validWorkspacePayload } from '../shared/workspace-rpc.mjs';
 import { SET_AGENT_PRESET_ENDPOINT, validAgentPresetPayload } from '../shared/agent-preset-rpc.mjs';
@@ -18,6 +19,7 @@ export const QQ_ENDPOINTS = Object.freeze({
   deleteBot: 'bot.delete',
   setWorkspace: SET_WORKSPACE_ENDPOINT,
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
+  setContextEnhancement: SET_CONTEXT_ENHANCEMENT_ENDPOINT,
 });
 export const QQ_RPC_ENDPOINTS = Object.freeze(Object.values(QQ_ENDPOINTS));
 
@@ -76,6 +78,10 @@ function payloadFailure(endpoint, payload) {
     return validAgentPresetPayload(payload)
       ? null : '请选择 Agent Preset。';
   }
+  if (endpoint === QQ_ENDPOINTS.setContextEnhancement) {
+    return validContextEnhancementPayload(payload)
+      ? null : '请提交有效的上下文增强设置。';
+  }
   return 'Unknown QQ endpoint.';
 }
 
@@ -171,6 +177,11 @@ export function createQqRpcHandler(controller, { encodeQr = qrDataUrl } = {}) {
           await controller.updateWorkspace(payload.botId, payload.workspace),
           cachedEncode,
         );
+      } else if (endpoint === QQ_ENDPOINTS.setContextEnhancement) {
+        if (typeof controller.updateContextEnhancement !== 'function') throw new Error('Context enhancement update is unavailable');
+        value = await controller.updateContextEnhancement(
+          payload.botId, payload.config, (status) => publicStatus(status, cachedEncode),
+        );
       } else if (endpoint === QQ_ENDPOINTS.setAgentPreset) {
         if (typeof controller.updateAgentPreset !== 'function') throw new Error('Agent preset update is unavailable');
         value = await publicStatus(

package/plugin-src/host/channels/shared/context-enhancement-rpc.mjs

@@ -0,0 +1,17 @@
+import { validateContextEnhancementConfig } from '../../../../src/channels/shared/context-enhancement.mjs';
+
+export const SET_CONTEXT_ENHANCEMENT_ENDPOINT = 'bot.context-enhancement.set';
+
+export function validContextEnhancementPayload(payload) {
+  try {
+    if (!payload || typeof payload !== 'object' || Array.isArray(payload)
+      || Reflect.ownKeys(payload).length !== 2
+      || !Object.hasOwn(payload, 'botId') || !Object.hasOwn(payload, 'config')
+      || typeof payload.botId !== 'string'
+      || !/^[A-Za-z0-9_-]{1,128}$/.test(payload.botId)) return false;
+    validateContextEnhancementConfig(payload.config);
+    return true;
+  } catch {
+    return false;
+  }
+}

package/plugin-src/host/channels/shared/production.mjs

@@ -102,6 +102,7 @@ export async function createTokenProductionController(ctx, config, internals, de
         token,
         harness: workspaceScope.harness,
         state: workspaceScope.state,
+        contextEnhancement: { botId, getSettings: () => workspaces.contextEnhancementFor(botId) },
         replyTimeoutMs: config.replyTimeoutMs ?? 600_000,
         connectTimeoutMs: config.connectTimeoutMs ?? 20_000,
         logger: {

package/plugin-src/host/channels/shared/rpc.mjs

@@ -1,3 +1,4 @@
+import { SET_CONTEXT_ENHANCEMENT_ENDPOINT, validContextEnhancementPayload } from './context-enhancement-rpc.mjs';
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
 import { publicConnectionTestResult } from '../../../../src/channels/shared/connection-test.mjs';
 import {
@@ -17,6 +18,7 @@ export const TOKEN_BOT_ENDPOINTS = Object.freeze({
   deleteBot: 'bot.delete',
   setWorkspace: SET_WORKSPACE_ENDPOINT,
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
+  setContextEnhancement: SET_CONTEXT_ENHANCEMENT_ENDPOINT,
 });
 
 const ENDPOINTS = Object.freeze(Object.values(TOKEN_BOT_ENDPOINTS));
@@ -71,6 +73,10 @@ function payloadFailure(endpoint, payload) {
     return validAgentPresetPayload(payload)
       ? null : '请选择 Agent Preset。';
   }
+  if (endpoint === TOKEN_BOT_ENDPOINTS.setContextEnhancement) {
+    return validContextEnhancementPayload(payload)
+      ? null : '请提交有效的上下文增强设置。';
+  }
   return 'Unknown bot endpoint.';
 }
 
@@ -152,6 +158,9 @@ export function createTokenBotRpcHandler(controller, { channel }) {
       } else if (endpoint === TOKEN_BOT_ENDPOINTS.setWorkspace) {
         if (typeof controller.updateWorkspace !== 'function') throw new Error('Workspace update is unavailable');
         value = await controller.updateWorkspace(payload.botId, payload.workspace);
+      } else if (endpoint === TOKEN_BOT_ENDPOINTS.setContextEnhancement) {
+        if (typeof controller.updateContextEnhancement !== 'function') throw new Error('Context enhancement update is unavailable');
+        value = await controller.updateContextEnhancement(payload.botId, payload.config);
       } else if (endpoint === TOKEN_BOT_ENDPOINTS.setAgentPreset) {
         if (typeof controller.updateAgentPreset !== 'function') throw new Error('Agent preset update is unavailable');
         value = await controller.updateAgentPreset(payload.botId, payload.agentPreset);

package/plugin-src/host/channels/shared/workspace-rpc.mjs

@@ -22,6 +22,7 @@ export function publicWorkspaceError(error) {
     'workspace-bot-not-found',
     'agent-preset-invalid',
     'agent-preset-unavailable',
+    'context-enhancement-invalid',
   ].includes(error?.code)) return null;
   return { code: error.code, message: error.message };
 }

package/plugin-src/host/channels/slack/production.mjs

@@ -89,6 +89,7 @@ export async function createProductionController(ctx, config = {}, internals = {
         appToken,
         harness: workspaceScope.harness,
         state: workspaceScope.state,
+        contextEnhancement: { botId, getSettings: () => workspaces.contextEnhancementFor(botId) },
         replyTimeoutMs: config.replyTimeoutMs ?? 600_000,
         connectTimeoutMs: config.connectTimeoutMs ?? 20_000,
         logger: {

package/plugin-src/host/channels/slack/rpc.mjs

@@ -1,3 +1,4 @@
+import { SET_CONTEXT_ENHANCEMENT_ENDPOINT, validContextEnhancementPayload } from '../shared/context-enhancement-rpc.mjs';
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
 import { publicConnectionTestResult } from '../../../../src/channels/shared/connection-test.mjs';
 import {
@@ -18,6 +19,7 @@ export const SLACK_ENDPOINTS = Object.freeze({
   deleteBot: 'bot.delete',
   setWorkspace: SET_WORKSPACE_ENDPOINT,
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
+  setContextEnhancement: SET_CONTEXT_ENHANCEMENT_ENDPOINT,
 });
 export const SLACK_RPC_ENDPOINTS = Object.freeze(Object.values(SLACK_ENDPOINTS));
 
@@ -75,6 +77,10 @@ function payloadFailure(endpoint, payload) {
     return validAgentPresetPayload(payload)
       ? null : '请选择 Agent Preset。';
   }
+  if (endpoint === SLACK_ENDPOINTS.setContextEnhancement) {
+    return validContextEnhancementPayload(payload)
+      ? null : '请提交有效的上下文增强设置。';
+  }
   return 'Unknown Slack endpoint.';
 }
 
@@ -154,6 +160,10 @@ export function createSlackRpcHandler(controller) {
         if (typeof controller.updateWorkspace !== 'function') throw new Error('Workspace update is unavailable');
         value = await controller.updateWorkspace(payload.botId, payload.workspace);
       }
+      else if (endpoint === SLACK_ENDPOINTS.setContextEnhancement) {
+        if (typeof controller.updateContextEnhancement !== 'function') throw new Error('Context enhancement update is unavailable');
+        value = await controller.updateContextEnhancement(payload.botId, payload.config);
+      }
       else if (endpoint === SLACK_ENDPOINTS.setAgentPreset) {
         if (typeof controller.updateAgentPreset !== 'function') throw new Error('Agent preset update is unavailable');
         value = await controller.updateAgentPreset(payload.botId, payload.agentPreset);

package/plugin-src/host/channels/wecom/production.mjs

@@ -103,6 +103,7 @@ export async function createProductionController(ctx, config = {}, internals = {
         secret,
         harness: workspaceScope.harness,
         state: workspaceScope.state,
+        contextEnhancement: { botId, getSettings: () => workspaces.contextEnhancementFor(botId) },
         replyTimeoutMs: config.replyTimeoutMs ?? 600_000,
         connectTimeoutMs: config.connectTimeoutMs ?? 20_000,
         maxReconnectAttempts: config.maxReconnectAttempts ?? 10,

package/plugin-src/host/channels/wecom/rpc.mjs

@@ -1,4 +1,5 @@
 import QRCode from 'qrcode';
+import { SET_CONTEXT_ENHANCEMENT_ENDPOINT, validContextEnhancementPayload } from '../shared/context-enhancement-rpc.mjs';
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
 import { publicWorkspaceError, SET_WORKSPACE_ENDPOINT, validWorkspacePayload } from '../shared/workspace-rpc.mjs';
 import { SET_AGENT_PRESET_ENDPOINT, validAgentPresetPayload } from '../shared/agent-preset-rpc.mjs';
@@ -18,6 +19,7 @@ export const WECOM_ENDPOINTS = Object.freeze({
   deleteBot: 'bot.delete',
   setWorkspace: SET_WORKSPACE_ENDPOINT,
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
+  setContextEnhancement: SET_CONTEXT_ENHANCEMENT_ENDPOINT,
 });
 export const WECOM_RPC_ENDPOINTS = Object.freeze(Object.values(WECOM_ENDPOINTS));
 
@@ -76,6 +78,10 @@ function payloadFailure(endpoint, payload) {
     return validAgentPresetPayload(payload)
       ? null : '请选择 Agent Preset。';
   }
+  if (endpoint === WECOM_ENDPOINTS.setContextEnhancement) {
+    return validContextEnhancementPayload(payload)
+      ? null : '请提交有效的上下文增强设置。';
+  }
   return 'Unknown Enterprise WeChat endpoint.';
 }
 
@@ -172,6 +178,11 @@ export function createWecomRpcHandler(controller, { encodeQr = qrDataUrl } = {})
           await controller.updateWorkspace(payload.botId, payload.workspace),
           cachedEncode,
         );
+      } else if (endpoint === WECOM_ENDPOINTS.setContextEnhancement) {
+        if (typeof controller.updateContextEnhancement !== 'function') throw new Error('Context enhancement update is unavailable');
+        value = await controller.updateContextEnhancement(
+          payload.botId, payload.config, (status) => publicStatus(status, cachedEncode),
+        );
       } else if (endpoint === WECOM_ENDPOINTS.setAgentPreset) {
         if (typeof controller.updateAgentPreset !== 'function') throw new Error('Agent preset update is unavailable');
         value = await publicStatus(

package/plugin-src/host/channels/weixin/production.mjs

@@ -107,6 +107,7 @@ export async function createProductionController(ctx, config = {}, internals = {
         token,
         harness: workspaceScope.harness,
         state: workspaceScope.state,
+        contextEnhancement: { botId, getSettings: () => workspaces.contextEnhancementFor(botId) },
         replyTimeoutMs: config.replyTimeoutMs ?? 600_000,
         maxMessageChars: config.maxMessageChars ?? DEFAULT_WEIXIN_MAX_MESSAGE_CHARS,
         logger: {

package/plugin-src/host/channels/weixin/rpc.mjs

@@ -1,4 +1,5 @@
 import QRCode from 'qrcode';
+import { SET_CONTEXT_ENHANCEMENT_ENDPOINT, validContextEnhancementPayload } from '../shared/context-enhancement-rpc.mjs';
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
 import {
   publicWorkspaceError,
@@ -25,6 +26,7 @@ export const WEIXIN_ENDPOINTS = Object.freeze({
   deleteBot: 'bot.delete',
   setWorkspace: SET_WORKSPACE_ENDPOINT,
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
+  setContextEnhancement: SET_CONTEXT_ENHANCEMENT_ENDPOINT,
 });
 export const WEIXIN_RPC_ENDPOINTS = Object.freeze(Object.values(WEIXIN_ENDPOINTS));
 
@@ -83,6 +85,10 @@ function payloadFailure(endpoint, payload) {
     return validAgentPresetPayload(payload)
       ? null : '请选择 Agent Preset。';
   }
+  if (endpoint === WEIXIN_ENDPOINTS.setContextEnhancement) {
+    return validContextEnhancementPayload(payload)
+      ? null : '请提交有效的上下文增强设置。';
+  }
   return 'Unknown Weixin endpoint.';
 }
 
@@ -207,6 +213,11 @@ export function createWeixinRpcHandler(controller, { encodeQr = qrDataUrl } = {}
           await controller.updateWorkspace(payload.botId, payload.workspace),
           cachedEncode,
         );
+      } else if (endpoint === WEIXIN_ENDPOINTS.setContextEnhancement) {
+        if (typeof controller.updateContextEnhancement !== 'function') throw new Error('Context enhancement update is unavailable');
+        value = await controller.updateContextEnhancement(
+          payload.botId, payload.config, (status) => publicStatus(status, cachedEncode),
+        );
       } else if (endpoint === WEIXIN_ENDPOINTS.setAgentPreset) {
         if (typeof controller.updateAgentPreset !== 'function') throw new Error('Agent preset update is unavailable');
         value = await publicStatus(

package/plugin-src/host/channels/whatsapp/production.mjs

@@ -106,6 +106,7 @@ export async function createProductionController(ctx, config = {}, internals = {
         authDir,
         harness: workspaceScope.harness,
         state: workspaceScope.state,
+        contextEnhancement: { botId, getSettings: () => workspaces.contextEnhancementFor(botId) },
         replyTimeoutMs: config.replyTimeoutMs ?? 600_000,
         connectTimeoutMs: config.connectTimeoutMs ?? 30_000,
         createSession,

package/plugin-src/host/channels/whatsapp/rpc.mjs

@@ -2,6 +2,7 @@ import QRCode from 'qrcode';
 
 import { publicConnectionTestResult } from '../../../../src/channels/shared/connection-test.mjs';
 import { normalizeWhatsappAccessPolicy } from '../../../../src/channels/whatsapp/config-store.mjs';
+import { SET_CONTEXT_ENHANCEMENT_ENDPOINT, validContextEnhancementPayload } from '../shared/context-enhancement-rpc.mjs';
 import { resolveRpcAuthority } from '../../rpc-authority.mjs';
 import { publicWorkspaceError, SET_WORKSPACE_ENDPOINT, validWorkspacePayload } from '../shared/workspace-rpc.mjs';
 import { SET_AGENT_PRESET_ENDPOINT, validAgentPresetPayload } from '../shared/agent-preset-rpc.mjs';
@@ -17,6 +18,7 @@ export const WHATSAPP_ENDPOINTS = Object.freeze({
   setAccessPolicy: 'bot.access-policy.set',
   setWorkspace: SET_WORKSPACE_ENDPOINT,
   setAgentPreset: SET_AGENT_PRESET_ENDPOINT,
+  setContextEnhancement: SET_CONTEXT_ENHANCEMENT_ENDPOINT,
 });
 export const WHATSAPP_RPC_ENDPOINTS = Object.freeze(Object.values(WHATSAPP_ENDPOINTS));
 
@@ -71,6 +73,10 @@ function payloadFailure(endpoint, payload) {
     return validAgentPresetPayload(payload)
       ? null : '请选择 Agent Preset。';
   }
+  if (endpoint === WHATSAPP_ENDPOINTS.setContextEnhancement) {
+    return validContextEnhancementPayload(payload)
+      ? null : '请提交有效的上下文增强设置。';
+  }
   return 'Unknown WhatsApp endpoint.';
 }
 
@@ -173,6 +179,11 @@ export function createWhatsappRpcHandler(controller, { encodeQr = qrDataUrl } =
           await controller.updateWorkspace(payload.botId, payload.workspace),
           cachedEncode,
         );
+      } else if (endpoint === WHATSAPP_ENDPOINTS.setContextEnhancement) {
+        if (typeof controller.updateContextEnhancement !== 'function') throw new Error('Context enhancement update is unavailable');
+        value = await controller.updateContextEnhancement(
+          payload.botId, payload.config, (status) => publicStatus(status, cachedEncode),
+        );
       } else if (endpoint === WHATSAPP_ENDPOINTS.setAgentPreset) {
         if (typeof controller.updateAgentPreset !== 'function') throw new Error('Agent preset update is unavailable');
         value = await publicStatus(

package/plugin-src/host/update-runtime.mjs

@@ -280,6 +280,8 @@ export function createUpdateRuntime(options = {}) {
 
       const profile = await packageAt(runtime.profileDir);
       const installed = await packageAt(join(runtime.profileDir, 'node_modules', PACKAGE_NAME));
+      result.sourceInstall = !registrySpec(profile.manifest.dependencies?.[PACKAGE_NAME])
+        || !inside(join(runtime.profileDir, 'node_modules'), installed.directory);
       result.installedVersion = typeof installed.manifest.version === 'string' ? installed.manifest.version : null;
       result.packageValid = await validPackage(installed);
       const loaded = await loadedPackage;
@@ -298,8 +300,7 @@ export function createUpdateRuntime(options = {}) {
       if (boundProfile !== undefined && boundProfile !== identity) result.blockedReason = 'installation-changed';
       else if (!sameLoadedPackage && boundProfile === undefined) result.blockedReason = 'installation-changed';
       else if (!result.packageValid) result.blockedReason = 'invalid-installation';
-      else if (!registrySpec(profile.manifest.dependencies?.[PACKAGE_NAME])
-          || !inside(join(runtime.profileDir, 'node_modules'), installed.directory)) result.blockedReason = 'source-install';
+      else if (result.sourceInstall) result.blockedReason = 'source-install';
       else if (runtime.blockedReason) result.blockedReason = runtime.blockedReason;
       else if (!sameLoadedPackage) result.blockedReason = 'pending-restart';
       else if (preflight) await checkRegistry(runtime);

package/plugin-src/host/update-service.mjs

@@ -201,6 +201,8 @@ export function createUpdateService({
       latestVersion: checked?.release.version ?? null,
       profileName: environment.profileName ?? null,
       environmentKind: environment.environmentKind ?? 'cli',
+      // Preserve source protection even when restart/recovery takes status priority.
+      sourceInstall: environment.sourceInstall === true || environment.blockedReason === 'source-install',
       canInstall,
       blockedReason,
       checkedAt: checked?.checkedAt ?? null,

package/scripts/verify-package.mjs

@@ -29,6 +29,7 @@ const required = [
   'plugin-src/client/channels/slack/index.js',
   'plugin-src/client/i18n.js',
   'plugin-src/client/update-panel.js',
+  'plugin-src/client/context-enhancement.js',
   'plugin-src/host/update-service.mjs',
   'plugin-src/host/update-runtime.mjs',
   'plugin-src/host/update-rpc.mjs',
@@ -51,6 +52,7 @@ const required = [
   'src/channels/discord/discord-runtime.mjs',
   'src/channels/whatsapp/whatsapp-runtime.mjs',
   'src/channels/whatsapp/whatsapp-web-session.mjs',
+  'src/channels/shared/context-enhancement.mjs',
 ];
 await Promise.all(required.map((path) => access(resolve(root, path))));
 
@@ -135,8 +137,19 @@ if ((client.match(/\.slots\.inject\(\s*["']settings\.section["']/gu) ?? []).leng
 if (client.includes('settings.plugins.tab') || clientSources.includes('settings.plugins.tab')) {
   throw new Error('client source or bundle still contains the legacy Plugins-tab settings entry');
 }
-if (/role:\s*["']switch|type:\s*["']checkbox/.test(client)) {
-  throw new Error('client bundle contains a channel enable switch');
+// Connections still have no channel-enable toggle. Only the shared context
+// editor owns checkable inputs: two scope switches and one mapped field input.
+const contextEditorSource = await readFile(resolve(root, 'plugin-src/client/context-enhancement.js'), 'utf8');
+const otherClientSources = clientSources.replace(contextEditorSource, '');
+if (/role:\s*["']switch|type:\s*["']checkbox/.test(otherClientSources)
+  || (client.match(/role:\s*["']switch["']/g) ?? []).length !== 2
+  || (client.match(/type:\s*["']checkbox["']/g) ?? []).length !== 3) {
+  throw new Error('checkable inputs must be limited to the context-enhancement editor');
+}
+for (const marker of ['bot.context-enhancement.set', '<dsh_im_source>', '<dsh_im_source_guidance>']) {
+  if (!host.includes(marker) || !client.includes(marker)) {
+    throw new Error(`context-enhancement marker missing from Host or Client bundle: ${marker}`);
+  }
 }
 if (!client.includes('container-type: inline-size')
   || !client.includes('@container (max-width: 680px)')) {

package/src/channels/dingtalk/dingtalk-api.mjs

@@ -316,16 +316,30 @@ function normalizeCardTarget(target) {
   }
   if (target?.type === 'group') {
     const openConversationId = nonEmptyString(target.openConversationId);
-    if (openConversationId) return { type: 'group', openConversationId };
+    if (openConversationId) {
+      return { type: 'group', openConversationId, atUserIds: target.atUserIds };
+    }
   }
   throw new TypeError('DingTalk AI Card target is invalid');
 }
 
-function cardData(text, flowStatus) {
+function cardMarkdown(text, target) {
+  const escape = (value) => String(value).replace(/[&<>"']/g, (char) => ({
+    '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;',
+  })[char]);
+  const mentions = target?.type === 'group'
+    ? Object.entries(target.atUserIds ?? {}).map(([userId, name]) => (
+        `<a atId="${escape(userId)}">${escape(name)}</a>`
+      )).join(' ')
+    : '';
+  return normalizeDingtalkCardMarkdown(mentions ? `${mentions}\n\n${text}` : text);
+}
+
+function cardData(text, flowStatus, target) {
   return {
     cardParamMap: {
       flowStatus,
-      msgContent: normalizeDingtalkCardMarkdown(text),
+      msgContent: cardMarkdown(text, target),
       staticMsgContent: '',
       sys_full_json_obj: JSON.stringify({ order: ['msgContent'] }),
       config: JSON.stringify({ autoLayout: true }),
@@ -339,7 +353,7 @@ function cardDeliverBody(cardInstanceId, target, robotCode) {
     return {
       ...base,
       openSpaceId: `dtv1.card//IM_GROUP.${target.openConversationId}`,
-      imGroupOpenDeliverModel: { robotCode },
+      imGroupOpenDeliverModel: { robotCode, atUserIds: target.atUserIds },
     };
   }
   return {
@@ -575,7 +589,7 @@ export function createDingtalkApi({
     }
   }
 
-  async function failCard({ clientId, clientSecret, cardInstanceId, text, signal }) {
+  async function failCard({ clientId, clientSecret, cardInstanceId, text, target, signal }) {
     const instanceId = nonEmptyString(cardInstanceId);
     const content = nonEmptyString(text);
     if (!instanceId) throw new TypeError('cardInstanceId is required');
@@ -589,7 +603,7 @@ export function createDingtalkApi({
           outTrackId: instanceId,
           guid: randomUUID(),
           key: 'msgContent',
-          content: normalizeDingtalkCardMarkdown(content),
+          content: cardMarkdown(content, target),
           isFull: true,
           isFinalize: false,
           isError: true,
@@ -602,7 +616,7 @@ export function createDingtalkApi({
         method: 'PUT',
         body: {
           outTrackId: instanceId,
-          cardData: cardData(content, '5'),
+          cardData: cardData(content, '5', target),
           cardUpdateOptions: { updateCardDataByKey: true },
         },
         headers,
@@ -883,6 +897,9 @@ export function createDingtalkApi({
               cardParamMap: { config: JSON.stringify({ autoLayout: true }) },
             },
             callbackType: 'STREAM',
+            cardAtUserIds: normalizedTarget.atUserIds
+              ? Object.keys(normalizedTarget.atUserIds)
+              : undefined,
             imGroupOpenSpaceModel: { supportForward: true },
             imRobotOpenSpaceModel: { supportForward: true },
           },
@@ -899,7 +916,7 @@ export function createDingtalkApi({
         delivered = true;
         await cardRequest('v1.0/card/instances', {
           method: 'PUT',
-          body: { outTrackId: cardInstanceId, cardData: cardData(content, '2') },
+          body: { outTrackId: cardInstanceId, cardData: cardData(content, '2', normalizedTarget) },
           headers,
           signal,
           action: 'AI Card 启动',
@@ -910,7 +927,7 @@ export function createDingtalkApi({
             outTrackId: cardInstanceId,
             guid: randomUUID(),
             key: 'msgContent',
-            content: normalizeDingtalkCardMarkdown(content).replace(/\n+$/, ''),
+            content: cardMarkdown(content, normalizedTarget).replace(/\n+$/, ''),
             isFull: true,
             isFinalize: false,
             isError: false,
@@ -927,6 +944,7 @@ export function createDingtalkApi({
             clientSecret: appSecret,
             cardInstanceId,
             text: t('卡片已结束，请查看后续消息。'),
+            target: normalizedTarget,
             signal: cleanupSignal,
           }).catch(() => undefined);
         }
@@ -935,7 +953,7 @@ export function createDingtalkApi({
       return { cardInstanceId };
     },
 
-    async updateAiCard({ clientId, clientSecret, cardInstanceId, text, signal }) {
+    async updateAiCard({ clientId, clientSecret, cardInstanceId, text, target, signal }) {
       const instanceId = nonEmptyString(cardInstanceId);
       const content = nonEmptyString(text);
       if (!instanceId) throw new TypeError('cardInstanceId is required');
@@ -947,7 +965,7 @@ export function createDingtalkApi({
           outTrackId: instanceId,
           guid: randomUUID(),
           key: 'msgContent',
-          content: normalizeDingtalkCardMarkdown(content).replace(/\n+$/, ''),
+          content: cardMarkdown(content, target).replace(/\n+$/, ''),
           isFull: true,
           isFinalize: false,
           isError: false,
@@ -959,14 +977,14 @@ export function createDingtalkApi({
       return true;
     },
 
-    async finishAiCard({ clientId, clientSecret, cardInstanceId, text, signal }) {
+    async finishAiCard({ clientId, clientSecret, cardInstanceId, text, target, signal }) {
       const instanceId = nonEmptyString(cardInstanceId);
       const content = nonEmptyString(text);
       if (!instanceId) throw new TypeError('cardInstanceId is required');
       if (!content) throw new TypeError('text is required');
       const token = await accessToken({ clientId, clientSecret, signal });
       const headers = { 'x-acs-dingtalk-access-token': token };
-      const normalizedContent = normalizeDingtalkCardMarkdown(content);
+      const normalizedContent = cardMarkdown(content, target);
       await cardRequest('v1.0/card/streaming', {
         method: 'PUT',
         body: {
@@ -987,7 +1005,7 @@ export function createDingtalkApi({
         method: 'PUT',
         body: {
           outTrackId: instanceId,
-          cardData: cardData(content, '3'),
+          cardData: cardData(content, '3', target),
           cardUpdateOptions: { updateCardDataByKey: true },
         },
         headers,
@@ -1008,13 +1026,18 @@ export function createDingtalkApi({
 
     failAiCard: failCard,
 
-    async sendText({ clientId, clientSecret, sessionWebhook, text, signal }) {
+    async sendText({ clientId, clientSecret, sessionWebhook, text, at, signal }) {
       const content = nonEmptyString(text);
       if (!content) throw new TypeError('text is required');
       const webhook = normalizeDingtalkSessionWebhook(sessionWebhook);
       const token = await accessToken({ clientId, clientSecret, signal });
+      const replyAt = at && typeof at === 'object'
+      && ((Array.isArray(at.atUserIds) && at.atUserIds.length > 0)
+          || (Array.isArray(at.atMobiles) && at.atMobiles.length > 0)
+          || at.isAtAll === true)
+          ? { at } : {};
       const response = await requestJson(fetchImpl, webhook, {
-        body: { msgtype: 'text', text: { content } },
+        body: { msgtype: 'text', text: { content }, ...replyAt },
         headers: { 'x-acs-dingtalk-access-token': token },
         signal,
         action: '消息回复',