v3.0.1-alpha.104

[Version: v3.0.1-alpha.104] - 2026-11-02

Full Changelog: v3.0.1-alpha.103...v3.0.1-alpha.104

重要提示

• Helm 部署的 Application、Backend、File 日志目录统一使用 common.logPath，默认值由 /bk-nodemgr/logs 改为 /bk-nodemgr/log；各组件 config.log.dir 不再生效。自定义日志目录的环境需将配置迁移至 common.logPath，并同步调整挂载及外部采集路径。
• ensure_absent=true 的部署策略不再按正向部署处理；反向清理尚未实现，包含 spec 的反向策略在执行或预览计算时返回错误，同次计算中的相关正向策略也不会继续。升级前检查已启用策略；需要正向部署时将该字段恢复为 false，不要将其用于卸载或删除配置。
• 自定义安装/升级脚本需调整：adminclient 的 bkapp code/secret 必须携带凭证名 iamv3、iamv4 或 apigw-sync；init_package.py 移除 --jwt-key、--expire-hours，改由 adminclient 按 File 配置签发有效期固定为 24 小时的 JWT。独立 jwt-generator 不再提供。
• 存量 process_config_<tenantID> 集合的旧三字段唯一索引不会自动删除，仍会阻止同名主子配置共存。使用该能力前，需备份数据、确认四字段唯一索引（含 data.is_main_config）建立成功，再移除对应旧三字段唯一索引；已有同名主子记录时，不能直接恢复旧唯一索引或依赖旧版按名称处理配置。

发布范围

• Backend/Control Plane：部署策略方向处理、插件部署准备查询、同名主子配置区分。
• File：V3、旧版 V2 及 V2 外部插件包的配置模板重名校验，V3/旧版 V2 发布包自定义文件保留。
• Application：Web/SaaS 请求 ID 处理；Backend：Proxy 安装主机查询。
• Installer/Deployment：Helm 日志目录统一及可选蓝鲸日志采集配置、adminclient 凭证解析、初始化包导入和 IAM/API Gateway 同步。
• Frontend：Agent/Proxy 带外管理当前设置回显、主控机选择与分页。

新增功能

• Helm 新增 bkLogConfig.enabled，默认关闭；启用后创建标准输出和容器文件日志两类 BkLogConfig，采集带时间戳的 System/Business INFO 日志文件。

功能优化

• 生成 V3 和旧版 V2 插件发布包时，保留对应平台插件目录内的自定义普通文件、相对路径和源文件权限，支持随包携带依赖库及辅助资源。
• 插件部署准备阶段批量读取主机和插件，并在单次请求内去重默认版本及资源包发布信息查询，减少批量部署中的重复查询。
• Agent/Proxy 带外管理表格加载当前设置，回显主控机 IP 和选择状态，并保留已有自定义带外协议。
• adminclient 的 JWT 签发和应用凭证读取同时支持 KMS 与明文部署，初始化包导入及 Helm 同步 Job 统一使用该入口；服务配置自动发现同时支持 Helm 的 *_conf.yaml 和 Docker Compose 的 bk-nodemgr-*.yml。

缺陷修复

• 修复 Application Web/SaaS 请求 ID 处理：读取 X-Request-Id，缺失时生成请求 ID，便于关联请求日志。
• 修复 Proxy 安装中目标主机 ID 集合为空时仍查询已有主机的问题，避免空条件引发无关主机查询。
• 修复切换顶部业务后主控机选择器拓扑未刷新的问题；IP 选择器默认每页条数固定为 10。
• 修复 ensure_absent=true 仍进入正向部署计算的问题，改为明确拒绝尚未实现的反向操作。
• 修复同名主配置与子配置在模板匹配、部署记录更新及策略计算中相互覆盖的问题；删除子配置时仅匹配子配置文件和记录，避免影响同名主配置。

Agent / Plugin / Package compatibility

• 本版本不涉及 Agent 安装器、插件包格式或资源包版本要求变更。
• 自定义文件保留仅作用于新生成的 V3/旧版 V2 发布包，不回填已有发布包，也不扩展 V2 外部插件打包流程。仅复制普通文件，不保留符号链接、硬链接或空目录；V3 的 definition.yaml、templates/*.template 和 V2 的 project.yaml、etc/*.tpl 不作为自定义文件复制，标准文件仍按原规则处理。
• 自定义文件不得与生成包中的标准文件或 bintool 文件重名；打包不会统一检查目标路径冲突。新增复制路径会拒绝绝对路径及不合法路径片段，但不校验自定义文件内容；发布前需核对来源、内容、权限和目标路径。
• 同一平台内允许主配置与子配置模板同名，但同一类型内模板名重复的 V3、旧版 V2 及 V2 外部插件包导入将被拒绝，需修正重复声明后重新导入。
• 配置记录沿用已有 is_main_config 字段，不会自动修复此前已被覆盖的内容或回填缺失的主子标记；存量异常记录需按实际主子归属核对修复后再执行配置操作。

组件依赖与升级前置条件

• 安装文档补充服务运行模式迁移说明：旧配置中的 Application、Backend、File 服务级 mode 需改为 runMode（Helm 使用 <service>.config.runMode），生产环境使用 release；旧键不能设置服务运行模式。此说明不涉及第三方组件的其他 mode 字段。
• Frontend 的当前设置回显依赖已有 Agent/Proxy 带外字段查询接口；配套 Backend/Application 至少使用 v3.0.1-alpha.103 中提供该接口的版本。
• 启用 bkLogConfig.enabled 前，需安装支持 bk.tencent.com/v1alpha1 的 BkLogConfig CRD 和对应日志采集服务，并将 bkLogConfig.dataId 设置为目标采集 Data ID；不使用该能力时保持关闭。
• 启用 JWT 鉴权的初始化包导入及 Helm IAM/API Gateway 同步需配套提供新版 bk-nodemgr-adminclient 的镜像；手工导入时需可执行该二进制并提供 File 配置，非标准配置文件名使用 --config-file 显式指定。
• KMS 模式下，凭证解析需可读的 global envelope 和 BK_NODEMGR_KMS_PRIVATE_KEY_GLOBAL，解密失败不会回退到明文。明文模式下，JWT 鉴权需配置非空的 <server>Server.jwtServerConfig.symmetricKey；IAM 同步凭证来自 Backend 的 iamV3/iamV4.appCode/appSecret，API Gateway 同步凭证来自 Job 环境变量 BK_APP_CODE、BK_APP_SECRET（通过 apigwSync.extraEnvVars 注入）。

已知问题

• 带外设置回显查询失败时，表格仍可展示和提交，但当前设置可能为空；跨页全选的主机查询中断时，仅展示已加载的主机。提交前核对设置和主机范围，异常时重新加载，避免将空字段覆盖到现有配置或遗漏目标主机。

v3.0.1-alpha.103

Full Changelog: [v3.0.1-alpha.102...v3.0.1-alpha.103](https://github.…

v3.0.1-alpha.102

[Version: v3.0.1-alpha.102] - 2026-10-27

Full Changelog: v3.0.1-alpha.101...v3.0.1-alpha.102

重要提示

• 导入插件包时，配置模板的 filePath 必须为固定目录：主配置为 etc，子配置为 etc/<plugin_name>；不一致的插件包将被拒绝导入。升级前请检查待导入插件包的 definition.yaml（V3）或 project.yaml（V2）。
• 下载 Agent、Proxy、插件、证书和 bin tool 安装包前，需具备对应包的 package_view 权限；backend 鉴权服务不可用时，下载请求会失败。

发布范围

• Backend/Control Plane：新增 V2 插件安装限速配置、配置策略事件快照一致性修复、包下载权限检查和 APIGW 请求 ID 修正。
• Plugin/Package：V2 插件包支持声明安装 CPU/磁盘 IO 限速；插件配置模板路径固定；上传结果展示限速配置。
• Installer/Deployment：Installer 在 Windows 全量安装前可配置 firewall，并在解压 V2 插件包时应用限速；APIGW 同步支持可选的拓扑查询 MCP Server。
• Frontend：优化带外管理设置，新增带外协议选项配置。

新增功能

• V2 插件 project.yaml 可选配置 install_cpu_limit（0 到 1）和 install_disk_io_limit（MB/s），用于限制安装或升级过程中处理 tgz 包的速度。未配置或设为 0 时不限速；install_cpu_limit 为 1 同样表示不限速。
• Installer 全量安装新增 --firewall_features、--firewall_remote_ips 参数：在 Windows 上，安装前按所选 features（gse、nodemgr）和允许的 CIDR 配置 firewall 规则；非 Windows 系统跳过该步骤。设置 features 时必须同时设置 CIDR。
• 包上传结果页展示插件包声明的安装 CPU/磁盘 IO 限速；插件发布查询响应保留这些限速信息。
• 带外管理设置页支持配置带外设备类型、协议、IP 和端口，并为各字段提供填写说明；协议选项由 Helm application.config.front.opsOutBandProtocols 提供（JSON 编码的协议列表，默认 []）。
• API Gateway 同步支持发布节点管理拓扑只读查询 MCP Server topo（业务拓扑、网络区域、网络单元、接入点、图节点和主机查询，不含创建、修改、删除操作）。该能力由 apigw-sync 的 ENABLE_SYNC_MCP_SERVERS 控制，默认 false。

功能优化

• Plugin、Plugin V2 和 Package 的 workflow action 失败重试改为带抖动的退避等待；超时和重试次数不变，失败动作的后续重试和最终失败返回可能等待更久。
• V3 插件模板可通过 PluginInfo.SubConfigPath 获取插件子配置目录（<PluginHomeDir>/etc/<plugin_name>）。
• 优化带外管理页面的设备下拉选择，协议名称不再显示端口后缀。
• apigw-sync 镜像基础镜像升级为 apigw-manager:4.2.4；Helm 中 apigwSync.config 使用 spec_version: 2。

缺陷修复

• 修复配置策略的创建、更新、删除、启用、禁用和调整优先级操作记录的事件快照：事件使用操作时的原子快照，批量操作部分成功后出错时，已成功的变更仍被记录。
• 修复 APIGW 请求 ID 请求头混用问题：服务端读取网关生成的 X-Bkapi-Request-Id，客户端向网关发送业务 X-Request-Id。
• 修复插件可见业务范围查询未包含 visible_biz_ids 为空的插件的问题。
• 修复旧版 V2 插件安装、升级解包未应用 CPU、磁盘 IO 限速的问题。

Agent / Plugin / Package compatibility

• V2 插件包的 install_cpu_limit 取值须在 0 到 1 之间，install_disk_io_limit 须为非负数；非法取值会导致插件包导入失败。
• V2 插件包导入校验配置模板路径：主配置 filePath 为 etc，子配置为 etc/<plugin_name>；V3 与外部插件包同样适用该规则。
• 插件安装 / 升级仅在限速值生效（install_cpu_limit 大于 0 且小于 1，或 install_disk_io_limit 大于 0）时才向 Installer 传递对应参数；未配置限速的插件包行为不变。
• 包下载接口的请求与成功响应字段不变；调用方须具备对应包的 package_view 权限。

组件依赖与升级前置条件

• 使用 V2 插件安装限速时，目标主机上的 Installer 须升级到本版本，以支持 --cpu-limit、--diskio-limit 并在解压时应用限速。
• 使用 Windows firewall 配置时，Installer 须升级到本版本，以支持 --firewall_features、--firewall_remote_ips；请先确认 features 与 CIDR 符合预期，单个 IPv4/IPv6 地址分别使用 /32 或 /128 表示。
• 升级前确认下载安装包的操作人员和调用方具备对应 package 资源的 package_view 权限。
• 启用拓扑 MCP Server 同步需同时升级 chart 与 apigw-sync 镜像，并将 ENABLE_SYNC_MCP_SERVERS 设为 true。
• 使用带外协议选项时，需在 Helm application.config.front.opsOutBandProtocols 中配置协议列表；未配置时协议选项为空。

v3.0.1-alpha.101

[Version: v3.0.1-alpha.101] - 2026-10-21

Full Changelog: v3.0.1-alpha.100...v3.0.1-alpha.101

发布范围

• Backend/Control Plane：支持 Windows firewall 部署配置、旧版 V2 插件冲突检查，以及 Node workflow 并发限制和重试退避。
• Plugin/Package：V3 插件包支持声明安装过程的磁盘 IO 限速；包上传和发布增加服务端权限前置检查。
• Installer/Deployment：Windows Agent 安装前可按配置应用 firewall 规则；Installer 支持安装包磁盘 IO 限速；KMS 部署的 IAM/API Gateway 同步 Job 从加密配置获取应用凭证。
• Topology：优化拓扑操作记录筛选与操作人信息。

新增功能

• V3 插件 project.yaml 可选配置 installDiskIoLimit（MB/s），用于限制安装或升级过程中处理 tgz 包的逻辑读写速度。未配置或设为 0 时不限速；V2 插件包忽略该字段。
• 插件安装 API 可选择启用旧版 V2 插件运行状态检查。对于声明存在旧版冲突的 V3 插件包，若目标主机上同名 V2 插件正在运行，安装会被阻止；启用该检查时，需先停止冲突的 V2 插件。
• Windows Agent 部署可配置 gse、nodemgr firewall features 及允许访问的 CIDR。features 为空时不管理 firewall 规则；单个 IPv4/IPv6 地址分别使用 /32 或 /128 CIDR 表示。
• Node 安装、升级、重配、重启、卸载、分配 Proxy Unit 六类 workflow 支持独立 Global Settings oper_node_<operation>_max_concurrency_num，operation 分别为 install、upgrade、reconfig、restart、uninstall、assign_proxy_unit，默认值均为 200，且须为正整数。并发限制按单个 trigger 生效，不限制多个 workflow 的合计并发。
• adminclient 新增 bkapp code、bkapp secret 子命令，从 KMS global envelope 获取应用凭证，供 Helm 的 IAM V3/V4、API Gateway 同步 Job 使用；非 KMS 部署继续使用原有凭证配置。

功能优化

• Topology 操作记录支持按管控区域、管控单元、类型和操作人筛选，并优化操作人展示及筛选后的分页行为。
• Node Action 失败重试由固定延迟改为指数退避并附加随机抖动；超时和重试次数不变，部分失败动作的后续重试及最终失败返回可能等待更久。
• 合并 ORM 和 workflow 操作实例数据的字段写入，并合并同名全局配置的并发读取，减少重复存储请求。

缺陷修复

• 修复 Windows SSH 安装失败时底层错误原因丢失、下载服务器配置错误信息标签不正确、deploy policy scope type 错误信息不正确，以及网络区域 ID 无效时错误返回不正确等问题。
• 修复拓扑操作记录的操作人记录不准确问题。
• 包上传和发布入口在解析请求和执行文件操作前检查对应包类型的 package_type_upload 权限，未通过鉴权时终止操作。
• 修复 Agent/Proxy 运维信息更新因已有主机的节点角色不匹配而被拒绝的问题；保留主机存在性校验和业务操作鉴权。
• 修复非法 tracing exporter 类型被误报为缺少类型的问题，保留底层校验错误，便于定位启动配置问题。

Agent / Plugin / Package compatibility

• installDiskIoLimit 为可选配置；未配置或设为 0 时维持不限速行为，旧版 V2 插件包不使用该配置。
• 只有在 V3 插件包设置正数 installDiskIoLimit 并生成带 --diskio-limit 的安装/升级脚本时，执行该脚本的 Installer 才需要支持此参数；否则不要求为该配置升级 Installer。
• 管控单元未设置 firewall 时继承部署默认配置；显式设置空对象 {} 时禁用 firewall setup。有效配置启用后，规则按所选 features 及允许的 CIDR 应用。
• Node 并发配置在创建 trigger 时固定，修改只影响后续创建的 trigger；重试沿用原 trigger。
• 包上传、发布的请求与成功响应字段不变；此前未被权限检查阻止的请求现在须通过对应包类型鉴权。

组件依赖与升级前置条件

• 对启用了 V2 插件冲突检查且命中冲突的主机，安装前须停止正在运行的同名旧版 V2 插件。
• 使用 installDiskIoLimit 时，部署环境中的 Installer 需支持 --diskio-limit；数值须为非负 MB/s，负值或非数值会导致插件包导入校验失败。
• Windows firewall 规则由 Installer 在安装前应用；请先确认部署配置中的 features 与 CIDR 符合预期。未设置 features 时不会管理 firewall 规则。
• 升级前确认包上传、发布操作人员具有对应 package_type 资源的 package_type_upload 权限；backend 鉴权服务不可用时，这些操作将终止。
• KMS 部署需同时升级 chart 与相关镜像，确保同步 Job 使用的镜像包含 bk-nodemgr-adminclient bkapp。启用 KMS 的同步 Job 要求 backend.enabled: true，可读取 KMS global envelope，并通过 BK_NODEMGR_KMS_PRIVATE_KEY_GLOBAL 注入私钥；Helm 从 global KMS Secret 的 privateKey 获取该值。

v3.0.1-alpha.100

[Version: v3.0.1-alpha.100] - 2026-10-20

Full Changelog: v3.0.1-alpha.99...v3.0.1-alpha.100

发布范围

• Backend/Control Plane：插件安装和其他 V3 插件操作 workflow 支持并发限流；新增对应 Global Settings；KMS TLS 配置加载与校验调整。
• File Service：导入和发布前校验包结构；V3 插件 project.yaml 支持 installCpuLimit。
• Installer：新增 --cpu-limit 参数；增加 trace 关联。
• Deployment：Helm init container 改为通过 bk-nodemgr-adminclient database check 检查存储；adminclient 新增 database 子命令。
• Relay Plugin：暴露 APM tracing 配置。
• Frontend：优化权限申请、菜单权限校验和任务历史时间筛选。

新增功能

• 插件 V3 project.yaml 新增 installCpuLimit，用于控制 installer 在插件 install/upgrade 时处理 tgz 包的 CPU 比例。仅当取值满足 0 < installCpuLimit < 1 时，Backend 才会在生成的 install/upgrade 脚本中注入 --cpu-limit；未配置、0 或 1 时行为不变；V2 插件包忽略该字段。
• installer 新增全局参数 --cpu-limit，用于限制 Agent/Plugin tgz 压缩、解压过程中的 CPU 占用，降低单核机器或 cgroup 受限容器被占满的风险。该参数不限制磁盘 IO，不覆盖 pluginv2 子命令。
• installer 启动时生成 root trace 并打印 trace-id，对外 HTTP 请求注入 W3C traceparent，便于与服务端日志和 APM 关联。installer 不主动上报 span 数据。
• 新增 Global Setting oper_plugin_install_max_concurrency_num，默认值 200。每个插件安装 workflow 按该值限制自身并发数，不同 workflow 之间不共享限流。该限流仅适用于 v3 插件安装路径。
• V3 插件的 upgrade、uninstall、apply/remove sub config、start/restart/stop process、migrate from v2 和 start debug 操作改用 ordered trigger，并分别使用 oper_plugin_<operation>_max_concurrency_num 控制单个 workflow 的最大并发数，默认值均为 200。并发数在创建 workflow 时固定，修改 setting 只影响后续创建的 workflow；Plugin V2、node 和 package 导入操作不在本次范围内。
• adminclient 新增 database 子命令，支持 etcd、Redis、MongoDB 的连通性检查与连接，adminclient 配置支持从 KMS 获取。运维脚本 script_tools/ops/{etcd,mongo,redis}.sh 改为通过该子命令连接存储。
• relay 插件配置新增 APM tracing 选项：exporter 类型、OTLP endpoint、protocol、insecure、headers、service name 和 trace sample rate。未配置时保持原有行为。

功能优化

• File Service 在导入和发布 Agent、Server、Plugin、bintool、plugin_bintool 与证书包前校验包结构：拒绝空包、缺少必需文件、未知平台以及已提供平台内容不完整的包；证书包要求八个文件齐全、非空且位于根目录或 cert/。plugin_bintool 仅发布实际提供的代际。
• Helm 部署中 backend、application、file 的存储 init container 改为通过 bk-nodemgr-adminclient database check 检查 etcd 与 MongoDB，持续重试直至存储就绪，避免首次安装时因存储启动较慢出现 Init:CrashLoopBackOff。
• 调整 TLS 文件加载行为；非 enabled 的 TLS 配置不再参与转换与校验。
• 前端优化：申请管控单元权限时关联资源实例描述；左侧菜单与业务关联的权限校验；拓扑图中管控单元权限申请；任务历史按时间筛选。
• 前端、安装镜像 Dockerfile 声明 # syntax=docker/dockerfile:1，避免不同构建环境默认 parser 不一致导致构建失败。

Agent / Plugin / Package compatibility

• 本版本不修改 Agent、Plugin 或 Package 格式；installCpuLimit 为 V3 插件 project.yaml 的可选字段。
• 包结构校验可能拒绝此前可导入但结构不完整的包，请在导入前确认包内容完整。
• 本版本不修改 API Gateway 资源定义。

组件依赖与升级前置条件

• Helm 部署的 init container 依赖镜像内的 bk-nodemgr-adminclient，请同时升级各模块镜像与 chart。
• --cpu-limit 需使用本版本 installer；旧版 installer 不识别该参数。

v3.0.1-alpha.99

[Version: v3.0.1-alpha.99] - 2026-10-19

Full Changelog: v3.0.1-alpha.98...v3.0.1-alpha.99

发布范围

• Backend/Control Plane：插件安装接口支持不传插件版本并安装默认版本；插件 Jinja2 系统配置中的多租户标识改为以字符串渲染。

新增功能

• 插件安装接口 /api/v3/plugin/install 的 plugin 列表项中，version 字段改为可选。未传入时，安装与目标主机 Agent generation、操作系统和 CPU 架构匹配的插件包默认版本。

缺陷修复

• 修复插件配置文件 Jinja2 系统配置中的多租户标识以布尔值渲染的问题，现统一以字符串 "true" 或 "false" 渲染。

Agent / Plugin / Package compatibility

• 本版本不修改 Agent、Plugin 或 Package 格式。
• 插件安装接口对已指定 version 的请求保持兼容，行为不变。
• 在 Jinja2 中引用多租户标识的插件配置模板，现获得字符串值（"true" 或 "false"），不再是布尔值。

v3.0.1-alpha.98

[Version: v3.0.1-alpha.98] - 2026-10-16

Full Changelog: v3.0.1-alpha.97...v3.0.1-alpha.98

发布范围

• Backend/Control Plane：新增共享插件包导入能力，支持通过 KMS 解密配置中的凭据，并修复预排序插件安装失败结果的返回问题。
• Frontend：优化 Agent 列表的搜索值校验提示及公告条出现时的用户信息面板位置。
• Operations/Deployment：Helm chart 新增基于 External Secrets Operator（ESO）的 KMS 凭据集成配置。

新增功能

• 插件包导入接口 /api/v3/package/workflow/import/v3/plugin、/api/v3/package/workflow/import/v2/plugin、/api/v3/package/workflow/import/v2/external_plugin 新增可选请求参数 is_shared，用于将导入的包发布为共享包；仅 system 租户请求生效，其他租户忽略该参数。
• 服务启动时支持通过 KMS 解密凭据信封，并覆盖相关凭据配置项。
• Helm chart 新增 kms 配置，启用后通过 ESO 为全局及 application、backend、file 模块拉取 KMS 凭据，私钥以环境变量注入，凭据信封以文件挂载。

功能优化

• Agent 列表搜索时，对未匹配任何搜索条件项的输入给出提示并移除该输入项；对不符合 IP 格式的 ip、area_ip 搜索值给出提示。
• 公告条显示时，用户信息面板随导航整体下移。

缺陷修复

• 修复预排序插件安装动作失败结果未正确返回的问题。

Agent / Plugin / Package compatibility

• 本版本不修改 Agent、Plugin 或 Package 包格式。
• 导入接口新增的 is_shared 为可选参数，未传入时保持原有行为。

组件依赖与升级前置条件

• kms.enabled 默认为 false；启用 KMS 凭据集成需要集群已部署 External Secrets Operator，并按实际 KMS 注册结果配置 kms.server 及各模块的 path、role、credential。

v3.0.1-alpha.97

[Version: v3.0.1-alpha.97] - 2026-10-14

Full Changelog: v3.0.1-alpha.96...v3.0.1-alpha.97

发布范围

• Backend/Control Plane：新增部署策略只读预览，并支持按指定顺序预览配置策略。
• Frontend：新增和优化配置策略排序预览及相关策略管理体验。
• Operations/Deployment：调整包上传后的 Package 权限授予，并统一 Helm workload 的 ServiceAccount 配置。

新增功能

• 新增 POST /api/v3/deploy_policy/preview 只读接口，可预览已启用部署策略的计算状态，不执行变更。
• 配置策略预览支持通过启用策略 ID 顺序控制冲突优先级。
• 新增未分配管控区域 ID 配置，默认值为 -1。

功能优化

• 优化 Agent、Plugin 配置策略排序和预览行为。
• 优化部署策略计算及目标状态预览。
• 在 IAM V4 模式下，Package 上传成功后为上传者授予对应 Package 的管理权限。
• Helm chart 为各服务和同步 Job 统一设置 serviceAccountName，并支持通过 serviceAccount 配置指定账号和注解。

缺陷修复

• 修复配置策略预览和列表接口的错误处理问题。
• 修复预排序插件的 compatibility mode 传递问题。
• 修复配置策略优先级重排时的事件详情记录问题。
• 修复 Agent 和 Proxy 安装预览数据清空后，执行安装按钮仍可用的问题。

Agent / Plugin / Package compatibility

• 本版本不修改 Agent、Plugin 或 Package 包格式。

组件依赖与升级前置条件

• Helm chart 的 serviceAccount.create 默认值由 true 改为 false；未指定 serviceAccount.name 时，Workload 默认使用 Kubernetes 的 default ServiceAccount。需要继续使用专用 ServiceAccount 的环境，应在升级时显式设置 serviceAccount.create: true，或配置已有的 serviceAccount.name，并保留所需权限。
• Package 上传后的管理权限授予失败不会回滚已完成的上传；使用 IAM V4 时请确认对应角色授予能力可用。

v3.0.1-alpha.96

[Version: v3.0.1-alpha.96] - 2026-10-12

Full Changelog: v3.0.1-alpha.95...v3.0.1-alpha.96

发布范围

• Backend/Control Plane: 扩展节点卸载和拓扑主机统计 API 的请求参数。
• Frontend: 统一 Agent 和 Proxy 统计与筛选条件中的状态文案。
• Operations: 更新 release verification 和 source archive signing 说明。
• CLI: 新增部分运维流程的 manual CLI 支持。
• Installer: 为服务端和工具安装器新增显式 HTTP proxy 覆盖与跳过支持。

新增功能

• 节点 Agent 或 Proxy 卸载成功后，支持解绑主机 AgentID 关系。
• 业务主机统计接口支持按节点角色过滤。
• 新增部分 Node Manager 操作的 manual CLI 支持。
• 安装器支持使用指定 HTTP proxy，或显式跳过 proxy 设置。

功能优化

• 补充 API Gateway 文档中的节点角色权限和主机统计过滤说明。
• 优化管控单元创建后的权限刷新，并限制 trigger 查询范围。
• 优化策略管理表单行为和拓扑筛选集成。

缺陷修复

• 修复创建管控单元后权限数据未刷新的问题。
• 修复 trigger 查询可能不受数量上限约束的问题。
• 修正节点安装器等待日志文案。
• 修复策略管理验收问题。
• 修复带 timezone offset 的 notice 时间解析问题。

Agent / Plugin / Package compatibility

• 本版本不修改 Agent、Plugin 或 Package 包格式。

组件依赖与升级前置条件

• Helm 部署默认保持现有 installer proxy 行为，不引入额外升级前置条件。

v3.0.1-alpha.95

[Version: v3.0.1-alpha.95] - 2026-10-09

Full Changelog: v3.0.1-alpha.94...v3.0.1-alpha.95

发布范围

• Frontend: 更新前端依赖处理，用于覆盖 npm security alerts。
• Backend/Control Plane: 增加主机 Agent 关系解绑 workflow 支持，并优化 workflow 启动失败处理。
• Integration: 按租户注册 Notice 应用。
• Documentation: 更新 BKRepo metadata 说明和项目文档。

新增功能

• 新增节点卸载流程中的主机 Agent 关系解绑 workflow 支持。

功能优化

• 增加前端 npm Dependabot security alerts 的处理覆盖。
• 更新 BKRepo package metadata 的文档说明。

缺陷修复

• 修复节点、Package、Plugin workflow 启动失败时的处理逻辑。
• 修复 Notice 应用注册逻辑，确保按租户独立注册。

Agent / Plugin / Package compatibility

• 本版本不修改 Agent、Plugin 或 Package 包格式。

组件依赖与升级前置条件

• Helm 部署不引入额外升级前置条件。