feat(env): 为 Sync-PathFromBash 添加非登录模式支持并改进 PATH 同步逻辑

- 默认改为非登录模式（仅从 .bashrc 加载 PATH），新增 -Login 开关启用完整登录模式
- 添加非登录模式失败时的回退逻辑，尝试显式加载 ~/.bashrc
- 保留现有登录模式回退到 /etc/profile 的逻辑
- 更新函数文档和测试用例，确保兼容性和可测试性

Author: mudssky

.trae/documents/默认从 .bashrc 获取 PATH，支持 -Login 切换.md

@@ -0,0 +1,29 @@
+## 目标
+- 将 `Sync-PathFromBash` 默认改为“非登录模式”，仅从 `.bashrc` 加载 PATH；通过 `-Login` 开关启用登录模式（`bash -l`）。
+
+## 影响面分析
+- 修改文件：`psutils/modules/env.psm1`
+- 风险：交互式 `.bashrc` 可能包含需要用户交互的命令；需保留回退并支持 `-WhatIf`。
+
+## 设计方案
+- 新增参数：`[switch]$Login`（默认 false）。
+- 非登录模式（默认）：使用 `bash -ci 'echo $PATH'` 获取仅由 `.bashrc` 配置的 PATH。
+- 登录模式（切换）：使用 `bash -lc 'echo $PATH'` 获取完整登录环境 PATH。
+- 回退逻辑：
+  - 非登录失败或空输出→尝试 `bash --noprofile --norc -c 'source ~/.bashrc 2>/dev/null; echo $PATH'`；若仍失败→返回警告。
+  - 登录失败或空输出→回退 `bash -c 'source /etc/profile >/dev/null 2>&1; echo $PATH'`。
+- 保留并复用现有增强：Trim/去重、集合差集（保留顺序）、目录存在性过滤、`-Prepend`/默认后置、`-WhatIf`/`-Confirm`、结构化返回对象。
+- 文档与示例：更新 `.PARAMETER Login` 与 `.EXAMPLE`，增加非登录与登录示例。
+
+## 实施步骤
+1. 在函数参数中添加 `-Login` 并改写 Bash 调用分支（默认 `bash -ci`，登录分支 `bash -lc`）。
+2. 添加非登录失败回退到显式 `source ~/.bashrc` 的逻辑；保留现有登录回退到 `/etc/profile`。
+3. 保持其余路径处理与输出逻辑不变，以减少回归风险。
+4. 更新函数注释的 `.DESCRIPTION`、`.PARAMETER Login`、`.EXAMPLE`。
+5. 更新/新增测试：验证默认非登录分支与 `-Login` 分支均能返回对象，且支持 `-WhatIf`。
+
+## 验证方案
+- 本地执行：`Sync-PathFromBash -WhatIf`（非登录）、`Sync-PathFromBash -Login -WhatIf`（登录），确认结构化返回字段齐全、无异常。
+- 极端用例：`.bashrc` 为空/含交互命令时，验证回退到 `source ~/.bashrc` 的行为与日志提示。
+
+请确认以上方案，确认后我将据此实现并完成测试。

profile/profile_unix.ps1

@@ -157,7 +157,7 @@ function Initialize-Environment {
         $env:PATH += ":/home/linuxbrew/.linuxbrew/bin/"
     }
     if ($IsLinux) {
-        Sync-PathFromBash
+        Sync-PathFromBash | Out-Null
     }
     if ($Minimal -or (Test-Path -Path (Join-Path $PSScriptRoot 'minimal')) -or $env:POWERSHELL_PROFILE_MINIMAL) {
         $SkipTools = $true

psutils/modules/env.psm1

@@ -431,11 +431,13 @@ function Remove-FromEnvPath {
 function Sync-PathFromBash {
     <#
     .SYNOPSIS
-        同步 Bash 登录 Shell 的 PATH 到当前 PowerShell 会话。
+        同步 Bash 的 PATH（默认非登录，从 .bashrc）到当前 PowerShell 会话。
     .DESCRIPTION
-        在 Linux/macOS 上，通过调用 `bash -l` 获取完整配置后的 PATH，
-        比较当前 PowerShell 的 PATH，追加缺失路径。支持前置/后置策略，
-        可选过滤不存在的目录，并返回结构化结果用于编程处理。
+        默认采用非登录模式（不加载 /etc/profile），通过 `bash -ci` 读取由 `.bashrc` 配置的 PATH，
+        并与 PowerShell 的 PATH 对比追加缺失项。可通过 `-Login` 开启登录模式（`bash -lc`）。
+        支持前置/后置策略、目录有效性过滤、结构化返回对象与安全预览。
+    .PARAMETER Login
+        启用登录模式（`bash -lc`），获取完整登录环境 PATH。
     .PARAMETER Prepend
         将缺失路径前置到 PATH 开头，使 Bash 的路径优先生效。
     .PARAMETER IncludeNonexistent
@@ -444,33 +446,48 @@ function Sync-PathFromBash {
         返回包含统计与结果的 `PSCustomObject`（默认 true）。
     .EXAMPLE
         Sync-PathFromBash -WhatIf -Verbose
-        预览将要变更的 PATH，不实际更改，并显示详细日志。
+        以非登录模式预览将要变更的 PATH，不实际更改，并显示详细日志。
     .EXAMPLE
-        Sync-PathFromBash -Prepend -Verbose
-        将 Bash 中缺失的目录前置到 PATH，适合优先使用 Bash 环境。
+        Sync-PathFromBash -Login -Prepend -Verbose
+        以登录模式将 Bash 中缺失的目录前置到 PATH，适合优先使用完整登录环境。
     #>
     [CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'Low')]
     param(
+        [switch]$Login,
         [switch]$Prepend,
-        [switch]$Append,
         [switch]$IncludeNonexistent,
         [bool]$ReturnObject = $true
     )
 
     try {
         $start = [DateTime]::UtcNow
         Write-Information "正在从 Bash 登录 Shell 中获取 PATH..."
-        if ($Prepend -and $Append) { throw "同时指定 Prepend 与 Append，不支持；请二选一" }
-
-        $bashPathOutput = bash -l -c 'echo $PATH'
-        $source = 'bash-login'
-        if ($LASTEXITCODE -ne 0 -or [string]::IsNullOrWhiteSpace($bashPathOutput)) {
-            Write-Warning "无法从 Bash 登录 Shell 获取 PATH，尝试回退方案。"
-            $bashPathOutput = bash -c 'source /etc/profile >/dev/null 2>&1; echo $PATH'
-            $source = 'bash-profile-fallback'
+        $bashPathOutput = ''
+        $source = ''
+        if ($Login) {
+            $bashPathOutput = bash -lc 'echo $PATH'
+            $source = 'bash-login'
             if ($LASTEXITCODE -ne 0 -or [string]::IsNullOrWhiteSpace($bashPathOutput)) {
-                Write-Warning "无法从 Bash 获取 PATH。Bash 可能未安装或存在配置错误。"
-                return
+                Write-Warning "无法从 Bash 登录 Shell 获取 PATH，尝试回退 /etc/profile。"
+                $bashPathOutput = bash -c 'source /etc/profile >/dev/null 2>&1; echo $PATH'
+                $source = 'bash-profile-fallback'
+                if ($LASTEXITCODE -ne 0 -or [string]::IsNullOrWhiteSpace($bashPathOutput)) {
+                    Write-Warning "无法从 Bash 获取 PATH。Bash 可能未安装或存在配置错误。"
+                    return
+                }
+            }
+        }
+        else {
+            $bashPathOutput = bash -ci 'echo $PATH'
+            $source = 'bash-nologin-bashrc'
+            if ($LASTEXITCODE -ne 0 -or [string]::IsNullOrWhiteSpace($bashPathOutput)) {
+                Write-Warning "非登录模式获取 PATH 失败，尝试显式加载 ~/.bashrc。"
+                $bashPathOutput = bash --noprofile --norc -c 'source ~/.bashrc 2>/dev/null; echo $PATH'
+                $source = 'bash-nologin-bashrc-fallback'
+                if ($LASTEXITCODE -ne 0 -or [string]::IsNullOrWhiteSpace($bashPathOutput)) {
+                    Write-Warning "无法从非登录模式获取 PATH。请检查 Bash 安装或 .bashrc 配置。"
+                    return
+                }
             }
         }
 

tests/Sync-PathFromBash.Tests.ps1

@@ -18,4 +18,7 @@ Describe 'Sync-PathFromBash basic behavior' {
     It 'should support Append strategy (default) without error when WhatIf' {
         { Sync-PathFromBash -WhatIf } | Should -Not -Throw
     }
+    It 'should support Login branch without error when WhatIf' {
+        { Sync-PathFromBash -Login -WhatIf } | Should -Not -Throw
+    }
 }