同方核显省电工具箱（iGPU saving toolbox）

纯 PowerShell 实现的独显省电工具箱，面向同方（TongFang）模具笔记本：

• 无需安装、不携带任何 exe、无第三方依赖（只用 Windows 自带组件）
• 读取显卡/固件信息并生成报告（只读，不改设置）
• 禁用 / 启用独显（Windows PnP 设备层）
• 热切换：在支持固件的机型上让独显真正下线（无需重启）

本工具为独立社区项目，非任何厂商官方工具，与硬件厂商无隶属或授权关系。

功能分级

机型	能力	实现
RTX 30 / 40 系	禁用 / 启用显示设备（省电、降温）	Windows PnP（Get-PnpDevice / Disable-PnpDevice / pnputil）
RTX 50 系	固件支持时真正让独显下线	文档化 ACPI-WMI 接口（ACPI\PNP0C14）读取支持位与状态、写入设备选择字

内屏由独显驱动时脚本会拒绝执行（否则会黑屏）；有程序占用独显时会先报告，需显式 -Force 才会强制释放。

GPU 功耗上限 / Dynamic Boost（实验性 · 菜单 13）

⚠️ 实验性功能。目前仅在 RTX 4060（115W 基础 + 25W DB = 140W 上限） 上验证过。 其它机型请先只用只读模式（-Action Status / Watch）确认地址与字节含义。

• 读取本机范围（不写死机型）：

  nvidia-smi --query-gpu=power.default_limit,power.min_limit,power.max_limit --format=csv

• 换算关系：enforced = 默认 TGP + DB 字节值 （本机：115W + 0..25W；实测 0x05→120W、0x0A→125W、0x13→134W、0x00→115W）
• 可写入地址（已确认）：0x743 / 0x745 / 0x746 / 0x7D4 / 0x7D5， 经 \\.\ACPIDriver 的 EC IOCTL（读 2621482120 / 写 2621482124，仅限 0x700–0x7FF）
• 未确认地址 0x7C4 / 0x751 / 0x7CC 只做只读展示，工具不会写入 （避免伪造"电池供电"状态影响充电与功耗策略）
• 写入流程：只读预演 → 原值记录 → 同值回写自检 → 分两次写入（0x746 → 等待 1s → 0x7D5） → 逐字节回读 + nvidia-smi 交叉验证 → 可用 -Action Restore 回滚
• 已知限制：nvidia-smi -pl 在笔记本上通常不受支持；写入后驱动侧可能延迟跟随， 请跑 GPU 负载后再看 enforced。低于默认 TGP（如 50W）目前没有可靠的安全开关。

快速使用

1. 保持整个目录完整（不要只拷单个文件）
2. 双击 双击运行-同方核显省电工具箱.cmd（会请求管理员权限，必须允许）
3. 在中文菜单里选数字按回车

也可以直接调用脚本（便于被其他项目引用）：

# 只读体检
.\Invoke-DgpuSilence.ps1 -Action Status

# 禁用独显（省电）
.\Invoke-DgpuSilence.ps1 -Action Disable -Elevated

# 恢复独显
.\Invoke-DgpuSilence.ps1 -Action Enable -Elevated

# 固件热切换（仅支持机型）
.\Invoke-GpuHotSwitch.ps1 -Action Silence -Yes

# GPU 功耗上限（实验性；先只读看当前值）
.\GpuPowerLimit.ps1 -Action Status
# 设置 Dynamic Boost 档位（本机 0..25W）
.\GpuPowerLimit.ps1 -Action EnableDb -DbWatt 25 -WhatIf
.\GpuPowerLimit.ps1 -Action EnableDb -DbWatt 25 -Yes
.\Invoke-GpuHotSwitch.ps1 -Action Restore -Yes

脚本与参数契约

脚本	作用	主要参数
GpuPowerSavingToolbox.ps1	中文菜单入口	—
Invoke-DgpuSilence.ps1	PnP 禁用/启用独显	-Action Status|Disable|Enable、-Force、-NoElevate、-Elevated、-DryRun、-RemoveDevice
Invoke-GpuHotSwitch.ps1	固件热切换（读取支持位、写入选择字、校验与回滚）	-Action Status|Silence|Restore、-Yes、-Force、-DryRun、-StateEngine <helpers.ps1>
Get-NvramState.ps1	只读固件状态探测与快照/对比	-Mode Probe|Snapshot|Compare
Clear-DgpuOccupants.ps1	列出/释放占用独显的程序	-List、-Kill、-Tier heavy|light

退出码（Invoke-DgpuSilence.ps1）：0 成功 · 2 门控拒绝 · 3 被占用 · 4 禁用失败 · 5 启用失败。

安全设计

• 显示拓扑门控：内屏由独显驱动时拒绝执行，避免黑屏
• 独占检测：先报告占用程序，强制释放需显式开关
• 结果校验与自动回滚：热切换后校验状态，失败自动切回
• 全程日志与退出码，便于脚本化调用

许可

MIT

---

备注：本仓库为脚本原版，可直接被其他项目引用或调用；不依赖任何加载器、插件框架或运行时。