dsh-tg-bridge 1.1.2 → 1.2.1

package/README.md

@@ -18,7 +18,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`).
+- **Кнопки «Стоп»/«Повторить», подтверждения инструментов** — прямо в сообщении, без набора команд.
 
 ## Требования
 
@@ -37,74 +37,75 @@ Telegram-мост для [DeepSeek Harness](https://deepseek.com): управл
 
 ## Установка
 
-Три способа, выбери один.
+Одна команда: токен бота и свой числовой id. Руками править ничего не нужно.
 
-**A. npm (рекомендуется)**
+**Windows (PowerShell)**
 
-```bash
-npx dsh-tg-bridge@latest init     # создать config.json из шаблона
-npx dsh-tg-bridge@latest check    # диагностика, ничего не меняет
-npx dsh-tg-bridge@latest setup    # установить и запустить мост
+```powershell
+npx dsh-tg-bridge@latest init --token 123456789:AA... --user 311217285
+npx dsh-tg-bridge@latest setup
 ```
 
-**B. Одной строкой (curl / PowerShell)**
+**macOS / Linux**
 
 ```bash
-# macOS / Linux
-curl -fsSL https://raw.githubusercontent.com/aleksvega/dsh-tg-bridge/main/install.sh | bash
+DSH_TG_TOKEN=123456789:AA... DSH_TG_USER=311217285 \
+  bash -c "$(curl -fsSL https://raw.githubusercontent.com/aleksvega/dsh-tg-bridge/main/install.sh)"
 ```
 
+**Windows одной строкой** (то же самое, ставит и запускает):
+
 ```powershell
-# Windows
+$env:DSH_TG_TOKEN='123456789:AA...'; $env:DSH_TG_USER='311217285'
 irm https://raw.githubusercontent.com/aleksvega/dsh-tg-bridge/main/install.ps1 | iex
 ```
 
-**C. Вручную**
+Что делает `init`:
 
-```bash
-git clone https://github.com/aleksvega/dsh-tg-bridge.git ~/.dsh/tg-bridge
-cd ~/.dsh/tg-bridge
-cp config.example.json config.json
-node cli.mjs check
-node cli.mjs setup
-```
-
-**2. Положить токен бота в хранилище DSH**
+| Что | Куда |
+|---|---|
+| токен бота | `~/.dsh/.credentials.yaml` → `refs.DSH_TELEGRAM_BOT_TOKEN`; остальные ключи не трогает |
+| твой id и рабочий каталог | `~/.dsh/tg-bridge/config.json`; существующий файл не перезаписывает |
+| профиль `headless` | проверяет и подсказывает, как создать, если его нет |
 
-Файл `~/.dsh/.credentials.yaml`, секция `refs`:
+Флаги `init`: `--cwd <путь>` (по умолчанию `~/Projects`), `--voice` (включить
+расшифровку голоса), `--dry-run` (показать, что будет записано, и ничего не менять).
 
-```yaml
-refs:
-  DSH_TELEGRAM_BOT_TOKEN: "123456789:AA..."
-```
+Id берётся у [@userinfobot](https://t.me/userinfobot), токен — у
+[@BotFather](https://t.me/BotFather).
 
-Имя переменной может быть любым с префиксом `DSH_TELEGRAM_BOT_TOKEN_` —
-мост найдёт его сам.
+**Автозапуск** установщик ставит сам: `launchd` на macOS, `systemd --user` на
+Linux. На Windows `setup` регистрирует задачу `DSH-TG-Bridge` и минутный сторож
+`DSH-Bridge-Kick`, который поднимает мост после падения.
 
-**3. Создать конфиг**
+**Вручную** (если нужен полный контроль):
 
 ```bash
-cp config.example.json config.json
+git clone https://github.com/aleksvega/dsh-tg-bridge.git ~/.dsh/tg-bridge
+cd ~/.dsh/tg-bridge
+node cli.mjs init --token 123456789:AA... --user 311217285
+node cli.mjs check     # отчёт, ничего не меняет
+node cli.mjs setup     # остановить старый мост и поднять новый
 ```
 
-Заполнить `allowedUserIds` — свой числовой id (узнать у
-[@userinfobot](https://t.me/userinfobot)). Без него мост не отвечает никому:
-это защита от чужих сообщений.
+Если мост уже стоит, `setup` перезапускает его на новом коде и переустанавливает
+меню команд.
 
-**4. Применить и проверить**
+## Если что-то не так
 
-```bash
-node setup.mjs          # остановит старый мост, поднимет новый, поставит меню
-node setup.mjs --check  # только отчёт, ничего не меняет
-```
+Ответ на ошибку заканчивается кодом — по нему видно, что чинить:
 
-**5. Автозапуск (Windows)**
-
-```powershell
-Register-ScheduledTask -TaskName "DSH-TG-Bridge" `
-  -Action (New-ScheduledTaskAction -Execute "node" -Argument "bridge.mjs" -WorkingDirectory "$HOME\.dsh\tg-bridge") `
-  -Trigger (New-ScheduledTaskTrigger -AtLogOn) -Force
-```
+| Код | Что значит |
+|---|---|
+| `INSUFFICIENT_QUOTA` | баланс провайдера пуст: пополни или оставь free-модели (`/prices`, `/models`) |
+| `TG_CONFLICT` | того же бота опрашивает второй процесс: `/doctor`, затем `/restart` |
+| `MISSING_CREDENTIAL` | в профиле нет ключа провайдера: добавь в приложении DSH |
+| `NO_DSH_CLI` | не найден CLI DeepSeek Harness: проверь установку приложения |
+| `NETWORK` | нет сети до провайдера: повтори, проверь VPN/DNS |
+| `SANDBOX_DENY` | DSH запретил доступ к файлу или каталогу: проверь путь проекта и права |
+| `UNKNOWN_MODEL` | модель из конфига недоступна: список рабочих в `/models` |
+| `EMPTY_RESPONSE` | модель ничего не вернула: повтори или смени модель (`/model`) |
+| `TURN_FAILED` | причина не распознана: `/doctor` и `/logs errors` |
 
 ## Проверка
 

package/bot-menu.mjs

@@ -14,9 +14,17 @@ import { homedir } from 'node:os';
 const args = new Set(process.argv.slice(2));
 
 const token = (() => {
-  const yaml = readFileSync(join(homedir(), '.dsh', '.credentials.yaml'), 'utf8');
-  const m = /^\s*(DSH_TELEGRAM_BOT_TOKEN_[A-Z0-9_]+):\s*["']?([^"'\s]+)/m.exec(yaml);
-  return m ? m[2] : '';
+  const env = (process.env.DSH_TELEGRAM_BOT_TOKEN || '').trim();
+  if (env) return env;
+  try {
+    const home = process.env.DSH_HOME || join(homedir(), '.dsh');
+    const yaml = readFileSync(join(home, '.credentials.yaml'), 'utf8');
+    // `dsh-tg init` writes the plain name; the DSH app adds a random suffix.
+    const m = /^\s*(DSH_TELEGRAM_BOT_TOKEN[A-Z0-9_]*):\s*["']?([^"'\s]+)/m.exec(yaml);
+    return m ? m[2] : '';
+  } catch {
+    return '';
+  }
 })();
 
 /** The real, implemented surface of dsh-tg-bridge — nothing aspirational. */
@@ -34,8 +42,7 @@ const COMMANDS = [
   { command: 'model', description: 'Сменить модель: /model <id>' },
   { command: 'skills', description: 'Скиллы: список или текст одного' },
   { command: 'soul', description: 'Персона: показать или задать' },
-  { command: 'plugins', description: 'Плагины профиля' },
-  { command: 'plugin', description: 'add/remove/disable/enable плагина' },
+  { command: 'plugins', description: 'Список и управление: add/remove/disable/enable' },
   { command: 'app', description: 'Перезапуск приложения: /app restart confirm' },
   { command: 'restart', description: 'Перезапуск моста: /restart confirm' },
   { command: 'doctor', description: 'Диагностика: мост, сеть, диск, каталог, сессия' },
@@ -59,8 +66,7 @@ const COMMANDS_EN = [
   { 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: 'plugins', description: 'List and manage: add/remove/disable/enable' },
   { command: 'app', description: 'Desktop app control' },
   { command: 'restart', description: 'Restart the bridge: /restart confirm' },
   { command: 'doctor', description: 'Diagnostics: bridge, network, disk, directory, session' },
@@ -84,8 +90,7 @@ const COMMANDS_ZH = [
   { command: 'model', description: '查看或切换模型' },
   { command: 'skills', description: '已安装的技能' },
   { command: 'soul', description: '代理人格设定' },
-  { command: 'plugins', description: '已安装的插件' },
-  { command: 'plugin', description: '启用或停用插件' },
+  { command: 'plugins', description: '列表与管理：add/remove/disable/enable' },
   { command: 'app', description: '桌面应用控制' },
   { command: 'restart', description: '重启桥接：/restart confirm' },
   { command: 'doctor', description: '诊断：桥接、网络、磁盘、目录、会话' },

package/bridge.mjs

@@ -26,10 +26,13 @@ import { renderPrices } from './prices.mjs';
 import { t, resolveLang } from './i18n.mjs';
 
 const HOME = homedir();
-const DIR = join(HOME, '.dsh', 'tg-bridge');
+const DSH_HOME = process.env.DSH_HOME || join(HOME, '.dsh');
+// State, config and logs live here. DSH_TG_HOME lets a checkout run with its own
+// directory instead of the default ~/.dsh/tg-bridge.
+const DIR = process.env.DSH_TG_HOME || join(DSH_HOME, 'tg-bridge');
 const STATE = join(DIR, 'state.json');
 const LOG = join(DIR, 'bridge.log');
-const CRED = join(HOME, '.dsh', '.credentials.yaml');
+const CRED = join(DSH_HOME, '.credentials.yaml');
 const PENDING_DIR = join(DIR, 'pending');
 const DONE_FILE = join(DIR, 'done.json');
 const RESTART_MARKER = join(DIR, 'restart.pending');
@@ -199,9 +202,31 @@ function readSecret(name) {
   const m = yaml.match(re);
   return m ? m[1] : '';
 }
-const token = readSecret('DSH_TELEGRAM_BOT_TOKEN_3278A97027814C501779F5E2');
+
+/**
+ * The bot token can be stored under three names: the plain one that `dsh-tg
+ * init` writes, the suffixed one DSH generates when the secret is added through
+ * the app, or an env var. Checking only the suffixed name made a fresh install
+ * fail with "token not found" even though init had just written it.
+ */
+function findToken() {
+  const env = (process.env.DSH_TELEGRAM_BOT_TOKEN || '').trim();
+  if (env) return env;
+  for (const name of ['DSH_TELEGRAM_BOT_TOKEN', 'DSH_TELEGRAM_BOT_TOKEN_3278A97027814C501779F5E2']) {
+    try {
+      const value = readSecret(name);
+      if (value) return value;
+    } catch {}
+  }
+  try {
+    const m = readFileSync(CRED, 'utf8').match(/^\s*(DSH_TELEGRAM_BOT_TOKEN[A-Z0-9_]*):\s*["']?([^"'\s]+)/m);
+    if (m) return m[2];
+  } catch {}
+  return '';
+}
+const token = findToken();
 if (!token) {
-  log('FATAL: bot token not found in .credentials.yaml');
+  log('FATAL: bot token not found — run `node cli.mjs init --token <t> --user <id>` or set DSH_TELEGRAM_BOT_TOKEN');
   process.exit(1);
 }
 const api = (method) => `https://api.telegram.org/bot${token}/${method}`;
@@ -1233,6 +1258,9 @@ ${CONTROL_COMMAND_HINT}`,
   }
   stop.done = true;
   await typing;
+  // Name the cause once, in a short stable code, so a screenshot of the error is
+  // enough to find the fix — and every code has a concrete next step, not "try again".
+  if (result.error) result.error = explainFailure(result.error);
   await progress.finish(result);
 
   // Never move a topic onto a different session once it has one. A retry that
@@ -1265,6 +1293,38 @@ ${CONTROL_COMMAND_HINT}`,
   await send(chatId, result.text || '(пустой ответ)', threadId);
 }
 
+/**
+ * Turn a raw CLI/provider error into `CODE` plus one actionable line.
+ *
+ * Raw text like `AUTH 403 insufficient_user_quota` means nothing to a person on
+ * a phone; the code makes the failure greppable and the hint says what to do.
+ */
+function explainFailure(text) {
+  const raw = String(text);
+  const cases = [
+    [/insufficient_user_quota|insufficient quota|AUTH\b|\b402\b|\bbalance\b|баланс|billing/i,
+      'INSUFFICIENT_QUOTA', 'баланс провайдера пуст. Пополни счёт или оставь free-модели: /prices и /models.'],
+    [/Conflict: terminated by other getUpdates|\b409\b/i,
+      'TG_CONFLICT', 'того же бота опрашивает второй процесс. Останови лишний: /doctor, затем /restart.'],
+    [/MISSING_CREDENTIAL|no credentials|not authenticated/i,
+      'MISSING_CREDENTIAL', 'в профиле нет ключа провайдера. Добавь его в приложении DSH и повтори.'],
+    [/ENOENT|not recognized|не найден.*dsh|dsh\.cmd/i,
+      'NO_DSH_CLI', 'CLI DeepSeek Harness не найден. Проверь установку приложения (нужен dsh.exe в Programs).'],
+    [/fetch failed|ETIMEDOUT|ECONNREFUSED|ENOTFOUND|socket hang up|network/i,
+      'NETWORK', 'сеть до провайдера недоступна. Повтори через минуту; если повторяется — проверь VPN/DNS.'],
+    [/EACCES|EPERM|access is denied|отказано в доступе|sandbox|permission denied/i,
+      'SANDBOX_DENY', 'DSH запретил доступ к файлу или каталогу. Проверь путь проекта и права на него.'],
+    [/UNKNOWN_MODEL|model not found|no such model/i,
+      'UNKNOWN_MODEL', 'модель из конфига недоступна. Список рабочих: /models.'],
+    [/empty response|EMPTY_RESPONSE|no output|пустой ответ/i,
+      'EMPTY_RESPONSE', 'модель ничего не вернула. Повтори или смени модель: /model.'],
+  ];
+  for (const [re, code, hint] of cases) {
+    if (re.test(raw)) return `${raw}\n\n${code}: ${hint}`;
+  }
+  return `${raw}\n\nTURN_FAILED: повтори запрос; если ошибка та же — /doctor и /logs errors.`;
+}
+
 // Per-topic turn queues: one turn at a time inside a topic, different topics run
 // in parallel. Bounded, because every turn is a full Electron process.
 const queues = new Map();

package/cli.mjs

@@ -1,56 +1,212 @@
 #!/usr/bin/env node
 // dsh-tg — CLI entrypoint for the Telegram bridge of DeepSeek Harness.
 //
-//   npx dsh-tg init     copy config.example.json -> config.json
-//   npx dsh-tg setup    install/restart the bridge (writes setup.log)
-//   npx dsh-tg check    diagnostics only, changes nothing
-//   npx dsh-tg doctor   supervisor report (pid, log tail)
-//   npx dsh-tg menu     register the bot command menu
-//   npx dsh-tg start    run the bridge in the foreground
+//   npx dsh-tg init --token <T> --user <ID>   write config + credentials, no editing
+//   npx dsh-tg setup                          install/restart the bridge
+//   npx dsh-tg check                          diagnostics only, changes nothing
+//   npx dsh-tg doctor                         supervisor report (pid, log tail)
+//   npx dsh-tg menu                           register the bot command menu
+//   npx dsh-tg start                          run the bridge in the foreground
+//
+// The goal of `init` is a cold start with ONE command: the person pastes the
+// bot token and their numeric id, and nothing else needs hand-editing.
 import { spawnSync } from 'node:child_process';
-import { copyFileSync, existsSync } from 'node:fs';
-import { dirname, join } from 'node:path';
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const DIR = dirname(fileURLToPath(import.meta.url));
-const pkg = JSON.parse((await import('node:fs')).readFileSync(join(DIR, 'package.json'), 'utf8'));
+const pkg = JSON.parse(readFileSync(join(DIR, 'package.json'), 'utf8'));
+const DSH_HOME = process.env.DSH_HOME || join(homedir(), '.dsh');
+// setup.mjs, the watchdog and /doctor all work on this one directory, so the
+// config must be written here and a checkout elsewhere must be mirrored here.
+const RUNTIME = join(DSH_HOME, 'tg-bridge');
+const RUNTIME_FILES = [
+  'bridge.mjs', 'control.mjs', 'i18n.mjs', 'bot-menu.mjs', 'prices.mjs',
+  'transcribe.py', 'setup.mjs', 'bridge-kick.mjs', 'bridge-restart-idle.mjs',
+  'restart-after-send.mjs', 'config.example.json',
+];
+
+/**
+ * Mirror this checkout into the runtime directory.
+ *
+ * Cloning anywhere except ~/.dsh/tg-bridge used to make `setup` answer "bridge
+ * not found", because every helper looks in the runtime directory. Files are
+ * copied, config.json is never overwritten: it holds the person's id and token.
+ */
+function syncRuntime() {
+  if (resolve(DIR) === resolve(RUNTIME)) return;
+  mkdirSync(join(RUNTIME, 'patches'), { recursive: true });
+  for (const file of RUNTIME_FILES) {
+    if (existsSync(join(DIR, file))) copyFileSync(join(DIR, file), join(RUNTIME, file));
+  }
+  try {
+    for (const patch of readdirSync(join(DIR, 'patches'))) {
+      copyFileSync(join(DIR, 'patches', patch), join(RUNTIME, 'patches', patch));
+    }
+  } catch {}
+  console.log(`  код: скопирован из ${DIR} в ${RUNTIME}`);
+}
 
 const [, , cmd = 'help', ...rest] = process.argv;
 
-const run = (file, args) => {
-  const res = spawnSync(process.execPath, [join(DIR, file), ...args], { stdio: 'inherit', cwd: DIR });
+const run = (file, args, { sync = false } = {}) => {
+  if (sync) syncRuntime();
+  const local = join(DIR, file);
+  const installed = join(RUNTIME, file);
+  // After a sync the installed copy is the freshest; otherwise run this checkout's
+  // own file, which reads state from RUNTIME through DSH_HOME.
+  const script = sync && resolve(RUNTIME) !== resolve(DIR) && existsSync(installed) ? installed : local;
+  const res = spawnSync(process.execPath, [script, ...args], { stdio: 'inherit', cwd: dirname(script) });
   process.exit(res.status ?? 0);
 };
 
+/** `--flag value` reader over a flat argv list. */
+function flag(name, fallback = '') {
+  const at = rest.indexOf(`--${name}`);
+  return at === -1 ? fallback : (rest[at + 1] ?? '');
+}
+
 const help = `
 dsh-tg ${pkg.version} — Telegram bridge for DeepSeek Harness
 
-  dsh-tg init      create config.json from the template
-  dsh-tg setup     install and restart the bridge (setup.log has every step)
-  dsh-tg check     run diagnostics without changing anything
-  dsh-tg doctor    supervisor report: pid, log tail, task state
-  dsh-tg menu      register /commands in the Telegram menu
-  dsh-tg start     run the bridge in the foreground
-  dsh-tg version   print the version
-  dsh-tg help      this text
-
-Docs: docs/STATE.md (current state), docs/ROADMAP.md (next steps),
-      docs/UX-ANALYSIS.md (what is still missing vs a full UI).
+  dsh-tg init --token <bot-token> --user <your-id>   настроить всё одной командой
+  dsh-tg setup     установить и перезапустить мост (setup.log хранит шаги)
+  dsh-tg check     диагностика, ничего не меняет
+  dsh-tg doctor    отчёт супервизора: pid, хвост лога
+  dsh-tg menu      зарегистрировать /команды в меню Telegram
+  dsh-tg start     запустить мост на переднем плане
+  dsh-tg version   версия
+  dsh-tg help      этот текст
+
+init:
+  --token <t>      токен бота от @BotFather (обязательно)
+  --user <id>      ваш числовой id от @userinfobot (обязательно)
+  --cwd <path>     рабочий каталог (по умолчанию ~/Projects)
+  --voice          включить голос (нужен python + faster-whisper)
+  --dry-run        показать, что будет записано, ничего не менять
+
+Docs: docs/STATE.md, docs/ROADMAP.md, docs/UX-ANALYSIS.md.
 `;
 
+/**
+ * Write `DSH_TELEGRAM_BOT_TOKEN: "..."` into the credentials store without
+ * touching other secrets: DSH keeps every credential in this one file, so a
+ * careless rewrite would log the person out of everything else.
+ *
+ * Line-based on purpose: regex over the whole file either misses a `refs:`
+ * that sits mid-document or appends a second `refs:` key, and a duplicate key
+ * silently hides every credential above it.
+ */
+function writeCredential(token, dryRun) {
+  const file = join(DSH_HOME, '.credentials.yaml');
+  const line = `  DSH_TELEGRAM_BOT_TOKEN: "${token}"`;
+  let lines;
+  try {
+    lines = readFileSync(file, 'utf8').split(/\r?\n/);
+  } catch {
+    lines = [];
+  }
+  const existing = lines.findIndex((l) => /^\s*DSH_TELEGRAM_BOT_TOKEN:/.test(l));
+  if (existing !== -1) {
+    if (lines[existing] === line) {
+      console.log('  credentials: токен уже записан');
+      return;
+    }
+    lines[existing] = line;
+    console.log(`  credentials: токен ${dryRun ? 'обновил бы' : 'обновлён'} в ${file}`);
+  } else {
+    const refs = lines.findIndex((l) => /^refs:\s*$/.test(l));
+    if (refs === -1) {
+      const tail = lines.join('\n').trimEnd();
+      lines = [...(tail ? [tail, ''] : []), 'refs:', line];
+    } else {
+      lines.splice(refs + 1, 0, line);
+    }
+    console.log(`  credentials: токен ${dryRun ? 'записал бы' : 'записан'} в ${file}`);
+  }
+  if (dryRun) return;
+  mkdirSync(DSH_HOME, { recursive: true });
+  writeFileSync(file, `${lines.join('\n')}\n`, 'utf8');
+}
+
+/** Build config.json for this person: their id, their cwd, voice only if asked. */
+function writeConfig({ userId, cwd, voice }, dryRun) {
+  const target = join(RUNTIME, 'config.json');
+  const example = JSON.parse(readFileSync(join(DIR, 'config.example.json'), 'utf8'));
+  if (existsSync(target)) {
+    console.log('  config.json: уже существует — не перезаписан');
+    return;
+  }
+  const config = {
+    ...example,
+    allowedUserIds: [Number(userId)],
+    cwd,
+    voice: { ...example.voice, enabled: Boolean(voice) },
+  };
+  delete config._comment;
+  if (dryRun) {
+    console.log(`  config.json: создал бы ${target} (id ${userId}, cwd ${cwd}, voice ${voice ? 'on' : 'off'})`);
+    return;
+  }
+  mkdirSync(RUNTIME, { recursive: true });
+  writeFileSync(target, `${JSON.stringify(config, null, 2)}\n`, 'utf8');
+  console.log(`  config.json: создан (id ${userId}, voice ${voice ? 'вкл' : 'выкл'})`);
+}
+
+/** A missing headless profile cannot be invented: DSH ships its bundles. */
+function checkProfile() {
+  const profile = join(DSH_HOME, 'profiles', 'headless');
+  if (existsSync(profile)) {
+    console.log('  профиль headless: на месте');
+    return true;
+  }
+  console.log('  профиль headless: НЕ НАЙДЕН');
+  console.log('    создай его один раз в приложении DSH: Settings → Profiles → headless,');
+  console.log('    либо скопируй шаблон из сборки: dsh --profile headless --dump-default-config');
+  return false;
+}
+
 switch (cmd) {
   case 'init': {
-    const target = join(DIR, 'config.json');
-    if (existsSync(target)) { console.log('config.json already exists — left untouched'); break; }
-    copyFileSync(join(DIR, 'config.example.json'), target);
-    console.log(`created ${target}\nEdit allowedUserIds and cwd before the first start.`);
+    const token = flag('token');
+    const userId = flag('user');
+    const dryRun = rest.includes('--dry-run');
+    const voice = rest.includes('--voice');
+    const cwd = flag('cwd', join(homedir(), 'Projects'));
+
+    if (!token || !userId) {
+      console.error('init требует --token и --user\n');
+      console.log(help);
+      process.exit(2);
+    }
+    if (!/^\d+$/.test(userId)) {
+      console.error(`--user должен быть числом (получено "${userId}"). Узнать: @userinfobot`);
+      process.exit(2);
+    }
+    if (!/^\d{6,}:[A-Za-z0-9_-]{20,}$/.test(token)) {
+      console.error('--token не похож на токен бота (ожидается 123456789:AA…)');
+      process.exit(2);
+    }
+
+    console.log(`dsh-tg init${dryRun ? ' (dry run)' : ''}\n`);
+    writeCredential(token, dryRun);
+    writeConfig({ userId, cwd, voice }, dryRun);
+    checkProfile();
+    console.log('\nДальше:');
+    console.log('  npx dsh-tg-bridge@latest check   # проверить');
+    console.log('  npx dsh-tg-bridge@latest setup   # поднять мост');
+    console.log('  в Telegram: /doctor');
     break;
   }
-  case 'setup': run('setup.mjs', rest); break;
-  case 'check': run('setup.mjs', ['--check', ...rest]); break;
+  case 'setup': run('setup.mjs', rest, { sync: true }); break;
+  // check must see the installed copy; if the runtime directory was never
+  // populated (custom clone path), mirror first so the report is not a lie.
+  case 'check': run('setup.mjs', ['--check', ...rest], { sync: !existsSync(join(RUNTIME, 'bridge.mjs')) }); break;
   case 'doctor': run('bridge-kick.mjs', rest); break;
   case 'menu': run('bot-menu.mjs', rest); break;
-  case 'start': run('bridge.mjs', rest); break;
+  case 'start': run('bridge.mjs', rest, { sync: true }); break;
   case 'version': console.log(pkg.version); break;
   case 'help': case '--help': case '-h': console.log(help); break;
   default:

package/control.mjs

@@ -354,7 +354,8 @@ export const CONTROL_COMMAND_HINT =
   'Работа: /cd · /new · /stop · /send · /seed\n' +
   'Сессии: /status · /sessions · /resume\n' +
   'Модели: /models · /model · /prices\n' +
-  'Расширения: /skills · /plugins · /plugin · /soul\n' +
+  'Расширения: /skills · /soul\n' +
+  'Плагины: /plugins [headless] — список; /plugins add|remove|disable|enable <что> — действия\n' +
   'Диагностика: /doctor · /logs\n' +
   'Язык: /lang en|ru|zh\n' +
   'Служебное: /app · /restart · /help';
@@ -363,7 +364,21 @@ export async function handleControl(ctx) {
   const { command, arg, send, reply, log, profile, state, key, config } = ctx;
   const say = (text) => reply(text);
 
-  switch (command) {
+  // One command for one job: `/plugins` is both the list and the way to change
+  // things. Two near-identical names (`/plugin` / `/plugins`) invited the exact
+  // mistake of typing the plural with an action. The singular form stays as an
+  // alias so old instructions and muscle memory keep working.
+  let effective = command;
+  if (effective === '/plugins') {
+    const [maybeAction] = String(arg || '').trim().split(/\s+/);
+    // `/plugins add|remove|disable|enable …` is the same work as `/plugin …`;
+    // the case bodies read `arg`, which already holds the action and its value.
+    if (['add', 'remove', 'disable', 'enable'].includes((maybeAction || '').toLowerCase())) {
+      effective = '/plugin';
+    }
+  }
+
+  switch (effective) {
     case '/status': {
       const head = modelOf('headless');
       const desk = modelOf('desktop');
@@ -452,6 +467,10 @@ export async function handleControl(ctx) {
           ...lines,
           orphan.length ? `\nУстановлены, но не в bundles:\n${fmt(orphan)}` : '',
           `\nОтключены строки: ${disabled.length ? disabled.join(', ') : 'нет'}`,
+          // The actions live behind the same command, so the list must say how
+          // to reach them — otherwise people keep hunting for `/plugin`.
+          `\nИзменить: /plugins add <пакет> · remove <имя> · disable <id> · enable <id>`,
+          'Профиль: добавь headless или desktop в конце.',
         ]
           .filter(Boolean)
           .join('\n'),
@@ -464,7 +483,7 @@ export async function handleControl(ctx) {
       const target = (rest[0] === 'headless' || rest[0] === 'desktop') && rest.length > 1 ? rest.shift() : 'desktop';
       const value = rest.join(' ').trim();
       if (!action || !value) {
-        say('Использование:\n/plugin add <npm|github|file:>\n/plugin remove <name>\n/plugin disable <id>\n/plugin enable <id>\nДоп. аргумент headless|desktop — профиль.');
+        say('Использование:\n/plugins add <npm|github|file:>\n/plugins remove <name>\n/plugins disable <id>\n/plugins enable <id>\nПрофиль: допиши headless или desktop.\n\n/plugin — то же самое, старая форма.');
         return true;
       }
       if (action === 'disable' || action === 'enable') {

package/package.json

@@ -1,50 +1,48 @@
-{
-    "name":  "dsh-tg-bridge",
-    "version":  "1.1.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"
-            },
-    "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/"
-              ]
-}
+{
+  "name": "dsh-tg-bridge",
+  "version": "1.2.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": ">=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/"
+  ]
+}

package/setup.mjs

@@ -124,9 +124,12 @@ function pidFilePid() {
 function bridgePids() {
   let pids = [];
   try {
+    // Match the full script path, not just "bridge.mjs": a second install with
+    // its own DSH_HOME and token is a different bot and must not be killed.
+    const filter = `$_.CommandLine -and $_.CommandLine.Contains('${BRIDGE}')`;
     const r = run('powershell', [
       '-NoProfile', '-NonInteractive', '-Command',
-      "Get-CimInstance Win32_Process -Filter \"Name='node.exe'\" | Where-Object { $_.CommandLine -match 'bridge\\.mjs' } | Select-Object -ExpandProperty ProcessId",
+      `Get-CimInstance Win32_Process -Filter "Name='node.exe'" | Where-Object { ${filter} } | Select-Object -ExpandProperty ProcessId`,
     ]);
     pids = (r.stdout || '')
       .split(/\r?\n/)
@@ -141,9 +144,12 @@ function bridgePids() {
 }
 
 function token() {
+  const env = (process.env.DSH_TELEGRAM_BOT_TOKEN || '').trim();
+  if (env) return env;
   try {
     const yaml = readFileSync(CRED, 'utf8');
-    const m = /^\s*(DSH_TELEGRAM_BOT_TOKEN_[A-Z0-9_]+):\s*["']?([^"'\s]+)/m.exec(yaml);
+    // `dsh-tg init` writes the plain name; the DSH app adds a random suffix.
+    const m = /^\s*(DSH_TELEGRAM_BOT_TOKEN[A-Z0-9_]*):\s*["']?([^"'\s]+)/m.exec(yaml);
     return m ? m[2] : '';
   } catch {
     return '';