本文档旨在指导用户在 Windows 环境下安装 gsudo 提权工具，并将其集成至 Fluent Terminal 中，实现终端启动即自动获取管理员权限的标准化配置。

1. 工具简介

gsudo (Sudo for Windows) 是一款允许用户在当前控制台窗口以管理员权限运行命令的开源工具。它解决了传统 Windows 开发中需要频繁切换“管理员窗口”与“普通窗口”的痛点，提供了类似 Linux sudo 的使用体验。

2. 安装部署

我们将使用 Windows Package Manager (winget) 进行标准化安装。

2.1 执行安装命令

请打开 PowerShell 或命令提示符（CMD），输入以下命令并回车：

winget install --id gerardog.gsudo -e

2.2 验证安装

安装完成后，输入以下命令验证是否已正确添加到系统路径：

gsudo -v

若返回版本号信息（如 v2.x.x），则说明安装成功。

3. Fluent Terminal 集成配置

本节将指导如何修改 Fluent Terminal 的配置文件，使其默认通过 gsudo 启动 PowerShell。

3.1 进入设置界面

  1. 打开 Fluent Terminal。
  2. 点击窗口左上角的菜单按钮（或使用快捷键 Ctrl + Shift+,）。
  3. 选择 Settings (设置)。

3.2 定位配置文件

  1. 在左侧导航栏中，点击 Profiles (配置文件)。
  2. 在列表中选择您日常使用的 PowerShell 配置文件（通常是默认勾选的项目）。

3.3 修改核心参数

在右侧的配置详情页面中，请严格按照下表修改两项核心参数：

设置项 (英文) 设置项 (中文) 修改后的值 说明
Executable 可执行程序位置 gsudo.exe 将启动程序替换为提权工具
Arguments 参数 powershell.exe 告知 gsudo 提权后运行 PowerShell

注意：

  • 如果系统无法直接识别 gsudo.exe，可以使用命令 (Get-Command gsudo).Source 获取绝对路径填入。
  • 建议将该配置文件的 Name (名称) 修改为 PowerShell (Admin) 以便区分。

3.4 保存配置

点击页面底部的 Save (保存) 按钮，并完全关闭 Fluent Terminal。

4. 验证测试

配置完成后，请执行以下步骤验证集成是否成功。

4.1 启动测试

重新打开 Fluent Terminal。

  • 预期行为：Windows 系统应立即弹出 UAC（用户账户控制）确认窗口，询问“是否允许此应用更改设备”。
  • 操作：点击“是”。

4.2 权限检测

进入终端界面后，输入以下命令检测当前权限状态：

方法一：使用网络会话命令（推荐）

net session
  • 成功：显示会话列表或“没有发生错误”。
  • 失败：显示“拒绝访问”。

方法二：使用 .NET 代码检测（精确）

([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
  • 成功：返回 True。
  • 失败：返回 False。

5. 高级配置（可选）

为了提升使用体验，减少 UAC 弹窗的频繁打扰，可以开启 gsudo 的凭据缓存模式。

在管理员权限的终端中执行：

gsudo config CacheMode Auto

功能说明：开启后，在首次提权并通过 UAC 验证后的短时间内（默认数分钟），再次打开新窗口或申请提权将不再弹出 UAC 提示，逻辑与 Linux 的 sudo timestamp 类似。