- deb822 文档规定注释以首列
#开头,不应把缩进后的#行直接当作注释保留。禁用企业源时,仅保留首列#行,其余行加一个首列#,保留原文并保持幂等。此次 APT 3.0.3 / 3.0.4 实测接受了原缩进示例,未复现审查声称的解析错误;回归测试同时验证规范输出和真实 APT 解析,不能把前者的失败说成后者报错。 - 不要把源操作的取消和失败混用。
select_mirror、change_sources、quick_setup:0完成,1失败,2取消。镜像跳过、镜像输入结束、拒绝写入确认都必须在写源前停止;一键优化不能继续删除弹窗或更新系统。 - 菜单分发器:
0已处理,1无效输入,2操作失败,3操作取消。run_menu对取消不报错;之前的失败仍须在退出时返回2。不要把动作的取消码2直接传给菜单框架。 - Bash 在条件调用中会抑制函数内的
set -e。失败和取消必须显式返回;测试应通过真实分发器和完整菜单输入验证,不能仅依赖叶函数或set -e。
验证命令(Linux、GNU sed、真实 APT):
bash tests/sources-enterprise-test.sh
bash tests/sources-cancellation-test.sh
bash tests/menu-action-status-test.sh
bash build.sh
bash -n dist/PVE-Tools.sh测试把 APT 源、CT 模板路径和备份重定向到临时目录;APT 使用 --print-uris update,不下载索引。不要直接执行 change_sources、quick_setup 或启动真实运维入口来测试。
macOS 的 BSD sed -i 不兼容源码;企业源测试应在隔离 Linux 环境运行。此修复不新增依赖、后台任务或网络请求,企业源仍只执行一次线性扫描。
cpu_add的 NUT 采集目标由<设备名>@localhost改为<设备名>@<服务器地址>;交互新增地址输入,默认localhost,空回车走默认值,非法输入回退localhost并给出提示。- 地址支持主机名、IPv4、
[IPv6]与可选:端口。依据 NUT 源码upscli_splitaddr:方括号用于区分 IPv6 与端口(如[1234:5678]:3493),内部解析缓冲为 256 字节,因此校验同时限制字符集与长度(≤255)。 - 该校验同时承担防注入职责:目标地址会拼进生成的 Perl 采集片段(
UPS_TARGET="..."),只放行A-Za-z0-9._:-与方括号。 - 远程地址仅在非回环时提示检查
upsd.conf的LISTEN/ACL;脚本仍不启停 NUT、不改ups.conf。 - 回归:
bash tests/ups-config-test.sh(52 项纯逻辑,含源码级断言「不再硬编码 localhost」)。
验证命令:
bash tests/ups-config-test.sh
bash build.sh && bash -n dist/PVE-Tools.shnut_ups_is_ipv6校验方括号内的内容:允许一次::压缩与末尾内嵌 IPv4,拒绝[:]、组数越界、组超长等写法;非法值走原有的回退localhost路径,不进入 UPS 采集。nut_ups_is_loopback_host按127.0.0.0/8判定回环(含:端口):Debian 默认把主机名解析到127.0.1.1,此前会被误判为远程地址并提示检查upsd.conf的LISTEN/ACL。localhost、127.0.0.1、[::1]行为不变。change_sources覆盖/etc/apt/sources.list.d/pve-no-subscription.sources前先backup_file,备份失败即sources_write_error并返回1,不再无提示覆盖用户自建配置。- 回归:
bash tests/ups-config-test.sh(64 项)、bash tests/sources-write-failure-test.sh(12 项,新增免订阅源备份失败注入)。