fix: restore local bot api startup

Docs/Architecture_Overview.md

@@ -74,8 +74,9 @@ TelegramSearchBot 是一个功能丰富的 Telegram 机器人，提供消息搜
 
 ### 本地 Bot API 服务
 - **内置 Telegram Bot API**: 可选启用内置 Bot API 服务
+- **外部 Local API**: 也可连接到已在本机其他位置运行的 Local Bot API
 - **优势**: 支持最大 2GB 文件发送（vs 云端 50MB）
-- **配置**: 需要 `TelegramBotApiId` 和 `TelegramBotApiHash`（从 my.telegram.org 获取）
+- **配置**: 内置模式需要 `TelegramBotApiId` 和 `TelegramBotApiHash`（从 my.telegram.org 获取）；外部模式使用 `ExternalLocalBotApiBaseUrl`
 
 ## 平台兼容性
 
@@ -269,4 +270,4 @@ TelegramSearchBot/
 ---
 
 *最后更新: 2026-03-26*
-*文档版本: 1.1*
+*文档版本: 1.1*

Docs/README_MCP.md

@@ -51,7 +51,7 @@ TelegramSearchBot 内置了以下工具，通过 `BuiltInToolAttribute` 标记
 | `send_document_file` | 发送文件（使用文件路径） | `file_path`, `caption?`, `reply_to_message_id?` |
 
 **文件大小限制**:
-- 本地Bot API (`EnableLocalBotAPI=true`): 最大 2GB
+- 本地 Bot API（内置或外部）: 最大 2GB
 - 云端API: 最大 50MB
 
 ### 2.3 搜索工具

README.md

@@ -45,6 +45,7 @@
   "EnableAutoASR": false,
   "IsLocalAPI": false,
   "EnableLocalBotAPI": false,
+  "ExternalLocalBotApiBaseUrl": "",
   "TelegramBotApiId": "",
   "TelegramBotApiHash": "",
   "LocalBotApiPort": 8081,
@@ -80,11 +81,13 @@
   - `AdminId`: 管理员Telegram用户ID(必须为数字)
 
 - **本地Bot API服务**:
-  - `EnableLocalBotAPI`: 是否启用内置Telegram Bot API服务(默认false)
+  - `EnableLocalBotAPI`: 是否启用内置 Telegram Bot API 服务(默认false)
+  - `ExternalLocalBotApiBaseUrl`: 外部本地 Bot API 地址；配置后会自动按本地 API 模式运行，无需再手动设置 `BaseUrl`/`IsLocalAPI`
   - `TelegramBotApiId`: Telegram Bot API的API ID（从my.telegram.org获取）
   - `TelegramBotApiHash`: Telegram Bot API的API Hash（从my.telegram.org获取）
   - `LocalBotApiPort`: 本地Bot API服务端口(默认8081)
-  - **优势**: 启用后可发送最大2GB文件（vs 云端50MB限制）
+  - **说明**: `EnableLocalBotAPI=true` 时会启动内置 `telegram-bot-api.exe`；若使用外部 local API，请保持 `EnableLocalBotAPI=false` 并填写 `ExternalLocalBotApiBaseUrl`
+  - **优势**: 使用本地 Bot API（内置或外部）后可发送最大2GB文件（vs 云端50MB限制）
 
 - **AI相关**:
   - `OllamaModelName`: 本地模型名称(默认"qwen2.5:72b-instruct-q2_K")

TelegramSearchBot.Common/Env.cs

@@ -11,52 +11,85 @@ static Env() {
             if (!Directory.Exists(WorkDir)) {
                 Directory.CreateDirectory(WorkDir);
             }
+            var config = new Config();
             try {
-                var config = JsonConvert.DeserializeObject<Config>(File.ReadAllText(Path.Combine(WorkDir, "Config.json")));
-                if (config is null) return;
-                EnableLocalBotAPI = config.EnableLocalBotAPI;
-                TelegramBotApiId = config.TelegramBotApiId;
-                TelegramBotApiHash = config.TelegramBotApiHash;
-                LocalBotApiPort = config.LocalBotApiPort;
-                if (config.EnableLocalBotAPI) {
-                    BaseUrl = $"http://127.0.0.1:{config.LocalBotApiPort}";
-                    IsLocalAPI = true;
-                } else {
-                    BaseUrl = config.BaseUrl;
-                    IsLocalAPI = config.IsLocalAPI;
+                var loadedConfig = JsonConvert.DeserializeObject<Config>(File.ReadAllText(Path.Combine(WorkDir, "Config.json")));
+                if (loadedConfig is not null) {
+                    config = loadedConfig;
                 }
-                BotToken = config.BotToken;
-                AdminId = config.AdminId;
-                EnableAutoOCR = config.EnableAutoOCR;
-                EnableAutoASR = config.EnableAutoASR;
-                //WorkDir = config.WorkDir;
-                TaskDelayTimeout = config.TaskDelayTimeout;
-                SameServer = config.SameServer;
-                OllamaModelName = config.OllamaModelName;
-                EnableVideoASR = config.EnableVideoASR;
-                EnableOpenAI = config.EnableOpenAI;
-                OpenAIModelName = config.OpenAIModelName;
-                OLTPAuth = config.OLTPAuth;
-                OLTPAuthUrl = config.OLTPAuthUrl;
-                OLTPName = config.OLTPName;
-                BraveApiKey = config.BraveApiKey;
-                EnableAccounting = config.EnableAccounting;
-                MaxToolCycles = config.MaxToolCycles;
-                EnableLLMAgentProcess = config.EnableLLMAgentProcess;
-                AgentHeartbeatIntervalSeconds = config.AgentHeartbeatIntervalSeconds;
-                AgentHeartbeatTimeoutSeconds = config.AgentHeartbeatTimeoutSeconds;
-                AgentChunkPollingIntervalMilliseconds = config.AgentChunkPollingIntervalMilliseconds;
-                AgentIdleTimeoutMinutes = config.AgentIdleTimeoutMinutes;
-                MaxConcurrentAgents = config.MaxConcurrentAgents;
-                AgentTaskTimeoutSeconds = config.AgentTaskTimeoutSeconds;
-                AgentShutdownGracePeriodSeconds = config.AgentShutdownGracePeriodSeconds;
-                AgentMaxRecoveryAttempts = config.AgentMaxRecoveryAttempts;
-                AgentQueueBacklogWarningThreshold = config.AgentQueueBacklogWarningThreshold;
-                AgentProcessMemoryLimitMb = config.AgentProcessMemoryLimitMb;
             } catch {
             }
 
+            var botApiEndpoint = ResolveBotApiEndpoint(config);
+            EnableLocalBotAPI = config.EnableLocalBotAPI;
+            TelegramBotApiId = config.TelegramBotApiId;
+            TelegramBotApiHash = config.TelegramBotApiHash;
+            LocalBotApiPort = config.LocalBotApiPort;
+            ExternalLocalBotApiBaseUrl = botApiEndpoint.ExternalLocalBotApiBaseUrl;
+            BaseUrl = botApiEndpoint.BaseUrl;
+            IsLocalAPI = botApiEndpoint.IsLocalApi;
+            BotToken = config.BotToken;
+            AdminId = config.AdminId;
+            EnableAutoOCR = config.EnableAutoOCR;
+            EnableAutoASR = config.EnableAutoASR;
+            //WorkDir = config.WorkDir;
+            TaskDelayTimeout = config.TaskDelayTimeout;
+            SameServer = config.SameServer;
+            OllamaModelName = config.OllamaModelName;
+            EnableVideoASR = config.EnableVideoASR;
+            EnableOpenAI = config.EnableOpenAI;
+            OpenAIModelName = config.OpenAIModelName;
+            OLTPAuth = config.OLTPAuth;
+            OLTPAuthUrl = config.OLTPAuthUrl;
+            OLTPName = config.OLTPName;
+            BraveApiKey = config.BraveApiKey;
+            EnableAccounting = config.EnableAccounting;
+            MaxToolCycles = config.MaxToolCycles;
+            EnableLLMAgentProcess = config.EnableLLMAgentProcess;
+            AgentHeartbeatIntervalSeconds = config.AgentHeartbeatIntervalSeconds;
+            AgentHeartbeatTimeoutSeconds = config.AgentHeartbeatTimeoutSeconds;
+            AgentChunkPollingIntervalMilliseconds = config.AgentChunkPollingIntervalMilliseconds;
+            AgentIdleTimeoutMinutes = config.AgentIdleTimeoutMinutes;
+            MaxConcurrentAgents = config.MaxConcurrentAgents;
+            AgentTaskTimeoutSeconds = config.AgentTaskTimeoutSeconds;
+            AgentShutdownGracePeriodSeconds = config.AgentShutdownGracePeriodSeconds;
+            AgentMaxRecoveryAttempts = config.AgentMaxRecoveryAttempts;
+            AgentQueueBacklogWarningThreshold = config.AgentQueueBacklogWarningThreshold;
+            AgentProcessMemoryLimitMb = config.AgentProcessMemoryLimitMb;
         }
+
+        public static BotApiEndpointSettings ResolveBotApiEndpoint(Config config) {
+            ArgumentNullException.ThrowIfNull(config);
+
+            var normalizedExternalLocalBotApiBaseUrl = NormalizeBaseUrl(config.ExternalLocalBotApiBaseUrl, string.Empty);
+            if (config.EnableLocalBotAPI) {
+                return new BotApiEndpointSettings(
+                    $"http://127.0.0.1:{config.LocalBotApiPort}",
+                    true,
+                    normalizedExternalLocalBotApiBaseUrl);
+            }
+
+            if (!string.IsNullOrWhiteSpace(normalizedExternalLocalBotApiBaseUrl)) {
+                return new BotApiEndpointSettings(
+                    normalizedExternalLocalBotApiBaseUrl,
+                    true,
+                    normalizedExternalLocalBotApiBaseUrl);
+            }
+
+            return new BotApiEndpointSettings(
+                NormalizeBaseUrl(config.BaseUrl, "https://api.telegram.org"),
+                config.IsLocalAPI,
+                normalizedExternalLocalBotApiBaseUrl);
+        }
+
+        private static string NormalizeBaseUrl(string? baseUrl, string fallback) {
+            if (string.IsNullOrWhiteSpace(baseUrl)) {
+                return fallback;
+            }
+
+            return baseUrl.Trim().TrimEnd('/');
+        }
+
         public static readonly string BaseUrl = null!;
 #pragma warning disable CS8604 // 引用类型参数可能为 null。
         public static readonly bool IsLocalAPI;
@@ -69,6 +102,7 @@ static Env() {
         public static readonly string TelegramBotApiId = null!;
         public static readonly string TelegramBotApiHash = null!;
         public static readonly int LocalBotApiPort;
+        public static readonly string ExternalLocalBotApiBaseUrl = string.Empty;
         public static readonly string WorkDir = null!;
         public static readonly int TaskDelayTimeout;
         public static readonly bool SameServer;
@@ -107,6 +141,7 @@ public class Config {
         //public string WorkDir { get; set; } = "/data/TelegramSearchBot";
         public bool IsLocalAPI { get; set; } = false;
         public bool EnableLocalBotAPI { get; set; } = false;
+        public string ExternalLocalBotApiBaseUrl { get; set; } = string.Empty;
         public string TelegramBotApiId { get; set; } = null!;
         public string TelegramBotApiHash { get; set; } = null!;
         public int LocalBotApiPort { get; set; } = 8081;
@@ -134,4 +169,6 @@ public class Config {
         public int AgentQueueBacklogWarningThreshold { get; set; } = 20;
         public int AgentProcessMemoryLimitMb { get; set; } = 256;
     }
+
+    public sealed record BotApiEndpointSettings(string BaseUrl, bool IsLocalApi, string ExternalLocalBotApiBaseUrl);
 }

TelegramSearchBot.Test/Common/EnvBotApiEndpointTests.cs

@@ -0,0 +1,45 @@
+using TelegramSearchBot.Common;
+using Xunit;
+
+namespace TelegramSearchBot.Test.Common {
+    public class EnvBotApiEndpointTests {
+        [Fact]
+        public void ResolveBotApiEndpoint_UsesEmbeddedLocalApiWhenEnabled() {
+            var result = Env.ResolveBotApiEndpoint(new Config {
+                BaseUrl = "https://api.telegram.org",
+                EnableLocalBotAPI = true,
+                LocalBotApiPort = 8081,
+                ExternalLocalBotApiBaseUrl = "http://127.0.0.1:8082/"
+            });
+
+            Assert.Equal("http://127.0.0.1:8081", result.BaseUrl);
+            Assert.True(result.IsLocalApi);
+            Assert.Equal("http://127.0.0.1:8082", result.ExternalLocalBotApiBaseUrl);
+        }
+
+        [Fact]
+        public void ResolveBotApiEndpoint_UsesExternalLocalApiWhenConfigured() {
+            var result = Env.ResolveBotApiEndpoint(new Config {
+                BaseUrl = "https://api.telegram.org",
+                IsLocalAPI = false,
+                EnableLocalBotAPI = false,
+                ExternalLocalBotApiBaseUrl = "http://127.0.0.1:8082/"
+            });
+
+            Assert.Equal("http://127.0.0.1:8082", result.BaseUrl);
+            Assert.True(result.IsLocalApi);
+        }
+
+        [Fact]
+        public void ResolveBotApiEndpoint_FallsBackToConfiguredBaseUrlWhenNoLocalApiConfigured() {
+            var result = Env.ResolveBotApiEndpoint(new Config {
+                BaseUrl = "https://api.telegram.org/",
+                IsLocalAPI = false,
+                EnableLocalBotAPI = false
+            });
+
+            Assert.Equal("https://api.telegram.org", result.BaseUrl);
+            Assert.False(result.IsLocalApi);
+        }
+    }
+}