deveco_hmigbot 0.1.0

package/skills/migrate-core/scripts/transpile/transpile-layout.mjs

@@ -0,0 +1,404 @@
+#!/usr/bin/env node
+/**
+ * transpile-layout.mjs — 布局静态转译器（静态前场核心件）。
+ *
+ * Android res/layout/*.xml → ArkUI 骨架 .ets：结构与数值由程序搬运（组件树、尺寸、
+ * 边距、颜色、文案引用、权重、对齐），行为留锚点 TODO 给切片。目标不是"翻译全部"，
+ * 是"结构保真由构造保证 + 覆盖率诚实遥测"：转不动的节点降级为带源锚点的占位，
+ * 绝不静默丢弃（转译率进报告，作为产线健康度指标）。
+ *
+ * 映射知识全在 mapping.json（数据即语料）；资源名与 convert-resources 的 1:1 命名对齐
+ * （@string/x → $r('app.string.x')）。
+ *
+ * 输出是**参考件**：2a 把它落在 spec/front/layouts（不进编译树），切片按需把片段并进页面/组件——实证 45 工程 244/244 份
+ * 骨架从未被页面 import，放进工程只产死代码与悬空立案；<include> 生成的兄弟 import 在整目录一起搬时仍成立。
+ *
+ * 用法：node transpile-layout.mjs --src <android根> --out <骨架输出目录> [--json report]
+ */
+import { readFileSync, writeFileSync, mkdirSync, readdirSync, statSync, existsSync } from 'node:fs';
+import { join, dirname, basename, resolve, relative, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+const MAP = JSON.parse(readFileSync(join(HERE, 'mapping.json'), 'utf8'));
+const argv = process.argv.slice(2);
+const argOf = (n, d) => { const i = argv.indexOf(n); return i >= 0 && argv[i + 1] ? argv[i + 1] : d; };
+const SRC = argOf('--src', null);
+const OUT = argOf('--out', null);
+const JSON_OUT = argOf('--json', null);
+const ONLY = argOf('--file', null);
+// AAR/库 res 目录（逗号分隔）：并入 values/styles/shape 解析（布局仍只取应用侧）
+const EXTRA_RES = (argOf('--extra-res', '') || '').split(',').map(s => s.trim()).filter(Boolean);
+if (!SRC || !OUT) { console.error('usage: transpile-layout.mjs --src <android root> --out <dir> [--json report] [--file x.xml] [--extra-res <aar-res,..>]'); process.exit(2); }
+
+// ---------- 定位 res 目录与布局文件 ----------
+function walk(dir, acc, depth = 0) {
+  if (depth > 14) return acc;
+  let es; try { es = readdirSync(dir); } catch { return acc; }
+  for (const e of es) {
+    if (['build', '.git', 'node_modules', 'test', 'androidTest'].includes(e)) continue;
+    const p = join(dir, e);
+    let st; try { st = statSync(p); } catch { continue; }
+    if (st.isDirectory()) walk(p, acc, depth + 1);
+    else acc.push(p);
+  }
+  return acc;
+}
+const all = walk(resolve(SRC), []);
+for (const er of EXTRA_RES) {
+  if (!existsSync(resolve(er))) { console.error(`⚠ --extra-res 目录不存在：${er}（已跳过——若为 AAR 请先解包）`); continue; }
+  walk(resolve(er), all);
+}
+const norm = p => p.replace(/\\/g, '/');
+const layouts = ONLY ? [resolve(ONLY)] : all.filter(f => /\/res\/layout\/[^/]+\.xml$/.test(norm(f)) && !EXTRA_RES.some(er => f.startsWith(resolve(er))));
+// 变体目录（layout-land/-v21/-sw600dp…）不转译，但必须进遥测——静默漏采=覆盖率谎报
+const variantLayouts = all.filter(f => /\/res\/layout-[^/]+\/[^/]+\.xml$/.test(norm(f)));
+const valueFiles = all.filter(f => /\/(?:res\/)?values\/[^/]+\.xml$/.test(norm(f)));
+
+// ---------- 资源表（strings/colors/dimens 名字 1:1 对齐 convert-resources） ----------
+const dimens = new Map(), colors = new Map();
+for (const f of valueFiles) {
+  const t = readFileSync(f, 'utf8');
+  for (const m of t.matchAll(/<dimen\s+name="([^"]+)"\s*>\s*(-?[\d.]+)(dp|dip|sp|px)\s*<\/dimen>/g)) dimens.set(m[1], Number(m[2]));
+  for (const m of t.matchAll(/<color\s+name="([^"]+)"\s*>\s*(#[0-9a-fA-F]{3,8})\s*<\/color>/g)) colors.set(m[1], m[2]);
+}
+// styles：name → {parent, items{android:attr: value}}，支持显式 parent 与点号隐式父链
+const styles = new Map();
+for (const f of valueFiles) {
+  const t = readFileSync(f, 'utf8');
+  for (const m of t.matchAll(/<style\s+name="([^"]+)"(?:\s+parent="([^"]*)")?\s*>([\s\S]*?)<\/style>/g)) {
+    const items = {};
+    for (const it of m[3].matchAll(/<item\s+name="([^"]+)"\s*>\s*([^<]+?)\s*<\/item>/g)) items[it[1]] = it[2];
+    styles.set(m[1], { parent: m[2] || null, items });
+  }
+}
+function resolveStyle(refRaw, depth = 0) {
+  if (!refRaw || depth > 8) return {};
+  const name = String(refRaw).replace(/^@(?:android:)?style\//, '');
+  const s = styles.get(name);
+  if (!s) return {};
+  const parentName = s.parent !== null ? s.parent : (name.includes('.') ? name.slice(0, name.lastIndexOf('.')) : null);
+  return { ...(parentName ? resolveStyle(parentName, depth + 1) : {}), ...s.items };
+}
+// shape drawable：res/drawable/*.xml 根为 <shape> 的 → 背景修饰符（色/圆角/描边）
+const shapes = new Map();
+for (const f of all.filter(x => /\/(?:res\/)?drawable[^/]*\/[^/]+\.xml$/.test(norm(x)))) {
+  const t = readFileSync(f, 'utf8');
+  if (!/^\s*(?:<\?xml[^>]*\?>)?\s*(?:<!--[\s\S]*?-->\s*)*<shape\b/.test(t)) continue;
+  const g = (re) => (t.match(re) || [])[1];
+  shapes.set(basename(f, '.xml'), {
+    solid: g(/<solid[^>]*android:color="([^"]+)"/),
+    radius: g(/<corners[^>]*android:radius="([^"]+)"/) || g(/android:topLeftRadius="([^"]+)"/),
+    strokeW: g(/<stroke[^>]*android:width="([^"]+)"/),
+    strokeC: g(/<stroke[^>]*android:color="([^"]+)"/),
+  });
+}
+
+// ---------- 极简 XML 解析（同长注释脱敏 → 标签树） ----------
+// XML 实体解码：属性值/文本进 ArkTS 前必须还原（&amp; 原样进 Text() 是生成物文案错误）
+function decodeEntities(s) {
+  return String(s)
+    .replace(/&#x([0-9a-fA-F]+);/g, (_, h) => String.fromCodePoint(parseInt(h, 16)))
+    .replace(/&#(\d+);/g, (_, d) => String.fromCodePoint(Number(d)))
+    .replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&amp;/g, '&');
+}
+function parseXml(text) {
+  const src = text.replace(/<!--[\s\S]*?-->/g, m => m.replace(/[^\n]/g, ' ')).replace(/<\?xml[\s\S]*?\?>/, '');
+  const root = { tag: '#root', attrs: {}, children: [], line: 0 };
+  const stack = [root];
+  // 属性支持单/双引号（单引号是合法 XML，旧版整节点静默丢弃且关闭标签错配污染树）
+  const re = /<\s*(\/)?\s*([\w.$-]+)((?:\s+[\w:.-]+\s*=\s*(?:"[^"]*"|'[^']*'))*)\s*(\/)?\s*>/g;
+  let m;
+  let parsedTags = 0;
+  while ((m = re.exec(src)) !== null) {
+    const [, closing, tag, attrStr, selfClose] = m;
+    const line = src.slice(0, m.index).split('\n').length;
+    if (closing) {
+      // 只弹到同名开标签——错配的关闭标签不许把父节点弹栈（污染树）
+      for (let k = stack.length - 1; k > 0; k--) if (stack[k].tag === tag) { stack.length = k; break; }
+      continue;
+    }
+    parsedTags++;
+    const attrs = {};
+    for (const a of attrStr.matchAll(/([\w:.-]+)\s*=\s*(?:"([^"]*)"|'([^']*)')/g)) attrs[a[1]] = decodeEntities(a[2] !== undefined ? a[2] : a[3]);
+    const node = { tag, attrs, children: [], line };
+    stack[stack.length - 1].children.push(node);
+    if (!selfClose) stack.push(node);
+  }
+  // 诚实遥测：解析器没吃下的开标签数（畸形/不支持写法）——绝不静默蒸发
+  const naive = (src.match(/<\s*[\w.$-]/g) || []).length - (src.match(/<\s*\//g) || []).length;
+  const skipped = Math.max(0, naive - parsedTags);
+  const tree = root.children[0] || null;
+  if (tree) tree.parseSkipped = skipped;
+  return tree;
+}
+
+// ---------- 值解析 ----------
+const stats = { files: 0, nodesTotal: 0, nodesMapped: 0, attrsTotal: 0, attrsMapped: 0, unmapped: {} };
+function dim(v) {
+  if (v === 'match_parent' || v === 'fill_parent') return `'100%'`;
+  if (v === 'wrap_content') return null;
+  const m = String(v).match(/^(-?[\d.]+)(dp|dip|sp|px)$/);
+  if (m) return Number(m[1]);
+  const r = String(v).match(/^@dimen\/(.+)$/);
+  if (r) return dimens.has(r[1]) ? dimens.get(r[1]) : `/* @dimen/${r[1]} */ 0`;
+  const pct = String(v).match(/^([\d.]+)%$/);
+  if (pct) return `'${v}'`;
+  return null;
+}
+function colorOf(v) {
+  if (/^#[0-9a-fA-F]{3,8}$/.test(v)) return `'${v}'`;
+  const r = String(v).match(/^@color\/(.+)$/);
+  if (r) return `$r('app.color.${r[1]}')`;
+  const a = String(v).match(/^@android:color\/(.+)$/);
+  if (a) return `/* android:${a[1]} */ '#00000000'`;
+  return null;
+}
+function textOf(v) {
+  const r = String(v).match(/^@string\/(.+)$/);
+  if (r) return `$r('app.string.${r[1]}')`;
+  // 反斜杠先转义（C:\path 曾变形）；属性值里合法的物理换行转 \n（裸换行=生成物语法错误）
+  return `'${String(v).replace(/\\/g, '\\\\').replace(/'/g, "\\'").replace(/\r/g, '').replace(/\n/g, '\\n')}'`;
+}
+function mediaOf(v) {
+  const r = String(v).match(/^@(?:drawable|mipmap)\/(.+)$/);
+  if (r) return `$r('app.media.${r[1]}')`;
+  return null;
+}
+
+// ---------- 修饰符装配 ----------
+const A = (attrs, k) => attrs[`android:${k}`];
+function modifiers(node, comp, orientation) {
+  const attrs = node.attrs;
+  // style / textAppearance 解析：条目作为缺省并入（节点显式属性优先）
+  for (const sk of ['style', 'android:textAppearance']) {
+    if (attrs[sk]) {
+      const items = resolveStyle(attrs[sk]);
+      for (const [k, v] of Object.entries(items)) {
+        const key = k.startsWith('android:') ? k : `android:${k}`;
+        if (attrs[key] === undefined) attrs[key] = v;
+      }
+      if (Object.keys(items).length) { stats.attrsTotal++; stats.attrsMapped++; }
+      delete attrs[sk === 'style' ? 'style' : sk];
+    }
+  }
+  const mods = [];
+  const todo = [];
+  let mapped = 0, total = 0;
+  const take = (k, fn) => {
+    const v = A(attrs, k);
+    if (v === undefined) return;
+    total++;
+    const r = fn(v);
+    if (r === undefined) { todo.push(`${k}="${v}"`); return; }
+    if (r !== null) mods.push(r);
+    mapped++;
+  };
+  take('layout_width', v => { const d = dim(v); return d === null ? null : `.width(${d})`; });
+  take('layout_height', v => { const d = dim(v); return d === null ? null : `.height(${d})`; });
+  take('layout_weight', v => { const n = Number(v); return `.layoutWeight(${Number.isFinite(n) ? n : 1})`; }); // weight=0 是"显式退出加权"，不许 ||1 反转语义
+  take('padding', v => { const d = dim(v); return d == null ? undefined : `.padding(${d})`; });
+  for (const [ak, side] of [['paddingStart', 'left'], ['paddingLeft', 'left'], ['paddingEnd', 'right'], ['paddingRight', 'right'], ['paddingTop', 'top'], ['paddingBottom', 'bottom']]) {
+    take(ak, v => { const d = dim(v); return d == null ? undefined : `.padding({ ${side}: ${d} })`; });
+  }
+  take('layout_margin', v => { const d = dim(v); return d == null ? undefined : `.margin(${d})`; });
+  for (const [ak, side] of [['layout_marginStart', 'left'], ['layout_marginLeft', 'left'], ['layout_marginEnd', 'right'], ['layout_marginRight', 'right'], ['layout_marginTop', 'top'], ['layout_marginBottom', 'bottom']]) {
+    take(ak, v => { const d = dim(v); return d == null ? undefined : `.margin({ ${side}: ${d} })`; });
+  }
+  take('background', v => {
+    const c = colorOf(v);
+    if (c) return `.backgroundColor(${c})`;
+    const sh = String(v).match(/^@drawable\/(.+)$/) && shapes.get(String(v).replace('@drawable/', ''));
+    if (sh) {
+      const parts = [];
+      if (sh.solid) { const sc = colorOf(sh.solid); if (sc) parts.push(`.backgroundColor(${sc})`); }
+      if (sh.radius) { const rd = dim(sh.radius); if (rd != null) parts.push(`.borderRadius(${rd})`); }
+      if (sh.strokeW) { const bw = dim(sh.strokeW); const bc = sh.strokeC ? colorOf(sh.strokeC) : null; if (bw != null) parts.push(`.border({ width: ${bw}${bc ? `, color: ${bc}` : ''} })`); }
+      if (parts.length) return parts.join('\n' + '  '.repeat(0) + '');
+    }
+    // 认不出的 drawable（ripple/layer-list/selector 等 xml）不发虚 $r 引用——降级 TODO 留给切片
+    const dm = String(v).match(/^@drawable\/(.+)$/);
+    if (dm && all.some(f => norm(f).includes(`/drawable`) && f.endsWith(`/${dm[1]}.xml`))) return undefined;
+    const mimg = mediaOf(v);
+    if (mimg) return `.backgroundImage(${mimg})`;
+    return undefined;
+  });
+  take('alpha', v => `.opacity(${v})`);
+  take('visibility', v => v === 'gone' ? `.visibility(Visibility.None)` : v === 'invisible' ? `.visibility(Visibility.Hidden)` : null);
+  take('minHeight', v => { const d = dim(v); return d == null ? undefined : `.constraintSize({ minHeight: ${d} })`; });
+  take('minWidth', v => { const d = dim(v); return d == null ? undefined : `.constraintSize({ minWidth: ${d} })`; });
+  take('elevation', v => { const d = dim(v); return d == null ? undefined : `.shadow({ radius: ${d}, color: '#1F000000' })`; });
+  if (comp === 'Text' || comp === 'Button' || comp === 'TextInput') {
+    take('textSize', v => { const d = dim(v); return d == null ? undefined : `.fontSize(${d})`; });
+    take('textColor', v => { const c = colorOf(v); return c ? `.fontColor(${c})` : undefined; });
+    take('textStyle', v => v.includes('bold') ? `.fontWeight(FontWeight.Bold)` : null);
+    take('maxLines', v => `.maxLines(${v})`);
+    take('ellipsize', v => v === 'end' ? `.textOverflow({ overflow: TextOverflow.Ellipsis })` : null);
+    take('singleLine', v => v === 'true' ? `.maxLines(1)` : null);
+  }
+  if (comp === 'Image') {
+    take('scaleType', v => ({ centerCrop: `.objectFit(ImageFit.Cover)`, fitCenter: `.objectFit(ImageFit.Contain)`, fitXY: `.objectFit(ImageFit.Fill)`, center: `.objectFit(ImageFit.None)` })[v]);
+    take('tint', v => { const c = colorOf(v); return c ? `.fillColor(${c})` : undefined; });
+  }
+  // gravity（照 ui-layout-semantics：主轴 justifyContent / 交叉轴 alignItems，按容器方向分派）
+  const grav = A(attrs, 'gravity');
+  if (grav !== undefined && (comp === 'Column' || comp === 'Row')) {
+    total++;
+    const parts = grav.split('|');
+    let ok = false;
+    for (const p of parts) {
+      const g = MAP.gravity[p.trim()];
+      if (!g) continue;
+      ok = true;
+      if (comp === 'Column') {
+        if (g.h) mods.push(`.alignItems(HorizontalAlign.${g.h})`);
+        if (g.v) mods.push(`.justifyContent(FlexAlign.${g.v === 'Start' ? 'Start' : g.v === 'End' ? 'End' : 'Center'})`);
+      } else {
+        if (g.v) mods.push(`.alignItems(VerticalAlign.${g.v === 'Start' ? 'Top' : g.v === 'End' ? 'Bottom' : 'Center'})`);
+        if (g.h) mods.push(`.justifyContent(FlexAlign.${g.h === 'Start' ? 'Start' : g.h === 'End' ? 'End' : 'Center'})`);
+      }
+    }
+    if (ok) mapped++; else todo.push(`gravity="${grav}"`);
+  }
+  // 记账：app:（ConstraintLayout/Material 等库属性）不转译但必须进分母——否则覆盖率虚高
+  for (const k of Object.keys(attrs)) {
+    if (k.startsWith('app:')) { total++; todo.push(`${k}="${attrs[k]}"`); continue; }
+    if (!k.startsWith('android:')) continue;
+    const bare = k.slice(8);
+    const handled = ['layout_width', 'layout_height', 'layout_weight', 'padding', 'paddingStart', 'paddingLeft', 'paddingEnd', 'paddingRight', 'paddingTop', 'paddingBottom',
+      'layout_margin', 'layout_marginStart', 'layout_marginLeft', 'layout_marginEnd', 'layout_marginRight', 'layout_marginTop', 'layout_marginBottom',
+      'background', 'alpha', 'visibility', 'minHeight', 'minWidth', 'elevation', 'textSize', 'textColor', 'textStyle', 'maxLines', 'ellipsize', 'singleLine',
+      'scaleType', 'tint', 'gravity', 'text', 'src', 'hint', 'id', 'orientation', 'contentDescription', 'checked', 'progress', 'max'];
+    if (handled.includes(bare)) continue;
+    total++;
+    todo.push(`${bare}="${attrs[k]}"`);
+  }
+  stats.attrsTotal += total;
+  stats.attrsMapped += mapped;
+  return { mods, todo };
+}
+
+// ---------- 递归发射 ----------
+function resolveWidget(tag) {
+  const direct = MAP.widgets[tag] || MAP.widgets[tag.split('.').pop()];
+  if (direct) return { w: direct, note: null };
+  // 后缀回退：自定义子类按标准词条转译（MyTextView/CurrencyTextView → TextView）
+  const simple = tag.split('.').pop();
+  for (const suf of MAP.fallbackSuffixes?.order || []) {
+    if (simple.endsWith(suf) && simple !== suf) {
+      const key = MAP.fallbackSuffixes.alias?.[suf] || suf;
+      const w = MAP.widgets[key] || MAP.widgets[key.split('.').pop()];
+      if (w) return { w, note: `custom subclass of ${suf}（${simple}），样式差异切片按源核对` };
+    }
+  }
+  return { w: null, note: null };
+}
+const includeRefs = new Set();
+function emitNode(node, indent, relFile) {
+  const pad = '  '.repeat(indent);
+  stats.nodesTotal++;
+  const { w, note: subclassNote } = resolveWidget(node.tag);
+  const id = A(node.attrs, 'id') ? A(node.attrs, 'id').replace(/^@\+?id\//, '') : null;
+  const anchor = `${relFile}:${node.line}${id ? ` #${id}` : ''}`;
+  if (w && w.kind === 'include') {
+    stats.nodesMapped++;
+    const ref = (node.attrs['layout'] || '').replace(/^@layout\//, '');
+    const pascal = ref.split(/[_-]/).map(s => s[0] ? s[0].toUpperCase() + s.slice(1) : '').join('');
+    if (pascal) includeRefs.add(pascal);
+    return `${pad}// ⚓ ${anchor} include @layout/${ref}\n${pad}${pascal ? `${pascal}Layout()` : `// TODO(include 缺 layout 引用)`}`;
+  }
+  if (!w) {
+    stats.unmapped[node.tag] = (stats.unmapped[node.tag] || 0) + 1;
+    const kids = node.children.map(c => emitNode(c, indent + 1, relFile)).join('\n');
+    return `${pad}// UNMAPPED <${node.tag}> (${anchor}) —— 切片阶段按源实现\n${pad}Column() {\n${kids}\n${pad}}`;
+  }
+  stats.nodesMapped++;
+  let comp = w.component;
+  if (w.byOrientation) comp = w.byOrientation[A(node.attrs, 'orientation') || ''] || w.default;
+  if (w.kind === 'passthrough') {
+    return node.children.map(c => emitNode(c, indent, relFile)).join('\n') || `${pad}// (${node.tag} 透传，无子节点)`;
+  }
+  if (node.tag === 'View' && w.onlyWhenThin) {
+    const h = A(node.attrs, 'layout_height');
+    comp = (h && dim(h) !== null && Number(dim(h)) <= 2) ? 'Divider' : 'Blank';
+  }
+  // 内容参数
+  let arg = '';
+  if (w.contentAttr && node.attrs[w.contentAttr] !== undefined) {
+    const v = node.attrs[w.contentAttr];
+    arg = w.contentAttr === 'android:src' ? (mediaOf(v) || `''`) : textOf(v);
+    stats.attrsTotal++; stats.attrsMapped++;
+  } else if (w.placeholderAttr && node.attrs[w.placeholderAttr] !== undefined) {
+    arg = `{ placeholder: ${textOf(node.attrs[w.placeholderAttr])} }`;
+    stats.attrsTotal++; stats.attrsMapped++;
+  }
+  const { mods, todo } = modifiers(node, comp, A(node.attrs, 'orientation'));
+  const allMods = [...mods, ...(w.extraMods || [])];
+  const kids = (w.kind === 'leaf' || w.kind === 'list') ? [] : node.children;
+  const header = `${pad}// ⚓ ${anchor}${subclassNote ? `\n${pad}// NOTE: ${subclassNote}` : ''}${w.todo ? `\n${pad}// TODO(transpile): ${w.todo}` : ''}${todo.length ? `\n${pad}// TODO(attrs): ${todo.join(' · ').slice(0, 160)}` : ''}`;
+  const open = `${pad}${comp}(${arg})`;
+  const body = kids.length ? ` {\n${kids.map(c => emitNode(c, indent + 1, relFile)).join('\n')}\n${pad}}` : (w.kind === 'container' || w.kind === 'scroll' ? ' {\n' + pad + '}' : '');
+  const modStr = allMods.map(m => `\n${pad}  ${m}`).join('');
+  return `${header}\n${open}${body}${modStr}`;
+}
+
+// ---------- 主流程 ----------
+mkdirSync(OUT, { recursive: true });
+const perFile = [];
+const written = new Map(); // 输出名 -> 源文件（多模块同名布局：后写覆盖=静默失真，必须检出）
+for (const f of layouts) {
+  const relFile = norm(f).split('/res/layout/')[1] || basename(f);
+  const before = { n: stats.nodesTotal, nm: stats.nodesMapped, a: stats.attrsTotal, am: stats.attrsMapped };
+  const tree = parseXml(readFileSync(f, 'utf8'));
+  if (!tree) { perFile.push({ file: relFile, error: '解析失败' }); continue; }
+  const pascal = basename(f, '.xml').split(/[_-]/).map(s => s[0] ? s[0].toUpperCase() + s.slice(1) : '').join('');
+  if (written.has(pascal)) {
+    perFile.push({ file: relFile, error: `输出名冲突：${pascal}Layout.ets 已由 ${written.get(pascal)} 生成（多模块同名布局），本文件跳过——需人工合并或改名` });
+    continue;
+  }
+  written.set(pascal, relFile);
+  includeRefs.clear();
+  const body = emitNode(tree, 2, relFile);
+  const importLines = [...includeRefs].filter(r => r !== pascal).map(r => `import { ${r}Layout } from './${r}Layout';`).join('\n');
+  const ets = `${importLines ? importLines + '\n' : ''}/**
+ * ${pascal}Layout —— 由 transpile-layout 生成（源：res/layout/${relFile}）。
+ * 结构与数值由程序搬运；⚓ 为源锚点；TODO(transpile/attrs) 为未转译项，切片阶段按源补齐。
+ * 行为（点击/数据绑定/可见性逻辑）一律由切片实现，本骨架不含任何业务逻辑。
+ */
+@ComponentV2
+export struct ${pascal}Layout {
+  build() {
+${body}
+  }
+}
+`;
+  writeFileSync(join(OUT, `${pascal}Layout.ets`), ets);
+  stats.files++;
+  perFile.push({
+    file: relFile,
+    nodes: stats.nodesTotal - before.n,
+    nodesMapped: stats.nodesMapped - before.nm,
+    attrs: stats.attrsTotal - before.a,
+    attrsMapped: stats.attrsMapped - before.am,
+  });
+}
+const pct = (a, b) => b ? Math.round(a * 100 / b) : 100;
+const report = {
+  src: relative(process.cwd(), resolve(SRC)) || '.', out: relative(process.cwd(), resolve(OUT)) || '.',
+  totals: {
+    files: stats.files,
+    nodeCoverage: `${stats.nodesMapped}/${stats.nodesTotal} (${pct(stats.nodesMapped, stats.nodesTotal)}%)`,
+    attrCoverage: `${stats.attrsMapped}/${stats.attrsTotal} (${pct(stats.attrsMapped, stats.attrsTotal)}%)`,
+    unmappedTags: stats.unmapped,
+    variantLayoutsSkipped: variantLayouts.length ? { count: variantLayouts.length, note: 'layout-land/-v21/-sw600dp 等变体未转译（切片按需处理）', files: variantLayouts.map(f => norm(f).split('/res/')[1] || f).slice(0, 40) } : null,
+    parseErrors: perFile.filter(p => p.error).length || undefined,
+  },
+  perFile,
+};
+if (JSON_OUT) { mkdirSync(dirname(resolve(JSON_OUT)), { recursive: true }); writeFileSync(JSON_OUT, JSON.stringify(report, null, 2)); }
+console.log(`[transpile-layout] ${stats.files} 个布局 → ${OUT}`);
+console.log(`  节点转译率 ${report.totals.nodeCoverage} · 属性转译率 ${report.totals.attrCoverage}`);
+if (variantLayouts.length) console.log(`  ⚠ 变体布局 ${variantLayouts.length} 个未转译（layout-land/-v21/…）——已入报告，不算进转译率`);
+for (const p of perFile.filter(x => x.error)) console.log(`  ⚠ ${p.file}: ${p.error}`);
+const un = Object.entries(stats.unmapped).sort((x, y) => y[1] - x[1]);
+if (un.length) console.log(`  未映射控件（回流 mapping.json 的候选）：${un.slice(0, 8).map(([t, n]) => `${t}×${n}`).join(', ')}`);

package/skills/migrate-core/scripts/vectors/run-arkts-vectors.mjs

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+// 纯 ArkTS 黄金向量门：跑 HarmonyOS Local Test（主机侧、不上设备）→ 解析 test_result.txt 裁决。
+// 替代旧的 node run-vectors.mjs（逻辑改 .ets 后 node 跑不了，改由 ArkTS Local Test 执行真实模块）。
+//
+// 用法: node run-arkts-vectors.mjs --project <DST> [--module entry] [--scope Suite[,Suite2]]
+// 退出码: 0=全绿 · 1=有用例失败 · 2=环境/结果缺失（无法裁决）
+//
+// 关键事实（spike 实测）：hvigorw test 用例失败仍 BUILD SUCCESSFUL、退出码 0，
+// 故必须解析 <module>/.test/default/intermediates/test/coverage_data/test_result.txt 的
+// "Tests run: N, Failure: F, Error: E, Pass: P" 汇总行 + 逐条 result=Failure。
+
+import { spawnSync } from 'node:child_process';
+import { resolveHvigorw, spawnOpts, quoteIfSpace } from '../lib/scan.mjs';
+import { existsSync, readFileSync, writeFileSync, accessSync, constants, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+
+function arg(name, def) {
+  const i = process.argv.indexOf('--' + name);
+  return i >= 0 && i + 1 < process.argv.length ? process.argv[i + 1] : def;
+}
+function fail(code, msg) { console.error('[arkts-vectors] ' + msg); process.exit(code); }
+
+const project = arg('project');
+const moduleName = arg('module', 'entry');
+const scope = arg('scope');
+if (!project) fail(2, '缺 --project <鸿蒙工程根>');
+const root = resolve(project);
+if (!existsSync(root)) fail(2, '工程不存在: ' + root);
+
+// 定位 hvigorw：工程本地 → PATH → DevEco 安装根（Windows 默认不进 PATH）；.bat 经 shell 起
+const hvigorw = resolveHvigorw(root);
+
+// --no-daemon 必须保留：selfTest 由各切片实现 agent **并行**调用，同工程并发 daemon 会互踩。
+// 已知限制：并发 selfTest 共用同一份 test_result.txt，极端时序下可能读到别的 scope 的结果——
+// 新鲜度闸（防假绿②）挡得住"陈旧"但挡不住"新鲜却是别人的"；实测未发生，记录不加机制。
+const cmd = ['test', '-p', 'module=' + moduleName, '-p', 'coverage=false', '--no-daemon'];
+if (scope) cmd.push('-p', 'scope=' + scope);
+
+const runStartedAtMs = Date.now();
+const run = spawnSync(quoteIfSpace(hvigorw), cmd, spawnOpts(hvigorw, { cwd: root, encoding: 'utf8', maxBuffer: 32 * 1024 * 1024 }));
+if (run.error && run.error.code === 'ENOENT') fail(2, 'hvigorw 未找到（工程无 hvigorw 且不在 PATH）：' + hvigorw);
+
+// 防假绿 ①：编译失败（COMPILE RESULT:FAIL / 退出码非 0 且无本轮汇总）不得读旧结果文件裁绿。
+// hvigorw test 的"用例失败仍退出 0"不适用编译失败——编译失败时没有本轮测试产物。
+const outText = (run.stdout || '') + '\n' + (run.stderr || '');
+if (/COMPILE RESULT:\s*FAIL/i.test(outText)) {
+  const tail = outText.split('\n').slice(-30).join('\n');
+  fail(2, 'Local Test 编译失败（COMPILE RESULT:FAIL），不得按旧 test_result.txt 裁决：\n' + tail);
+}
+if (run.status !== null && run.status !== 0 && !/Tests run:/.test(outText)) {
+  const tail = outText.split('\n').slice(-30).join('\n');
+  fail(2, `hvigorw test 退出码 ${run.status} 且无本轮测试汇总，疑似编译/环境失败：\n` + tail);
+}
+
+// 解析结果文件（用例失败时 hvigorw 退出码不可信，见文件头；但编译失败已在上方拦截）
+const resultFile = join(root, moduleName, '.test', 'default', 'intermediates', 'test', 'coverage_data', 'test_result.txt');
+if (!existsSync(resultFile)) {
+  const tail = (run.stdout || '').split('\n').slice(-15).join('\n');
+  fail(2, '无 test_result.txt（Local Test 可能没跑起来）：' + resultFile + '\n最后输出:\n' + tail);
+}
+// 防假绿 ②：结果文件必须比本轮运行新（陈旧文件=本轮根本没产出，按无法裁决失败）。
+try {
+  const st = statSync(resultFile);
+  if (st.mtimeMs < runStartedAtMs - 2000) {
+    fail(2, `test_result.txt 为陈旧文件（mtime ${new Date(st.mtimeMs).toISOString()} 早于本轮运行起点）`
+      + '——本轮 Local Test 未产出结果（编译失败或环境问题），拒绝假绿裁决');
+  }
+} catch (e) { fail(2, 'test_result.txt 状态读取失败: ' + resultFile); }
+const text = readFileSync(resultFile, 'utf8');
+const summary = /Tests run:\s*(\d+),\s*Failure:\s*(\d+),\s*Error:\s*(\d+),\s*Pass:\s*(\d+)/.exec(text);
+if (!summary) fail(2, 'test_result.txt 无汇总行，无法裁决');
+const runN = +summary[1], failN = +summary[2], errN = +summary[3], passN = +summary[4];
+
+const failing = [];
+const lines = text.split('\n');
+for (let i = 0; i < lines.length; i++) {
+  const m = /^test=(.+)$/.exec(lines[i].trim());
+  if (m) {
+    // 该 test 后若干行内出现 result=Failure 或 "Error in"
+    for (let j = i + 1; j < Math.min(i + 12, lines.length); j++) {
+      if (/^test=/.test(lines[j].trim())) break;
+      if (/result=Failure|^Error in/.test(lines[j].trim())) { failing.push(m[1]); break; }
+    }
+  }
+}
+
+console.log(`[arkts-vectors] ${moduleName}: run=${runN} pass=${passN} fail=${failN} error=${errN}`);
+if (runN === 0) fail(2, '0 个用例被执行（scope/脚手架有问题）');
+// 防假绿 ③：向量集缩水检测（部分测试文件编译断裂被静默跳过 → run 数骤降却仍"全绿"，实证 46→9）。
+// 基线自记账：每次全绿把本 scope 的 run 数写入 <工程>/.vector-counts.json（只升不降）；
+// 低于基线即失败。有意裁剪向量时删除该文件对应键重置基线（错误信息里已写明）。
+const countsFile = join(root, '.vector-counts.json');
+const countsKey = `${moduleName}:${scope || '*'}`;
+let counts = {};
+try { counts = JSON.parse(readFileSync(countsFile, 'utf8')) || {}; } catch { /* 首跑无基线 */ }
+const baseline = Number(counts[countsKey]) || 0;
+if (baseline && runN < baseline) {
+  fail(1, `向量集缩水：本轮仅执行 ${runN} 例，低于基线 ${baseline}（${countsKey}）——疑似部分测试文件编译断裂被静默跳过；`
+    + `如确属有意裁剪向量，删除 ${countsFile} 中 "${countsKey}" 键重置基线后重跑`);
+}
+if (failN > 0 || errN > 0) {
+  console.error('[arkts-vectors] 失败用例: ' + (failing.slice(0, 40).join(', ') || '(见 ' + resultFile + ')'));
+  process.exit(1);
+}
+try { counts[countsKey] = Math.max(runN, baseline); writeFileSync(countsFile, JSON.stringify(counts, null, 2) + '\n'); } catch { /* 记账失败不阻断裁决 */ }
+console.log('[arkts-vectors] 全绿 ✓');
+process.exit(0);

package/skills/migrate-core/scripts/vectors/setup-arkts-test.mjs

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+// 装 ArkTS Local Test 脚手架：entry/src/test/ + @ohos/hypium 依赖（含离线兜底）。
+// 迁移 stage-2 建空工程后调用；算法域向量门（run-arkts-vectors.mjs）依赖它。
+//
+// 用法: node setup-arkts-test.mjs --project <DST> [--module entry]
+// 退出码: 0=就绪 · 2=无法就绪（hypium 既装不上也找不到缓存）
+
+import { spawnSync } from 'node:child_process';
+import { resolveOhpm, spawnOpts, quoteIfSpace } from '../lib/scan.mjs';
+import { existsSync, mkdirSync, readFileSync, writeFileSync, cpSync, symlinkSync, readdirSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+
+const arg = (n, d) => { const i = process.argv.indexOf('--' + n); return i >= 0 ? process.argv[i + 1] : d; };
+const project = arg('project'); const moduleName = arg('module', 'entry');
+if (!project) { console.error('[setup-arkts-test] 缺 --project'); process.exit(2); }
+const root = resolve(project);
+const mod = join(root, moduleName);
+
+// 1) test 目录 + List.test.ets 骨架（不覆盖已有）
+const testDir = join(mod, 'src', 'test');
+mkdirSync(testDir, { recursive: true });
+const listFile = join(testDir, 'List.test.ets');
+if (!existsSync(listFile)) {
+  writeFileSync(listFile, '// 各算法域 harness 在此注册（提取步追加 import + 调用）\nexport default function testsuite() {\n}\n');
+  console.log('[setup-arkts-test] 建 ' + listFile);
+}
+
+// 2) entry/oh-package.json5 加 hypium devDependency
+const pkgFile = join(mod, 'oh-package.json5');
+if (existsSync(pkgFile)) {
+  let t = readFileSync(pkgFile, 'utf8');
+  if (!/@ohos\/hypium/.test(t)) {
+    if (/"devDependencies"\s*:\s*\{/.test(t)) t = t.replace(/("devDependencies"\s*:\s*\{)/, '$1\n    "@ohos/hypium": "1.0.25",');
+    else if (/^\s*\{\s*\}\s*$/.test(t)) t = '{\n  "devDependencies": { "@ohos/hypium": "1.0.25" }\n}\n';
+    // 前一属性若无尾逗号必须补上——直接顶格追加会产出非法 JSON5（构建红，实证）
+    else t = t.replace(/(\S)\s*\}\s*$/, (_m, ch) => `${ch === ',' || ch === '{' ? ch : ch + ','}\n  "devDependencies": { "@ohos/hypium": "1.0.25" }\n}\n`);
+    writeFileSync(pkgFile, t);
+    console.log('[setup-arkts-test] oh-package.json5 加 @ohos/hypium');
+  }
+}
+
+// 3) 装依赖：先 ohpm install，失败则离线链入
+function hypiumReady() {
+  return existsSync(join(mod, 'oh_modules', '@ohos', 'hypium')) || existsSync(join(root, 'oh_modules', '@ohos', 'hypium'));
+}
+if (!hypiumReady()) {
+  const ohpm = resolveOhpm();
+  const r = spawnSync(quoteIfSpace(ohpm), ['install'], spawnOpts(ohpm, { cwd: root, encoding: 'utf8' }));
+  if (!hypiumReady()) {
+    console.log('[setup-arkts-test] ohpm install 未就绪（' + ((r.stderr || '').includes('ECONNRESET') ? '网络不可达' : '未知') + '），转离线链入');
+    // 扫已知缓存位置找 @ohos+hypium@* / @ohos+hamock@*
+    const roots = [join(homedir(), 'Downloads'), join(homedir(), 'Repos'), homedir()];
+    const found = {};
+    for (const base of roots) {
+      let entries = [];
+      try { entries = readdirSync(base); } catch { continue; }
+      for (const e of entries) {
+        const store = join(base, e, 'oh_modules', '.ohpm');
+        if (!existsSync(store)) continue;
+        for (const pkg of (() => { try { return readdirSync(store); } catch { return []; } })()) {
+          if (/^@ohos\+hypium@/.test(pkg) && !found.hypium) found.hypium = join(store, pkg);
+          if (/^@ohos\+hamock@/.test(pkg) && !found.hamock) found.hamock = join(store, pkg);
+        }
+        if (found.hypium && found.hamock) break;
+      }
+      if (found.hypium && found.hamock) break;
+    }
+    if (!found.hypium) { console.error('[setup-arkts-test] 离线也找不到 @ohos+hypium 缓存——请在联网机器 ohpm install 一次或手动放置'); process.exit(2); }
+    const dstStore = join(root, 'oh_modules', '.ohpm');
+    const dstAt = join(root, 'oh_modules', '@ohos');
+    mkdirSync(dstStore, { recursive: true }); mkdirSync(dstAt, { recursive: true });
+    // 根级 + 模块级都要链：hvigorw test 编译 entry 测试时按模块 oh_modules 解析，
+    // 只链根级会"装了却解析不到"（实证：需手工补 cp 才编译过）
+    const dstAtMod = join(mod, 'oh_modules', '@ohos');
+    mkdirSync(dstAtMod, { recursive: true });
+    for (const k of ['hypium', 'hamock']) {
+      if (!found[k]) continue;
+      const name = found[k].split('/').pop();
+      cpSync(found[k], join(dstStore, name), { recursive: true });
+      const target = join(dstStore, name, 'oh_modules', '@ohos', k);
+      try { symlinkSync(target, join(dstAt, k)); } catch { /* 已存在 */ }
+      try { symlinkSync(target, join(dstAtMod, k)); } catch { /* 已存在 */ }
+      console.log('[setup-arkts-test] 离线链入 @ohos/' + k + '（根级+模块级）← ' + name);
+    }
+  }
+}
+
+if (hypiumReady()) { console.log('[setup-arkts-test] 就绪 ✓'); process.exit(0); }
+console.error('[setup-arkts-test] hypium 仍不可用'); process.exit(2);