初始提交

This commit is contained in:
2026-08-26 18:48:17 +08:00
commit 3c6ff7d205
5 changed files with 386 additions and 0 deletions

97
README.md Normal file
View File

@@ -0,0 +1,97 @@
# ⚠️ 重要声明 ⚠️
> # 🚨 免责声明
>
> ## 本工具仅供学习交流使用!
>
> ### 请勿用于任何商业用途、违法用途或对他人造成损害的用途!
>
> **使用本工具所造成的一切后果,由使用者自行承担!**
>
> - 修改注册表可能导致系统不稳定、驱动异常、设备无法识别等问题
> - 请在操作前自行备份注册表与重要数据
> - 操作需谨慎,风险自负
---
# 显卡名称修改工具 (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:重新运行本工具,输入原始显卡名称再次修改即可;或到设备管理器卸载设备后重新扫描硬件。
---
# ⚠️ 再次提醒 ⚠️
> ## 本工具仅供学习交流使用
>
> ### 因使用本工具产生的一切后果,由使用者自行承担!
>
> #### 请勿将本工具用于非法用途、商业用途或损害他人利益!