@dr-co/dsh-node-client 0.0.0-stage → 0.0.60

package/lib/i18n.mjs

@@ -0,0 +1,511 @@
+/**
+ * Язык сообщений клиента: китайский, английский (по умолчанию) и русский.
+ *
+ * Источник истины — локаль: `DSHNC_LANG`, затем `LC_ALL`, затем `LANG`. Язык,
+ * которого нет в словаре, не ошибка: падаем на английский. Так же и с
+ * отсутствующим ключом — берём английский, чтобы сообщение никогда не было
+ * пустым.
+ *
+ * @module dsh-node-client/i18n
+ */
+
+export const LANGS = ['en', 'ru', 'zh']
+
+const DICT = {
+  en: {
+    'files.readChunk.description': 'Read a binary chunk: base64, for copying big files',
+    'files.writeChunk.description': 'Write a chunk into <path>.inprogress; the last chunk renames it into place',
+    'files.sha256.description': 'Hash of a file: compare after copying',
+    'files.arg.base64': 'Chunk bytes in base64',
+    'files.arg.final': 'Last chunk: rename .inprogress into the target path',
+    'help.config': 'config [key=value…]      client settings: show or change',
+    'help.policy': 'policy [url] [key=…]     per-server policy: max, base, approver, tool',
+    'help.audit': 'audit [n]                commands that ran without the sandbox',
+    'help.workdir': 'workdir [path]           session working directory: show or set',
+    'help.onboard': 'onboard                  setup wizard: menu, current values as defaults',
+    'files.api.description': 'Node files: read and write without a shell',
+    'files.read.description': 'Read a file: text and version for later edits',
+    'files.write.description': 'Write a file atomically; ifVersion protects against clobbering',
+    'files.edit.description': 'Replace a literal string in a file; refuses ambiguity',
+    'files.list.description': 'List one directory level',
+    'files.stat.description': 'Check existence, size and version',
+    'files.arg.offset': 'Byte offset to start reading from',
+    'files.arg.limit': 'How many bytes to read at most',
+    'files.arg.version': 'Version from read/stat: refuse the write if the file changed',
+    'files.arg.dirs': 'Create parent directories (default true)',
+    'daemon.reload': 'reloading config (SIGHUP)',
+    'presence.pongTimeout': 'no answer to the ping within {seconds}s — reconnecting',
+    'config.saved': 'settings saved: {patch}',
+    'config.usage': 'usage: dshnc config key=value [key=value…]',
+    'session.ping.description': 'Check that the node answers; returns pong, uptime and platform',
+    'run.resultFailed': 'seq {seq}: could not deliver the result — {message}',
+    'audit.empty': 'no commands without the sandbox yet',
+    'run.auditFailed': 'audit write failed: {message}',
+    'session.chdir.description': 'Switch the working directory of this session (it must exist; create it with session.mkdir)',
+    'session.chdir.arg.path': 'Absolute path of an existing directory (inside the node roots)',
+    'session.mkdir.description': 'Create a directory inside the node roots',
+    'session.mkdir.arg.path': 'Absolute path to create',
+    'session.mkdir.arg.mode': 'Permissions in octal, for example 755',
+    'session.exists': ' (already exists)',
+    'err.writeState': 'cannot write client state: {message} (inside the sandbox only the workdir is writable)',
+    'policy.current': 'access: {access} | roots: {roots}',
+    'policy.saved': 'policy for {url}: {patch}',
+    'session.api.description': 'Session itself: switch the working directory of the session',
+    'session.chdir.description': 'Switch the working directory of this session (all later commands start there)',
+    'session.chdir.arg.path': 'Absolute directory path (must be inside the node roots)',
+    'session.chdir.arg.create': 'Create the directory if it does not exist',
+    'session.cwd.description': 'Show the current working directory of the session',
+    'session.arg.session': 'Session id (defaults to the calling session)',
+    'session.noStore': 'session: the client has no session store',
+    'session.noSession': 'session: no session id in the command metadata',
+    'session.created': ' (created)',
+    'workdir.set': 'workdir: {dir} — each session gets its own subdirectory',
+    'workdir.none': 'workdir is not set: commands run in the daemon directory',
+    'auto.noLauncher': 'WARNING: {path} does not exist — the unit will fail to start',
+    'auto.copyState': 'Move the current state (token, cursor) to {dir}? [y/N]',
+    'auto.copied': 'State copied: {dir}',
+    'auto.copyFailed': 'Could not copy the state ({message}) — run `dshnc connect <link>` as {user}',
+    'auto.copySkip': 'Leaving the state here; the new user will need `dshnc connect <link>`',
+    'help.autostart': 'autostart                questions and a systemd unit',
+    'unit.description': 'dsh-nodes client (dshnc) — remote commands executor',
+    'auto.title': 'Setting up autostart (systemd)',
+    'auto.name': 'Node name',
+    'auto.aliases': 'Aliases, comma separated (the node can be called by any)',
+    'auto.scope': 'Run as system service [system] or inside your user session [user]',
+    'auto.dedicated': 'Create a dedicated system user for it? [y/N]',
+    'auto.username': 'User name',
+    'auto.createUser': 'No rights to create users. Run this and press Enter when done:',
+    'auto.waitingUser': 'waiting for user {user}…',
+    'auto.graphical': 'Start only inside the graphical session (needs DISPLAY)? [y/N]',
+    'auto.written': 'Unit written: {path}',
+    'auto.next': 'Now, as a user with rights:',
+    'auto.stateDir': 'State (token, cursor) lives in {dir}',
+    'auto.copyConfig': 'Copying the existing state to {dir}',
+    'auto.noToken': 'No token yet: after install run `sudo -u {user} dshnc connect <link>`',
+    'auto.done': 'Done.',
+    'bash.arg.stdin': 'Data passed to the command on stdin (up to 64 KiB)',
+    'bash.api.description': 'Shell on the node machine',
+    'bash.exec.description': 'Run a command in the shell and return stdout, stderr and exit code',
+    'bash.arg.command': 'Command line',
+    'bash.arg.cwd': 'Working directory',
+    'bash.arg.timeout': 'Timeout in seconds',
+    'help.title': 'dshnc — dsh-nodes client ({home})',
+    'help.connect': 'connect <url>            connect: a link with a code does everything,',
+    'help.connect2': '                         without a code — request and wait for approval',
+    'help.daemon': 'daemon [url...]          work: declare bash, take commands, reply;',
+    'help.daemon2': '                         without arguments — every server from the config;',
+    'help.daemon3': '                         runs in the foreground (background via systemd/nohup)',
+    'help.foreground': '--foreground             kept for compatibility, same behaviour',
+    'help.status': 'status                   client id and saved servers',
+    'help.version': 'version                  client version',
+    'help.help': 'help                     this screen',
+    'help.env': 'Environment: DSHNC_HOME (state directory), DSHNC_SHELL (default /bin/sh), DSHNC_LANG (en, ru, zh)',
+    'status.id': 'client id:  {id}',
+    'status.name': 'name:       {name}',
+    'status.none': 'no servers yet — start with `dshnc connect <url>`',
+    'status.server': '{url}: {token}, cursor {cursor}, epoch {epoch}{alias}',
+    'status.token.yes': 'token present',
+    'status.token.no': 'no token',
+    'status.alias': ', node {alias}',
+    'version.line': 'dshnc {version} (protocol {proto})',
+    'cmd.unknown': 'unknown command: {command}',
+    'err.needUrl': 'a url is required: dshnc connect https://host/dsh-nodes/pair?v=...',
+    'err.nothingToServe': 'nothing to serve: run `dshnc connect <url>` first',
+    'err.generic': 'error: {message}',
+    'err.aborted': 'aborted',
+    'connect.paired': 'connected: node {node} ({alias}), token saved',
+    'connect.requested': 'request sent: {name} / {short}',
+    'connect.waiting': 'the admin has to approve it in the admin panel — waiting',
+    'connect.approved': 'approved: node {node} ({alias}), token saved',
+    'connect.rejected': 'the request was rejected',
+    'connect.handed': 'the token was already handed out; reissue it in the admin',
+    'connect.timeout': 'the request was not approved within 30 minutes',
+    'connect.done': 'done. next: dshnc daemon',
+    'connect.noCode': 'the link carries no code — connection impossible',
+    'daemon.servers': 'servers: {servers}',
+    'daemon.plugins': 'plugins: {plugins}',
+    'daemon.stopping': 'stopping',
+    'auto.nodeSummary': 'node: {name}',
+    'auto.aliasesSuffix': ', aliases: {aliases}',
+    'auto.userCreated': 'created user {user}',
+    'bash.clipped': '\n… truncated: showing {shown} of {total} characters',
+    'presence.sendFailed': 'could not send a frame: {message}',
+    'presence.openFailed': 'WebSocket did not open: {message}',
+    'presence.badFrame': 'cannot parse a frame',
+    'run.noPlugin': 'no plugin for method {method}',
+    'run.announced': '{base}: declared {apis}, epoch {epoch}',
+    'run.warning': 'warning: {warning}',
+    'run.reconnect': '{base}: the server is of another life (epoch {from} → {to}), cursor reset',
+    'run.restarted': '{base}: the server restarted (epoch {from} → {to}), cursor reset',
+    'run.presenceClosed': '{base}: presence closed ({code}), falling back to polling',
+    'run.retry': '{base}: {message} — retrying in {seconds}s',
+    'run.tokenRejected': '{base}: the token does not fit, a new request is needed',
+    'run.command': '{base}: {seq} {method} → {flag}',
+    'run.ok': 'ok',
+    'run.error': 'error {code}',
+    'api.unauthorized': 'the token did not fit',
+    'api.timeout': 'the server did not answer',
+    'api.http': 'HTTP {status}',
+    'bash.needCommand': 'command is required and must be a non-empty string',
+    'bash.timeout': 'the command did not finish within {seconds}s and was killed',
+    'bash.cancelled': 'the call was cancelled',
+    'plugins.noName': '{label}: no api.name',
+    'plugins.nameType': '{label}: api.name must be a string',
+    'plugins.noMethods': '{label}: api.methods is empty',
+    'plugins.noHandle': '{label}: no handle()',
+    'plugins.methodNoName': '{label}: a method without a name',
+    'plugins.methodNoArgs': '{label}: method {method} has no args schema',
+    'plugins.directory': 'cannot read the plugins directory: {message}',
+    'plugins.taken': 'plugin {entry} declares api "{name}", which is already taken — skipped',
+    'plugins.failed': 'plugin {entry} did not load: {message}',
+  },
+  ru: {
+    'files.readChunk.description': 'Прочитать двоичный кусок: base64, для копирования больших файлов',
+    'files.writeChunk.description': 'Записать кусок в <path>.inprogress; последний переименовывает файл на место',
+    'files.sha256.description': 'Хеш файла: сверять после копирования',
+    'files.arg.base64': 'Байты куска в base64',
+    'files.arg.final': 'Последний кусок: переименовать .inprogress в целевой путь',
+    'help.config': 'config [ключ=значение…]  настройки клиента: показать или изменить',
+    'help.policy': 'policy [url] [ключ=…]    правила для сервера: max, base, approver, tool',
+    'help.audit': 'audit [сколько]          что исполнялось без песочницы (последние записи)',
+    'help.workdir': 'workdir [путь]           рабочая директория: показать или задать',
+    'help.onboard': 'onboard                  мастер настройки: меню, текущие значения по умолчанию',
+    'files.api.description': 'Файлы на узле: чтение и запись без оболочки',
+    'files.read.description': 'Прочитать файл: текст и версия для последующих правок',
+    'files.write.description': 'Записать файл атомарно; ifVersion защищает от затирания',
+    'files.edit.description': 'Заменить строку в файле; при неоднозначности отказывает',
+    'files.list.description': 'Показать содержимое каталога',
+    'files.stat.description': 'Проверить наличие, размер и версию',
+    'files.arg.offset': 'С какого байта читать',
+    'files.arg.limit': 'Сколько байт прочитать максимум',
+    'files.arg.version': 'Версия из read/stat: отказ, если файл изменился',
+    'files.arg.dirs': 'Создавать родительские каталоги (по умолчанию да)',
+    'daemon.reload': 'перечитываю конфиг (SIGHUP)',
+    'presence.pongTimeout': 'нет ответа на пинг за {seconds} с — переподключаюсь',
+    'config.saved': 'настройки сохранены: {patch}',
+    'config.usage': 'использование: dshnc config ключ=значение [ключ=значение…]',
+    'session.ping.description': 'Проверить, что узел отвечает: возвращает pong, аптайм и платформу',
+    'run.resultFailed': 'seq {seq}: не смог отправить результат — {message}',
+    'audit.empty': 'команд без песочницы пока не было',
+    'run.auditFailed': 'не смог записать аудит: {message}',
+    'session.chdir.description': 'Переключить рабочий каталог сессии (каталог должен существовать; создать — session.mkdir)',
+    'session.chdir.arg.path': 'Абсолютный путь существующего каталога (внутри разрешённых на узле)',
+    'session.mkdir.description': 'Создать каталог внутри разрешённых на узле',
+    'session.mkdir.arg.path': 'Абсолютный путь, который нужно создать',
+    'session.mkdir.arg.mode': 'Права в восьмеричном виде, например 755',
+    'session.exists': ' (уже существует)',
+    'err.writeState': 'не удалось записать состояние клиента: {message} (внутри песочницы писать можно только в рабочий каталог)',
+    'policy.current': 'доступ: {access} | разрешённые каталоги: {roots}',
+    'policy.saved': 'правила для {url}: {patch}',
+    'session.api.description': 'Сама сессия: переключение рабочего каталога',
+    'session.chdir.description': 'Переключить рабочий каталог сессии — все следующие команды начнутся там',
+    'session.chdir.arg.path': 'Абсолютный путь каталога (должен быть внутри разрешённых на узле)',
+    'session.chdir.arg.create': 'Создать каталог, если его нет',
+    'session.cwd.description': 'Показать текущий рабочий каталог сессии',
+    'session.arg.session': 'Идентификатор сессии (по умолчанию — вызывающая)',
+    'session.noStore': 'session: у клиента нет хранилища сессий',
+    'session.noSession': 'session: в метаданных команды нет идентификатора сессии',
+    'session.created': ' (создан)',
+    'workdir.set': 'рабочая директория: {dir} — у каждой сессии будет свой подкаталог',
+    'workdir.none': 'рабочая директория не задана: команды идут в каталоге демона',
+    'auto.noLauncher': 'ВНИМАНИЕ: {path} не существует — юнит не запустится',
+    'auto.copyState': 'Перенести текущее состояние (токен, курсор) в {dir}? [y/N]',
+    'auto.copied': 'Состояние перенесено: {dir}',
+    'auto.copyFailed': 'Не удалось перенести состояние ({message}) — выполни `dshnc connect <ссылка>` от {user}',
+    'auto.copySkip': 'Состояние оставляю здесь; новому пользователю понадобится `dshnc connect <ссылка>`',
+    'help.autostart': 'autostart                вопросы и автозапуск через systemd',
+    'unit.description': 'клиент dsh-nodes (dshnc) — исполнитель удалённых команд',
+    'auto.title': 'Настройка автозапуска (systemd)',
+    'auto.name': 'Имя узла',
+    'auto.aliases': 'Алиасы через запятую (по любому из них узел можно позвать)',
+    'auto.scope': 'Запускать системной службой [system] или внутри твоей сессии [user]',
+    'auto.dedicated': 'Создать для него отдельного системного пользователя? [y/N]',
+    'auto.username': 'Имя пользователя',
+    'auto.createUser': 'Нет прав создавать пользователей. Выполни это и нажми Enter:',
+    'auto.waitingUser': 'жду пользователя {user}…',
+    'auto.graphical': 'Запускать только внутри графической сессии (нужен DISPLAY)? [y/N]',
+    'auto.written': 'Юнит записан: {path}',
+    'auto.next': 'Теперь от имени пользователя с правами:',
+    'auto.stateDir': 'Состояние (токен, курсор) живёт в {dir}',
+    'auto.copyConfig': 'Копирую существующее состояние в {dir}',
+    'auto.noToken': 'Токена ещё нет: после установки выполни `sudo -u {user} dshnc connect <ссылка>`',
+    'auto.done': 'Готово.',
+    'bash.arg.stdin': 'Данные в stdin команды (до 64 КиБ)',
+    'bash.api.description': 'Shell на машине узла',
+    'bash.exec.description': 'Выполнить команду в shell и вернуть stdout, stderr и код возврата',
+    'bash.arg.command': 'Командная строка',
+    'bash.arg.cwd': 'Рабочий каталог',
+    'bash.arg.timeout': 'Таймаут в секундах',
+    'help.title': 'dshnc — клиент dsh-nodes ({home})',
+    'help.connect': 'connect <url>            подключиться: ссылка с кодом связывает всё сама,',
+    'help.connect2': '                         без кода — заявка и ожидание одобрения в админке',
+    'help.daemon': 'daemon [url...]          работать: объявить bash, забирать команды, отвечать',
+    'help.daemon2': '                         без аргументов — все серверы из конфига;',
+    'help.daemon3': '                         работает на переднем плане (фон — через systemd/nohup)',
+    'help.foreground': '--foreground             оставлено для совместимости, поведение то же',
+    'help.status': 'status                   показать id клиента и сохранённые серверы',
+    'help.version': 'version                  версия клиента',
+    'help.help': 'help                     этот экран',
+    'help.env': 'Переменные: DSHNC_HOME (каталог состояния), DSHNC_SHELL (шелл, по умолчанию /bin/sh), DSHNC_LANG (en, ru, zh)',
+    'status.id': 'id клиента:  {id}',
+    'status.name': 'имя:         {name}',
+    'status.none': 'серверов нет — начни с `dshnc connect <url>`',
+    'status.server': '{url}: {token}, курсор {cursor}, epoch {epoch}{alias}',
+    'status.token.yes': 'токен есть',
+    'status.token.no': 'токена нет',
+    'status.alias': ', узел {alias}',
+    'version.line': 'dshnc {version} (протокол {proto})',
+    'cmd.unknown': 'неизвестная команда: {command}',
+    'err.needUrl': 'нужен url: dshnc connect https://host/dsh-nodes/pair?v=...',
+    'err.nothingToServe': 'нечего обслуживать: сначала `dshnc connect <url>`',
+    'err.generic': 'ошибка: {message}',
+    'err.aborted': 'прервано',
+    'connect.paired': 'подключено: узел {node} ({alias}), токен сохранён',
+    'connect.requested': 'заявка отправлена: {name} / {short}',
+    'connect.waiting': 'админ должен допустить её в админке — ждём',
+    'connect.approved': 'допущен: узел {node} ({alias}), токен сохранён',
+    'connect.rejected': 'заявку отклонили',
+    'connect.handed': 'токен уже выдан; перевыпусти в админке',
+    'connect.timeout': 'заявка не одобрена за 30 минут',
+    'connect.done': 'готово. дальше: dshnc daemon',
+    'connect.noCode': 'в ссылке нет кода — подключение не состоится',
+    'daemon.servers': 'серверы: {servers}',
+    'daemon.plugins': 'плагины: {plugins}',
+    'daemon.stopping': 'останавливаюсь',
+    'auto.nodeSummary': 'узел: {name}',
+    'auto.aliasesSuffix': ', алиасы: {aliases}',
+    'auto.userCreated': 'создан пользователь {user}',
+    'bash.clipped': '\n… обрезано: показано {shown} из {total} символов',
+    'presence.sendFailed': 'не удалось отправить кадр: {message}',
+    'presence.openFailed': 'WebSocket не открылся: {message}',
+    'presence.badFrame': 'кадр не разбирается',
+    'run.noPlugin': 'нет плагина для метода {method}',
+    'run.announced': '{base}: объявили {apis}, epoch {epoch}',
+    'run.warning': 'предупреждение: {warning}',
+    'run.reconnect': '{base}: сервер другой жизни (epoch {from} → {to}), курсор сброшен',
+    'run.restarted': '{base}: сервер перезапущен (epoch {from} → {to}), курсор сброшен',
+    'run.presenceClosed': '{base}: присутствие закрыто ({code}), работаю опросом',
+    'run.retry': '{base}: {message} — повтор через {seconds} с',
+    'run.tokenRejected': '{base}: токен не подошёл, нужна новая заявка',
+    'run.command': '{base}: {seq} {method} → {flag}',
+    'run.ok': 'ok',
+    'run.error': 'ошибка {code}',
+    'api.unauthorized': 'токен не подошёл',
+    'api.timeout': 'сервер не ответил',
+    'api.http': 'HTTP {status}',
+    'bash.needCommand': 'command обязателен и должен быть непустой строкой',
+    'bash.timeout': 'команда не уложилась в {seconds} с и была убита',
+    'bash.cancelled': 'вызов отменён',
+    'plugins.noName': '{label}: нет api.name',
+    'plugins.nameType': '{label}: api.name должен быть строкой',
+    'plugins.noMethods': '{label}: api.methods пуст',
+    'plugins.noHandle': '{label}: нет handle()',
+    'plugins.methodNoName': '{label}: метод без имени',
+    'plugins.methodNoArgs': '{label}: метод {method} без схемы args',
+    'plugins.directory': 'каталог плагинов не читается: {message}',
+    'plugins.taken': 'плагин {entry} объявляет api «{name}», который уже занят — пропущен',
+    'plugins.failed': 'плагин {entry} не загрузился: {message}',
+  },
+  zh: {
+    'files.readChunk.description': '读取二进制块：base64',
+    'files.writeChunk.description': '写入数据块',
+    'files.sha256.description': '文件哈希',
+    'files.arg.base64': 'base64 字节',
+    'files.arg.final': '最后一块',
+    'help.config': 'config [键=值…]          客户端设置：查看或修改',
+    'help.policy': 'policy [url] [键=…]      每个服务器的策略：max、base、approver、tool',
+    'help.audit': 'audit [数量]             未经沙箱执行的命令',
+    'help.workdir': 'workdir [路径]           会话工作目录：查看或设置',
+    'help.onboard': 'onboard                  配置向导：菜单，当前值作为默认值',
+    'files.api.description': '节点文件：无 shell 的读写',
+    'files.read.description': '读取文件：文本和版本',
+    'files.write.description': '原子写入文件',
+    'files.edit.description': '在文件中替换字符串',
+    'files.list.description': '列出一个目录',
+    'files.stat.description': '检查是否存在与版本',
+    'files.arg.offset': '起始字节偏移',
+    'files.arg.limit': '最大读取字节数',
+    'files.arg.version': '来自 read/stat 的版本',
+    'files.arg.dirs': '创建父目录',
+    'daemon.reload': '正在重新读取配置（SIGHUP）',
+    'presence.pongTimeout': '{seconds} 秒内没有回应 ping——正在重连',
+    'config.saved': '设置已保存：{patch}',
+    'config.usage': '用法：dshnc config 键=值 [键=值…]',
+    'session.ping.description': '检查节点是否有响应：返回 pong、运行时长和平台',
+    'run.resultFailed': 'seq {seq}：无法提交结果——{message}',
+    'audit.empty': '还没有无沙箱命令',
+    'run.auditFailed': '无法写入审计：{message}',
+    'session.chdir.description': '切换会话工作目录（目录必须存在；创建请用 session.mkdir）',
+    'session.chdir.arg.path': '已存在目录的绝对路径（在节点允许范围内）',
+    'session.mkdir.description': '在节点允许范围内创建目录',
+    'session.mkdir.arg.path': '要创建的绝对路径',
+    'session.mkdir.arg.mode': '八进制权限，例如 755',
+    'session.exists': '（已存在）',
+    'err.writeState': '无法写入客户端状态：{message}（沙箱内只能写工作目录）',
+    'policy.current': '访问：{access} | 允许目录：{roots}',
+    'policy.saved': '{url} 的规则：{patch}',
+    'session.api.description': '会话本身：切换会话的工作目录',
+    'session.chdir.description': '切换本会话的工作目录（后续命令都在其中启动）',
+    'session.chdir.arg.path': '绝对目录路径（必须在节点允许的范围内）',
+    'session.chdir.arg.create': '目录不存在时创建',
+    'session.cwd.description': '显示会话当前的工作目录',
+    'session.arg.session': '会话标识（默认是调用方会话）',
+    'session.noStore': 'session：客户端没有会话存储',
+    'session.noSession': 'session：命令元数据里没有会话标识',
+    'session.created': '（已创建）',
+    'workdir.set': '工作目录：{dir}——每个会话有独立子目录',
+    'workdir.none': '未设置工作目录：命令在守护进程目录中运行',
+    'auto.noLauncher': '注意：{path} 不存在——单元将无法启动',
+    'auto.copyState': '把当前状态（令牌、游标）搬到 {dir} 吗？[y/N]',
+    'auto.copied': '状态已复制：{dir}',
+    'auto.copyFailed': '无法复制状态（{message}）——请以 {user} 身份执行 `dshnc connect <链接>`',
+    'auto.copySkip': '状态留在原处；新用户需要执行 `dshnc connect <链接>`',
+    'help.autostart': 'autostart                几个问题，然后配置 systemd 自启',
+    'unit.description': 'dsh-nodes 客户端（dshnc）——远程命令执行器',
+    'auto.title': '配置开机自启（systemd）',
+    'auto.name': '节点名称',
+    'auto.aliases': '别名，用逗号分隔（任意一个都能叫到节点）',
+    'auto.scope': '作为系统服务运行 [system] 还是在你自己的会话里 [user]',
+    'auto.dedicated': '为它创建独立的系统用户？[y/N]',
+    'auto.username': '用户名',
+    'auto.createUser': '没有创建用户的权限。请执行下面的命令，完成后按 Enter：',
+    'auto.waitingUser': '正在等待用户 {user}…',
+    'auto.graphical': '仅在图形会话中启动（需要 DISPLAY）？[y/N]',
+    'auto.written': '单元文件已写入：{path}',
+    'auto.next': '现在用有权限的用户执行：',
+    'auto.stateDir': '状态（令牌、游标）位于 {dir}',
+    'auto.copyConfig': '正在把现有状态复制到 {dir}',
+    'auto.noToken': '还没有令牌：安装后执行 `sudo -u {user} dshnc connect <链接>`',
+    'auto.done': '完成。',
+    'bash.arg.stdin': '传给命令 stdin 的数据（最多 64 KiB）',
+    'bash.api.description': '节点机器上的 shell',
+    'bash.exec.description': '在 shell 中执行命令，返回 stdout、stderr 和退出码',
+    'bash.arg.command': '命令行',
+    'bash.arg.cwd': '工作目录',
+    'bash.arg.timeout': '超时时间（秒）',
+    'help.title': 'dshnc — 客户端 dsh-nodes ({home})',
+    'help.connect': 'connect <url>            连接：带验证码的链接会自己完成绑定，',
+    'help.connect2': '                         没有验证码时——提交申请并在管理页等待批准',
+    'help.daemon': 'daemon [url...]          运行：声明 bash，取命令，回结果',
+    'help.daemon2': '                         不带参数时——配置文件里的所有服务器；',
+    'help.daemon3': '                         前台运行（后台交给 systemd/nohup）',
+    'help.foreground': '--foreground             保留兼容，行为相同',
+    'help.status': 'status                   显示客户端 id 和已保存的服务器',
+    'help.version': 'version                  客户端版本',
+    'help.help': 'help                     这个界面',
+    'help.env': '环境变量：DSHNC_HOME（状态目录）、DSHNC_SHELL（默认 /bin/sh）、DSHNC_LANG（en、ru、zh）',
+    'status.id': '客户端 id：{id}',
+    'status.name': '名称：      {name}',
+    'status.none': '还没有服务器——先运行 `dshnc connect <url>`',
+    'status.server': '{url}：{token}，游标 {cursor}，epoch {epoch}{alias}',
+    'status.token.yes': '有令牌',
+    'status.token.no': '没有令牌',
+    'status.alias': '，节点 {alias}',
+    'version.line': 'dshnc {version}（协议 {proto}）',
+    'cmd.unknown': '未知命令：{command}',
+    'err.needUrl': '需要 url：dshnc connect https://host/dsh-nodes/pair?v=...',
+    'err.nothingToServe': '没有可服务的服务器：先运行 `dshnc connect <url>`',
+    'err.generic': '错误：{message}',
+    'err.aborted': '已中断',
+    'connect.paired': '已连接：节点 {node}（{alias}），令牌已保存',
+    'connect.requested': '申请已发送：{name} / {short}',
+    'connect.waiting': '管理员需在管理面板中批准——等待中',
+    'connect.approved': '已批准：节点 {node}（{alias}），令牌已保存',
+    'connect.rejected': '申请被拒绝',
+    'connect.handed': '令牌已发出；请在管理页重新签发',
+    'connect.timeout': '申请在 30 分钟内未获批准',
+    'connect.done': '完成。下一步：dshnc daemon',
+    'connect.noCode': '链接里没有验证码——无法连接',
+    'daemon.servers': '服务器：{servers}',
+    'daemon.plugins': '插件：{plugins}',
+    'daemon.stopping': '正在停止',
+    'auto.nodeSummary': '节点：{name}',
+    'auto.aliasesSuffix': '，别名：{aliases}',
+    'auto.userCreated': '已创建用户 {user}',
+    'bash.clipped': '\n… 已截断：显示 {total} 个字符中的 {shown} 个',
+    'presence.sendFailed': '无法发送帧：{message}',
+    'presence.openFailed': 'WebSocket 未能打开：{message}',
+    'presence.badFrame': '无法解析帧',
+    'run.noPlugin': '方法 {method} 没有插件',
+    'run.announced': '{base}：已声明 {apis}，epoch {epoch}',
+    'run.warning': '警告：{warning}',
+    'run.reconnect': '{base}：服务器已换代（epoch {from} → {to}），游标已重置',
+    'run.restarted': '{base}：服务器重启（epoch {from} → {to}），游标已重置',
+    'run.presenceClosed': '{base}：连接已关闭（{code}），改用轮询',
+    'run.retry': '{base}：{message}——{seconds} 秒后重试',
+    'run.tokenRejected': '{base}：令牌不匹配，需要重新申请',
+    'run.command': '{base}：{seq} {method} → {flag}',
+    'run.ok': 'ok',
+    'run.error': '错误 {code}',
+    'api.unauthorized': '令牌不匹配',
+    'api.timeout': '服务器没有响应',
+    'api.http': 'HTTP {status}',
+    'bash.needCommand': 'command 必填，且必须是非空字符串',
+    'bash.timeout': '命令未在 {seconds} 秒内完成，已被终止',
+    'bash.cancelled': '调用已取消',
+    'plugins.noName': '{label}: 缺少 api.name',
+    'plugins.nameType': '{label}: api.name 必须是字符串',
+    'plugins.noMethods': '{label}: api.methods 为空',
+    'plugins.noHandle': '{label}: 缺少 handle()',
+    'plugins.methodNoName': '{label}: 有方法没有名字',
+    'plugins.methodNoArgs': '{label}: 方法 {method} 没有 args 结构',
+    'plugins.directory': '无法读取插件目录：{message}',
+    'plugins.taken': '插件 {entry} 声明的 api“{name}”已被占用——跳过',
+    'plugins.failed': '插件 {entry} 加载失败：{message}',
+  },
+}
+
+/** Привести локаль к одному из поддерживаемых языков. */
+export function normalizeLang (value) {
+  if (!value) return null
+  const tag = String(value).trim().toLowerCase().replace('_', '-')
+  if (!tag) return null
+  if (tag.startsWith('zh')) return 'zh'
+  if (tag.startsWith('ru')) return 'ru'
+  if (tag.startsWith('en')) return 'en'
+  return null
+}
+
+/** Язык из окружения: DSHNC_LANG → LC_ALL → LC_MESSAGES → LANG → en. */
+export function detectLang (env = process.env) {
+  for (const key of ['DSHNC_LANG', 'LC_ALL', 'LC_MESSAGES', 'LANG']) {
+    const lang = normalizeLang(env?.[key])
+    if (lang) return lang
+  }
+  return 'en'
+}
+
+let current = 'en'
+
+/** Зафиксировать язык для процесса. */
+export function setLang (lang) {
+  current = normalizeLang(lang) ?? 'en'
+  return current
+}
+
+/** Текущий язык. */
+export function lang () {
+  return current
+}
+
+/**
+ * Перевод по ключу с подстановкой `{name}`.
+ * @param {string} key ключ словаря
+ * @param {Record<string, unknown>} [vars]
+ */
+export function t (key, vars) {
+  const table = DICT[current] ?? DICT.en
+  const template = table[key] ?? DICT.en[key] ?? key
+  if (!vars) return template
+  return template.replace(/\{(\w+)\}/g, (match, name) => (name in vars ? String(vars[name]) : match))
+}
+
+/** Для тестов: есть ли ключ во всех языках. */
+export function keys () {
+  return Object.keys(DICT.en)
+}
+
+/** Для тестов: словарь языка. */
+export function table (lang) {
+  return DICT[lang] ?? {}
+}