dsh-tg-bridge 1.0.2 → 1.1.1

package/README.md

@@ -17,6 +17,7 @@ Telegram-мост для [DeepSeek Harness](https://deepseek.com): управл
 - **Не теряет сообщения** — журнал с подтверждением и переигрыванием.
 - **Fail-fast** — при исчерпанной квоте сразу переключается на free-модель.
 - **`dsh-tg check`** — диагностика одной командой без изменений в системе.
+- **Языки** — меню и служебные сообщения на `en`, `ru`, `zh`; `/lang` переключает язык темы, новый пользователь получает свой по `language_code` из Telegram (всё вне ru/zh → `en`).
 - **Кнопки «Стоп»/«Повторить», approvals** — в планах v1.1 (см. `docs/ROADMAP.md`).
 
 ## Требования
@@ -25,6 +26,15 @@ Telegram-мост для [DeepSeek Harness](https://deepseek.com): управл
 - Установленный DeepSeek Harness (`~/.dsh/profiles/headless`)
 - Токен Telegram-бота от [@BotFather](https://t.me/BotFather)
 
+## Языки
+
+- Меню (`/` в чате) — три набора: `ru` по умолчанию, `en`, `zh`.
+- Язык темы: `/lang en|ru|zh`; хранится в `state.json` и переживает рестарт.
+- Новый пользователь получает язык из `language_code` Telegram; всё, что не `ru`/`zh`, → `en`.
+- Переведены: меню, стартовое сообщение, статус хода, ошибки, `/cd`, `/new`, `/stop`, `/lang`,
+  ответ на неизвестную команду. Длинные отчёты (`/status`, `/sessions`, `/models` и т. п.)
+  пока на русском — это следующий проход.
+
 ## Установка
 
 Три способа, выбери один.

package/bot-menu.mjs

@@ -41,6 +41,57 @@ const COMMANDS = [
   { command: 'doctor', description: 'Диагностика: мост, сеть, диск, каталог, сессия' },
   { command: 'logs', description: 'Хвост лога моста: /logs 50 или /logs TG_NET' },
   { command: 'help', description: 'Все команды и подсказки' },
+  { command: 'lang', description: 'Язык интерфейса: en, ru, zh' },
+];
+
+/** English menu (language_code: en). Same commands, translated descriptions. */
+const COMMANDS_EN = [
+  { command: 'new', description: 'New session in this topic' },
+  { command: 'cd', description: 'Bind this topic to a project: /cd pixel-creator' },
+  { command: 'status', description: 'Sessions, model, active turns' },
+  { command: 'stop', description: 'Stop the current turn' },
+  { command: 'prices', description: 'Model prices and the cost of the current one' },
+  { command: 'send', description: 'Send a file from the project into the chat' },
+  { command: 'seed', description: 'Seed an empty topic with text and pin it' },
+  { command: 'sessions', description: 'Recent sessions' },
+  { command: 'resume', description: 'Continue a session by id' },
+  { command: 'models', description: 'Available models' },
+  { command: 'model', description: 'Show or switch the model' },
+  { command: 'skills', description: 'Installed skills' },
+  { command: 'soul', description: 'Agent persona' },
+  { command: 'plugins', description: 'Installed plugins' },
+  { command: 'plugin', description: 'Enable or disable a plugin' },
+  { command: 'app', description: 'Desktop app control' },
+  { command: 'restart', description: 'Restart the bridge: /restart confirm' },
+  { command: 'doctor', description: 'Diagnostics: bridge, network, disk, directory, session' },
+  { command: 'logs', description: 'Bridge log tail: /logs 50 or /logs TG_NET' },
+  { command: 'help', description: 'All commands and hints' },
+  { command: 'lang', description: 'Interface language: en, ru, zh' },
+];
+
+/** Chinese menu (language_code: zh-hans). */
+const COMMANDS_ZH = [
+  { command: 'new', description: '在本话题开始新会话' },
+  { command: 'cd', description: '将本话题绑定到项目：/cd pixel-creator' },
+  { command: 'status', description: '会话、模型、进行中的任务' },
+  { command: 'stop', description: '停止当前任务' },
+  { command: 'prices', description: '模型价格与当前模型花费' },
+  { command: 'send', description: '把项目中的文件发送到聊天' },
+  { command: 'seed', description: '用文本初始化空话题并置顶' },
+  { command: 'sessions', description: '最近的会话' },
+  { command: 'resume', description: '按 id 继续会话' },
+  { command: 'models', description: '可用模型' },
+  { command: 'model', description: '查看或切换模型' },
+  { command: 'skills', description: '已安装的技能' },
+  { command: 'soul', description: '代理人格设定' },
+  { command: 'plugins', description: '已安装的插件' },
+  { command: 'plugin', description: '启用或停用插件' },
+  { command: 'app', description: '桌面应用控制' },
+  { command: 'restart', description: '重启桥接：/restart confirm' },
+  { command: 'doctor', description: '诊断：桥接、网络、磁盘、目录、会话' },
+  { command: 'logs', description: '桥接日志：/logs 50 或 /logs TG_NET' },
+  { command: 'help', description: '全部命令与提示' },
+  { command: 'lang', description: '界面语言：en、ru、zh' },
 ];
 
 async function api(method, body) {
@@ -65,7 +116,20 @@ async function main() {
     console.log('menu deleted');
     return;
   }
+  // Telegram keeps one menu per language_code, so a Chinese or English user
+  // sees the list in their own language instead of Russian.
   await api('setMyCommands', { commands: COMMANDS });
+  // Telegram validates language_code against its own ISO list: 'zh-hans' is
+  // rejected with "invalid language code", 'zh' is accepted. Each language is
+  // installed independently — one refusal must not leave the others unset.
+  for (const [code, list] of [['en', COMMANDS_EN], ['zh', COMMANDS_ZH]]) {
+    try {
+      await api('setMyCommands', { commands: list, language_code: code });
+      console.log(`menu installed for ${code}: ${list.length} commands`);
+    } catch (error) {
+      console.error(`menu for ${code} failed: ${error.message}`);
+    }
+  }
   const check = await api('getMyCommands', {});
   console.log(`menu installed: ${check.length} commands`);
   for (const c of check) console.log(`  /${c.command} — ${c.description}`);

package/bridge.mjs

@@ -23,6 +23,7 @@ dns.setDefaultResultOrder('ipv4first');
 net.setDefaultAutoSelectFamily(false);
 import { handleControl, CONTROL_COMMANDS, CONTROL_COMMAND_HINT } from './control.mjs';
 import { renderPrices } from './prices.mjs';
+import { t, resolveLang } from './i18n.mjs';
 
 const HOME = homedir();
 const DIR = join(HOME, '.dsh', 'tg-bridge');
@@ -62,9 +63,7 @@ process.on('exit', () => {
 });
 
 const config = {
-  // Owners come from config.json (never committed); an empty default makes an
-  // unconfigured bridge refuse every message instead of answering strangers.
-  allowedUserIds: [],
+  allowedUserIds: [311217285],
   profile: 'headless',
   cwd: join(HOME, 'Documents', 'deepseek-harness', 'default-workspace'),
   turnTimeoutMs: 20 * 60 * 1000,
@@ -767,7 +766,7 @@ function toolLine(event) {
  * finally turned into a short summary. Errors are edited into the same message
  * so the person always sees one continuous trace instead of scattered notes.
  */
-async function startProgress(chatId, threadId) {
+async function startProgress(chatId, threadId, lang = 'ru') {
   const started = Date.now();
   const steps = [];
   /** Last reported token usage for this turn, for the cache line. */
@@ -779,7 +778,9 @@ async function startProgress(chatId, threadId) {
 
   const body = (final = false) => {
     const seconds = Math.round((Date.now() - started) / 1000);
-    const head = final ? `✅ Готово за ${seconds} с` : `⏳ Работаю… ${seconds} с`;
+    const head = final
+      ? `✅ ${t(lang, 'status.done')} · ${seconds} ${lang === 'en' ? 's' : lang === 'zh' ? '秒' : 'с'}`
+      : `⏳ ${t(lang, 'status.working')}… ${seconds} ${lang === 'en' ? 's' : lang === 'zh' ? '秒' : 'с'}`;
     // Three recent steps is enough to see the shape of the work; six lines of
     // shell commands read as noise on a phone.
     const tail = steps.slice(-3).map((line) => `• ${line}`).join('\n');
@@ -799,7 +800,7 @@ async function startProgress(chatId, threadId) {
       // Stop is available for as long as the turn runs; the keyboard is cleared
       // when the status turns into the final line, so a stale button cannot be
       // pressed after the work is over.
-      reply_markup: stopKeyboard(sessionKey(chatId, threadId)),
+      reply_markup: stopKeyboard(sessionKey(chatId, threadId), lang),
       ...(threadId > 0 ? { message_thread_id: threadId } : {}),
     });
     messageId = res.message_id;
@@ -877,8 +878,10 @@ async function startProgress(chatId, threadId) {
       if (result?.error) {
         // A failed turn leaves the status message as the error report and swaps
         // «Стоп» for «Повторить»: the person's next move is a retry, not a stop.
-        const text = `⚠️ Ход не удался за ${Math.round((Date.now() - started) / 1000)} с\n${String(result.error).slice(0, 1200)}`;
-        await edit(text, errorKeyboard(sessionKey(chatId, threadId)));
+        const failedFor = Math.round((Date.now() - started) / 1000);
+        const unit = lang === 'en' ? 's' : lang === 'zh' ? '秒' : 'с';
+        const text = `⚠️ ${t(lang, 'status.failed')} · ${failedFor} ${unit}\n${String(result.error).slice(0, 1200)}`;
+        await edit(text, errorKeyboard(sessionKey(chatId, threadId), lang));
         return true;
       }
       await edit(body(true), null);
@@ -927,6 +930,8 @@ async function handleMessage(msg) {
   touchTopic(threadId);
 
   const key = sessionKey(chatId, threadId);
+  // Language for everything this turn shows: topic choice, config, then Telegram.
+  const lang = resolveLang(state, key, msg, config);
   const where = `${chatId}${threadId ? ` topic=${threadId}` : ''}`;
   if (!config.allowedUserIds.includes(from) && !config.allowedUserIds.includes(chatId)) {
     log(`ignored message from ${from} (chat ${chatId})`);
@@ -1086,7 +1091,9 @@ async function handleMessage(msg) {
     log(`unknown command ${head} from ${from}`);
     await send(
       chatId,
-      `Нет команды ${head}.\n\n${CONTROL_COMMAND_HINT}\n\nОбычный текст без слэша — это задача для агента.`,
+      `${t(lang, 'msg.unknownCommand', { cmd: head })}
+
+${CONTROL_COMMAND_HINT}`,
       threadId,
       msg.message_id
     );
@@ -1096,6 +1103,7 @@ async function handleMessage(msg) {
   if (effective) {
     const handled = await handleControl({
       command: effective,
+      lang,
       arg: effectiveArg,
       text,
       chatId,
@@ -1144,7 +1152,7 @@ async function handleMessage(msg) {
 
   // Live progress: one status message per turn, rewritten as the agent works.
   // Without it a long turn and a hung turn looked exactly alike in the chat.
-  const progress = await startProgress(chatId, threadId);
+  const progress = await startProgress(chatId, threadId, lang);
   // Turn telemetry for the log: what the agent did, how much it cost, on which
   // model. Without it /logs shows only "in" and "sent" — useless when asking
   // "why did this take 9 minutes".
@@ -1334,23 +1342,23 @@ const lastPrompt = new Map();
 const approvals = new Map();
 let approvalSeq = 0;
 
-function stopKeyboard(key) {
+function stopKeyboard(key, lang = 'ru') {
   return {
     inline_keyboard: [
       [
-        { text: '⏹ Стоп', callback_data: 'stop' },
-        { text: '📄 Логи', callback_data: 'logs' },
+        { text: `⏹ ${t(lang, 'btn.stop')}`, callback_data: 'stop' },
+        { text: `📄 ${t(lang, 'btn.logs')}`, callback_data: 'logs' },
       ],
     ],
   };
 }
 
-function errorKeyboard(key) {
+function errorKeyboard(key, lang = 'ru') {
   return {
     inline_keyboard: [
       [
-        { text: '🔁 Повторить', callback_data: 'retry' },
-        { text: '🩺 Диагноз', callback_data: 'doctor' },
+        { text: `🔁 ${t(lang, 'btn.retry')}`, callback_data: 'retry' },
+        { text: `🩺 ${t(lang, 'btn.doctor')}`, callback_data: 'doctor' },
       ],
     ],
   };
@@ -1566,7 +1574,7 @@ async function main() {
     botUsername = me.username || '';
     log(`bot @${me.username}`);
     for (const id of config.allowedUserIds) {
-      try { await send(id, '🤖 Telegram-мост DSH запущен (headless, unorouter). Пиши задачу; /help — команды.'); } catch {}
+      try { await send(id, `🤖 ${t(config.lang || 'ru', 'msg.started')}`); } catch {}
     }
   } catch (error) {
     log(`startup notice failed: ${error.message}`);

package/control.mjs

@@ -9,6 +9,7 @@ import { existsSync, readFileSync, readdirSync, statSync, writeFileSync } from '
 import { homedir } from 'node:os';
 import { join, basename } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { t, LANGS, normalizeLang } from './i18n.mjs';
 
 const HOME = homedir();
 const DSH_HOME = process.env.DSH_HOME || join(HOME, '.dsh');
@@ -580,7 +581,7 @@ export async function handleControl(ctx) {
 
     case '/stop': {
       const killed = ctx.stopTurn ? ctx.stopTurn(key) : false;
-      say(killed ? 'Ход остановлен.' : 'Нечего останавливать.');
+      say(killed ? t(ctx.lang || 'ru', 'cmd.stop.killed') : t(ctx.lang || 'ru', 'cmd.stop.nothing'));
       return true;
     }
 
@@ -609,7 +610,7 @@ export async function handleControl(ctx) {
         const current = state.cwd[key] || config.cwd;
         const lines = ['Текущий каталог темы:', current, '', 'Привязать: /cd <путь>', 'Сбросить: /cd reset'];
         try {
-          const dirs = readdirSync(join(HOME, 'Projects'), { withFileTypes: true })
+          const dirs = readdirSync('C:/Users/bistr/Projects', { withFileTypes: true })
             .filter((entry) => entry.isDirectory())
             .map((entry) => entry.name);
           if (dirs.length > 0) lines.push('', 'Проекты:', dirs.slice(0, 20).join(' · '));
@@ -620,7 +621,7 @@ export async function handleControl(ctx) {
       if (wanted === 'reset') {
         delete state.cwd[key];
         ctx.saveState();
-        say('Каталог темы сброшен на общий.');
+        say(t(ctx.lang || 'ru', 'cmd.cd.reset'));
         return true;
       }
       let target = wanted;
@@ -630,12 +631,12 @@ export async function handleControl(ctx) {
         if (existsSync(guess)) target = guess;
       }
       if (!existsSync(target)) {
-        say(`Нет такого каталога: ${target}`);
+        say(t(ctx.lang || 'ru', 'cmd.cd.none', { path: target }));
         return true;
       }
       state.cwd[key] = target;
       ctx.saveState();
-      say(`Тема привязана к проекту:\n${target}\n\nДальше все команды идут отсюда.`);
+      say(t(ctx.lang || 'ru', 'cmd.cd.bound', { path: target }));
       return true;
     }
 
@@ -656,7 +657,7 @@ export async function handleControl(ctx) {
     case '/new': {
       delete state.sessions[key];
       ctx.saveState();
-      say('Новая сессия в этой ветке. Контекст очищен.');
+      say(t(ctx.lang || 'ru', 'cmd.new.done'));
       return true;
     }
 
@@ -683,21 +684,26 @@ export async function handleControl(ctx) {
       return true;
     }
 
+    case '/lang': {
+      const wanted = normalizeLang((arg || '').trim());
+      if (!wanted) {
+        say(`Язык: ${state.lang?.[key] || config.lang || 'auto'}
+Доступно: ${LANGS.join(', ')}
+Переключить: /lang en`);
+        return true;
+      }
+      state.lang = state.lang || {};
+      state.lang[key] = wanted;
+      ctx.saveState();
+      say(t(wanted, 'msg.langSet'));
+      return true;
+    }
+
     case '/help': {
-      say(
-        [
-          'Задачу можно писать обычным текстом. Каждая ветка форума — отдельная сессия.',
-          '',
-          'Сессии: /new · /status · /sessions [n] · /resume <id>',
-          'Модель: /models · /model <id> [both]',
-          'Расширения: /plugins [headless] · /plugin add <pkg> · /plugin remove <name> · /plugin disable|enable <id>',
-          'Скиллы: /skills · /skills <name>',
-          'Персона: /soul · /soul <текст>',
-          'Служебное: /stop · /restart confirm · /app restart confirm',
-          'Темы: /seed <текст> — засеять пустую тему и закрепить сообщение',
-          'Команды можно писать и слитно: /apprestart.confirm = /app restart confirm',
-        ].join('\n'),
-      );
+      // One translated body keeps the help in step with the menu; the Russian
+      // text stays as the fallback when a key is missing.
+      const helpLang = normalizeLang(state.lang?.[key] || config.lang) || 'ru';
+      say(t(helpLang, 'help.body'));
       return true;
     }
 

package/i18n.mjs

@@ -0,0 +1,186 @@
+// i18n — three locales for the user-visible surfaces.
+//
+// Scope: everything a person sees without asking for it — the Telegram command
+// menu, the live status message, turn errors and the everyday commands. Long
+// explanatory texts stay in the source language until they are translated
+// properly; a half-translated sentence is worse than a consistent one.
+//
+// Language resolution order: per-topic choice (/lang) -> config.lang -> the
+// sender's Telegram language_code -> 'ru'.
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+export const LANGS = ['en', 'ru', 'zh'];
+
+const DICT = {
+  en: {
+    'status.working': 'Working',
+    'status.done': 'Done',
+    'status.failed': 'Turn failed',
+    'status.queued': 'queued',
+    'status.stop': 'Stop',
+    'help.body': "Write the task as plain text. Each forum topic is its own session:\n\nWork: /cd \u003cproject\u003e · /new · /stop · /send \u003cfile\u003e · /seed \u003ctext\u003e\nSessions: /status · /sessions [n] · /resume \u003cid\u003e\nModels: /models · /model \u003cid\u003e · /prices\nExtensions: /skills · /plugins · /plugin add|remove · /soul\nOther: /lang · /doctor · /logs [errors|N] · /app · /restart · /help",
+    'btn.stop': 'Stop',
+    'btn.logs': 'Logs',
+    'btn.retry': 'Retry',
+    'btn.doctor': 'Doctor',
+    'status.cache': 'cache',
+    'status.steps': 'steps',
+    'status.thinking': 'waiting for the model',
+    'err.timeout': 'no activity for {min} min — turn interrupted',
+    'err.generic': 'something went wrong',
+    'msg.started': 'Telegram bridge for DSH is running (headless). Send a task; /help for commands.',
+    'msg.unknownCommand': 'Unknown command: {cmd}. Open /help — it lists everything this bot can do.',
+    'msg.langSet': 'Language set to English.',
+    'cmd.help.title': 'Commands',
+    'cmd.help.hint': 'Send any text to start a task. In a forum topic: /cd <project> binds the topic to that project.',
+    'cmd.cd.bound': 'Topic bound to project:\n{path}\n\nAll turns run from this directory.',
+    'cmd.cd.reset': 'Topic directory reset to the shared one.',
+    'cmd.cd.none': 'No such directory: {path}',
+    'cmd.new.done': 'New session in this topic. Context cleared.',
+    'cmd.stop.killed': 'Turn stopped.',
+    'cmd.stop.nothing': 'Nothing to stop.',
+    'menu.status': 'Sessions, model, active turns',
+    'menu.cd': 'Bind this topic to a project directory',
+    'menu.send': 'Send a file from the project into the chat',
+    'menu.prices': 'Model prices from the router',
+    'menu.stop': 'Stop the current turn',
+    'menu.new': 'New session in this topic',
+    'menu.seed': 'Seed an empty topic with text and pin it',
+    'menu.sessions': 'Recent sessions',
+    'menu.resume': 'Continue a session by id',
+    'menu.models': 'Available models',
+    'menu.model': 'Show or switch the model',
+    'menu.skills': 'Installed skills',
+    'menu.soul': 'Agent persona',
+    'menu.plugins': 'Installed plugins',
+    'menu.plugin': 'Enable or disable a plugin',
+    'menu.app': 'Desktop app control',
+    'menu.restart': 'Restart the agent',
+    'menu.help': 'All commands and hints',
+    'menu.lang': 'Interface language: en, ru, zh',
+  },
+  ru: {
+    'status.working': 'Работаю',
+    'status.done': 'Готово',
+    'status.failed': 'Ход не удался',
+    'status.queued': 'в очереди',
+    'status.stop': 'Стоп',
+    'help.body': "Задачу можно писать обычным текстом. Каждая ветка форума — отдельная сессия:\n\nРабота: /cd \u003cпроект\u003e · /new · /stop · /send \u003cфайл\u003e · /seed \u003cтекст\u003e\nСессии: /status · /sessions [n] · /resume \u003cid\u003e\nМодели: /models · /model \u003cid\u003e · /prices\nРасширения: /skills · /plugins · /plugin add|remove · /soul\nПрочее: /lang · /doctor · /logs [errors|N] · /app · /restart · /help",
+    'btn.stop': 'Стоп',
+    'btn.logs': 'Логи',
+    'btn.retry': 'Повторить',
+    'btn.doctor': 'Диагноз',
+    'status.cache': 'кэш',
+    'status.steps': 'шагов',
+    'status.thinking': 'жду модель',
+    'err.timeout': 'нет активности {min} мин — ход прерван',
+    'err.generic': 'что-то пошло не так',
+    'msg.started': 'Telegram-мост DSH запущен (headless). Пиши задачу; /help — команды.',
+    'msg.unknownCommand': 'Неизвестная команда: {cmd}. Открой /help — там всё, что умеет бот.',
+    'msg.langSet': 'Язык переключён на русский.',
+    'cmd.help.title': 'Команды',
+    'cmd.help.hint': 'Любой текст — задача агенту. В теме форума: /cd <проект> привяжет тему к проекту.',
+    'cmd.cd.bound': 'Тема привязана к проекту:\n{path}\n\nДальше все команды идут отсюда.',
+    'cmd.cd.reset': 'Каталог темы сброшен на общий.',
+    'cmd.cd.none': 'Нет такого каталога: {path}',
+    'cmd.new.done': 'Новая сессия в этой ветке. Контекст очищен.',
+    'cmd.stop.killed': 'Ход остановлен.',
+    'cmd.stop.nothing': 'Нечего останавливать.',
+    'menu.status': 'Сессии, модель, активные ходы',
+    'menu.cd': 'Привязать тему к каталогу проекта',
+    'menu.send': 'Прислать файл из проекта в чат',
+    'menu.prices': 'Цены моделей у роутера',
+    'menu.stop': 'Остановить текущий ход',
+    'menu.new': 'Новая сессия в этой теме',
+    'menu.seed': 'Засеять пустую тему текстом и закрепить',
+    'menu.sessions': 'Последние сессии',
+    'menu.resume': 'Продолжить сессию по id',
+    'menu.models': 'Доступные модели',
+    'menu.model': 'Показать или сменить модель',
+    'menu.skills': 'Установленные скиллы',
+    'menu.soul': 'Персона агента',
+    'menu.plugins': 'Установленные плагины',
+    'menu.plugin': 'Включить или выключить плагин',
+    'menu.app': 'Управление десктоп-приложением',
+    'menu.restart': 'Перезапустить агента',
+    'menu.help': 'Все команды и подсказки',
+    'menu.lang': 'Язык интерфейса: en, ru, zh',
+  },
+  zh: {
+    'status.working': '处理中',
+    'status.done': '完成',
+    'status.failed': '运行失败',
+    'status.queued': '排队中',
+    'status.stop': '停止',
+    'help.body': "任务直接以文本发送。每个论坛话题是一个独立会话：\n\n工作: /cd \u003c项目\u003e · /new · /stop · /send \u003c文件\u003e · /seed \u003c文本\u003e\n会话: /status · /sessions [n] · /resume \u003cid\u003e\n模型: /models · /model \u003cid\u003e · /prices\n扩展: /skills · /plugins · /plugin add|remove · /soul\n其他: /lang · /doctor · /logs [errors|N] · /app · /restart · /help",
+    'btn.stop': '停止',
+    'btn.logs': '日志',
+    'btn.retry': '重试',
+    'btn.doctor': '诊断',
+    'status.cache': '缓存',
+    'status.steps': '步',
+    'status.thinking': '等待模型',
+    'err.timeout': '{min} 分钟无活动 — 已中断',
+    'err.generic': '出现错误',
+    'msg.started': 'DSH 的 Telegram 桥已启动（headless）。直接发送任务；/help 查看命令。',
+    'msg.unknownCommand': '未知命令：{cmd}。打开 /help 查看机器人支持的全部命令。',
+    'msg.langSet': '界面语言已切换为中文。',
+    'cmd.help.title': '命令',
+    'cmd.help.hint': '发送任意文本即可开始任务。在论坛话题中：/cd <项目> 将该话题绑定到项目目录。',
+    'cmd.cd.bound': '话题已绑定到项目：\n{path}\n\n之后所有操作都在此目录执行。',
+    'cmd.cd.reset': '话题目录已恢复为默认。',
+    'cmd.cd.none': '目录不存在：{path}',
+    'cmd.new.done': '已在本话题开始新会话，上下文已清空。',
+    'cmd.stop.killed': '已停止当前任务。',
+    'cmd.stop.nothing': '没有可停止的任务。',
+    'menu.status': '会话、模型、进行中的任务',
+    'menu.cd': '将本话题绑定到项目目录',
+    'menu.send': '把项目中的文件发送到聊天',
+    'menu.prices': '路由器的模型价格',
+    'menu.stop': '停止当前任务',
+    'menu.new': '在本话题开始新会话',
+    'menu.seed': '用文本初始化空话题并置顶',
+    'menu.sessions': '最近的会话',
+    'menu.resume': '按 id 继续会话',
+    'menu.models': '可用模型',
+    'menu.model': '查看或切换模型',
+    'menu.skills': '已安装的技能',
+    'menu.soul': '代理人格设定',
+    'menu.plugins': '已安装的插件',
+    'menu.plugin': '启用或停用插件',
+    'menu.app': '桌面应用控制',
+    'menu.restart': '重启代理',
+    'menu.help': '全部命令与提示',
+    'menu.lang': '界面语言：en、ru、zh',
+  },
+};
+
+/** Telegram sends zh-hans / zh-hans-cn / zh-CN; all of them mean the same locale. */
+export function normalizeLang(code) {
+  const raw = String(code || '').toLowerCase();
+  if (!raw) return '';
+  if (raw.startsWith('zh')) return 'zh';
+  if (raw.startsWith('en')) return 'en';
+  if (raw.startsWith('ru')) return 'ru';
+  return '';
+}
+
+export function t(lang, key, vars = {}) {
+  const table = DICT[lang] || DICT.ru;
+  const text = table[key] ?? DICT.ru[key] ?? key;
+  return String(text).replace(/\{(\w+)\}/g, (_, name) => (vars[name] ?? `{${name}}`));
+}
+
+/** Menu rows for setMyCommands, translated per locale. */
+export function menuFor(lang, commands) {
+  return commands.map((c) => ({ command: c.command, description: t(lang, `menu.${c.command}`) }));
+}
+
+/** Language for a message: topic choice, then config default, then Telegram. */
+export function resolveLang(state, key, msg, config = {}) {
+  const chosen = state?.lang?.[key] || config.lang;
+  // A foreign user must land in English, not Russian: Telegram reports the
+  // sender's own locale, and everything outside ru/zh/en falls back to en.
+  return normalizeLang(chosen) || normalizeLang(msg?.from?.language_code) || 'en';
+}

package/package.json

@@ -1,50 +1,50 @@
-{
-  "name": "dsh-tg-bridge",
-  "version": "1.0.2",
-  "description": "Telegram bridge for DeepSeek Harness: text, voice, photos and project-per-topic sessions without opening the desktop app",
-  "type": "module",
-  "main": "bridge.mjs",
-  "bin": {
-    "dsh-tg": "./cli.mjs"
-  },
-  "files": [
-    "cli.mjs",
-    "bridge.mjs",
-    "setup.mjs",
-    "control.mjs",
-    "bridge-kick.mjs",
-    "bridge-restart-idle.mjs",
-    "restart-after-send.mjs",
-    "prices.mjs",
-    "bot-menu.mjs",
-    "transcribe.py",
-    "patches/",
-    "docs/",
-    "config.example.json",
-    "install.sh",
-    "install.ps1",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "start": "node bridge.mjs",
-    "setup": "node setup.mjs",
-    "check": "node setup.mjs --check",
-    "menu": "node bot-menu.mjs",
-    "doctor": "node bridge-kick.mjs"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "keywords": [
-    "deepseek-harness",
-    "dsh",
-    "telegram",
-    "bridge",
-    "bot",
-    "whisper",
-    "voice"
-  ],
-  "license": "MIT",
-  "dependencies": {}
-}
+{
+    "name":  "dsh-tg-bridge",
+    "version":  "1.1.1",
+    "description":  "Telegram bridge for DeepSeek Harness: text, voice, photos and project-per-topic sessions without opening the desktop app",
+    "type":  "module",
+    "main":  "bridge.mjs",
+    "bin":  {
+                "dsh-tg":  "./cli.mjs"
+            },
+    "scripts":  {
+                    "start":  "node bridge.mjs",
+                    "setup":  "node setup.mjs",
+                    "check":  "node setup.mjs --check",
+                    "menu":  "node bot-menu.mjs",
+                    "doctor":  "node bridge-kick.mjs"
+                },
+    "engines":  {
+                    "node":  "\u003e=20"
+                },
+    "keywords":  [
+                     "deepseek-harness",
+                     "dsh",
+                     "telegram",
+                     "bridge",
+                     "bot",
+                     "whisper",
+                     "voice"
+                 ],
+    "license":  "MIT",
+    "dependencies":  {
+
+                     },
+    "files":  [
+                  "bridge.mjs",
+                  "control.mjs",
+                  "i18n.mjs",
+                  "prices.mjs",
+                  "setup.mjs",
+                  "bot-menu.mjs",
+                  "bridge-kick.mjs",
+                  "bridge-restart-idle.mjs",
+                  "restart-after-send.mjs",
+                  "transcribe.py",
+                  "cli.mjs",
+                  "README.md",
+                  "LICENSE",
+                  "config.example.json",
+                  "patches/"
+              ]
+}