补充 release SpacetimeDB 健康检查与巡检防回退

增加 SpacetimeDB 阶段化健康检查与 /readyz 阶段输出
记录 procedure/reducer/read 失败的阶段和耗时
补充 release 健康巡检 systemd timer 与生产 ops 预检
同步 API 构建部署、provision 脚本和运维文档

server-rs/crates/api-server/src/config.rs

@@ -12,6 +12,7 @@ use platform_speech::{
 
 const DEFAULT_INTERNAL_API_SECRET: &str = "genarrative-dev-internal-bridge";
 const SPACETIME_LOCAL_CONFIG_FILE: &str = "spacetime.local.json";
+const DEFAULT_SPACETIME_HEALTH_CHECK_TIMEOUT_SECONDS: u64 = 2;
 pub(crate) const DEFAULT_VECTOR_ENGINE_IMAGE_REQUEST_TIMEOUT_MS: u64 = 1_000_000;
 
 // 集中管理 api-server 的启动配置，避免入口层直接散落环境变量解析逻辑。
@@ -118,6 +119,7 @@ pub struct AppConfig {
     pub spacetime_token: Option<String>,
     pub spacetime_pool_size: u32,
     pub spacetime_procedure_timeout: Duration,
+    pub spacetime_health_check_timeout: Duration,
     pub llm_provider: LlmProvider,
     pub llm_base_url: String,
     pub llm_api_key: Option<String>,
@@ -276,6 +278,9 @@ impl Default for AppConfig {
             spacetime_token: None,
             spacetime_pool_size: 4,
             spacetime_procedure_timeout: Duration::from_secs(30),
+            spacetime_health_check_timeout: Duration::from_secs(
+                DEFAULT_SPACETIME_HEALTH_CHECK_TIMEOUT_SECONDS,
+            ),
             llm_provider: LlmProvider::Ark,
             llm_base_url: String::new(),
             llm_api_key: None,
@@ -704,6 +709,12 @@ impl AppConfig {
             config.spacetime_procedure_timeout =
                 Duration::from_secs(spacetime_procedure_timeout_seconds);
         }
+        if let Some(spacetime_health_check_timeout_seconds) =
+            read_first_duration_seconds_env(&["GENARRATIVE_SPACETIME_HEALTH_CHECK_TIMEOUT_SECONDS"])
+        {
+            config.spacetime_health_check_timeout =
+                Duration::from_secs(spacetime_health_check_timeout_seconds);
+        }
 
         if let Some(llm_provider) =
             read_first_llm_provider_env(&["GENARRATIVE_LLM_PROVIDER", "LLM_PROVIDER"])
@@ -1610,6 +1621,26 @@ mod tests {
         }
     }
 
+    #[test]
+    fn from_env_reads_spacetime_health_check_timeout() {
+        let _guard = ENV_LOCK
+            .get_or_init(|| Mutex::new(()))
+            .lock()
+            .expect("env lock should not poison");
+
+        unsafe {
+            std::env::remove_var("GENARRATIVE_SPACETIME_HEALTH_CHECK_TIMEOUT_SECONDS");
+            std::env::set_var("GENARRATIVE_SPACETIME_HEALTH_CHECK_TIMEOUT_SECONDS", "3");
+        }
+
+        let config = AppConfig::from_env();
+        assert_eq!(config.spacetime_health_check_timeout.as_secs(), 3);
+
+        unsafe {
+            std::env::remove_var("GENARRATIVE_SPACETIME_HEALTH_CHECK_TIMEOUT_SECONDS");
+        }
+    }
+
     #[test]
     fn default_keeps_structured_llm_web_search_disabled() {
         let config = AppConfig::default();