@xmanrui/dsh-im 4.0.0 → 4.1.0

package/src/channels/feishu/feishu-runtime.mjs

@@ -563,6 +563,41 @@ export class FeishuRuntime {
     });
   }
 
+  async sendProactiveText(target, text, { signal } = {}) {
+    if (!this.#status.ready || !this.#client) {
+      const error = new Error('飞书机器人尚未连接');
+      error.code = 'bot-not-connected';
+      throw error;
+    }
+    const receiveIdType = target?.kind === 'user' ? 'open_id'
+      : target?.kind === 'group' ? 'chat_id' : null;
+    const receiveId = target?.kind === 'user'
+      ? nonEmptyString(target?.route?.openId)
+      : target?.kind === 'group'
+        ? nonEmptyString(target?.route?.chatId)
+        : null;
+    if (!receiveIdType || !receiveId) {
+      const error = new TypeError('Invalid Feishu proactive delivery target');
+      error.code = 'invalid-target';
+      throw error;
+    }
+    signal?.throwIfAborted();
+    const response = await this.#client.im.v1.message.create({
+      params: { receive_id_type: receiveIdType },
+      data: {
+        receive_id: receiveId,
+        msg_type: 'text',
+        content: JSON.stringify({ text }),
+      },
+    });
+    if (response?.code && response.code !== 0) {
+      const error = new Error(`Feishu proactive delivery failed: ${response.msg || response.code}`);
+      error.code = 'target-rejected';
+      throw error;
+    }
+    return { sent: true };
+  }
+
   stop(options = {}) {
     if (this.#stopping) return this.#stopping;
 

package/src/channels/feishu/multi-bot-controller.mjs

@@ -537,6 +537,21 @@ export class MultiBotDshFeishuController {
     });
   }
 
+  async sendProactiveText(botId, target, text, options = {}) {
+    this.#assertOpen();
+    return this.#withBotTransition(botId, async () => {
+      this.#requireBot(botId);
+      const runtime = this.#runtimes.get(botId);
+      if (!isConnected(connectionStatus(runtime))
+        || typeof runtime.sendProactiveText !== 'function') {
+        const error = new Error('飞书机器人尚未连接');
+        error.code = 'bot-not-connected';
+        throw error;
+      }
+      return runtime.sendProactiveText(target, text, options);
+    });
+  }
+
   async disconnectBot(botId) {
     this.#assertOpen();
     // An operational pause only: credentials/config remain durable, so the

package/src/channels/qq/qq-bridge.mjs

@@ -83,14 +83,14 @@ function helpText() {
     t('/history [数量]  查看最近历史消息（默认 3 条，最多 5 条）'),
     t('/workspace 工作区绝对路径  切换工作区'),
     t('/workspacelist  列出工作区绝对路径'),
-    t('/sessionlist [工作区序号或绝对路径]  列出会话 ID 和标题'),
+    t('/sessionlist 或 /sessions [工作区序号或绝对路径]  列出会话 ID 和标题'),
     t('/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话'),
     t('/models  按序号列出所有可用模型'),
     t('/reasoninglist 或 /reasonings  按序号列出当前模型可用推理等级'),
     t('/reasoning [序号、等级ID或 --default]  查看或切换当前推理等级'),
     t('/model [序号或完整模型ID] [推理等级ID]  查看或切换当前会话模型'),
     t('示例：先发 /models，再发 /model 2 [推理等级ID]'),
-    t('/presetlist  按序号列出可用 Agent Preset'),
+    t('/presetlist 或 /presets  按序号列出可用 Agent Preset'),
     t('/preset [序号或完整ID]  查看或设置当前机器人 Agent Preset'),
     t('纯数字 ID：/preset id:<ID>'),
     t('/preset --default  跟随 Host 默认'),

package/src/channels/qq/qq-controller.mjs

@@ -268,6 +268,20 @@ export class QqController {
     });
   }
 
+  async sendProactiveText(botId, target, text, options = {}) {
+    const config = this.#configStore.get(botId);
+    if (!config) throw new Error('Unknown QQ bot');
+    return this.#withBotTransition(botId, async () => {
+      const runtime = this.#runtimes.get(botId);
+      if (!runtime?.status?.ready || typeof runtime.sendProactiveText !== 'function') {
+        const error = new Error(t('QQ机器人尚未连接'));
+        error.code = 'bot-not-connected';
+        throw error;
+      }
+      return runtime.sendProactiveText(target, text, options);
+    });
+  }
+
   async deleteBot(botId) {
     const config = this.#configStore.get(botId);
     if (!config) throw new Error('Unknown QQ bot');

package/src/channels/qq/qq-runtime.mjs

@@ -97,6 +97,29 @@ export class QqRuntime {
     return { sent: true };
   }
 
+  async sendProactiveText(target, text, { signal } = {}) {
+    const nativeId = target?.kind === 'user'
+      ? (typeof target?.route?.userOpenId === 'string' ? target.route.userOpenId.trim() : '')
+      : target?.kind === 'group'
+        ? (typeof target?.route?.groupOpenId === 'string' ? target.route.groupOpenId.trim() : '')
+        : '';
+    if (!nativeId) {
+      const error = new TypeError('Invalid QQ proactive delivery target');
+      error.code = 'invalid-target';
+      throw error;
+    }
+    if (!this.#status.ready || !this.#bot) {
+      const error = new Error('QQ bot is not connected');
+      error.code = 'bot-not-connected';
+      throw error;
+    }
+    signal?.throwIfAborted();
+    return this.#bot.sendText({
+      scope: target.kind === 'user' ? 'c2c' : 'group',
+      targetId: nativeId,
+    }, text);
+  }
+
   async start() {
     if (this.#status.ready && this.#bot) return this.status;
     if (this.#starting) return this.#starting;

package/src/channels/shared/bot-workspace-store.mjs

@@ -49,8 +49,90 @@ function botIdOf(value) {
   return value;
 }
 
+function deliveryTargetError(code, message, options) {
+  const error = new Error(message, options);
+  error.code = code;
+  return error;
+}
+
+function targetIdOf(value) {
+  if (typeof value !== 'string'
+    || !/^[A-Za-z0-9._:@-]{1,128}$/.test(value)) {
+    throw deliveryTargetError('invalid-target', 'Invalid target id');
+  }
+  return value;
+}
+
+function jsonRecord(value) {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    throw deliveryTargetError('invalid-target', 'Invalid target route');
+  }
+  try {
+    const serialized = JSON.stringify(value);
+    if (serialized === undefined) throw new TypeError('route is not JSON');
+    const route = JSON.parse(serialized);
+    if (!route || typeof route !== 'object' || Array.isArray(route)) {
+      throw new TypeError('route is not an object');
+    }
+    return route;
+  } catch (cause) {
+    throw deliveryTargetError('invalid-target', 'Invalid target route', { cause });
+  }
+}
+
+function normalizeDeliveryTarget(value, { targetId } = {}) {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    throw deliveryTargetError('invalid-target', 'Invalid delivery target');
+  }
+  const allowed = targetId === undefined
+    ? new Set(['targetId', 'name', 'kind', 'route'])
+    : new Set(['name', 'kind', 'route']);
+  if (Object.keys(value).some((key) => !allowed.has(key))) {
+    throw deliveryTargetError('invalid-target', 'Invalid delivery target');
+  }
+  const id = targetIdOf(targetId ?? value.targetId);
+  if (typeof value.kind !== 'string' || !/^[a-z][a-z0-9-]{0,31}$/.test(value.kind)) {
+    throw deliveryTargetError('invalid-target', 'Invalid target kind');
+  }
+  let name;
+  if (value.name !== undefined) {
+    if (typeof value.name !== 'string' || !value.name.trim() || value.name.trim().length > 80) {
+      throw deliveryTargetError('invalid-target', 'Invalid target name');
+    }
+    name = value.name.trim();
+  }
+  return {
+    targetId: id,
+    ...(name === undefined ? {} : { name }),
+    kind: value.kind,
+    route: jsonRecord(value.route),
+  };
+}
+
+function normalizeDeliveryTargets(value) {
+  const deliveryTargets = Object.create(null);
+  if (value === undefined) return deliveryTargets;
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return null;
+  try {
+    for (const [botId, targets] of Object.entries(value)) {
+      botIdOf(botId);
+      if (!targets || typeof targets !== 'object' || Array.isArray(targets)) return null;
+      const normalizedTargets = Object.create(null);
+      for (const [targetId, target] of Object.entries(targets)) {
+        const normalized = normalizeDeliveryTarget(target, { targetId });
+        const { targetId: _targetId, ...stored } = normalized;
+        normalizedTargets[targetId] = stored;
+      }
+      deliveryTargets[botId] = normalizedTargets;
+    }
+  } catch {
+    return null;
+  }
+  return deliveryTargets;
+}
+
 function normalizeDocument(value) {
-  if (!value || value.version !== 1 || !value.workspaces
+  if (!value || ![1, 2].includes(value.version) || !value.workspaces
     || typeof value.workspaces !== 'object' || Array.isArray(value.workspaces)) return null;
   const workspaces = {};
   for (const [botId, workspace] of Object.entries(value.workspaces)) {
@@ -83,7 +165,16 @@ function normalizeDocument(value) {
       }
     }
   }
-  return { version: 1, workspaces, agentPresets, contextEnhancement };
+  if (value.version === 1 && value.deliveryTargets !== undefined) return null;
+  const deliveryTargets = normalizeDeliveryTargets(value.deliveryTargets);
+  if (!deliveryTargets) return null;
+  return {
+    version: value.version,
+    workspaces,
+    agentPresets,
+    contextEnhancement,
+    deliveryTargets,
+  };
 }
 
 export async function validateWorkspacePath(value) {
@@ -112,9 +203,11 @@ export async function validateWorkspacePath(value) {
 export class BotWorkspaceStore {
   #path;
   #defaultWorkspace;
+  #version = 1;
   #workspaces = {};
   #agentPresets = {};
   #contextEnhancement = {};
+  #deliveryTargets = Object.create(null);
   #generations = new Map();
   #nextGeneration = 1;
   #incarnations = new Map();
@@ -135,14 +228,18 @@ export class BotWorkspaceStore {
     try {
       const normalized = normalizeDocument(JSON.parse(await readFile(this.#path, 'utf8')));
       if (!normalized) throw new Error('dsh-im workspace config is invalid');
+      this.#version = normalized.version;
       this.#workspaces = normalized.workspaces;
       this.#agentPresets = normalized.agentPresets;
       this.#contextEnhancement = normalized.contextEnhancement;
+      this.#deliveryTargets = normalized.deliveryTargets;
     } catch (error) {
       if (error?.code !== 'ENOENT') throw error;
+      this.#version = 1;
       this.#workspaces = {};
       this.#agentPresets = {};
       this.#contextEnhancement = {};
+      this.#deliveryTargets = Object.create(null);
     }
     this.#generations.clear();
     this.#nextGeneration = 1;
@@ -181,6 +278,83 @@ export class BotWorkspaceStore {
       : DEFAULT_CONTEXT_ENHANCEMENT_CONFIG;
   }
 
+  listDeliveryTargets(botId) {
+    const id = botIdOf(botId);
+    if (!this.has(id)) throw deliveryTargetError('unknown-bot', 'Unknown bot');
+    return Object.entries(this.#deliveryTargets[id] ?? {})
+      .map(([targetId, target]) => normalizeDeliveryTarget(target, { targetId }))
+      .sort((left, right) => left.targetId.localeCompare(right.targetId));
+  }
+
+  deliveryTargetFor(botId, targetId) {
+    const id = botIdOf(botId);
+    const targetKey = targetIdOf(targetId);
+    if (!this.has(id)) throw deliveryTargetError('unknown-bot', 'Unknown bot');
+    const target = this.#deliveryTargets[id]?.[targetKey];
+    return target ? normalizeDeliveryTarget(target, { targetId: targetKey }) : null;
+  }
+
+  async createDeliveryTarget(botId, value) {
+    const id = botIdOf(botId);
+    const target = normalizeDeliveryTarget(value);
+    return this.#enqueue(id, async () => {
+      if (!this.has(id)) throw deliveryTargetError('unknown-bot', 'Unknown bot');
+      if (Object.hasOwn(this.#deliveryTargets[id] ?? {}, target.targetId)) {
+        throw deliveryTargetError('target-conflict', 'Target already exists');
+      }
+      const { targetId, ...stored } = target;
+      const next = {
+        ...this.#deliveryTargets,
+        [id]: { ...(this.#deliveryTargets[id] ?? {}), [targetId]: stored },
+      };
+      await this.#persist(this.#contextEnhancement, next, 2);
+      this.#deliveryTargets = next;
+      this.#version = 2;
+      return normalizeDeliveryTarget(stored, { targetId });
+    });
+  }
+
+  async updateDeliveryTarget(botId, targetId, value) {
+    const id = botIdOf(botId);
+    const targetKey = targetIdOf(targetId);
+    const replacement = normalizeDeliveryTarget(value, { targetId: targetKey });
+    return this.#enqueue(id, async () => {
+      if (!this.has(id)) throw deliveryTargetError('unknown-bot', 'Unknown bot');
+      if (!Object.hasOwn(this.#deliveryTargets[id] ?? {}, targetKey)) {
+        throw deliveryTargetError('unknown-target', 'Unknown target');
+      }
+      const { targetId: _targetId, ...stored } = replacement;
+      const next = {
+        ...this.#deliveryTargets,
+        [id]: { ...this.#deliveryTargets[id], [targetKey]: stored },
+      };
+      await this.#persist(this.#contextEnhancement, next, 2);
+      this.#deliveryTargets = next;
+      this.#version = 2;
+      return normalizeDeliveryTarget(stored, { targetId: targetKey });
+    });
+  }
+
+  async deleteDeliveryTarget(botId, targetId) {
+    const id = botIdOf(botId);
+    const targetKey = targetIdOf(targetId);
+    return this.#enqueue(id, async () => {
+      if (!this.has(id)) throw deliveryTargetError('unknown-bot', 'Unknown bot');
+      if (!Object.hasOwn(this.#deliveryTargets[id] ?? {}, targetKey)) {
+        throw deliveryTargetError('unknown-target', 'Unknown target');
+      }
+      const botTargets = { ...this.#deliveryTargets[id] };
+      delete botTargets[targetKey];
+      const next = { ...this.#deliveryTargets };
+      if (Object.keys(botTargets).length > 0) next[id] = botTargets;
+      else delete next[id];
+      await this.#persist(this.#contextEnhancement, next, 2);
+      this.#deliveryTargets = next;
+      this.#version = 2;
+      return true;
+    });
+  }
+
   generationFor(botId) {
     return this.#generations.get(botIdOf(botId)) ?? null;
   }
@@ -471,6 +645,7 @@ export class BotWorkspaceStore {
       ...Object.keys(this.#workspaces),
       ...Object.keys(this.#agentPresets),
       ...Object.keys(this.#contextEnhancement),
+      ...Object.keys(this.#deliveryTargets),
       ...this.#dirtyRemovals,
     ]);
     for (const botId of candidates) {
@@ -518,10 +693,13 @@ export class BotWorkspaceStore {
     const hadWorkspace = Object.hasOwn(this.#workspaces, id);
     const hadPreset = Object.hasOwn(this.#agentPresets, id);
     const hadContextEnhancement = Object.hasOwn(this.#contextEnhancement, id);
-    const needsCleanup = hadWorkspace || hadPreset || hadContextEnhancement || this.#dirtyRemovals.has(id);
+    const hadDeliveryTargets = Object.hasOwn(this.#deliveryTargets, id);
+    const needsCleanup = hadWorkspace || hadPreset || hadContextEnhancement
+      || hadDeliveryTargets || this.#dirtyRemovals.has(id);
     delete this.#workspaces[id];
     delete this.#agentPresets[id];
     delete this.#contextEnhancement[id];
+    delete this.#deliveryTargets[id];
     this.#generations.delete(id);
     this.#incarnations.delete(id);
     if (!needsCleanup) return {
@@ -551,14 +729,21 @@ export class BotWorkspaceStore {
     return queued;
   }
 
-  async #persist(contextEnhancement = this.#contextEnhancement) {
-    const document = { version: 1, workspaces: this.#workspaces };
+  async #persist(
+    contextEnhancement = this.#contextEnhancement,
+    deliveryTargets = this.#deliveryTargets,
+    version = this.#version,
+  ) {
+    const document = { version, workspaces: this.#workspaces };
     if (Object.keys(this.#agentPresets).length > 0) {
       document.agentPresets = this.#agentPresets;
     }
     if (Object.keys(contextEnhancement).length > 0) {
       document.contextEnhancement = contextEnhancement;
     }
+    if (version >= 2 && Object.keys(deliveryTargets).length > 0) {
+      document.deliveryTargets = deliveryTargets;
+    }
     await mkdir(dirname(this.#path), { recursive: true, mode: 0o700 });
     const temporary = `${this.#path}.tmp`;
     await writeFile(temporary, `${JSON.stringify(document, null, 2)}\n`, {
@@ -572,7 +757,8 @@ export class BotWorkspaceStore {
   async #persistCurrentDocument() {
     if (Object.keys(this.#workspaces).length > 0
       || Object.keys(this.#agentPresets).length > 0
-      || Object.keys(this.#contextEnhancement).length > 0) {
+      || Object.keys(this.#contextEnhancement).length > 0
+      || Object.keys(this.#deliveryTargets).length > 0) {
       await this.#persist();
       return;
     }

package/src/channels/shared/i18n-en/feishu.mjs

@@ -223,6 +223,8 @@ export default {
   '📊 系统状态': '📊 System status',
   '📋 会话 / 工作区': '📋 Sessions / workspace',
   '/sessionlist  列出工作区会话': '/sessionlist  List workspace sessions',
+  '/sessionlist 或 /sessions  列出工作区会话':
+    '/sessionlist or /sessions  List workspace sessions',
   '/session ID  绑定已有会话': '/session ID  Bind an existing session',
   '/workspacelist  列出工作区': '/workspacelist  List workspaces',
   '/workspace 路径  切换工作区': '/workspace PATH  Switch workspace',
@@ -239,12 +241,14 @@ export default {
   '📦 批量输入（仅私聊）': '📦 Batch input (direct messages only)',
   '🤖 预设 / 模型': '🤖 Presets / models',
   '/models  列出模型': '/models  List models',
+  '/presetlist 或 /presets  列出可用 Agent Preset':
+    '/presetlist or /presets  List available Agent Presets',
   '🎮 任务控制': '🎮 Task controls',
   '/steer 指令  给 Agent 补充指令': '/steer INSTRUCTION  Steer the Agent',
   '**📋 卡片功能**\n\n1. 会话下拉 — 切换当前绑定会话\n2. 工作区下拉 — 切换工作区\n3. 🤖 预设下拉 — 切换 Agent 预设\n4. 🧠 模型下拉 — 切换模型\n5. 🆕 新会话 — 开启全新会话\n6. 📋 会话/关注 — 查看/绑定会话，管理关注\n7. ⏹ 停止 — 停止当前任务\n8. 📐 压缩 — 压缩当前会话上下文\n9. 补充指令 — 给 Agent 发送指令\n10. 🗄 归档切换 — 显示/隐藏归档会话\n11. 📊 状态 — 查看系统连接状态\n12. 📖 帮助 — 查看本帮助':
     '**📋 Card features**\n\n1. Session dropdown — switch the bound session\n2. Workspace dropdown — switch workspace\n3. 🤖 Preset dropdown — switch Agent Preset\n4. 🧠 Model dropdown — switch model\n5. 🆕 New session — start fresh\n6. 📋 Sessions/watches — view or bind sessions and manage watches\n7. ⏹ Stop — stop the current task\n8. 📐 Compact — compact the current session context\n9. Steer task — send an instruction to the Agent\n10. 🗄 Archived toggle — show or hide archived sessions\n11. 📊 Status — view connection status\n12. 📖 Help — view this help',
-  '**⌨️ 文本命令**\n\n`/m` — 打开菜单卡片\n`/new` — 开启全新会话\n`/session ID` — 绑定已有会话\n`/sessionlist [工作区]` — 列出会话\n`/workspace 路径` — 切换工作区\n`/workspacelist` — 列出工作区\n`/status` — 查看连接状态\n`/compact` — 压缩上下文\n`/stop` — 停止当前任务\n`/steer 指令` — 补充指令\n`/watch ID` — 关注会话\n`/watchlist` — 关注列表\n`/unwatch ID` — 取消关注\n`/archived on/off` — 归档显隐\n`/presetlist` — 列出预设\n`/preset [序号/ID]` — 切换预设\n`/preset --default` — 跟随默认\n`/models` — 列出模型\n`/reasoninglist` 或 `/reasonings` — 按序号列出当前模型可用推理等级\n`/reasoning [序号、等级ID或 --default]` — 查看或切换当前推理等级\n`/model [序号或完整模型ID] [推理等级ID]` — 查看或切换当前会话模型\n`/batch` — 开启批量输入（仅私聊，最多 10 条文字）\n`/send` — 提交当前批次\n`/cancel` — 取消当前批次\n`/repair` — 补全飞书权限与卡片回调':
-    '**⌨️ Text commands**\n\n`/m` — open the menu card\n`/new` — start a new session\n`/session ID` — bind an existing session\n`/sessionlist [workspace]` — list sessions\n`/workspace PATH` — switch workspace\n`/workspacelist` — list workspaces\n`/status` — view connection status\n`/compact` — compact context\n`/stop` — stop the current task\n`/steer INSTRUCTION` — steer the task\n`/watch ID` — watch a session\n`/watchlist` — list watched sessions\n`/unwatch ID` — stop watching\n`/archived on/off` — show or hide archived sessions\n`/presetlist` — list presets\n`/preset [index/ID]` — switch preset\n`/preset --default` — follow default\n`/models` — list models\n`/reasoninglist` or `/reasonings` — list reasoning efforts for the current model\n`/reasoning [index, effort ID, or --default]` — show or switch reasoning effort\n`/model [index or full model ID] [reasoning effort ID]` — show or switch the current Session model\n`/batch` — start batch input (direct messages only, up to 10 text messages)\n`/send` — submit the current batch\n`/cancel` — cancel the current batch\n`/repair` — complete Feishu permissions and the card callback',
+  '**⌨️ 文本命令**\n\n`/m` — 打开菜单卡片\n`/new` — 开启全新会话\n`/session ID` — 绑定已有会话\n`/sessionlist [工作区]` 或 `/sessions [工作区]` — 列出会话\n`/workspace 路径` — 切换工作区\n`/workspacelist` — 列出工作区\n`/status` — 查看连接状态\n`/compact` — 压缩上下文\n`/stop` — 停止当前任务\n`/steer 指令` — 补充指令\n`/watch ID` — 关注会话\n`/watchlist` — 关注列表\n`/unwatch ID` — 取消关注\n`/archived on/off` — 归档显隐\n`/presetlist` 或 `/presets` — 列出预设\n`/preset [序号/ID]` — 切换预设\n`/preset --default` — 跟随默认\n`/models` — 列出模型\n`/reasoninglist` 或 `/reasonings` — 按序号列出当前模型可用推理等级\n`/reasoning [序号、等级ID或 --default]` — 查看或切换当前推理等级\n`/model [序号或完整模型ID] [推理等级ID]` — 查看或切换当前会话模型\n`/batch` — 开启批量输入（仅私聊，最多 10 条文字）\n`/send` — 提交当前批次\n`/cancel` — 取消当前批次\n`/repair` — 补全飞书权限与卡片回调':
+    '**⌨️ Text commands**\n\n`/m` — open the menu card\n`/new` — start a new session\n`/session ID` — bind an existing session\n`/sessionlist [workspace]` or `/sessions [workspace]` — list sessions\n`/workspace PATH` — switch workspace\n`/workspacelist` — list workspaces\n`/status` — view connection status\n`/compact` — compact context\n`/stop` — stop the current task\n`/steer INSTRUCTION` — steer the task\n`/watch ID` — watch a session\n`/watchlist` — list watched sessions\n`/unwatch ID` — stop watching\n`/archived on/off` — show or hide archived sessions\n`/presetlist` or `/presets` — list presets\n`/preset [index/ID]` — switch preset\n`/preset --default` — follow default\n`/models` — list models\n`/reasoninglist` or `/reasonings` — list reasoning efforts for the current model\n`/reasoning [index, effort ID, or --default]` — show or switch reasoning effort\n`/model [index or full model ID] [reasoning effort ID]` — show or switch the current Session model\n`/batch` — start batch input (direct messages only, up to 10 text messages)\n`/send` — submit the current batch\n`/cancel` — cancel the current batch\n`/repair` — complete Feishu permissions and the card callback',
   '**💡 数字兜底**\n回复数字快速操作：\n**1**工作区列表 · **2**新会话 · **3**会话/关注\n**4**状态 · **5**补全权限 · **6**帮助':
     '**💡 Number fallback**\nReply with a number for a quick action:\n**1** Workspace list · **2** New session · **3** Sessions/watches\n**4** Status · **5** Complete permissions · **6** Help',
   '从下方下拉选择补充指令；最后一项可自定义输入。':

package/src/channels/shared/i18n-en/shared-a.mjs

@@ -124,6 +124,8 @@ export default {
   '/workspacelist  列出工作区绝对路径': '/workspacelist  List absolute workspace paths',
   '/sessionlist [工作区序号或绝对路径]  列出会话 ID 和标题':
     '/sessionlist [workspace index or absolute path]  List session IDs and titles',
+  '/sessionlist 或 /sessions [工作区序号或绝对路径]  列出会话 ID 和标题':
+    '/sessionlist or /sessions [workspace index or absolute path]  List session IDs and titles',
   '/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话':
     '/session <Session ID or workspace index>  Bind this chat to the specified session',
   '/models  按序号列出所有可用模型': '/models  List all available models by index',
@@ -139,6 +141,8 @@ export default {
   '示例：先发 /models，再发 /model 2 [推理等级ID]':
     'Example: send /models first, then /model 2 [reasoning effort ID]',
   '/presetlist  按序号列出可用 Agent Preset': '/presetlist  List available Agent Presets by index',
+  '/presetlist 或 /presets  按序号列出可用 Agent Preset':
+    '/presetlist or /presets  List available Agent Presets by index',
   '/preset [序号或完整ID]  查看或设置当前机器人 Agent Preset':
     '/preset [index or full ID]  Show or set the Agent Preset of this bot',
   '纯数字 ID：/preset id:<ID>': 'Numeric-only ID: /preset id:<ID>',

package/src/channels/shared/preset-command.mjs

@@ -8,7 +8,7 @@ import { splitWorkspaceCommandMessage } from './workspace-command.mjs';
 import { WORKSPACE_SESSION_STALE } from './workspace-session.mjs';
 
 const PRESET_COMMAND = /^\/preset(?=$|\s)/iu;
-const PRESET_LIST_COMMAND = /^\/presetlist(?=$|\s)/iu;
+const PRESET_LIST_COMMAND = /^\/(?:presetlist|presets)(?=$|\s)/iu;
 const PRESET_LIST_USAGE = '用法：/presetlist（不带参数）';
 const PRESET_USAGE = [
   '用法：',
@@ -257,7 +257,7 @@ export async function runPresetCommand(text, harness, state, key, options = {})
   const requestOptions = rpcOptions(options.signal);
 
   if (PRESET_LIST_COMMAND.test(command)) {
-    if (!/^\/presetlist[ \t]*$/iu.test(command)) return commandResult(t(PRESET_LIST_USAGE));
+    if (!/^\/(?:presetlist|presets)[ \t]*$/iu.test(command)) return commandResult(t(PRESET_LIST_USAGE));
     try {
       const current = await settings(harness, requestOptions);
       saveSnapshot(state, key, current.agentPresetCatalog.items);

package/src/channels/shared/text-harness-bridge.mjs

@@ -469,6 +469,11 @@ export class TextHarnessBridge {
     });
   }
 
+  sendProactiveText(target, text, { signal } = {}) {
+    signal?.throwIfAborted();
+    return this.#bot.sendText(target, text);
+  }
+
   async #deliverArtifacts(target, replyTo, artifacts = [], baseReceipt) {
     const delivery = await deliverOutboundArtifacts({
       artifacts,
@@ -542,14 +547,14 @@ export class TextHarnessBridge {
           t('/history [数量]  查看最近历史消息（默认 3 条，最多 5 条）'),
           t('/workspace 工作区绝对路径  切换工作区'),
           t('/workspacelist  列出工作区绝对路径'),
-          t('/sessionlist [工作区序号或绝对路径]  列出会话 ID 和标题'),
+          t('/sessionlist 或 /sessions [工作区序号或绝对路径]  列出会话 ID 和标题'),
           t('/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话'),
           t('/models  按序号列出所有可用模型'),
           t('/reasoninglist 或 /reasonings  按序号列出当前模型可用推理等级'),
           t('/reasoning [序号、等级ID或 --default]  查看或切换当前推理等级'),
           t('/model [序号或完整模型ID] [推理等级ID]  查看或切换当前会话模型'),
           t('示例：先发 /models，再发 /model 2 [推理等级ID]'),
-          t('/presetlist  按序号列出可用 Agent Preset'),
+          t('/presetlist 或 /presets  按序号列出可用 Agent Preset'),
           t('/preset [序号或完整ID]  查看或设置当前机器人 Agent Preset'),
           t('纯数字 ID：/preset id:<ID>'),
           t('/preset --default  跟随 Host 默认'),

package/src/channels/shared/token-bot-controller.mjs

@@ -227,6 +227,22 @@ export class TokenBotController {
     });
   }
 
+  async sendProactiveText(botId, target, text, options = {}) {
+    const config = this.#configStore.get(botId);
+    if (!config) throw new Error(`Unknown ${this.#descriptor.label} bot`);
+    return this.#withBotTransition(botId, async () => {
+      const runtime = this.#runtimes.get(botId);
+      if (!runtime?.status?.ready || typeof runtime.sendProactiveText !== 'function') {
+        const error = new Error(t('{label}机器人尚未连接', {
+          label: this.#descriptor.label,
+        }));
+        error.code = 'bot-not-connected';
+        throw error;
+      }
+      return runtime.sendProactiveText(target, text, options);
+    });
+  }
+
   async deleteBot(botId) {
     const config = this.#configStore.get(botId);
     if (!config) throw new Error(`Unknown ${this.#descriptor.label} bot`);

package/src/channels/shared/workspace-command.mjs

@@ -6,7 +6,7 @@ import { WORKSPACE_SESSION_STALE } from './workspace-session.mjs';
 
 const WORKSPACE_COMMAND = /^\/workspace(?:\s+([\s\S]+))?$/i;
 const WORKSPACE_LIST_COMMAND = /^\/workspacelist(?:\s+([\s\S]+))?$/i;
-const SESSION_LIST_COMMAND = /^\/sessionlist(?:\s+([\s\S]+))?$/i;
+const SESSION_LIST_COMMAND = /^\/(?:sessionlist|sessions)(?:\s+([\s\S]+))?$/i;
 const SESSION_BIND_PREFIX = /^\/session(?=$|\s)/i;
 const SESSION_BIND_COMMAND = /^\/session[ \t]+([^\s]+)$/i;
 const MAX_WORKSPACE_PATH_LENGTH = 4_096;

package/src/channels/slack/slack-controller.mjs

@@ -189,6 +189,20 @@ export class SlackController {
     });
   }
 
+  async sendProactiveText(botId, target, text, options = {}) {
+    const config = this.#configStore.get(botId);
+    if (!config) throw new Error('Unknown Slack bot');
+    return this.#withBotTransition(botId, async () => {
+      const runtime = this.#runtimes.get(botId);
+      if (!runtime?.status?.ready || typeof runtime.sendProactiveText !== 'function') {
+        const error = new Error(t('Slack机器人尚未连接'));
+        error.code = 'bot-not-connected';
+        throw error;
+      }
+      return runtime.sendProactiveText(target, text, options);
+    });
+  }
+
   async deleteBot(botId) {
     const config = this.#configStore.get(botId);
     if (!config) throw new Error('Unknown Slack bot');

package/src/channels/slack/slack-runtime.mjs

@@ -407,6 +407,30 @@ export class SlackRuntime {
     return this.#bridge.sendConnectionTest(text);
   }
 
+  async sendProactiveText(target, text, options = {}) {
+    if (!this.#status.ready || !this.#bridge) {
+      const error = new Error('Slack bot is not connected');
+      error.code = 'bot-not-connected';
+      throw error;
+    }
+    const channelId = typeof target?.route?.channelId === 'string'
+      ? target.route.channelId.trim() : '';
+    const threadTs = typeof target?.route?.threadTs === 'string'
+      ? target.route.threadTs.trim() : '';
+    if (!channelId
+      || (target?.kind !== 'conversation' && target?.kind !== 'thread')
+      || (target.kind === 'thread' && !threadTs)
+      || (target.kind === 'conversation' && threadTs)) {
+      const error = new TypeError('Invalid Slack proactive delivery target');
+      error.code = 'invalid-target';
+      throw error;
+    }
+    return this.#bridge.sendProactiveText({
+      channelId,
+      ...(threadTs ? { threadTs } : {}),
+    }, text, options);
+  }
+
   async start() {
     if (this.#status.ready && this.#socket) return this.status;
     if (this.#starting) return this.#starting;

package/src/channels/telegram/telegram-runtime.mjs

@@ -22,10 +22,12 @@ export const TELEGRAM_COMMAND_MENU = Object.freeze([
   { command: 'workspace', description: '切换工作区' },
   { command: 'workspacelist', description: '列出工作区绝对路径' },
   { command: 'sessionlist', description: '列出会话 ID 和标题' },
+  { command: 'sessions', description: '列出会话 ID 和标题' },
   { command: 'session', description: '将当前聊天绑定到指定会话' },
   { command: 'models', description: '按序号列出所有可用模型' },
   { command: 'model', description: '查看或切换当前会话模型' },
   { command: 'presetlist', description: '列出可用 Agent Preset' },
+  { command: 'presets', description: '列出可用 Agent Preset' },
   { command: 'preset', description: '查看或设置新会话 Agent Preset' },
   { command: 'stop', description: '停止当前任务' },
   { command: 'steer', description: '纠偏当前任务' },
@@ -717,6 +719,30 @@ export class TelegramRuntime {
     return this.#bridge.sendConnectionTest(text);
   }
 
+  async sendProactiveText(target, text, options = {}) {
+    if (!this.#status.ready || !this.#bridge) {
+      const error = new Error('Telegram bot is not connected');
+      error.code = 'bot-not-connected';
+      throw error;
+    }
+    const chatIdText = typeof target?.route?.chatId === 'string'
+      ? target.route.chatId.trim() : '';
+    const chatId = Number(chatIdText);
+    const messageThreadId = target?.route?.messageThreadId;
+    if (!/^-?\d+$/.test(chatIdText) || !Number.isSafeInteger(chatId)
+      || (target?.kind !== 'chat' && target?.kind !== 'topic')
+      || (target.kind === 'topic' && (!Number.isSafeInteger(messageThreadId) || messageThreadId <= 0))
+      || (target.kind === 'chat' && messageThreadId !== undefined)) {
+      const error = new TypeError('Invalid Telegram proactive delivery target');
+      error.code = 'invalid-target';
+      throw error;
+    }
+    return this.#bridge.sendProactiveText({
+      chatId,
+      ...(target.kind === 'topic' ? { messageThreadId } : {}),
+    }, text, options);
+  }
+
   async start() {
     if (this.#status.ready && this.#pollTask) return this.status;
     if (this.#starting) return this.#starting;

package/src/channels/wecom/state-store.mjs

@@ -72,6 +72,10 @@ export class WecomStateStore {
     await this.#persist();
   }
 
+  snapshot() {
+    return structuredClone(this.#state);
+  }
+
   async remove() {
     try {
       await unlink(this.#path);