deveco_hmigbot 0.21.5

package/skills/migrate-core/scripts/convert/convert-resources.mjs

@@ -0,0 +1,437 @@
+#!/usr/bin/env node
+/**
+ * Android resources → HarmonyOS resources 确定性转换（通用版）。
+ *
+ * 来源：在真实迁移项目中验证过的转换脚本，去掉了应用特定的路径与主题 token，
+ * I/O 全部参数化；转换逻辑（字符串清洗、locale 映射、vector→SVG）保持原样。
+ *
+ * 用法：
+ *   node convert-resources.mjs --src <Android 源码根> --dst <HarmonyOS 工程根> --out <工作目录> [--app-name <名字>] [--module <模块名>=entry]
+ *
+ * 做什么：
+ *   - 自动发现 $SRC 下所有 *\/src/main/res 目录（跳过 build/、测试目录）
+ *   - strings.xml / plurals → <module>/src/main/resources/<locale>/element/{string,plural}.json（base + 多语言）
+ *   - colors.xml → base/element/color.json；values-night/colors.xml → dark/element/color.json
+ *   - vector drawable XML → base/media/<name>.svg（clip-path 丢弃并告警；非 vector 记 skipped）
+ *   - mipmap 应用图标（ic_launcher*）拷到 base/media 与 AppScope
+ *   - integers/dimens 汇总进清单（不落资源，供实现单元当常量参考）
+ *   - 产出 <out>/resource-manifest.json（统计 + 图标清单 + skipped + warnings + 冲突记录）
+ *
+ * 不做什么（留给实现单元）：shape/selector/layer-list 等非 vector drawable、9-patch、主题 token 设计。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+
+// ---------- args ----------
+function argOf(flag) {
+  const i = process.argv.indexOf(flag);
+  return i >= 0 && process.argv[i + 1] ? process.argv[i + 1] : undefined;
+}
+const SRC = argOf('--src');
+const DST = argOf('--dst');
+const OUT = argOf('--out');
+const APP_NAME = argOf('--app-name');
+const MODULE = argOf('--module') || 'entry'; // 目标模块名（多模块工程用 --module 指定）
+// AAR/库资源合并：把解包 AAR 的 res 目录（可多个，逗号分隔）并入转换集——库资源缺口的轻量解法；
+// 未解包的 .aar 先 unzip 取其 res/ 再传入（.aar 即 zip）。反编合并指引见 references/topics/resources/aar-decompile.md。
+const EXTRA_RES = (argOf('--extra-res') || '').split(',').map(s => s.trim()).filter(Boolean);
+if (!SRC || !DST || !OUT) {
+  console.error('usage: node convert-resources.mjs --src <android root> --dst <harmony project> --out <workdir> [--app-name <name>] [--module <name>=entry] [--extra-res <AAR的res,..>]');
+  process.exit(1);
+}
+const skipped = [];
+const warnings = [];
+const conflicts = [];
+
+// ---------- helpers ----------
+function read(p) { return fs.readFileSync(p, 'utf8'); }
+function write(p, s) { fs.mkdirSync(path.dirname(p), { recursive: true }); fs.writeFileSync(p, s); }
+function decodeXmlEntities(s) {
+  return s.replace(/&#x([0-9a-fA-F]+);/g, (_, h) => String.fromCodePoint(parseInt(h, 16)))
+    .replace(/&#(\d+);/g, (_, d) => String.fromCodePoint(parseInt(d, 10)))
+    .replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"')
+    .replace(/&apos;/g, "'").replace(/&amp;/g, '&');
+}
+function unescapeAndroid(s) {
+  let out = ''; let i = 0;
+  while (i < s.length) {
+    const c = s[i];
+    if (c === '\\' && i + 1 < s.length) {
+      const n = s[i + 1];
+      if (n === 'n') out += '\n'; else if (n === 't') out += '\t';
+      else if (n === '\'') out += "'"; else if (n === '"') out += '"';
+      else if (n === '\\') out += '\\'; else if (n === ' ') out += ' ';
+      else { out += n; }
+      i += 2;
+    } else { out += c; i += 1; }
+  }
+  return out;
+}
+function cleanText(raw) {
+  let s = (raw ?? '').replace(/<!\[CDATA\[([\s\S]*?)\]\]>/g, '$1');
+  s = decodeXmlEntities(s);
+  s = s.replace(/<xliff:g[^>]*>/g, '').replace(/<\/xliff:g>/g, '');
+  s = s.replace(/<[^>]+>/g, '');
+  s = unescapeAndroid(s);
+  return s.trim();
+}
+
+// ---------- discover res dirs ----------
+function findResDirs(root) {
+  const out = [];
+  const walk = (dir, depth) => {
+    if (depth > 8) return;
+    let entries;
+    try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return; }
+    for (const e of entries) {
+      if (!e.isDirectory()) continue;
+      const name = e.name;
+      if (name === 'build' || name === '.git' || name === 'node_modules' || name.startsWith('.')) continue;
+      if (name === 'test' || name === 'androidTest' || name === 'sharedTest') continue;
+      const p = path.join(dir, name);
+      if (name === 'res' && dir.endsWith(path.join('src', 'main'))) { out.push(p); continue; }
+      walk(p, depth + 1);
+    }
+  };
+  walk(root, 0);
+  // app 模块优先（同名资源冲突时 app 的先到先得）
+  return out.sort((a, b) => {
+    const aApp = /\/app\//.test(String(a).replace(/\\/g, '/')) ? 0 : 1;   // Windows 反斜杠路径也认
+    const bApp = /\/app\//.test(String(b).replace(/\\/g, '/')) ? 0 : 1;
+    return aApp - bApp || a.localeCompare(b);
+  });
+}
+const resDirs = findResDirs(SRC);
+// 库资源排在应用资源之后：同名冲突时应用侧先到先得，AAR 只补缺
+for (const er of EXTRA_RES) {
+  if (fs.existsSync(er)) resDirs.push(er);
+  else console.error(`warn: --extra-res 不存在，跳过：${er}`);
+}
+if (!resDirs.length) { console.error(`no */src/main/res found under ${SRC}`); process.exit(1); }
+
+// ---------- locale mapping ----------
+const ANDROID_TO_OH_LOCALE = (dir) => {
+  const m = dir.match(/^values-(.+)$/); if (!m) return null;
+  let l = m[1];
+  if (/^(night|land|port|v\d+|w\d+dp|h\d+dp|sw\d+dp|ldpi|mdpi|hdpi|xhdpi|xxhdpi|xxxhdpi)$/.test(l)) return null; // 非语言限定符
+  l = l.replace(/^zh-rCN$/, 'zh_CN').replace(/^zh-rTW$/, 'zh_TW').replace(/^zh-rHK$/, 'zh_HK')
+    .replace(/^pt-rBR$/, 'pt_BR').replace(/^kn-rIN$/, 'kn_IN')
+    .replace(/^in$/, 'id').replace(/^iw$/, 'he')
+    .replace(/^b\+([a-z]+)\+([A-Za-z0-9]+)(?:\+([A-Za-z0-9]+))?$/, (_m, lang, a, b) => b ? `${lang}_${a}_${b}` : `${lang}_${a}`)
+    .replace(/^([a-z]{2,3})-r([A-Za-z0-9]+)$/, '$1_$2');
+  // 目标平台限定符语法：语言 2–3 小写；可选文字 4 字母（首大写）；可选地区 2 大写字母或 3 位数字。
+  // 地区两字母统一大写；变体/方言标签（如 4 字母以上的地区位）不在语法内 → 整个 locale 跳过并告警，不让一个目录名弄红整个构建
+  const seg = l.split('_');
+  if (seg.length > 1 && /^[a-z]{2}$/.test(seg[seg.length - 1])) seg[seg.length - 1] = seg[seg.length - 1].toUpperCase();
+  l = seg.join('_');
+  if (/^[a-z]{2,3}(_[A-Z][a-z]{3})?(_[A-Z]{2}|_\d{3})?$/.test(l)) return l;
+  warnings.push(`locale ${dir} → ${l} 不符合目标平台限定符语法，已跳过`);
+  return null;
+};
+
+// ---------- strings + plurals（多 res 目录合并，先到先得，冲突记录） ----------
+const stringsByLocale = new Map(); // ohLocale -> Map(name->value)
+const pluralsByLocale = new Map(); // ohLocale -> Map(name->[{quantity,value}])
+for (const resDir of resDirs) {
+  let valueDirs;
+  try { valueDirs = fs.readdirSync(resDir).filter((d) => d.startsWith('values')); } catch { continue; }
+  for (const dir of valueDirs) {
+    // 不按文件名找：AAR/库资源是合并式 values.xml——读目录下全部 xml 提取标签
+    let xmlFiles;
+    try { xmlFiles = fs.readdirSync(path.join(resDir, dir)).filter((x) => x.endsWith('.xml')); } catch { continue; }
+    if (!xmlFiles.length) continue;
+    const oh = dir === 'values' ? 'base' : ANDROID_TO_OH_LOCALE(dir);
+    if (!oh) continue;
+    const xml = xmlFiles.map((x) => read(path.join(resDir, dir, x))).join('\n');
+    if (!stringsByLocale.has(oh)) stringsByLocale.set(oh, new Map());
+    if (!pluralsByLocale.has(oh)) pluralsByLocale.set(oh, new Map());
+    const sm = stringsByLocale.get(oh); const pm = pluralsByLocale.get(oh);
+    const put = (name, value) => {
+      if (sm.has(name)) { if (sm.get(name) !== value) conflicts.push(`string ${oh}/${name} (kept first)`); return; }
+      sm.set(name, value);
+    };
+    for (const m of xml.matchAll(/<string\s+name="([^"]+)"([^>]*?)\/>/g)) put(m[1], '');
+    for (const m of xml.matchAll(/<string\s+name="([^"]+)"([^>]*)>([\s\S]*?)<\/string>/g)) put(m[1], cleanText(m[3]));
+    for (const m of xml.matchAll(/<plurals\s+name="([^"]+)"[^>]*>([\s\S]*?)<\/plurals>/g)) {
+      if (pm.has(m[1])) continue;
+      // 自闭合空项（<item quantity="many"/>，翻译平台留的占位）与实体项一趟按文档序解析——分两趟时
+      // 实体项正则会从自闭合标签越过 `/>` 吞到下一项的 </item>，产出重复 quantity（构建报 Duplicated quantity）。
+      // 空值不进（plural 项须有值），同 quantity 只留首个。
+      const items = []; const seenQ = new Set();
+      for (const im of m[2].matchAll(/<item\s+quantity="([^"]+)"[^>]*?(\/>|>([\s\S]*?)<\/item>)/g)) {
+        const value = im[2] === '/>' ? '' : cleanText(im[3]);
+        if (!value || seenQ.has(im[1])) continue;
+        seenQ.add(im[1]); items.push({ quantity: im[1], value });
+      }
+      // 目标平台要求 other 必在：源里 other 为空占位时用最接近的复数档补齐（many > few > 末项），不让整个 locale 构建失败
+      if (items.length && !seenQ.has('other')) {
+        const fill = items.find((i) => i.quantity === 'many') || items.find((i) => i.quantity === 'few') || items[items.length - 1];
+        items.push({ quantity: 'other', value: fill.value });
+        warnings.push(`plural ${oh}/${m[1]}: other 缺失，以 ${fill.quantity} 档补齐`);
+      }
+      if (items.length) pm.set(m[1], items);
+    }
+  }
+}
+if (!stringsByLocale.has('base')) stringsByLocale.set('base', new Map());
+const baseMap = stringsByLocale.get('base');
+
+// app 名：--app-name 优先，其次源 app_name，最后保留骨架里的 EntryAbility_label
+const appName = APP_NAME || baseMap.get('app_name') || undefined;
+if (appName) baseMap.set('app_name', appName);
+
+// 写 string.json / plural.json（保留骨架里已有、源没有的 name）
+const skeletonStrings = path.join(DST, MODULE, 'src/main/resources/base/element/string.json');
+let keepStrings = [];
+try { keepStrings = JSON.parse(read(skeletonStrings)).string || []; } catch { keepStrings = []; }
+for (const oh of stringsByLocale.keys()) {
+  const map = stringsByLocale.get(oh);
+  if (!map.size) continue;
+  if (appName && !map.has('app_name')) map.set('app_name', appName);
+  const arr = [];
+  if (oh === 'base') {
+    for (const k of keepStrings) if (!map.has(k.name)) arr.push({ name: k.name, value: k.value });
+  }
+  for (const [name, value] of map) arr.push({ name, value });
+  if (oh === 'base' && appName) {
+    const idx = arr.findIndex((x) => x.name === 'EntryAbility_label');
+    if (idx >= 0) arr[idx].value = appName; else arr.push({ name: 'EntryAbility_label', value: appName });
+  }
+  const dir = oh === 'base' ? 'base' : oh;
+  write(path.join(DST, MODULE, `src/main/resources/${dir}/element/string.json`), JSON.stringify({ string: arr }, null, 2));
+  const pm = pluralsByLocale.get(oh);
+  if (pm && pm.size) {
+    const pl = [...pm.entries()].map(([name, value]) => ({ name, value }));
+    write(path.join(DST, MODULE, `src/main/resources/${dir}/element/plural.json`), JSON.stringify({ plural: pl }, null, 2));
+  }
+}
+if (appName) {
+  write(path.join(DST, 'AppScope/resources/base/element/string.json'),
+    JSON.stringify({ string: [{ name: 'app_name', value: appName }] }, null, 2));
+}
+
+// ---------- colors（base + night→dark） ----------
+function parseColorsFile(f, into) {
+  if (!fs.existsSync(f)) return;
+  for (const m of read(f).matchAll(/<color\s+name="([^"]+)"[^>]*>([^<]+)<\/color>/g)) {
+    const name = m[1]; const value = m[2].trim();
+    if (into.has(name)) { if (into.get(name) !== value) conflicts.push(`color ${name} (kept first)`); continue; }
+    into.set(name, value);
+  }
+}
+// 引用解析：主题色表常见 `@color/x` 转引（整表可能全是引用，直接丢会得到 0 色 + 布局悬空），在同表内递归解到字面量，
+// 夜间表回退基表；@android:color/、?attr/ 与解不到的库色告警剔除。
+function resolveColorRefs(map, fallback) {
+  for (const [name, raw] of [...map.entries()]) {
+    let v = raw, hops = 0;
+    while (typeof v === 'string' && v.startsWith('@') && hops++ < 6) {
+      const ref = (v.match(/^@color\/([\w.]+)$/) || [])[1];
+      v = ref ? (map.get(ref) ?? (fallback ? fallback.get(ref) : undefined) ?? null) : null;
+    }
+    if (typeof v === 'string' && /^#[0-9A-Fa-f]{3,8}$/.test(v)) map.set(name, v);
+    else { warnings.push(`color ${name} = ${raw} unresolved (dropped)`); map.delete(name); }
+  }
+}
+const baseColors = new Map(); const nightColors = new Map();
+for (const resDir of resDirs) {
+  for (const [sub, map] of [['values', baseColors], ['values-night', nightColors]]) {
+    let xs; try { xs = fs.readdirSync(path.join(resDir, sub)).filter((x) => x.endsWith('.xml')); } catch { continue; }
+    for (const x of xs) parseColorsFile(path.join(resDir, sub, x), map);
+  }
+}
+resolveColorRefs(baseColors, null);
+resolveColorRefs(nightColors, baseColors);
+function normHex(v) {
+  // Android #AARRGGBB → 保留 8 位（HarmonyOS 支持 #AARRGGBB）；其余原样大写
+  return v.toUpperCase();
+}
+if (baseColors.size) {
+  const baseColorF = path.join(DST, MODULE, 'src/main/resources/base/element/color.json');
+  let keepColors = [];
+  try { keepColors = JSON.parse(read(baseColorF)).color || []; } catch { keepColors = []; }
+  const arr = keepColors.filter((c) => !baseColors.has(c.name))
+    .concat([...baseColors.entries()].map(([name, value]) => ({ name, value: normHex(value) })));
+  write(baseColorF, JSON.stringify({ color: arr }, null, 2));
+}
+if (nightColors.size) {
+  const darkColorF = path.join(DST, MODULE, 'src/main/resources/dark/element/color.json');
+  let keepDark = [];
+  try { keepDark = JSON.parse(read(darkColorF)).color || []; } catch { keepDark = []; }
+  const arr = keepDark.filter((c) => !nightColors.has(c.name))
+    .concat([...nightColors.entries()].map(([name, value]) => ({ name, value: normHex(value) })));
+  write(darkColorF, JSON.stringify({ color: arr }, null, 2));
+}
+
+// ---------- vector drawable → svg ----------
+const ANDROID_COLOR_MAP = { '@android:color/white': '#FFFFFF', '@android:color/black': '#000000', '#FFF': '#FFFFFF', '#000': '#000000' };
+function normColor(v, fallback) {
+  if (!v) return { c: fallback, a: 1 };
+  v = v.trim();
+  if (ANDROID_COLOR_MAP[v]) return { c: ANDROID_COLOR_MAP[v], a: 1 };
+  if (v.startsWith('?attr') || v.startsWith('?android')) return { c: fallback, a: 1 };
+  if (v.startsWith('@color/')) { const c = baseColors.get(v.slice(7)); if (c) return normColor(c, fallback); return { c: fallback, a: 1 }; }
+  if (v.startsWith('#')) {
+    if (v.length === 9) return { c: '#' + v.slice(3), a: parseInt(v.slice(1, 3), 16) / 255 };
+    if (v.length === 7) return { c: v, a: 1 };
+    if (v.length === 5) return { c: '#' + v.slice(1).split('').map((x) => x + x).join('').slice(0, 6), a: 1 };
+    if (v.length === 4) return { c: '#' + v.slice(1).split('').map((x) => x + x).join(''), a: 1 };
+  }
+  return { c: fallback, a: 1 };
+}
+function attrs(s) {
+  const o = {};
+  for (const m of s.matchAll(/([\w:.%-]+)="([^"]*)"/g)) o[m[1]] = m[2];
+  return o;
+}
+let gradCounter = 0;
+function pathSvg(pa, defs) {
+  const a = attrs(pa);
+  let fill = 'none'; let fillOpacity = '';
+  const gradMatch = pa.match(/<aapt:attr\s+name="android:fillColor"[^>]*>([\s\S]*?)<\/aapt:attr>/);
+  if (gradMatch) {
+    const g = attrs(gradMatch[1].match(/<gradient[^>]*>/)[0]);
+    const id = `g${gradCounter++}`;
+    const stops = [];
+    for (const sm of gradMatch[1].matchAll(/<item\s+([^>]*?)\/>/g)) {
+      const ia = attrs(sm[1]);
+      stops.push(`    <stop offset="${ia['android:offset']}" stop-color="${normColor(ia['android:color'], '#000000').c}"/>`);
+    }
+    defs.push(`  <linearGradient id="${id}" x1="${g['android:startX'] ?? 0}" y1="${g['android:startY'] ?? 0}" x2="${g['android:endX'] ?? 1}" y2="${g['android:endY'] ?? 0}">\n${stops.join('\n')}\n  </linearGradient>`);
+    fill = `url(#${id})`;
+  } else {
+    const nc = normColor(a['android:fillColor'], '#000000');
+    if (a['android:fillColor'] !== undefined) { fill = nc.c; fillOpacity = (nc.a * parseFloat(a['android:fillAlpha'] ?? '1')).toFixed(3); }
+  }
+  if (a['android:strokeColor'] !== undefined) {
+    const sc = normColor(a['android:strokeColor'], '#000000');
+    return `<path d="${a['android:pathData']}" fill="${fill}"${fillOpacity && fillOpacity !== '1.000' ? ` fill-opacity="${fillOpacity}"` : ''} stroke="${sc.c}"${a['android:strokeWidth'] ? ` stroke-width="${a['android:strokeWidth']}"` : ' stroke-width="1"'}/>`;
+  }
+  return `<path d="${a['android:pathData']}" fill="${fill}"${fillOpacity && fillOpacity !== '1.000' ? ` fill-opacity="${fillOpacity}"` : ''}${a['android:fillType'] === 'evenOdd' ? ' fill-rule="evenodd"' : ''}/>`;
+}
+function groupTransform(a) {
+  const px = parseFloat(a['android:pivotX'] ?? 0); const py = parseFloat(a['android:pivotY'] ?? 0);
+  const tx = parseFloat(a['android:translateX'] ?? 0); const ty = parseFloat(a['android:translateY'] ?? 0);
+  const r = parseFloat(a['android:rotation'] ?? 0);
+  const sx = parseFloat(a['android:scaleX'] ?? 1); const sy = parseFloat(a['android:scaleY'] ?? 1);
+  return `translate(${px + tx} ${py + ty}) rotate(${r}) scale(${sx} ${sy}) translate(${-px} ${-py})`;
+}
+function vectorToSvg(xml, name) {
+  const rootM = xml.match(/<vector[^>]*>/); if (!rootM) return null;
+  const ra = attrs(rootM[0]);
+  const w = (ra['android:width'] || '24dp').replace('dp', '');
+  const h = (ra['android:height'] || '24dp').replace('dp', '');
+  const vw = ra['android:viewportWidth'] || w; const vh = ra['android:viewportHeight'] || h;
+  const defs = []; const body = [];
+  const stack = [];
+  const tagRe = /<\/?(group|path|clip-path|aapt:attr|vector)[^>]*?\/?>/g;
+  const region = xml.slice(rootM.index + rootM[0].length, xml.lastIndexOf('</vector>'));
+  for (const t of region.matchAll(tagRe)) {
+    const tag = t[0];
+    if (tag.startsWith('<group')) stack.push(`<g transform="${groupTransform(attrs(tag))}">`);
+    else if (tag.startsWith('</group')) { stack.push('</g>'); const g = stack.pop(); if (g && g.startsWith('<g')) body.push(g); const c = stack.pop(); if (c) body.push(c); }
+    else if (tag.startsWith('<path')) body.push(pathSvg(region.slice(t.index, region.indexOf('/>', t.index) + 2), defs));
+    else if (tag.startsWith('<clip-path')) warnings.push(`${name}: clip-path dropped`);
+  }
+  return `<?xml version="1.0" encoding="UTF-8"?>\n<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${h}" viewBox="0 0 ${vw} ${vh}">\n${defs.length ? `<defs>\n${defs.join('\n')}\n</defs>\n` : ''}${body.join('\n')}\n</svg>\n`;
+}
+const icons = [];
+const iconSeen = new Set();
+for (const resDir of resDirs) {
+  let dirs;
+  try { dirs = fs.readdirSync(resDir).filter((d) => d === 'drawable' || d.startsWith('drawable-')); } catch { continue; }
+  for (const d of dirs) {
+    const full = path.join(resDir, d);
+    for (const f of fs.readdirSync(full)) {
+      if (!f.endsWith('.xml')) { if (!/\.(png|jpe?g|webp|gif)$/i.test(f)) skipped.push(`${path.relative(SRC, full)}/${f} (non-xml)`); continue; } // 位图另段处理
+      const name = f.replace('.xml', '');
+      if (iconSeen.has(name)) continue;
+      const xml = read(path.join(full, f));
+      if (!/<vector[\s>]/.test(xml)) { skipped.push(`${path.relative(SRC, full)}/${f} (not vector: ${(xml.match(/<(\w[\w-]*)[\s>]/) || [])[1]})`); continue; }
+      const svg = vectorToSvg(xml, name);
+      if (svg) { write(path.join(DST, MODULE, `src/main/resources/base/media/${name}.svg`), svg); icons.push(name); iconSeen.add(name); }
+      else skipped.push(`${path.relative(SRC, full)}/${f} (convert fail)`);
+    }
+  }
+}
+
+// ---------- 位图（drawable*/mipmap* 下的 png/jpg/webp/gif）→ base/media：不搬则布局里 $r('app.media.x') 悬空（实测 3 个应用骨架期即硬违规） ----------
+// mipmap 目录是任意可引用图片资源（@mipmap/x 与 @drawable/x 同为 $r('app.media.x')），不只放启动图标。
+// 同名多密度按 nodpi > xxxhdpi > … > 无限定符 取一张（媒体只需一份最高清）；未列出的限定符目录排最后；9-patch 无等价记 skipped。
+const RASTER_DENS = ['drawable-nodpi', 'mipmap-nodpi', 'drawable-xxxhdpi', 'mipmap-xxxhdpi', 'drawable-xxhdpi', 'mipmap-xxhdpi', 'drawable-xhdpi', 'mipmap-xhdpi', 'drawable-hdpi', 'mipmap-hdpi', 'drawable-mdpi', 'mipmap-mdpi', 'drawable', 'mipmap'];
+const rasters = [];
+for (const resDir of resDirs) {
+  let dirs; try { dirs = fs.readdirSync(resDir).filter((d) => /^(drawable|mipmap)(-|$)/.test(d)); } catch { continue; }
+  const rank = (d) => (RASTER_DENS.indexOf(d) < 0 ? 99 : RASTER_DENS.indexOf(d));
+  dirs.sort((a, b) => rank(a) - rank(b));
+  for (const d of dirs) {
+    const full = path.join(resDir, d);
+    for (const f of fs.readdirSync(full)) {
+      const m = f.match(/^(.+?)(\.9)?\.(png|jpe?g|webp|gif)$/i); if (!m) continue;
+      if (m[2]) { skipped.push(`${path.relative(SRC, full)}/${f} (9-patch 无等价)`); continue; }
+      const name = m[1]; if (iconSeen.has(name)) continue;
+      const ext = m[3].toLowerCase() === 'jpeg' ? 'jpg' : m[3].toLowerCase();
+      const dst = path.join(DST, MODULE, `src/main/resources/base/media/${name}.${ext}`);
+      fs.mkdirSync(path.dirname(dst), { recursive: true }); fs.copyFileSync(path.join(full, f), dst);
+      iconSeen.add(name); rasters.push(name);
+    }
+  }
+}
+
+// ---------- app icons (mipmap png，取最高密度可用的) ----------
+const DENSITIES = ['mipmap-xxxhdpi', 'mipmap-xxhdpi', 'mipmap-xhdpi', 'mipmap-hdpi', 'mipmap-mdpi', 'mipmap'];
+outer:
+for (const resDir of resDirs) {
+  for (const den of DENSITIES) {
+    const mip = path.join(resDir, den);
+    if (!fs.existsSync(mip)) continue;
+    let copied = false;
+    for (const [srcName, dstName] of [['ic_launcher_foreground.png', 'foreground.png'], ['ic_launcher_background.png', 'background.png'], ['ic_launcher.png', 'ic_launcher.png']]) {
+      const f = path.join(mip, srcName);
+      if (fs.existsSync(f)) {
+        for (const dst of [path.join(DST, MODULE, 'src/main/resources/base/media'), path.join(DST, 'AppScope/resources/base/media')]) {
+          fs.mkdirSync(dst, { recursive: true }); fs.copyFileSync(f, path.join(dst, dstName));
+        }
+        copied = true;
+      }
+    }
+    if (copied) {
+      // 单图场景（源无分层 png，仅 ic_launcher.png）：icon 引用从模板 layered_image 切到单图，
+      // 否则桌面仍显示模板分层图标（搬运成功但引用没切，实测坑）
+      const gotForeground = fs.existsSync(path.join(DST, 'AppScope/resources/base/media', 'foreground.png')) &&
+        fs.existsSync(path.join(mip, 'ic_launcher_foreground.png'));
+      if (!gotForeground && fs.existsSync(path.join(mip, 'ic_launcher.png'))) {
+        for (const cfg of [path.join(DST, 'AppScope/app.json5'), path.join(DST, MODULE, 'src/main/module.json5')]) {
+          if (!fs.existsSync(cfg)) continue;
+          const t0 = fs.readFileSync(cfg, 'utf8');
+          const t1 = t0.replace(/"icon"\s*:\s*"\$media:layered_image"/g, '"icon": "$media:ic_launcher"');
+          if (t1 !== t0) { fs.writeFileSync(cfg, t1); warnings.push(`icon 引用切换为单图 $media:ic_launcher（源无分层 png）：${cfg}`); }
+        }
+      }
+      break outer;
+    }
+  }
+}
+
+// ---------- integers/dimens（进清单，供实现单元当常量参考） ----------
+const integers = {}; const dimens = {};
+for (const resDir of resDirs) {
+  for (const file of ['values/integers.xml', 'values/dimens.xml']) {
+    const f = path.join(resDir, file);
+    if (!fs.existsSync(f)) continue;
+    const xml = read(f);
+    for (const m of xml.matchAll(/<integer\s+name="([^"]+)"[^>]*>([^<]+)<\/integer>/g)) if (!(m[1] in integers)) integers[m[1]] = parseInt(m[2].trim());
+    for (const m of xml.matchAll(/<dimen\s+name="([^"]+)"[^>]*>([^<]+)<\/dimen>/g)) if (!(m[1] in dimens)) dimens[m[1]] = m[2].trim();
+  }
+}
+
+// ---------- manifest ----------
+const manifest = {
+  resDirs: resDirs.map((d) => path.relative(SRC, d)),
+  strings: { base: baseMap.size, locales: [...stringsByLocale.keys()].filter((k) => k !== 'base' && stringsByLocale.get(k).size).length },
+  plurals: (pluralsByLocale.get('base') || new Map()).size,
+  colors: { base: baseColors.size, dark: nightColors.size },
+  icons: icons.sort(), rasters: rasters.sort(),
+  integers, dimens, conflicts, skipped, warnings,
+};
+write(path.join(OUT, 'resource-manifest.json'), JSON.stringify(manifest, null, 2));
+console.log(`resDirs=${resDirs.length} strings(base)=${baseMap.size} locales=${manifest.strings.locales} plurals=${manifest.plurals} colors=${baseColors.size}+${nightColors.size}dark icons=${icons.length}+${rasters.length}raster conflicts=${conflicts.length} skipped=${skipped.length} warnings=${warnings.length}`);