Qt fixtures and docs declare xim:qt-base / xim:qt 6.11.1.1, the payload with its runtime closure

Author: Sunrisepeak

.agents/docs/2026-09-26-plugins-0.15-architecture-plan.md

@@ -53,7 +53,7 @@ build.mcpp，而不是 mcpp.toml。
 plugins = { version = "0.15.0", features = ["rules-qt", "deps-vcpkg"], host-module = true }
 
 [target.'cfg(any(windows, linux, macos))'.xlings.workspace]
-"xim:qt-base" = "6.11.1"
+"xim:qt-base" = "6.11.1.1"
 ```
 
 ```cpp
@@ -148,7 +148,9 @@ rules-qt 的 SDK 查找顺序为 `options::root` → `QT_ROOT_DIR`（不采用 `
 | vcpkg 前缀多一层 triplet | 改用返回的 `prefix`，不硬编码 `vcpkg_installed/<triplet>`（GalTranslPP `gpp.build` 第 182 行） |
 | 插件不再提供 glib 目录 | 使用外部 Qt 的 Linux 项目自行处理闭包 |
 
-以下变化不需要消费方修改：Linux 与 Windows 的 Qt 载荷会因 `installed()` 的标记 `runtime 1` 自动重装。
+载荷的更新方式：xlings 以磁盘上的载荷与安装记录判定"已安装"，不会对已存在的载荷调用配方的 `installed()`。因此含运行时闭包的载荷以新版本号
+`6.11.1.1` 发布（xim-pkgindex#888，沿用 fontconfig 2.15.0.1、libglvnd 1.7.0.1 的做法），项目声明 `"xim:qt-base" = "6.11.1.1"`。
+这一点由插件 CI 实测发现：缓存恢复了旧的 6.11.1 载荷，Linux 程序缺少 `libzstd.so.1`。
 
 ## 8. 任务依赖与 PR
 
@@ -174,7 +176,7 @@ GalTranslPP PR2：按 §7 迁移；Windows 回归（含 VC++ 运行时）
 | 稳定性 | 动作的输入输出完整；运行时闭包在规划、链接、运行、打包阶段分别由引擎与载荷保证 |
 | 简洁 | 删除三个 feature、一个包内工具和 metadata 一级；新增的机制只有 `cmake -P` 脚本 |
 | 易用性 | 配置集中在 build.mcpp；依赖边不再有 `tools`；Qt 选择是两行显式声明 |
-| 兼容性 | 破坏性变更集中在 §7，每项修改为一到两行；载荷自动重装 |
+| 兼容性 | 破坏性变更集中在 §7，每项修改为一到两行；载荷修订经新版本号到达已安装旧载荷的机器 |
 | 跨平台 | 三个平台的闭包逐一论证；windows-aarch64 的 CRT 为已知缺口 |
 | 一致性 | 三级配置、fact 记录、警告优先，对所有成员相同 |
 | 测试 | 新增 `qt-sdk-consumer`（三个层级）、Linux Widgets 与打包、Windows CRT、`vcpkg-libcxx` |

docs/rules-qt.md

@@ -10,7 +10,7 @@ plugins = { version = "0.15.0", features = ["rules-qt"], host-module = true }
 
 # The SDK and its version are the project's declaration.
 [target.'cfg(any(windows, linux, macos))'.xlings.workspace]
-"xim:qt-base" = "6.11.1"
+"xim:qt-base" = "6.11.1.1"
 
 [build]
 sources = ["src/*.cpp", "res/*.qrc", "i18n/*.ts", "ui/*.ui"]
@@ -45,7 +45,7 @@ The first of three levels that names an SDK decides, and the rule records which
 | `xim:qt` | qtbase, qtsvg, qtdeclarative, qttools, qttranslations |
 | `xim:qt-addons` | the additional libraries, beside `xim:qt` |
 
-0.15.0 removed the features `rules-qt-xim`, `rules-qt-xim-base` and `rules-qt-xim-addons`, which declared a payload at a fixed version: a feature states a mechanism, and the SDK a program links is the project's choice. A project that named one declares the payload instead, as above.
+The payloads that carry their runtime closure are version `6.11.1.1` (the Qt 6.11.1 archives, laid out anew); a machine that holds `6.11.1` keeps the earlier layout. 0.15.0 removed the features `rules-qt-xim`, `rules-qt-xim-base` and `rules-qt-xim-addons`, which declared a payload at a fixed version: a feature states a mechanism, and the SDK a program links is the project's choice. A project that named one declares the payload instead, as above.
 
 ## Options
 

rules/qt.cppm

@@ -366,7 +366,7 @@ inline bool compile(options opt = {}) {
             "{}: no Qt SDK{}. Nothing Qt-specific is planned. Name one with options::root or "
             "QT_ROOT_DIR, or declare a payload, which `mcpp build` provisions:\n"
             "    [target.'cfg(any(windows, linux, macos))'.xlings.workspace]\n"
-            "    \"xim:qt-base\" = \"6.11.1\"",
+            "    \"xim:qt-base\" = \"6.11.1.1\"",
             who, source.level.empty() ? std::string()
                                       : " at the directory " + source.level + " names"));
         return true;

tests/qt-consumer/mcpp.toml

@@ -37,7 +37,7 @@ plugins = { path = "../..", features = ["rules-qt"], host-module = true }
 
 # The SDK is the project's declaration, at the version it chooses.
 [target.'cfg(any(windows, linux, macos))'.xlings.workspace]
-"xim:qt-base" = "6.11.1"
+"xim:qt-base" = "6.11.1.1"
 
 [build]
 # Qt's Linux libraries load the shared libstdc++ (`libstdc++.so.6`), so the

tests/qt-sdk-consumer/mcpp.toml

@@ -21,7 +21,7 @@ import_std = false
 plugins = { path = "../..", features = ["rules-qt"], host-module = true }
 
 [target.'cfg(any(windows, linux, macos))'.xlings.workspace]
-"xim:qt-base" = "6.11.1"
+"xim:qt-base" = "6.11.1.1"
 
 [build]
 # Qt's Linux libraries load the shared libstdc++; see tests/qt-consumer.

tests/qt-widgets-consumer/mcpp.toml

@@ -25,7 +25,7 @@ plugins = { path = "../..", features = ["rules-qt"], host-module = true }
 # The SDK is the project's declaration: the full base package here, and
 # `xim:qt-base` in tests/qt-consumer.
 [target.'cfg(any(windows, linux, macos))'.xlings.workspace]
-"xim:qt" = "6.11.1"
+"xim:qt" = "6.11.1.1"
 
 # Built, run and packed on every host by CI. On Linux the payload carries
 # QtGui's runtime closure (libdbus, fontconfig, xcb, ...); on Windows, the VC++