dsh-tg-bridge 1.2.6 → 1.2.7

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';
 
@@ -676,14 +676,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 +845,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 +1012,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 +1112,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 +1153,7 @@ async function handleMessage(msg) {
       chatId,
       `${t(lang, 'msg.unknownCommand', { cmd: head })}
 
-${CONTROL_COMMAND_HINT}`,
+${t(lang, 'help.body')}`,
       threadId,
       msg.message_id
     );
@@ -1667,9 +1670,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,
           );
         }
@@ -1726,10 +1730,12 @@ async function main() {
             if (!queues.has(queueKey)) return; // already finished
             const started = turnStartedAt.get(queueKey);
             const mins = started ? Math.max(1, Math.round((Date.now() - started) / 60000)) : 0;
-            const howLong = mins > 0 ? `идёт уже ${mins} мин` : 'ещё идёт';
+            const notice = mins > 0
+              ? t(lang, 'msg.busy.since', { min: mins })
+              : t(lang, 'msg.busy.now');
             await send(
               msg.chat.id,
-              `⏳ Предыдущий ход ${howLong} — твоё сообщение в очереди.\nЕсли это затянулось, /stop прервёт ход, и я сразу возьмусь за твоим.`,
+              `⏳ ${notice}`,
               thread,
             );
           }

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.7",
   "description": "Telegram bridge for DeepSeek Harness: text, voice, photos and project-per-topic sessions without opening the desktop app",
   "type": "module",
   "main": "bridge.mjs",