docs(downGithub.ps1): 更新脚本描述和参数说明

更新了脚本的.SYNOPSIS和.DESCRIPTION部分，添加了详细的参数说明和示例，以更好地描述脚本的功能和用法。同时，修改了仓库克隆命令，使用`gh repo clone`代替`git clone`，并添加了`--mirror`选项以克隆完整仓库镜像。

Author: mudssky

downGithub.ps1

@@ -1,33 +1,52 @@
 <#
 .SYNOPSIS
-	A short one-line action-based description, e.g. 'Tests if a function is valid'
+    批量下载指定 GitHub 用户的所有仓库。
+
 .DESCRIPTION
-	A longer description of the function, its purpose, common use cases, etc.
-.NOTES
-	Information or caveats about the function e.g. 'This function is not supported in Linux'
-.LINK
-	Specify a URI to a help page, this will show when Get-Help -Online is used.
-.EXAMPLE
-	Test-MyTestFunction -Verbose
-	Explanation of the function or its result. You can include multiple examples with additional .EXAMPLE lines
-#>
+    此脚本用于下载指定 GitHub 用户的所有公开仓库。
+    可以选择是否在文件夹名称中包含日期。
 
+.PARAMETER UserName
+    GitHub 用户名（必填）
 
+.PARAMETER Path
+    下载仓库的本地路径，默认为当前目录
+
+.PARAMETER WithDate
+    是否在文件夹名称中包含日期
+
+.EXAMPLE
+    .\downGithub.ps1 -UserName "octocat"
+    下载用户 octocat 的所有仓库到当前目录
 
+.EXAMPLE
+    .\downGithub.ps1 -UserName "octocat" -Path "D:\GitRepos" -WithDate
+    下载用户 octocat 的所有仓库到 D:\GitRepos，并在文件夹名称中包含日期
+#>
 [CmdletBinding()]
 param (
 	[Parameter(Mandatory = $true)]
 	$UserName = '',
 	# 下载执行的路径
 	[string]
-	$Path = '.'
+	$Path = '.',
+	[switch]
+	$WithDate
 )
 
 $repos = Invoke-RestMethod -Uri "https://api.github.com/users/$UserName/repos" -Headers @{ "User-Agent" = "Mozilla/5.0" }
 
 $repos
 
-$repoParentPath = Join-Path $Path $UserName
+$folderMame = $UserName
+
+if ($WithDate) {
+	$dateString = Get-Date -Format "yyyyMMdd"
+	$folderMame = "$dateString-$UserName"
+}
+
+
+$repoParentPath = Join-Path $Path $folderMame
 
 if (-not (Test-Path $repoParentPath)) {
 	New-Item -ItemType Directory -Force -Path $repoParentPath
@@ -39,9 +58,9 @@ foreach ($repo in $repos) {
 	$repoUrl = $repo.clone_url
 	$repoPath = "$repoParentPath\$repoName"
 
-	# 检查是否已经存在该目录，如果不存在则克隆仓库
+	# 检查是否已经存在该目录，如果不存在则克隆完整仓库镜像
 	if (-not (Test-Path -Path $repoPath)) {
-		git clone $repoUrl $repoPath
+		gh repo clone $repoUrl $repoPath -- --mirror
 	}
 	else {
 		Write-Output "Repository '$repoName' already exists, skipping..."