From abea7fce11319f3e7684aad3c35b5c4d0f41668a Mon Sep 17 00:00:00 2001
From: mokurin000 <1348292515a@gmail.com>
Date: Sat, 2 Aug 2025 02:05:05 +0800
Subject: [PATCH] docs: add more documentation

---
 sdgb-api/src/title/model/get_user_music_api/mod.rs |  2 ++
 sdgb-cli/src/commands.rs                           | 10 ++++++++--
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/sdgb-api/src/title/model/get_user_music_api/mod.rs b/sdgb-api/src/title/model/get_user_music_api/mod.rs
index 50b37a6..b2121bc 100644
--- a/sdgb-api/src/title/model/get_user_music_api/mod.rs
+++ b/sdgb-api/src/title/model/get_user_music_api/mod.rs
@@ -59,9 +59,11 @@ pub struct UserMusicDetail {
     /// - 5: SYNC
     pub sync_status: i64,
 
+    /// DX 分数
     pub deluxscore_max: i64,
     pub score_rank: i64,
 
+    /// 理论次数
     pub ext_num1: i64,
     pub ext_num2: i64,
 }
diff --git a/sdgb-cli/src/commands.rs b/sdgb-cli/src/commands.rs
index f7884b6..e44184f 100644
--- a/sdgb-cli/src/commands.rs
+++ b/sdgb-cli/src/commands.rs
@@ -27,6 +27,7 @@ pub enum Commands {
         qrcode_content: String,
     },
 
+    /// Retrieve update package of SDGB
     AuthLite {
         #[arg(short, long, default_value = "1.50")]
         title_ver: String,
@@ -34,12 +35,14 @@ pub enum Commands {
         variant: AuthLiteVariant,
     },
 
-    // below are login-free
+    /// Test delay to SDGB server
     Ping,
+    /// Get basic info
     Preview {
         #[arg(short, long)]
         user_id: u32,
     },
+    /// Get B35 + B15 play records
     Rating {
         #[arg(short, long)]
         user_id: u32,
@@ -51,12 +54,15 @@ pub enum Commands {
         #[arg(short, long, default_value_t = RatingFormat::default())]
         format: RatingFormat,
     },
+    /// Get all play records
     MusicDetail {
         #[arg(short, long)]
         user_id: u32,
     },
 
-    // below requires login
+    /// Retrieve full userdata
+    ///
+    /// WARNING: This requires to login & logout your account
     Userdata {
         #[arg(short, long)]
         user_id: u32,