@xmanrui/dsh-im 4.19.1 → 4.20.0

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

@@ -35,6 +35,11 @@ export const SHARED_COMMAND_CATALOG = Object.freeze([
   defineCatalogCommand('workspace', '切换工作区', [
     '/workspace 工作区序号或绝对路径  切换工作区',
   ], { aliases: ['ws'] }),
+  defineCatalogCommand('conv', '设置当前对话专属工作区', [
+    '/conv 或 /conversation  查看当前对话工作区',
+    '/conv 工作区绝对路径或序号  设置当前对话专属工作区',
+    '/conv clear  清除专属工作区，回到 bot 默认工作区',
+  ], { aliases: ['conversation', 'thread'] }),
   defineCatalogCommand('workspacelist', '列出工作区绝对路径', [
     '/workspacelist  列出工作区绝对路径',
     '/ws、/wsl、/workspaces  工作区命令别名',

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

@@ -80,11 +80,21 @@ export async function runCompactCommand(text, harness, state, conversationKey, o
   if (typeof sessionId !== 'string' || !sessionId) {
     return commandResult(t('当前聊天还没有可压缩的会话，请先发送一条消息。'));
   }
-  if (typeof harness?.executeCommand !== 'function') {
-    return commandResult(t('当前机器人暂不支持上下文压缩。'));
-  }
   try {
-    const execution = await harness.executeCommand(sessionId, '/compact', options);
+    let execution;
+    if (typeof harness?.workspaceSession === 'function') {
+      const session = harness.workspaceSession(sessionId, conversationKey);
+      if (typeof session?.executeCommand !== 'function') {
+        return commandResult(t('当前机器人暂不支持上下文压缩。'));
+      }
+      execution = await session.executeCommand('/compact', options);
+    } else {
+      // Legacy Harnesses have no scoped Session handle to carry the route fence.
+      if (typeof harness?.executeCommand !== 'function') {
+        return commandResult(t('当前机器人暂不支持上下文压缩。'));
+      }
+      execution = await harness.executeCommand(sessionId, '/compact', options);
+    }
     if (execution === undefined) {
       return commandResult(t('当前 Harness 未注册 /compact 命令，请确认上下文压缩组件已启用。'));
     }

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

@@ -24,7 +24,7 @@ function boundSession(harness, state, key) {
   if (typeof harness?.workspaceSession !== 'function') {
     throw new TypeError('Harness does not support workspace sessions');
   }
-  const session = harness.workspaceSession(sessionId);
+  const session = harness.workspaceSession(sessionId, key);
   if (!session || typeof session !== 'object') {
     throw new TypeError('Harness returned an invalid workspace session');
   }

package/src/channels/shared/deferred-delivery-coordinator.mjs

@@ -128,7 +128,7 @@ export function createDeferredDeliveryCoordinator({
           entry = { ...entry, turn: outcome.turn };
         }
         if (stopping) {
-          const session = harness.workspaceSession?.(entry.sessionId);
+          const session = harness.workspaceSession?.(entry.sessionId, entry.key);
           const stopped = typeof session?.stopDeferredTurn === 'function'
             ? await session.stopDeferredTurn({ turn: entry.turn, promptRpcId: entry.promptRpcId }, {
                 signal: activeSignal, isCurrent: () => bound(entry),

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

@@ -124,7 +124,7 @@ export async function runHistoryCommand(text, harness, state, key, {
   }
 
   try {
-    const session = harness?.workspaceSession?.(sessionId);
+    const session = harness?.workspaceSession?.(sessionId, key);
     if (typeof session?.readHistory !== 'function') {
       return commandResult(t('当前 Harness 暂不支持读取会话历史。'));
     }

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

@@ -5,4 +5,6 @@ export default {
     'The Discord Gateway Intents are misconfigured. Please check the Bot settings in the Developer Portal.',
   'Discord机器人': 'Discord Bot',
   ' Gateway 长连接': ' Gateway long-lived connection',
+  'Thread 创建结果暂时无法确认。若已创建，请在对应 Thread 中重试；若未创建，请稍后重新 @机器人。':
+    'The Thread creation result cannot be confirmed yet. If the Thread was created, retry inside it; if it was not, mention the bot again shortly.',
 };

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

@@ -125,6 +125,47 @@ export default {
   '/compact  压缩当前会话的较早上下文': '/compact  Compact the earlier context of the current session',
   '/workspace 工作区序号或绝对路径  切换工作区':
     '/workspace <workspace index or absolute path>  Switch workspace',
+  '设置当前对话专属工作区': 'Set a workspace dedicated to this conversation',
+  '/conv 或 /conversation  查看当前对话工作区':
+    '/conv or /conversation  Show the workspace of this conversation',
+  '/conv 工作区绝对路径或序号  设置当前对话专属工作区':
+    '/conv <workspace absolute path or index>  Set a workspace dedicated to this conversation',
+  '/conv clear  清除专属工作区，回到 bot 默认工作区':
+    '/conv clear  Clear the dedicated workspace and fall back to the bot default',
+  '对话专属：/conv 工作区序号或绝对路径（仅影响当前对话）':
+    'Dedicated to this conversation: /conv <workspace index or absolute path> (affects this conversation only)',
+  '当前对话工作区：{workspace}': 'This conversation uses the workspace: {workspace}',
+  '状态：已为该对话显式绑定，之后修改 bot 默认工作区不会影响本对话。':
+    'Status: explicitly bound for this conversation; changing the bot default workspace later will not affect it.',
+  '状态：未显式绑定，当前跟随 bot 默认工作区。':
+    'Status: not explicitly bound; this conversation currently follows the bot default workspace.',
+  '当前对话工作区已切换为：{workspace}': 'This conversation now uses the workspace: {workspace}',
+  '已清除对话专属工作区，当前使用 bot 默认工作区：{workspace}（之后默认工作区的变化会同步到本对话）':
+    'Cleared the dedicated workspace. This conversation now uses the bot default: {workspace} (later changes to that default follow here as well)',
+  '可切换的工作区（{count}）：': 'Available workspaces ({count}):',
+  '用法：/conv 工作区序号或绝对路径': 'Usage: /conv <workspace index or absolute path>',
+  '清除：/conv clear': 'Clear: /conv clear',
+  '{message}\n用法：/conv 工作区绝对路径': '{message}\nUsage: /conv <workspace absolute path>',
+  '当前机器人暂不支持按对话设置专属工作区。':
+    'This bot does not support per-conversation workspaces yet.',
+  '当前机器人暂不支持设置对话工作区。':
+    'This bot does not support setting a conversation workspace yet.',
+  '当前消息缺少可设置的对话上下文。':
+    'This message has no conversation context to bind a workspace to.',
+  '暂时无法读取当前对话工作区，请稍后重试。':
+    'This conversation workspace is temporarily unavailable. Please try again later.',
+  '暂时无法清除对话工作区，请稍后重试。':
+    'The conversation workspace could not be cleared right now. Please try again later.',
+  '机器人正在移除或已重新接入，无法读取对话工作区。':
+    'The bot is being removed or was reconnected, so the conversation workspace cannot be read.',
+  '机器人正在移除或已重新接入，无法清除对话工作区。':
+    'The bot is being removed or was reconnected, so the conversation workspace cannot be cleared.',
+  '机器人正在移除或已重新接入，无法切换对话工作区。':
+    'The bot is being removed or was reconnected, so the conversation workspace cannot be switched.',
+  '不带工作区参数时，/sessionlist 默认列出当前对话的有效工作区。':
+    'Without a workspace argument, /sessionlist lists the workspace this conversation effectively uses.',
+  '不带工作区参数时，默认列出当前对话的有效工作区（未设置对话专属工作区时即 bot 默认工作区）。':
+    'Without a workspace argument it lists the workspace this conversation effectively uses (the bot default when no conversation workspace is set).',
   '/workspacelist  列出工作区绝对路径': '/workspacelist  List absolute workspace paths',
   '/ws、/wsl、/workspaces  工作区命令别名': '/ws, /wsl, /workspaces  Workspace command aliases',
   '/sessionlist [工作区序号或绝对路径]  列出会话 ID 和标题':

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

@@ -1,5 +1,10 @@
 // English translations (telegram area). Keys are exact Chinese literals passed to t().
 export default {
+  // Terminal status written back over a placeholder whose in-place edit was
+  // rejected, so it is the last thing a reader sees on a degraded reply.
+  '回复已发送。': 'The reply was sent.',
+  '回复发送结果未能确认。': 'The reply delivery result could not be confirmed.',
+  '消息发送失败，请稍后重试。': 'The message could not be sent. Try again later.',
   '开启一个全新会话': 'Start a brand-new Session',
   '压缩当前会话的较早上下文': 'Compact the earlier context of the current Session',
   '切换工作区': 'Switch Workspace',

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

@@ -1,5 +1,7 @@
+import diagnostics from '../../weixin/connection-error.en.mjs';
 // English translations (weixin area). Keys are exact Chinese literals passed to t().
 export default {
+  ...diagnostics,
   // weixin-bridge.mjs
   '微信已连接 DeepSeek Harness。': 'WeChat is connected to DeepSeek Harness.',
   '结果文件「{name}」已生成，但微信机器人当前没有文件消息发送权限，请检查机器人文件消息能力。': 'The result file "{name}" was generated, but the WeChat bot currently has no permission to send file messages. Please check the bot\'s file messaging capability.',

package/src/channels/shared/i18n.mjs

@@ -10,17 +10,60 @@ import { EN } from './i18n-en.mjs';
 
 let language = 'zh';
 
+const listeners = new Set();
+
 // Accepts 'en', 'en-US', 'english' (any case) as English; anything else
-// (including undefined and unrecognized values) selects Chinese.
-export function setImHostLanguage(lang) {
+// (including undefined and unrecognized values) selects Chinese. Pure: use it
+// to judge a candidate tag without switching the active language.
+export function normalizeImHostLanguage(lang) {
   const normalized = typeof lang === 'string' ? lang.trim().toLowerCase() : '';
-  language = normalized === 'english' || /^en(?:[-_].*)?$/u.test(normalized) ? 'en' : 'zh';
+  return normalized === 'english' || /^en(?:[-_].*)?$/u.test(normalized) ? 'en' : 'zh';
+}
+
+/**
+ * Select the language of every host-side message. Subscribers registered
+ * through onImHostLanguageChange are notified only when the resolved language
+ * actually changes, so re-applying the same selection in a different spelling
+ * (or an unrecognized tag that keeps falling back to Chinese) is free.
+ */
+export function setImHostLanguage(lang) {
+  const next = normalizeImHostLanguage(lang);
+  if (next === language) return language;
+  const previous = language;
+  language = next;
+  // Snapshot first: a subscriber may unsubscribe (or subscribe) while running.
+  for (const listener of [...listeners]) {
+    if (!listeners.has(listener)) continue;
+    try {
+      listener(next, previous);
+    } catch {
+      // Each subscriber owns its own diagnostics; one that fails must not
+      // strand the rest, nor abandon a language switch that already happened.
+    }
+  }
+  return language;
 }
 
 export function getImHostLanguage() {
   return language;
 }
 
+/**
+ * Observe committed changes to the host message language. Platform-side
+ * surfaces that were localized once at connect time (the Telegram command
+ * menu, for example) re-synchronize from here instead of waiting for a
+ * reconnect. Subscribers must not throw; the disposer is idempotent.
+ */
+export function onImHostLanguageChange(listener) {
+  if (typeof listener !== 'function') {
+    throw new TypeError('onImHostLanguageChange requires a listener function');
+  }
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+
 // Translate a user-facing Chinese literal. In zh mode (the default) this is
 // the identity function. Optional `params` fills `{name}` placeholders in
 // both the Chinese key and its translation, e.g.

package/src/channels/shared/interface-language-store.mjs

@@ -0,0 +1,127 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, readdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
+import { basename, dirname, join } from 'node:path';
+
+import { normalizeInterfaceLanguageTag } from './interface-language.mjs';
+
+const DOCUMENT_VERSION = 1;
+
+function invalidTagError() {
+  const error = new Error('Invalid DSH interface language tag.');
+  error.code = 'interface-language-invalid';
+  return error;
+}
+
+// Mirrors the atomic settings writes of the inbound attachment TTL store and
+// the update service: create a private temporary file, then rename it in.
+async function writeSettingsDocument(path, document) {
+  await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+  const temporary = `${path}.${randomUUID()}.tmp`;
+  try {
+    await writeFile(temporary, `${JSON.stringify(document, null, 2)}\n`, {
+      encoding: 'utf8',
+      mode: 0o600,
+      flag: 'wx',
+    });
+    await rename(temporary, path);
+  } finally {
+    await unlink(temporary).catch((error) => {
+      if (error.code !== 'ENOENT') throw error;
+    });
+  }
+}
+
+/**
+ * Durable mirror of the DSH interface language, so bot messages keep following
+ * it across Host restarts and before any browser has connected. Only the
+ * lowest resolution layer lives here (see ./interface-language.mjs): an
+ * unreadable document resolves to "nothing mirrored" rather than pinning a
+ * language nobody chose.
+ */
+export class InterfaceLanguageStore {
+  #path;
+  #tag = null;
+  // Whether the document on disk is known to already say what #tag says. False
+  // for a missing or unreadable document, so the next report repairs it.
+  #stored = false;
+
+  constructor(path) {
+    if (typeof path !== 'string' || !path) {
+      throw new TypeError('interface language store path is required');
+    }
+    this.#path = path;
+  }
+
+  async load() {
+    let raw;
+    try {
+      raw = await readFile(this.#path, 'utf8');
+    } catch (error) {
+      if (error?.code !== 'ENOENT') throw error;
+      this.#tag = null;
+      this.#stored = false;
+      await this.#removeStaleTemporaries();
+      return this;
+    }
+    const read = this.#readTag(raw);
+    this.#tag = read === undefined ? null : read;
+    this.#stored = read !== undefined;
+    await this.#removeStaleTemporaries();
+    return this;
+  }
+
+  // Crash leftovers from an interrupted atomic write are unreferenced by
+  // anyone; remove them so the settings directory stays clean.
+  async #removeStaleTemporaries() {
+    const directory = dirname(this.#path);
+    const prefix = `${basename(this.#path)}.`;
+    try {
+      const entries = await readdir(directory);
+      await Promise.all(entries
+        .filter((name) => name.startsWith(prefix) && name.endsWith('.tmp'))
+        .map((name) => unlink(join(directory, name)).catch(() => {})));
+    } catch {
+      // A missing directory or concurrent removal is fine; cleanup is best-effort.
+    }
+  }
+
+  // Returns the mirrored tag (null when the document mirrors nothing), or
+  // undefined when the document is damaged or from an unknown future version.
+  #readTag(raw) {
+    let document;
+    try {
+      document = JSON.parse(raw);
+    } catch {
+      return undefined;
+    }
+    if (!document || typeof document !== 'object' || Array.isArray(document)) return undefined;
+    if (document.version !== DOCUMENT_VERSION) return undefined;
+    if (document.interfaceLanguage === undefined) return null;
+    return normalizeInterfaceLanguageTag(document.interfaceLanguage) ?? undefined;
+  }
+
+  getLanguageTag() {
+    return this.#tag;
+  }
+
+  /**
+   * Record the interface language reported by the settings UI. Passing null
+   * clears the mirror, returning resolution to the layers above it. The
+   * settings page reports its locale on every mount, so an unchanged value is
+   * accepted without rewriting the document.
+   */
+  async setLanguageTag(value) {
+    const tag = value === null || value === undefined
+      ? null
+      : normalizeInterfaceLanguageTag(value);
+    if (tag === null && value !== null && value !== undefined) throw invalidTagError();
+    if (tag === this.#tag && this.#stored) return tag;
+    await writeSettingsDocument(this.#path, {
+      version: DOCUMENT_VERSION,
+      ...(tag === null ? {} : { interfaceLanguage: tag }),
+    });
+    this.#tag = tag;
+    this.#stored = true;
+    return tag;
+  }
+}

package/src/channels/shared/interface-language.mjs

@@ -0,0 +1,51 @@
+// Resolution policy for the DSH interface language that dsh-im's bot messages
+// follow.
+//
+// The host message language (./i18n.mjs) is a two-value switch: English, or
+// Chinese as the always-available fallback. The DSH interface language is a
+// BCP 47-style tag that a language pack may extend beyond the shipped zh/en
+// pair, so a tag is carried verbatim through resolution and persistence and is
+// collapsed to a dictionary language only where it reaches setImHostLanguage().
+
+/** Tag shape accepted by DSH's own locale preference (@deepseek-ai/dsh-client-locale). */
+const LANGUAGE_TAG = /^[A-Za-z]{2,8}(?:-[A-Za-z0-9]{1,8})*$/u;
+
+/**
+ * Resolution layers, highest precedence first.
+ *
+ * - `config`: the plugin's own `language` option (or `DSH_IM_LANGUAGE`). An
+ *   operator who pinned a language in the Host composition keeps it, whatever
+ *   any individual browser reads the interface in.
+ * - `settings`: the explicit selection in DSH's Language row, read from the
+ *   Host user-settings document. This is the setting users mean by "DSH is set
+ *   to English".
+ * - `mirror`: the last effective interface locale reported by the settings UI.
+ *   DSH stores nothing when the interface language came from the browser's
+ *   language list, so without this layer a reader who never opened the
+ *   Language row would still be answered in Chinese.
+ */
+export const HOST_LANGUAGE_SOURCES = Object.freeze(['config', 'settings', 'mirror']);
+
+/**
+ * Normalize one interface-language tag. Surrounding whitespace is trimmed;
+ * anything that is not a BCP 47-style tag returns null so a malformed layer is
+ * skipped rather than silently overriding the layers below it.
+ */
+export function normalizeInterfaceLanguageTag(value) {
+  if (typeof value !== 'string') return null;
+  const trimmed = value.trim();
+  return LANGUAGE_TAG.test(trimmed) ? trimmed : null;
+}
+
+/**
+ * Pick the winning interface-language tag across the layers, in
+ * HOST_LANGUAGE_SOURCES order. Returns `{ tag: null, source: 'default' }` when
+ * no layer names a usable tag, which keeps Chinese as the shipped default.
+ */
+export function resolveHostLanguageTag(layers = {}) {
+  for (const source of HOST_LANGUAGE_SOURCES) {
+    const tag = normalizeInterfaceLanguageTag(layers[source]);
+    if (tag !== null) return { tag, source };
+  }
+  return { tag: null, source: 'default' };
+}

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

@@ -443,7 +443,7 @@ async function boundSession(harness, state, key, options) {
   if (typeof harness?.workspaceSession !== 'function') {
     throw new TypeError('Harness does not support workspace sessions');
   }
-  const session = harness.workspaceSession(sessionId);
+  const session = harness.workspaceSession(sessionId, key);
   if (!session || typeof session.sessionExists !== 'function') {
     throw new TypeError('Harness returned an invalid workspace session');
   }
@@ -705,11 +705,13 @@ export async function runModelCommand(text, harness, state, key, options = {}) {
           throw new TypeError('Harness cannot create a conversation session');
         }
         // An explicit choice must remain usable even when the saved bot model expires.
-        const sessionId = await harness.createSession({ ...requestOptions, inheritBotModel: false });
+        const sessionId = await harness.createSession({
+          ...requestOptions, inheritBotModel: false, conversationKey: key,
+        });
         if (typeof sessionId !== 'string' || !sessionId) {
           throw new TypeError('Harness returned an invalid session id');
         }
-        const session = harness.workspaceSession(sessionId);
+        const session = harness.workspaceSession(sessionId, key);
         applied = await selectAndVerifyModel(session, selection, requestOptions);
         const currentSessionId = state.sessionFor(key);
         if (typeof currentSessionId === 'string' && currentSessionId) {

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

@@ -324,6 +324,32 @@ export class TokenBotController {
     };
   }
 
+  /**
+   * Re-synchronize the platform-side command menu of every connected bot.
+   *
+   * Called when the host message language changes: a menu the platform stored
+   * at connect time would otherwise keep the previous language until the bot
+   * reconnected. Runtimes of channels without a platform-side menu expose no
+   * refresh hook and are skipped, and one bot's failure never hides the rest.
+   * @returns the number of bots that accepted a refreshed menu.
+   */
+  async refreshCommandMenus() {
+    if (this.#closed) return 0;
+    const refreshed = await Promise.all([...this.#runtimes].map(async ([botId, runtime]) => {
+      if (typeof runtime?.refreshCommandMenu !== 'function') return false;
+      try {
+        return await runtime.refreshCommandMenu() === true;
+      } catch (error) {
+        this.#logger.warn?.(
+          `[dsh-im:${this.#descriptor.key}] bot ${botId} command menu refresh failed:`,
+          error,
+        );
+        return false;
+      }
+    }));
+    return refreshed.filter(Boolean).length;
+  }
+
   async close() {
     if (this.#closed) return;
     this.#closed = true;