@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/prescan/prescan-rules.yaml

@@ -0,0 +1,355 @@
+# 本文件由同步脚本自动生成，请勿手改。如需修正请更新知识源数据后重新运行 `npm run sync:kb`。
+# 构成：上游规则集原文（24 条 PSCAN-*）+ 知识图谱 prescan_pattern 预派生（4 条 PSCAN-KB-*，知识源 commit 70926181cd） + 本地手维护规则（3 条 PSCAN-LOCAL-*，源自 skills/pc-error-atlas/prescan/local-rules.yaml）
+
+# pre-scan-rules.yaml — 预编译源码风险扫描规则集
+# 闭环机制：编译中新发现的问题可通过 graph add 回填到此文件
+# 格式：每条规则包含 pattern（grep 正则）+ scope_globs（搜索范围）+ severity
+version: 1
+last_updated: 2026-08-20
+
+rules:
+  # ── HMDFS 文件系统限制 ──
+  - id: PSCAN-HMDFS-001
+    category: hmdfs
+    severity: critical
+    pattern: '\bln\s+(-\w*s\w*\s|--symbolic\s)'
+    scope_globs: ['Makefile*', 'makefile*', '*.mk']
+    description: "Makefile 中的 ln -s 创建符号链接，HMDFS 不支持"
+    solution_hint: "sed 's/ln -s/cp -a/g' 或 wrapper 脚本替代"
+    kb_ref: "E018,E050,E073,E079,E080"
+    auto_generated: false
+    hit_count: 0
+
+  - id: PSCAN-HMDFS-002
+    category: hmdfs
+    severity: medium
+    pattern: '\bchmod\b|\bchown\b|\bfchmod\b'
+    scope_globs: ['*.c', '*.h']
+    description: "源码中调用 chmod/chown，HMDFS 上可能无权限效果"
+    solution_hint: "通常非阻塞，测试中可能需忽略"
+    kb_ref: "E046"
+    auto_generated: false
+    hit_count: 0
+
+  # ── 文件系统路径 ──
+  - id: PSCAN-FS-001
+    category: filesystem
+    severity: medium
+    pattern: '"/tmp[/"]'
+    scope_globs: ['*.c', '*.h', '*.py', '*.sh']
+    description: "/tmp 路径硬编码，HMDFS 上 /tmp 为只读 erofs"
+    solution_hint: "改用 $TMPDIR 或 /data/local/tmp"
+    kb_ref: "E002"
+    auto_generated: false
+    hit_count: 0
+
+  - id: PSCAN-PATH-001
+    category: hardcoded_path
+    severity: medium
+    pattern: '"/etc/[^"]*"'
+    scope_globs: ['*.c', '*.h']
+    description: "源码中硬编码 /etc/ 路径，可能不被 --prefix 覆盖"
+    solution_hint: "检查是否通过 configure --sysconfdir 或 #define 配置"
+    auto_generated: false
+    hit_count: 0
+
+  # ── musl 兼容性 ──
+  - id: PSCAN-MUSL-001
+    category: musl_compat
+    severity: critical
+    pattern: '\bpthread_cancel\b'
+    scope_globs: ['*.c', '*.h', '*.cc', '*.cpp']
+    description: "pthread_cancel 在 musl/OHOS 上不可用"
+    solution_hint: "#ifdef __OHOS__ 跳过 cancel，改用标志位+pthread_join"
+    kb_ref: "E085,E127"
+    auto_generated: false
+    hit_count: 0
+
+  - id: PSCAN-MUSL-002
+    category: musl_compat
+    severity: critical
+    pattern: '\bmremap\b'
+    scope_globs: ['*.c', '*.h', '*.cc', '*.cpp']
+    description: "mremap syscall 在 OHOS 上不可用"
+    solution_hint: "#ifdef __OHOS__ 用 realloc 替代 mremap"
+    auto_generated: false
+    hit_count: 0
+
+  - id: PSCAN-MUSL-003
+    category: musl_compat
+    severity: high
+    pattern: '\bppoll\b'
+    scope_globs: ['*.c', '*.h', '*.cc', '*.cpp']
+    description: "ppoll 在 OHOS 上不可用"
+    solution_hint: "#ifdef __OHOS__ 用 poll 替代 ppoll"
+    auto_generated: false
+    hit_count: 0
+
+  - id: PSCAN-MUSL-004
+    category: musl_compat
+    severity: medium
+    pattern: '\bsecure_getenv\b'
+    scope_globs: ['*.c', '*.h']
+    description: "secure_getenv 是 glibc 扩展，musl 未实现"
+    solution_hint: "#define secure_getenv getenv（OHOS 无 setuid 场景）"
+    kb_ref: "E081"
+    auto_generated: false
+    hit_count: 0
+
+  - id: PSCAN-MUSL-005
+    category: musl_compat
+    severity: medium
+    pattern: '\bLIBINTL\b|\bENABLE_NLS\b|#include\s*<libintl\.h>'
+    scope_globs: ['*']
+    description: "检测 gettext/NLS 国际化，OHOS 缺少 libintl 开发库"
+    solution_hint: "configure 加 --disable-nls 或 Makefile 中 ENABLE_NLS="
+    kb_ref: "E015,E027"
+    auto_generated: false
+    hit_count: 0
+
+  # ── 构建系统 ──
+  - id: PSCAN-BUILD-001
+    category: build_system
+    severity: auto
+    pattern: null
+    check_type: file_exists
+    check_targets: ['config.guess', 'config.sub']
+    description: "检测 config.guess/config.sub 存在，autotools 项目需打补丁"
+    solution_hint: "patch-autotools-ohos.pl 自动修复"
+    kb_ref: "E007,E072"
+    auto_generated: false
+    hit_count: 1
+
+  - id: PSCAN-BUILD-002
+    category: build_system
+    severity: medium
+    pattern: 'find_library\s*\(\s*\w+\s+m\b'
+    scope_globs: ['CMakeLists.txt', '*.cmake']
+    description: "CMake find_library 查找 libm，OHOS 无独立 libm"
+    solution_hint: "set(LIBM \"\") 或改为 find_library(LIBM m) 不 REQUIRED"
+    auto_generated: false
+    hit_count: 0
+
+  # ── 文档分析（标记给 AI 判断）──
+  - id: PSCAN-DOC-001
+    category: docs
+    severity: info
+    pattern: '(?:require|depends|need).*?(?:Linux|glibc|kernel\s+\d|GNU C)'
+    scope_globs: ['README*', 'INSTALL*', 'NEWS*', 'CHANGES*', 'ChangeLog*']
+    description: "文档中声明了 Linux/glibc 依赖，可能需要平台适配"
+    solution_hint: "AI 读取相关文档判断具体风险"
+    auto_generated: false
+    hit_count: 0
+
+  - id: PSCAN-DOC-002
+    category: docs
+    severity: info
+    pattern: null
+    check_type: dir_exists
+    check_targets: ['gnulib', 'lib/gnulib', 'gl']
+    description: "检测到 gnulib 模块，可能包含 glibc 假设"
+    solution_hint: "关注 E061, E062, E081 相关问题"
+    kb_ref: "E061,E062,E081"
+    auto_generated: false
+    hit_count: 0
+
+  # ── 测试风险 ──
+  - id: PSCAN-TEST-001
+    category: test_risk
+    severity: low
+    pattern: '\bsymlink\b|\breadlink\b|\bln\s+-s\b'
+    scope_globs: ['test*', 'tests*', 't/*']
+    description: "测试中使用符号链接，HMDFS 上可能失败"
+    solution_hint: "加入 EXCLUDE_LIST 或跳过"
+    kb_ref: "E018,E050"
+    auto_generated: false
+    hit_count: 0
+
+  - id: PSCAN-TEST-002
+    category: test_risk
+    severity: low
+    pattern: '\bgetuid\b|\bgetgid\b|\bgeteuid\b'
+    scope_globs: ['test*', 'tests*', 't/*', '*.test']
+    description: "测试中检查 uid/gid，OHOS uid 范围与 Linux 不同"
+    solution_hint: "已知平台限制，非功能缺陷"
+    auto_generated: false
+    hit_count: 0
+
+  # ── v12.5: linking / build-system / shell 域（对齐知识库高频错误域）──
+  - id: PSCAN-LINK-001
+    category: linking
+    severity: high
+    pattern: 'dlopen\s*\(\s*"/'
+    scope_globs: ['*.c', '*.h', '*.cc', '*.cpp']
+    description: "dlopen 硬编码绝对路径加载，OHOS 打包路径/sandbox 下大概率加载失败"
+    solution_hint: "改为相对 soname（dlopen('libxxx.so.1')）或 $ORIGIN 相对路径"
+    kb_ref: "E019"
+    auto_generated: false
+    hit_count: 0
+
+  - id: PSCAN-LINK-002
+    category: linking
+    severity: medium
+    pattern: '-Wl,-rpath,\$\(PWD\)|-Wl,-rpath,/home|-Wl,-rpath,/tmp|-Wl,-rpath,/build'
+    scope_globs: ['Makefile*', '*.mk', '*.am', 'CMakeLists.txt', '*.cmake']
+    description: "rpath 指向构建机绝对路径，发布包在目标机上加载失败"
+    solution_hint: "删除或改为 $ORIGIN 相对 rpath（-Wl,-rpath,'$$ORIGIN'）"
+    kb_ref: "E019"
+    auto_generated: false
+    hit_count: 0
+
+  - id: PSCAN-BUILD-101
+    category: build_system
+    severity: high
+    pattern: 'install\s*\(.*DESTINATION\s+/(etc|usr|opt|var)'
+    scope_globs: ['CMakeLists.txt', '*.cmake']
+    description: "CMake install 使用系统绝对路径 DESTINATION，绕过 --prefix"
+    solution_hint: "改为相对路径 DESTINATION (etc/ share/) 由 CMAKE_INSTALL_PREFIX 接管"
+    kb_ref: "E019"
+    auto_generated: false
+    hit_count: 0
+
+  - id: PSCAN-BUILD-102
+    category: build_system
+    severity: medium
+    check_type: file_exists
+    check_targets: ['config.guess']
+    description: "config.guess 存在，老版本不识别 ohos 目标三元组，configure 直接失败"
+    solution_hint: "替换为含 aarch64-unknown-linux-ohos 支持的新版 config.guess"
+    kb_ref: "E007"
+    auto_generated: false
+    hit_count: 1
+
+  - id: PSCAN-BUILD-103
+    category: build_system
+    severity: medium
+    pattern: 'AM_GNU_GETTEXT.*0\.1[0-7]|AM_ICONV\b'
+    scope_globs: ['configure.ac']
+    description: "老版 gettext/iconv 宏在交叉编译下探测失败率高"
+    solution_hint: "升级 gettext 宏或 --disable-nls 绕过"
+    kb_ref: "E118"
+    auto_generated: false
+    hit_count: 0
+
+  - id: PSCAN-SHELL-001
+    category: shell
+    severity: medium
+    pattern: '\[\[\s.*\]\]|\bstat -c\b|\breadlink -f\b'
+    scope_globs: ['configure', 'configure.ac', 'Makefile*', '*.mk']
+    description: "bash 专用语法/工具出现在可移植构建脚本中，OHOS 默认 sh 会失败"
+    solution_hint: "改 POSIX 等价写法（[ ] + test、stat -f 检查、readlink 无 -f 用 realpath）"
+    kb_ref: "E037"
+    auto_generated: false
+    hit_count: 0
+
+  - id: PSCAN-SHELL-002
+    category: shell
+    severity: high
+    pattern: '^#!\s*/bin/bash'
+    scope_globs: ['*.sh', 'configure*']
+    description: "shebang 硬编码 /bin/bash，OHOS 无 bash 时脚本报 bad interpreter"
+    solution_hint: "改 #!/usr/bin/env sh 或 POSIX sh 重写"
+    kb_ref: "E037"
+    auto_generated: false
+    hit_count: 0
+
+  - id: PSCAN-GLIBC-001
+    category: libc
+    severity: medium
+    pattern: '__GLIBC__|gnu/libc-version|__libc_start_main'
+    scope_globs: ['*.c', '*.h', '*.cc', '*.cpp']
+    description: "glibc 专用宏/头，musl 下未定义导致代码走错分支或链接失败"
+    solution_hint: "#ifdef __OHOS__/__MUSL__ 分支处理，或用通用 POSIX 接口"
+    kb_ref: "E020"
+    auto_generated: false
+    hit_count: 0
+
+  - id: PSCAN-PATH-002
+    category: filesystem
+    severity: medium
+    pattern: '\$HOME/\.|~/\.'
+    scope_globs: ['configure', 'configure.ac', 'Makefile*', '*.mk']
+    description: "构建脚本依赖 $HOME 点文件，HMDFS home 与构建 sandbox 行为不同"
+    solution_hint: "改用可配置的 $(prefix)/etc 或环境变量注入"
+    kb_ref: "E079"
+    auto_generated: false
+    hit_count: 0
+
+  # ── 知识图谱派生规则（同步时从条目 prescan_pattern 预生成；运行时无需知识库） ──
+  - id: PSCAN-KB-E013
+    category: kb_derived
+    severity: medium
+    pattern: '\bdlopen\b|\bdlsym\b'
+    scope_globs: ['*.c', '*.h', '*.cc', '*.cpp']
+    description: "[KB] 动态链接错误（-ldl 缺失）"
+    solution_hint: "add-ldflags"
+    kb_ref: "E013"
+    auto_generated: true
+    hit_count: 0
+
+  - id: PSCAN-KB-E019
+    category: kb_derived
+    severity: critical
+    pattern: 'dlopen\s*\(\s*"/'
+    scope_globs: ['*.c', '*.h', '*.cc', '*.cpp', '*.sh', 'Makefile*', '*.mk']
+    description: "[KB] 库加载失败（运行时）"
+    solution_hint: "set-ld-library-path"
+    kb_ref: "E019"
+    auto_generated: true
+    hit_count: 0
+
+  - id: PSCAN-KB-E037
+    category: kb_derived
+    severity: medium
+    pattern: '^#!/bin/bash|^#!/usr/bin/bash'
+    scope_globs: ['*.sh', '*.py', '*.pl', 'configure*', '*.in']
+    description: "[KB] shebang 兼容性（/usr/bin/env 缺失 + 可移植性）"
+    solution_hint: "shebang-fix"
+    kb_ref: "E037"
+    auto_generated: true
+    hit_count: 0
+
+  - id: PSCAN-KB-E465
+    category: kb_derived
+    severity: critical
+    pattern: 'ctypes\.CDLL\(|cdll\.LoadLibrary\('
+    scope_globs: ['*.py', '*.py.in', '*.py.top', 'Makefile*', '*.mk']
+    description: "[KB] Route upstream dlopen/ctypes tests past the OHOS worker loader boundary with an embedded-Python launcher that links the library under test as its own NEEDED"
+    solution_hint: "embedded-python-launcher"
+    kb_ref: "E465"
+    auto_generated: true
+    hit_count: 0
+
+  # ── 本地手维护规则（PSCAN-LOCAL-*；维护入口见 prescan/local-rules.yaml 头注释，改后重跑同步生效） ──
+  - id: PSCAN-LOCAL-001
+    category: musl_compat
+    severity: medium
+    pattern: 'iconv_open\s*\(\s*"(GB18030|GBK|GB2312|BIG5)"'
+    scope_globs: ['*.c', '*.h', '*.cc', '*.cpp']
+    description: "[L009] iconv_open 以 CJK 编码为输出方向（to=CJK）：OHOS musl 分支裁剪了 CJK 编码方向转换表，运行期 EINVAL"
+    solution_hint: "解码方向（from=CJK）正常；编码方向需改用其他转换实现或在外部完成转换，详见 local-errors/L009.md"
+    kb_ref: "L009"
+    auto_generated: false
+    hit_count: 0
+
+  - id: PSCAN-LOCAL-002
+    category: build_hygiene
+    severity: high
+    pattern: '(git\s+apply|\bpatch\s+-p\d).*\|\|\s*(echo|true)'
+    scope_globs: ['*.sh', 'Makefile*', '*.mk', '*.py', '*.ps1']
+    description: "[L031] 补丁应用失败被 || echo/|| true 静默掩盖——补丁没打进产物但构建绿、patches_applied 声称已应用"
+    solution_hint: "补丁应用必须 fail-fast（set -e / exit 1），补丁写入前先 git apply --check 全链往返验证，详见 local-errors/L031.md"
+    kb_ref: "L031"
+    auto_generated: false
+    hit_count: 0
+
+  - id: PSCAN-LOCAL-003
+    category: platform_ipc
+    severity: medium
+    pattern: '\bsem_open\s*\('
+    scope_globs: ['*.c', '*.h', '*.cc', '*.cpp']
+    description: "[L029] sem_open 命名 POSIX 信号量在 app 域受限（/dev/shm namefs MAC）；file-scope static 对象在 static-init 期调用会在 main() 前 terminate"
+    solution_hint: "static 对象改 Meyers 单例（函数局部 static）延迟构造；app 域内避免命名信号量，详见 local-errors/L029.md"
+    kb_ref: "L029"
+    auto_generated: false
+    hit_count: 0

package/node_modules/@ohos-agent/pc-adapter/skills/pc-error-atlas/scripts/README.md

@@ -0,0 +1,19 @@
+<!-- 本文件由同步脚本自动生成，请勿手改。如需修正请更新知识源数据后重新运行 `npm run sync:kb`。 -->
+
+# 配套工具脚本（知识库同步生成物）
+
+本目录为**生成物**（知识库同步管道打包而来），存放图谱条目修复命令引用的实体工具——
+条目里的命令改写到本目录后，在装包的机器上才真能跑。
+
+| 文件 | 说明 |
+|---|---|
+| `patch-autotools-ohos.pl` | autotools 一键补丁脚本：给 config.guess/config.sub 打鸿蒙识别分支（错误图谱 E007 的推荐修复动作） |
+| `atlas-checklist.mjs` | **写码前清单生成器（手维护，非生成物）**：按任务域关键词从 error-index.json（含 L 系列）生成 ≤10 条「症状 → 检查点」清单，开码前当编码约束用。用法：`node atlas-checklist.mjs <关键词...> [--max N]` |
+
+## 用法
+
+```bash
+perl <本目录>/patch-autotools-ohos.pl <工程的 config.guess 路径> <config.sub 路径>
+```
+
+知识源 commit：`70926181cd`。

package/node_modules/@ohos-agent/pc-adapter/skills/pc-error-atlas/scripts/atlas-checklist.mjs

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+/**
+ * 写码前清单生成器（手维护，**非生成物**——sync 豁免，同 local-rules.yaml 先例）。
+ *
+ * 按任务域关键词过滤 `knowledge/error-index.json`（E 系列 + L 系列本地条目同表），
+ * 输出 ≤N 条「症状 → 检查点」清单，供开码前当编码约束用（pc-03 步骤 1 的插入点 C）。
+ * 纪律：单卡 ≤10 条（防清单轰炸）；零命中即本域暂无已知禁忌，照常编码。
+ *
+ * **L live 叠加**：除索引外直扫 `knowledge/local-errors/L*.md`（相对脚本位置解析），
+ * 从 `# L###:` 标题行 + 头部注释 trigger/summary_plain 组检索面，与索引条目按 id 去重
+ * （索引优先）——新沉淀未入索引时对清单同样可见，「沉淀 → 写码前清单」闭环不依赖 sync
+ * （与 knowledge-index.ts 的 live 叠加同型）。目录缺失/文件畸形容错跳过。
+ *
+ * 用法：node atlas-checklist.mjs <关键词...> [--max N]   （N 默认 10；纯人读 stdout）
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url))
+const INDEX_JSON = path.resolve(SCRIPT_DIR, '..', 'knowledge', 'error-index.json')
+const LOCAL_ERRORS_DIR = path.resolve(SCRIPT_DIR, '..', 'knowledge', 'local-errors')
+
+const args = process.argv.slice(2)
+const keywords = []
+let max = 10
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === '--max') {
+    max = Math.max(1, Number(args[++i]) || 10) // 钳到 ≥1：负数会掏空结果误打「无命中」
+  } else {
+    keywords.push(args[i])
+  }
+}
+
+if (keywords.length === 0) {
+  console.error('用法: node atlas-checklist.mjs <关键词...> [--max N]')
+  process.exit(2)
+}
+
+let index
+try {
+  index = JSON.parse(fs.readFileSync(INDEX_JSON, 'utf8'))
+} catch (err) {
+  console.error(`✗ 读不到 error-index.json（${INDEX_JSON}）：${err.message}`)
+  process.exit(1)
+}
+
+/** L live 叠加：直扫 local-errors/L*.md 组装成索引同构条目（检索面=标题+trigger+summary_plain）。 */
+function localLiveEntries(indexedIds) {
+  let files = []
+  try {
+    files = fs.readdirSync(LOCAL_ERRORS_DIR)
+  } catch {
+    return []
+  }
+  const out = []
+  for (const f of files) {
+    const m = /^(L\d+)\.md$/.exec(f)
+    if (!m || indexedIds.has(m[1])) continue
+    let head = ''
+    try {
+      head = fs.readFileSync(path.join(LOCAL_ERRORS_DIR, f), 'utf8').slice(0, 4096)
+    } catch {
+      continue
+    }
+    const titleM = head.match(new RegExp(`^#\\s+${m[1]}[:：]\\s*(.+)$`, 'm'))
+    if (!titleM) continue // 畸形文件（缺标题行）跳过
+    const triggerM = head.match(/^trigger:\s*(.+)$/m)
+    const summaryM = head.match(/^summary_plain:\s*(.+)$/m)
+    out.push({
+      id: m[1],
+      title: titleM[1].trim(),
+      keywords: (triggerM?.[1] ?? '').trim().split(/\s+/).filter(Boolean),
+      category: '',
+      rec_approach: (summaryM?.[1] ?? '').trim(),
+      source: 'local',
+    })
+  }
+  return out
+}
+
+const indexEntries = Array.isArray(index) ? index : []
+const entries = [...indexEntries, ...localLiveEntries(new Set(indexEntries.map((e) => String(e?.id ?? ''))))]
+
+const haystack = (e) =>
+  [e.title ?? '', ...(Array.isArray(e.keywords) ? e.keywords : []), e.category ?? '', e.rec_approach ?? '']
+    .join(' ')
+    .toLowerCase()
+
+const scored = []
+for (const e of entries) {
+  const hay = haystack(e)
+  const score = keywords.filter((k) => hay.includes(k.toLowerCase())).length
+  if (score > 0) scored.push({ e, score })
+}
+scored.sort((a, b) => b.score - a.score || String(a.e.id).localeCompare(String(b.e.id)))
+
+const picks = scored.slice(0, max)
+if (picks.length === 0) {
+  console.log(`（无命中）关键词 ${keywords.join(' / ')} 在错误图谱（含 L 系列）暂无已知禁忌——照常编码。`)
+  process.exit(0)
+}
+
+console.log(`写码前检查清单（${picks.length} 条，关键词 ${keywords.join(' / ')}；单卡 ≤${max} 条）：`)
+for (const { e } of picks) {
+  const local = e.source === 'local' ? '（本地沉淀）' : ''
+  const hint = String(e.rec_approach ?? '').trim() || (Array.isArray(e.keywords) ? e.keywords.join('、') : '')
+  console.log(`[${e.id}]${local} ${e.title ?? ''}`)
+  console.log(`    → 检查点: ${hint.length > 120 ? `${hint.slice(0, 120)}…` : hint}`)
+}

package/node_modules/@ohos-agent/pc-adapter/skills/pc-error-atlas/scripts/patch-autotools-ohos.pl

@@ -0,0 +1,146 @@
+#!/usr/bin/perl
+# 本文件由同步脚本自动生成，请勿手改。如需修正请更新知识源数据后重新运行 `npm run sync:kb`。
+# patch-autotools-ohos.pl — 一键为 autotools 项目打 HarmonyOS 补丁
+#
+# 用法: perl patch-autotools-ohos.pl <config.guess> <config.sub>
+# 基于: autotools-patterns.md #2-#3
+#
+# 铁律: 禁止用 --build/--host 绕过 (autotools-patterns.md #0)
+
+use strict;
+use warnings;
+
+my $cg = $ARGV[0] or die "Usage: $0 <config.guess> <config.sub>\n";
+my $cs = $ARGV[1] or die "Usage: $0 <config.guess> <config.sub>\n";
+-e $cg or die "Not found: $cg\n";
+-e $cs or die "Not found: $cs\n";
+
+sub read_file {
+    my ($f) = @_;
+    open my $h, '<', $f or die "Cannot read $f: $!\n";
+    local $/; my $c = <$h>; close $h;
+    return $c;
+}
+
+sub write_file {
+    my ($f, $c) = @_;
+    open my $h, '>', $f or die "Cannot write $f: $!\n";
+    print $h $c;
+    close $h;
+}
+
+# ====== 1. config.guess ======
+print "Patching config.guess...\n";
+my $gc = read_file($cg);
+my $cg_changed = 0;
+
+# 1.1 Insert __OHOS__ after the __ANDROID__ LIBC detection
+unless ($gc =~ /__OHOS__/) {
+    # Find '#if defined(__ANDROID__)' followed by 'LIBC=android' on next line
+    # Use regex for flexibility with whitespace variations
+    if ($gc =~ s{(^\s*#\s*if\s+defined\(__ANDROID__\)\s*\n\s*LIBC=android)}
+                    {$1\n#elif defined(__OHOS__)\n    LIBC=ohos}m) {
+        print "  [ok] Added __OHOS__ LIBC detection\n";
+        $cg_changed++;
+    } else {
+        warn "  [warn] Could not find __ANDROID__/LIBC=android in config.guess\n";
+    }
+} else {
+    print "  [skip] __OHOS__ already present\n";
+}
+
+# 1.2 Insert HarmonyOS case block before NetBSD
+unless ($gc =~ /HarmonyOS/) {
+    my $block =
+        "    *:HarmonyOS:*:*)\n" .
+        "\tcase \"\$UNAME_MACHINE\" in\n" .
+        "\t    aarch64|arm64) MACHINE=aarch64 ;;\n" .
+        "\t    armv7*|armv8*) MACHINE=arm ;;\n" .
+        "\t    x86_64|amd64)  MACHINE=x86_64 ;;\n" .
+        "\t    i?86)         MACHINE=i686 ;;\n" .
+        "\t    *)            MACHINE=\"\$UNAME_MACHINE\" ;;\n" .
+        "\tesac\n" .
+        "\tGUESS=\${MACHINE}-unknown-linux-ohos\n" .
+        "\t;;\n\n";
+
+    # Match the NetBSD line that starts the NetBSD case in the main switch
+    if ($gc =~ s/(^[ \t]+\*\:NetBSD\:\*\:\*\)[ \t]*\n)/$block$1/m) {
+        print "  [ok] Added HarmonyOS system identification\n";
+        $cg_changed++;
+    } else {
+        warn "  [warn] Could not find NetBSD insertion point in config.guess\n";
+    }
+} else {
+    print "  [skip] HarmonyOS block already present\n";
+}
+
+write_file($cg, $gc) if $cg_changed;
+
+# ====== 2. config.sub ======
+print "\nPatching config.sub...\n";
+my $sc = read_file($cs);
+my $changes = 0;
+
+# 2.1 Add ohos-linux triplet after android-linux
+unless ($sc =~ /ohos-linux/) {
+    # Match the android-linux block (tabs for indentation)
+    if ($sc =~ s{^(\s*android-linux\)\s*\n)((\s*)basic_machine=\$field1-unknown\s*\n)((\s*)basic_os=linux-android\s*\n)(\s*;;\s*\n)}
+                    {$1$2$4$6\tohos-linux)\n$3basic_machine=\$field1-unknown\n$5basic_os=linux-ohos\n$6}m) {
+        print "  [ok] Added ohos-linux triplet\n"; $changes++;
+    } else {
+        warn "  [warn] Could not find android-linux in config.sub\n";
+    }
+} else {
+    print "  [skip] ohos-linux already present\n";
+}
+
+# 2.2 Add ohos* to OS type list
+# Only check the gnu* | android* line for ohos*
+unless ($sc =~ /gnu\*\s*\|\s*android\*\s*\|\s*ohos\*/) {
+    if ($sc =~ s{(gnu\*\s*\|\s*android\*)}{$1 | ohos*}) {
+        print "  [ok] Added ohos* to OS list\n"; $changes++;
+    }
+} else {
+    print "  [skip] ohos* already in OS list\n";
+}
+
+# 2.3 Add linux-ohos to kernel-OS validation list
+unless ($sc =~ /linux-ohos/) {
+    # Two known variants of the uclibc entry:
+    #   linux-uclibc*- )   (xz 5.6.2's config.sub)
+    #   linux-uclibc* )    (older versions)
+    if ($sc =~ s{(linux-uclibc\*[/-]?\s*)\)}{$1| linux-ohos*)}) {
+        print "  [ok] Added linux-ohos to kernel list\n"; $changes++;
+    } else {
+        warn "  [warn] Could not find linux-uclibc pattern in config.sub\n";
+    }
+} else {
+    print "  [skip] linux-ohos already present\n";
+}
+
+write_file($cs, $sc) if $changes;
+
+print "\nDone. cg=$cg_changed sub=$changes change(s).\n";
+
+# ====== Verification (grep-based, avoids execution issues on HarmonyOS) ======
+print "\n--- Verification ---\n";
+my $ok = 0;
+$ok++ if $gc =~ /__OHOS__/;
+$ok++ if $gc =~ /HarmonyOS/;
+$ok++ if $sc =~ /ohos-linux/;
+$ok++ if $sc =~ /android\*\s*\|\s*ohos\*/;  # ohos* in OS list
+$ok++ if $sc =~ /linux-ohos/;
+
+printf "config.guess: __OHOS__=%d HarmonyOS=%d\n",
+    ($gc =~ /__OHOS__/ ? 1 : 0), ($gc =~ /HarmonyOS/ ? 1 : 0);
+printf "config.sub:  ohos-linux=%d ohos*=%d linux-ohos=%d\n",
+    ($sc =~ /ohos-linux/ ? 1 : 0), ($sc =~ /android\*.*ohos\*/ ? 1 : 0), ($sc =~ /linux-ohos/ ? 1 : 0);
+print "Score: $ok/5\n";
+
+if ($ok >= 4) {
+    print "✅ Patching successful.\n";
+    exit 0;
+} else {
+    print "❌ Some patches may have failed.\n";
+    exit 1;
+}