# ⚠️ 重要声明 ⚠️

> # 🚨 免责声明
>
> ## 本工具仅供学习交流使用！
>
> ### 请勿用于任何商业用途、违法用途或对他人造成损害的用途！
>
> **使用本工具所造成的一切后果，由使用者自行承担！**
>
> - 修改注册表可能导致系统不稳定、驱动异常、设备无法识别等问题
> - 请在操作前自行备份注册表与重要数据
> - 操作需谨慎，风险自负

---

# 显卡名称修改工具 (GPU Rename)

一个用于修改 Windows 系统显卡显示名称的 Go 命令行小工具。

## ✨ 功能特性

- 自动枚举当前**实际连接**的物理显卡（PCI 总线），过滤掉幽灵设备与虚拟显示适配器
- 显卡数量 > 1 时，列出列表供用户选择
- 支持自定义显卡显示名称
- 修改完成后自动验证结果
- 修改成功后提示重启机器

## 🖥️ 运行环境

- Windows 7 / 8 / 10 / 11
- 需要 **管理员权限** 运行（修改注册表 HKLM 需要）

## 📦 编译

```bash
# 使用 Go 1.21+ 编译
go mod tidy
go build -o editgpu.exe .
```

或直接使用已编译好的 `editgpu.exe`。

## 🚀 使用方法

1. **右键** 以管理员身份运行 `editgpu.exe`
2. 程序自动检测物理显卡：

   - 只有 1 块显卡：直接选中
   - 多块显卡：输入序号选择要修改的显卡

3. 输入新的显卡名称（直接回车可取消）
4. 程序自动修改注册表并验证
5. 看到「修改成功」提示后，**重启电脑**使修改完全生效

## ⚙️ 工作原理

程序通过 Windows SetupAPI 枚举当前存在的显卡设备：

1. 使用 `DIGCF_PRESENT` 标志只获取当前实际连接的设备，排除历史遗留的幽灵设备
2. 通过 `SPDRP_ENUMERATOR_NAME == "PCI"` 过滤，只保留物理显卡，排除虚拟显示适配器
3. 获取设备实例 ID，映射到注册表路径 `HKLM\SYSTEM\CurrentControlSet\Enum\...`
4. 修改该路径下的 `DeviceDesc` 注册表值

## 📁 文件结构

```
editgpu/
├── main.go       # 主程序源码
├── go.mod        # Go 模块配置
├── go.sum        # 依赖校验文件
└── README.md     # 本说明文档
```

## ❓ 常见问题

**Q：提示「请以管理员身份运行」？**
A：修改注册表需要管理员权限，请右键选择「以管理员身份运行」。

**Q：修改后设备管理器不显示新名称？**
A：请重启电脑，重启后设备管理器会刷新显示新名称。

**Q：修改名称会影响显卡性能吗？**
A：不会，仅修改显示名称，不影响硬件本身与驱动功能。

**Q：如何恢复原始名称？**
A：重新运行本工具，输入原始显卡名称再次修改即可；或到设备管理器卸载设备后重新扫描硬件。

---

# ⚠️ 再次提醒 ⚠️

> ## 本工具仅供学习交流使用
>
> ### 因使用本工具产生的一切后果，由使用者自行承担！
>
> #### 请勿将本工具用于非法用途、商业用途或损害他人利益！