@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/error-index.md

@@ -0,0 +1,680 @@
+<!-- 本文件由同步脚本自动生成，请勿手改。如需修正请更新知识源数据后重新运行 `npm run sync:kb`。 -->
+
+# 鸿蒙 PC 错误图谱 · 总索引（542 条）
+
+> 面向场景：**鸿蒙 PC 设备本机原生编译（aarch64）**。交叉编译语境的条目请按
+> phase 与症状关键词自行甄别。结构化版本见 [error-index.json](error-index.json)，
+> 知识源 commit：`70926181cd`。
+
+## 用法
+
+1. 用错误关键词 / 报错片段 `grep` 本表（按「症状关键词」列）。
+2. 命中行得到 `E编号`（点击可直接跳到条目页）。
+3. 打开 `errors/E编号.md` 读完整根因与解决方案。
+
+```bash
+grep -i 'undefined symbol' error-index.md   # → 得到 E 编号
+# 然后阅读 errors/<E编号>.md
+```
+
+- severity：`3`=blocking(🔴) / `2`=medium(🟡) / `1`=minor(🟢) / `0`=resolved(✅)。
+- 表按条目 `phase` 首值分大类，方便定位；同一条可能跨阶段，以条目页元数据为准。
+
+## 1-下载/源码获取（19 条）
+
+| E编号 | severity | 症状关键词 | 一句话解法 |
+|---|---|---|---|
+| [E017](errors/E017.md) | 2(medium) | GitHub, timeout, timed out, wget, curl, mirror, ghfast, gitcode, gitee, proxy, download failed, network unreachable, tsinghua, aliyun, huawei, release | use-ghfast |
+| [E276](errors/E276.md) | 2(medium) | codeload, badzipfile, filename=, conan.get, refs.tags, tar.gz, basename, decompress | 在 source() 的 get() 调用显式传 filename='<软件>-<版本>.tar.gz',让 conan 按扩展名正确识别为 tar.gz 解压;URL 保持官方源(R39)不变,只改下载文件名。 |
+| [E299](errors/E299.md) | 3(blocking) | Conan source, get(), download, timeout, mirror, sha256, computed hash, provided hash, 404, DNS, conandata.yml, official URL, R39 | classify-source-failure |
+| [E349](errors/E349.md) | 3(blocking) | vlang, v, vc, self-hosted compiler, bootstrap, source(), make v, binary-sign-tool, TMPDIR, gc none, extra_exelinkflags | pinned-bootstrap-source-and-signed-stage-wrapper |
+| [E372](errors/E372.md) | 3(blocking) | Conan source, curl missing, Python SSL unavailable, HTTPS, HTTP mirror, authority mirror, sha256, conandata.yml, Buildbot | official-https-first-authority-http-fallback |
+| [E377](errors/E377.md) | 3(blocking) | KWStyle, ExternalProject_Add, GIT_REPOSITORY, DOWNLOAD_COMMAND, ITK_FORBID_DOWNLOADS | checksum-bound-local-externalproject-source |
+| [E378](errors/E378.md) | 2(medium) | conan source, source_folder, output-folder, absolute recipe path, strip_root | isolated-recipe-copy-source-probe |
+| [E382](errors/E382.md) | 2(medium) | dangling symlink, cross-package resource, Conan dependency, HMDFS, materialize, copy2, byte identity, path containment, acf-ppp | dependency-graph-resource-materialization |
+| [E392](errors/E392.md) | 2(medium) | BadZipFile, File is not a zip file, codeload.github.com, get(), filename, strip_root, tar.gz, zip, Conan, compiler_executables, dict, check_type, make, No targets specified, No makefile found, cwd, source_folder, build_folder, raw makefile, single-file, install, copy, OHOS | raw-makefile-conan-recipe-pattern |
+| [E405](errors/E405.md) | 2(medium) | posix_spawn, posix_spawnp, PATH, bare-name, subprocess, FileNotFoundError, Errno 2, _IS_HARMONYOS, curl, shutil.which, shell=True | use-absolute-path-or-shell-or-which |
+| [E406](errors/E406.md) | 2(medium) | sha256, SHA-256, 交叉验证, 多路径, codeload, 代理, 直连, 误测, scout, recipe 创建, hash mismatch, conandata.yml | multi-path-cross-verify |
+| [E421](errors/E421.md) | 2(medium) | sourceforge, 403, forbidden, 404, cloudflare, downloads.sourceforge.net | 用 curl 请求 downloads.sourceforge.net 的短路径，从 301 Location 得到真实子目录路径， 再用真实路径 HTTP/HTTPS 直接下载；最后用 sha256 校验（可与 FreeBSD ports astro/<pkg>/distinfo 交叉核对，确认与上游同字节） |
+| [E425](errors/E425.md) | 2(medium) | pico-sdk, .gitmodules, empty submodule, tinyusb, cyw43-driver, lwip, mbedtls, btstack, Debian orig tarball, dependency split | scope-current-package-and-preserve-placeholders |
+| [E430](errors/E430.md) | 2(medium) | GitHub Release API, asset digest, sha256, Homebrew checksum, release archive | official-asset-digest-binding |
+| [E431](errors/E431.md) | 2(medium) | Conan source folder, pristine source, patch postimage, reverse replay, /dev/null addition, ordered patches | byte-proven-pristine-forward-replay |
+| [E432](errors/E432.md) | 2(medium) | native SDK, output ownership, failure status, destroy, finite coordinate, int32 overflow, checked narrowing | ownership-and-checked-narrowing |
+| [E466](errors/E466.md) | 2(medium) | python, sdist, docs, Makefile, nested source, promote, strip_root, chardet | 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 目录推断 |
+| [E475](errors/E475.md) | 2(medium) | conan source cache, patch_ng hunk mismatch, repeated create, stale postimage, explicit blank hunk record | fresh-source-and-exact-hunks |
+| [E483](errors/E483.md) | 2(medium) | BadZipFile, File is not a zip file, codeload.github.com, get(), filename, strip_root, tar.gz, tar.xz, zip, Conan, conandata, source, uncompress, download | explicit-filename-in-get |
+
+## 2-配置（187 条）
+
+| E编号 | severity | 症状关键词 | 一句话解法 |
+|---|---|---|---|
+| [E001](errors/E001.md) | 3(blocking) | cc not found, C compiler, clang, PATH, compiler, cannot create executables | set-env-var |
+| [E002](errors/E002.md) | 3(blocking) | /tmp, temporary, read-only, erofs, TMPDIR, Permission denied, tmp | set-env-var |
+| [E007](errors/E007.md) | 2(medium) | config.guess, build type, HarmonyOS, autoconf, cannot guess, unable to guess, UNAME_SYSTEM, build system type, Invalid configuration, config.sub, triplet, ohos-linux, __OHOS__, OS not recognized, basic os list | patch-autotools-script |
+| [E010](errors/E010.md) | 2(medium) | toybox, sed, expr, GNU coreutils, GNU sed, garbled, hang, stuck, unsupported command, label, branch, regex, \\| | install-gnu-tools |
+| [E011](errors/E011.md) | 3(blocking) | umask 077, Permission denied, config.status, mktemp, HMDFS, setgid, temp directory, subs1.awk, subs1.sed, confXXXXXX, cannot create temp file, chmod, drwx--S---, tmp_work | edit-umask-in-configure |
+| [E012](errors/E012.md) | 3(blocking) | ar command not found, llvm-ar, RANLIB, LLVM toolchain, NM, archive, invalid option | set-env-var |
+| [E021](errors/E021.md) | 1(minor) | BUILDEXEEXT, .exe, case insensitive, conftestdir, file system, build exe, extension, Makefile | skip-configure-test |
+| [E029](errors/E029.md) | 2(medium) | bash, malloc, musl, incompatible, --without-bash-malloc, memory management, runtime crash, glibc allocator | configure-disable-feature |
+| [E030](errors/E030.md) | 1(minor) | m32, 32-bit, personality, strace, aarch64 only, --disable-mpers, cross compile, architecture mismatch | configure-disable-feature |
+| [E035](errors/E035.md) | 3(blocking) | boost, b2, bjam, SHELL, version, error code, match-command-output | header-only-install |
+| [E036](errors/E036.md) | 2(medium) | sysconfig, get_platform, uname, space, ohos-aarch64, _sysconfigdata, BUILDEXEEXT, Python platform, path resolution | source-patch |
+| [E041](errors/E041.md) | 2(medium) | automake, version mismatch, aclocal, autoheader, autoreconf, VPATH, timestamp, Makefile.am, configure.ac | bypass-autotools |
+| [E052](errors/E052.md) | 2(medium) | HMDFS, config.status, 临时目录, Permission denied, subs1.awk, tmpdir | modify_tmpdir |
+| [E053](errors/E053.md) | 2(medium) | cc1plus, clang++, CXX, C++ compiler, autotools, unrecognized command-line option, g++, LLVM, configure | set-env-var |
+| [E058](errors/E058.md) | 3(blocking) | configure, missing, autoconf, autogen, autotools, bootstrap, development snapshot | use-stable-release |
+| [E059](errors/E059.md) | 3(blocking) | AUTOM4TE, aclocal.m4, placeholder, automake, bootstrap, configure.ac | use-stable-release |
+| [E060](errors/E060.md) | 2(medium) | config.status, Permission denied, mktemp, HMDFS, temporary, confXXXXXX | use-tmpfs-workaround |
+| [E061](errors/E061.md) | 2(medium) | gnulib, stdbool, stdbool-c99, stdbool.h, deprecated, configure detection, conftest, config.h, sed, GNU software | fix-conftest-first |
+| [E064](errors/E064.md) | 3(blocking) | conftest, cross compile, configure, autotools, ac_cv_, cache file, security dialog, Permission denied, exit 127, config.log, cannot run compiled programs | trigger-security-dialog |
+| [E070](errors/E070.md) | 2(medium) | m32, 32-bit, personality, aarch64, multiarch, cross compile, strace, --disable-mpers | reconfigure-disable-feature |
+| [E071](errors/E071.md) | 2(medium) | automake, version mismatch, requires, installed, aclocal, autoheader, autoreconf, timestamp, /bin/true | bypass-autotools-env |
+| [E072](errors/E072.md) | 3(blocking) | config.sub, invalid triplet, ohos, unknown operating system, unknown vendor, configure, autoconf, autotools, triple validation | patch-autotools-script |
+| [E075](errors/E075.md) | 2(medium) | C_INCLUDE_PATH, pkg-config, cflags empty, header not found, system include path, PKG_CONFIG_PATH, configure, cmake, environment variable trap | env-var-remove |
+| [E082](errors/E082.md) | 3(blocking) | conftest.c, gnulib, bool not detected, stdbool.h, configure second run, E064, HAVE_STDBOOL_H undef, stdlib.h no, stdint.h no, checking for bool | configure-twice |
+| [E089](errors/E089.md) | 2(medium) | aclocal, am_AUTOM4TE, autom4te, PKG_INSTALLDIR, pkg.m4, aclocal.m4, pkgconfigdir undefined, pkgconfig_DATA | replace-pkginstalldir |
+| [E090](errors/E090.md) | 3(blocking) | meson, host_system, harmonyos, linux, undefined symbol, glib, gjournal, systemd, platform detection | sed-replace |
+| [E092](errors/E092.md) | 2(medium) | CMAKE_SYSTEM_NAME, CMakeLists.txt, ohos, harmonyos, cmake, platform detection, unknown system, check_c_source_compiles, check_function_exists, HAVE_SNPRINTF, HAVE_DECL_ISNAN | cmake-toolchain |
+| [E095](errors/E095.md) | 2(medium) | lzip, custom configure, CXX, c++, CC, environment variable, hardcode, custom build system | set-env-var |
+| [E096](errors/E096.md) | 2(medium) | cmake, c++17, c++20, cmake_cxx_standard, compiler detection, standard required, abseil | cmake-cxx-standard-explicit |
+| [E097](errors/E097.md) | 2(medium) | bearssl, mk/, conf/, SingleUnix.mk, no configure, custom Makefile, manual install | custom-config-mk |
+| [E099](errors/E099.md) | 3(blocking) | b2, bjam, Boost.Build, boost, clang++ --version, Jamroot, user-config.jam, architecture detection, compiler detection, exit code 1, OHOS, aarch64-unknown-linux-ohos | use-cmake-build |
+| [E100](errors/E100.md) | 2(medium) | libjpeg-turbo, SIMD, unknown CPU, jsimd_can_, undefined symbol, simdcoverage | add-cmake-flag |
+| [E103](errors/E103.md) | 3(blocking) | cmake_minimum_required, Compatibility, CMake 4, version 3.4, 3.3, 3.2, removed, deprecated | bump-cmake-minimum-version |
+| [E105](errors/E105.md) | 3(blocking) | rust, cargo, rustc, Rust, toolchain, ELF, dynamic linker, ld-linux-aarch64.so.1, unrecognized OS type | wait-for-platform-support |
+| [E106](errors/E106.md) | 3(blocking) | GNU cat, stdout permission, SIGPIPE, configure failure, config.status, coreutils, toybox cat, PATH order | path_adjustment |
+| [E110](errors/E110.md) | 3(blocking) | HMDFS, config.status, Permission denied, confXXXXXX, temp file, autotools | use_alternate_build_dir |
+| [E112](errors/E112.md) | 3(blocking) | mktemp, Permission denied, subs1.awk, config.status, HMDFS, temporary directory, autotools | bypass-mktemp |
+| [E114](errors/E114.md) | 3(blocking) | mktemp, Permission denied, subs1.awk, config.status, HMDFS, temporary directory | bypass-mktemp |
+| [E116](errors/E116.md) | 3(blocking) | Automake::Config, automake perl, aclocal perl module, precompiled package incompatible, perl @INC | compile-automake-from-source |
+| [E117](errors/E117.md) | 2(medium) | config-cmake.h.in, PACKAGE_STRING, cmake CONFIGURE_FILE, undeclared identifier PACKAGE | create_cmake_template |
+| [E118](errors/E118.md) | 3(blocking) | HMDFS, mktemp, config.status, autotools, Permission denied, 临时目录, configure | patch-script |
+| [E122](errors/E122.md) | 2(medium) | config.sub, kernel-os, linux-ohos, Invalid configuration, not known to work, kernel validation | add-linux-ohos-to-validation |
+| [E125](errors/E125.md) | 3(blocking) | HMDFS, hmdfs, config.status, Permission denied, subs1.awk, confdir, temporary directory, config files machinery, distributed filesystem | relocate-build-dir |
+| [E126](errors/E126.md) | 3(blocking) | HMDFS, config.status, Permission denied, temporary file, autotools | use_precompiled_package          # 见 DESIGN §5 impl 列表 |
+| [E128](errors/E128.md) | 3(blocking) | go, golang, permission denied, elf签名, Go编译器, Go项目 | use-prebuilt-package |
+| [E129](errors/E129.md) | 3(blocking) | umask 077, Permission denied, config.status, mktemp, subs1.awk, HMDFS, setgid | sed-replace |
+| [E132](errors/E132.md) | 3(blocking) | LD_LIBRARY_PATH, libxml2, lld, linker, unable to link, Toolchain, ohos-sdk | set-environment-path |
+| [E136](errors/E136.md) | 2(medium) | TMPDIR, umask, mktemp, Permission denied, 临时目录, config.status, HarmonyOS权限 | patch-script |
+| [E139](errors/E139.md) | 2(medium) | GMP, gmp, shared library, static library, libgmp.so, -lgmp, precompiled package | compile-gmp-shared |
+| [E140](errors/E140.md) | 2(medium) | CMAKE_SYSTEM_NAME, HarmonyOS, OS_LINUX, platform detection, __OHOS__ | add-harmonyos-cmake-detection |
+| [E144](errors/E144.md) | 3(blocking) | cmake module missing, BuildVersion.cmake, ParseVersion.cmake, MongoPlatform.cmake, MongoSettings.cmake, mongo-c-driver, libbson, .work re-initialization | manual-build-mode-b |
+| [E145](errors/E145.md) | 3(blocking) | meson, Unknown variable, have_arm_intrinsics_or_asm, subdir, silk, celt, opus | source-patch |
+| [E146](errors/E146.md) | 2(medium) | dependency, missing, precompiled, external, Alpine, cmd-pkgs | use_precompiled_package |
+| [E149](errors/E149.md) | 1(minor) | socat, autotools, platform, success, musl, config.guess, config.sub | direct_compile |
+| [E150](errors/E150.md) | 3(blocking) | submodule, framework, git, tarball, missing directory | manual-download |
+| [E151](errors/E151.md) | 2(medium) | check_c_source_compiles, check_function_exists, HAVE_SNPRINTF, HAVE_DECL_ISNAN, cmake detection, config.h, platform detection, musl, undefined, macro redefined | manually-add-have-defines |
+| [E153](errors/E153.md) | 3(blocking) | b2, bjam, Boost.Build, boost, clang++ --version, Jamroot, user-config.jam, architecture detection, compiler detection, exit code 1, OHOS, aarch64-unknown-linux-ohos | use-cmake-build |
+| [E154](errors/E154.md) | 3(blocking) | rustc, cargo, rustup, Rust, Cargo.toml, unrecognized OS type | install-rust-prebuilt |
+| [E155](errors/E155.md) | 1(minor) | Makefile.PL, ExtUtils::MakeMaker, PERL5LIB, pure Perl, CPAN, backpan, PREFIX, INSTALL_BASE, Pod::Coverage, Devel::Symdump, Pod::Parser | perl-pure-module-build |
+| [E156](errors/E156.md) | 2(medium) | fbida, Autoconf.mk, GNUmakefile, make config, custom build system, non-standard configure | standard-fbida-config |
+| [E157](errors/E157.md) | 2(medium) | JPEG_VER, jpeg-version.sh, cpp, libjpeg, libjpeg-turbo, JPEG_LIB_VERSION, jpeg version detection | manual-jpeg-ver |
+| [E159](errors/E159.md) | 3(blocking) | TRY_RUN, cross-compiling, cmake, configuration, cache file | cmake-cache-preset |
+| [E160](errors/E160.md) | 3(blocking) | HarmonyOS, config.guess, unable to guess system type, HongMeng Kernel | config-guess-harmonyos-patch |
+| [E161](errors/E161.md) | 3(blocking) | sort, tail, grep, stdin, Permission denied, stat failed, fstat, pipe, GNU coreutils, SELinux, HarmonyOS | avoid-pipe-use-files |
+| [E165](errors/E165.md) | 3(blocking) | shebang, bash, interpreter, configure failed, exit 127, bin/bash, bin/sh, OpenHarmony, HongMeng | shebang-fix |
+| [E167](errors/E167.md) | 2(medium) | config.status, subs1.awk, Permission denied, confXXXXXX, ac_tmp, temporary directory, autotools | patch-script |
+| [E168](errors/E168.md) | 2(medium) | PostgreSQL, extension, PGXS, pg_config, topn, no configure | approach-identifier          # 见 DESIGN §5 impl 列表 |
+| [E172](errors/E172.md) | 3(blocking) | rust, cargo, rustc, Rust, toolchain, ELF, dynamic linker, ld-linux-aarch64.so.1 | wait-for-platform-support   # 见 DESIGN §5 impl 列表 |
+| [E175](errors/E175.md) | 2(medium) | HMDFS, Permission denied, confXXXXXX, mktemp, config.status | autoreconf-regenerate |
+| [E177](errors/E177.md) | 2(medium) | distutils, msvccompiler, Python3.12, ImportError | source-patch |
+| [E178](errors/E178.md) | 1(minor) | autoreconf, automake, coreutils, new toolchain | autoreconf-regenerate |
+| [E180](errors/E180.md) | 1(minor) | rust, cargo, rustc, glibc, musl, OHOS target | rust-native-compile |
+| [E181](errors/E181.md) | 2(medium) | heredoc, cat << EOF, Permission denied, HMDFS, config.mak, configure | manual-makefile-modify |
+| [E183](errors/E183.md) | 2(medium) | heredoc, cat << EOF, Permission denied, HMDFS, Python script, create_config.py | python-script-replace |
+| [E184](errors/E184.md) | 2(medium) | ant, maven, gradle, java, build.xml, pom.xml, build.gradle, command not found | manual-install-ant |
+| [E185](errors/E185.md) | 1(minor) | SSL, certificate, HTTPS, download, curl, wget, CA证书, network | set-env-var |
+| [E187](errors/E187.md) | 2(medium) | cmake, cmake_minimum_required, version compatibility, policy version minimum | add-cmake-flag |
+| [E189](errors/E189.md) | 3(blocking) | qmake, spec_pre.prf, features, Qt, mkspecs | manual-compile              # 见 DESIGN §5 impl 列表 |
+| [E191](errors/E191.md) | 2(medium) | libc++, libc++abi, clang++, unable to find library, CXX compiler, broken | approach-identifier          # 见 DESIGN §5 impl 列表 |
+| [E195](errors/E195.md) | 2(medium) | promote_nested_source, include directory missing, CMakeLists.txt path, ../include, sibling directory loss, nested source | restore-from-tarball |
+| [E204](errors/E204.md) | 2(medium) | libvpx, configure.sh, target, arm64-linux-gcc, custom configure | fix-tarball-and-specify-target |
+| [E205](errors/E205.md) | 2(medium) | OHOS, ohos-linux, HarmonyOS, triplet, config.guess, config.sub, autotools, cross-build, c__ANDROID__ Never use `--build/--host` flags ( per autotools-patterns.md #0. | patch-script |
+| [E206](errors/E206.md) | 2(medium) | HMDFS, umask 077, Permission denied, config.status, conf*, temporary directory, autotools | patch-script |
+| [E209](errors/E209.md) | 2(medium) | ltmain.sh, autogen.sh, libtool, autotools, configure.ac | manual-workaround |
+| [E216](errors/E216.md) | 1(minor) | cmake, conan, CMakeDeps, INTERFACE_INCLUDE_DIRECTORIES, glib, libxml2, components, cross_compile, GLOB, semicolon-separator | glob-fallback-with-empty-guard |
+| [E220](errors/E220.md) | 3(blocking) | perl, Configure, metaconfig, hardlink, symlink, LNS, touch, miniperl, ExtUtils::Install, installperl, POSIX::access, -w, write probe, create unlink, IPC/SysV, prctl, PR_SET_NAME, tool_requires | composite-ohos-toolchain-adaptation |
+| [E223](errors/E223.md) | 3(blocking) | HMDFS, config.status, subs1.awk, mktemp, umask 077, owner, mode, MAC label, app-private cache, fail-closed | private-cache-capability-validation |
+| [E232](errors/E232.md) | 2(medium) | Conan, Autotools.configure, configure, Permission denied, error 126, CONFIG_SHELL, settings_build.os, _configure_args | native-ohos-shell-prefix |
+| [E234](errors/E234.md) | 2(medium) | --with-pic, static library, fPIC, relocation, AutotoolsToolchain, whole-archive | preserve-conan-fpic-and-prune-project-conflict |
+| [E238](errors/E238.md) | 3(blocking) | features.h file not found, CLING_CXX_INCL, cxx-isystem, sysroot/usr/include, embedded Clang, header discovery, adjacent clang | preserve-and-merge-target-sysroot-includes |
+| [E253](errors/E253.md) | 2(medium) | ocaml, ocamlc, ocamlopt, camlrun, config.guess, unknown-unknown-linux-gnu, configure, mktemp, tmpdir, ocamltest, testsuite, make all, ocamldebug, UNIX socket, bind, Operation not permitted, create_process, posix_spawn, flambda, flat-float-array, camlPlugin, symbol not found | ohos-toolchain-migration |
+| [E254](errors/E254.md) | 3(blocking) | toybox, patch, dry-run, new-file, 污染, orig 目录, refresh-patch, patch_ng, 无法应用 | avoid-new-file-patches |
+| [E258](errors/E258.md) | 2(medium) | meson.options, meson_options.txt, both exist, same file, symlink | delete-duplicate-meson-options |
+| [E264](errors/E264.md) | 2(medium) | configure, *-config, geos-config, Conan metadata, cpp_info, HMDFS, signed ELF, dependency discovery, legacy helper | metadata-derived-native-config-adapter |
+| [E267](errors/E267.md) | 2(medium) | CMAKE_SYSTEM_NAME, OHOS, HarmonyOS, OS_LINUX, platform detection, target_compile_definitions, object library | add-harmonyos-cmake-detection |
+| [E268](errors/E268.md) | 2(medium) | config.sub, patch-autotools-ohos.pl, linux-ohos, kernel-OS check, autotools, triplet, config.guess, OHOS triplet | patch-source |
+| [E271](errors/E271.md) | 2(medium) | not a gzip file, tar Not tar, single-file release asset, uncompressed release asset | Use a custom Conan application recipe to download the official single-file asset with SHA256 verification, validate it directly, and install it under package/bin without extraction. |
+| [E273](errors/E273.md) | 2(medium) | PETSC_DIR, petscvariables, absolute prefix, Conan cache, relocation, python3 | relocate-private-dependency-copy |
+| [E277](errors/E277.md) | 2(medium) | vendored, bundled, 内嵌, 内联构建, staging, libmodbus, popt, apr, libssh, msgpack, ncurses, Required library not found, 未发布, 无配方 | build-vendored-to-staging |
+| [E278](errors/E278.md) | 3(blocking) | target_link_libraries, add_subdirectory, conditional target, if(TARGET), plain library name, unable to find library, -l | restore-cmake-target-definition |
+| [E279](errors/E279.md) | 2(medium) | patch-ng, zero-context hunk, config.guess, context anchor | context-anchored-patch |
+| [E282](errors/E282.md) | 2(medium) | conandata.yml, apply_conandata_patches, base_path, multiple sources, nested source, patch root, destination | conandata-per-patch-base-path |
+| [E283](errors/E283.md) | 3(blocking) | package_type, library, shared option, default_options | declare-shared-contract |
+| [E284](errors/E284.md) | 2(medium) | generated config header, cross compile, host probe, target capability, sparseconfig.h, u_int16_t, uint16_t, Conan | generate-target-config-header |
+| [E285](errors/E285.md) | 2(medium) | openal-soft, Null backend, loopback, No Output, ALC_SOFT_loopback, alcRenderSamplesSOFT, audio backend, ALSOFT_TESTS, sign-elf, no audio device, GoogleTest FetchContent | disable-external-backends-keep-null-loopback |
+| [E286](errors/E286.md) | 3(blocking) | enzyme, LLVMExports, LLVMDemangle, TableGen, tblgen, lit.cfg.py, lit.site.cfg.py, FileCheck, llvm-lit, llvmGetPassPluginInfo, add_llvm_library, add_public_tablegen_target, configure_lit_site_cfg, get_llvm_lit_path, check-enzyme, OHOS SDK LLVM, libLLVM-15.so, plugin, AutoDiff, LLVMConfig.cmake, AddLLVM.cmake, .inc, BlasDerivatives, CallDerivatives, BlasAttributor, BlasTA, BlasDiffUse, InstructionDerivatives, IntrinsicDerivatives, BinopDerivatives | cmake-overlay-with-stub-tblgen-and-skip-lit |
+| [E290](errors/E290.md) | 2(medium) | check_symbol_exists, typedef, type alias, check_c_source_compiles, AC_CHECK_TYPES, HAVE_KERNEL_RWF_T, __kernel_rwf_t | compile-probe-for-type |
+| [E296](errors/E296.md) | 2(medium) | Conan, MesonToolchain, Windows, OHOS, cross file, C:/, prefix, target, sysroot, llvm-ar.exe, linker, program not executable | complete-meson-cross-machine |
+| [E300](errors/E300.md) | 3(blocking) | FindFFTW.cmake, custom Find module, CMakeDeps, self.dependencies, FFTWF_INCLUDE_DIR, FFTWF_LIBRARY | cmake-cache-path-bridge |
+| [E302](errors/E302.md) | 3(blocking) | open_memstream, fclose, fflush, cookie stream, HAVE_OPEN_MEMSTREAM, empty captured output | behavior-probe-or-evidence-bound-disable |
+| [E304](errors/E304.md) | 3(blocking) | FFTW_MEASURE, FFTW_ESTIMATE, GMX_DISABLE_FFTW_MEASURE, PME, CTest timeout, repeated process startup | evidence-bound-fftw-estimate |
+| [E311](errors/E311.md) | 2(medium) | replace_in_file, self.source_folder, no_copy_source, Copying sources to build folder, source cache, package ID, editable | verify-or-enforce-source-isolation |
+| [E320](errors/E320.md) | 2(medium) | fmemopen, AC_CHECK_FUNCS, AC_RUN_IFELSE, HAVE_FMEMOPEN, runtime probe, temporary file fallback, HarmonyOS, OHOS, libc, EBADF, memory stream, configure-time probe, link-time detection | configure-runtime-probe |
+| [E323](errors/E323.md) | 2(medium) | Qt6DBus, Qt6::DBus, FEATURE_dbus, dbus/1.14.10, libdbus-1, Qt6DBusConfig.cmake, find_package(Qt6DBus, Qt component DBus missing, qtbase 配方 dbus 关闭 | (1) requirements() 新增 self.requires("dbus/1.14.10")；(2) generate() 将 FEATURE_dbus 改为 ON，并把 dbus package_folder 追加进 CMAKE_PREFIX_PATH 使 find_package(DBus1) 命中；(3) package_info() 补 dbus 组件 (libs=["Qt6DBus"], requires=["core"], cmake_target_name="Qt6::DBus")； (4) conan create 复验 libQt6DBus.so 与 Qt6DBusConfig.cmake 产出后下游 find_package(Qt6DBus REQUIRED NO_MODULE) 可消费。 |
+| [E332](errors/E332.md) | 2(medium) | BUILD_TESTING, HWY_TEST_STANDALONE, GoogleTest, gtest_discover_tests, CTest, offline | enable-native-standalone-test-runner |
+| [E334](errors/E334.md) | 3(blocking) | fastnetmon, AF_PACKET, AF_XDP, libbpf, libpcap, netmap, sflow, netflow, DDoS | feature-gate-private-network-backends |
+| [E335](errors/E335.md) | 2(medium) | HTTP, Error, 418:, teapot, Layer, Recognition | 改用 Alpine 官方 distfiles 镜像 distfiles.alpinelinux.org/distfiles/v3.24/ 分发 tarball |
+| [E338](errors/E338.md) | 3(blocking) | getpwuid, getpwnam, homedir, configdir, pw_dir, SIGSEGV, Signal 11, core dumped, ROSWELL_HOME | 首选运行时设置软件官方支持的环境变量（如 ROSWELL_HOME）注入绝对路径；若需源码适配，用 __OHOS__ 守卫在 homedir() 为 NULL 时回退到固定路径（须含实质回退逻辑，符合 R8，禁止空壳 stub） |
+| [E339](errors/E339.md) | 2(medium) | waf, waflib, Context.py, imp, imp.new_module, ModuleNotFoundError, Python 3.12, ModuleType | replace-imp-new-module |
+| [E341](errors/E341.md) | 3(blocking) | lld -flavor gnu, GNU ld fallback, BAD_COMMAND, permission denied, libxml2.so.16, LD_LIBRARY_PATH, CTest | preserve-sdk-lld-with-scoped-host-runtime |
+| [E342](errors/E342.md) | 2(medium) | BUILD_TESTING, GoogleTest, googletest, FetchContent, ExternalProject, configure-time download, offline CI, Conan test_package | disable-networked-upstream-tests-and-run-consumer-test |
+| [E343](errors/E343.md) | 2(medium) | qt_internal_add_shaders, Qt6ShaderTools_DIR, qtshadertools | CMakeToolchain 显式设 Qt6ShaderTools_DIR=<qtshadertools 包>/lib/cmake/Qt6ShaderTools + CMAKE_PREFIX_PATH |
+| [E344](errors/E344.md) | 2(medium) | ctest, integration, media backend, No backend | MANIFEST.yml 声明 excluded_upstream_tests，build() 用 ctest -R 只运行 unit 测试子集 |
+| [E346](errors/E346.md) | 3(blocking) | /bin/sh Permission denied, Error 127, make Error 127, SHELL=/bin/sh, conan create, cmake build, hmmac, try-compile, working C compiler broken, Ninja, CMAKE_MAKE_PROGRAM | cmake-generator-ninja |
+| [E347](errors/E347.md) | 2(medium) | gitlab, 418, teapot, source download, conan, urllib, anti-bot | Pre-seed conan source download cache (core.sources:download_cache, keyed by sha256) with a curl-downloaded tarball before conan create; gitlab URLs are official R39 source, cache bypasses the anti-bot 418 |
+| [E348](errors/E348.md) | 2(medium) | graphene, glib2, glib-2.0, gobject-2.0, gio-2.0, PkgConfigDeps, pkg_config_name, forwarding pc, alias-pc, pkg-config search path, meson dependency, GNOME, GLib, glib-mkenums, pango | forwarding-pc-in-generate |
+| [E355](errors/E355.md) | 3(blocking) | meson, host_machine.system, harmonyos, ohos, Unsupported platform, pkg-config, prefix=/, -I//include, boost interprocess, boost locale, libboost_locale, boost asio, boost charconv, gtest-main | patch-meson-platform |
+| [E359](errors/E359.md) | 2(medium) | HOSTCC, HOSTLD, CC_FOR_BUILD, build machine compiler, native generator, custom configure, cross compile | map-conan-build-compiler-to-upstream-host-variables |
+| [E368](errors/E368.md) | 2(medium) | Meson, --wrap, fault injection, OOM, reallocarray, mkstemps, mkdtemp, strndup, static library, shared library, MinGW, dllimport | capability-bound-fault-injection |
+| [E375](errors/E375.md) | 3(blocking) | NOT UNIX, WIN32, ProcessWin32.c, ProcessUNIX.c, tif_win32.c, tif_unix.c, capability probe | positive-win32-and-posix-capability-selection |
+| [E376](errors/E376.md) | 3(blocking) | find_library, libm, NIFTI_SYSTEM_MATH_LIB, NOTFOUND, floor, pow, sqrt, empty cache | target-evidence-bound-empty-library-cache |
+| [E379](errors/E379.md) | 3(blocking) | ITK_USE_CLANG_FORMAT, ExternalData_OBJECT_STORES, ExternalData_URL_TEMPLATES, ExternalData_NO_SYMLINKS, export_sources, test-data/Objects, Encoded/CID, base64, missing binary patch data, CID, CTest 4.4 | manifest-bound-complete-test-input-closure |
+| [E380](errors/E380.md) | 3(blocking) | ITK_COMPUTER_MEMORY_SIZE, cmake_host_system_information, TOTAL_PHYSICAL_MEMORY, MemTotal, CTest inventory | validated-explicit-memory-budget |
+| [E384](errors/E384.md) | 2(medium) | coturn, openssl, libcrypto, libssl, SSL_CFLAGS, SSL_LIBS, 自写 configure, hand-written configure, configure probe, pkg_config_name, openssl.pc, libcrypto.pc, 探测库, 覆盖变量, LDFLAGS, autotools | configure-documented-env-override |
+| [E386](errors/E386.md) | 2(medium) | capability-tested shell, getcwd, CONFIG_SHELL, SHELL, conanbuild, LOG_COMPILER, RunTest, RunGrepTest, direct ELF, HMDFS, noexec | capability-tested-shell-and-selective-dispatch |
+| [E390](errors/E390.md) | 2(medium) | unzip, zipfile, jar, java, FileNotFoundError | 用 Python zipfile.extractall 替代 unzip 解压 jar，或使用 JDK 自带 jar 工具提取 META-INF/MANIFEST.MF |
+| [E391](errors/E391.md) | 2(medium) | L0p, settings, missing_setting, compiler, build_type, JVM, java, conanfile | conanfile.py settings 声明全部四项 os/compiler/build_type/arch；JVM 应用不受影响（构建时不使用编译器设置） |
+| [E393](errors/E393.md) | 2(medium) | libsndfile, CMakeAutoGen, CMAKE_MODULE_PATH, ctest, binary-sign-tool, .codesign | resolve-cmake-helper-relative-to-list-dir |
+| [E399](errors/E399.md) | 2(medium) | epoll-shim, ctest, signalfd, kqueue, header-only, INTERFACE, BUILD_TESTING | Set BUILD_TESTING=True. Use self.run(ctest, ignore_errors=True) in build() since failures are behavioral not compile errors. Exclude signalfd blocking tests with -E regex. Set CTEST_TIMEOUT=30 via tc.cache_variables. |
+| [E407](errors/E407.md) | 2(medium) | AC_CHECK_FUNCS, HAVE_PTHREAD_CANCEL, pa_unix_util.c, paqa_errs, ALSA, JACK, OSS, ASIHPI | configure-feature-probe |
+| [E409](errors/E409.md) | 3(blocking) | BLACS, runtest.cmake, TESTSTRING, list APPEND, RUNTIMEDIR, OUTPUTDIR, $ORIGIN, MPI_Abort, FLUSH, OUTNUM | preserve-runtime-quote-empty-flush-before-abort |
+| [E412](errors/E412.md) | 2(medium) | optional dependency, OpenSSL, libcrypto, configure autodetect, static package, undeclared dependency, worker environment | explicit-optional-backend-policy |
+| [E424](errors/E424.md) | 3(blocking) | pico-sdk, commands.json, R38, L0k, CLI tool, application, bindirs, pioasm | add-software-level-commands-json |
+| [E427](errors/E427.md) | 2(medium) | pico-sdk, shadow CI, isolated HOME, CONAN_HOME, PYTHONPATH, distro, conan 2.29.1, pip timeout, files.pythonhosted.org | isolate-cache-keep-python-import-path |
+| [E433](errors/E433.md) | 1(minor) | gpgmepy, gpgme-config, config-overrides, prefix=/, setup.py, gpgme.h, SWIG, cflags | config-overrides-wrapper |
+| [E435](errors/E435.md) | 2(medium) | gpgrt-config, /bin/sh, mksh, here-doc, read loop, hang, gpg-error-config, config script, bash wrapper | build-local-bash-wrapper |
+| [E437](errors/E437.md) | 2(medium) | 6.11, qtcore5compat, tarball，configure, Layer, Recognition, severity: | conandata url 用 qt5compat-everywhere-src-6.11.1.tar.xz，conan 包名用 qtcore5compat |
+| [E438](errors/E438.md) | 2(medium) | 子模块构建找不到, harmonyos-clang, mkspec, Qt6Config, Layer, Recognition | CMakeToolchain 设 Qt6_DIR=qtbase 包 lib/cmake/Qt6 + QT_QMAKE_TARGET_MKSPEC=harmonyos-clang + CMAKE_FIND_ROOT_PATH_MODE_PACKAGE=BOTH |
+| [E439](errors/E439.md) | 2(medium) | 子模块可选组件误设为, REQUIRED, 导致依赖膨胀, Layer, Recognition, severity: | qtcore5compat 配方仅 requires qtbase/6.11.1，无需额外 Qt 模块 |
+| [E440](errors/E440.md) | 2(medium) | Failed, find, required, component, "Help", Qt6Help_DIR | test_package 改用实际产出的 Qt6::UiTools（QUiLoader）+ find_package(Qt6 COMPONENTS UiTools) |
+| [E441](errors/E441.md) | 2(medium) | Failed, find, required, component, "Sql", Qt6Sql_DIR | 创建 qtbase-sql-dbus/6.11.1 变体（FEATURE_sql=ON、FEATURE_dbus=ON + dbus/1.14.10 依赖，参照 qtbase-gui 变体先例） |
+| [E443](errors/E443.md) | 3(blocking) | HMFS, cross-UID, Conan cache, native launcher, gettextize, libtoolize, aclocal, automake, glib-genmarshal, glib-mkenums, relocatable tools | task-local-native-interpreter-and-relocation-closure |
+| [E448](errors/E448.md) | 3(blocking) | GNUSTEP_MAKEFILES, GNUSTEP_SYSTEM_ROOT, GNUSTEP_CONFIG_FILE, GNUSTEP_INSTALLATION_DOMAIN, gnustep-make, GNUmakefile, SYSTEM domain, LD_LIBRARY_PATH | conan-gnustep-make-domain-closure |
+| [E451](errors/E451.md) | 2(medium) | find_package(Clang), CMakeDeps, CMakeToolchain, CMAKE_PREFIX_PATH, ClangConfig.cmake, LLVMConfig.cmake, clangIndex, clang-cpp, CLANG_LINK_CLANG_DYLIB, LLVM_LINK_LLVM_DYLIB, rapidjson, RapidJSON_INCLUDE_DIRS, cmake_find_mode, LLVMVersionMajor | cmake-only-cmake-toolchain     # 只用 CMakeToolchain，不用 CMakeDeps |
+| [E455](errors/E455.md) | 2(medium) | libstdc++, libc++, invalid library name, conan profile, libcxx, OHOS, clang, CMakeToolchain, compiler check broken | use-ohos-profile-libcxx |
+| [E456](errors/E456.md) | 2(medium) | CMAKE_AUTOMOC_EXECUTABLE, CMAKE_AUTORCC_EXECUTABLE, CMAKE_AUTOUIC_EXECUTABLE, Qt5, moc, rcc, uic, host tools, AArch64, Windows | separate-target-qt-and-native-host-tools |
+| [E458](errors/E458.md) | 3(blocking) | restinio, header-only, C++14, sendfile, SIGSEGV, Signal 11, broken pipe, read_until, End of file, http-parser, asio, fmt, RESTINIO_FIND_DEPS, RESTINIO_USE_EXTERNAL_HTTP_PARSER, externals.rb, dependency closure, ohpcd, HTTP server, 127.0.0.1 | probe-only-then-publish-deps |
+| [E459](errors/E459.md) | 3(blocking) | WITHOUT_SERVER, OHOS, HMDFS, TARGET_FILE, FindCurses, MYSQL_CHECK_RPC, bundled, try_run, client library, target usage requirements, SunRPC | semantic-client-graph-pruning |
+| [E460](errors/E460.md) | 2(medium) | Git snapshot, generated configure, Makefile.in, bootstrap, bootstrap.conf, gnulib, automake, libtool, gettext, m4, --skip-po, NLS, source tag, generated files | pinned-gnulib-bootstrap-toolchain |
+| [E463](errors/E463.md) | 2(medium) | gtk, GTK+, Broadway, X11, Wayland, HMDFS, glib-compile-resources, GtkWindow | broadway-headless-consumer-probe |
+| [E467](errors/E467.md) | 2(medium) | AutotoolsDeps, LIBS, AC_PROG_CC, cross compiling, conftest, dependency closure, configure rc=77, OHOS | read-config-log-then-fix-loader |
+| [E468](errors/E468.md) | 2(medium) | PkgConfigDeps, PKG_CONFIG_PATH, generators_folder, PKG_CHECK_MODULES, util-macros, xorg-macros, autotools, OHOS | append-generators-folder-to-pkg-config-path |
+| [E480](errors/E480.md) | 3(blocking) | Xcomposite, Xcomposite.h, Xfixes.h, PKG_CHECK_MODULES, xfixes, transitive_headers, cmd-pkgs, Track B, libXcomposite.so.1, headers-only, CFLAGS only | same-track-transitive-headers |
+| [E481](errors/E481.md) | 2(medium) | MesonToolchain, cc.find_library, libm, bionic, shared_library version, llvm-ar, llvm-ranlib, binary-sign-tool, TMPDIR | shared-only-meson-toolchain-with-llvm-tools |
+| [E482](errors/E482.md) | 2(medium) | heredoc, here document, TMPPREFIX, zsh, TMPDIR, read-only, zsh daemon | set-env-var |
+| [E484](errors/E484.md) | 2(medium) | patch, dry-run, .orig, refresh-patch, source/target file does not exist | baseline-restore |
+| [E487](errors/E487.md) | 2(medium) | Qt6LinguistTools, LinguistTools, qt6linguisttools, qttools, ECMPoQmTools, poqm, lrelease, lupdate, lconvert, tool_requires, Qt6LinguistTools_DIR, Qt6_DIR, find_package | qt6linguisttools-tool-require-plus-pin-DIR |
+| [E490](errors/E490.md) | 2(medium) | Autotools, configure, config.guess, config.sub, install-sh, missing, chmod, stat.S_IXUSR, OHOS, HMDFS, make check | restore-known-autotools-script-modes |
+| [E491](errors/E491.md) | 2(medium) | swftools, Autotools, configure, HMDFS, TMPDIR, umask, fno-common, DESTDIR, Makefile.in, Conan, OHOS | patch-each-autotools-failure-layer-and-run-end-to-end |
+| [E494](errors/E494.md) | 2(medium) | __start___debug, __stop___debug, gc-sections, nostart-stop-gc, undefined symbol | LDFLAGS 增加 -Wl,-z,nostart-stop-gc |
+| [E495](errors/E495.md) | 2(medium) | QT_HOST_PATH, cross compile Qt, Qt6, CMAKE_SYSTEM_NAME, mkspec | 本机同架构（如 OHOS aarch64 host=target）时设 QT_HOST_PATH=qtbase 前缀；conan 配方中改用 CMAKE_PREFIX_PATH 指向 qtbase 包 + QT_QMAKE_TARGET_MKSPEC=harmonyos-clang 即可，无需 QT_HOST_PATH |
+| [E496](errors/E496.md) | 2(medium) | SO_PRIORITY, setsockopt, Operation not permitted, EPERM, CAP_NET_ADMIN | setsockopt 调用对 EPERM/EACCES 视为尽力而为(不致命), 与 ENOTSOCK 同等处理 |
+| [E500](errors/E500.md) | 2(medium) | MAX_INPUT, undeclared identifier, musl, _POSIX_MAX_INPUT | 源文件加 #ifndef MAX_INPUT #define MAX_INPUT _POSIX_MAX_INPUT #endif |
+| [E505](errors/E505.md) | 1(minor) | LD_LIBRARY_PATH, DT_RPATH, DT_RUNPATH, rpath, symlink alias, soname, needed by, materialised view, disable-new-dtags, conan create, autotools | materialised-signed-runtime-view |
+| [E506](errors/E506.md) | 3(blocking) | arm_neon.h, CMAKE_SYSTEM_PROCESSOR, arm_init.c, filter_neon_intrinsics.c, palette_neon_intrinsics.c, undefined symbol | compiler-capability-backed-neon-source-selection |
+| [E507](errors/E507.md) | 3(blocking) | pthread_setcancelstate, CheckCXXSymbolExists, Threads::Threads, BOOST_SP_THREAD_SLEEP_NO_PTHREAD_SETCANCELSTATE, KWStyle | link-aware-symbol-capability-selection |
+| [E508](errors/E508.md) | 3(blocking) | glib, g_libintl, libintl, gettext, meson, host_machine, host_system, harmonyos, gnome, gtk, pango, intl-wrapper | intl-wrapper |
+| [E514](errors/E514.md) | 2(medium) | libtoolize, ltmain.sh, install.sh, aux dir, autoreconf, autotools, putting auxiliary files, required file ltmain.sh not found | ensure-install-sh-in-source-root |
+| [E517](errors/E517.md) | 1(minor) | codesign, binary-sign-tool, selfSign, Permission denied, dlopen, shared library, published package, signature invalid, E135 | remove-then-resign-in-task-local-view |
+| [E520](errors/E520.md) | 2(medium) | qsb, Error relocating, LD_LIBRARY_PATH, libQt6ShaderTools | build() 中用 cmake -E env LD_LIBRARY_PATH=<qtbase lib>:<qtshadertools lib> cmake --build |
+| [E521](errors/E521.md) | 2(medium) | libtoolize, SED, ltmain.sh, hardcoded path, autoreconf, automake, auxdir, autoconf | export-env-tools |
+| [E526](errors/E526.md) | 3(blocking) | apply_conandata_patches, patch_ng, strip=0, a//b/, git format-patch, conandata.yml, dry-run, patch level, target file not found | mirror-strip-0-patch-semantics-in-pre-ci |
+| [E527](errors/E527.md) | 3(blocking) | gtk, gtk+, gdk, broadway, broadwayd, X11, wayland, quartz, win32, epoxy, libepoxy, display backend, glib-mkenums, glib-genmarshal, native wrapper, PkgConfigDeps, alias-pc, forwarding pc, gtk+-3.0.pc, GUI, klavaro | broadway-backend-native-tools-wrapper |
+| [E528](errors/E528.md) | 3(blocking) | libunwind, Autotools, config.status, llvm-ar, llvm-ranlib, mktemp, TMPDIR, replace_in_file, HMDFS, /data/storage/el2/base, /data/service/hnp/bin, shadow CI | recipe-local-ohos-autotools-env-closure |
+| [E538](errors/E538.md) | 2(medium) | pangomm, harfbuzz, glib, glibmm, cairomm, pango, cppstd=17, libc++, profile, shared, options conflict, package ID, pangocairo.pc, gmmprocdir, extra_defs, binary-sign-tool, musl | published-binary-wait-plus-meson-pkgconfig-fixes |
+| [E542](errors/E542.md) | 2(medium) | Qt6LinguistTools, LinguistTools, qttools, lrelease, lupdate, lconvert, ECMPoQmTools, ecm_install_po_files_as_qm, find_package Qt6 LinguistTools, Qt6LinguistToolsConfig.cmake, provider recipe | provider 配方复用已发布父模块制品：conanfile.py name=qt6linguisttools （slug 全小写 L0m-5），requires(qttools, qtbase)，build() 仅 apply_conandata_patches，package() 从 qttools 依赖包复制 lib/cmake/Qt6LinguistTools/* 与 bin/{lrelease,lupdate,lconvert,lcheck, ltext2id}，package_info 暴露 linguisttools 组件（Qt6::LinguistTools）+ env_info.PATH。 |
+| [E543](errors/E543.md) | 2(medium) | AC_TRY_RUN, cross compiling, configure.in, flex, bison, yacc, lex, tool_requires, guint64, test_package, no make check | patch-configure-cross-branch |
+
+## 3-编译（96 条）
+
+| E编号 | severity | 症状关键词 | 一句话解法 |
+|---|---|---|---|
+| [E005](errors/E005.md) | 2(medium) | -fPIC, relocation, R_AARCH64, PIC, static library, shared library, position independent | add-cflags |
+| [E008](errors/E008.md) | 2(medium) | fstat, EACCES, Permission denied, pipe, terminal, socket, STDOUT_FILENO, lseek, errno=13, ohos_fstat, st_blksize | source-patch |
+| [E016](errors/E016.md) | 2(medium) | assembler, unknown instruction, ARM mode, disable-asm, no-asm, assembly code, processor not support, inline asm | reconfigure-no-asm |
+| [E020](errors/E020.md) | 2(medium) | _IO_FILE, _IO_read_ptr, _IO_write_ptr, musl, glibc, opaque type, incomplete definition, undeclared, struct __FILE, stdio internals | source-patch |
+| [E025](errors/E025.md) | 1(minor) | CAN socket, CAN_RAW_FD_FRAMES, CAN_RAW_JOIN_FILTERS, undeclared, pyconfig.h, HAVE_LINUX_CAN, kernel header, configure detection mismatch | fix-configure-detection |
+| [E026](errors/E026.md) | 2(medium) | TLS, __thread, _Thread_local, thread_local, tls_model, glibc extension, musl, pthread | use-standard-tls |
+| [E032](errors/E032.md) | 2(medium) | _GNU_SOURCE, _BSD_SOURCE, DIR, opendir, readdir, dirent, unknown type, undeclared, musl, gawk | add-cflags |
+| [E033](errors/E033.md) | 2(medium) | cchar_t, setcchar, ncurses, wide char, _XOPEN_SOURCE_EXTENDED, _XOPEN_SOURCE, musl, Python curses, undefined reference | add-cflags |
+| [E062](errors/E062.md) | 2(medium) | FLEXIBLE_ARRAY_MEMBER, FAM, flexmember, gnulib, C99, dfa.h, xalloc.h, include order, sed, undeclared identifier | add-cflags-or-fix-include |
+| [E063](errors/E063.md) | 2(medium) | -Werror, warning to error, int-conversion, incompatible-pointer-types, implicit-function-declaration, format-truncation, musl, clang, CFLAGS, Makefile | add-cflags-disable-werror |
+| [E065](errors/E065.md) | 2(medium) | gnulib, xzalloc, xmemdup, xalloc, size_t, stddef.h, include order, CPPFLAGS, sed, compile.c, undeclared | fix-cppflags-or-reconfigure |
+| [E069](errors/E069.md) | 2(medium) | automake, circular dependency, Makefile.in, regenerate, @am_, gen-all.pl, timestamp | use-gen-perl-script |
+| [E074](errors/E074.md) | 2(medium) | make -j, parallel, FIFO, jobserver, hang, stuck, pipe, Permission denied, SELinux, concurrent build, GNU make | env-var-override |
+| [E081](errors/E081.md) | 1(minor) | secure_getenv, __libc_secure_getenv, musl, tmpdir.c, undeclared, implicit function declaration, libc, TMPDIR, gnulib, path_search | source-patch |
+| [E084](errors/E084.md) | 2(medium) | JNA, JNI, Java, javac, jar, libjnidispatch, libffi, ffi_closure, callback, Native.load, Java Native Access, TEMPLATE, Version.java | manual-java-native-build |
+| [E085](errors/E085.md) | 2(medium) | pthread_cancel, pthread_testcancel, pthread_setcancelstate, pthread_setcanceltype, undefined symbol, PTHREAD_IN_USE_DETECTION, posix-lock, musl, weak symbol, pthread threading detection, lock hard, _hard | define-pthread-detection-hard |
+| [E086](errors/E086.md) | 2(medium) | struct ucred, SO_PEERCRED, SCM_CREDENTIALS, assuan-socket, peer credentials, local socket cred, socket server, __OHOS__ | ohos-guard-ucred |
+| [E091](errors/E091.md) | 2(medium) | sockaddr_storage, redefinition, linux/socket.h, sys/socket.h, netlink, harmonyos, conflicting types, libusb, usbutils | define-guard |
+| [E093](errors/E093.md) | 2(medium) | getpass, GNU extension, musl, missing function, undeclared, implicit function declaration | source-patch |
+| [E094](errors/E094.md) | 2(medium) | pthread_attr_setaffinity_np, GNU extension, musl, thread affinity, CPU affinity, undeclared, CPU_SETSIZE, cpu_set_t, sched_getaffinity, sched_setaffinity, CPU_COUNT, CPU_ZERO, CPU_SET | source-patch |
+| [E102](errors/E102.md) | 2(medium) | mmsghdr, recvmmsg, sendmmsg, batch message, UDP, high performance, incomplete type, undeclared, musl, __linux__, __OHOS__ | exclude-ohos-from-linux-conditionals |
+| [E109](errors/E109.md) | 3(blocking) | fortran, gfortran, \.f文件, fortran编译器缺失, F77, F90, F95 | use-prebuilt-package |
+| [E111](errors/E111.md) | 2(medium) | python, pip, gssapi, krb5, kerberos, requests_gssapi, python-ldap, 系统库依赖, 编译依赖 | add-deps |
+| [E113](errors/E113.md) | 2(medium) | u_int, u_long, u_char, caddr_t, BSD类型, compat头文件, OHOS | add-cflags |
+| [E115](errors/E115.md) | 2(medium) | fallocate, FALLOC_FL_ZERO_RANGE, FALLOC_FL_INSERT_RANGE, FALLOC_FL_UNSHARE_RANGE, undeclared identifier, __OHOS__ | source-patch |
+| [E119](errors/E119.md) | 3(blocking) | sockaddr_storage, redefinition, linux/socket.h, sys/socket.h, OpenHarmony, OHOS | macro-guard-skip-header |
+| [E127](errors/E127.md) | 3(blocking) | pthread_cancel, pthread_setcanceltype, pthread_setcancelstate, undeclared identifier, HarmonyOS, OpenMP | undef-macro |
+| [E130](errors/E130.md) | 3(blocking) | nullptr_t, __abi_tag__, libcxx-ohos, c++17, c++11, OHOS SDK | change-cxx-standard |
+| [E133](errors/E133.md) | 3(blocking) | musl, stddef.h, stdlib.h, pthread.h, sysroot conflict, isystem, nullptr_t | temp-move-musl-headers |
+| [E138](errors/E138.md) | 3(blocking) | CLOCK_REALTIME, CLOCK_MONOTONIC, clock_gettime, timespec, time.h, POSIX timer | disable-posix-timer |
+| [E147](errors/E147.md) | 2(medium) | CPU_SETSIZE, cpu_set_t, sched_getaffinity, sched_setaffinity, CPU_COUNT, CPU_ZERO, CPU_SET, CPU affinity, undeclared, musl, __linux__, __OHOS__ | source-patch |
+| [E148](errors/E148.md) | 2(medium) | mmsghdr, recvmmsg, sendmmsg, batch message, UDP, high performance, incomplete type, undeclared, musl, __linux__, __OHOS__ | exclude-ohos-from-linux-conditionals |
+| [E152](errors/E152.md) | 2(medium) | CLOCK_REALTIME, CLOCK_MONOTONIC, clock_gettime, undeclared identifier, musl, POSIX timer | add-cflags |
+| [E158](errors/E158.md) | 2(medium) | fbida, libexif, pkg-config, exif-data.h, exiftran, thumbnail.cgi, GNUmakefile, CFLAGS, missing header | patch-gnu-makefile |
+| [E162](errors/E162.md) | 2(medium) | SSL_OP_NO_RENEGOTIATION, SSL_trace, SSL_get1_peer_certificate, OpenSSL 3.5, undeclared identifier | source-patch |
+| [E163](errors/E163.md) | 2(medium) | __packed, duplicate symbol, binder.h, userfaultfd.h, OpenHarmony header | source-patch |
+| [E164](errors/E164.md) | 3(blocking) | adjtime, adjtimex, time adjustment, syscall | source-patch                  # 见 DESIGN §5 impl 列表 |
+| [E169](errors/E169.md) | 3(blocking) | argp.h, fatal error, file not found, GNU argp, command-line parsing | install-prebuilt-package |
+| [E171](errors/E171.md) | 3(blocking) | euidaccess, undeclared identifier, eaccess, unistd.h, OpenHarmony, permission check | source-code-patch |
+| [E176](errors/E176.md) | 3(blocking) | ICU, stubdata, libicudata, dynamic linker, bootstrap, static, data packaging | static-build-with-static-data |
+| [E190](errors/E190.md) | 3(blocking) | Perl XS, Makefile.PL, CCFLAGS, LDDLFLAGS, nostdlib, errno.h, crti.o | perl-xs-build-params |
+| [E192](errors/E192.md) | 3(blocking) | pthread_mutexattr_setrobust, PTHREAD_MUTEX_ROBUST, musl, robust mutex, HarmonyOS | source-patch |
+| [E194](errors/E194.md) | 3(blocking) | musl, bits/alltypes.h, sys/types.h, Perl XS, header missing, OpenHarmony SDK, DateTime | platform-limitation-record    # 见 DESIGN §5 impl 列表 |
+| [E196](errors/E196.md) | 3(blocking) | std::size_t, size_t, musl, C++, HarmonyOS, header | source-patch |
+| [E197](errors/E197.md) | 2(medium) | Wmismatched-tags, conflicting declaration, struct, class, forward declaration, FHTransform | source-patch |
+| [E198](errors/E198.md) | 2(medium) | Wdeprecated-copy, deprecated copy, assignment operator, implicitly declared, FHTransform | source-patch |
+| [E199](errors/E199.md) | 1(minor) | U16_NEXT, expected semicolon, missing semicolon, ICU macro, unicode | source-patch |
+| [E203](errors/E203.md) | 2(medium) | getprogname, __progname, musl, poll.h, sys/poll.h, redirect, OpenHarmony, OHOS, -W#warnings | source-patch |
+| [E211](errors/E211.md) | 2(medium) | pthread_getaffinity_np, pthread_setaffinity_np, musl, affinity, undeclared identifier, sched_setaffinity, sched_getaffinity | replace-with-sched-api |
+| [E219](errors/E219.md) | 2(medium) | no non-sandbox python3, /data/app/bin/python3, E212, verify-elf-only, nanobind, HNP buildenv, jupyter-events, rpds | e212-verify-elf-fallback |
+| [E235](errors/E235.md) | 3(blocking) | OpenSSL, OHOS, __fd_chk, rand_unix.c, RAND_bytes, FD_SET, DEVRANDOM_WAIT, getrandom, libcrypto.a | select-supported-getrandom-seed |
+| [E240](errors/E240.md) | 2(medium) | CoreGraphics, ApplicationServices, CGDisplay, NativeDisplayManager, display resolution, mode setter, unsupported boundary, screenresolution | capability-split-with-negative-tests |
+| [E245](errors/E245.md) | 3(blocking) | vhangup, SYS_vhangup, __NR_vhangup, tty hangup, undefined symbol, undeclared function, OHOS, HarmonyOS, syscall shim, 未导出, 无声明, 链接失败, libc.so, aarch64-linux-ohos | ohos-syscall-shim |
+| [E248](errors/E248.md) | 2(medium) | automake, command not found, Makefile.in, Makefile.am, missing automake, Error 127, regenerate, timestamp, mtime, patch order | fix-mtime-after-patch |
+| [E250](errors/E250.md) | 3(blocking) | go, golang, go toolchain, go not found, build tool missing, command not found, Go compiler | download-go-sdk |
+| [E252](errors/E252.md) | 2(medium) | version-only smoke, ROM, firmware, model data, external asset, context lifecycle, missing asset, public inventory, consumer test | substantive-pre-asset-lifecycle-flow |
+| [E288](errors/E288.md) | 2(medium) | CMake, BUILD_SHARED_LIBS, static, shared, single artifact | single-cmake-library-target |
+| [E293](errors/E293.md) | 2(medium) | dynamic exception specifications, register storage class, C++17, throw(, Wdynamic-exception-spec, Wregister, 2003, legacy code, old C++, compiler.cppstd, cppstd=17 | toolchain-flag |
+| [E313](errors/E313.md) | 3(blocking) | msgpack, stdckdint.h, ruby, gem, extconf, C23, musl, stdckdint, C 扩展, install | stdckdint-shim-plus-install-override |
+| [E330](errors/E330.md) | 2(medium) | CMake, SONAME, symlink, cmake_symlink_library, CMAKE_PLATFORM_NO_VERSIONED_SONAME, CMAKE_SHARED_LIBRARY_SONAME_C_FLAG, DT_NEEDED, HMDFS, expat | no-versioned-soname-keep-soname-flag |
+| [E351](errors/E351.md) | 2(medium) | GsfOutput, gsf_output_write, gsf_output_seek, gsf_output_tell, xxx_UT_DEBUGMSG, UT_ASSERT, gsf_off_t, AbiWord plugin, ie_exp, IE_Exp, export plugin, PalmDoc, compat shim | extend-compat-shim-export-direction |
+| [E356](errors/E356.md) | 2(medium) | chibicc, compiler package, x86-64 output, OHOS armv8, high difficulty, source-owned closure, native glibc execution, target header blocker, exact XFAIL, blocking XPASS, ABI mismatch, R39 | two-plane-fixed-target-validation |
+| [E358](errors/E358.md) | 2(medium) | Rust, Cargo.lock, nix, libc, ctrlc, target_env=ohos, --locked, legacy lock graph | semver-bounded-deterministic-lock-migration |
+| [E367](errors/E367.md) | 2(medium) | unknown, type, name, 'Dl_info', Layer, Recognition | include dlfcn.h 前先 #define _GNU_SOURCE，include 后 #undef |
+| [E373](errors/E373.md) | 2(medium) | ConanFile.run, conanbuild, build scope, Meson introspection, subprocess.run, PATH, StringIO, Buildbot | conan-self-run-captured-introspection |
+| [E383](errors/E383.md) | 2(medium) | SONAME, CMAKE_SHARED_LIBRARY_SONAME_C_FLAG, Platform/HarmonyOS, readelf -d, libyajl.so, no SONAME, soname_gate | conan-recipe-soname-flag |
+| [E385](errors/E385.md) | 2(medium) | aws-lc-sys, Cargo build.rs, cmake crate, OHOS_NDK_HOME, ohos.toolchain.cmake, CMAKE_RANLIB, CMAKE_C_COMPILER_RANLIB, llvm-ar s, static archive index | target-scoped-cmake-toolchain-overlay |
+| [E388](errors/E388.md) | 2(medium) | Boost.Math, long double, BOOST_MATH_PROMOTE_DOUBLE_POLICY, halley_iterate, non_central_chi_squared, evaluation_error, HarmonyOS PC | disable-boost-math-double-promotion |
+| [E397](errors/E397.md) | 2(medium) | missing typename, dependent type name, P0634R3, typename elision, C++20 clang | Add 'typename' keyword before all dependent type names in source headers. Three patterns: (1) using X = Y<...>::type -> using X = typename Y<...>::type; (2) using X = Y::template Z<...> -> using X = typename Y::template Z<...>; (3) using X = alloc_traits::member -> using X = typename alloc_traits::member. Apply systematically using clang error output to locate all positions. |
+| [E400](errors/E400.md) | 2(medium) | ai-cli, Node.js, Bun 1.3.9, V8 JIT, jitless, Signal 5, WebAssembly, OpenH264, Conan package cache, cross-UID, launcher, shadow CI | capability-matrix-and-package-folder-consumer-test |
+| [E402](errors/E402.md) | 2(medium) | gzip, toybox, GZIP_MAN, --force, --best, short option, -f -9, unrecognized option, Unknown option, man pages, install-no-strip | recipe-patch-gzip-short-options |
+| [E420](errors/E420.md) | 2(medium) | legacy C, transitive declaration, implicit int, direct include, libgsf, gsf-doc-meta-data.h, wvSummary.c, int conversion | include-api-owning-public-header |
+| [E422](errors/E422.md) | 2(medium) | winerror | 添加平台条件编译宏，隔离 Windows 特有代码 |
+| [E426](errors/E426.md) | 2(medium) | pico-sdk, pioasm, tools/pioasm, PIOASM_VERSION_STRING, PIOASM_GENERATE_PARSER, host tool, RP2040, RP2350, bare-metal | cmake-subproject-application-package |
+| [E434](errors/E434.md) | 2(medium) | copystamp, VPATH, in-tree, automake, cp same file, gpgmepy, distutils | vpath-build |
+| [E447](errors/E447.md) | 3(blocking) | SDL2, SDL2_image, SDL2_mixer, FindSDL2.cmake, vendored Find module, CMakeDeps, INTERFACE_INCLUDE_DIRECTORIES, transitive dependency, static library, libwebp, libtiff, SDL_audio.h, SDL_gamecontroller.h, cache variable bridge, nanopb pre-generated, user_presets_path | conan-recipe cache-variable bridge (E300 扩展) |
+| [E449](errors/E449.md) | 3(blocking) | libobjc2, Objective-C runtime, -fobjc-runtime=gcc, -fconstant-string-class=NSConstantString, -fblocks, Foundation, NSConstantString, LD_LIBRARY_PATH, runenv_info | objc-runtime-flags-in-package-info |
+| [E450](errors/E450.md) | 3(blocking) | avr-libc, OHOS host, AVR target, cross sysroot, avr-gcc -B, unprefixed as ld nm, linker scripts, multilib, weak symbol, source coverage | cross-target-resource-boundary-and-explicit-driver-dispatch |
+| [E469](errors/E469.md) | 2(medium) | cpp-httplib, httplib, bind_port, bind_to_any_port, bind_to_port, Server, test_package, port binding | use-bind-to-any-port |
+| [E470](errors/E470.md) | 2(medium) | cppitertools, itertools, header-only, Bazel BUILD, BUILD file, case-insensitive, 大小写不敏感, cmake_layout, build_folder, provenance, version metadata, tag mismatch, conanfile version | tag-as-provenance-source + non-default-cmake-build-folder + header-library-recipe |
+| [E473](errors/E473.md) | 3(blocking) | SDL2_image, SDL_image, WebP::webp, WebP::webpdemux, libwebp, libwebpdemux.so, CMakeDeps, cmake_build_modules, Findwebp.cmake, webp_INCLUDE_PATH, webpdemux_INCLUDE_PATH, imported target, CMAKE_FIND_PACKAGE_PREFER_CONFIG | conan-recipe build-module imported-target injection (cmake_build_modules) |
+| [E476](errors/E476.md) | 2(medium) | OHOS, HarmonyOS, OpenHarmony, max_align_t, max_alignment, posix_memalign, is_aligned, malloc_allocator, heap_allocator, new_allocator | source-code-patch |
+| [E485](errors/E485.md) | 2(medium) | OHOS, hardware, peripheral, stub, usb, libusb, undefined reference, header missing, AC_CHECK_LIB | stub 绕过（生成 stub 外设头（声明外设 API）+ stub 实现（返回 -1/0——无硬件——功能不实际使用）——CPPFLAGS -I stub + 编译 stub 对象 + 链接追加（make LIBS/LDFLAGS）） |
+| [E486](errors/E486.md) | 1(minor) | GCC bootstrap, build-generated host executable, first execution, compiler wrapper, ELF EXEC, ELF DYN, .codesign, binary-sign-tool, avr-gcc, cc1, xgcc, native driver, target object, tool_requires | link-interception-sign-before-first-exec |
+| [E493](errors/E493.md) | 2(medium) | undeclared, identifier, 'program_invocation_name', OHOS, musl, libc | __OHOS__ 下改用 __progname（extern "C" char *__progname） |
+| [E501](errors/E501.md) | 2(medium) | make, cmake, clang, lld, libxml2, LD_LIBRARY_PATH, lua, runner, test_package | direct-compile-source-list-and-wrap-link-env |
+| [E510](errors/E510.md) | 2(medium) | toybox patch, GNU patch, gpatch, libquickjs-sys, bundled patches, fuzz, Hunk FAILED, path strip, strip-components, patch -p1 | prepend-harmonybrew-gnu-patch |
+| [E511](errors/E511.md) | 3(blocking) | Meson, shared library, versioned .so, libfoo.so, symlink, HMDFS, HarmonyOS, cannot find -l, package lib, build tree | materialize-versioned-so-aliases |
+| [E512](errors/E512.md) | 2(medium) | pure python, build self-check, import, runtime python package, unidecode, pyyaml, CI worker, clean environment, ModuleNotFoundError, pip install, local pass CI fail | add-deps |
+| [E513](errors/E513.md) | 2(medium) | pthread_cancel, pthread_setcanceltype, JACK_DISABLE_PTHREAD_CANCEL, pthread_kill, pthread_join, SIGUSR1, joinable thread, thread exit | guarded-signal-thread-exit |
+| [E516](errors/E516.md) | 2(medium) | _res, __res_state, resolv, ip_options, linux/ip.h, OHOS, libc, resolver state | provide-custom-resolver-state |
+| [E522](errors/E522.md) | 2(medium) | dependency_libs, stale Conan cache, libX11.la, libxcb.la, transitive .la, libtool shadow, PurePosixPath, Windows UNC, task-local cache | task-local-recursive-libtool-shadow |
+| [E524](errors/E524.md) | 1(minor) | SYS_PREFIX, shared prefix, C compiler cannot create executables, conftest, uuid_generate_random, libjansson, sqlite3, libedit, libxml2, ncurses, e2fsprogs, build_folder, os.access X_OK, HMDFS, dependency provisioning | private-prefix-injection |
+| [E525](errors/E525.md) | 2(medium) | make -j, nproc, -j1, FIFO, jobserver, 7zip, Makefile, OHOS, 并行构建 | force-j1 |
+| [E532](errors/E532.md) | 3(blocking) | Unsupported platform, CMAKE_SYSTEM_NAME, HarmonyOS, elseif UNIX, WIN32, FATAL_ERROR, cmake configure, platform detection, POSIX branch, transport adapter | harmonyos-into-unix-branch |
+| [E533](errors/E533.md) | 2(medium) | bsdtar, libarchive, autotools, config.guess, HarmonyOS, OHOS, aarch64-linux-ohos, hmdfs, hmfs, umask, Permission denied, assertion_file_mode, owner-bits-only, setgid, zlib, fPIC, xz, liblzma, make check, test_package, pkg-config, rpath, configure, autoconf, portability, cross-compilation | autotools-hmdfs-dependency-boundary-test-classification |
+
+## 4-链接（34 条）
+
+| E编号 | severity | 症状关键词 | 一句话解法 |
+|---|---|---|---|
+| [E003](errors/E003.md) | 2(medium) | pthread, undefined reference, -lpthread, -pthread, threading, libpthread, pthread_create, pthread_mutex | add-cflags |
+| [E004](errors/E004.md) | 3(blocking) | symbol not found, ImportError, undefined symbol, BIND_NOW, musl, dlopen, dlsym, NEEDED, shared library, LD_LIBRARY_PATH, libpython | modify-ldshared |
+| [E013](errors/E013.md) | 2(medium) | dlopen, dlsym, dlclose, -ldl, libdl, dynamic linking, undefined reference, shared library loading | add-ldflags |
+| [E014](errors/E014.md) | 2(medium) | syslog, getrandom, unimplemented, syscall, NO_SYSLOG, -DNO_, disable feature, undefined reference, not available | add-cflags-disable |
+| [E015](errors/E015.md) | 2(medium) | libintl_dgettext, dgettext, undefined symbol, libintl, gettext, NLS, argp, linking | configure-libs-option |
+| [E027](errors/E027.md) | 2(medium) | libintl, gettext, NLS, -lintl, native language support, --disable-nls, bindtextdomain, textdomain, internationalization | configure-disable-feature |
+| [E050](errors/E050.md) | 3(blocking) | HMDFS, symlink, symbolic link, os.path.exists, ld.lld, -lpython, pip install, make install, lib*.so, linker | copy-replace-symlink |
+| [E078](errors/E078.md) | 1(minor) | musl, BIND_NOW, BIND_LAZY, dlopen, symbol not found, relocating, ImportError, LDSHARED, BLDSHARED, extension module, .so, NEEDED, circular dependency, libpython, libperl, libruby | build-var-override |
+| [E104](errors/E104.md) | 3(blocking) | version_script.ver, ld.lld, cannot find version script, olm, libolm, symbol export | create-version-script |
+| [E107](errors/E107.md) | 3(blocking) | g_libintl, libintl.a, libintl.so, GLib static, gettext dynamic, undefined reference | create-intermediate-library |
+| [E120](errors/E120.md) | 3(blocking) | libxml2.so.16, lld, shared libraries, LD_LIBRARY_PATH, OHOS SDK | env-library-path |
+| [E121](errors/E121.md) | 3(blocking) | setutxent, pututxline, endutxline, utmpx, OMIT_UTMP | add_compile_definition |
+| [E123](errors/E123.md) | 2(medium) | meson, static library, linking, libintl, glib, undefined symbol, g_libintl_ | patch-build-file |
+| [E124](errors/E124.md) | 3(blocking) | go, link, mapping, permission denied, output file | use-cgo-linker |
+| [E134](errors/E134.md) | 3(blocking) | go build, link, mapping output file, permission denied, mmap, HMDFS, Go linker | set-env-var |
+| [E137](errors/E137.md) | 3(blocking) | fstack-protector-strong, ldflags, lddlflags, ld.lld, unknown argument, ExtUtils::CBuilder, have_compiler, Module::Build, Perl, cbuilder, config override | source-patch |
+| [E166](errors/E166.md) | 3(blocking) | Go, link, permission denied, mapping output file, HMDFS, SELinux, Go build, link tool, ELF 签名 | platform_limitation |
+| [E173](errors/E173.md) | 3(blocking) | XS, Perl, CRT, crti.o, crtbeginS.o, musl, nostartfiles, LDDLFLAGS, shared library, linking, Pari.so | patch-build-file |
+| [E207](errors/E207.md) | 2(medium) | HarmonyOS, CMake, 相对路径链接, ../lib, SONAME缺失, 库依赖路径, 零介入失败, RPATH无效 | manual-workaround |
+| [E208](errors/E208.md) | 1(minor) | Perl XS, Makefile.PL, OTHERLDFLAGS, -nostartfiles, -nodefaultlibs, sys/types.h, libc, musl, CPATH, LIBRARY_PATH | set-env-var |
+| [E213](errors/E213.md) | 2(medium) | l64a, undefined reference, musl, libc | implement-locally |
+| [E221](errors/E221.md) | 3(blocking) | package_type, application, library, CMakeDeps, cpp_info.libs, system_libs, includedirs, bindirs, imported target | model-cli-library-public-contract |
+| [E229](errors/E229.md) | 2(medium) | explicit_bzero, undefined reference, fallback object, hidden symbol, standalone test, LDADD, libc missing API | link-exact-fallback-object |
+| [E236](errors/E236.md) | 2(medium) | Libtool, Conan, .la, libdir='//lib', library was moved, nested archive, ET_REL, llvm-ar, LIBADD, PCRE2_LIBS, SQLITE3_LIBS | scoped-la-free-static-archive-directory |
+| [E247](errors/E247.md) | 2(medium) | Libs.private, pkg-config --static, C API, C++ objects, libc++, operator new, std::__n1 | propagate-static-cxx-runtime-in-pkg-config |
+| [E266](errors/E266.md) | 3(blocking) | libxml2.so.16, lld, linker, xmlFreeDoc, symbol not found, fuse-ld | use-alternative-linker |
+| [E331](errors/E331.md) | 3(blocking) | VERSION, SOVERSION, symlink, libopenjp2.so, HMDFS, cmake_symlink_library, Operation not permitted | ohos-only-unversioned-shared-library |
+| [E353](errors/E353.md) | 1(minor) | CMake, static, upstream tests, gd_static, GD_LIB, ctest, target dependency, -lgd | test-helper-target-alias |
+| [E442](errors/E442.md) | 2(medium) | host-loaded plugin, private host ABI, unresolved host symbols, libtool module, no-undefined, dlopen, ELF DYN, plugin entry points | model-host-as-runtime-contract |
+| [E457](errors/E457.md) | 2(medium) | glib, static only, duplicate runtime, double copy, GType, dispose, PC=0, SIGSEGV, shared library, ConanException, avahi-glib | build-consumer-static-or-verify-dependency-shared |
+| [E523](errors/E523.md) | 3(blocking) | go build, mapping output file, fallocate, permission denied, link tool, toolexec, GOROOT, go mod | toolexec-wrapper |
+| [E531](errors/E531.md) | 2(medium) | qsort_r, musl, glibc, OHOS, HarmonyOS, undefined reference, GNU extension, BSD extension, reentrant sort, single-threaded, thread-local | local-glibc-compat-shim |
+| [E534](errors/E534.md) | 2(medium) | gethostid, strverscmp, sigisemptyset, getusershell, endusershell, GNU extension, musl, OHOS, missing libc, compat, missing_syscalls, hostid, sort, hush, su, loginutils | compat-patch-in-missing-syscalls |
+| [E537](errors/E537.md) | 2(medium) | Conan, cache, DT_NEEDED, absolute path, SONAME, RPATH, RUNPATH, libKF6Package.so, IMPORTED_NO_SONAME, target_link_directories, -l, relocatable, HMDFS, patchelf, mmap, PROT_EXEC, consumer, isolated cache | link-time-SONAME-basename |
+
+## 5-安装/打包/签名（52 条）
+
+| E编号 | severity | 症状关键词 | 一句话解法 |
+|---|---|---|---|
+| [E018](errors/E018.md) | 2(medium) | ln, symlink, Permission denied, wrapper script, soft link, SELinux, ln -sf, garbled, readlink, exec, copy instead of link | wrapper-script |
+| [E028](errors/E028.md) | 3(blocking) | shared library, conflict, system crash, --without-shared, static only, ncurses, symbol link, override, LD_LIBRARY_PATH, rpath, version mismatch | configure-static-only |
+| [E037](errors/E037.md) | 2(medium) | /usr/bin/env, shebang, bad interpreter, No such file, env not found, shell script, #!/usr/bin/env, portable | shebang-fix |
+| [E042](errors/E042.md) | 2(medium) | RPATH, patchelf, lib-dynload, extension module, NEEDED, ImportError, portable, $ORIGIN, Python, gdbm | set-rpath-patchelf |
+| [E049](errors/E049.md) | 2(medium) | shebang, hardcoded path, interpreter, perl, python, automake, gen-all.pl, portable, #!/data/, #!/usr/local/ | shebang-portable-fix |
+| [E054](errors/E054.md) | 2(medium) | security dialog, first execution, binary confirmation, Permission denied, make check, make install, popup, non-system binary | batch-trigger-execution |
+| [E066](errors/E066.md) | 1(minor) | refresh-patch.sh, tar.xz, tar.gz, tar.bz2, tar format, script defect, xz compression, patch generation, archives | source-patch |
+| [E077](errors/E077.md) | 1(minor) | ELF, signature, codesign, patchelf, strip, objcopy, binary-sign-tool, RPATH, RUNPATH, operation not permitted, re-sign, .note.ohos.ident, permission denied | post-install-script |
+| [E079](errors/E079.md) | 2(medium) | hard link, ln, HMDFS, Operation not permitted, make install, git clone, ccache, cargo, pnpm, content-addressable store, fdupes, man page alias | command-substitute |
+| [E087](errors/E087.md) | 1(minor) | Permission denied, .sh, HMDFS, chmod, execute permission, install -c -m 755, no execute permission, gpg-error-config-test.sh | use-sh-prefix |
+| [E098](errors/E098.md) | 1(minor) | install, command not found, toybox, 缺失命令 | cp-chmod-replace |
+| [E108](errors/E108.md) | 2(medium) | install, ginstall, GNU install, HarmonyOS, install -d, install -m0755, Error 127, Makefile, install-exec-local | patch-makefile-in-ginstall |
+| [E174](errors/E174.md) | 2(medium) | install, No such file or directory, make, coreutils, installation failed | manual-install |
+| [E182](errors/E182.md) | 1(minor) | shell script, install, ruby-build, no compilation, toybox, coreutils | manual-workaround |
+| [E188](errors/E188.md) | 1(minor) | toybox, install, coreutils, compatibility, GNU, 命令兼容 | use-gnu-coreutils |
+| [E241](errors/E241.md) | 2(medium) | data package, data-only, rule-list, JSON data, SPDX, no compilation, test_package, self.run, conanrun, SHA256 verification, fixed output comparison | data-package-pattern |
+| [E242](errors/E242.md) | 2(medium) | Fortran, .mod, module file, compiler ID, compiler version, LLVMFlang, tool_requires, package_id_mode, CMake component | compiler-identity-package-and-component-gate |
+| [E251](errors/E251.md) | 2(medium) | mecab-ko-dic, MeCab, 词典, 分词, 韩语, UTF-8, locale, mecab-dict-index, dictionary, NLP 数据包, CSV dictionary, Korean tokenization, data package | nlp-dictionary-package-pattern |
+| [E255](errors/E255.md) | 2(medium) | resource data package, icon theme, font package, document package, config template, no compilation, makefile empty, SVG, PNG, index.theme, 资源型库, 数据包, 纯资源, no_copy_source, symbolic link loop, symlink loop, find absolute path empty, test_package, XDG_DATA_DIRS, W3 local CI, L0 quality gate, L0c, L0d, commands.json | resource-data-package-conan-recipe |
+| [E281](errors/E281.md) | 2(medium) | resource package, voice data, diphone, festival, no build step, file-based validation, EST index | resource-package-file-copy |
+| [E289](errors/E289.md) | 3(blocking) | HELP2MAN, man_MANS, cannot stat, No such file or directory, install-man | clear-automake-man-list |
+| [E295](errors/E295.md) | 2(medium) | sign-elf, 签名, codesign, 签名门禁, ELF 签名, probe-only, 工具缺失, .codesign, 可交付门禁 | record-sign-elf-missing-probe-only |
+| [E297](errors/E297.md) | 2(medium) | runtime assets, share directory, config sample, web assets, package completeness | package-runtime-resource-closure |
+| [E305](errors/E305.md) | 3(blocking) | font, OTF, OpenType, cmap, name table, glyph, unicode, fontconfig, fc-scan, share/fonts, OFL, SIL Open Font License, resource-only package, no build, font resource | 字体资源型数据包的标准化适配方法： (1) conanfile.py: package_type="application", settings=("os","arch")；build() 为空；     package() 安装 fonts/otf/*.otf → share/fonts/OTF/, license → licenses/；     package_info() 暴露 resdirs=["share/fonts/OTF"] 和 user_info.font_dir。 (2) conandata.yml: sources 包含 url 和 sha256。 (3) test_package/conanfile.py: 用 Python struct 模块自实现轻量 OTF 解析器     （无需依赖 otfinfo/ttx/fonttools），验证：     - license 文件存在     - 4 个 OTF 文件名与 sha256 精确匹配（版本固定）     - OpenType name table: Family(1), Style(2), Full(4), Version(5), PS Name(6)     - cmap 覆盖: ASCII 字母+数字+常用符号     - 安装路径: share/fonts/OTF/ 存在且含 .otf 文件 (4) fontconfig/fc-scan/otfinfo/ttx/fonttools/fontbakery 等工具可作为     可选验证（环境中有则使用输出额外信息），不应作为 test_package 硬依赖。 (5) 上游测试核验：字体项目通常无传统测试用例(0/0 N/A)。 (6) 路径 B 知识库扩展候选：因为现有知识库未完整覆盖 OTF/OpenType metadata、     glyph/Unicode 抽样、license/hash/安装路径验证的可复用方法。 |
+| [E309](errors/E309.md) | 2(medium) | generated public header, configure_file, config header, compiler probe, install_headers, source copy, package_id, fd_set | reproduce-generated-install-output |
+| [E317](errors/E317.md) | 3(blocking) | normalizePath, R.home, share, No such file or directory, //lib/R/share, Makefile.in, install sed, global replace, R_SHARE_DIR, R_INCLUDE_DIR, R_DOC_DIR, R_HOME_DIR, 1, /PATTERN=/, range-limited sed, relocatable, --prefix=/, DESTDIR, moved-r-base | sed-range-limited-replace |
+| [E319](errors/E319.md) | 2(medium) | acronym, NLTK, nltk.corpus, ensure_loaded, nltk.download, python noarch, py3-none-any, pip wheel, installer, site-packages, PYTHONPATH, egg-info, console_scripts, import 阻塞, 语料库, words corpus, brown, gutenberg | lazy-resource-loading-and-pip-wheel-noarch-package |
+| [E321](errors/E321.md) | 2(medium) | byte-lite, any-lite, nonstd-lite, martinmoene, header-only, Conan 1.x, Conan 2.x, package_type=header-library, cmake_layout, CMakeToolchain, CMakeDeps, test_package, INTERFACE library, cpp_info.set_property, cmake_file_name, cmake_target_name, upstream test, CTest | header-only-lite-conan2-migration |
+| [E322](errors/E322.md) | 2(medium) | header-only, INTERFACE target, package_type, header-library, self.info.clear, cmake install export, TaskflowConfig.cmake, TF_BUILD_TESTS, find_package CONFIG, CMakeDeps | header-only-cmake-interface-recipe |
+| [E333](errors/E333.md) | 2(medium) | predl_cache, pre-download, conan create failed, files.pythonhosted.org, FileNotFoundError, NoSuchKey | url_form（conandata.yml 改用 /packages/source/ 官方 URL，sha256 与哈希目录 sdist 完全一致） |
+| [E336](errors/E336.md) | 2(medium) | make, install, DESTDIR, 复制布局, Layer | conanfile.py: build() 只跑 make all 校验语法，package() 跑 make install DESTDIR，package_info 用 cpp_info.resdirs 暴露 usr/share/acf/app/{name} |
+| [E340](errors/E340.md) | 2(medium) | basic_layout, build_folder, source_folder, cargo target/release, glob, package(), binary not found, conan package | glob-recursive-locate-cargo-artifact |
+| [E345](errors/E345.md) | 2(medium) | loadable module, plugin, private host, ABI match, minimal configuration, dlopen, libtool, Conan test_package, destructive negative test, same-source test fixture, FIFO capability probe, slapd, rwm.so | abi-matched-private-host-validation |
+| [E352](errors/E352.md) | 2(medium) | pure Lua, Lua 5.1, LUA_PATH, share/lua/5.1, require, compatibility module, HMDFS, symlink, test_package | lua-module-dual-layout-target-require |
+| [E360](errors/E360.md) | 3(blocking) | mutable logical package name, @PROJECT_NAME@Targets.cmake, install export namespace drift, variant-suffixed package config, static-only export identity | separate-logical-package-identity-from-artifact-variant |
+| [E362](errors/E362.md) | 2(medium) | Conan dependency, shared template, symlink, no-link, HMDFS, materialize, byte compare, resource identity, package_folder | dependency-derived-resource-materialization |
+| [E364](errors/E364.md) | 2(medium) | MPICH, mpicc, WRAPPER_CPPFLAGS, CPPFLAGS, user-local include, non-relocatable path | recipe-owned-wrapper-flags |
+| [E395](errors/E395.md) | 2(medium) | dangling symlink, broken symlink, Path.is_file, Path.is_symlink, unlink, package cleanup, metadata alias, conanmanifest | explicit-file-or-symlink-unlink |
+| [E396](errors/E396.md) | 2(medium) | Conan graph info, Conan install, package_folder null, RREV, PID, PREV, build never, isolated Conan home, package materialization | cross-bind-graph-identity-and-install-folder |
+| [E411](errors/E411.md) | 3(blocking) | not a valid libtool object, export_sources, compat, .lo, .dirstamp, libtool, conan create | 归档前清理 compat/、tests/ 下全部构建产物（find .deps/.libs -type d -exec rm -rf + 与 *.lo/*.o/*.Plo/*.Po/*.dirstamp 删除），只保留源文件；或 export_sources 用白名单复制 *.h/*.cpp |
+| [E423](errors/E423.md) | 1(minor) | cross binutils, Canadian cross, package-owned command, destructive negative test, host executable, target artifact, elf32-avr, ATmega328P, Intel HEX, Conan test_package | package-owned-host-target-closed-loop |
+| [E453](errors/E453.md) | 1(minor) | HMDFS mode projection, SONAME regular alias, group write, copy2, copymode, byte identical, world writable, setuid, shared library materialization | security-baseline-mode-comparison |
+| [E477](errors/E477.md) | 2(medium) | system acceleration policy, registry unreachable, registry_unreachable, conan download, L0i, R36, ohpcd, cnb.cool, only-recipe, registry probe, 制品仓, 依赖未发布 | verify-registry-with-conan-list |
+| [E498](errors/E498.md) | 3(blocking) | Conan 2, CMakeDeps, cpp_info.includedirs, include directory, imported target, headerless library, package metadata | explicit-empty-public-include-contract |
+| [E499](errors/E499.md) | 2(medium) | VirtualRunEnv, runenv_info, LD_LIBRARY_PATH, cpp_info.requires, transitive libdirs, libminizip.so.1 | export-transitive-runtime-libdirs |
+| [E504](errors/E504.md) | 3(blocking) | RPATH_CHANGE, musl, loader, Error loading shared library, cmake install, .so, LD_LIBRARY_PATH | conanfile.py generate() 设 CMAKE_SKIP_INSTALL_RPATH=TRUE，并在 package() 中用构建产物覆盖 install 产物（libubox 先例） |
+| [E515](errors/E515.md) | 3(blocking) | strip=0, strip:1, a/ b/ prefix, apply_conandata_patches, patch_ng, refresh-patch, Git-style patch | approach-identifier          # 见 DESIGN §5 impl 列表 |
+| [E518](errors/E518.md) | 3(blocking) | git-clone, libz.so, /data/service/hnp/bin/git, exit code 127, buildbot, worker, RUNPATH, /code/deps_install, zlib, 环境故障, shared library, musl ldso | worker-env-fix-zlib |
+| [E519](errors/E519.md) | 2(medium) | install-data-am, EXTRA_DIST, out-of-source, build-release, srcdir, addprefix, ginstall, cannot stat | approach-identifier          # 见 DESIGN §5 impl 列表 |
+| [E536](errors/E536.md) | 1(minor) | firmware, brcm, broadcom, linux-firmware-brcm, resource package, binary blob, firmware blob, no compile, data-only, resource-only | firmware-resource-package-validation |
+| [E539](errors/E539.md) | 2(medium) | zlib, test_package, CMakeDeps, zlib::zlib, shared library, PIC probe, static archive | api-roundtrip-plus-shared-library-link |
+| [E541](errors/E541.md) | 2(medium) | zlib, libz.so, libz.a, -fPIC, static-only, shared object, Python extension, AArch64 relocation | static-only-pic-archive |
+
+## 6-测试（77 条）
+
+| E编号 | severity | 症状关键词 | 一句话解法 |
+|---|---|---|---|
+| [E056](errors/E056.md) | 1(minor) | IndentationError, skipIf, reason wrap, multiline decorator, unittest, py_compile, patch quality, test file | source-patch |
+| [E057](errors/E057.md) | 1(minor) | regrtest, parallel worker, cpu_count, MAKEFLAGS, TESTOPTS, -j, load average, global state pollution, flaky | env-var-override |
+| [E193](errors/E193.md) | 2(medium) | case-insensitive, HMDFS, filesystem, BOO, boo | skip-case-sensitive-tests |
+| [E214](errors/E214.md) | 2(medium) | interactive, read, blocking, non-interactive, smoke_test, timeout, shell_script, ENTER, security_check | non-blocking-read |
+| [E215](errors/E215.md) | 2(medium) | LuaRocks, Lua 5.5, luacov, Busted, test dependency, Path B, os.tmpname, TMPDIR, relocatable launcher, test_package | path-b-with-consumer-validation |
+| [E217](errors/E217.md) | 2(medium) | fatal error, file not found, includedirs, test_package, header, CMakeLists install, DESTINATION include | check-cmake-header-install-subdir |
+| [E225](errors/E225.md) | 3(blocking) | CMakeToolchain, CMakeUserPresets, user_presets_path, cmake_layout, build_folder $TMP, tempfile.mkdtemp, TMPDIR, generators, test_package | conan-managed-temporary-test-layout |
+| [E226](errors/E226.md) | 2(medium) | os.popen, pipe.read, TypeError, str, bytes, Python 3.12, HarmonyOS, subprocess.PIPE | capture-subprocess-bytes-explicitly |
+| [E228](errors/E228.md) | 2(medium) | Libtool wrapper, LOG_COMPILER, .libs, Permission denied, extensionless script, make check, /system/bin/sh | conditional-log-compiler-launcher |
+| [E230](errors/E230.md) | 2(medium) | compile matrix, macro namespace, source-included transport, loopback, listener, connect, accept, bidirectional transfer, runtime smoke | compile-matrix-plus-loopback-runtime |
+| [E231](errors/E231.md) | 3(blocking) | official archive, source binding, tar member, SHA256, dynamic discovery, upstream tests | discover-tests-from-verified-archive |
+| [E233](errors/E233.md) | 2(medium) | POLLRDHUP, EPOLLRDHUP, EV_FEATURE_EARLY_CLOSE, poll, epoll, simpleclose, HarmonyOS, OHOS | ohos-rdhup-capability-gate |
+| [E239](errors/E239.md) | 2(medium) | self.run, ConanException, consumer cases, aggregate failures, fail-fast, exit code, test_package | catch-record-continue-then-raise |
+| [E243](errors/E243.md) | 2(medium) | protocol XML, schema, code generator, per-document test, xcbgen, pkg-config, PYTHONPATH, relocatable data package | per-document-generator-plus-discovery-matrix |
+| [E244](errors/E244.md) | 2(medium) | handle error, out parameter, last operation error, close error, error lifetime, fault injection, use after close | operation-fault-injection-with-pre-close-error-snapshot |
+| [E259](errors/E259.md) | 2(medium) | NDEBUG, assert, side effect, g_module_symbol, Conan Release, build_type Release, assertion failed, self NULL, latent bug, unchecked return, conditional compilation | hoist-side-effect-out-of-assert |
+| [E263](errors/E263.md) | 2(medium) | native-image, finalizer, installed layout, source tree, JAVA_HOME, libexec, test helper, package consumer | layout-aware-helper-resolution |
+| [E265](errors/E265.md) | 2(medium) | fatsort, upstream tests, make tests, fsck.vfat, valgrind, grep -oP, locale, LC_ALL, /tmp, erofs, read-only filesystem, testconfig.mk, ASan, UBSan, sanitize, address, undefined, memory check, 替代内存检查 | 1) 覆盖 SHELL/TMPDIR/FS_IMG 绕过 /tmp 只读限制；2) 用 sed -nE 替代 grep -oP；3) 无 valgrind 时用 clang ASan/UBSan（-fsanitize=address,undefined）替代内存检查，单独统计通过率，不能伪造 valgrind 通过；4) 设置 LC_ALL=C 匹配 OHOS locale；5) 在 OHOS 上重新生成 expected 输出文件 |
+| [E269](errors/E269.md) | 2(medium) | python2, python 2, run_tests.py, test runner, Missing parentheses, SyntaxError, subprocess.check_output | port-python-script |
+| [E272](errors/E272.md) | 2(medium) | arm-none-eabi-binutils, DejaGNU, expect spawn, /bin/stty, tmpfile, EACCES, ctf-compressed, cross toolchain, OHOS, -nottyinit, LD_PRELOAD, tmpfile-shim | spawn-nottyinit-plus-tmpfile-shim |
+| [E275](errors/E275.md) | 2(medium) | OHOS, shell, grep -v, set -e, autoenv, empty file | allow-empty-grep-result |
+| [E287](errors/E287.md) | 3(blocking) | fuzz, AFL, afl-fuzz, fuzz.c, fuzz.bash, fuzzin, corpus, tmux, sudo, sysfs, CAP_NET_RAW, TFTP, tftp_put, nmrp_do, raw socket, pcap, pcap_open_live, ethsock, nmrpflash, deterministic runner, corpus runner, alternative test, network interactive, nmrp, .pkts | fuzz-corpus-deterministic-runner |
+| [E291](errors/E291.md) | 3(blocking) | finish, W4, graph validate, E213, E214, 基线阻塞, repository_baseline_blocked, 知识图谱完整性, 顶层退出码, .ci-result.json | record-repository-baseline-blocked |
+| [E292](errors/E292.md) | 3(blocking) | CTest, GTest, ARROW_TEST_DATA, PARQUET_TEST_DATA, TZDIR, zoneinfo, relative NEEDED, basename NEEDED, duplicate GTest, jobserver, ranges, fadvise, LocalFileSystem, Boost.Context, CMAKE_SYSTEM_PROCESSOR, DST, OOM, allocator, overcommit, FetchContent, gRPC, OpenSSL, symlink, hardlink | layered-ctest-migration |
+| [E294](errors/E294.md) | 2(medium) | shared package, static tests, internal symbols, second build tree, CTest, Conan, can_run, upstream tests, BUILD_SHARED_LIBS, test submodules | dual-cmake-build-tree |
+| [E298](errors/E298.md) | 3(blocking) | cmake.test, CTest, VirtualRunEnv, conanrun, test_package, shared library, runtime path, LD_LIBRARY_PATH, PATH | virtual-run-env-explicit-run |
+| [E301](errors/E301.md) | 2(medium) | CMake.test, CMake.ctest, cli_args, --output-on-failure, cmake --build, ctest | use-cmake-ctest-helper |
+| [E303](errors/E303.md) | 3(blocking) | can't open /, Permission denied, hostfs, opendir, EACCES, root directory, restricted process, application domain | scope-root-probe-eacces |
+| [E307](errors/E307.md) | 2(medium) | test_package, cmake not found, header-only, compile-only, tools.build:compiler_executables, Conan profile, Error 127 | profile-compiler-direct-compile |
+| [E308](errors/E308.md) | 3(blocking) | L0c, test_package, test source, suffix, .c.in, .cpp.in, template, no_test_sources, maxdepth | accepted-test-source-suffix |
+| [E310](errors/E310.md) | 2(medium) | --version, version output, product prefix, brand prefix, exact version, output contract, false failure | assert-documented-version-contract |
+| [E312](errors/E312.md) | 3(blocking) | grntest, Ruby, bundle, gem, run-test.sh, 4227, .test, GQTP, groonga-command, groonga-command-parser, gqtp, groonga-client, groonga-log, groonga-query-log, msgpack, stdckdint.h, install, codesign | full-dependency-chain-solution |
+| [E318](errors/E318.md) | 3(blocking) | go test, go test -c, unsigned ELF, .test, Permission denied, Operation not permitted, binary-sign-tool, source directory, test.v | compile-sign-run-go-tests |
+| [E325](errors/E325.md) | 2(medium) | CONFIG_SHELL, bash, /data/service/hnp/bin/bash, TMPDIR, test_package, shutil.which, sh, mktemp, /tmp, ostra | shell-discovery-and-writable-tmpdir |
+| [E326](errors/E326.md) | 2(medium) | git archive, HEAD snapshot, worktree, dirty tree, shadow CI, No packages to build, conanfile.py, staged commit, package snapshot | snapshot-before-shadow-ci |
+| [E327](errors/E327.md) | 2(medium) | upstream test stats, test-related files, package scope, FastAPI, DB, web dashboard, infrastructure scripts, test_package, ostra-sysctl, review audit | layered-test-evidence |
+| [E328](errors/E328.md) | 2(medium) | smoke-test, package-owned, repo-level, control-plane, web dashboard, infrastructure scripts, upstream denominator, review scope, ostra | separated-test-clusters |
+| [E329](errors/E329.md) | 2(medium) | ServiceAction, ServiceStatus, test_models.py, control-plane, pydantic, Python 3.12, import-time NameError, collection failure | reorder-service-action |
+| [E354](errors/E354.md) | 2(medium) | Redis, Tcl, runtest, tclsh8.6, binary-sign-tool, REDIS_TEST_TMPDIR, HarmonyFS, HMDFS, SIGSTOP | sign-targets-run-all-suites-account-capabilities |
+| [E357](errors/E357.md) | 2(medium) | informational option, mandatory config, --version, --help, system daemon, global options, safe probe, allowlist, negative control, pppd | early-informational-option-allowlist |
+| [E361](errors/E361.md) | 2(medium) | MPICH, Hydra, mpiexec, detached descendant, setsid, double fork, managed timeout, zero residue, canary | bound-timeout-plus-post-cleanup-token-gate |
+| [E363](errors/E363.md) | 3(blocking) | read-only /tmp, bare exit, exit code 0, empty Summary, /bin/bash, xargs -I, TMPDIR, positive completion marker | writable-temp-explicit-interpreter-fail-fast-positive-summary |
+| [E365](errors/E365.md) | 2(medium) | MPICH, Hydra, PMI abort, disable-auto-cleanup, valid INT_MIN, valid INT_MAX, stale test oracle, delayed canary | termination-bound-valid-abort-oracle |
+| [E366](errors/E366.md) | 2(medium) | emacs --batch, EMACSLOADPATH, batch-byte-compile, loaddefs-generate, check-declare, make lisp, pure Elisp | package-emacs-batch-and-elisp-loadpath |
+| [E369](errors/E369.md) | 2(medium) | ELF signing, binary-sign-tool, signed-exec.pending, cleanup ownership, mv -nT, no-clobber, path replacement, signal deferral, held FD, coherent commit, device inode | per-object-identity-bound-no-clobber-publication |
+| [E370](errors/E370.md) | 2(medium) | Meson testlog.json, PASS, SKIP, FAIL, SkipPlatforms, fixture inventory, unique suite fixture key, expected failure returncode, target selector | source-keyed-terminal-map-and-target-id-projection |
+| [E374](errors/E374.md) | 2(medium) | Conan test_package, can_run, OHOS, binary-sign-tool, llvm-objcopy, llvm-readelf, compile link, runtime NOT_RUN, Buildbot | artifact-first-capability-gated-runtime |
+| [E387](errors/E387.md) | 2(medium) | llvm-lit, check-llvm, check-clang, lit.cfg.py, lit.site.cfg.py, llvm_config.use_lit_shell, lit.llvm.initialize, config.llvm_tools_dir, config.llvm_obj_root, config.host_triple, config.targets_to_build, psutil, --timeout, FileCheck, llc, -mtriple=aarch64-unknown-linux-ohos, codesign | 1) 自包含替换式 lit.cfg.py：复制上游 llvm/test/lit.cfg.py 并在顶部注入全部 site 属性 （llvm_src_root/llvm_obj_root/llvm_tools_dir/llvm_lib_dir/llvm_shlib_dir/host_triple/target_triple/ targets_to_build=字符串/llvm_use_sanitizer/build_mode/enable_llvm_dylib/llvm_dylib_version/host_arch/ host_os/host_cc/host_ldflags/llvm_enable_assertions/inliner_model/raevict_model/lit_tools_dir/ use_lit_shell/use_default_substitutions/python_executable/go/gold/ld/ld64/ptxas/ocamlfind/ocaml_flags/ osx_sysroot/build_examples/build_shared_libs/enable_threads/expensive_checks/has_plugins/have_curl/ have_libxar/have_libxml/have_libxml2/have_llvm_driver/have_ocamlopt/have_opt_viewer_modules/have_tf_aot/ have_tf_api/libcxx_used/link_llvm_dylib/linked_bye_extension/llvm_locstats_used）+ import lit.llvm + lit.llvm.initialize(lit_config, config)；2) 入口脚本 run_lit_subsel.sh 生成 llvm-lit-wrapper.py （config_map 把源码 llvm/test 映射到 lit.site.cfg.py）；3) 最小 smoke 用例 test_lit/add.ll （RUN: llc -mtriple=aarch64-unknown-linux-ohos \| FileCheck %s）；4) 子集选择：按文件名排序取 CodeGen/AArch64 前 50 + InstSimplify 前 15，禁止跑全量（约 7.3 万文件不现实） |
+| [E394](errors/E394.md) | 2(medium) | LD_PRELOAD, constructor, pre-main, environment snapshot, PAM_WRAPPER_SERVICE_DIR, service file, passdb, exec, test fixture | parent-prepare-then-exec |
+| [E398](errors/E398.md) | 2(medium) | XSyncValueSubtract, XSyncValue, overflow, sign transition, libxext, installed-package consumer | result-first-overflow-boundary-validation |
+| [E401](errors/E401.md) | 2(medium) | real.ok, golden, atan2f, ULP, musl, glibc, platform variant, {arch}-{os}.ok, arm64-ohos.ok, MLton, libm, correct rounding | add-{arch}-{os}-ok-platform-oracle-variant |
+| [E403](errors/E403.md) | 2(medium) | test_package, __pycache__, conanbuild.sh, conanrun.sh, residual, pristine, metadata, mlton-consumer, deactivate, delivery hygiene, web-review | pre-delivery-test-package-residual-cleanup |
+| [E410](errors/E410.md) | 2(medium) | adapt, IntentBuilder, entity expansion, ContextManager, Trie, pytest, run_tests.sh, test_package | expand-upstream-modules-and-assert-intent-semantics |
+| [E413](errors/E413.md) | 2(medium) | expected SKIP, conditional skip, upstream inventory, nonfailed, AArch64, UINT_MAX, SIZE_MAX, GLib TAP | hashed-expected-skip-outcome-contract |
+| [E414](errors/E414.md) | 2(medium) | calc, fpos_t, fseeko, ftello, file-position, musl, HarmonyOS, regress.cal, fgetpos, fsetpos | source-patch |
+| [E417](errors/E417.md) | 2(medium) | AVIF, JXL, #if 0, 19 有效格式, formats[], testimage, Autotools CI, CMake CI, not supported, TGA SKIP, SDLTest_Log, assertion, testimage, 742, Skipped=0 | declare-format-coverage-by-ci-variant |
+| [E419](errors/E419.md) | 2(medium) | -fsigned-char, plain char, unsigned char, INT8, integer promotion, AArch64, pixel sample | consistent-target-signed-char-mode |
+| [E428](errors/E428.md) | 3(blocking) | pico-sdk, pioasm, test_package, VirtualRunEnv, env=conanrun, subprocess.run, PATH, absolute path, FileNotFoundError | pass-packaged-tool-absolute-path |
+| [E444](errors/E444.md) | 3(blocking) | GLib, GObject, g_type_ensure_initialized, gobject_init, .init_array, constructor, HarmonyOS, OHOS, G_TYPE_OBJECT, g_object_new, type system, test_package | explicit-idempotent-gobject-init-entry |
+| [E445](errors/E445.md) | 2(medium) | Neovim, nvim-lspconfig, vusted, busted, upstream test, headless, Path B, Lua runtime plugin, test_package | path-b-packaged-neovim-vusted-chain |
+| [E446](errors/E446.md) | 2(medium) | zix, filesystem, HMDFS, OHOS, symlink, hardlink, BAD_PERMS, NOT_SUPPORTED, meson test, canonical path | capability-scoped-filesystem-test-exemption |
+| [E452](errors/E452.md) | 1(minor) | shared library copy, task-private runtime, old codesign, force re-sign, binary-sign-tool, llvm-objcopy, LD_LIBRARY_PATH, SONAME alias, loader RC 127 | force-resign-private-runtime-copies |
+| [E454](errors/E454.md) | 2(medium) | nothing, added, commit, untracked, files, present | submit 前为适配创建知识草稿(graph add --draft)，使 git add 暂存区有真实内容可提交 |
+| [E461](errors/E461.md) | 2(medium) | AF_UNIX, bind, abstract, socket, tmpdir, erofs, HMDFS, EPERM, EROFS, dbus, peer, test | abstract-socket-first-with-tmpdir-fallback |
+| [E462](errors/E462.md) | 3(blocking) | gdb, strace, ptrace, SELinux, SIGSEGV, ucontext, frame pointer, addr2line, dladdr, ASan silent, PC=0, debug | userland-signal-handler-frame-walk |
+| [E464](errors/E464.md) | 2(medium) | mygui, dummy, addResourceLocation, DummyDataManager, getDataPath, DataStream, EOF, busy loop, SIGKILL, Error 137, headless, display context | mygui-dummy-resource-registration-headless |
+| [E465](errors/E465.md) | 3(blocking) | ctypes, CDLL(None), PY_LOG_COMPILER, embedded python, launcher, make check PYTHON, dlopen, isl_test_python, Py_DecodeLocale, python3-config --embed | embedded-python-launcher |
+| [E471](errors/E471.md) | 3(blocking) | gtkmm, gtk_init, gdk_rgba, Gdk::RGBA, Gdk::Rectangle, Failed to open display, FONTCONFIG_FILE, FONTCONFIG_PATH, fonts.conf, failing suite, --no-suite=failing, broadwayd, broadway, display server, GUI binding, test classification, headless, no display | display-test-classification-and-no-display-api-probes |
+| [E472](errors/E472.md) | 3(blocking) | test_package, ELF signing, binary-sign-tool, selfSign, llvm-objcopy, codesign, SDL_VIDEODRIVER=dummy, SDL_AUDIODRIVER=dummy, stub_test_method, self.run, SDL_kitchensink, Kit_Init, Kit_GetVersion | sign-elf-and-sdl-dummy-headless-test |
+| [E488](errors/E488.md) | 2(medium) | dlopen, Permission denied, owner, 20001006, chmod, Python extension, .so, cffi, import | copy-rewrite（复制整个包到可写目录 + open/write 逐字节重写 .so + chmod 777 + rename） |
+| [E489](errors/E489.md) | 3(blocking) | CTest, build tree, ELF closure, codesign, binary-sign-tool, dlopen, LD_PRELOAD, MODULE library, plugin, Permission denied, OHOS | sign-build-tree-runtime-closure |
+| [E492](errors/E492.md) | 2(medium) | zix, Meson, SONAME, build tree, install tree, libzix-0.so.0, Error loading shared library, LD_LIBRARY_PATH, shared library alias, OHOS | build-and-package-soname-alias-materialization |
+| [E502](errors/E502.md) | 3(blocking) | dlopen, Permission denied, LD_PRELOAD, needed by, NEEDED, ctypes, CI worker, HNP python, .codesign, binary-sign-tool, release signature, task-private copy | probe-then-route-to-exec-time |
+| [E503](errors/E503.md) | 2(medium) | --version, --help, smoke test, L2 gate, jshn, CLI tool | 补丁在 main() 开头增加 --version/--help GNU 长选项处理并返回 0（libubox jshn 先例） |
+| [E530](errors/E530.md) | 3(blocking) | api_surface, version_contract, DECLARE_SYMBOL, __typeof__, offsetof, XineramaScreenInfo, display-independent, Xvfb, strong typed relocation | strong-typed-relocation-plus-abi-pinning |
+| [E535](errors/E535.md) | 2(medium) | cgns, CGNS, CGNS_ENABLE_TESTS, ctest, cmake.test, SKIP_RETURN_CODE, SKIP_TESTS, test_back_comp, HDF5, Fortran, flang, gfortran, MPI, 上游测试, 真实通过率, 24 项, 23 passed, 1 skipped, 0 failed, cg_open, cg_base_write, cg_close, cg_nbases, test_package | enable-upstream-ctest |
+| [E544](errors/E544.md) | 3(blocking) | zsh, null-glob, (N), G0a, build_and_test.sh, 〈外部知识库路径〉, ls, wc -l, empty dir, draft count, W3, local CI, finish, 草稿计数, rmdir | fix-g0a-count-with-dir-check |
+
+## 7-运行时（61 条）
+
+| E编号 | severity | 症状关键词 | 一句话解法 |
+|---|---|---|---|
+| [E006](errors/E006.md) | 3(blocking) | OpenSSL, BAD_SIGNATURE, RSA_verify, PSS, no-asm, ARM64, assembly, ssl.SSLError, cert_verify, last octet invalid | reconfigure-no-asm |
+| [E009](errors/E009.md) | 2(medium) | SELinux, domain transition, adhoc_bin, hishell_hap, hnp_file, Permission denied, subprocess, pipe, \| cat, 2>&1 | pipe-bypass |
+| [E019](errors/E019.md) | 3(blocking) | shared library, cannot open, lib*.so, LD_LIBRARY_PATH, rpath, ld.so, NEEDED, dynamic linker, library path, ldd, $ORIGIN, RPATH, runpath, musl | set-ld-library-path |
+| [E022](errors/E022.md) | 1(minor) | sem_unlink, POSIX semaphore, /dev/shm, FileNotFoundError, multiprocessing, warning | source-patch-try-except |
+| [E023](errors/E023.md) | 1(minor) | locale, UTF-8, LC_ALL, strcoll, FAIL, en_US, locale -a, test_locale, collation | skip-test |
+| [E024](errors/E024.md) | 2(medium) | Unix domain socket, AF_UNIX, bind, Permission denied, SELinux, multiprocessing, TCP fallback, localhost | use-tcp-socket |
+| [E031](errors/E031.md) | 2(medium) | /proc, Permission denied, SELinux, htop, proc/stat, proc/meminfo, cannot open | sudo-run |
+| [E034](errors/E034.md) | 2(medium) | CA certificates, SSL, wget, curl, ca-certificates, /etc/ssl/certs, certificate verify failed, unable to load | install-ca-certs |
+| [E038](errors/E038.md) | 1(minor) | groff, macro, g.tmac, safe.tmac, padj.tmac, man-db, man_db.conf, nroff, diversion, warning, mandoc | config-patch |
+| [E039](errors/E039.md) | 2(medium) | iconv, //IGNORE, //TRANSLIT, musl, glibc, UTF-8, encoding conversion, man-db, manconv, mandb, whatis | source-patch |
+| [E040](errors/E040.md) | 3(blocking) | mandb, SIGSEGV, 139, MAN_OWNER, segfault, null pointer, man-db, get_man_owner, pw_uid, chown, config.h | config-patch |
+| [E043](errors/E043.md) | 1(minor) | BASH_SOURCE, toybox ash, HiShell, activate.sh, $0, dirname, shell script, POSIX, bashism | source-patch |
+| [E044](errors/E044.md) | 3(blocking) | PYTHONHOME, encodings, standard library, sys.prefix, portable package, Fatal Python error, init_sys_streams | env-var-activate |
+| [E045](errors/E045.md) | 3(blocking) | mmap, RWX, W^X, ctypes, CFUNCTYPE, MemoryError, libffi, closure, JIT, PROT_EXEC, mprotect, Invalid argument | no-fix-platform-limitation |
+| [E046](errors/E046.md) | 1(minor) | chmod, not effective, SELinux, HMDFS, os.access, permission, test failure, stat, mode unchanged, HarmonyOS | skip-test |
+| [E047](errors/E047.md) | 1(minor) | other-read, 0o004, umask, file permission, HMDFS, assertion error, test_dbm_dumb, test_uu, mode diff | relax-assertion |
+| [E048](errors/E048.md) | 1(minor) | UDPLITE, UDP-Lite, IPPROTO_UDPLITE, Permission denied, socket, kernel protocol, RFC 3828, test_socket | skip-test |
+| [E051](errors/E051.md) | 3(blocking) | SIGSYS, signal 31, exit 159, setreuid, setregid, chroot, clock_settime, unimplemented syscall, core dump, sigaction, ENOSYS, __OHOS__ | source-patch |
+| [E055](errors/E055.md) | 1(minor) | posix_spawn, fork+exec, _USE_POSIX_SPAWN, vfork, errpipe, subprocess, shell builtin, Python 3.12, musl | skip-test |
+| [E067](errors/E067.md) | 1(minor) | grep, BRE, regex metacharacter, fixed string, -F, parenthesis, bracket, dollar, case pattern, AI programming | use-grep-F-or-case |
+| [E068](errors/E068.md) | 3(blocking) | find_library, ldconfig, ctypes.util, SubprocessError, /sbin/ldconfig, cffi, trio, dlopen, shared library | source-patch |
+| [E073](errors/E073.md) | 3(blocking) | shared library, .so, symbolic link, symlink, cannot load, exists but not loadable, runtime, dlopen, cp replace, static link | configure-static-only |
+| [E076](errors/E076.md) | 2(medium) | fstat, lseek, pipe, tty, socket, EACCES, EPERM, non-file fd, FIFO, coreutils, cat, head, tail, dd, seek, blksize, st_mode | source-patch-ifdef |
+| [E080](errors/E080.md) | 2(medium) | venv, lib64, symlink, Permission denied, HMDFS, os.symlink, ensure_directories, virtual environment, EnvBuilder, platlibdir | source-patch-try-except |
+| [E083](errors/E083.md) | 3(blocking) | System.load, Permission denied, dlopen, JNI library, BiSheng JDK, bishengjdk, ELF signature, selfSign, binary-sign-tool, .codesign, NativeLibraries, UnsatisfiedLinkError | sign-jdk-and-library |
+| [E088](errors/E088.md) | 2(medium) | RUNPATH, RPATH, LD_LIBRARY_PATH, namespace, ld-musl-namespace, lib-dynload, ImportError, shared library, patchelf, $ORIGIN | copy-libs-to-dynload-dir |
+| [E101](errors/E101.md) | 2(medium) | git, safe.directory, dubious ownership, HMDFS, UID, permission | set-env-var |
+| [E131](errors/E131.md) | 2(medium) | Permission denied, loading shared library, LD environment variable, dlopen, Perl XS, DynaLoader | unset-env-var |
+| [E135](errors/E135.md) | 3(blocking) | libintl, ELF signature, signing, dynamic linker, Error loading shared library, symbol not found, dlopen | sign-elf-library |
+| [E142](errors/E142.md) | 3(blocking) | g_libintl_dgettext, libintl_glib, gettext, NLS, gnulib, dgettext, ENABLE_NLS | link-libintl_glib |
+| [E143](errors/E143.md) | 2(medium) | bscalc, ctypes, dlopen, Permission denied, Python shebang, /usr/bin/python3, PYTHONPATH, bytesize module | fix-shebang-plus-env |
+| [E179](errors/E179.md) | 3(blocking) | ELF签名, Python扩展模块, Permission denied, ImportError | configure-option |
+| [E186](errors/E186.md) | 3(blocking) | cargo, libz.so, Error loading shared library, musl ldso, RUNPATH, patchelf | patchelf-fix-runpath |
+| [E200](errors/E200.md) | 1(minor) | LD_PRELOAD, fsync, interception, OHOS | verify-ld-preload |
+| [E201](errors/E201.md) | 1(minor) | test_run.sh, /bin/bash, strace, OHOS | manual-test-execution |
+| [E202](errors/E202.md) | 1(minor) | PTHREAD_KEYS_MAX, pthread_key_create, musl, OHOS | skip-test |
+| [E210](errors/E210.md) | 3(blocking) | mimalloc, MI_OVERRIDE, 段错误, killed, malloc覆盖, 内存分配器 | add-cmake-flag |
+| [E212](errors/E212.md) | 2(medium) | Permission denied, loading shared library, dlopen, hmmac, security label, hnp_file, hishell_hap_data_file, hmdfs, Perl XS, DynaLoader, ctypes CDLL | install-to-hnp-path |
+| [E218](errors/E218.md) | 2(medium) | CastXML, LLVM_LINK_LLVM_DYLIB, CLANG_LINK_CLANG_DYLIB, mc-relax-all, libLLVM-15.so, libclang-cpp.so, InitLLVM, CommandLine Error, inconsistency, registered more than once, OHOS, LLVM shared library, dylib | link-only-clang-cpp-monolith |
+| [E222](errors/E222.md) | 3(blocking) | FaultLogger, ptrace, DeviceDebuggable, native crash, symbolization, llvm-objdump, backtrace, maps, ASLR | faultlogger-evidence-chain |
+| [E224](errors/E224.md) | 3(blocking) | sigaltstack, SA_ONSTACK, SS_DISABLE, alternate signal stack, owner thread, pthread_join, free, allocator, FaultLogger | owner-thread-altstack-lifecycle |
+| [E237](errors/E237.md) | 2(medium) | ACPI, acpid, acpi_listen, /proc/acpi, /sys/bus/acpi, /sys/firmware/acpi, NETLINK_GENERIC, HongMeng Kernel, HarmonyOS, power button, lid event, battery, thermal, kernel interface missing, daemon | compile-verify-with-runtime-degradation |
+| [E246](errors/E246.md) | 2(medium) | SIGSYS, SYS_SECCOMP, si_syscall, seccomp, syscall blocked, adjtimex, syscall 171, signal 31, core dump, graceful degradation | graceful-degradation |
+| [E249](errors/E249.md) | 3(blocking) | Signal 11, exit 139, attempting free, not malloc, shared ownership, stack object | initialize-borrowed-ownership |
+| [E260](errors/E260.md) | 3(blocking) | native-image, Python launcher, shell wrapper, ELF magic, fixed path, fexecve, descriptor, TOCTOU, exit 127 | descriptor-bound-elf-launch |
+| [E261](errors/E261.md) | 3(blocking) | native-image, finalizer, rollback, recovery, symlink, identity, signed-output, renameat2, RENAME_NOREPLACE, concurrent replacement | identity-bound-recovery-and-cleanup |
+| [E262](errors/E262.md) | 3(blocking) | native-image, scratch, symlink, policy resolver, missing parent, .t, reserved output, path classification | policy-first-nonstrict-resolution |
+| [E270](errors/E270.md) | 2(medium) | CLOCK_SGI_CYCLE, clock_gettime, EINVAL, FFTW, measure_execution_time, start_over, CLOCK_MONOTONIC, OHOS | source-patch |
+| [E274](errors/E274.md) | 2(medium) | shared library, SONAME, soname, symlink, lib*.so.*, versioned, NEEDED, ld.so, package(), conan, runtime linker, Error loading shared library, needed by | create-soname-symlink |
+| [E280](errors/E280.md) | 3(blocking) | Thread, Tcl_StaticPackage, package require Thread, interp create, child interp, vwait, TCLLIBPATH, pkgIndex.tcl, ThreadReap, ThreadJoin, joinable, thread.test hang | static-package-registration-bridge |
+| [E306](errors/E306.md) | 2(medium) | std::polar, negative rho, negative radius, NaN, Pole to add is NaN, libc++, HarmonyOS | construct-complex-components |
+| [E314](errors/E314.md) | 2(medium) | no events were recorded, Rprof_memory_summary, setitimer, ITIMER_PROF, SIGPROF, RPE_CPU, RPE_ELAPSED, ProfileThread, initial delay, empty profile, ITIMER_PROF, profiling, R_InitProfiling | probe-detect-fallback |
+| [E315](errors/E315.md) | 2(medium) | persist.time.timezone, param get, zoneinfo, TZDIR, IANA, Olson, Asia/Shanghai, /etc/zoneinfo, /system/etc/zoneinfo, internal-tzcode, datetime.R, cacheIt, localtime, UTC offset, tzcode | authoritative-param-probe-with-tzdir-priority |
+| [E316](errors/E316.md) | 3(blocking) | libopenblas.so.0, SONAME, NEEDED, Error loading shared library, symbol not found, zgemm_, exec/R, _prepare_relocatable_runtime, shutil.copy2, symlink, Conan package, moved-r-base, OpenBLAS, relocatable | copy-soname-entity |
+| [E324](errors/E324.md) | 2(medium) | /proc, /sys, sysinfo, getloadavg, meminfo, read_cpu_times, disk usage, partial metrics, zero fill, best-effort, ostra-sysctl | best-effort-metric-aggregation |
+| [E337](errors/E337.md) | 2(medium) | require, 'acf.fs', 'mvc', Layer, Recognition | self.requires('acf-core/0.24.1')（已发布制品仓）；测试用 test_package 验证包布局而非运行 Lua |
+| [E350](errors/E350.md) | 2(medium) | desktop wrapper, KDE Activities, plasma-activities-cli, xdpyinfo, kdialog, explicit context provider, OpenHarmony | explicit-context-provider |
+| [E404](errors/E404.md) | 2(medium) | zsh, autoload, is-at-least, compinit, function definition file not found, fpath, OHOS | create-missing-zsh-function |
+| [E408](errors/E408.md) | 2(medium) | Perl AppConfig, no such variable, optional setting, undefined accessor, debug, DEFAULT, stderr | register-then-normalize-optional-appconfig-value |
+| [E436](errors/E436.md) | 2(medium) | lua 5.2, lua 5.5, generic-for, mutable loop, const variable, acf-lib, luac -p, share/lua/5.2, LUA_PATH | assess-lua-version-first |
+| [E509](errors/E509.md) | 2(medium) | cargo.real, symbol not found, relocating, OpenSSL, libssl.so, libcrypto.so, LD_LIBRARY_PATH, harmonybrew, dynamic binary, RUNPATH, OBJ_nid2sn, SSL_CTX_new, OSSL_PROVIDER_try_load | set-LD_LIBRARY_PATH-to-harmonybrew-openssl |
+
+## 8-验证/评审/发布（15 条）
+
+| E编号 | severity | 症状关键词 | 一句话解法 |
+|---|---|---|---|
+| [E141](errors/E141.md) | 2(medium) | configure_options, YAML list, regex, [], no closing quote, shell argument, manifest.yaml | use-empty-string |
+| [E170](errors/E170.md) | 1(minor) | verify_build, manifest, build_system, G4, archive | add-compat-field |
+| [E227](errors/E227.md) | 2(medium) | git diff --check, unified diff, patch context, blank-at-eol, single space, fuzz=0 | split-source-and-patch-whitespace-validation |
+| [E256](errors/E256.md) | 3(blocking) | binary patch, tar.gz, packaging, git apply, diff patch, CI failure, missing binary patch data, staging-verified | remove-binary-from-commit |
+| [E257](errors/E257.md) | 2(medium) | header-only, 单头文件, no cmake, build() 方法, G1, 配方完整性, conan-verify, 无构建系统, single-header | no-op-build-for-header-only |
+| [E371](errors/E371.md) | 2(medium) | tar, readback, directory member, archive root, trailing slash, terminal evidence, postrelease, SHA-256 | exact-directory-and-regular-file-whitelists |
+| [E381](errors/E381.md) | 3(blocking) | staged tree, wrapper, controller, allocation record, authority, git write-tree, zero SSH | four-way-snapshot-binding |
+| [E389](errors/E389.md) | 2(medium) | canonical package reference, temporary repair version, downstream Conan dependency, missing recipe, exact dependency version, package_folder, build never | canonical-reference-reconciliation |
+| [E415](errors/E415.md) | 2(medium) | mirror fallback, gh-proxy, conandata.yml 原地改写, 恢复, 逐字节一致, Errno 2 curl, predl_cache, 官方 URL, build_and_test.sh, L4 误扫 | verify-and-restore-conandata-after-ci |
+| [E416](errors/E416.md) | 3(blocking) | conan slug, L0m-5, L0m-4, 双 case, 大小写不敏感 FS, case-insensitive, SDL2_image, libXext, libxext, skip-worktree, L4 误扫, 大写元数据目录, 小写 recipe 目录 | add-lowercase-recipe-dir-keep-uppercase-meta |
+| [E418](errors/E418.md) | 2(medium) | AllowEmptyString, mandatory string, empty stdout, File.WriteAllText, exact downstream diagnostic, ownership drift | explicit-empty-state-and-exact-error-oracle |
+| [E474](errors/E474.md) | 2(medium) | API20 snapshot acknowledgement, observer timeout, nativewindow, OHAudio, consumers_total, NOT_REQUIRED, NOT_RUN, authoritative terminal receipt | typed-consumer-and-observer-receipts |
+| [E478](errors/E478.md) | 2(medium) | conan-verify, package id, dotted version, G4, conan create | 版本号含点号时 G4/L2/L4/L5 会被跳过但标记 PASS；需手动用 conan cache path '<ref>:<pkgid>' + readelf/sha256 验证产物完整性（或用 conan list 获取 package id） |
+| [E529](errors/E529.md) | 3(blocking) | libunwind, test_package, CMake, cmake_layout, VirtualRunEnv, tools.build:compiler_executables, /data/service/hnp/bin, shadow CI | test-package-local-tool-path |
+| [E540](errors/E540.md) | 2(medium) | zlib, shadow CI, ohos-test-runner, make, PATH, /data/service/hnp/bin, CMake, Conan | runner-path-prepend |
+
+## 9-其他（1 条）
+
+| E编号 | severity | 症状关键词 | 一句话解法 |
+|---|---|---|---|
+| [E497](errors/E497.md) | 2(medium) | Git, HMDFS, /storage, /data, dubious ownership, safe.directory, cannot stat .git/branches, separate-git-dir, maintenance.auto, gc.auto | native-separate-git-dir |
+
+## 10-本地补充条目（L 系列，64 条）
+
+> 插件侧实战沉淀（`local-errors/`，手维护），不随知识源同步；正文里的 E 编号为旧编号语境，
+> 与原 E 号的对照见 [local-errors/README.md](local-errors/README.md)。
+
+| L编号 | severity | 症状关键词 | 一句话解法 |
+|---|---|---|---|
+| [L001](local-errors/L001.md) | — | — | HAP 安装签名信任链失败（fail to verify pkcs7） |
+| [L002](local-errors/L002.md) | — | — | HAP 构建 00308018（SDK management mode changed / not writable）= runtimeOS 与本机 SDK 形态不匹配 |
+| [L003](local-errors/L003.md) | — | — | QPlainTextEdit::appendPlainText 在 OHOS 上 SIGABRT |
+| [L004](local-errors/L004.md) | — | — | CMake 默认生成器回退 MSVC，产物是 x86 .dll |
+| [L005](local-errors/L005.md) | — | — | Scintilla 等 C++17 依赖编译失败 |
+| [L006](local-errors/L006.md) | — | — | 链接 QPA 平台插件导致运行时加载失败 |
+| [L007](local-errors/L007.md) | — | — | 设备侧执行用户二进制被拒（Permission denied / Operation not permitted / exit 126 / 127） |
+| [L008](local-errors/L008.md) | — | — | 依赖运行时数据在目标机缺失（功能全绿但能力静默降级） |
+| [L009](local-errors/L009.md) | — | — | OHOS musl 分支 iconv 缺失 CJK 编码方向（to=CJK EINVAL） |
+| [L010](local-errors/L010.md) | — | — | 跨架构浮点微差 + libc 依赖的测试脚手架：同代码双架构一过一挂 |
+| [L011](local-errors/L011.md) | — | — | Windows 宿主编码纪律：BOM 吞注释、ASCII 损坏源码、CRLF 毒化 sh/CTest |
+| [L012](local-errors/L012.md) | — | — | HNP zip 布局违约装机失败（9568407 / 0x801101 / native package install failed） |
+| [L013](local-errors/L013.md) | — | — | OpenSSL 3.x TLS 握手在 OHOS aarch64 平台级失败 |
+| [L014](local-errors/L014.md) | — | — | meson `run_command('test', '-d', ...)` 在 Windows 宿主失败（无 `test` 命令） |
+| [L015](local-errors/L015.md) | — | — | 可选能力降级模式下 API 入参为 NULL 未守卫 → 解引用 SIGSEGV |
+| [L016](local-errors/L016.md) | — | — | 测试用例缺陷——断言/参数类型与真实平台契约不符（testcase-defect） |
+| [L017](local-errors/L017.md) | — | — | Windows 宿主 `find_package(PkgConfig REQUIRED)` 配置失败（无 pkg-config） |
+| [L018](local-errors/L018.md) | — | — | conan 头文件数据族版本不兼容（cimg/3.6.6 t_magenta 常量 vs 函数） |
+| [L019](local-errors/L019.md) | — | — | CImg 家族 X11/Xlib.h not found（NDK sysroot 无 X11） |
+| [L020](local-errors/L020.md) | — | — | NDK 目标封装脚本在带空格安装路径下失效（Windows 宿主） |
+| [L021](local-errors/L021.md) | — | — | cmd `set "VAR=..."` 嵌套引号导致编译参数断裂（Windows 宿主） |
+| [L022](local-errors/L022.md) | — | — | glib conan 包缺失 Unix 专有头（gio/gunixinputstream.h、gunixoutputstream.h） |
+| [L023](local-errors/L023.md) | — | — | clang 15 前端 ICE —— concept 带模板模板实参的约束 auto 形参 |
+| [L024](local-errors/L024.md) | — | — | std::ranges 算法报 no member named —— libc++ 15 门控需 -D_LIBCPP_ENABLE_EXPERIMENTAL |
+| [L025](local-errors/L025.md) | — | — | clang 15 的 C++20 缺口组（P0960 / P0634 / CRTP 约束缓存 / libc++ 裁剪） |
+| [L026](local-errors/L026.md) | — | — | demo 验证接线错——API 枚举/编码参数与模块生命周期（harness-defect） |
+| [L027](local-errors/L027.md) | — | — | fork+execv 子进程信号继承——exec wrapper 未重置 SIG_IGN 处置与阻塞掩码，SIGINT 无法递送 |
+| [L028](local-errors/L028.md) | — | — | 宿主工具脚本替代的解析保真度（comp_sql DELIMITER 状态机） |
+| [L029](local-errors/L029.md) | — | — | static-init 期调 sem_open 失败——命名 POSIX 信号量在 app 域受限，进程 main() 前崩溃 |
+| [L030](local-errors/L030.md) | — | — | provider 自检状态机卡 INIT —— OpenSSL 3.x 族 DRBG/RAND 全挂（03080006） |
+| [L031](local-errors/L031.md) | — | — | corrupt patch 被 `\|\| echo 继续` 静默掩盖——补丁未打进产物但构建绿 |
+| [L032](local-errors/L032.md) | — | — | demo 验证接线错——对象状态/时区/正则/持久化残留/压缩数据（harness-defect） |
+| [L033](local-errors/L033.md) | — | — | demo 验证接线错——TLS/NTLS/密码学 API 握手与证书构造（harness-defect） |
+| [L034](local-errors/L034.md) | — | — | cli-hnp-runner — 手编 C++ NAPI 缺 libc++_shared.so 导致全部用例「调用失败: {}」（cpp-napl-missing-shared） |
+| [L035](local-errors/L035.md) | — | — | napi_stub exec 名与 HNP 二进制名不一致导致所有 CLI exec RC=127（exec-name-mismatch） |
+| [L036](local-errors/L036.md) | — | — | 纯 C TU 在 OHOS 上链接 C++ 实现 .so → init 期信号终止 |
+| [L037](local-errors/L037.md) | — | — | 生成/补写测试的断言必须锚定 API 契约——契约外 UB 断言真机必崩且不是库缺陷 |
+| [L038](local-errors/L038.md) | — | — | 重生成保护的协议漂移——保留旧页面 + 新 runner = 签名错配 |
+| [L039](local-errors/L039.md) | — | — | NAPI 函数内 `char[] == const char*` 指针比较——以字符串内容为目标的 caseId 校验永远不通过 |
+| [L040](local-errors/L040.md) | — | — | napi 异步工作中 `g_case_busy` 清位顺序：store(false) 必须在 resolve_deferred 之前 |
+| [L041](local-errors/L041.md) | — | — | HAP 装机签名校验失败（9568329）——zip 重复条目 / 证书不匹配 |
+| [L042](local-errors/L042.md) | — | — | libc++abi: terminating due to uncaught foreign exception（aarch64-musl） |
+| [L043](local-errors/L043.md) | — | — | Lua C API 负栈索引归一化公式：gettop + index + 1（不是 gettop - index + 1） |
+| [L044](local-errors/L044.md) | — | — | HAP 内 fork 无 exec 隔离把可恢复错误放大成进程崩溃——受阻归因平台前先做进程内对照 |
+| [L045](local-errors/L045.md) | — | — | 数据驱动测试二进制缺 testutil provider 位置参数——usage 退出零执行（harness-defect） |
+| [L046](local-errors/L046.md) | — | — | testutil 选项置于位置参数之后——opt_next 提前 EOF，过滤静默失效（harness-defect） |
+| [L047](local-errors/L047.md) | — | — | hilog 全量 RAW dump 自截断——TAP 证据被自己的日志挤掉，声称值遭验收驳回（harness-defect） |
+| [L048](local-errors/L048.md) | — | — | 存量 test-demo 判定分叉——用例页永远「已出结果」零 result 行，一把执行页却出 pass（scaffold 版本偏移） |
+| [L049](local-errors/L049.md) | — | — | `sign-demo` 不带 `--demo-dir test-demo` 签错包——装的是阶段 3 HAP，「改了没生效」 |
+| [L050](local-errors/L050.md) | — | — | assert 型测试证据被 NDEBUG 整体编译掉——rc==0 退化为空证明，判定必须钉住 stdout 证据行（assert-evidence-vacuity） |
+| [L051](local-errors/L051.md) | — | — | 计算类 demo 设备内存未初始化 + atomic_add 读改写——冷启过/暖复跑挂（harness-defect） |
+| [L052](local-errors/L052.md) | — | — | OHOS NDK clang 15 libc++ 的 float from_chars 被标记为 deleted——复用 __APPLE__ 分支 strtod_l 兜底 |
+| [L053](local-errors/L053.md) | — | — | ld.lld 的 .debug_gdb_scripts 段与 --fatal-warnings 冲突——重链加 codesign 场景 |
+| [L054](local-errors/L054.md) | — | — | CTR-DRBG 创建后未设 CIPHER 参数——instantiate 静默失败（wrapper-only 错误码） |
+| [L055](local-errors/L055.md) | — | — | 看门狗只杀直接子进程——孙进程持 pipe 致 run-all 挂死（孤儿进程现场） |
+| [L056](local-errors/L056.md) | — | — | bash VAR=val 独立成行不 export——环境变量静默失效误诊平台限制 |
+| [L057](local-errors/L057.md) | — | — | hilog 捕获过滤三坑——`-e` 拆管 / bundle 名缩写漏行 / 过滤失效全量噪声 |
+| [L059](local-errors/L059.md) | — | — | Electron 打包目录重构导致相对路径错位——Cannot find module '../xxx' 解析出载荷根 |
+| [L060](local-errors/L060.md) | — | — | Electron-OH 渲染进程对系统分区文件 stat/read EACCES——主进程可读、渲染进程被拒（Chromium 子进程沙箱） |
+| [L061](local-errors/L061.md) | — | — | Electron-OH new BrowserWindow 偶发卡死——窗口系统竞态（进程活着但界面出不来） |
+| [L062](local-errors/L062.md) | — | — | Electron-OH 同步 require 缺失模块永久挂起（不抛 MODULE_NOT_FOUND）——内联/惰性化/闭合校验 |
+| [L063](local-errors/L063.md) | — | — | Electron-OH 应用内多窗口（第二次 new BrowserWindow）启动失败——无托盘形态须成对删除 processMode/startupVisibility |
+| [L064](local-errors/L064.md) | — | — | Electron-OH 上 @electron/remote 跨进程回调（REMOTE_RENDERER_CALLBACK）无法回传渲染层——dialog 弹框正常但 Promise 永不 resolve |
+