refactor: add shared logging crate

server-rs/crates/shared-logging/Cargo.toml

@@ -0,0 +1,8 @@
+[package]
+name = "shared-logging"
+edition.workspace = true
+version.workspace = true
+license.workspace = true
+
+[dependencies]
+tracing-subscriber = { version = "0.3", features = ["env-filter", "fmt"] }

server-rs/crates/shared-logging/README.md

@@ -0,0 +1,32 @@
+# shared-logging 共享日志 crate 占位说明
+
+日期：`2026-04-21`
+
+## 1. crate 职责
+
+`shared-logging` 是 Rust 工作区统一日志基础设施 crate，后续负责：
+
+1. 统一 `tracing subscriber` 初始化入口
+2. 统一日志过滤器解析逻辑
+3. 统一当前阶段日志输出风格
+4. 为 `api-server`、后续 `spacetime-module`、测试支撑与独立入口提供可复用日志初始化能力
+
+## 2. 当前阶段说明
+
+当前阶段已完成最小落地：
+
+1. 提供 `resolve_env_filter(...)`
+2. 提供 `init_tracing(...)`
+3. 把 `api-server` 的日志初始化逻辑迁出为共享 crate
+
+后续与本 crate 直接相关的任务包括：
+
+1. 根据环境扩展日志输出格式
+2. 补充测试入口、worker 入口与其它主工程 crate 的统一接入
+3. 视需要补充 JSON 输出、链路追踪或远端采集适配
+
+## 3. 边界约束
+
+1. `shared-logging` 只承接日志初始化与基础设施，不承接 HTTP 业务语义。
+2. `TraceLayer`、request id、响应头、错误 envelope 等 HTTP 逻辑继续留在 `api-server`。
+3. 不允许把业务埋点、审计事件或供应商日志适配塞进本 crate。

server-rs/crates/shared-logging/src/lib.rs

@@ -0,0 +1,22 @@
+use std::io;
+
+use tracing_subscriber::{fmt, EnvFilter};
+
+// 统一解析工作区日志过滤器，优先环境变量，其次回落到调用方传入的默认值。
+pub fn resolve_env_filter(default_filter: &str) -> EnvFilter {
+    EnvFilter::try_from_default_env()
+        .or_else(|_| EnvFilter::try_new(default_filter))
+        .unwrap_or_else(|_| EnvFilter::new("info"))
+}
+
+// 统一初始化 tracing subscriber，避免各入口重复散落相同配置。
+pub fn init_tracing(default_filter: &str) -> Result<(), io::Error> {
+    let env_filter = resolve_env_filter(default_filter);
+
+    fmt()
+        .with_env_filter(env_filter)
+        .with_target(true)
+        .compact()
+        .try_init()
+        .map_err(|error| io::Error::other(format!("初始化 tracing subscriber 失败：{error}")))
+}