🦄 refactor: 优化日志输出

Author: apoint123

Cargo.lock

@@ -17,7 +17,12 @@ tokio = { version = "1", features = ["full"] }
 # Log
 tracing = "0.1"
 tracing-appender = "0.2"
-tracing-subscriber = { version = "0.3", features = ["env-filter", "json"] }
+tracing-subscriber = { version = "0.3", features = [
+    "env-filter",
+    "time",
+    "local-time",
+] }
+time = { version = "0.3", features = ["macros", "formatting", "local-offset"] }
 
 # Error & Serialize
 anyhow = "1.0"

native/external-media-integration/Cargo.toml

@@ -14,16 +14,20 @@ export declare function disableSystemMedia(): void
 
 /** Discord 配置参数 */
 export interface DiscordConfigPayload {
-  /** 暂停时是否显示 */
+  /**
+   * 暂停时是否显示
+   *
+   * 注意暂停时进度会固定为 0
+   */
   showWhenPaused: boolean
-  /** 显示模式 */
+  /** 显示模式，参考 [`DiscordDisplayMode`] */
   displayMode?: DiscordDisplayMode
 }
 
 /**
  * Discord 显示模式枚举
  *
- * 控制 Discord 左下角 "正在听 XXX" 的显示内容
+ * 不打开详细信息面板时，在用户名下方显示的小字
  */
 export type DiscordDisplayMode = /** Listening to SPlayer */
 'Name'|
@@ -76,19 +80,23 @@ export interface MetadataParam {
   /**
    * 封面的 HTTP URL，更新 Discord RPC 时必传，其他平台可不传
    *
-   * Linux 平台会优先使用 URL 来更新封面
+   * Linux 平台在没有提供 `cover_data` 时会使用它
    */
   originalCoverUrl?: string
   /**
-   * 网易云音乐 ID
+   * 网易云音乐中对应的曲目 ID
    *
-   * 会以 "NCM-{ID}" 的格式上传到 SMTC 的 “流派” 字段，以及用来生成 Discord RPC 的按钮链接
+   * ### 用途
+   * - 以 "NCM-{ID}" 的格式上传到 SMTC 的 “流派” 字段
+   * - 生成 Discord RPC 的按钮链接
+   * - MacOS 和 Linux 会使用此值来填充唯一的曲目 ID
    */
   ncmId?: number
   /**
    * 当前歌曲时长，单位是毫秒
    *
-   * 用于 Linux、MacOS、Discord RPC 的元数据更新。Windows 使用 [`TimelinePayload`] 的 `total_time` 字段。
+   * 用于 Linux、MacOS、Discord RPC 的元数据更新。Windows 使用 [`TimelinePayload`] 的
+   * `total_time` 字段。
    */
   duration?: number
 }
@@ -152,7 +160,8 @@ export interface TimelinePayload {
  *
  * ### 参数
  *
- * * `payload` - 配置信息，可以配置是否在暂停后也显示 Discord Activity 和 状态显示风格。详情请查看 [`DiscordConfigPayload`]
+ * * `payload` - 配置信息，可以配置是否在暂停后也显示 Discord Activity 和 状态显示风格。详情请查看
+ *   [`DiscordConfigPayload`]
  */
 export declare function updateDiscordConfig(payload: DiscordConfigPayload): void
 

native/external-media-integration/index.d.ts

@@ -8,6 +8,7 @@ use anyhow::{
     Context,
     Result,
 };
+use time::macros::format_description;
 use tracing::{
     error,
     trace,
@@ -17,8 +18,12 @@ use tracing_appender::{
     rolling::RollingFileAppender,
 };
 use tracing_subscriber::{
+    Layer,
     filter::LevelFilter,
-    fmt,
+    fmt::{
+        self,
+        time::LocalTime,
+    },
     layer::SubscriberExt,
     util::SubscriberInitExt,
 };
@@ -36,7 +41,7 @@ pub fn init(log_dir_str: String) -> Result<()> {
         .rotation(tracing_appender::rolling::Rotation::DAILY)
         .filename_prefix("external-media-integration")
         .filename_suffix("log")
-        .max_log_files(3)
+        .max_log_files(5)
         .build(&log_path)
         .context("无法创建日志文件 Appender")?;
 
@@ -47,21 +52,24 @@ pub fn init(log_dir_str: String) -> Result<()> {
         return Ok(());
     }
 
+    let time_format = format_description!("[hour]:[minute]:[second]");
+    let local_timer = LocalTime::new(time_format);
+
     let file_layer = fmt::layer()
         .with_writer(non_blocking)
         .with_ansi(false)
-        .with_file(true)
-        .with_line_number(true)
-        .with_thread_ids(true)
-        .with_target(true);
+        .with_target(true)
+        .with_timer(local_timer.clone())
+        .with_filter(LevelFilter::TRACE);
 
     let stdout_layer = fmt::layer()
         .with_writer(std::io::stdout)
         .with_ansi(true)
-        .pretty();
+        .pretty()
+        .with_timer(local_timer)
+        .with_filter(LevelFilter::WARN);
 
     tracing_subscriber::registry()
-        .with(LevelFilter::INFO)
         .with(file_layer)
         .with(stdout_layer)
         .try_init()