@grinev/opencode-telegram-bot 0.7.0 → 0.9.0

package/dist/i18n/index.js

@@ -1,18 +1,70 @@
 import { en } from "./en.js";
+import { de } from "./de.js";
+import { es } from "./es.js";
 import { ru } from "./ru.js";
-export const SUPPORTED_LOCALES = ["en", "ru"];
-const dictionaries = {
-    en,
-    ru,
-};
+import { zh } from "./zh.js";
+const LOCALE_DEFINITIONS = [
+    {
+        code: "en",
+        label: "English",
+        dateLocale: "en-US",
+        dictionary: en,
+    },
+    {
+        code: "de",
+        label: "Deutsch",
+        dateLocale: "de-DE",
+        dictionary: de,
+    },
+    {
+        code: "es",
+        label: "Español",
+        dateLocale: "es-ES",
+        dictionary: es,
+    },
+    {
+        code: "ru",
+        label: "Русский",
+        dateLocale: "ru-RU",
+        dictionary: ru,
+    },
+    {
+        code: "zh",
+        label: "简体中文",
+        dateLocale: "zh-CN",
+        dictionary: zh,
+    },
+];
+const DEFAULT_LOCALE = "en";
+export const SUPPORTED_LOCALES = LOCALE_DEFINITIONS.map((definition) => definition.code);
+const localeDefinitionByCode = Object.fromEntries(LOCALE_DEFINITIONS.map((definition) => [definition.code, definition]));
 let runtimeLocaleOverride = null;
-function normalizeLocale(locale) {
-    const normalized = locale.trim().toLowerCase();
+export function resolveSupportedLocale(locale) {
+    const normalized = locale?.trim().toLowerCase();
+    if (!normalized) {
+        return null;
+    }
+    if (Object.hasOwn(localeDefinitionByCode, normalized)) {
+        return normalized;
+    }
     const baseLocale = normalized.split("-")[0];
-    if (baseLocale === "ru") {
-        return "ru";
+    if (Object.hasOwn(localeDefinitionByCode, baseLocale)) {
+        return baseLocale;
     }
-    return "en";
+    return null;
+}
+export function normalizeLocale(locale, fallback = DEFAULT_LOCALE) {
+    return resolveSupportedLocale(locale) ?? fallback;
+}
+export function isSupportedLocale(locale) {
+    return resolveSupportedLocale(locale) !== null;
+}
+export function getLocaleOptions() {
+    return LOCALE_DEFINITIONS.map(({ code, label }) => ({ code, label }));
+}
+export function getDateLocale(locale) {
+    const activeLocale = locale ?? getLocale();
+    return localeDefinitionByCode[activeLocale].dateLocale;
 }
 function interpolate(template, params) {
     if (!params) {
@@ -31,7 +83,7 @@ export function getLocale() {
         return runtimeLocaleOverride;
     }
     const localeFromEnv = process.env.BOT_LOCALE;
-    return normalizeLocale(localeFromEnv ?? "en");
+    return normalizeLocale(localeFromEnv, DEFAULT_LOCALE);
 }
 export function setRuntimeLocale(locale) {
     runtimeLocaleOverride = locale;
@@ -41,7 +93,7 @@ export function resetRuntimeLocale() {
 }
 export function t(key, params, locale) {
     const activeLocale = locale ?? getLocale();
-    const dictionary = dictionaries[activeLocale];
+    const dictionary = localeDefinitionByCode[activeLocale].dictionary;
     const template = dictionary[key] ?? en[key];
     if (!template) {
         return key;

package/dist/i18n/ru.js

@@ -43,6 +43,11 @@ export const ru = {
     "bot.prompt_send_error": "Не удалось отправить запрос в OpenCode.",
     "bot.session_error": "🔴 OpenCode вернул ошибку: {message}",
     "bot.unknown_command": "⚠️ Неизвестная команда: {command}. Используйте /help для списка команд.",
+    "bot.photo_downloading": "⏳ Скачиваю фото...",
+    "bot.photo_too_large": "⚠️ Фото слишком большое (макс. {maxSizeMb}МБ)",
+    "bot.photo_model_no_image": "⚠️ Текущая модель не поддерживает изображения. Отправляю только текст.",
+    "bot.photo_download_error": "🔴 Не удалось скачать фото",
+    "bot.photo_no_caption": "💡 Совет: Добавьте подпись, чтобы описать, что делать с этим фото.",
     "status.header_running": "🟢 **OpenCode Server запущен**",
     "status.health.healthy": "Healthy",
     "status.health.unhealthy": "Unhealthy",
@@ -115,6 +120,7 @@ export const ru = {
     "model.change_error_callback": "Ошибка при смене модели",
     "model.menu.empty": "⚠️ Нет доступных моделей",
     "model.menu.current": "Текущая модель: {name}\n\nВыберите модель:",
+    "model.menu.favorites_hint": "ℹ️ Список моделей формируется из favorites в OpenCode CLI.",
     "model.menu.error": "🔴 Не удалось получить список моделей",
     "variant.model_not_selected_callback": "Ошибка: модель не выбрана",
     "variant.changed_callback": "Variant изменен: {name}",
@@ -192,13 +198,16 @@ export const ru = {
     "tool.file_header.write": "Write File/Path: {path}\n============================================================\n\n",
     "tool.file_header.edit": "Edit File/Path: {path}\n============================================================\n\n",
     "runtime.wizard.ask_token": "Введите токен Telegram-бота (получить у @BotFather).\n> ",
+    "runtime.wizard.ask_language": "Выберите язык интерфейса.\nВведите номер языка из списка или код локали.\nНажмите Enter, чтобы оставить язык по умолчанию: {defaultLocale}\n{options}\n> ",
+    "runtime.wizard.language_invalid": "Введите номер языка из списка или поддерживаемый код локали.\n",
+    "runtime.wizard.language_selected": "Выбран язык: {language}\n",
     "runtime.wizard.token_required": "Токен обязателен. Попробуйте еще раз.\n",
     "runtime.wizard.token_invalid": "Похоже на невалидный токен (ожидается формат <id>:<secret>). Попробуйте еще раз.\n",
     "runtime.wizard.ask_user_id": "Введите ваш Telegram User ID (можно узнать у @userinfobot).\n> ",
     "runtime.wizard.user_id_invalid": "Введите положительное целое число (> 0).\n",
     "runtime.wizard.ask_api_url": "Введите URL OpenCode API (опционально).\nНажмите Enter для значения по умолчанию: {defaultUrl}\n> ",
     "runtime.wizard.api_url_invalid": "Введите корректный URL (http/https) или нажмите Enter для значения по умолчанию.\n",
-    "runtime.wizard.start": "Запуск first-run wizard для настройки OpenCode Telegram Bot.\n",
+    "runtime.wizard.start": "Настройка OpenCode Telegram Bot.\n",
     "runtime.wizard.saved": "Конфигурация сохранена:\n- {envPath}\n- {settingsPath}\n",
     "runtime.wizard.not_configured_starting": "Приложение еще не сконфигурировано. Запускаю wizard...\n",
     "runtime.wizard.tty_required": "Интерактивный wizard требует TTY-терминал. Запустите `opencode-telegram config` в интерактивной оболочке.",

package/dist/i18n/zh.js

@@ -0,0 +1,247 @@
+export const zh = {
+    "cmd.description.status": "服务器和会话状态",
+    "cmd.description.new": "创建新会话",
+    "cmd.description.stop": "停止当前操作",
+    "cmd.description.sessions": "列出会话",
+    "cmd.description.projects": "列出项目",
+    "cmd.description.model": "选择模型",
+    "cmd.description.agent": "选择模式",
+    "cmd.description.opencode_start": "启动 OpenCode 服务器",
+    "cmd.description.opencode_stop": "停止 OpenCode 服务器",
+    "cmd.description.help": "帮助",
+    "callback.unknown_command": "未知命令",
+    "callback.processing_error": "处理错误",
+    "error.load_agents": "❌ 加载代理列表失败",
+    "error.load_models": "❌ 加载模型列表失败",
+    "error.load_variants": "❌ 加载变体列表失败",
+    "error.context_button": "❌ 处理上下文按钮失败",
+    "error.generic": "🔴 出现了一些问题。",
+    "interaction.blocked.expired": "⚠️ 此交互已过期。请重新开始。",
+    "interaction.blocked.expected_callback": "⚠️ 此步骤请使用内联按钮，或点击取消。",
+    "interaction.blocked.expected_text": "⚠️ 此步骤请发送一条文本消息。",
+    "interaction.blocked.expected_command": "⚠️ 此步骤请发送一条命令。",
+    "interaction.blocked.command_not_allowed": "⚠️ 当前步骤不可用此命令。",
+    "interaction.blocked.finish_current": "⚠️ 请先完成当前交互（回答或取消），然后再打开其他菜单。",
+    "inline.blocked.expected_choice": "⚠️ 请使用内联按钮选择一个选项，或点击取消。",
+    "inline.blocked.command_not_allowed": "⚠️ 内联菜单激活期间不可用此命令。",
+    "question.blocked.expected_answer": "⚠️ 请使用按钮、自定义回答或取消来回答当前问题。",
+    "question.blocked.command_not_allowed": "⚠️ 在当前问答流程完成之前不可用此命令。",
+    "inline.button.cancel": "❌ 取消",
+    "inline.inactive_callback": "此菜单已失效",
+    "inline.cancelled_callback": "已取消",
+    "common.unknown": "未知",
+    "common.unknown_error": "未知错误",
+    "start.welcome": "👋 欢迎使用 OpenCode Telegram Bot！\n\n可用命令：\n/projects — 选择项目\n/sessions — 会话列表\n/new — 新建会话\n/agent — 切换模式\n/model — 选择模型\n/status — 状态\n/help — 帮助",
+    "help.text": "📖 **帮助**\n\n/status - 查看服务器状态\n/sessions - 会话列表\n/new - 创建新会话\n/help - 帮助",
+    "bot.thinking": "💭 思考中...",
+    "bot.project_not_selected": "🏗 未选择项目。\n\n请先使用 /projects 选择一个项目。",
+    "bot.creating_session": "🔄 正在创建新会话...",
+    "bot.create_session_error": "🔴 创建会话失败。请重试 /new，或使用 /status 检查服务器状态。",
+    "bot.session_created": "✅ 会话已创建：{title}",
+    "bot.session_busy": "⏳ 代理正在执行任务。请等待完成，或使用 /stop 中断当前运行。",
+    "bot.session_reset_project_mismatch": "⚠️ 活动会话与所选项目不匹配，因此已重置。使用 /sessions 选择一个会话，或 /new 创建新会话。",
+    "bot.prompt_send_error": "向 OpenCode 发送请求失败。",
+    "bot.session_error": "🔴 OpenCode 返回错误：{message}",
+    "bot.unknown_command": "⚠️ 未知命令：{command}。使用 /help 查看可用命令。",
+    "bot.photo_downloading": "⏳ 正在下载照片...",
+    "bot.photo_too_large": "⚠️ 照片过大（最大 {maxSizeMb}MB）",
+    "bot.photo_model_no_image": "⚠️ 当前模型不支持图像输入。将仅发送文本。",
+    "bot.photo_download_error": "🔴 下载照片失败",
+    "bot.photo_no_caption": "💡 提示：添加说明文字以描述你希望对这张照片做什么。",
+    "status.header_running": "🟢 **OpenCode 服务器正在运行**",
+    "status.health.healthy": "健康",
+    "status.health.unhealthy": "不健康",
+    "status.line.health": "状态：{health}",
+    "status.line.version": "版本：{version}",
+    "status.line.managed_yes": "由机器人管理：是",
+    "status.line.managed_no": "由机器人管理：否",
+    "status.line.pid": "PID：{pid}",
+    "status.line.uptime_sec": "运行时间：{seconds} 秒",
+    "status.line.mode": "模式：{mode}",
+    "status.line.model": "模型：{model}",
+    "status.agent_not_set": "未设置",
+    "status.project_selected": "🏗 项目：{project}",
+    "status.project_not_selected": "🏗 项目：未选择",
+    "status.project_hint": "使用 /projects 选择项目",
+    "status.session_selected": "📋 当前会话：{title}",
+    "status.session_not_selected": "📋 当前会话：未选择",
+    "status.session_hint": "使用 /sessions 选择一个会话，或 /new 创建",
+    "status.server_unavailable": "🔴 OpenCode 服务器不可用\n\n使用 /opencode_start 启动服务器。",
+    "projects.empty": "📭 未找到项目。\n\n在 OpenCode 中打开一个目录并至少创建一个会话，然后它会出现在这里。",
+    "projects.select": "请选择一个项目：",
+    "projects.select_with_current": "请选择一个项目：\n\n当前：🏗 {project}",
+    "projects.fetch_error": "🔴 OpenCode 服务器不可用，或加载项目时发生错误。",
+    "projects.selected": "✅ 已选择项目：{project}\n\n📋 会话已重置。请在此项目中使用 /sessions 或 /new。",
+    "projects.select_error": "🔴 选择项目失败。",
+    "sessions.project_not_selected": "🏗 未选择项目。\n\n请先使用 /projects 选择一个项目。",
+    "sessions.empty": "📭 未找到会话。\n\n使用 /new 创建新会话。",
+    "sessions.select": "请选择一个会话：",
+    "sessions.fetch_error": "🔴 OpenCode 服务器不可用，或加载会话时发生错误。",
+    "sessions.select_project_first": "🔴 未选择项目。使用 /projects。",
+    "sessions.loading_context": "⏳ 正在加载上下文和最新消息...",
+    "sessions.selected": "✅ 已选择会话：{title}",
+    "sessions.select_error": "🔴 选择会话失败。",
+    "sessions.preview.empty": "没有最近消息。",
+    "sessions.preview.title": "最近消息：",
+    "sessions.preview.you": "你：",
+    "sessions.preview.agent": "代理：",
+    "new.project_not_selected": "🏗 未选择项目。\n\n请先使用 /projects 选择一个项目。",
+    "new.created": "✅ 新会话已创建：{title}",
+    "new.create_error": "🔴 OpenCode 服务器不可用，或创建会话时发生错误。",
+    "stop.no_active_session": "🛑 代理尚未启动\n\n使用 /new 创建会话，或通过 /sessions 选择一个。",
+    "stop.in_progress": "🛑 已停止事件流，正在发送中止信号...\n\n等待代理停止。",
+    "stop.warn_unconfirmed": "⚠️ 事件流已停止，但服务器未确认中止。\n\n检查 /status，并在几秒后重试 /stop。",
+    "stop.warn_maybe_finished": "⚠️ 事件流已停止，但代理可能已完成。",
+    "stop.success": "✅ 代理操作已中断。本次运行的后续消息将不再发送。",
+    "stop.warn_still_busy": "⚠️ 信号已发送，但代理仍在忙。\n\n事件流已禁用，因此不会发送中间消息。",
+    "stop.warn_timeout": "⚠️ 中止请求超时。\n\n事件流已禁用，请在几秒后重试 /stop。",
+    "stop.warn_local_only": "⚠️ 已在本地停止事件流，但服务器端中止失败。",
+    "stop.error": "🔴 停止操作失败。\n\n事件流已停止，请再次尝试 /stop。",
+    "opencode_start.already_running_managed": "⚠️ OpenCode 服务器已在运行\n\nPID：{pid}\n运行时间：{seconds} 秒",
+    "opencode_start.already_running_external": "✅ OpenCode 服务器正作为外部进程运行\n\n版本：{version}\n\n该服务器不是由机器人启动，因此 /opencode-stop 无法停止它。",
+    "opencode_start.starting": "🔄 正在启动 OpenCode 服务器...",
+    "opencode_start.start_error": "🔴 启动 OpenCode 服务器失败\n\n错误：{error}\n\n请检查 OpenCode CLI 已安装且在 PATH 中可用：\n`opencode --version`\n`npm install -g @opencode-ai/cli`",
+    "opencode_start.started_not_ready": "⚠️ OpenCode 服务器已启动，但未响应\n\nPID：{pid}\n\n服务器可能仍在启动中。几秒后试试 /status。",
+    "opencode_start.success": "✅ OpenCode 服务器启动成功\n\nPID：{pid}\n版本：{version}",
+    "opencode_start.error": "🔴 启动服务器时发生错误。\n\n请查看应用日志了解详情。",
+    "opencode_stop.external_running": "⚠️ OpenCode 服务器正作为外部进程运行\n\n该服务器不是通过 /opencode-start 启动的。\n请手动停止它，或使用 /status 检查状态。",
+    "opencode_stop.not_running": "⚠️ OpenCode 服务器未运行",
+    "opencode_stop.stopping": "🛑 正在停止 OpenCode 服务器...\n\nPID：{pid}",
+    "opencode_stop.stop_error": "🔴 停止 OpenCode 服务器失败\n\n错误：{error}",
+    "opencode_stop.success": "✅ OpenCode 服务器已成功停止",
+    "opencode_stop.error": "🔴 停止服务器时发生错误。\n\n请查看应用日志了解详情。",
+    "agent.changed_callback": "模式已更改：{name}",
+    "agent.changed_message": "✅ 模式已切换为：{name}",
+    "agent.change_error_callback": "切换模式失败",
+    "agent.menu.current": "当前模式：{name}\n\n请选择模式：",
+    "agent.menu.select": "请选择工作模式：",
+    "model.changed_callback": "模型已更改：{name}",
+    "model.changed_message": "✅ 模型已切换为：{name}",
+    "model.change_error_callback": "切换模型失败",
+    "model.menu.empty": "⚠️ 没有可用模型",
+    "model.menu.current": "当前模型：{name}\n\n请选择模型：",
+    "model.menu.favorites_hint": "ℹ️ 模型列表来自 OpenCode CLI 的收藏（favorites）。",
+    "model.menu.error": "🔴 获取模型列表失败",
+    "variant.model_not_selected_callback": "错误：未选择模型",
+    "variant.changed_callback": "变体已更改：{name}",
+    "variant.changed_message": "✅ 变体已切换为：{name}",
+    "variant.change_error_callback": "切换变体失败",
+    "variant.select_model_first": "⚠️ 请先选择一个模型",
+    "variant.menu.empty": "⚠️ 没有可用变体",
+    "variant.menu.current": "当前变体：{name}\n\n请选择变体：",
+    "variant.menu.error": "🔴 获取变体列表失败",
+    "context.button.confirm": "✅ 是的，压缩上下文",
+    "context.no_active_session": "⚠️ 没有活动会话。使用 /new 创建会话",
+    "context.confirm_text": '📊 会话 "{title}" 的上下文压缩\n\n这会通过移除历史中的旧消息来减少上下文占用。当前任务不会被中断。\n\n继续？',
+    "context.callback_session_not_found": "未找到会话",
+    "context.callback_compacting": "正在压缩上下文...",
+    "context.progress": "⏳ 正在压缩上下文...",
+    "context.error": "❌ 上下文压缩失败",
+    "context.success": "✅ 上下文压缩成功",
+    "permission.inactive_callback": "权限请求已失效",
+    "permission.processing_error_callback": "处理错误",
+    "permission.no_active_request_callback": "错误：没有活动请求",
+    "permission.reply.once": "仅允许一次",
+    "permission.reply.always": "始终允许",
+    "permission.reply.reject": "已拒绝",
+    "permission.send_reply_error": "❌ 发送权限回复失败",
+    "permission.blocked.expected_reply": "⚠️ 请先使用上方按钮回答权限请求。",
+    "permission.blocked.command_not_allowed": "⚠️ 在你回答权限请求之前不可用此命令。",
+    "permission.header": "{emoji} **权限请求：{name}**\n\n",
+    "permission.button.allow": "✅ 允许一次",
+    "permission.button.always": "🔓 始终允许",
+    "permission.button.reject": "❌ 拒绝",
+    "permission.name.bash": "Bash",
+    "permission.name.edit": "编辑",
+    "permission.name.write": "写入",
+    "permission.name.read": "读取",
+    "permission.name.webfetch": "Web 获取",
+    "permission.name.websearch": "Web 搜索",
+    "permission.name.glob": "文件搜索",
+    "permission.name.grep": "内容搜索",
+    "permission.name.list": "列出目录",
+    "permission.name.task": "任务",
+    "permission.name.lsp": "LSP",
+    "question.inactive_callback": "投票已失效",
+    "question.processing_error_callback": "处理错误",
+    "question.select_one_required_callback": "请至少选择一个选项",
+    "question.enter_custom_callback": "请发送你的自定义回答",
+    "question.cancelled": "❌ 投票已取消",
+    "question.answer_already_received": "已收到答案，请稍候...",
+    "question.completed_no_answers": "✅ 投票完成（无答案）",
+    "question.no_active_project": "❌ 没有活动项目",
+    "question.no_active_request": "❌ 没有活动请求",
+    "question.send_answers_error": "❌ 向代理发送答案失败",
+    "question.multi_hint": "\n*你可以选择多个选项*",
+    "question.button.submit": "✅ 完成",
+    "question.button.custom": "🔤 自定义回答",
+    "question.button.cancel": "❌ 取消",
+    "question.use_custom_button_first": '⚠️ 要发送文本，请先点击当前问题的 "自定义回答" 按钮。',
+    "question.summary.title": "✅ 投票已完成！\n\n",
+    "question.summary.question": "问题 {index}：\n{question}\n\n",
+    "question.summary.answer": "回答：\n{answer}\n\n",
+    "keyboard.agent_mode": "{emoji} {name} 模式",
+    "keyboard.context": "📊 {used} / {limit} ({percent}%)",
+    "keyboard.context_empty": "📊 0",
+    "keyboard.variant": "💭 {name}",
+    "keyboard.variant_default": "💡 默认",
+    "keyboard.updated": "⌨️ 键盘已更新",
+    "pinned.default_session_title": "新会话",
+    "pinned.unknown": "未知",
+    "pinned.line.project": "项目: {project}",
+    "pinned.line.model": "模型: {model}",
+    "pinned.line.context": "上下文: {used} / {limit} ({percent}%)",
+    "pinned.files.title": "文件（{count}）：",
+    "pinned.files.item": "  {path}{diff}",
+    "pinned.files.more": "  ... 还有 {count} 个",
+    "tool.todo.overflow": "*(还有 {count} 个任务)*",
+    "tool.file_header.write": "写入文件/路径: {path}\n============================================================\n\n",
+    "tool.file_header.edit": "编辑文件/路径: {path}\n============================================================\n\n",
+    "runtime.wizard.ask_token": "请输入 Telegram 机器人 token（从 @BotFather 获取）。\n> ",
+    "runtime.wizard.ask_language": "请选择界面语言。\n输入列表中的语言编号或 locale code。\n按 Enter 保持默认语言：{defaultLocale}\n{options}\n> ",
+    "runtime.wizard.language_invalid": "请输入列表中的语言编号或受支持的 locale code。\n",
+    "runtime.wizard.language_selected": "已选择语言：{language}\n",
+    "runtime.wizard.token_required": "必须提供 token。请重试。\n",
+    "runtime.wizard.token_invalid": "token 看起来无效（期望格式 <id>:<secret>）。请重试。\n",
+    "runtime.wizard.ask_user_id": "请输入你的 Telegram User ID（可从 @userinfobot 获取）。\n> ",
+    "runtime.wizard.user_id_invalid": "请输入一个正整数（> 0）。\n",
+    "runtime.wizard.ask_api_url": "请输入 OpenCode API URL（可选）。\n按 Enter 使用默认值：{defaultUrl}\n> ",
+    "runtime.wizard.api_url_invalid": "请输入有效 URL（http/https），或按 Enter 使用默认值。\n",
+    "runtime.wizard.start": "OpenCode Telegram Bot 设置。\n",
+    "runtime.wizard.saved": "配置已保存：\n- {envPath}\n- {settingsPath}\n",
+    "runtime.wizard.not_configured_starting": "应用尚未配置。正在启动向导...\n",
+    "runtime.wizard.tty_required": "交互式向导需要 TTY 终端。请在交互式 shell 中运行 `opencode-telegram config`。",
+    "rename.no_session": "⚠️ 没有活动会话。请先创建或选择一个会话。",
+    "rename.prompt": "📝 请输入会话的新标题：\n\n当前：{title}",
+    "rename.empty_title": "⚠️ 标题不能为空。",
+    "rename.success": "✅ 会话已重命名为：{title}",
+    "rename.error": "🔴 重命名会话失败。",
+    "rename.cancelled": "❌ 重命名已取消。",
+    "rename.inactive_callback": "重命名请求已失效",
+    "rename.inactive": "⚠️ 重命名请求未激活。请再次运行 /rename。",
+    "rename.blocked.expected_name": "⚠️ 请以文本输入新会话名称，或在重命名消息中点击取消。",
+    "rename.blocked.command_not_allowed": "⚠️ 重命名等待新名称期间不可用此命令。",
+    "rename.button.cancel": "❌ 取消",
+    "cmd.description.rename": "重命名当前会话",
+    "cli.usage": "用法：\n  opencode-telegram [start] [--mode sources|installed]\n  opencode-telegram status\n  opencode-telegram stop\n  opencode-telegram config\n\n说明：\n  - 不带命令时默认执行 `start`\n  - `--mode` 目前仅支持 `start` 命令",
+    "cli.placeholder.status": "命令 `status` 目前是占位符。真实状态检查将会在 service 层（阶段 5）添加。",
+    "cli.placeholder.stop": "命令 `stop` 目前是占位符。真实的后台进程停止将会在 service 层（阶段 5）添加。",
+    "cli.placeholder.unavailable": "命令不可用。",
+    "cli.error.prefix": "CLI 错误：{message}",
+    "cli.args.unknown_command": "未知命令：{value}",
+    "cli.args.mode_requires_value": "选项 --mode 需要一个值：sources|installed",
+    "cli.args.invalid_mode": "无效的 --mode 值：{value}。期望 sources|installed",
+    "cli.args.unknown_option": "未知选项：{value}",
+    "cli.args.mode_only_start": "选项 --mode 仅支持 start 命令",
+    "legacy.models.fetch_error": "🔴 获取模型列表失败。请使用 /status 检查服务器状态。",
+    "legacy.models.empty": "📋 没有可用模型。请在 OpenCode 中配置 providers。",
+    "legacy.models.header": "📋 **可用模型：**\n\n",
+    "legacy.models.no_provider_models": "  ⚠️ 没有可用模型\n",
+    "legacy.models.env_hint": "💡 在 .env 中使用该模型：\n",
+    "legacy.models.error": "🔴 加载模型列表时发生错误。",
+    "stt.recognizing": "🎤 正在识别音频...",
+    "stt.recognized": "🎤 识别结果：\n{text}",
+    "stt.not_configured": "🎤 语音识别尚未配置。\n\n在 .env 中设置 STT_API_URL 和 STT_API_KEY 以启用。",
+    "stt.error": "🔴 识别音频失败：{error}",
+    "stt.empty_result": "🎤 音频消息中未检测到语音。",
+};

package/dist/interaction/guard.js

@@ -23,6 +23,10 @@ function classifyIncomingInput(ctx) {
         }
         return { inputType: "text" };
     }
+    // Photo, voice, audio, and other non-text messages are classified as "other"
+    if (ctx.message?.photo) {
+        return { inputType: "other" };
+    }
     return { inputType: "other" };
 }
 function getExpectedInputBlockReason(expectedInput) {

package/dist/model/capabilities.js

@@ -0,0 +1,62 @@
+import { opencodeClient } from "../opencode/client.js";
+import { logger } from "../utils/logger.js";
+const capabilitiesCache = {};
+/**
+ * Get model capabilities from OpenCode API
+ * Results are cached in memory per model
+ */
+export async function getModelCapabilities(providerID, modelID) {
+    const cacheKey = `${providerID}/${modelID}`;
+    if (capabilitiesCache[cacheKey] !== undefined) {
+        logger.debug(`[ModelCapabilities] Cache hit for ${cacheKey}`);
+        return capabilitiesCache[cacheKey];
+    }
+    try {
+        logger.debug(`[ModelCapabilities] Fetching capabilities for ${cacheKey}`);
+        const response = await opencodeClient.config.providers();
+        if (response.error || !response.data) {
+            logger.error("[ModelCapabilities] API returned error:", response.error);
+            capabilitiesCache[cacheKey] = null;
+            return null;
+        }
+        const providers = response.data.providers;
+        const provider = providers.find((p) => p.id === providerID);
+        if (!provider) {
+            logger.warn(`[ModelCapabilities] Provider ${providerID} not found`);
+            capabilitiesCache[cacheKey] = null;
+            return null;
+        }
+        const model = provider.models[modelID];
+        if (!model) {
+            logger.warn(`[ModelCapabilities] Model ${cacheKey} not found in provider`);
+            capabilitiesCache[cacheKey] = null;
+            return null;
+        }
+        logger.debug(`[ModelCapabilities] Found capabilities for ${cacheKey}`);
+        capabilitiesCache[cacheKey] = model.capabilities;
+        return model.capabilities;
+    }
+    catch (error) {
+        logger.error("[ModelCapabilities] Failed to fetch providers:", error);
+        capabilitiesCache[cacheKey] = null;
+        return null;
+    }
+}
+/**
+ * Check if model supports a specific input type
+ */
+export function supportsInput(capabilities, inputType) {
+    if (!capabilities) {
+        return false;
+    }
+    return capabilities.input[inputType] === true;
+}
+/**
+ * Check if model supports attachments in general
+ */
+export function supportsAttachment(capabilities) {
+    if (!capabilities) {
+        return false;
+    }
+    return capabilities.attachment === true;
+}

package/dist/runtime/bootstrap.js

@@ -5,7 +5,7 @@ import { createInterface } from "node:readline/promises";
 import { fileURLToPath } from "node:url";
 import dotenv from "dotenv";
 import { getRuntimePaths } from "./paths.js";
-import { t } from "../i18n/index.js";
+import { getLocale, getLocaleOptions, resolveSupportedLocale, setRuntimeLocale, t, } from "../i18n/index.js";
 const DEFAULT_API_URL = "http://localhost:4096";
 const FALLBACK_MODEL_PROVIDER = "opencode";
 const FALLBACK_MODEL_ID = "big-pickle";
@@ -60,6 +60,7 @@ function finalizeEnvContent(lines) {
 export function buildEnvFileContent(existingContent, values) {
     let lines = normalizeEnvLineEndings(existingContent);
     const orderedUpdates = [
+        ["BOT_LOCALE", values.BOT_LOCALE],
         ["TELEGRAM_BOT_TOKEN", values.TELEGRAM_BOT_TOKEN],
         ["TELEGRAM_ALLOWED_USER_ID", values.TELEGRAM_ALLOWED_USER_ID],
         ["OPENCODE_API_URL", values.OPENCODE_API_URL],
@@ -188,6 +189,35 @@ async function askToken() {
         return token;
     }
 }
+async function askLocale() {
+    const localeOptions = getLocaleOptions();
+    const defaultLocale = getLocale();
+    const defaultLocaleOption = localeOptions.find((localeOption) => localeOption.code === defaultLocale) ?? localeOptions[0];
+    const optionsText = localeOptions
+        .map((localeOption, index) => `${index + 1} - ${localeOption.label} (${localeOption.code})`)
+        .join("\n");
+    const prompt = t("runtime.wizard.ask_language", {
+        options: optionsText,
+        defaultLocale: `${defaultLocaleOption.label} (${defaultLocaleOption.code})`,
+    });
+    for (;;) {
+        const answer = await askVisible(prompt);
+        if (!answer) {
+            return defaultLocaleOption.code;
+        }
+        if (/^\d+$/.test(answer)) {
+            const index = Number.parseInt(answer, 10) - 1;
+            if (index >= 0 && index < localeOptions.length) {
+                return localeOptions[index].code;
+            }
+        }
+        const localeByCode = resolveSupportedLocale(answer);
+        if (localeByCode) {
+            return localeByCode;
+        }
+        process.stdout.write(t("runtime.wizard.language_invalid"));
+    }
+}
 async function askAllowedUserId() {
     for (;;) {
         const allowedUserId = await askVisible(t("runtime.wizard.ask_user_id"));
@@ -213,6 +243,16 @@ async function askApiUrl() {
     }
 }
 async function collectWizardValues() {
+    const locale = await askLocale();
+    setRuntimeLocale(locale);
+    const selectedLocaleOption = getLocaleOptions().find((localeOption) => localeOption.code === locale) ?? null;
+    process.stdout.write("\n");
+    process.stdout.write(t("runtime.wizard.language_selected", {
+        language: selectedLocaleOption !== null
+            ? `${selectedLocaleOption.label} (${selectedLocaleOption.code})`
+            : locale,
+    }));
+    process.stdout.write("\n");
     process.stdout.write(t("runtime.wizard.start"));
     process.stdout.write("\n");
     const token = await askToken();
@@ -220,6 +260,7 @@ async function collectWizardValues() {
     const apiUrl = await askApiUrl();
     process.stdout.write("\n");
     return {
+        locale,
         token,
         allowedUserId,
         apiUrl,
@@ -249,6 +290,7 @@ async function runWizardAndPersist(runtimePaths) {
     const provider = existingParsed.OPENCODE_MODEL_PROVIDER || modelDefaults.provider;
     const modelId = existingParsed.OPENCODE_MODEL_ID || modelDefaults.modelId;
     const envValues = {
+        BOT_LOCALE: wizardValues.locale,
         TELEGRAM_BOT_TOKEN: wizardValues.token,
         TELEGRAM_ALLOWED_USER_ID: wizardValues.allowedUserId,
         OPENCODE_API_URL: wizardValues.apiUrl,

package/dist/session/cache-manager.js

@@ -12,6 +12,12 @@ const SYNC_SAFETY_WINDOW_MS = 60_000;
 const SYNC_COOLDOWN_MS = 60_000;
 const STORAGE_FALLBACK_SCAN_LIMIT = 200;
 const SQLITE_FALLBACK_QUERY_LIMIT = 200;
+const SERVER_UNAVAILABLE_ERROR_MARKERS = [
+    "fetch failed",
+    "econnrefused",
+    "connection refused",
+    "connect refused",
+];
 const EMPTY_CACHE = {
     version: CACHE_VERSION,
     lastSyncedUpdatedAt: 0,
@@ -144,6 +150,50 @@ function createVirtualProjectId(worktree) {
     const hash = createHash("sha1").update(worktree).digest("hex").slice(0, 16);
     return `dir_${hash}`;
 }
+function hasServerUnavailableMarker(value) {
+    const lower = value.toLowerCase();
+    return SERVER_UNAVAILABLE_ERROR_MARKERS.some((marker) => lower.includes(marker));
+}
+function isServerUnavailableError(error) {
+    const queue = [error];
+    const seen = new Set();
+    while (queue.length > 0) {
+        const current = queue.pop();
+        if (!current || seen.has(current)) {
+            continue;
+        }
+        seen.add(current);
+        if (typeof current === "string") {
+            if (hasServerUnavailableMarker(current)) {
+                return true;
+            }
+            continue;
+        }
+        if (current instanceof Error) {
+            if (hasServerUnavailableMarker(`${current.name}: ${current.message}`)) {
+                return true;
+            }
+            const errorWithCause = current;
+            if (errorWithCause.cause) {
+                queue.push(errorWithCause.cause);
+            }
+            continue;
+        }
+        if (typeof current === "object") {
+            const value = current;
+            if (typeof value.code === "string" && hasServerUnavailableMarker(value.code)) {
+                return true;
+            }
+            if (typeof value.message === "string" && hasServerUnavailableMarker(value.message)) {
+                return true;
+            }
+            if (value.cause) {
+                queue.push(value.cause);
+            }
+        }
+    }
+    return false;
+}
 async function runSync() {
     await ensureCacheLoaded();
     const params = buildListParams();
@@ -352,7 +402,12 @@ export async function syncSessionDirectoryCache(options) {
         lastSyncAttemptAt = Date.now();
     })
         .catch((error) => {
-        logger.warn("[SessionCache] Failed to sync sessions cache", error);
+        if (isServerUnavailableError(error)) {
+            logger.warn("[SessionCache] OpenCode server is not running. Start it with: opencode serve");
+        }
+        else {
+            logger.warn("[SessionCache] Failed to sync sessions cache", error);
+        }
         lastSyncAttemptAt = 0;
     })
         .finally(() => {