@xmanrui/dsh-im 4.6.0 → 4.8.0

package/package.json

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

package/plugin-src/client/context-enhancement.js

@@ -17,6 +17,8 @@ const FIELD_LABELS = Object.freeze({
   senderId: '发送者标识',
   senderName: '发送者昵称',
   conversationTitle: '会话标题',
+  chatId: '会话标识',
+  threadId: '话题标识',
   botId: '机器人标识',
 });
 
@@ -29,6 +31,14 @@ const FIELD_HELP = Object.freeze({
     labelKey: 'conversationTitleHelpLabel',
     text: '该字段不是每个渠道都能提供。钉钉群聊会带上群名。当前消息没有会话标题时，即使已选择该字段，<dsh_im_source> 中也会省略 conversationTitle。',
   }),
+  chatId: Object.freeze({
+    labelKey: 'chatIdHelpLabel',
+    text: '该字段不是每个渠道都能提供。会话标识用于区分不同的群组或私聊，飞书群聊会带上群 ID。当前消息没有会话标识时，即使已选择该字段，<dsh_im_source> 中也会省略 chatId。',
+  }),
+  threadId: Object.freeze({
+    labelKey: 'threadIdHelpLabel',
+    text: '该字段不是每个渠道都能提供。飞书话题群的消息会带上话题 ID，用于区分同一群组内的不同话题；当前消息不在话题中时，即使已选择该字段，<dsh_im_source> 中也会省略 threadId。',
+  }),
 });
 
 const SCOPE_COPY = Object.freeze({
@@ -38,6 +48,8 @@ const SCOPE_COPY = Object.freeze({
     fieldsHelpLabel: '查看群聊来源字段说明',
     senderNameHelpLabel: '查看群聊发送者昵称字段说明',
     conversationTitleHelpLabel: '查看群聊会话标题字段说明',
+    chatIdHelpLabel: '查看群聊会话标识字段说明',
+    threadIdHelpLabel: '查看群聊话题标识字段说明',
     guidanceLabel: '增强提示词',
     guidanceHelpLabel: '查看群聊增强提示词使用说明',
     guidanceUsage: '用于告诉模型如何使用当前群聊消息的 <dsh_im_source> 来源字段。只填写正文，插件会自动添加 <dsh_im_source_guidance> 成对标签。',
@@ -49,6 +61,8 @@ const SCOPE_COPY = Object.freeze({
     fieldsHelpLabel: '查看私聊来源字段说明',
     senderNameHelpLabel: '查看私聊发送者昵称字段说明',
     conversationTitleHelpLabel: '查看私聊会话标题字段说明',
+    chatIdHelpLabel: '查看私聊会话标识字段说明',
+    threadIdHelpLabel: '查看私聊话题标识字段说明',
     guidanceLabel: '增强提示词',
     guidanceHelpLabel: '查看私聊增强提示词使用说明',
     guidanceUsage: '用于告诉模型如何使用当前私聊消息的 <dsh_im_source> 来源字段。只填写正文，插件会自动添加 <dsh_im_source_guidance> 成对标签。',

package/plugin-src/client/i18n.js

@@ -292,6 +292,14 @@ const EN = Object.freeze({
   '查看群聊会话标题字段说明': 'View group conversation title field details',
   '查看私聊会话标题字段说明': 'View direct conversation title field details',
   '该字段不是每个渠道都能提供。钉钉群聊会带上群名。当前消息没有会话标题时，即使已选择该字段，<dsh_im_source> 中也会省略 conversationTitle。': 'This field is not available on every channel. DingTalk group chats include the group name. If the current message has no conversation title, <dsh_im_source> omits conversationTitle even when the field is selected.',
+  '会话标识': 'Chat ID',
+  '查看群聊会话标识字段说明': 'View group chat ID field details',
+  '查看私聊会话标识字段说明': 'View direct chat ID field details',
+  '该字段不是每个渠道都能提供。会话标识用于区分不同的群组或私聊，飞书群聊会带上群 ID。当前消息没有会话标识时，即使已选择该字段，<dsh_im_source> 中也会省略 chatId。': 'This field is not available on every channel. The chat ID distinguishes different groups or direct chats, and Feishu group chats include the group ID. If the current message has no chat ID, <dsh_im_source> omits chatId even when the field is selected.',
+  '话题标识': 'Topic ID',
+  '查看群聊话题标识字段说明': 'View group topic ID field details',
+  '查看私聊话题标识字段说明': 'View direct topic ID field details',
+  '该字段不是每个渠道都能提供。飞书话题群的消息会带上话题 ID，用于区分同一群组内的不同话题；当前消息不在话题中时，即使已选择该字段，<dsh_im_source> 中也会省略 threadId。': 'This field is not available on every channel. Messages in a Feishu topic chat carry the topic ID, which distinguishes different topics inside the same group. If the current message is not inside a topic, <dsh_im_source> omits threadId even when the field is selected.',
   '机器人标识': 'Bot ID',
   '增强提示词': 'Guidance',
   '查看增强提示词使用说明': 'View guidance instructions',
@@ -319,7 +327,7 @@ const EN = Object.freeze({
   '上下文增强保存失败，请重试。': 'Could not save context enhancement. Try again.',
   '请提交完整的上下文增强设置。': 'Submit the complete context enhancement settings.',
   '群聊和私聊开关必须是布尔值。': 'Group and direct switches must be booleans.',
-  '来源字段只能选择已定义的六个字段。': 'Source fields must be chosen from the six defined fields.',
+  '来源字段只能选择已定义的八个字段。': 'Source fields must be chosen from the eight defined fields.',
   '保存中…': 'Saving…',
   '未设置': 'Not set',
   '工作区修改失败，请重试。': 'Could not update the workspace. Try again.',

package/plugin-src/client/workspace-directory-picker.js

@@ -7,6 +7,17 @@ function pickerErrorCode(error) {
   return error?.rpcError?.code ?? error?.code;
 }
 
+const PICKER_ERROR_KINDS = new Map([
+  ['directory-picker/unavailable', 'unavailable'],
+  ['directory-picker-unavailable', 'unavailable'],
+  ['directory-picker/unreadable', 'unreadable'],
+  ['directory-unreadable', 'unreadable'],
+]);
+
+function pickerErrorKind(error) {
+  return PICKER_ERROR_KINDS.get(pickerErrorCode(error));
+}
+
 function pickerErrorDetails(error) {
   return error?.rpcError?.details ?? error?.details;
 }
@@ -110,9 +121,9 @@ export function WorkspaceDirectoryPicker({
       const initialPath = initialPathRef.current;
       const initial = await loadDirectory(initialPath || undefined, { reportError: false });
       if (!active || initial.aborted || initial.value) return;
-      const code = pickerErrorCode(initial.error);
+      const kind = pickerErrorKind(initial.error);
       const details = pickerErrorDetails(initial.error);
-      if (code === 'directory-picker-unavailable'
+      if (kind === 'unavailable'
         && details?.capability === 'native'
         && typeof picker.pickDirectory === 'function') {
         setLoading(true);
@@ -128,7 +139,7 @@ export function WorkspaceDirectoryPicker({
         }
         return;
       }
-      if (initialPath && code === 'directory-unreadable') {
+      if (initialPath && kind === 'unreadable') {
         const home = await loadDirectory(undefined, { reportError: false });
         if (!active || home.aborted || home.value) return;
         setError(pickerErrorMessage(home.error));

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

@@ -82,6 +82,7 @@ const HELP_TEXT_LINES = [
   '/workspace 工作区序号或绝对路径  切换工作区',
   '/workspacelist  列出工作区绝对路径',
   '/sessionlist 或 /sessions [工作区序号或绝对路径]  列出会话 ID 和标题',
+  '/sessionlist --limit N  仅列出当前工作区前 N 个会话',
   '/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话',
   '/models  按序号列出所有可用模型',
   '/reasoninglist 或 /reasonings  按序号列出当前模型可用推理等级',
@@ -1135,6 +1136,7 @@ export class DingtalkHarnessBridge {
           senderId: sender,
           senderName: message.senderNick,
           conversationTitle: message.conversationTitle,
+          chatId: message.conversationId,
         }));
         contextEnhanced = content !== originalContent;
       }

package/src/channels/feishu/bridge.mjs

@@ -47,7 +47,12 @@ import {
   isPresetCommand,
   runPresetCommand,
 } from '../shared/preset-command.mjs';
-import { runWorkspaceCommand, resolveSessionListWorkspace, workspacePathSnapshot } from '../shared/workspace-command.mjs';
+import {
+  parseSessionListArgument,
+  resolveSessionListWorkspace,
+  runWorkspaceCommand,
+  workspacePathSnapshot,
+} from '../shared/workspace-command.mjs';
 import { askInWorkspaceSession } from '../shared/workspace-session.mjs';
 import { captureContextEnhancement, enhanceContextContent } from '../shared/context-enhancement.mjs';
 import { deliverOutboundArtifacts } from '../shared/semantic/artifact-delivery.mjs';
@@ -160,6 +165,7 @@ const WORKSPACE_HELP_LINES = [
   '/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话',
   '/workspacelist  列出工作区绝对路径',
   '/sessionlist 或 /sessions [工作区序号或绝对路径]  列出会话 ID 和标题',
+  '/sessionlist --limit N  仅列出当前工作区前 N 个会话',
 ];
 
 /** Safe user-facing text for bind/workspace failures (no raw messages). */
@@ -1085,8 +1091,18 @@ export class FeishuHarnessBridge {
       return;
     }
     if (SESSION_LIST_PREFIX.test(commandText)) {
-      const selector = commandText.replace(/^\/(?:sessionlist|sessions)/i, '').trim() || null;
-      await this.#showSessions({ chatId: event.message.chat_id, key, replyTo: event.message.message_id }, selector, 0);
+      const argument = commandText.replace(/^\/(?:sessionlist|sessions)/i, '').trim();
+      const request = parseSessionListArgument(argument);
+      if (request.error) {
+        await this.#send(event.message.chat_id, request.error, { replyTo: event.message.message_id });
+        return;
+      }
+      await this.#showSessions(
+        { chatId: event.message.chat_id, key, replyTo: event.message.message_id },
+        request.selector || null,
+        0,
+        { limit: request.limit },
+      );
       return;
     }
     if (WORKSPACE_LIST_COMMAND.test(commandText)) {
@@ -1850,6 +1866,7 @@ export class FeishuHarnessBridge {
     messageId = null,
     sessionWorkspace = null,
     sessionPage = 0,
+    sessionLimit = null,
     selections = [],
   }) {
     // Confirmations triggered by a card interaction stay anchored to the
@@ -1861,7 +1878,7 @@ export class FeishuHarnessBridge {
         { chatId, key, replyTo: messageId },
         sessionWorkspace,
         page,
-        { updateMessageId: messageId },
+        { updateMessageId: messageId, limit: sessionLimit },
       );
       return;
     }
@@ -2040,7 +2057,7 @@ export class FeishuHarnessBridge {
           { chatId, key, replyTo: messageId },
           sessionWorkspace,
           sessionPage,
-          { updateMessageId: messageId },
+          { updateMessageId: messageId, limit: sessionLimit },
         );
       }
       return;
@@ -2056,7 +2073,7 @@ export class FeishuHarnessBridge {
           { chatId, key, replyTo: messageId },
           sessionWorkspace,
           sessionPage,
-          { updateMessageId: messageId },
+          { updateMessageId: messageId, limit: sessionLimit },
         );
       }
     }
@@ -2141,7 +2158,7 @@ export class FeishuHarnessBridge {
     { chatId, key, replyTo = null },
     selector,
     page = 0,
-    { updateMessageId = null } = {},
+    { updateMessageId = null, limit = null } = {},
   ) {
     try {
       const signal = this.#cardDataSignal();
@@ -2151,7 +2168,11 @@ export class FeishuHarnessBridge {
         return;
       }
       const listed = await this.#harness.listWorkspaceSessions(resolved.workspace, { signal });
-      const sessions = this.#visibleSessions(Array.isArray(listed?.sessions) ? listed.sessions : []);
+      const visibleSessions = this.#visibleSessions(Array.isArray(listed?.sessions) ? listed.sessions : []);
+      const sessionLimit = Number.isSafeInteger(limit) && limit > 0 ? limit : null;
+      const sessions = sessionLimit === null
+        ? visibleSessions
+        : visibleSessions.slice(0, sessionLimit);
       const workspace = listed?.workspace ?? resolved.workspace;
       if (sessions.length === 0) {
         await this.#send(chatId, t('工作区：{workspace}\n该工作区暂无会话。', { workspace }), { replyTo });
@@ -2178,6 +2199,7 @@ export class FeishuHarnessBridge {
           // list response's workspace is display data and is not authoritative.
           sessionWorkspace: resolved.workspace,
           sessionPage: safePage,
+          sessionLimit,
         },
       );
     } catch (error) {
@@ -2246,6 +2268,9 @@ export class FeishuHarnessBridge {
       sessionPage: Number.isSafeInteger(options.sessionPage) && options.sessionPage >= 0
         ? options.sessionPage
         : 0,
+      sessionLimit: Number.isSafeInteger(options.sessionLimit) && options.sessionLimit > 0
+        ? options.sessionLimit
+        : null,
     });
     if (this.#cardKeys.size > 200) {
       const oldest = this.#cardKeys.keys().next().value;
@@ -3305,6 +3330,8 @@ export class FeishuHarnessBridge {
       content = enhanceContextContent(originalContent, snapshot, () => ({
         channel: 'feishu',
         senderId: senderOpenId(event),
+        chatId: event.message.chat_id,
+        threadId: event.message.thread_id,
       }));
       contextEnhanced = content !== originalContent;
     }

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

@@ -488,6 +488,7 @@ export function menuHelpText() {
     '',
     '📋 会话 / 工作区',
     '/sessionlist 或 /sessions  列出工作区会话',
+    '/sessionlist --limit N  仅列出当前工作区前 N 个会话',
     '/session ID  绑定已有会话',
     '/workspacelist  列出工作区',
     '/workspace 工作区序号或绝对路径  切换工作区',
@@ -554,6 +555,7 @@ const HELP_TEXT_COMMANDS = [
   '`/new` — 开启全新会话',
   '`/session ID` — 绑定已有会话',
   '`/sessionlist [工作区]` 或 `/sessions [工作区]` — 列出会话',
+  '`/sessionlist --limit N` 或 `/sessions --limit N` — 仅列出当前工作区前 N 个会话',
   '`/workspace 工作区序号或绝对路径` — 切换工作区',
   '`/workspacelist` — 列出工作区',
   '`/status` — 查看连接状态',

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

@@ -91,6 +91,7 @@ function helpText() {
     t('/workspace 工作区序号或绝对路径  切换工作区'),
     t('/workspacelist  列出工作区绝对路径'),
     t('/sessionlist 或 /sessions [工作区序号或绝对路径]  列出会话 ID 和标题'),
+    t('/sessionlist --limit N  仅列出当前工作区前 N 个会话'),
     t('/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话'),
     t('/models  按序号列出所有可用模型'),
     t('/reasoninglist 或 /reasonings  按序号列出当前模型可用推理等级'),
@@ -889,6 +890,7 @@ export class QqHarnessBridge {
           channel: 'qq',
           senderId: sender,
           senderName: message.kind === 'group' ? message.senderName : undefined,
+          chatId: message.kind === 'group' ? message.groupOpenid : message.senderId,
         }));
         contextEnhanced = content !== originalContent;
       }

package/src/channels/shared/context-enhancement.mjs

@@ -1,6 +1,7 @@
 // Shared by the Host and settings UI; keep this module browser-compatible.
 export const CONTEXT_ENHANCEMENT_FIELDS = Object.freeze([
-  'channel', 'conversationType', 'senderId', 'senderName', 'conversationTitle', 'botId',
+  'channel', 'conversationType', 'senderId', 'senderName', 'conversationTitle',
+  'chatId', 'threadId', 'botId',
 ]);
 
 export const CONTEXT_ENHANCEMENT_GUIDANCE_MAX_LENGTH = 8_000;
@@ -38,7 +39,7 @@ const CHANNELS = new Set([
 ]);
 const SOURCE_LIMITS = {
   channel: 16, conversationType: 6, senderId: 256, senderName: 256,
-  conversationTitle: 256, botId: 128,
+  conversationTitle: 256, chatId: 256, threadId: 256, botId: 128,
 };
 const CONTROL_CHARACTERS = /[\u0000-\u001f\u007f-\u009f\u202a-\u202e\u2066-\u2069]/g;
 
@@ -64,7 +65,7 @@ function validateContextEnhancementScope(input) {
     throw invalidConfig('群聊和私聊开关必须是布尔值。');
   }
   if (!Array.isArray(fields) || ![...fields].every((field) => CONTEXT_ENHANCEMENT_FIELDS.includes(field))) {
-    throw invalidConfig('来源字段只能选择已定义的六个字段。');
+    throw invalidConfig('来源字段只能选择已定义的八个字段。');
   }
   if (typeof guidance !== 'string' || guidance.length > CONTEXT_ENHANCEMENT_GUIDANCE_MAX_LENGTH) {
     throw invalidConfig(`增强提示词不得超过 ${CONTEXT_ENHANCEMENT_GUIDANCE_MAX_LENGTH} 个字符。`);
@@ -150,7 +151,7 @@ function sourceString(value, field) {
 function sourceBlock(snapshot, sourceFactory) {
   const { fields } = snapshot.config;
   const needsSource = fields.some((field) => [
-    'channel', 'senderId', 'senderName', 'conversationTitle',
+    'channel', 'senderId', 'senderName', 'conversationTitle', 'chatId', 'threadId',
   ].includes(field));
   const source = needsSource ? sourceFactory?.() : null;
   const projected = {};

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

@@ -246,8 +246,8 @@ export default {
   '/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 [工作区]` 或 `/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 <workspace index or absolute 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`/m` — 打开菜单卡片\n`/new` — 开启全新会话\n`/session ID` — 绑定已有会话\n`/sessionlist [工作区]` 或 `/sessions [工作区]` — 列出会话\n`/sessionlist --limit N` 或 `/sessions --limit N` — 仅列出当前工作区前 N 个会话\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`/sessionlist --limit N` or `/sessions --limit N` — list only the first N sessions in the current workspace\n`/workspace <workspace index or absolute 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

@@ -127,6 +127,8 @@ export default {
     '/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',
+  '/sessionlist --limit N  仅列出当前工作区前 N 个会话':
+    '/sessionlist --limit N  List only the first N sessions in the current workspace',
   '/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话':
     '/session <Session ID or workspace index>  Bind this chat to the specified session',
   '/models  按序号列出所有可用模型': '/models  List all available models by index',

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

@@ -3,8 +3,8 @@ export default {
   // workspace-command.mjs
   '用法：/session Session ID 或当前工作区序号（/session N）':
     'Usage: /session Session ID or the session index in the current Workspace (/session N)',
-  '用法：\n/sessionlist  列出当前工作区会话\n/sessionlist 工作区序号  按 /workspacelist 序号列出会话\n/sessionlist 工作区绝对路径  列出指定工作区会话':
-    'Usage:\n/sessionlist  List Sessions in the current Workspace\n/sessionlist Workspace index  List Sessions by /workspacelist index\n/sessionlist Workspace absolute path  List Sessions in the given Workspace',
+  '用法：\n/sessionlist  列出当前工作区会话\n/sessionlist --limit N  列出当前工作区前 N 个会话（N 为正整数）\n/sessionlist 工作区序号  按 /workspacelist 序号列出会话\n/sessionlist 工作区绝对路径  列出指定工作区会话':
+    'Usage:\n/sessionlist  List Sessions in the current Workspace\n/sessionlist --limit N  List the first N Sessions in the current Workspace (N must be a positive integer)\n/sessionlist Workspace index  List Sessions by /workspacelist index\n/sessionlist Workspace absolute path  List Sessions in the given Workspace',
   '工作区必须是绝对路径。\n{usage}': 'The Workspace must be an absolute path.\n{usage}',
   '工作区路径包含不支持的字符或长度超过限制。\n{usage}':
     'The Workspace path contains unsupported characters or exceeds the length limit.\n{usage}',

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

@@ -597,6 +597,7 @@ export class TextHarnessBridge {
           t('/workspace 工作区序号或绝对路径  切换工作区'),
           t('/workspacelist  列出工作区绝对路径'),
           t('/sessionlist 或 /sessions [工作区序号或绝对路径]  列出会话 ID 和标题'),
+          t('/sessionlist --limit N  仅列出当前工作区前 N 个会话'),
           t('/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话'),
           t('/models  按序号列出所有可用模型'),
           t('/reasoninglist 或 /reasonings  按序号列出当前模型可用推理等级'),
@@ -682,11 +683,14 @@ export class TextHarnessBridge {
       let contextEnhanced = false;
       if (snapshot) {
         const originalContent = content ?? text;
+        const contextSource = message.contextSource?.();
         content = enhanceContextContent(originalContent, snapshot, () => ({
           channel: this.#descriptor.key,
           senderId,
-          senderName: message.contextSource?.()?.senderName,
-          conversationTitle: message.contextSource?.()?.conversationTitle,
+          senderName: contextSource?.senderName,
+          conversationTitle: contextSource?.conversationTitle,
+          chatId: contextSource?.chatId ?? message.conversationId,
+          threadId: contextSource?.threadId,
         }));
         contextEnhanced = content !== originalContent;
       }

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

@@ -18,6 +18,7 @@ const SESSION_BIND_USAGE = '用法：/session Session ID 或当前工作区序
 const SESSION_LIST_USAGE = [
   '用法：',
   '/sessionlist  列出当前工作区会话',
+  '/sessionlist --limit N  列出当前工作区前 N 个会话（N 为正整数）',
   '/sessionlist 工作区序号  按 /workspacelist 序号列出会话',
   '/sessionlist 工作区绝对路径  列出指定工作区会话',
 ].join('\n');
@@ -45,6 +46,20 @@ function validSessionId(value) {
     && !UNSAFE_DISPLAY_TEXT.test(value);
 }
 
+export function parseSessionListArgument(value) {
+  const argument = typeof value === 'string' ? value.trim() : '';
+  if (!argument) return { selector: '', limit: null };
+  if (!argument.toLowerCase().startsWith('--limit')) {
+    return { selector: argument, limit: null };
+  }
+  const match = /^--limit[ \t]+(\d+)$/iu.exec(argument);
+  const limit = match ? Number(match[1]) : null;
+  if (!Number.isSafeInteger(limit) || limit < 1) {
+    return { error: t(SESSION_LIST_USAGE) };
+  }
+  return { selector: '', limit };
+}
+
 async function existingWorkspacePaths(values) {
   const checked = await Promise.all(values.map(async (value) => {
     const workspace = normalizedWorkspacePath(value);
@@ -235,12 +250,13 @@ async function currentSessionListWorkspace(harness) {
 }
 
 async function runSessionListCommand(match, harness) {
+  const request = parseSessionListArgument(match[1]);
+  if (request.error) return commandResult(request.error);
   if (typeof harness?.listWorkspaceSessions !== 'function') {
     return commandResult(t('当前机器人暂不支持列出工作区会话。'));
   }
-  const selector = match[1]?.trim() ?? '';
   try {
-    const resolved = await resolveSessionListWorkspace(selector, harness);
+    const resolved = await resolveSessionListWorkspace(request.selector, harness);
     if (resolved.error) return commandResult(resolved.error);
     const listed = await harness.listWorkspaceSessions(resolved.workspace);
     if (!listed || !Array.isArray(listed.sessions)) {
@@ -249,7 +265,10 @@ async function runSessionListCommand(match, harness) {
     harness.assertWorkspaceScope?.();
     const workspace = normalizedWorkspacePath(listed.workspace) ?? resolved.workspace;
     const currentWorkspace = await currentSessionListWorkspace(harness);
-    const message = sessionListMessage(workspace, listed.sessions, {
+    const sessions = request.limit === null
+      ? listed.sessions
+      : listed.sessions.slice(0, request.limit);
+    const message = sessionListMessage(workspace, sessions, {
       currentWorkspace: workspace === currentWorkspace,
     });
     return commandResult(message, splitWorkspaceCommandMessage(message));

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

@@ -172,6 +172,10 @@ export function normalizeSlackEvent(payload, botUserId, {
     senderIsBot: String(event.user) === String(botUserId),
     kind: direct ? 'direct' : 'group',
     conversationId: direct ? String(event.channel) : `${event.channel}:${threadTs}`,
+    contextSource: () => ({
+      chatId: String(event.channel),
+      threadId: event.thread_ts ? String(event.thread_ts) : undefined,
+    }),
     content: stripBotMention(event.text ?? '', botUserId),
     plainText: !Array.isArray(event.files) || event.files.length === 0,
     images: Array.isArray(event.files)

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

@@ -266,6 +266,8 @@ export function normalizeTelegramUpdate(update, {
         .filter((value) => typeof value === 'string' && value.trim())
         .map((value) => value.trim()).join(' ') || message.from?.username,
       conversationTitle: direct ? undefined : message.chat?.title,
+      chatId: String(chatId),
+      threadId: messageThreadId === undefined ? undefined : String(messageThreadId),
     }),
     senderIsBot: message.from?.is_bot === true,
     kind: direct ? 'direct' : 'group',

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

@@ -74,6 +74,7 @@ function helpText() {
     t('/workspace 工作区序号或绝对路径  切换工作区'),
     t('/workspacelist  列出工作区绝对路径'),
     t('/sessionlist 或 /sessions [工作区序号或绝对路径]  列出会话 ID 和标题'),
+    t('/sessionlist --limit N  仅列出当前工作区前 N 个会话'),
     t('/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话'),
     t('/models  按序号列出所有可用模型'),
     t('/reasoninglist 或 /reasonings  按序号列出当前模型可用推理等级'),
@@ -1055,6 +1056,7 @@ export class WecomHarnessBridge {
         content = enhanceContextContent(originalContent, snapshot, () => ({
           channel: 'wecom',
           senderId,
+          chatId,
         }));
         contextEnhanced = content !== originalContent;
       }

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

@@ -88,6 +88,7 @@ const HELP_TEXT = () => [
   t('/workspace 工作区序号或绝对路径  切换工作区'),
   t('/workspacelist  列出工作区绝对路径'),
   t('/sessionlist 或 /sessions [工作区序号或绝对路径]  列出会话 ID 和标题'),
+  t('/sessionlist --limit N  仅列出当前工作区前 N 个会话'),
   t('/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话'),
   t('/models  按序号列出所有可用模型'),
   t('/reasoninglist 或 /reasonings  按序号列出当前模型可用推理等级'),
@@ -785,6 +786,7 @@ export class WeixinHarnessBridge {
           content = enhanceContextContent(originalContent, snapshot, () => ({
             channel: 'weixin',
             senderId: sender,
+            chatId: sender,
           }));
           contextEnhanced = content !== originalContent;
         }