@hmos-library-adapter/fast 0.0.17-beta.0 → 0.0.17-beta.2

package/node_modules/@ohos-agent/pc-adapter/skills/pc-error-atlas/knowledge/errors/E463.md

@@ -0,0 +1,52 @@
+<!-- 本文件由同步脚本自动生成，请勿手改。如需修正请更新知识源数据后重新运行 `npm run sync:kb`。 -->
+
+# E463: Build GTK 3.24 with Broadway and validate consumers without a display
+
+> **严重度**: 🟡 medium | **分类**: ohos, meson, filesystem, broadway, gtk | **自动修复**: ❌
+
+---
+
+## 错误特征
+
+```
+broadway
+X11
+Wayland
+HMDFS
+shebang
+libffi.so.8
+GtkWindow
+```
+
+## 根因
+
+The base OHOS runner has neither X11/Wayland nor the prerequisites required by the upstream GTK GUI tests. Ambient GLib tools can load an incompatible device-global libffi ABI, while pinned compiled tools copied from a Conan cache require HarmonyOS self-signing before execution.
+
+## 验证命令
+
+```bash
+conan create 〈外部知识库归档〉 --build=missing; require the signed GtkWindow type probe and R34 destructive dependency test to pass.
+```
+
+## 解决方案
+
+**broadway-headless-consumer-probe**：Use the gtk Conan slug, enable Broadway, overwrite generated pkg-config tool variables with signed private copies of pinned compiled GLib tools, pair them with dependency library paths, and run a no-display consumer probe.
+
+```bash
+-Dx11_backend=false -Dwayland_backend=false -Dbroadway_backend=true
+```
+
+## 🚫 禁止策略
+
+### 🚫 禁止 1
+
+- **模式**：`claim upstream GUI tests passed without display fixture`
+- **原因**：Display, input, theme, and upstream harness prerequisites are absent in the headless package gate.
+- **后果**：Test coverage is overstated and regressions may be hidden.
+
+## 涉及软件
+
+ohos, meson, filesystem, broadway, gtk 场景（关键词: gtk, GTK+, Broadway, X11, Wayland, HMDFS, glib-compile-resources, GtkWindow）。根因: The base OHOS runner has neither X11/Wayland nor the prerequisites required by the upstream GTK GUI tests. Ambient GLib
+
+---
+*条目 E463 · 更新 2026-08-27 · 知识库同步生成物*

package/node_modules/@ohos-agent/pc-adapter/skills/pc-error-atlas/knowledge/errors/E464.md

@@ -0,0 +1,55 @@
+<!-- 本文件由同步脚本自动生成，请勿手改。如需修正请更新知识源数据后重新运行 `npm run sync:kb`。 -->
+
+# E464: MyGUI Dummy 后端资源注册缺失与 DataStream read EOF 契约导致无头测试自旋（SIGKILL Error 137）
+
+> **严重度**: 🟡 medium | **分类**: platform, compat, build-system, testing, graphics | **自动修复**: ✅ source-patch | **原则**: [P003](../principles.md#P003)、[P010](../principles.md#P010)、[P012](../principles.md#P012)
+
+---
+
+## 错误特征
+
+```
+MyGUI_Core\.xml not found
+addResourceLocation
+DummyDataManager
+getDataPath
+DataStream::read
+min\(size\(\), _count\)
+Error 137 while executing
+Signal 9
+```
+
+## 根因
+
+MyGUI Dummy 渲染后端（MYGUI_RENDERSYSTEM=1）的 addResourceLocation 为空实现、
+DummyDataManager 五个 DataManager 虚接口全空返回，导致无头环境下 ResourceManager 无法解析
+MyGUI_Core.xml 等资源；且 DataStream::read() 返回 min(size(),_count) 而非实际读取字节
+（忽略 gcount），EOF 后仍返回非 0，标准 read-until-0 消费循环在 EOF 后无限自旋（CPU 忙循环），
+进程被调度层 SIGKILL（Conan Error 137）
+
+## 验证命令
+
+```bash
+conan create 内 test_package test() 运行 test_headless（正式 runenv），
+预期 RESULT 14 passed, 0 failed；conan-verify G2/G3/G4 PASS
+```
+
+## 解决方案
+
+**mygui-dummy-resource-registration-headless**：镜像 OpenGL/OpenGLES 契约实现 DummyDataManager addResourceLocation/getData/getDataPath/isDataExist/getDataListNames（scanFolder 递归），BaseManager 接线；测试 T3 按 st->size() 一次读取适配 DataStream::read() 契约，T4 递归 mask 用 basename
+
+```bash
+patch 0002-dummy-resource-registration.patch（3 文件）+ test_headless T3/T4 修正；经 ohpc_compile_worker finish 重建后 conan create 内 test() 运行
+```
+
+## 回退方案
+
+**openGLES-8-backend**：真实显示/渲染上下文（XComponent+EGL / DISPLAY）用 OpenGLES 后端（RENDERSYSTEM=8）构建，绕过 Dummy 占位限制
+
+## 涉及软件
+
+MyGUI 3.4.x Dummy 后端在无头环境（OHOS PC/CI 无显示）的适配与消费测试；
+依赖 MyGUI DataStream::read() 的任何 read-until-0 测试
+
+---
+*条目 E464 · 更新 2026-08-31 · 知识库同步生成物*

package/node_modules/@ohos-agent/pc-adapter/skills/pc-error-atlas/knowledge/errors/E465.md

@@ -0,0 +1,71 @@
+<!-- 本文件由同步脚本自动生成，请勿手改。如需修正请更新知识源数据后重新运行 `npm run sync:kb`。 -->
+
+# E465: Route upstream dlopen/ctypes tests past the OHOS worker loader boundary with an embedded-Python launcher that links the library under test as its own NEEDED
+
+> **严重度**: 🔴 blocking | **分类**: platform, ohos, autotools, testing, security | **自动修复**: ❌
+
+---
+
+## 错误特征
+
+```
+AttributeError: do_dlsym failed: Symbol not found.*so=/data/service/hnp/bin/python3
+FAIL: .*test_python\.py
+```
+
+## 根因
+
+On workers where dlopen and LD_PRELOAD refuse user-directory shared objects (E2166), the only loader path that accepts them is the process-startup DT_NEEDED chain. A tiny embedded-Python launcher whose own NEEDED entry is the freshly self-signed library under test maps it into the process global symbol scope before the interpreter initializes, so the upstream ctypes binding resolves through its CDLL(None) fallback and the real test logic executes unchanged. The stock interpreter can never do this because no post-start mapping of the library is permitted there.
+
+## 验证命令
+
+```bash
+make -n check shows PY_LOG_COMPILER expanding to the launcher; then one upstream test executed through it passes while the same interpreter name via stock python3 fails on dlopen (worker evidence: PR #6848 build #33932 flipped isl_test_python.py from FAIL to PASS).
+```
+
+## 解决方案
+
+**embedded-python-launcher**：Compile launcher.c (Py_Initialize, Py_DecodeLocale-marshalled argv, script-dir sys.path insertion, PyRun_SimpleFileEx) with clang linking the freshly self-signed shared library by full path (NEEDED records the SONAME) plus HNP libpython (rpath to its directory; python3-config --embed fallback when no shared libpython exists); route the automake test through it with make check PYTHON=<launcher>.
+
+```bash
+clang -Wno-deprecated-declarations launcher.c -I "$($PY -c import\ sysconfig\;print\(sysconfig.get_paths\(\)\[.include.\]\)") <PYROOT>/lib/libpython3.12.so <selfsigned>/<libtarget.so> -Wl,-rpath,<PYROOT>/lib -o launcher && make -j1 check PYTHON="$PWD/launcher"
+```
+
+## 回退方案
+
+**python3-config-embed-static**：Executors whose HNP python ships no libpython.so (Py_ENABLE_SHARED=0): compile with python3-config --includes plus --ldflags --embed so the interpreter links statically; the library-under-test NEEDED entry is unchanged.
+
+```bash
+clang launcher.c $(python3-config --includes) <selfsigned>/libtarget.so $(python3-config --ldflags --embed) -o launcher
+```
+
+## 🚫 禁止策略
+
+### 🚫 禁止 1
+
+- **模式**：`(export )?PYTHON=[^ ]+ &&? .*make .*check|PYTHON=[^ ]+ make`
+- **原因**：A shell environment prefix PYTHON=... is overridden by the configure-generated assignment PYTHON = @PYTHON@ in the Makefile; build #33918 proved the stock interpreter silently kept running the test (traceback so=/data/service/hnp/bin/python3) while the launcher was built and never used. Only a make command-line variable overrides the assignment and propagates through recursive makes.
+- **后果**：Expensive CI rounds spent on a fallback that is actually dead code.
+
+### 🚫 禁止 2
+
+- **模式**：`LD_PRELOAD=.*(make|ctest).*check`
+- **原因**：Workers ignore LD_PRELOAD of user-directory libraries (E2166, build #33895); the preloaded object never joins the global scope and the test still fails at CDLL(None) with a misleading missing-symbol error.
+- **后果**：Misattribution of the failure to the launcher or the signature instead of the loader policy.
+
+### 🚫 禁止 3
+
+- **模式**：`argv-as-wchar|PySys_SetArgvEx\(.*argv \+ 1, 0\)(?![\s\S]*Py_DecodeLocale)`
+- **原因**：Passing char** argv directly to PySys_SetArgvEx corrupts sys.argv (wchar_t re-interpretation of char* produced fatal 'no mem for sys.argv' and out-of-range codepoint errors before the fix); argv must be marshalled through Py_DecodeLocale.
+- **后果**：Launcher crashes before the first test line, indistinguishable from a loader policy failure in truncated logs.
+
+## 涉及软件
+
+Any archived package whose upstream suite contains ctypes/FFI tests against a shared library built in the same conan build (python bindings, plugin-loading tests).
+
+## 相关模式
+
+- **相似模式**：[E135](E135.md)
+
+---
+*条目 E465 · 更新 2026-08-28 · 知识库同步生成物*

package/node_modules/@ohos-agent/pc-adapter/skills/pc-error-atlas/knowledge/errors/E466.md

@@ -0,0 +1,40 @@
+<!-- 本文件由同步脚本自动生成，请勿手改。如需修正请更新知识源数据后重新运行 `npm run sync:kb`。 -->
+
+# E466: init_build._promote_nested_source 仅按 C/C++ 构建标记(configure/CMakeLists.t
+
+> **严重度**: 🟡 medium | **分类**: python, extract, init-build, sdist | **自动修复**: ❌
+
+---
+
+## 错误特征
+
+```
+嵌套源码检测: 找到源码在
+\.work 目录只有 docs 内容
+cp: .*Operation not permitted
+```
+
+## 根因
+
+init_build._promote_nested_source 仅按 C/C++ 构建标记(configure/CMakeLists.txt/Makefile/meson.build)识别源码子目录；Python sdist(如 chardet)顶层无这些标记，递归误命中含 Sphinx Makefile 的 docs/ 目录，把 docs/ 提升为源码根。另外 HMDFS 文件系统禁止创建硬链接(cp -al 报 Operation not permitted)。
+
+## 验证命令
+
+```bash
+ls .work/chardet/__init__.py && python3 -c "import sys; sys.path.insert(0,'.work'); import chardet; print(chardet.__version__)"
+```
+
+## 解决方案
+
+**Python 包(sdist)适配时若发现 .work 只有 docs 内容: 1) rm -rf 两个目录; 2) mkdir .orig && tar xzf --strip-components=1 -C .orig; 3) cp -a .orig/. .work/(勿用硬链接); 4) 写入 .tarball-sha256 校验; 5) 配方 build() 走 pip install 路径，不依赖 init-build 目录推断**：Python 包(sdist)适配时若发现 .work 只有 docs 内容: 1) rm -rf 两个目录; 2) mkdir .orig && tar xzf --strip-components=1 -C .orig; 3) cp -a .orig/. .work/(勿用硬链接); 4) 写入 .tarball-sha256 校验; 5) 配方 build() 走 pip install 路径，不依赖 init-build 目录推断
+
+```bash
+可选: 具体命令模板(${VAR}变量引用)
+```
+
+## 涉及软件
+
+init-build 阶段所有 Python 包(sdist)适配
+
+---
+*条目 E466 · 更新 2026-08-28 · 知识库同步生成物*

package/node_modules/@ohos-agent/pc-adapter/skills/pc-error-atlas/knowledge/errors/E467.md

@@ -0,0 +1,51 @@
+<!-- 本文件由同步脚本自动生成，请勿手改。如需修正请更新知识源数据后重新运行 `npm run sync:kb`。 -->
+
+# E467: AutotoolsDeps exports LIBS, so autoconf's earliest run probe links the whole dependency closure and fails at configure
+
+> **严重度**: 🟡 medium | **分类**: autotools, toolchain, conan | **自动修复**: ❌
+
+---
+
+## 错误特征
+
+```
+checking whether we are cross compiling... configure: error: cannot run C compiled programs
+Error loading shared library .* \(needed by \./conftest\)
+```
+
+## 根因
+
+Conan 的 AutotoolsDeps 会把依赖闭包写进 LIBS/CPPFLAGS 环境变量，autoconf 最早的 AC_PROG_CC 交叉编译判定会沿用这些 LIBS 去链接 conftest。于是本应只跑一个空 main 的探测变成需要真正加载整条共享依赖闭包；只要闭包里有任一库在本机不可加载，错误就在 configure 阶段以 rc=77 暴露，而不是在测试阶段，容易被误判为编译器或三元组问题。
+
+## 验证命令
+
+```bash
+grep -A6 'checking whether we are cross compiling' <build>/config.log  # 看真实第一条加载错误
+```
+
+## 解决方案
+
+**read-config-log-then-fix-loader**：先读 config.log 里 conftest 的完整链接命令与第一条错误，区分是签名/别名/路径问题（见 E257、E321），再在任务私有视图内修好可加载性；不要改成静态链接、不要预设 cross_compiling 缓存变量、也不要加 --host。
+
+```bash
+grep -B2 -A8 'cannot run C compiled programs' $B/config.log
+```
+
+## 回退方案
+
+**drop-autotoolsdeps-when-pkgconfig-sufficient**：若依赖探测已由 PkgConfigDeps 覆盖，可不生成 AutotoolsDeps，使早期探测不再无条件链接整条闭包。
+
+## 🚫 禁止策略
+
+### 🚫 禁止 1
+
+- **模式**：`用 ac_cv_prog_cc_works=yes 或 --host= 让探测直接通过`
+- **原因**：伪造能力检测结果会让 config.h 与真实平台不符；--host 属 R1 禁止项
+- **后果**：问题被推到运行期或其他包，且审计按欺骗检测判 P0
+
+## 涉及软件
+
+所有 os=OHOS 上使用 Autotools+AutotoolsDeps 且依赖含共享库的 Conan 配方（X.Org 客户端库、图形栈尤其常见）。
+
+---
+*条目 E467 · 更新 2026-08-28 · 知识库同步生成物*

package/node_modules/@ohos-agent/pc-adapter/skills/pc-error-atlas/knowledge/errors/E468.md

@@ -0,0 +1,56 @@
+<!-- 本文件由同步脚本自动生成，请勿手改。如需修正请更新知识源数据后重新运行 `npm run sync:kb`。 -->
+
+# E468: PkgConfigDeps writes .pc files but does not extend PKG_CONFIG_PATH, so upstream PKG_CHECK_MODULES probes miss Conan metadata
+
+> **严重度**: 🟡 medium | **分类**: toolchain, conan, pkg-config | **自动修复**: ❌
+
+---
+
+## 错误特征
+
+```
+Package [a-z0-9.-]+ was not found in the pkg-config search path
+No package .[a-z0-9.-]+. found
+configure: error: Package requirements
+```
+
+## 根因
+
+Conan 的 PkgConfigDeps 只在 generators 目录写出与上游探测名对齐的 .pc 文件，不会把该目录加入 PKG_CONFIG_PATH；AutotoolsToolchain 也不一定包含它。于是上游 configure 的 PKG_CHECK_MODULES 只能看到系统路径，找不到 Conan 生成的元数据，报 was not found in the pkg-config search path。X.Org 类库还会额外需要 xorg-macros.pc（由 util-macros 提供），缺失时 macros_datadir 为空、man/DOCUSER 替换退化却不报错，属于静默降级。
+
+## 验证命令
+
+```bash
+在构建目录里 source conanbuild.sh 后执行 pkg-config --exists xrender && pkg-config --modversion xrender
+```
+
+## 解决方案
+
+**append-generators-folder-to-pkg-config-path**：在 generate() 中显式 self.buildenv_info.append_path('PKG_CONFIG_PATH', self.generators_folder)，并把需要 .m4/.pc 的构建工具（如 util-macros）声明为 tool_requires，让其 package_info 暴露的 PKG_CONFIG_PATH/ACLOCAL_PATH 经 VirtualBuildEnv 生效。
+
+```bash
+self.buildenv_info.append_path('PKG_CONFIG_PATH', self.generators_folder)
+```
+
+## 回退方案
+
+**read-generated-pc-names**：确认上游探测名与 Conan 生成的 .pc 文件名是否一致（例如 freetype 需映射为 freetype2、xorgproto 需映射为 xproto），必要时用 PkgConfigDeps.set_property 对齐。
+
+```bash
+ls <generators_folder>/*.pc
+```
+
+## 🚫 禁止策略
+
+### 🚫 禁止 1
+
+- **模式**：`往全局 shell 配置或 profile 里写 PKG_CONFIG_PATH 来救单个包`
+- **原因**：profile 是共享文件，单库特例应留在配方内；全局环境变量还会被 pkg-config 判为系统路径
+- **后果**：影响其他包的构建可复现性，且 PR 会被判为越权修改基础设施
+
+## 涉及软件
+
+所有使用 Autotools + PkgConfigDeps 的配方；X.Org 客户端库额外受 xorg-macros 影响。
+
+---
+*条目 E468 · 更新 2026-08-28 · 知识库同步生成物*

package/node_modules/@ohos-agent/pc-adapter/skills/pc-error-atlas/knowledge/errors/E469.md

@@ -0,0 +1,46 @@
+<!-- 本文件由同步脚本自动生成，请勿手改。如需修正请更新知识源数据后重新运行 `npm run sync:kb`。 -->
+
+# E469: cpp-httplib test_package 中 bind_port() 不存在，需用 bind_to_any_port() 获取已绑定端口
+
+> **严重度**: 🟡 medium | **分类**: header-only-library-server-port-binding | **自动修复**: ❌
+
+---
+
+## 错误特征
+
+```
+no member named 'bind_port' in 'httplib::Server'
+```
+
+## 根因
+
+cpp-httplib 0.18.0 的 httplib::Server 没有 bind_port() 成员；可用 API 是 bind_to_port(host, port) 返回 bool、bind_to_any_port(host) 返回自动分配的端口号 int、listen_after_bind()/listen(host, port) 启动监听。编写本地 HTTP 往返测试时若按"绑定到自动端口 + 读取端口"的思路使用 bind_port() 会编译失败
+
+## 验证命令
+
+```bash
+conan create . -pr:h=〈外部知识库流水线〉 -pr:b=〈外部知识库流水线〉
+```
+
+## 解决方案
+
+**use-bind-to-any-port**：test_package 中本地起 httplib::Server 时使用 bind_to_any_port(host) 获得自动分配端口，用该端口构造 Client 完成 HTTP 往返断言，替代不存在的 bind_port()
+
+```bash
+conan create 〈外部知识库归档〉
+```
+
+## 🚫 禁止策略
+
+### 🚫 禁止 1
+
+- **模式**：`bind_port()`
+- **原因**：cpp-httplib 0.18.0 httplib::Server 不存在该成员，直接编译失败
+- **后果**：test_package 编译失败阻塞 conan create
+
+## 涉及软件
+
+所有用 cpp-httplib 0.18.0 httplib::Server 绑定任意端口并需要读取端口号的消费者测试/示例代码
+
+---
+*条目 E469 · 更新 2026-08-30 · 知识库同步生成物*

package/node_modules/@ohos-agent/pc-adapter/skills/pc-error-atlas/knowledge/errors/E470.md

@@ -0,0 +1,68 @@
+<!-- 本文件由同步脚本自动生成，请勿手改。如需修正请更新知识源数据后重新运行 `npm run sync:kb`。 -->
+
+# E470: cppitertools 2.3 三问题组合：上游配方版本元数据 vs 官方 tag、大小写不敏感 FS 下 Bazel BUILD 与 build 目录冲突、header-only 配方与消费者测试
+
+> **严重度**: 🟡 medium | **分类**: build-system, conan, packaging, filesystem, provenance | **自动修复**: ❌
+
+---
+
+## 错误特征
+
+```
+NotADirectoryError: [Errno 20] Not a directory: '.../b/build/Release'
+上游 conanfile.py version 与官方 tag 不一致
+package_type 未声明 header-library 或消费者 include/命名空间写错
+```
+
+## 根因
+
+上游 conanfile.py 的 version 字段由作者维护、滞后于官方 tag，不作为发布事实来源，官方 Git tag 才是。cmake_layout 默认使用名为 build 的构建目录，上游仓库根目录存在 Bazel `BUILD` 文件时，在大小写不敏感 FS 上 `build` 目录创建被既有文件阻断（NotADirectoryError），conan create 在 generate 阶段失败。header-only 库无编译产物，配方需显式 header-library 类型并以真实头文件 API 做消费者测试。
+
+## 验证命令
+
+```bash
+conan create 〈外部知识库归档〉 -pr:h ohos-aarch64 -pr:b default && ctest --output-on-failure
+```
+
+## 解决方案
+
+**tag-as-provenance-source + non-default-cmake-build-folder + header-library-recipe**：版本号以官方 tag 为准并记录 tag commit 与 SHA-256（conandata.yml），不沿用上游 conanfile 版本；cmake_layout(self, build_folder="build_dir") 规避与 Bazel BUILD 文件碰撞；配方 package_type="header-library"，package_info 仅暴露 include 与 cmake_target_name，test_package 以 iter::range/enumerate/zip/accumulate 真实 API 断言（C++17）。
+
+```bash
+conan create 〈外部知识库归档〉 -pr:h ohos-aarch64 -pr:b default
+```
+
+## 回退方案
+
+**build-folder-rename-or-toolchain-decision**：若多次更换 build_folder 后冲突仍在，检查上游源码树是否有与构建目录同名的非常规文件；或由平台决策是否在大小写不敏感 FS 上启用 conan 独立构建目录。
+
+## 🚫 禁止策略
+
+### 🚫 禁止 1
+
+- **模式**：`沿用上游 conanfile.py 的 version 字段作为归档版本号`
+- **原因**：上游版本元数据滞后于官方 tag，沿用会产生与官方发布无关的版本，破坏 provenance 可追溯性。
+- **后果**：归档/制品仓出现虚假版本，CI/审核按版本号误判。
+
+### 🚫 禁止 2
+
+- **模式**：`rm -f BUILD|git rm.*BUILD|删除上游 BUILD 文件`
+- **原因**：BUILD 是上游官方 Bazel 构建文件，删除会破坏上游树（R39 官方源完整性），正确做法是改本地构建目录名。
+- **后果**：上游树被修改，归档与官方源不一致，补丁链路污染。
+
+### 🚫 禁止 3
+
+- **模式**：`test_package 只打印字符串不调用被测包 API`
+- **原因**：R34：test 必须实质依赖被测包；header-only 库必须 include 真实头文件并断言。
+- **后果**：L1e 破坏性反向验证拦截，PR 失败。
+
+## 涉及软件
+
+任何上游自带 conanfile.py 且版本字段与官方 tag 不一致的库（provenance 校验）；任何仓库根含 Bazel/其他 BUILD 文件且在大小写不敏感 FS 上编译的 CMake 配方；任何 header-only C++17 及以上库的 Conan 配方/消费者测试。
+
+## 相关模式
+
+- **相似模式**：[E307](E307.md)、[E035](E035.md)、[E021](E021.md)、[E071](E071.md)
+
+---
+*条目 E470 · 更新 2026-08-31 · 知识库同步生成物*

package/node_modules/@ohos-agent/pc-adapter/skills/pc-error-atlas/knowledge/errors/E471.md

@@ -0,0 +1,72 @@
+<!-- 本文件由同步脚本自动生成，请勿手改。如需修正请更新知识源数据后重新运行 `npm run sync:kb`。 -->
+
+# E471: OHOS PC 无任何原生显示后端；gtkmm 4.0.0 tests/meson.build 的「可执行测试」(exe
+
+> **严重度**: 🔴 blocking | **分类**: platform, meson, testing, binding, display | **自动修复**: ✅ recipe-options+patch(test/meson.build)
+
+---
+
+## 错误特征
+
+```
+Failed to open display
+Gtk-WARNING.*Failed to open display
+Fontconfig error: Cannot load default config file
+gtk_init.*failed
+gtk4-broadwayd.*Operation not permitted
+exit status 1.*display
+```
+
+## 根因
+
+OHOS PC 无任何原生显示后端；gtkmm 4.0.0 tests/meson.build
+的「可执行测试」(execute=true) 与「GUI 测试」标志不等价——
+4 个 execute=true 测试中 3 个仍调用 gtk_init()（需显示服务
+器），无显示环境下 gtk_init() 失败、进程 exit 1；gtk_init()
+前置 fontconfig 在无 /etc/fonts/fonts.conf 的 OHOS 上也失败；
+提供显示服务的 gtk4-broadwayd 在 OHOS 因签名约束不可执行
+(EPERM)。这些是真实显示依赖而非库缺陷，需按显示依赖分类，
+不能写成库测试失败或强行 headless 假装通过。
+
+## 验证命令
+
+```bash
+待补：条目级验证命令未随草稿记录；该条目来自已合并 PR（见 source_pr），CI 验证以 PR 记录为准
+```
+
+## 解决方案
+
+**display-test-classification-and-no-display-api-probes**：① tests/meson.build 把真实调用 gtk_init()/建窗口的测试标记
+failing suite（suite:['failing']），CI/构建统一
+meson test --no-suite=failing 排除并记录真实原因（glibmm
+E215 同款）；② build() 运行 meson test 前注入 fontconfig
+包真实配置 FONTCONFIG_FILE/PATH（否则无显示 API 测试也因
+fonts.conf 缺失失败）；③ 新增不依赖显示器的公开 API 探针
+（Gdk::RGBA set_rgba_u/get_red_u、Gdk::Rectangle、sigc++-3.0
+连接）作为鸿蒙特有测试并单独统计；④ 显示依赖测试不可运行
+（broadwayd EPERM）时如实记录「需 Broadway 服务或真实显示
+环境」，禁止跳过填 100% 或将 EPERM 写成构建失败。
+
+```bash
+# tests/meson.build（0003 补丁同款）
+if ex[4]
+  if ex_name in ['bitset_iterator_test', 'object_move_test', 'tree_model_iterator_test']
+    test(ex_name, exe_file, suite: ['failing'])
+  else
+    test(ex_name, exe_file)
+  endif
+endif
+# conanfile.py build()（fontconfig 注入）
+#   os.environ["FONTCONFIG_FILE"] = f"{fontconfig_pkg}/etc/fonts/fonts.conf"
+#   os.environ["FONTCONFIG_PATH"] = f"{fontconfig_pkg}/etc/fonts"
+# 测试运行：
+#   meson test -v -C {build} --timeout-multiplier=16 --no-rebuild --no-suite=failing
+#   测试统计口径：真实运行 / 显示依赖不可运行(failing 排除) / 构建但不执行
+```
+
+## 涉及软件
+
+platform, meson, testing, binding, display 场景（关键词: gtkmm, gtk_init, gdk_rgba, Gdk::RGBA, Gdk::Rectangle, Failed to open display, FONTCONFIG_FILE, FONTC）。根因: OHOS PC 无任何原生显示后端；gtkmm 4.0.0 tests/meson.build 的「可执行测试」(execute=true) 与「GUI 测试」标志不等价—— 4 个 execute=true 测试中 3 个仍调用 gtk_
+
+---
+*条目 E471 · 更新 2026-08-31 · 知识库同步生成物*

package/node_modules/@ohos-agent/pc-adapter/skills/pc-error-atlas/knowledge/errors/E472.md

@@ -0,0 +1,68 @@
+<!-- 本文件由同步脚本自动生成，请勿手改。如需修正请更新知识源数据后重新运行 `npm run sync:kb`。 -->
+
+# E472: Sign and headless-run Conan test_package executable tests on OHOS (SDL dummy drivers + self.run for L0d gate)
+
+> **严重度**: 🔴 blocking | **分类**: ohos, cmake, conan, testing, elfsign | **自动修复**: ✅ sign-elf-and-dummy-drivers
+
+---
+
+## 错误特征
+
+```
+test_package .* Error in test\(\) method
+self\.run.*失败
+stub_test_method
+SDL_.*Driver.*init
+binary not found
+codesign
+```
+
+## 根因
+
+SDL_kitchensink 1.0.13 的 test_package 生成可执行测试 test_sdl_kitchensink（调用 Kit_GetVersion/Kit_GetSDLAudioFormatString/Kit_Init/Kit_Quit）。在 OHOS aarch64 + Conan 2 下：(1) OHOS 要求 ELF 代码签名（binary-sign-tool sign -selfSign 1）后才可加载执行，未签名则测试无法运行； (2) 测试调用 SDL 初始化，CI/无显示无声卡环境需显式 SDL_VIDEODRIVER=dummy / SDL_AUDIODRIVER=dummy 走 stub 后端； (3) CI L0d 门禁要求 test() 内含 self.run() 实际执行逻辑，否则判 stub_test_method 空壳拦截； (4) 测试若用 AUDIO_S16LSB 等 SDL 宏需显式 #include <SDL_audio.h>，且 sdl2 头在 include/SDL2/ 需由配方 cpp_info.includedirs 透传。
+
+## 验证命令
+
+```bash
+conan create 〈外部知识库归档〉 -pr:h=〈外部知识库流水线〉 -pr:b=〈外部知识库流水线〉 --user=ohpcd --channel=stable
+```
+
+## 解决方案
+
+**sign-elf-and-sdl-dummy-headless-test**：test_package/conanfile.py 的 build() 内用 llvm-objcopy --remove-section .codesign（容忍失败）+ binary-sign-tool sign -selfSign 1 对测试 ELF 签名并移回、chmod 755；test() 内 os.environ 设 SDL_VIDEODRIVER=dummy / SDL_AUDIODRIVER=dummy，然后 self.run("'<bin>'", env="conanrun") 实际执行签名后二进制（真实调用库 API 做版本/格式字符串/初始化断言）；测试源显式 #include <SDL_audio.h>（用 AUDIO_S16LSB 等宏时），SDL include 路径由配方 cpp_info.includedirs 追加 sdl2 的 include/SDL2 透传（sdl2_image 先例）。
+
+```bash
+def build(self):
+    cmake = CMake(self); cmake.configure(); cmake.build()
+    self._sign_elf(os.path.join(self.cpp.build.bindirs[0], "test_sdl_kitchensink"))
+def _sign_elf(self, path):
+    self.run('{oc} --remove-section .codesign "{f}" 2>/dev/null'.format(oc="/data/service/hnp/bin/llvm-objcopy", f=path), ignore_errors=True)
+    tmp = path + ".signed"
+    self.run('{sg} sign -inFile "{f}" -outFile "{t}" -selfSign 1'.format(sg="/data/service/hnp/bin/binary-sign-tool", f=path, t=tmp))
+    if os.path.exists(tmp):
+        shutil.move(tmp, path)
+    os.chmod(path, 0o755)
+def test(self):
+    os.environ["SDL_VIDEODRIVER"] = "dummy"
+    os.environ["SDL_AUDIODRIVER"] = "dummy"
+    self.run(f"'{os.path.join(self.cpp.build.bindirs[0], 'test_sdl_kitchensink')}'", env="conanrun")
+```
+
+## 回退方案
+
+**none**：无（该子问题无替代方案：OHOS 必须签名；SDL 必须 dummy 无头；L0d 必须 self.run）
+
+## 🚫 禁止策略
+
+### 🚫 禁止 1
+
+- **模式**：`伪造.*测试|跳过.*签名.*当作.*通过|stub.*test.*当作.*PASS`
+- **原因**：不得以未签名的失败执行或空壳 test() 冒充测试通过；不得把本地验证当作远端发布
+- **后果**：数据失真导致门禁/路径判定错误
+
+## 涉及软件
+
+OHOS/arm64 上 test_package 产出可执行测试、且测试依赖 SDL（或同类需显示/音频初始化的库）的 Conan 配方；以及任何需 ELF 签名才能运行测试二进制的 OHOS 包。
+
+---
+*条目 E472 · 更新 2026-08-29 · 知识库同步生成物*