feat(Sync-ClaudeConfig): 改进配置同步脚本处理符号链接

- 替换原始 Copy-Item 调用为自定义 Copy-FileSystemEntry 函数
- 添加对符号链接的特殊处理，避免在失效链接上中断迁移过程
- 实现 Copy-ReparsePointItem 函数专门处理符号链接复制
- 对目录链接进行跳过处理，防止循环或无权限路径问题
- 优先复制可解析的文件链接内容，失效链接仅警告不失败
- 添加相关测试用例验证符号链接处理逻辑

Author: mudssky

ai/coding/claude/Sync-ClaudeConfig.ps1

@@ -264,7 +264,67 @@ function Copy-DirectoryContents {
     }
 
     foreach ($item in Get-ChildItem -LiteralPath $SourcePath -Force) {
-        Copy-Item -LiteralPath $item.FullName -Destination (Join-Path $DestinationPath $item.Name) -Recurse -Force
+        Copy-FileSystemEntry -Item $item -DestinationPath (Join-Path $DestinationPath $item.Name)
+    }
+}
+
+function Copy-FileSystemEntry {
+    param(
+        [Parameter(Mandatory)]
+        [System.IO.FileSystemInfo]$Item,
+
+        [Parameter(Mandatory)]
+        [string]$DestinationPath
+    )
+
+    # 旧版 ~/.claude 整目录软链接里可能混入 runtime 生成的符号链接。
+    # 单独分流可避免 Copy-Item -Recurse 在失效链接上中断整个迁移。
+    if ($Item.Attributes.HasFlag([System.IO.FileAttributes]::ReparsePoint)) {
+        Copy-ReparsePointItem -Item $Item -DestinationPath $DestinationPath
+        return
+    }
+
+    if ($Item.PSIsContainer) {
+        if (-not (Test-Path -LiteralPath $DestinationPath)) {
+            New-Item -ItemType Directory -Path $DestinationPath -Force | Out-Null
+        }
+
+        Copy-DirectoryContents -SourcePath $Item.FullName -DestinationPath $DestinationPath
+        return
+    }
+
+    Copy-Item -LiteralPath $Item.FullName -Destination $DestinationPath -Force
+}
+
+function Copy-ReparsePointItem {
+    param(
+        [Parameter(Mandatory)]
+        [System.IO.FileSystemInfo]$Item,
+
+        [Parameter(Mandatory)]
+        [string]$DestinationPath
+    )
+
+    $linkTarget = Get-LinkTargetText -Item $Item
+    if ($Item.PSIsContainer) {
+        # 目录链接可能指向外部目录或形成环；迁移旧 ~/.claude 时跳过它们，
+        # 可以避免把整个备份流程拖进循环或无权限路径。
+        Write-Warning "备份时跳过目录链接：$($Item.FullName) -> $linkTarget"
+        return
+    }
+
+    try {
+        # 对文件链接优先复制当前可解析的内容，这样像 latest.log 之类的快捷入口
+        # 若仍然有效，就会在备份中落成普通文件；若链接已失效则只告警不失败。
+        Copy-Item -LiteralPath $Item.FullName -Destination $DestinationPath -Force -ErrorAction Stop
+    }
+    catch {
+        if ([string]::IsNullOrWhiteSpace($linkTarget)) {
+            Write-Warning "备份时跳过无法解析目标的链接：$($Item.FullName)"
+            return
+        }
+
+        Write-Warning "备份时跳过无法复制的链接：$($Item.FullName) -> $linkTarget。$($_.Exception.Message)"
     }
 }
 

tests/Sync-ClaudeConfig.Tests.ps1

@@ -176,6 +176,40 @@ Describe 'Sync-ClaudeConfig' {
         Test-Path -LiteralPath (Join-Path $script:GlobalClaudePath 'settings.json') | Should -BeTrue
     }
 
+    It 'migrates legacy symlink directories even when runtime data contains broken symbolic links' {
+        & $script:WriteTestJson -Path (Join-Path $script:SourceRoot 'config/settings.json') -Value @{
+            env = @{
+                API_TIMEOUT_MS = '3000'
+            }
+        }
+
+        $legacyManagedRoot = Join-Path $script:SourceRoot '.claude'
+        $brokenLinkPath = Join-Path $legacyManagedRoot 'debug/latest'
+        $missingDebugFile = Join-Path $legacyManagedRoot 'debug/missing-session.txt'
+
+        New-Item -ItemType Directory -Path (Join-Path $legacyManagedRoot 'debug') -Force | Out-Null
+        New-Item -ItemType Directory -Path (Split-Path -Parent $script:GlobalClaudePath) -Force | Out-Null
+
+        try {
+            # 这里故意创建一个失效符号链接，用来复现用户目录里已有运行态快捷入口时的迁移问题。
+            New-Item -ItemType SymbolicLink -Path $brokenLinkPath -Target $missingDebugFile | Out-Null
+            New-Item -ItemType SymbolicLink -Path $script:GlobalClaudePath -Target $legacyManagedRoot | Out-Null
+        }
+        catch {
+            Set-ItResult -Skipped -Because "当前环境无法稳定创建符号链接：$($_.Exception.Message)"
+            return
+        }
+
+        Set-Content -Path (Join-Path $script:GlobalClaudePath 'history.jsonl') -Value 'runtime-history' -Encoding utf8NoBOM
+
+        { & $script:SyncScriptPath -SourceRoot $script:SourceRoot -GlobalClaudePath $script:GlobalClaudePath -BackupRoot $script:BackupRoot } | Should -Not -Throw
+
+        $targetItem = Get-Item -LiteralPath $script:GlobalClaudePath -Force
+        $targetItem.Attributes.HasFlag([System.IO.FileAttributes]::ReparsePoint) | Should -BeFalse
+        Test-Path -LiteralPath (Join-Path $script:GlobalClaudePath 'history.jsonl') | Should -BeTrue
+        Test-Path -LiteralPath (Join-Path $script:GlobalClaudePath 'settings.json') | Should -BeTrue
+    }
+
     It 'removes stale managed files without deleting unmanaged files in the same directory' {
         & $script:WriteTestJson -Path (Join-Path $script:SourceRoot 'config/settings.json') -Value @{
             env = @{