fanhuadesenlinnn/PVE-Tools-9

Fork 0

mirror of https://hubproxy.babadafafafafa.cn/https://github.com/Mapleawaa/PVE-Tools-9.git synced 2026-09-20 08:03:35 +08:00

Files

Maple 886e82f0cb refactor: 模块化重构 — 拆分 lib/ 基础设施层与 src/modules/ 功能模块

PVE-Tools.sh 从 ~14,700 行单文件重构为 150 行入口点，
所有函数按职责拆分到独立文件，通过 source 机制加载。

lib/ — 基础设施层（零业务逻辑）
  config.sh: 全局变量与常量
  core.sh: 日志、UI、确认、备份、GRUB、进度条
  network.sh: 网络检测、镜像选择
  runtime.sh: 运行时守卫、main() 入口

src/modules/ — 功能模块（10 个目录）
  01-optimization  02-sources  03-boot-kernel
  04-gpu-passthrough  05-vm-container  06-networking
  07-storage-disk  08-tools-about  09-security  10-third-party

新增 build.sh（合并编译）和 dev.sh（开发 source 入口），
release.yml 新增构建步骤，CI 适配模块化结构。

2026-07-08 11:15:59 +08:00

3.8 KiB

Raw Blame History

根目录 > Modules

Modules -- 第三方插件市场与模块

模块职责

提供 PVE Tools Pro 的第三方插件/模块市场。主脚本通过 GitHub API 自动扫描本目录中的 .sh 脚本，根据脚本头部元信息（name/author/version/github）展示并允许用户选择执行。同时存放附加二进制资源（如 NVIDIA vGPU Unlock .so 文件）。

入口与启动

项目	说明
发现机制	主脚本通过 GitHub API 获取 `Modules/` 树结构，自动发现 `.sh` 文件
元信息格式	脚本第 2-5 行必须包含 `## name:`、`## author:`、`## version:`、`## github:` 注释
执行入口	用户在主菜单的"第三方工具集"中选择对应插件执行
下载方式	从 `https://raw.githubusercontent.com/PVE-Tools/PVE-Tools-9/main/Modules/<name>.sh` 下载

插件元信息模板

#!/bin/bash
## name:插件名称
## author:作者名
## version:1.0.0
## github:https://github.com/xxx/xxx

当前模块清单

文件	类型	说明
`install-zsh.sh`	Bash 脚本	ZSH 安装脚本 v3.0 (by Maple)，自动安装 oh-my-zsh 并配置
`VGPU/libvgpu_unlock_rs_20230207_44d5bb3.so`	二进制 (.so)	NVIDIA vGPU Unlock 补丁库，用于解锁消费级 GPU 的 vGPU 功能

install-zsh.sh 概述

作者: Maple
版本: 3.0
功能: 在 Debian 系系统上自动安装 ZSH + oh-my-zsh
流程: 环境预检(检查是否为 Debian) -> 网络诊断与镜像选择 -> 安装 ZSH -> 安装 oh-my-zsh -> 配置主题和插件
特点: 支持检测 GitHub 连通性并自动切换镜像源

VGPU/libvgpu_unlock_rs.so

来源: 基于 Rust 重写的 vgpu_unlock 项目（第三方开源项目）
用途: 用作 NVIDIA vGPU 破解的共享库
大小: 较大二进制文件，仅记录路径不读取内容
风险: 主脚本对此功能采用"文档引导优先"策略，先全屏警告并引导到 Wiki 文章后再继续

关键依赖与配置

依赖	说明
GitHub API	主脚本通过 `GET /repos/PVE-Tools/PVE-Tools-9/git/trees/main?recursive=1` 发现模块
raw.githubusercontent.com	模块脚本的下载源
主脚本配置变量	`THIRD_PARTY_MODULES_TREE_API_MAIN_URL`、`THIRD_PARTY_MODULES_RAW_BASE_URL`

数据模型

插件元信息数据结构（从脚本头部注释解析）:

name: string      # 插件名称
author: string    # 作者名
version: string   # 版本号
github: string    # GitHub 项目地址

测试与质量

插件审核: 通过 GitHub PR 或 Issue Template 提交，由维护者人工审核
执行前风险确认: 主脚本在执行任何第三方模块前强制要求用户确认
无自动化测试: 模块为第三方贡献，无 CI 覆盖

常见问题 (FAQ)

Q: 如何提交新插件？ 两种方式：

Fork 仓库 -> 添加 .sh 到 Modules/ -> 提交 PR（推荐）
在 GitHub Issues 选择"插件提交"模板，填写元信息和脚本内容

Q: 插件需要遵守什么规范？

文件名以 .sh 结尾
第 2-5 行包含元信息（name/author/version/github）
高风险操作必须在脚本中给出交互确认

Q: VGPU 模块如何工作？ 主脚本不再自动执行 vGPU 配置。用户通过主菜单进入后，会先看到全屏警告和 Wiki 链接，确认后手动操作。.so 文件作为可选资源供高级用户使用。

变更记录 (Changelog)

日期	变更
2026-07-08	更新：项目模块化后 Modules 目录无变化，install-zsh.sh 和 VGPU 状态不变
2026-04-28	初始化 Modules 模块 CLAUDE.md

3.8 KiB Raw Blame History Unescape Escape