PVE Tools Pro

外观

更新日志 ​

本页用于同步脚本正式发布版本。v11.0.0 为交互层框架化与高风险运维护栏的大版本升级；v7.0.0 曾覆盖 CLI、安全边界、虚拟机运维、宿主机网络与 GPU 直通体系。

2026年7月28日 - v11.0.0 ​

交互层框架化（Liino）：菜单统一、确认两档、GPU/GRUB 护栏与 CI 真闸门 ​

Build 代号：Liino。本版本把「能跑」推进到「可预期、可回滚、可审计」——统一交互骨架，收紧高风险写入，并修正远程安装 / 自更新链路。

P0 / 交互层：lib/menu.sh 与全模块菜单迁移 ​

  • 新增统一菜单框架 lib/menu.sh：run_menu / menu_prompt / prompt_value / prompt_yes_no / prompt_pick_from_list / show_report。
  • 约 48 处手写 while true 菜单循环迁移为 *_render + *_dispatch，覆盖主菜单 1–10 及 GPU、CVE、防火墙、内核等二级菜单。
  • EOF（Ctrl+D / 输入流关闭）与 Ctrl+C 守卫：子菜单视为返回上级，主循环优雅退出，杜绝无效选择死循环刷屏。
  • MENU_SKIP_PAUSE：进出子菜单与返回不再多按一次「任意键」；动作完成后才 pause。
  • 返回项文案按嵌套深度自动生成（「返回主菜单」/「返回上级菜单」）；读取提示统一为 请选择操作 [0-N]: 。
  • 风险横幅（VM / 宿主机网络）每会话仅完整展示一次，避免菜单重绘整屏刷同一段警告。

P0 / 确认体系与系统配置写入规范 ​

  • 确认两档成文并落地：
    • 轻档 confirm_action（输入 yes）：可逆配置写入。
    • 重档 confirm_high_risk_action（指定确认词）：GRUB / VFIO、驱动黑名单 + initramfs、第三方 deb/内核、LVM、qm 磁盘槽位、Ceph、防火墙清空、SSH 加固等。
  • 成块配置一律 apply_block / remove_block（# PVE-TOOLS BEGIN/END <MARKER>），写前自动备份，可幂等清理。
  • GRUB 参数改为数组化按 key 精确增删查：新增 grub_has_param，避免旧正则误伤相邻参数。
  • 默认启动内核优先 proxmox-boot-tool kernel pin（GRUB 与 systemd-boot 均适用），失败再回退 grub-set-default。

P0 / GPU 直通与 IOMMU 安全边界 ​

  • 新增 gpu_detect_active_stacks / gpu_warn_active_stacks：进入任一直通方案前检测已有配置（含旧版无 marker 的 GRUB 特征兜底），降低多方案叠加冲突。
  • IOMMU 开/关强制重档确认（IOMMU-ON / IOMMU-OFF）；模块写入走 marker，清理时先 marker 再兼容历史裸行。
  • 去掉一键直通写死的 vfio-pci ids=8086:3185；核显 / 声卡黑名单改为可选确认，避免宿主机本地显示默认黑屏。
  • Intel 核显清理路径增强：同步移除本工具写入的相关黑名单块，避免「以为恢复了其实仍被屏蔽」。

P1 / 远程安装、自更新与分发纠偏 ​

  • 远程模式与自更新统一改为 GitHub Releases 完整单文件：releases/latest/download/PVE-Tools.sh（main 不再跟踪 dist/，raw 入口仅约 300 行 bootstrap）。
  • 修正 vGPU Unlock 资源路径：指向真实存在的 Modules/VGPU/*.so（原错误 Modules/NVIDIA/ 不存在）。
  • build.sh / dev.sh / PVE-Tools.sh 三入口同步加载 lib/menu.sh。
  • 优化菜单补齐 UPS 电源诊断入口；CVE 菜单编号连续化；主菜单文案突出 CVE 与 IT87。

P1 / CI/CD 护栏「从空转到真闸门」 ​

  • PR 验证补全：lib/src 全量 shellcheck error、源码与 dist 函数集合双向 diff、UPDATE 首行必须含当前版本、对 dist 的 eval / 未引号 rm -rf $var / source 扫描（命中即失败）。
  • 正式 / Beta 发版前再跑语法、shellcheck、函数一致性；正式版强制 tag == CURRENT_VERSION == VERSION。
  • 正式 release 排除 *-beta* / *-alpha* / *-rc*，避免与 beta 流水线抢同一 tag。
  • 发布物附带 SHA256SUMS.txt；文档移除已过时的 shc 二进制编译叙事。

P2 / 文档、仓库卫生与维护声明 ​

  • 根 CLAUDE.md / AGENTS.md / 模块文档按现实重写：入口行数、远程模式、menu 规范、术语表、测试策略。
  • 日文 README 文件名由错误的 REAMDE-JP.md 更正为 README-JP.md。
  • 清理历史截图、proxmoxlib.js、release ROM 等无关大文件；.gitignore 允许 Docs/ 入库。
  • 明确 Shell 版本恢复持续维护；此前「v8.8.8 后停更转 Go」计划已撤回。

升级提醒 ​

  • 大版本升级：交互与确认节奏有变化，高风险操作会要求输入指定确认词，请按屏幕提示操作。
  • 远程一键安装与脚本内自更新依赖 GitHub Releases 资产；发版完成后请确认 releases/latest 已挂上 PVE-Tools.sh。
  • 若曾使用旧版一键 IOMMU / 核显方案，升级后进入对应菜单查看「已存在方案」提示，切换方案前建议先清理旧配置并备份 GRUB。
  • 建议验证：bash dev.sh 走通主菜单进出；维护窗口内抽测 IOMMU / 换源 / 防火墙等重档路径。

2026年7月26日 - v10.2.2 ​

IT87 驱动安全加固与防御性编程增强 ​

  • 锁定 IT87 驱动仓库引用为 PGP 签名提交 SHA，改用 git init && git fetch 支持按 SHA 精确检出，降低供应链风险。
  • IT87 安装流程防御性增强：写入前 backup_file 备份、mktemp 创建临时目录、兼容 DKMS 格式、read -r 安全读取。
  • 清理 dist/ 目录，发布流程不再跟踪构建产物。

升级提醒 ​

  • 已安装 IT87 驱动的用户无需重新安装；本次更新主要加固新安装链路。

2026年7月11日 - v10.2.0 ​

IT87 驱动支持与 Bootstrap 优化 ​

  • 第三方工具模块新增 IT87 驱动支持：为 ITE EC 风扇传感器提供主线内核外的驱动方案，方便在缺少 it87 内核模块的环境中读取风扇转速与温度。
  • 优化 bootstrap 下载流程，提升远程安装与自更新稳定性。

2026年7月8日 - v10.1.0 ​

模块加载顺序修复与 Bootstrap 精简 ​

  • 修复模块加载顺序：确保 source 各模块 init.sh 后再加载同级脚本，避免依赖缺失导致的运行时错误。
  • 精简 bootstrap：远程入口改为仅下载 dist 单文件，去除多余拉取步骤，加快冷启动速度。
  • 修复版本号比较：去除预发布后缀（-beta / -alpha / -rc）后再比对，避免升级检测误判。

2026年7月8日 - v10.0.1 ​

安全中心 CVE 漏洞修补（Copy Fail / Dirty Frag / Januscape） ​

  • 安全中心新增 CVE 漏洞修补：Copy Fail 与 Dirty Frag 本地提权漏洞（LPE）修复，覆盖内核模块黑名单与相关缓解策略。
  • Januscape CVE-2026-53359 漏洞修补。
  • cve-fix.sh 全面加固：移除双击暂停、幂等黑名单管理、drop_caches 门控、read -r 安全读取、内核检测加固、错误检查完善。
  • 同步更新文档、镜像资源与 CI 配置。

升级提醒 ​

  • 建议进入「安全中心」菜单执行一次 CVE 检测，确认当前内核的漏洞覆盖状态。

2026年7月8日 - v10.0.0 ​

模块化架构重构 × v9.0.0 特性合并发布；Shell 版本恢复持续维护 ​

Build 代号：模块化重塑。本版本彻底重构代码组织架构，合并原计划独立发布的 v9.0.0 全部特性，同时正式撤回「v8.8.8 后停更转 Go」的归档计划。

架构层：模块化重构 ​

  • 拆分 lib/ 基础设施层与 src/modules/ 功能模块，将单文件脚本按职责解耦为可独立加载的模块单元。
  • 实现模块间 init.sh 依赖管理，各功能按需加载，降低耦合度与维护成本。

功能层：v9.0.0 特性集合并 ​

  • 镜像源系统重构：改为并行数组架构，新增智能镜像选择与通用下载函数，提升换源可靠性与扩展性。
  • CoolerControl 风扇控制：新增一键安装/更新/卸载，为桌面级散热管理提供脚本化入口。
  • 垃圾清理系统：新增基础清理、备份修剪、快照修剪、孤立磁盘扫描等功能，帮助回收存储空间。
  • 磁盘直通增强：整盘发现、存储控制器直通、NVMe 直通能力补强，新增系统盘保护避免误操作。
  • 存储挂载向导：支持 ext4 / xfs 分区一键挂载，简化新增磁盘的接入流程。
  • 安全中心菜单：整合安全相关功能入口，统一收口 CVE 修补、内核安全配置等路径。
  • 主菜单重组：新增「安全中心」「第三方工具」入口；虚拟机高级操作拆分为聚焦型子菜单，提升操作效率。
  • 移除内嵌文档站：删除 Web/ 目录下的 VitePress 文档站，仓库更精简；文档通过独立的 docs-next 站点继续维护。

工程层：代码质量与发布流程 ​

  • cpupower 安全写入加固、upgrade-pve 强制升级确认。
  • 修复审查机器人反馈的代码问题：安全规范、回归边界、变量作用域等。
  • 发布流程纠偏：移除 shc/ssc 二进制编译链路，改为发布原始 Shell 脚本，消除 glibc 兼容性风险。
  • 仓库引用更新：Mapleawaa → PVE-Tools，域名与安装命令同步修正。

升级提醒 ​

  • 从 v8.8.8 升级到 v10.0.0 是一次大版本跳跃（v9.0.0 从未正式发布，其全部特性已合并入本版本）。
  • Shell 版本已恢复持续维护，此前「停止更新」公告作废。
  • 模块化重构后内部结构变化较大，如有自定义脚本引用内部函数请重新适配。
  • 建议验证：进入主菜单逐项检查各功能入口是否正常加载。

2026年5月15日 - v8.8.8 ​

Shell 版最终版本（并不），项目归档并转向 Go 重构 ​

  • Shell 版本定格为最终版本，main 分支停止功能更新，后续维护将转向 Go 语言重构版（beta-go 分支）。
  • 文档站首页新增 EOL 归档公告横幅，引导用户了解项目后续方向。
  • 导航栏新增"归档说明"入口，集中展示项目归档背景与后续规划。
  • 公告组件更新为项目归档声明，明确说明 Shell 版停止更新及 Go 重构版的开源地址。
  • 注释掉 HarmonyOS Sans 外部字体引用，改用系统默认字体栈，减少外部依赖。
  • 页脚版权信息更新为 Ciriu Networks 标识。
  • 赞助数据同步更新。

升级提醒 ​

  • Shell 版 v8.8.8 为最终版本，不再接收新功能更新。
  • 如需继续使用 PVE Tools Pro，请关注 Go 重构版：beta-go 分支。
  • 现有 Shell 版功能仍可正常使用，但不再提供新特性支持。

2026年5月9日 - v7.7.0 ​

修复阿里云换源 Ceph 镜像 404 问题，优化换源日志提示 ​

  • 修复阿里云换源时 Ceph 镜像指向不存在地址（https://mirrors.aliyun.com/ceph/debian-squid 返回 404）的 BUG，改为使用官方 Ceph 源。
  • 优化换源功能的日志提示，明确告知用户哪些源使用了镜像站、哪些沿用官方源，避免混淆。
  • 经验证，阿里云和腾讯云目前均不提供 PVE / Ceph / CT 模板镜像，脚本在选择这两家镜像站时会自动回退到官方源。

升级提醒 ​

  • 如果你之前选择了阿里云换源并发现 Ceph 源更新失败，升级后重新执行一次换源操作即可修复。
  • 阿里云和腾讯云目前仅支持 Debian 基础源和安全更新源的镜像加速，PVE / Ceph / CT 组件仍使用官方源。

2026年5月7日 - v7.6.0 ​

  • 将按 MAC 地址绑定网卡到 Bridge 的实现改为 systemd .link 规则，生成 /etc/systemd/network/10-pve-tools-*.link，不再依赖老旧的 udev 持久化绑定方式。
  • 新增绑定前冲突检测与宿主机网络引用检查，只有在确认不会影响现有网络拓扑时才写入配置，降低误绑和断网风险。
  • 保留旧式 /etc/udev/rules.d/70-persistent-net.rules 的兼容清理逻辑，方便从历史方案平滑迁移到新实现。
  • 换源菜单新增腾讯云公网镜像和阿里云公网镜像选项，其中腾讯云用于 Debian / 安全更新，阿里云用于 Debian / 安全 / Ceph。
  • 脚本版本保持为 7.6.0，本次仅做同版本补充，不额外迭代。

升级提醒 ​

  • 如果你之前已经手动写过旧式 udev 规则，这次更新后建议重新检查一次网卡和 Bridge 的绑定结果。
  • 新实现会优先走 systemd .link，旧规则只负责兼容清理，不再作为主路径。
  • 新增的公网镜像选项只会接入已确认可用的组件，避免把未验证的地址写入系统配置。

2026年5月5日 - v7.5.0 ​

Copy Fail 入口改为修复复查与清理，适配已陆续修复后的内核管理流程 ​

  • 将 Copy Fail（CVE-2026-31431） 入口语义从"检测/缓解"调整为"修复复查 / 清理 / 升级后复验"，更适合漏洞已逐步修复完成后的场景。
  • 在主菜单和内核菜单增加修复后提示，提醒用户完成内核升级后尽快回到该入口检查状态、清理历史临时阻断配置并再次验证。
  • 保留检测、手动说明、自动临时阻断、回滚和同步内核功能，但统一改写为"修复后管理"视角，减少误导用户把临时阻断当成长期方案。

升级提醒 ​

  • 如果你已经完成内核更新，建议先进入 Copy Fail 菜单执行一次检测，再确认是否需要清理 /etc/modprobe.d/disable-algif.conf 和 /etc/modprobe.d/disable-authencesn.conf。
  • 这次更新只调整入口语义和提示，不改变既有检测与内核同步逻辑。

2026年4月30日 - v7.4.0 ​

内核更新修复：避免误装辅助包，统一真实内核包识别 ​

  • 修复自动更新流程误把辅助包当作最新内核的问题，避免再次出现 proxmox-kernel-libc-dev 之类的错误安装目标。
  • 统一 proxmox-kernel-* / pve-kernel-* / -signed 的包名识别与规范化逻辑，确保菜单展示、自动更新和手动安装走同一套真实内核路径。
  • 调整可用内核列表筛选规则，只保留真实内核包，减少混入开发包、工具包或其他辅助条目的风险。
  • 保留 Copy Fail（CVE-2026-31431） 安全处置入口，并同步将脚本版本提升到 7.4.0。

升级提醒 ​

  • 这次更新重点是修复内核管理链路，不影响已有的 Copy Fail 检测、缓解和回滚功能。
  • 如果你之前误触发过内核更新失败，建议先重新打开"查看可用内核列表"确认包名，再执行安装或自动同步。

2026年4月30日 - v7.3.0 ​

内核安全响应：新增 Copy Fail（CVE-2026-31431）检测、风险评估与缓解入口 ​

  • 新增 Copy Fail / CVE-2026-31431 漏洞处置菜单，挂载到"启动与内核 -> 内核管理"路径，便于围绕当前运行内核直接排查与处理。
  • 新增漏洞状态检测：综合当前运行内核版本、已安装内核包 changelog、CONFIG_CRYPTO_USER_API_AEAD / CONFIG_CRYPTO_AUTHENCESN、algif_aead / authencesn 模块状态，判断系统更接近"已修复 / 已缓解 / 仍有风险 / 通常不受影响"哪一类。
  • 新增受攻击危险评估：结合交互用户数量、LXC 容器数量与运行状态、SSH 服务暴露情况，对本地提权 / 容器逃逸前置条件做更直观提示。
  • 新增手动处理说明：在界面中明确区分"正式修复优先"和"临时缓解优先"，提醒用户优先升级到供应商明确声明已修复该 CVE 的内核。
  • 新增两种自动临时缓解方式：
    • 禁用 algif_aead（参考 copy.fail 官方建议）
    • 禁用 authencesn（参考发行版 workaround 思路）
  • 新增临时缓解回滚入口，便于在完成正式内核修复后撤销持久化模块阻断策略。
  • 保留并复用现有内核同步更新流程，但在交互文案中明确说明"升级到仓库最新内核"不自动等于"已经修复该 CVE"，避免误判风险边界。

升级提醒 ​

  • 该版本重点是安全检测与缓解辅助，不包含 exploit、PoC 或自动化高风险利用逻辑。
  • 若当前内核供应商尚未发布明确修复包，建议先启用临时缓解，再安排维护窗口升级并重启到修复后的内核。

2026年4月27日 - v7.2.0 ​

SSH 连接教程与安装指南更新 ​

  • 新增 SSH 连接教程文档，为新手用户提供从客户端配置到密钥管理的完整指引。
  • 更新安装指南，优化远程安装命令与使用说明。

2026年4月26日 - v7.1.1 ​

UPS 监控修复与集成策略优化 ​

  • 修复 UPS 监控中 Perl 插值问题，避免特殊字符导致前端渲染异常。
  • 优化 UPS 集成策略：将 UPS 服务管理从 apcupsd 切换为基于 NUT 的支持，兼容更多 UPS 品牌与型号（Closes #77）。
  • 新增 UPS 诊断功能，方便在配置异常时快速排查连接与数据上报问题。
  • 兼容 NUT 驱动上报的 ups.realpower.nominal 字段，完善额定功率读取。

升级提醒 ​

  • 若此前使用 apcupsd 管理 UPS，升级后需确认 NUT 配置是否已正确接管；建议进入 UPS 菜单验证数据读取是否正常。

2026年4月15日 - v7.0.1 ​

用户误操作防护与 NUT UPS 支持 ​

  • 修复多处可能导致用户误操作的风险路径，增强输入校验与操作前提示。
  • 将 UPS 服务管理切换为基于 NUT 的实现，优化相关功能与提示信息。
  • 清理调试期间遗留的试删代码，提升脚本稳定性。

2026年4月6日 - v7.0.0 ​

史诗级重构：安全边界、VM 运维、宿主机网络与 GPU 直通能力全面升级 ​

P0 / 最高优先级：数据安全边界与高风险操作防护体系重构 ​

  • 重构高风险数据操作确认链路：为备份、恢复、配置导入导出、模板、克隆、Cloud-Init、迁移、防火墙开关、宿主机网络等关键路径补齐更明确的风险说明与确认词机制。
  • 强化脚本级免责声明与许可提示：首次进入脚本时明确提醒宿主机网络、桥接 / Bond / VLAN、防火墙，以及 VM、磁盘、快照、克隆、恢复、迁移等操作的破坏性后果。
  • 修复多处高风险操作的安全边界问题，重点收紧 VM 定时备份、配置导入、宿主机网络提交、防火墙规则集导入、IPv6 NAT6 等路径的输入校验与回滚兜底。
  • 接入误操作后数据恢复导向内容，强调"立刻停止写入、优先保护现场、必要时联系专业数据恢复"的顺序。

P1 / 高优先级：VM 生命周期运维能力大幅补全 ​

  • 新增 VM 备份与恢复工具链：支持 vzdump 备份、从备份恢复为新 VM、定时备份任务管理，并对压缩方式、模式、目标存储和保留策略做更严格校验。
  • 新增 VM 配置导入 / 导出：支持结构化导出配置，并在导入失败时尽量自动清理半成品 VM 与回滚已重绑磁盘槽位。
  • 新增模板 / 克隆 / Cloud-Init：支持模板转换、完整克隆、链接克隆、cloud image 导入、Cloud-Init 参数写入与模板化交付。
  • 新增虚拟机磁盘管理、快照管理、启动顺序与网络管理、集群内迁移等高频运维路径。
  • 新增 IMG 镜像导入路径与 VM / 容器定时开关机能力，完善日常交付与自动化运维闭环。

P1 / 高优先级：宿主机网络、防火墙、IPv6 与诊断工具箱上线 ​

  • 新增宿主机网络配置向导：支持 bridge、VLAN、Bond、IPv4 / IPv6 / SLAAC / DHCP、PVE 防火墙、安全组、IPv6 助手与网络诊断工具箱。
  • 新增 staged 网络提交流程与失败自动回滚逻辑，降低误改 /etc/network/interfaces 导致 SSH / WebUI 断连的风险。
  • 新增规则集导入 / 导出、安全组维护、防火墙多层级开关，以及 IPv6 透传 / NAT6 场景支持。
  • 补齐 traceroute、mtr、nmap、tcpdump 与端口连通性检查，形成宿主机侧网络诊断全链路。

P1 / 高优先级：GPU / PCI 直通体系补强 ​

  • 新增 NVIDIA 显卡直通 / 虚拟化完整菜单：覆盖 GPU 直通、驱动信息与监控、驱动切换、宿主机预配置和 vGPU Unlock 风险引导。
  • 新增 AMD 独显直通：支持枚举 AMD / ATI GPU、选择 VM、写入 hostpci、附带音频功能直通与 VFIO ids 写入。
  • 新增 AMD 核显直通：提供"需用户自备 ROM / vBIOS"的安全配置向导，仅负责校验 ROM 文件与写入 romfile，不负责自动提取。
  • 保留并继续增强 Intel 核显虚拟化、Intel 核显直通、通用 IOMMU / RDM / NVMe / 控制器直通能力。

P2 / 中优先级：CLI 主交互界面与体验优化 ​

  • 保留原有 show_banner 风格的前提下，重写主菜单一级选项文本，让入口描述更贴近真实功能内容。
  • 主菜单补充 AMD、宿主机网络与防火墙等能力映射，菜单层风险提示更加清晰。
  • Tips 系统改为启动阶段从 v1.hitokoto.cn 获取一条随机一言，并在当前会话中缓存，不再每次返回主菜单都刷新。

P2 / 中优先级：合规、文档与用户引导增强 ​

  • 更新许可协议接受版本与生效日期，要求用户重新确认新的高风险使用边界。
  • 官网新增或补充 VM 备份 / 迁移 / Cloud-Init、宿主机网络 / 防火墙 / IPv6、误操作后数据恢复等专题内容。
  • 持续强化"先备份、再操作、最后验证"的运维顺序提示。

升级提醒 ​

  • v7.0.0 是一次真正意义上的大版本升级。
  • 升级后建议优先检查：主菜单入口、VM 备份 / 恢复、Cloud-Init、宿主机网络 staged 提交、PVE 防火墙导入导出、AMD / NVIDIA / Intel 直通菜单。
  • 高风险功能请始终在已准备备份、已准备回滚方案、且具备控制台或带外管理条件下执行。

2026年4月5日 - v6.9.0 ​

VM 运维工具箱上线，打通备份、模板、Cloud-Init 与迁移流程 ​

  • 新增虚拟机高级运维工具箱：统一收口 VM 备份恢复、配置导入导出、模板 / 克隆 / Cloud-Init、磁盘管理、快照、启动策略、网络管理与集群内迁移入口。
  • 新增定时备份能力：基于 /etc/cron.d/ 幂等管理 vzdump 任务，支持压缩方式、目标存储与 keep-last 保留策略。
  • 新增配置导入 / 导出：导出 qm config 结果为结构化文件，并通过 qm create + qm set 安全重建新 VM，避免直接覆盖集群配置文件。
  • 新增 cloud image 模板流程：支持导入 .img / .raw / .qcow2 云镜像，自动挂载 Cloud-Init 盘并写入 ciuser、ipconfig0、sshkeys、cicustom 等参数。
  • 补齐磁盘 / 快照 / 启动 / 网络与集群迁移流程：支持磁盘扩容 / 迁移、快照回滚、bridge / VLAN 调整与集群内 qm migrate 交互式封装。
  • IMG 导入兼容性增强：镜像导入由固定 raw 假设升级为自动识别源格式，降低 cloud image 与第三方镜像导入失败率。

2026年3月19日 - v6.8.0 ​

第三方市场与 NVIDIA 策略调整，补齐离线与 UPS 体验 ​

  • 新增第三方软件市场（Modules）：脚本可从仓库 Modules 自动发现 .sh 脚本，按头部元信息（name / author / version / github）展示并执行，新增执行前风险确认与下载回退逻辑。
  • NVIDIA vGPU 策略改为"文档引导优先"：移除 vGPU 自动配置流程，保留高风险提醒与人工操作路径；vGPU Unlock 入口改为先全屏警告并引导到 Wiki 文章后再继续。
  • 补充 NVIDIA 专题文档：新增"为何不建议自动化安装 vGPU 驱动"说明，收录第三方研究教程与资源来源声明，降低误配风险。
  • 新增离线模式守卫：启动阶段检测联网状态；若不可达则展示本机 IP / 路由 / DNS 诊断信息，并要求用户明确确认离线继续，离线时自动跳过在线更新与镜像策略。
  • 修复 UPS 服务高频告警问题：温度监控流程加入 apcupsd 服务管理；在不启用 UPS 展示时自动执行 stop + disable，避免持续刷日志与邮件轰炸。
  • 文档站结构更新：导航 / 侧边栏新增"开发计划"入口与相关页面，完善近期演进信息可见性。

2026年3月9日 - v6.7.0 ​

修复温控概览布局并增强 SMART 展示 ​

  • 修复节点概览图表被拉高问题：移除温控功能对右侧 minHeight 的重复补丁，解决硬盘数量较多时 CPU Usage、Memory Usage 等折线图被异常拉高的问题。
  • 重构温控恢复逻辑：恢复 Web UI / 温控文件时改为直接重新安装 pve-manager 与 proxmox-widget-toolkit 官方包，避免多次打补丁后 .bak 文件不再是纯净原版。
  • 增强硬件状态可读性：为 CPU、NVMe、SATA 温度增加颜色显示，新增 NVMe 异常断电指标，并为 SATA SMART 属性 174/192 提供异常断电兜底展示。

2026年2月22日 - v6.6.1 ​

热修复：PVE 9.1.5 误拦截 ​

  • 修复版本识别不稳定：改为直接从 pveversion 输出提取 pve-manager/x.y.z，并保留 dpkg-query 回退
  • 避免误判为非 PVE9：修复部分环境下被错误触发"非 PVE9 风险确认/拦截"的问题

2026年2月22日 - v6.6.0 ​

邮件通知引导与安全防护增强 ​

  • 新增邮件通知自动化引导：配置数据中心 From/root 邮箱、Postfix SMTP 中继（QQ/163/Gmail/自定义）、可选发送测试邮件与 ZFS ZED 邮件参数
  • 新增 IMG 镜像导入：自动扫描指定目录下的 .img，支持转换为 qcow2/raw 并导入到指定虚拟机与存储，可选自动挂载到 VM
  • 增强非 PVE9 使用防护：启动时强制风险确认；并对换源/更新/一键优化/升级等毁灭性自动化操作进行硬拦截
  • 硬盘直通列表增强：新增 ATA: 标识列（显示 ata-* by-id），用于区分 wwn 信息难以对应具体 SN 的硬盘
  • 文档站合规页面优化：TOS 与 ULA 拆分为两个独立页面并加入导航入口
  • CI 发布流程修复：改为 push tag 后自动创建 GitHub Release，并修复 tag 匹配触发条件

2026年2月22日 - v6.5.0 ​

NVIDIA 显卡管理与合规入口 ​

  • 新增 NVIDIA 显卡管理一级菜单：包含显卡直通虚拟机、vGPU 配置与分配、驱动信息与监控、驱动切换与回滚
  • 修复无 NVIDIA GPU 环境的交互错乱：缺少设备时直接提示并返回，避免输出污染与异常报错
  • 新增许可同意界面：首次运行需同意条款（Y/N），条款详情通过文档站链接查看
  • 文档站新增 TOS/ULA：拆分为两个独立页面并加入导航入口

2026年2月22日 - v6.4.0 ​

磁盘/控制器直通与引导辅助 ​

  • 新增 RDM 单盘直通：从 /dev/disk/by-id/ 自动发现可直通整盘，支持 scsi/sata/ide 总线直通，并支持 --delete 取消直通
  • 新增控制器直通：自动扫描 SATA/SCSI/RAID 控制器并展示控制器下磁盘映射，直通前自动检查 IOMMU 状态
  • 关键安全保护：自动识别并拦截包含 PVE 系统盘的控制器直通，降低误操作导致宿主机崩溃的风险
  • 新增 NVMe 直通：识别 NVMe 控制器，并支持按需写入 MSI-X 重定位参数提升兼容性
  • 新增引导配置辅助：识别直通磁盘的 UEFI/Legacy 类型，给出 VM 固件类型、机器类型与启动顺序建议

2026年2月8日 - v6.3.1 ​

驱动黑名单自动清理与文档站视觉增强 ​

  • 新增 i915 及音视频驱动黑名单自动移除功能：在关闭核显直通后自动清理相关模块屏蔽规则，避免「以为恢复了其实仍被屏蔽」的问题。
  • 文档站主题切换新增圆形扩散动画效果，提升交互体验。
  • 更新 README 展示图与主界面截图。

2026年2月7日 - v6.3.0 ​

UI 视觉系统全面进化 ​

  • 重构颜色引擎：实现基于 printf 的 ANSI 变量定义，彻底解决在部分环境下的转义字符乱码问题
  • 视觉风格统一：引入 UI_BORDER、UI_DIVIDER 等常量，确保全脚本菜单边框、标题风格高度一致
  • 交互色彩优化：
    • 针对 核显虚拟化 模块，强化了【危险警告】的视觉冲击力（危险红+警告黄）
    • 优化了 系统信息概览，使用色彩区分不同硬件状态与网络接口
    • 为所有子菜单添加了功能分类高亮（青色标注），提升操作指引清晰度
  • 兼容性增强：针对 PVE 网页控制台（noVNC）进行了色彩降级适配，确保在 16 色模式下不失真、不显示全灰

2026年2月7日 - v6.2.0 ​

新增虚拟机与容器定时开关机管理 ​

  • 新增定时任务管理菜单，支持对虚拟机（qm）和容器（pct）进行自动识别与配置
  • 实现基于 /etc/cron.d/ 的幂等配置管理，支持自定义开关机时间并自动重启服务
  • 文档网站新增脚本下载源切换功能，支持多线路（Cloudflare/GitHub/CDN）选择
  • 优化文档网站视觉效果，为标题及页脚添加渐变色与颗粒感质感

2026年2月6日 - v6.2.0-pre ​

官方文档网站上线与架构重构 ​

  • 推出 官方文档网站（VitePress），包含完整使用指南、功能特性及 FAQ
  • 重构脚本菜单结构，采用更清晰的二级菜单分类
  • 新增配置块安全管理函数，支持带标记的幂等修改
  • 引入 GRUB 参数幂等管理函数，实现对 /etc/default/grub 配置的精准增删
  • 优化核显虚拟化（SR-IOV/GVT-g）配置逻辑，自动处理驱动冲突
  • 在脚本中新增大量"图吧"风格的随机小贴士，提升用户体验
  • 为 Cloudflare Workers 部署添加配置支持

2026年2月3日 ​

优化 iGPU SR-IOV 配置兼容性 ​

  • 优化 iGPU SR-IOV 配置以兼容 PVE 9.1
  • 在 GRUB 参数中添加 module_blacklist=xe，防止 6.8+ 内核中新的 xe 驱动与 i915 驱动冲突

2026年1月20日 - v6.0.1 ​

优化磁盘休眠检测逻辑 ​

  • 在磁盘休眠检测中增加对 SAS 协议的判断，避免对 SAS 盘使用 hdparm 导致误报
  • 更新 star 统计数量至 1K

2026年1月14日 - v6.0.0 ​

重大更新：核显直通自动化与救砖工具 ​

  • 版本号从 5.0.0 升级至 6.0.0
  • 重构主菜单结构，采用二级菜单分类，提升交互体验
  • 新增 Intel 6-14 代核显直通自动化配置功能，支持自动下载 ROM 和修改版 QEMU
  • 新增"应急救砖工具箱"，支持恢复官方 proxmoxlib.js、重置驱动黑名单及还原官方 QEMU
  • 优化 CI/CD 流程，引入 shc 将脚本编译为二进制文件发布
  • 优化日志记录机制，减少控制台冗余输出
  • 优化移除 PVE 订阅弹窗的匹配逻辑，提高对新版本 PVE 的兼容性

2026年1月6日 ​

界面优化与清理 ​

  • 移除菜单和版本信息中的多余空行，保持界面整洁统一

2025年12月15日 ​

UPS监控功能增强 ​

  • 新增从 apcaccess status 中解析 NOMPOWER，展示 UPS 额定功率（W）
  • 根据 NOMPOWER 与 LOADPCT 估算当前功率，并在 UI 中显示
  • 对 STATUS 做中文化映射（ONLINE / ONBATT / CHRG / DISCHRG）
  • 兼容 OUTPUTV / LINEV 两种电压字段
  • 对缺失字段增加默认值，避免异常导致整块 UPS 信息解析失败

2025年12月3-9日 ​

文档与体验优化 ​

  • 清理 README 冗余内容，优化排版
  • 更新项目状态说明，增加维护公告
  • 修复国际网络安装脚本链接，更新快捷命令

2025年11月28日 - v5.0.0 ​

功能优化与社区贡献 ​

  • 修复检查更新耗时过久的问题
  • 优化 UI，删除过于重复和臃肿的 UI 元素
  • 删除部分功能中的颜色代码
  • 新增虚拟机快速安装脚本
  • 修复错误的 CT 模板（社区贡献修复 Ceph 源配置问题）
  • 新增核显显卡直通、显卡虚拟化功能

2025年11月21日 ​

驱动与兼容性修复 ​

  • 修复 AMD 系列 CPU 温度显示出现异常的问题
  • 核显直通部分驱动选择问题修复完成

2025年11月11日 ​

新增核显直通与UPS监控 ​

  • 修复 UPS 监控项目异常，优化无设备情况下的显示逻辑
  • 新增核显直通菜单和功能项
  • 更新展示截图

2025年11月4日 ​

新增UPS信息检测 ​

  • 新增 UPS 信息检测功能（感谢社区代码贡献）
  • 修复温度传感器显示部分模块的问题
  • 修改 README，关闭相关 issue

2025年10月24日 ​

修复CT模板源问题 ​

  • 修复 CT 模板地址错误的问题
  • 修复错误的 CT 源配置

2025年10月23日 ​

用户反馈修复与优化 ​

  • 移除传感器检测项目的可选配置项
  • 修复新增/修改传感器后信息框被遮挡的显示问题
  • 更新小工具来源配置
  • 优化系统稳定性与性能表现

2025年10月17日 - v4.1.0 ​

第三方工具集成与生态扩展 ​

  • 集成 tteck/Proxmox 社区的 13 个实用工具
  • 智能下载管理（curl 优先，进度显示）
  • 安全执行机制（二次确认 + 日志审计）
  • 优化 TUI 颜色显示，保持界面和谐
  • 新增 Tools 目录和完整文档
  • 新增多个辅助脚本：monitor-all.sh、netdata.sh、post-install 脚本等
  • 更新版本号并修复日志输出中的颜色代码问题

2025年10月11日 - v4.0.0 ​

重大重构：UI优化与功能增强 ​

  • 修复颜色代码显示问题，使用 echo -e 替代 printf
  • 简化所有UI边框元素为普通虚线，移除颜色格式化
  • 改进 install_kernel 函数，支持完整包名和版本号两种格式
  • 合并温度监控选项到专用子菜单，合并Ceph相关选项到专用子菜单
  • 实现交互式温度监控菜单系统，支持详细传感器配置
  • 改进 check_update() 函数，支持从VERSION和UPDATE双文件获取更新信息
  • 新增通用下载函数 download_file，替代原有 download_version_file
  • 新增UPDATE文件支持详细更新内容展示
  • 重新编号主菜单选项（1-13），优化交互流程

2025年10月5日 ​

UI交互优化 ​

  • 优化 UI 交互界面操作统一性
  • 替换新的展示截图

2025年9月28日 ​

安全更新与功能扩展 ​

  • 合入PVE安全镜像源，建议尽快升级脚本并且换源
  • 新增 PVE8 一键升级 PVE9 功能
  • 新增未来指南文档和多张功能截图
  • 修复错误的图片引用和贡献者渲染图

2025年9月19日 - v3.x ​

安全镜像源与版本管理 ​

  • 新增镜像源选择功能和版本检查
  • 修复镜像源备份文件的存放位置会被误识别警告的问题
  • 删除不应该存在的更新日志文件
  • 更新版本号文件
  • 添加关于多次拉取文件的警告提示
  • 为版本检查添加网络检测和跳过功能
  • 在横幅中添加版本信息显示
  • 优化脚本输出文案和格式
  • 更新展示截图
  • 合入社区贡献的安全镜像源配置

2025年9月15日 ​

内核管理功能 ​

  • 新增内核切换功能和相关文档
  • 添加 .gitignore 文件
  • 后续优化文档并删除临时文件

2025年9月11日 ​

清理遗留问题 ​

  • 移除遗漏的emoji字符

2025年9月9日 - v2.x ​

功能爆发期：多模块新增 ​

  • 新增硬件直通配置（开启/关闭）
  • 新增 CPU 电源模式管理（performance、powersave 等）
  • 新增 CPU 与硬盘温度监控
  • 新增 Ceph 存储支持（ceph-squid、ceph-quincy）
  • 新增 Ceph 卸载功能
  • 新增调试模式支持，使用 --debug 标志跳过 PVE 检测
  • 去除无法显示的Emoji，修复逻辑问题
  • 优化日志函数输出格式
  • 新增英文文档 README-EN.md
  • 更新README添加快速开始指南和提交历史徽章
  • 扩展主菜单，新增选项 8-14

2025年9月1-2日 - v1.x ​

项目创建与基础功能 ​

  • 初始提交：LICENSE、README.md、PVE-Tools.sh
  • 持续优化 README.md，修复字符画显示问题
  • 修复遗漏特别鸣谢问题
  • 修复脚本中的小问题