dsh-tg-bridge 1.2.6 → 1.2.8

package/README.md

@@ -74,6 +74,21 @@ irm https://raw.githubusercontent.com/aleksvega/dsh-tg-bridge/main/install.ps1 |
 Id берётся у [@userinfobot](https://t.me/userinfobot), токен — у
 [@BotFather](https://t.me/BotFather).
 
+### Настройки бота в Telegram
+
+Три вещи, без которых бот будет молчать в группе или работать наполовину:
+
+1. **Privacy mode → Disable** (`/setprivacy` у BotFather). Иначе бот видит
+   только команды, а обычный текст в теме — нет.
+2. **Темы включены** в настройках группы (Edit → Topics). Без них вся работа
+   идёт в один чат, отдельные сессии на тему не создаются.
+3. **Право Pin Messages** для бота. Нужно только для закрепления первого
+   сообщения темы; без него мост продолжит работать, но пин не поставит.
+
+Меню команд настраивать руками не нужно: мост ставит его сам при старте, сразу
+на русском, английском и китайском. Полная таблица настроек, права, проверка и
+типичные ошибки — [docs/TELEGRAM-SETUP.md](docs/TELEGRAM-SETUP.md).
+
 **Автозапуск** установщик ставит сам: `launchd` на macOS, `systemd --user` на
 Linux. На Windows `setup` регистрирует задачу `DSH-TG-Bridge` и минутный сторож
 `DSH-Bridge-Kick`, который поднимает мост после падения.
@@ -153,6 +168,7 @@ Telegram → bridge.mjs → dsh --profile headless --json → ответ
 
 ## Документация
 
+- [docs/TELEGRAM-SETUP.md](docs/TELEGRAM-SETUP.md) — настройки BotFather, группы и права бота
 - [docs/STATE.md](docs/STATE.md) — что работает, известные проблемы
 - [docs/ROADMAP.md](docs/ROADMAP.md) — что дальше
 - [docs/UX-ANALYSIS.md](docs/UX-ANALYSIS.md) — разбор интерактива

package/bridge.mjs

@@ -22,7 +22,7 @@ import dns from 'node:dns';
 import net from 'node:net';
 dns.setDefaultResultOrder('ipv4first');
 net.setDefaultAutoSelectFamily(false);
-import { handleControl, CONTROL_COMMANDS, CONTROL_COMMAND_HINT } from './control.mjs';
+import { handleControl, CONTROL_COMMANDS } from './control.mjs';
 import { renderPrices } from './prices.mjs';
 import { t, resolveLang } from './i18n.mjs';
 
@@ -607,6 +607,7 @@ export function toTelegramHtml(input) {
 async function send(chatId, text, threadId = 0, replyTo = 0) {
   const html = config.plainText === true ? '' : toTelegramHtml(text);
   const parts = html ? chunk(html, 3800) : chunk(toPlainText(text) || '(пусто)');
+  let lastId = 0;
   for (const part of parts) {
     const body = { chat_id: chatId, text: part, disable_web_page_preview: true };
     if (html) body.parse_mode = 'HTML';
@@ -627,7 +628,9 @@ async function send(chatId, text, threadId = 0, replyTo = 0) {
       res = await tg('sendMessage', body);
     }
     log(`sent chat=${chatId}${threadId ? ` topic=${threadId}` : ''} msg=${res.message_id} len=${part.length}${html ? ' html' : ''}`);
+    lastId = res.message_id;
   }
+  return lastId;
 }
 
 /** Remember which topics already got their seed message, so it happens once. */
@@ -676,14 +679,14 @@ async function ensureTopicSeed(chatId, threadId, text) {
  * reads as a log of what was started instead of a wall of prompts. The full
  * text lives in the topic itself; this is only the pointer.
  */
-async function logTopicToGeneral(chatId, threadId, text) {
+async function logTopicToGeneral(chatId, threadId, text, lang = 'ru') {
   if (config.topicLog === false) return;
   const head = String(text ?? '').replace(/\s+/g, ' ').trim();
   const preview = head.length > 90 ? `${head.slice(0, 90)}…` : head;
   try {
     await tg('sendMessage', {
       chat_id: chatId,
-      text: `📌 Новая тема: ${preview}\n→ работа идёт в теме, здесь — лог.`,
+      text: t(lang, 'msg.topicLog', { preview }),
       disable_web_page_preview: true,
     });
     log(`topic ${threadId} logged to General`);
@@ -845,10 +848,13 @@ async function startProgress(chatId, threadId, lang = 'ru') {
     // 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');
-    const more = steps.length > 3 ? `\n…и ещё ${steps.length - 3}` : '';
+    const more = steps.length > 3 ? `\n${t(lang, 'status.more', { n: steps.length - 3 })}` : '';
     // The cache line belongs to the outcome, not to every intermediate edit.
     const cache = final && usage.cacheReadTokens
-      ? `\n🧠 кэш: ${Math.round((usage.cacheReadTokens / Math.max(1, usage.cacheReadTokens + (usage.inputTokens ?? 0))) * 100)}% (${Math.round(usage.cacheReadTokens / 1000)}k из кэша)`
+      ? `\n${t(lang, 'status.cacheLine', {
+        pct: Math.round((usage.cacheReadTokens / Math.max(1, usage.cacheReadTokens + (usage.inputTokens ?? 0))) * 100),
+        k: Math.round(usage.cacheReadTokens / 1000),
+      })}`
       : '';
     return (tail ? `${head}\n${tail}${more}${cache}` : `${head}${cache}`);
   };
@@ -1009,7 +1015,7 @@ async function handleMessage(msg) {
       try {
         const res = await tg('sendMessage', {
           chat_id: chatId,
-          text: '🎤 Расшифровываю…',
+          text: t(lang, 'msg.transcribing'),
           disable_web_page_preview: true,
           ...(threadId > 0 ? { message_thread_id: threadId } : {}),
           ...(msg.message_id ? { reply_to_message_id: msg.message_id } : {}),
@@ -1109,7 +1115,7 @@ async function handleMessage(msg) {
     const seed = await ensureTopicSeed(chatId, threadId, text);
     if (seed) {
       log(`topic ${threadId} seeded with message=${seed}`);
-      await logTopicToGeneral(chatId, threadId, text);
+      await logTopicToGeneral(chatId, threadId, text, lang);
     }
   }
 
@@ -1150,7 +1156,7 @@ async function handleMessage(msg) {
       chatId,
       `${t(lang, 'msg.unknownCommand', { cmd: head })}
 
-${CONTROL_COMMAND_HINT}`,
+${t(lang, 'help.body')}`,
       threadId,
       msg.message_id
     );
@@ -1395,12 +1401,33 @@ function maybeExitForRestart() {
   setTimeout(() => process.exit(75), 300).unref?.();
 }
 
+/**
+ * Queue notices, one per topic. A notice exists only while the person is
+ * waiting: the moment the queued turn starts it is deleted, so a long session
+ * does not leave a column of "идёт уже 7 мин" messages behind (it did).
+ */
+const busyNotices = new Map();
+
+async function clearBusyNotice(key) {
+  const notice = busyNotices.get(key);
+  if (!notice) return;
+  busyNotices.delete(key);
+  try {
+    await tg('deleteMessage', { chat_id: notice.chatId, message_id: notice.messageId });
+  } catch (error) {
+    log(`busy notice delete failed: ${error.message}`);
+  }
+}
+
 function enqueue(key, task, onBusy) {
   const prev = queues.get(key) || Promise.resolve();
   const queued = queues.has(key);
   const run = prev
     .then(() => acquire())
-    .then(() => {
+    .then(async () => {
+      // The person was told "your message is queued"; that notice has done its
+      // job the moment the turn starts and must not linger in the chat.
+      await clearBusyNotice(key);
       // Remember when the turn actually started: the queue notice has to say
       // "идёт уже 24 мин", not just "занято" — silence is what reads as a hang.
       turnStartedAt.set(key, Date.now());
@@ -1409,6 +1436,7 @@ function enqueue(key, task, onBusy) {
     .catch((error) => log(`turn queue error ${key}: ${error.message}`))
     .finally(() => {
       turnStartedAt.delete(key);
+      clearBusyNotice(key).catch(() => {});
       release();
       if (queues.get(key) === run) queues.delete(key);
       // A deferred restart waits for exactly this moment: the answer is out and
@@ -1667,9 +1695,10 @@ async function main() {
         const notice = JSON.parse(readFileSync(RESTART_NOTICE, 'utf8'));
         unlinkSync(RESTART_NOTICE);
         if (Date.now() - Number(notice.at || 0) < 10 * 60 * 1000) {
+          const lang = resolveLang(state, sessionKey(notice.chatId, notice.threadId || 0), null, config);
           await send(
             notice.chatId,
-            `✅ Мост перезапущен — на связи (pid ${process.pid}).\nТема и сессия прежние, можно продолжать.`,
+            `✅ ${t(lang, 'msg.restarted', { pid: process.pid })}`,
             notice.threadId || 0,
           );
         }
@@ -1724,14 +1753,22 @@ async function main() {
         ? async () => {
             await new Promise((resolve) => setTimeout(resolve, Number(config.busyNoticeMs ?? 45000)));
             if (!queues.has(queueKey)) return; // already finished
+            // One notice per topic: a second queued message must not add a
+            // second copy of the same line.
+            if (busyNotices.has(queueKey)) return;
             const started = turnStartedAt.get(queueKey);
             const mins = started ? Math.max(1, Math.round((Date.now() - started) / 60000)) : 0;
-            const howLong = mins > 0 ? `идёт уже ${mins} мин` : 'ещё идёт';
-            await send(
+            const notice = mins > 0
+              ? t(lang, 'msg.busy.since', { min: mins })
+              : t(lang, 'msg.busy.now');
+            const messageId = await send(
               msg.chat.id,
-              `⏳ Предыдущий ход ${howLong} — твоё сообщение в очереди.\nЕсли это затянулось, /stop прервёт ход, и я сразу возьмусь за твоим.`,
+              `⏳ ${notice}`,
               thread,
             );
+            if (messageId) busyNotices.set(queueKey, { chatId: msg.chat.id, messageId });
+            // The turn may have started while the notice was in flight.
+            if (!queues.has(queueKey)) await clearBusyNotice(queueKey);
           }
         : undefined,
     );

package/control.mjs

@@ -349,17 +349,6 @@ export const CONTROL_COMMANDS = [
   'prices', 'help', 'doctor', 'logs', 'lang',
 ];
 
-/** One-line menu used when an unknown command arrives. */
-export const CONTROL_COMMAND_HINT =
-  'Работа: /cd · /new · /stop · /send · /seed\n' +
-  'Сессии: /status · /sessions · /resume\n' +
-  'Модели: /models · /model · /prices\n' +
-  'Расширения: /skills · /soul\n' +
-  'Плагины: /plugins [headless] — список; /plugins add|remove|disable|enable <что> — действия\n' +
-  'Диагностика: /doctor · /logs\n' +
-  'Язык: /lang en|ru|zh\n' +
-  'Служебное: /app · /restart · /help';
-
 export async function handleControl(ctx) {
   const { command, arg, send, reply, log, profile, state, key, config } = ctx;
   const say = (text) => reply(text);
@@ -549,10 +538,10 @@ export async function handleControl(ctx) {
 
     case '/restart': {
       if (arg !== 'confirm') {
-        say('Перезапуск моста: /restart confirm. Приложение DSH: /app restart confirm.');
+        say(t(ctx.lang || 'ru', 'cmd.restart.prompt'));
         return true;
       }
-      say('Перезапускаю мост…');
+      say(t(ctx.lang || 'ru', 'cmd.restart.started'));
       const bridge = fileURLToPath(new URL('./bridge.mjs', import.meta.url));
       // Tell the replacement process where to confirm, so the chat does not go
       // silent after "Перезапускаю мост…" (it did, twice on 2026-10-24).

package/i18n.mjs

@@ -25,11 +25,20 @@ const DICT = {
     'btn.retry': 'Retry',
     'btn.doctor': 'Doctor',
     'status.cache': 'cache',
+    'status.more': '…and {n} more',
+    'status.cacheLine': '🧠 cache: {pct}% ({k}k from cache)',
+    'msg.topicLog': '📌 New topic: {preview}\n→ work happens in the topic, this is the log.',
+    'msg.transcribing': '🎤 Transcribing…',
     'status.steps': 'steps',
     'status.thinking': 'waiting for the model',
     'err.timeout': 'no activity for {min} min — turn interrupted',
     'err.generic': 'something went wrong',
+    'msg.busy.since': '⏳ The previous turn has been running for {min} min — your message is queued.\nIf it stalls, /stop interrupts it and I take yours right away.',
+    'msg.busy.now': '⏳ The previous turn is still running — your message is queued.\nIf it stalls, /stop interrupts it and I take yours right away.',
     'msg.started': 'Telegram bridge for DSH is running (headless). Send a task; /help for commands.',
+    'msg.restarted': 'Bridge restarted — back online (pid {pid}).\nThe topic and session are the same; keep going.',
+    'cmd.restart.prompt': 'To restart the bridge: /restart confirm. For the DSH app: /app restart confirm.',
+    'cmd.restart.started': 'Restarting the bridge…',
     'msg.unknownCommand': 'Unknown command: {cmd}. Open /help — it lists everything this bot can do.',
     'msg.langSet': 'Language set to English.',
     'cmd.help.title': 'Commands',
@@ -72,11 +81,20 @@ const DICT = {
     'btn.retry': 'Повторить',
     'btn.doctor': 'Диагноз',
     'status.cache': 'кэш',
+    'status.more': '…и ещё {n}',
+    'status.cacheLine': '🧠 кэш: {pct}% ({k}k из кэша)',
+    'msg.topicLog': '📌 Новая тема: {preview}\n→ работа идёт в теме, здесь — лог.',
+    'msg.transcribing': '🎤 Расшифровываю…',
     'status.steps': 'шагов',
     'status.thinking': 'жду модель',
     'err.timeout': 'нет активности {min} мин — ход прерван',
     'err.generic': 'что-то пошло не так',
+    'msg.busy.since': '⏳ Предыдущий ход идёт уже {min} мин — твоё сообщение в очереди.\nЕсли это затянулось, /stop прервёт ход, и я сразу возьмусь за твоим.',
+    'msg.busy.now': '⏳ Предыдущий ход ещё идёт — твоё сообщение в очереди.\nЕсли это затянулось, /stop прервёт ход, и я сразу возьмусь за твоим.',
     'msg.started': 'Telegram-мост DSH запущен (headless). Пиши задачу; /help — команды.',
+    'msg.restarted': 'Мост перезапущен — на связи (pid {pid}).\nТема и сессия прежние, можно продолжать.',
+    'cmd.restart.prompt': 'Перезапуск моста: /restart confirm. Приложение DSH: /app restart confirm.',
+    'cmd.restart.started': 'Перезапускаю мост…',
     'msg.unknownCommand': 'Неизвестная команда: {cmd}. Открой /help — там всё, что умеет бот.',
     'msg.langSet': 'Язык переключён на русский.',
     'cmd.help.title': 'Команды',
@@ -119,11 +137,20 @@ const DICT = {
     'btn.retry': '重试',
     'btn.doctor': '诊断',
     'status.cache': '缓存',
+    'status.more': '…还有 {n} 条',
+    'status.cacheLine': '🧠 缓存：{pct}%（{k}k 来自缓存）',
+    'msg.topicLog': '📌 新主题：{preview}\n→ 工作在主题里进行，这里是日志。',
+    'msg.transcribing': '🎤 正在转写…',
     'status.steps': '步',
     'status.thinking': '等待模型',
     'err.timeout': '{min} 分钟无活动 — 已中断',
     'err.generic': '出现错误',
+    'msg.busy.since': '⏳ 上一轮已运行 {min} 分钟 —— 你的消息在队列中。\n如果太久，/stop 会中断它，我马上处理你的消息。',
+    'msg.busy.now': '⏳ 上一轮还在运行 —— 你的消息在队列中。\n如果太久，/stop 会中断它，我马上处理你的消息。',
     'msg.started': 'DSH 的 Telegram 桥已启动（headless）。直接发送任务；/help 查看命令。',
+    'msg.restarted': '桥已重启，连接正常（pid {pid}）。\n主题和会话不变，可以继续。',
+    'cmd.restart.prompt': '重启桥：/restart confirm。重启 DSH 应用：/app restart confirm。',
+    'cmd.restart.started': '正在重启桥…',
     'msg.unknownCommand': '未知命令：{cmd}。打开 /help 查看机器人支持的全部命令。',
     'msg.langSet': '界面语言已切换为中文。',
     'cmd.help.title': '命令',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-tg-bridge",
-  "version": "1.2.6",
+  "version": "1.2.8",
   "description": "Telegram bridge for DeepSeek Harness: text, voice, photos and project-per-topic sessions without opening the desktop app",
   "type": "module",
   "main": "bridge.mjs",