android2harmony 0.1.4 → 0.1.6

package/skills/hmos-incremental-ui-align/scripts/extract_checklist.js

@@ -0,0 +1,285 @@
+#!/usr/bin/env node
+import * as fs from "node:fs";
+import * as path from "node:path";
+const NO_DIFF_VALUES = /* @__PURE__ */ new Set([
+  "",
+  "-",
+  "—",
+  "–",
+  "一致",
+  "相同",
+  "无",
+  "无差异",
+  "n/a",
+  "na",
+  "none",
+  "same",
+  "identical",
+  "ok",
+  "✓",
+  "√",
+  "对齐",
+  "已对齐",
+  "no diff",
+  "无变化"
+]);
+const SPLIT_PATTERN = /<br\s*\/?>|；|;|\n/;
+const PIPE_PLACEHOLDER = "\0PIPE\0";
+function splitRow(line) {
+  let s = line.trim().replace(/\\\|/g, PIPE_PLACEHOLDER);
+  if (s.startsWith("|")) s = s.slice(1);
+  if (s.endsWith("|")) s = s.slice(0, -1);
+  return s.split("|").map((c) => c.trim().split(PIPE_PLACEHOLDER).join("|"));
+}
+function isSeparator(cells) {
+  if (cells.length === 0) return false;
+  const nonEmpty = cells.filter((c) => c.trim() !== "");
+  if (nonEmpty.length === 0) return false;
+  return cells.every((c) => c.trim() === "" || /^:?-{2,}:?$/.test(c.trim()));
+}
+function cellHasDiff(val) {
+  if (val === void 0 || val === null) return false;
+  const v = val.trim().replace(/^[`*]+|[`*]+$/g, "").trim().toLowerCase();
+  return !NO_DIFF_VALUES.has(v) && v !== "";
+}
+function findDiffCol(headerCells) {
+  const candidates = ["diff", "差异", "目标", "target"];
+  for (let i = 0; i < headerCells.length; i++) {
+    if (headerCells[i].toLowerCase().includes("diff")) return i;
+  }
+  for (let i = 0; i < headerCells.length; i++) {
+    const h = headerCells[i].toLowerCase();
+    if (candidates.some((c) => h.includes(c))) return i;
+  }
+  return -1;
+}
+function labelCol(headerCells) {
+  const keys = [
+    "component",
+    "组件",
+    "ui component",
+    "state",
+    "transition",
+    "effect",
+    "dimension",
+    "property",
+    "属性",
+    "维度",
+    "状态"
+  ];
+  for (let i = 0; i < headerCells.length; i++) {
+    const h = headerCells[i].toLowerCase();
+    if (keys.some((k) => h.includes(k))) return i;
+  }
+  return 0;
+}
+function parseTables(text) {
+  const tables = [];
+  const lines = text.split(/\r?\n/);
+  let currentSection = "";
+  let i = 0;
+  const n = lines.length;
+  while (i < n) {
+    const line = lines[i];
+    const h = line.trim().match(/^#{1,6}\s+(.+)$/);
+    if (h) {
+      currentSection = h[1].trim();
+      i += 1;
+      continue;
+    }
+    if (line.includes("|") && i + 1 < n && lines[i + 1].includes("|")) {
+      const header = splitRow(line);
+      const sep = splitRow(lines[i + 1]);
+      if (isSeparator(sep) && header.length >= 2) {
+        const rows = [];
+        let j = i + 2;
+        while (j < n && lines[j].includes("|") && lines[j].trim()) {
+          const cells = splitRow(lines[j]);
+          if (isSeparator(cells)) {
+            j += 1;
+            continue;
+          }
+          rows.push(cells);
+          j += 1;
+        }
+        tables.push({ header, rows, section: currentSection });
+        i = j;
+        continue;
+      }
+    }
+    i += 1;
+  }
+  return tables;
+}
+function classifyPrefix(section) {
+  const s = section.toLowerCase();
+  if (s.includes("per-transition") || s.includes("transition")) return "[TRANSITION] ";
+  if (s.includes("per-state") || s.includes("state") && s.includes("visual")) return "[STATE] ";
+  if (s.includes("state machine") || section.includes("状态")) return "[STATE] ";
+  if (s.includes("dynamic") || s.includes("transient") || section.includes("动态")) return "[DYNAMIC] ";
+  return "";
+}
+function extractItemsFromTable(table) {
+  const { header, rows, section } = table;
+  const diffIdx = findDiffCol(header);
+  if (diffIdx === -1) return [];
+  const lblIdx = labelCol(header);
+  const prefix = classifyPrefix(section);
+  const items = [];
+  for (const cells of rows) {
+    if (diffIdx >= cells.length) continue;
+    const diffVal = cells[diffIdx];
+    if (!cellHasDiff(diffVal)) continue;
+    let label = lblIdx < cells.length ? cells[lblIdx].trim() : "";
+    label = label.replace(/^[`*]+|[`*]+$/g, "").trim();
+    let parts = diffVal.split(SPLIT_PATTERN).map((p) => p.trim()).filter((p) => p);
+    if (parts.length === 0) parts = [diffVal.trim()];
+    for (const part of parts) {
+      if (!cellHasDiff(part)) continue;
+      items.push(label ? `${prefix}${label}: ${part}` : `${prefix}${part}`);
+    }
+  }
+  return items;
+}
+function processComparison(filePath) {
+  const text = fs.readFileSync(filePath, "utf-8");
+  const tables = parseTables(text);
+  const items = [];
+  let diffRows = 0;
+  for (const t of tables) {
+    const diffIdx = findDiffCol(t.header);
+    if (diffIdx === -1) continue;
+    for (const cells of t.rows) {
+      if (diffIdx < cells.length && cellHasDiff(cells[diffIdx])) diffRows += 1;
+    }
+    items.push(...extractItemsFromTable(t));
+  }
+  const page = path.basename(path.dirname(filePath));
+  return { page, items, tableCount: tables.length, diffRowCount: diffRows };
+}
+function findComparisonFiles(taskDir) {
+  const results = [];
+  const walk = (dir) => {
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        walk(full);
+      } else if (entry.isFile() && entry.name === "UI_comparison.md") {
+        results.push(full);
+      }
+    }
+  };
+  walk(taskDir);
+  return results.sort();
+}
+function buildChecklist(taskDir) {
+  const compFiles = findComparisonFiles(taskDir);
+  const out = [
+    "# Fix Checklist",
+    "",
+    "> 本文件由 scripts/extract_checklist.ts 自动生成草稿。",
+    "> 每条对应一个 UI_comparison.md 中 Diff 非空的差异行（已逐行拆分）。",
+    "> 主 agent 需：去重、补全人类可读描述、回溯 Android 源码值，再开始修复。",
+    ""
+  ];
+  const stats = [];
+  if (compFiles.length === 0) {
+    out.push("_(未找到任何 UI_comparison.md —— 请先完成 Step 2)_");
+    return { text: out.join("\n"), stats };
+  }
+  for (const cf of compFiles) {
+    const info = processComparison(cf);
+    stats.push(info);
+    out.push(`## ${info.page}`);
+    out.push(
+      `<!-- source: ${cf.split(path.sep).join("/")} | tables=${info.tableCount} | diff_rows=${info.diffRowCount} | items=${info.items.length} -->`
+    );
+    if (info.items.length === 0) {
+      out.push("- _(无差异，或该页未生成有效 Diff 表 —— 请人工确认)_");
+    } else {
+      for (const it of info.items) out.push(`- [ ] ${it}`);
+    }
+    out.push("");
+  }
+  return { text: out.join("\n"), stats };
+}
+function parseArgs(argv) {
+  const args = { taskDir: "", output: null };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    const next = () => {
+      if (i + 1 >= argv.length) {
+        console.error(`Missing value for ${a}`);
+        process.exit(2);
+      }
+      return argv[++i];
+    };
+    if (a === "--task-dir") {
+      args.taskDir = next();
+    } else if (a === "--output" || a === "-o") {
+      args.output = next();
+    } else if (a === "-h" || a === "--help") {
+      printHelp();
+      process.exit(0);
+    } else {
+      console.error(`Unknown argument: ${a}`);
+      process.exit(2);
+    }
+  }
+  if (!args.taskDir) {
+    console.error("error: --task-dir is required");
+    process.exit(2);
+  }
+  return args;
+}
+function printHelp() {
+  console.log(
+    [
+      "确定性提取所有 UI_comparison.md 中的差异，生成 fix_checklist.md 草稿",
+      "",
+      "Usage: node extract_checklist.ts --task-dir <dir> [-o <output>]",
+      "",
+      "  --task-dir      task 目录（含 hmos_page_*/UI_comparison.md）（必填）",
+      "  --output,-o     输出路径（默认 {task_dir}/fix_checklist.md）"
+    ].join("\n")
+  );
+}
+function main() {
+  const args = parseArgs(process.argv.slice(2));
+  if (!fs.existsSync(args.taskDir) || !fs.statSync(args.taskDir).isDirectory()) {
+    console.log(`[ERR] task-dir 不存在: ${args.taskDir}`);
+    return 1;
+  }
+  const outPath = args.output ?? path.join(args.taskDir, "fix_checklist.md");
+  const { text, stats } = buildChecklist(args.taskDir);
+  fs.writeFileSync(outPath, text, "utf-8");
+  const totalRows = stats.reduce((sum, s) => sum + s.diffRowCount, 0);
+  const totalItems = stats.reduce((sum, s) => sum + s.items.length, 0);
+  console.log(`Wrote ${outPath}`);
+  console.log(
+    `Comparison files: ${stats.length} | total diff rows: ${totalRows} | total checklist items: ${totalItems}`
+  );
+  console.log("-".repeat(60));
+  console.log(`${"PAGE".padEnd(48)}${"rows".padStart(5)}${"items".padStart(6)}`);
+  for (const s of stats) {
+    const flag = s.items.length >= s.diffRowCount ? "" : "  <-- CHECK";
+    console.log(
+      `${s.page.slice(0, 46).padEnd(48)}${String(s.diffRowCount).padStart(5)}${String(
+        s.items.length
+      ).padStart(6)}${flag}`
+    );
+  }
+  if (totalRows === 0) {
+    console.log(
+      "\n[WARN] 0 个 diff 行被识别。可能 comparison 表头无 Diff 列，或文件只有状态说明没有表格 —— 请回到 Step 2 检查。"
+    );
+  }
+  return 0;
+}
+process.exit(main());

package/skills/hmos-incremental-ui-align/scripts/navigation-capure.md

@@ -1,76 +1,76 @@
-Create a timestamped output directory under `capture_output_dir`:
-```
-task_dir = capture_output_dir / "task_{timestamp}"
-android_capture_dir = task_dir / "android_page_{i}_{name}"
-hmos_capture_dir = task_dir / "hmos_page_{i}_{name}"
-```
-Each paired hmos-android page-pair should have the same `i`
-
-## Navigation prompt rules
-
-Each page's `android_nav_path` / `hmos_nav_path` is used as the `--prompt` for `app_feature_verify.ts`.
-The `--prompt` mode auto-prepends "打开{app_name}，" so do not include "打开{app_name}" in the prompt.
-
-## Navigate to Android page and Capture (If navigated Success)
-```bash
-node ./app_feature_verify.ts \
-  --device adb \
-  --app "{android.app_name}" \
-  --package "{android.package}" \
-  --prompt "{pages[i].android_nav_path}" \
-  --max-steps 15
-```
-
-**Capture Android page** (if navigation succeeded — TypeScript version, run with Node ≥ 22.18 / 23.6, no build step / no dependencies)
-```bash
-node ./page_capture.ts --device adb -o "{android_capture_dir}"
-```
-
-## Navigate & Capture HarmonyOS Pages
-
-Same as Andorid but with `--device hdc` and HarmonyOS config values. Directory pattern:
-```
-hmos_capture_dir = task_dir / "hmos_page_{i}_{name}"
-```
-For pages missed in harmony OS app, navigation will certainly fail — `hmos_capture_dir` will be empty, which is expected. Skip navigation for these pages and leave the directory empty.
-
-## Burst Capture for Multi-State Components (Step 1.5)
-
-Use `page_capture_burst.ts` to continuously capture view tree + screenshot pairs at 1-second intervals. This is designed for dynamic/stateful UI where a single snapshot is insufficient.
-
-### Usage
-```bash
-node ./scripts/page_capture_burst.ts --device adb -o "{output_dir}" --duration {seconds}
-```
-- `--device`: `adb` for Android (currently the only supported device)
-- `-o`: output directory (each frame produces `view_NNN.xml` + `screenshot_NNN.png`)
-- `--duration`: capture duration in seconds (default 10, recommended 5 for most states)
-- `--serial`: device serial if multiple devices connected
-
-### Workflow: Auto-Capturable States
-For states that can be triggered by simple gestures (tap, short long-press then release):
-1. Navigate to the base page using `app_feature_verify.ts`
-2. Start burst capture in background: `page_capture_burst.ts --duration 5`
-3. Immediately trigger the state change via `app_feature_verify.ts` with the action prompt
-4. From burst output, select the frame that best represents each state
-
-### Workflow: Manual-Capture States
-For states requiring continuous gestures (long-press hold, drag) or physical input (voice, sensor):
-1. Navigate to the base page using `app_feature_verify.ts`
-2. Print instructions for the user to manually perform the gesture
-3. User runs burst capture in terminal while performing the gesture on device
-4. User confirms capture is complete
-
-### Output Directory Naming for State Captures
-```
-{platform}_page_{i}_{base_name}_state_{state_id}_{state_name}/
-  screenshot_001.png
-  view_001.xml
-  state_context.md   (extracted from state_model.md)
-```
-
-### Selecting Representative Frames
-After burst capture, compare consecutive frames by diffing their view tree XML:
-- If `view_NNN.xml` differs significantly from `view_NNN-1.xml` (new nodes, visibility changes, text changes), it likely represents a state transition
-- Select the first stable frame after a transition as the representative for that state
-
+Create a timestamped output directory under `capture_output_dir`:
+```
+task_dir = capture_output_dir / "task_{timestamp}"
+android_capture_dir = task_dir / "android_page_{i}_{name}"
+hmos_capture_dir = task_dir / "hmos_page_{i}_{name}"
+```
+Each paired hmos-android page-pair should have the same `i`
+
+## Navigation prompt rules
+
+Each page's `android_nav_path` / `hmos_nav_path` is used as the `--prompt` for `app_feature_verify.js`.
+The `--prompt` mode auto-prepends "打开{app_name}，" so do not include "打开{app_name}" in the prompt.
+
+## Navigate to Android page and Capture (If navigated Success)
+```bash
+node ./app_feature_verify.js \
+  --device adb \
+  --app "{android.app_name}" \
+  --package "{android.package}" \
+  --prompt "{pages[i].android_nav_path}" \
+  --max-steps 15
+```
+
+**Capture Android page** (if navigation succeeded — TypeScript version, run with Node ≥ 22.18 / 23.6, no build step / no dependencies)
+```bash
+node ./page_capture.js --device adb -o "{android_capture_dir}"
+```
+
+## Navigate & Capture HarmonyOS Pages
+
+Same as Andorid but with `--device hdc` and HarmonyOS config values. Directory pattern:
+```
+hmos_capture_dir = task_dir / "hmos_page_{i}_{name}"
+```
+For pages missed in harmony OS app, navigation will certainly fail — `hmos_capture_dir` will be empty, which is expected. Skip navigation for these pages and leave the directory empty.
+
+## Burst Capture for Multi-State Components (Step 1.5)
+
+Use `page_capture_burst.js` to continuously capture view tree + screenshot pairs at 1-second intervals. This is designed for dynamic/stateful UI where a single snapshot is insufficient.
+
+### Usage
+```bash
+node ./scripts/page_capture_burst.js --device adb -o "{output_dir}" --duration {seconds}
+```
+- `--device`: `adb` for Android (currently the only supported device)
+- `-o`: output directory (each frame produces `view_NNN.xml` + `screenshot_NNN.png`)
+- `--duration`: capture duration in seconds (default 10, recommended 5 for most states)
+- `--serial`: device serial if multiple devices connected
+
+### Workflow: Auto-Capturable States
+For states that can be triggered by simple gestures (tap, short long-press then release):
+1. Navigate to the base page using `app_feature_verify.js`
+2. Start burst capture in background: `page_capture_burst.js --duration 5`
+3. Immediately trigger the state change via `app_feature_verify.js` with the action prompt
+4. From burst output, select the frame that best represents each state
+
+### Workflow: Manual-Capture States
+For states requiring continuous gestures (long-press hold, drag) or physical input (voice, sensor):
+1. Navigate to the base page using `app_feature_verify.js`
+2. Print instructions for the user to manually perform the gesture
+3. User runs burst capture in terminal while performing the gesture on device
+4. User confirms capture is complete
+
+### Output Directory Naming for State Captures
+```
+{platform}_page_{i}_{base_name}_state_{state_id}_{state_name}/
+  screenshot_001.png
+  view_001.xml
+  state_context.md   (extracted from state_model.md)
+```
+
+### Selecting Representative Frames
+After burst capture, compare consecutive frames by diffing their view tree XML:
+- If `view_NNN.xml` differs significantly from `view_NNN-1.xml` (new nodes, visibility changes, text changes), it likely represents a state transition
+- Select the first stable frame after a transition as the representative for that state
+