@harmonyos-arkts/d2h 0.1.11 → 0.1.12

package/skills/arkts-icon-sizing/scripts/icon_audit.py

@@ -1,131 +1,131 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""第 1/3 步 —— 审计 ArkUI (.ets) 中欠约束尺寸的 Image() 组件。
-
-成因
-  Android UI 迁移到 HarmonyOS/ArkUI 时，转换器常保留 `.objectFit(...)` 却
-  丢掉用了 `android:layout_width/height="wrap_content"` 的 ImageView 的
-  `.width()/.height()`。位图被拷进 `resources/base/media`（无密度限定符），
-  于是 HarmonyOS 按其原始像素尺寸当作 vp 渲染 —— 图标被放大（按源密度倍数，
-  如 xxhdpi = 3 倍），非方形图标还会比例失真。
-
-会标记什么（一个 Image 的修饰链满足）
-  - 既无 width 又无 height 且无 size()        -> kind = NO-DIMS
-  - 恰好只有 width/height 之一，且无 aspectRatio -> kind = ONE-DIM-NO-ASPECT
-  （width('100%') + height('100%') = 满铺，视为有意为之。）
-  同时列出 ImageFit.Fill 用法（可能拉伸）供人工复核。
-
-输出
-  打印摘要并写出 JSON 报告（默认 icon_report.json），供 icon_dims.py /
-  icon_fix.py / icon_autofix.py 消费。
-
-用法
-  python icon_audit.py                         # 自动发现 */src/main/ets 根
-  python icon_audit.py --roots entry/src/main/ets/pages entry/.../components
-  python icon_audit.py --json icon_report.json
-"""
-import os, re, json, argparse
-
-
-def discover_roots():
-    """找出每一个 */src/main/ets 目录（entry + 任意 HSP/HAR 模块）。"""
-    roots, skip = [], {'node_modules', 'oh_modules', 'build', '.git', '.hvigor', '.idea'}
-    for base, dirs, _ in os.walk('.'):
-        dirs[:] = [d for d in dirs if d not in skip]
-        if base.replace('\\', '/').endswith('src/main/ets'):
-            roots.append(base)
-    return sorted(set(roots))
-
-
-def chain_window(lines, i):
-    """第 i 行 Image 的修饰链 = 紧随其后、缩进更深的那些行。"""
-    base = len(lines[i]) - len(lines[i].lstrip())
-    out, j = [], i + 1
-    while j < len(lines):
-        ln = lines[j]
-        if ln.strip() == '':
-            j += 1
-            continue
-        if (len(ln) - len(ln.lstrip())) <= base:
-            break
-        out.append(ln)
-        j += 1
-    return '\n'.join(out)
-
-
-def audit(roots):
-    flagged, fill_used, full_bleed, scanned = [], [], 0, 0
-    for root in roots:
-        for dp, _, files in os.walk(root):
-            for fn in files:
-                if not fn.endswith('.ets'):
-                    continue
-                path = os.path.join(dp, fn).replace('\\', '/')
-                lines = open(path, encoding='utf-8').read().split('\n')
-                for i, ln in enumerate(lines):
-                    st = ln.lstrip()
-                    # 跳过注释行，避免被注释掉的 Image()/ImageView 引用误命中
-                    if st.startswith('*') or st.startswith('//') or st.startswith('/*'):
-                        continue
-                    code = ln.split('//')[0]
-                    if not re.search(r'\bImage\(', code):
-                        continue
-                    scanned += 1
-                    win = chain_window(lines, i)
-                    has_w, has_h = '.width(' in win, '.height(' in win
-                    has_size = '.size(' in win
-                    has_aspect = '.aspectRatio(' in win
-                    has_weight = '.layoutWeight(' in win
-                    w100, h100 = ".width('100%')" in win, ".height('100%')" in win
-                    fitm = re.search(r'ImageFit\.(\w+)', win)
-                    fit = fitm.group(1) if fitm else None
-                    iconm = re.search(r"(?:app|sys)\.media\.([A-Za-z0-9_]+)", code)
-                    icon = iconm.group(1) if iconm else None
-                    if 'ImageFit.Fill' in win:
-                        fill_used.append({'file': path, 'line': i + 1, 'icon': icon})
-                    if w100 and h100:
-                        full_bleed += 1
-                        continue
-                    ok = has_size or (has_w and has_h) or \
-                        ((has_w ^ has_h) and (has_aspect or has_weight))
-                    if ok:
-                        continue
-                    flagged.append({
-                        'file': path, 'line': i + 1, 'icon': icon,
-                        'dynamic': icon is None,
-                        'kind': 'NO-DIMS' if not (has_w or has_h) else 'ONE-DIM-NO-ASPECT',
-                        'fit': fit, 'expr': code.strip()[:60],
-                    })
-    return {'scanned': scanned, 'flagged': flagged,
-            'fill': fill_used, 'full_bleed_count': full_bleed}
-
-
-def main():
-    ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
-    ap.add_argument('--roots', nargs='*', help='要扫描的 ets 目录（默认：自动发现 */src/main/ets）')
-    ap.add_argument('--json', default='icon_report.json', help='报告输出路径')
-    a = ap.parse_args()
-    roots = a.roots or discover_roots()
-    if not roots:
-        print('未找到 ets 根。请从 HarmonyOS 工程根运行，或用 --roots 指定。')
-        return
-    print('扫描根目录：')
-    for r in roots:
-        print('  ' + r)
-    rep = audit(roots)
-    print(f'\n== 扫描 {rep["scanned"]} 个 Image() | 标记 {len(rep["flagged"])} '
-          f'| Fill {len(rep["fill"])} | 满铺 {rep["full_bleed_count"]} ==\n')
-    stat = [f for f in rep['flagged'] if not f['dynamic']]
-    dyn = [f for f in rep['flagged'] if f['dynamic']]
-    print(f'-- 欠约束的静态图标（{len(stat)}）--')
-    for f in sorted(stat, key=lambda x: (x['file'], x['line'])):
-        print(f"  [{f['kind']:18}] fit={f['fit'] or '-':8} {os.path.basename(f['file'])}:{f['line']}  {f['icon']}")
-    print(f'\n-- 动态源图片（{len(dyn)}）-> 手工解析资源（见 SKILL.md）--')
-    for f in sorted(dyn, key=lambda x: (x['file'], x['line'])):
-        print(f"  {os.path.basename(f['file'])}:{f['line']}  {f['expr']}")
-    json.dump(rep, open(a.json, 'w', encoding='utf-8'), ensure_ascii=False, indent=2)
-    print(f'\n已写出 {a.json}  ->  下一步：python icon_dims.py --report {a.json}')
-
-
-if __name__ == '__main__':
-    main()
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""第 1/3 步 —— 审计 ArkUI (.ets) 中欠约束尺寸的 Image() 组件。
+
+成因
+  Android UI 迁移到 HarmonyOS/ArkUI 时，转换器常保留 `.objectFit(...)` 却
+  丢掉用了 `android:layout_width/height="wrap_content"` 的 ImageView 的
+  `.width()/.height()`。位图被拷进 `resources/base/media`（无密度限定符），
+  于是 HarmonyOS 按其原始像素尺寸当作 vp 渲染 —— 图标被放大（按源密度倍数，
+  如 xxhdpi = 3 倍），非方形图标还会比例失真。
+
+会标记什么（一个 Image 的修饰链满足）
+  - 既无 width 又无 height 且无 size()        -> kind = NO-DIMS
+  - 恰好只有 width/height 之一，且无 aspectRatio -> kind = ONE-DIM-NO-ASPECT
+  （width('100%') + height('100%') = 满铺，视为有意为之。）
+  同时列出 ImageFit.Fill 用法（可能拉伸）供人工复核。
+
+输出
+  打印摘要并写出 JSON 报告（默认 icon_report.json），供 icon_dims.py /
+  icon_fix.py / icon_autofix.py 消费。
+
+用法
+  python icon_audit.py                         # 自动发现 */src/main/ets 根
+  python icon_audit.py --roots entry/src/main/ets/pages entry/.../components
+  python icon_audit.py --json icon_report.json
+"""
+import os, re, json, argparse
+
+
+def discover_roots():
+    """找出每一个 */src/main/ets 目录（entry + 任意 HSP/HAR 模块）。"""
+    roots, skip = [], {'node_modules', 'oh_modules', 'build', '.git', '.hvigor', '.idea'}
+    for base, dirs, _ in os.walk('.'):
+        dirs[:] = [d for d in dirs if d not in skip]
+        if base.replace('\\', '/').endswith('src/main/ets'):
+            roots.append(base)
+    return sorted(set(roots))
+
+
+def chain_window(lines, i):
+    """第 i 行 Image 的修饰链 = 紧随其后、缩进更深的那些行。"""
+    base = len(lines[i]) - len(lines[i].lstrip())
+    out, j = [], i + 1
+    while j < len(lines):
+        ln = lines[j]
+        if ln.strip() == '':
+            j += 1
+            continue
+        if (len(ln) - len(ln.lstrip())) <= base:
+            break
+        out.append(ln)
+        j += 1
+    return '\n'.join(out)
+
+
+def audit(roots):
+    flagged, fill_used, full_bleed, scanned = [], [], 0, 0
+    for root in roots:
+        for dp, _, files in os.walk(root):
+            for fn in files:
+                if not fn.endswith('.ets'):
+                    continue
+                path = os.path.join(dp, fn).replace('\\', '/')
+                lines = open(path, encoding='utf-8').read().split('\n')
+                for i, ln in enumerate(lines):
+                    st = ln.lstrip()
+                    # 跳过注释行，避免被注释掉的 Image()/ImageView 引用误命中
+                    if st.startswith('*') or st.startswith('//') or st.startswith('/*'):
+                        continue
+                    code = ln.split('//')[0]
+                    if not re.search(r'\bImage\(', code):
+                        continue
+                    scanned += 1
+                    win = chain_window(lines, i)
+                    has_w, has_h = '.width(' in win, '.height(' in win
+                    has_size = '.size(' in win
+                    has_aspect = '.aspectRatio(' in win
+                    has_weight = '.layoutWeight(' in win
+                    w100, h100 = ".width('100%')" in win, ".height('100%')" in win
+                    fitm = re.search(r'ImageFit\.(\w+)', win)
+                    fit = fitm.group(1) if fitm else None
+                    iconm = re.search(r"(?:app|sys)\.media\.([A-Za-z0-9_]+)", code)
+                    icon = iconm.group(1) if iconm else None
+                    if 'ImageFit.Fill' in win:
+                        fill_used.append({'file': path, 'line': i + 1, 'icon': icon})
+                    if w100 and h100:
+                        full_bleed += 1
+                        continue
+                    ok = has_size or (has_w and has_h) or \
+                        ((has_w ^ has_h) and (has_aspect or has_weight))
+                    if ok:
+                        continue
+                    flagged.append({
+                        'file': path, 'line': i + 1, 'icon': icon,
+                        'dynamic': icon is None,
+                        'kind': 'NO-DIMS' if not (has_w or has_h) else 'ONE-DIM-NO-ASPECT',
+                        'fit': fit, 'expr': code.strip()[:60],
+                    })
+    return {'scanned': scanned, 'flagged': flagged,
+            'fill': fill_used, 'full_bleed_count': full_bleed}
+
+
+def main():
+    ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
+    ap.add_argument('--roots', nargs='*', help='要扫描的 ets 目录（默认：自动发现 */src/main/ets）')
+    ap.add_argument('--json', default='icon_report.json', help='报告输出路径')
+    a = ap.parse_args()
+    roots = a.roots or discover_roots()
+    if not roots:
+        print('未找到 ets 根。请从 HarmonyOS 工程根运行，或用 --roots 指定。')
+        return
+    print('扫描根目录：')
+    for r in roots:
+        print('  ' + r)
+    rep = audit(roots)
+    print(f'\n== 扫描 {rep["scanned"]} 个 Image() | 标记 {len(rep["flagged"])} '
+          f'| Fill {len(rep["fill"])} | 满铺 {rep["full_bleed_count"]} ==\n')
+    stat = [f for f in rep['flagged'] if not f['dynamic']]
+    dyn = [f for f in rep['flagged'] if f['dynamic']]
+    print(f'-- 欠约束的静态图标（{len(stat)}）--')
+    for f in sorted(stat, key=lambda x: (x['file'], x['line'])):
+        print(f"  [{f['kind']:18}] fit={f['fit'] or '-':8} {os.path.basename(f['file'])}:{f['line']}  {f['icon']}")
+    print(f'\n-- 动态源图片（{len(dyn)}）-> 手工解析资源（见 SKILL.md）--')
+    for f in sorted(dyn, key=lambda x: (x['file'], x['line'])):
+        print(f"  {os.path.basename(f['file'])}:{f['line']}  {f['expr']}")
+    json.dump(rep, open(a.json, 'w', encoding='utf-8'), ensure_ascii=False, indent=2)
+    print(f'\n已写出 {a.json}  ->  下一步：python icon_dims.py --report {a.json}')
+
+
+if __name__ == '__main__':
+    main()

package/skills/arkts-icon-sizing/scripts/icon_autofix.py

@@ -1,88 +1,88 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""全自动单入口 —— 一次跑完 审计→测量→修复→复审，输出单个机读 JSON，无任何人工 gate。
-
-由调用方或 CI 在输入边界明确时调用；也可直接使用 --apply。
-
-为什么无人工审核也安全：
-  尺寸 = 像素 ÷ 密度 是确定性计算；只动「无尺寸 / 单尺寸无 aspectRatio」的 Image，
-  绝不碰已带尺寸的；幂等（重复跑第二次 fixed_count=0）；调用者负责保护已有工作区改动。
-  动态源图片 / 无 raster 项只记录、不修改，由调用方判断其是否阻塞当前请求。
-
-用法
-  python icon_autofix.py --apply --output-json icon_autofix.json
-  python icon_autofix.py --apply --android-res <a>/app/src/main/res <a>/base/src/main/res \
-      --output-json icon_autofix.json
-  python icon_autofix.py --apply --density 3 --output-json icon_autofix.json   # 无 Android 源
-"""
-import os, json, argparse
-import sys
-from pathlib import Path
-
-# 允许从本脚本目录直接 import 同级模块
-sys.path.insert(0, str(Path(__file__).parent))
-from icon_audit import discover_roots, audit
-from icon_dims import find_media_dir, build_plan
-from icon_fix import apply_fixes
-
-
-def autofix(android_res, density, apply=True):
-    """审计→测量→修复→复审，返回结构化结果 dict。"""
-    roots = discover_roots()
-    if not roots:
-        return {'passed': True, 'skipped': True, 'reason': '未找到 */src/main/ets 根'}
-    report = audit(roots)
-    media = find_media_dir()
-    names = sorted({f['icon'] for f in report['flagged'] if f.get('icon')})
-    if media:
-        plan, no_raster = build_plan(names, media, android_res, density)
-    else:
-        plan, no_raster = {}, names
-    applied, dynamic = apply_fixes(plan, report, apply=apply)
-    # 复审：验证收敛。有 raster 却仍被标记的静态图标 = 异常
-    report2 = audit(roots)
-    residual = [f for f in report2['flagged']
-                if not f['dynamic'] and f.get('icon') in plan]
-    return {
-        'passed': True,                       # 自愈永不阻断；执行异常时由外层 main 置 False
-        'media': media,
-        'scanned': report['scanned'],
-        'flagged_before': len(report['flagged']),
-        'flagged_after': len(report2['flagged']),
-        'fixed_count': len(applied),
-        'fixed': applied,
-        'dynamic_unresolved': dynamic,        # Image(this.foo()) / 三元等，记录不修
-        'no_raster_unresolved': no_raster,    # 纯 svg shape / 矢量图，记录不修
-        'fill_for_review': report.get('fill', []),
-        'residual_static': [{'file': f['file'], 'line': f['line'], 'icon': f['icon']} for f in residual],
-        'density_source': ('android-res' if android_res else f'fallback {density}x'),
-    }
-
-
-def main():
-    ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
-    ap.add_argument('--project-root', default='.', help='HarmonyOS 工程根（脚本会 chdir 到此）')
-    ap.add_argument('--android-res', nargs='*', default=[], help='Android res 根，用于逐图密度（缺省回退 --density）')
-    ap.add_argument('--density', type=float, default=3.0, help='回退密度倍数（默认 3 = xxhdpi）')
-    ap.add_argument('--apply', action='store_true', help='落盘（默认 dry-run，仅计算）')
-    ap.add_argument('--output-json', required=True, help='结果 JSON 输出路径')
-    a = ap.parse_args()
-
-    out_path = Path(a.output_json).resolve()      # chdir 前先解析为绝对路径
-    android_res = [str(Path(r).resolve()) for r in a.android_res] or None
-    if a.project_root and a.project_root != '.':
-        os.chdir(a.project_root)
-
-    try:
-        out = autofix(android_res, a.density, apply=a.apply)
-    except Exception as e:
-        out = {'passed': False, 'error': str(e)}
-
-    out_path.parent.mkdir(parents=True, exist_ok=True)
-    out_path.write_text(json.dumps(out, ensure_ascii=False, indent=2), encoding='utf-8')
-    brief = {k: out.get(k) for k in ('passed', 'fixed_count', 'dynamic_unresolved', 'density_source', 'skipped', 'error')}
-    print(json.dumps({k: v for k, v in brief.items() if v is not None}, ensure_ascii=False))
-
-
-if __name__ == '__main__':
-    main()
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""全自动单入口 —— 一次跑完 审计→测量→修复→复审，输出单个机读 JSON，无任何人工 gate。
+
+由调用方或 CI 在输入边界明确时调用；也可直接使用 --apply。
+
+为什么无人工审核也安全：
+  尺寸 = 像素 ÷ 密度 是确定性计算；只动「无尺寸 / 单尺寸无 aspectRatio」的 Image，
+  绝不碰已带尺寸的；幂等（重复跑第二次 fixed_count=0）；调用者负责保护已有工作区改动。
+  动态源图片 / 无 raster 项只记录、不修改，由调用方判断其是否阻塞当前请求。
+
+用法
+  python icon_autofix.py --apply --output-json icon_autofix.json
+  python icon_autofix.py --apply --android-res <a>/app/src/main/res <a>/base/src/main/res \
+      --output-json icon_autofix.json
+  python icon_autofix.py --apply --density 3 --output-json icon_autofix.json   # 无 Android 源
+"""
+import os, json, argparse
+import sys
+from pathlib import Path
+
+# 允许从本脚本目录直接 import 同级模块
+sys.path.insert(0, str(Path(__file__).parent))
+from icon_audit import discover_roots, audit
+from icon_dims import find_media_dir, build_plan
+from icon_fix import apply_fixes
+
+
+def autofix(android_res, density, apply=True):
+    """审计→测量→修复→复审，返回结构化结果 dict。"""
+    roots = discover_roots()
+    if not roots:
+        return {'passed': True, 'skipped': True, 'reason': '未找到 */src/main/ets 根'}
+    report = audit(roots)
+    media = find_media_dir()
+    names = sorted({f['icon'] for f in report['flagged'] if f.get('icon')})
+    if media:
+        plan, no_raster = build_plan(names, media, android_res, density)
+    else:
+        plan, no_raster = {}, names
+    applied, dynamic = apply_fixes(plan, report, apply=apply)
+    # 复审：验证收敛。有 raster 却仍被标记的静态图标 = 异常
+    report2 = audit(roots)
+    residual = [f for f in report2['flagged']
+                if not f['dynamic'] and f.get('icon') in plan]
+    return {
+        'passed': True,                       # 自愈永不阻断；执行异常时由外层 main 置 False
+        'media': media,
+        'scanned': report['scanned'],
+        'flagged_before': len(report['flagged']),
+        'flagged_after': len(report2['flagged']),
+        'fixed_count': len(applied),
+        'fixed': applied,
+        'dynamic_unresolved': dynamic,        # Image(this.foo()) / 三元等，记录不修
+        'no_raster_unresolved': no_raster,    # 纯 svg shape / 矢量图，记录不修
+        'fill_for_review': report.get('fill', []),
+        'residual_static': [{'file': f['file'], 'line': f['line'], 'icon': f['icon']} for f in residual],
+        'density_source': ('android-res' if android_res else f'fallback {density}x'),
+    }
+
+
+def main():
+    ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
+    ap.add_argument('--project-root', default='.', help='HarmonyOS 工程根（脚本会 chdir 到此）')
+    ap.add_argument('--android-res', nargs='*', default=[], help='Android res 根，用于逐图密度（缺省回退 --density）')
+    ap.add_argument('--density', type=float, default=3.0, help='回退密度倍数（默认 3 = xxhdpi）')
+    ap.add_argument('--apply', action='store_true', help='落盘（默认 dry-run，仅计算）')
+    ap.add_argument('--output-json', required=True, help='结果 JSON 输出路径')
+    a = ap.parse_args()
+
+    out_path = Path(a.output_json).resolve()      # chdir 前先解析为绝对路径
+    android_res = [str(Path(r).resolve()) for r in a.android_res] or None
+    if a.project_root and a.project_root != '.':
+        os.chdir(a.project_root)
+
+    try:
+        out = autofix(android_res, a.density, apply=a.apply)
+    except Exception as e:
+        out = {'passed': False, 'error': str(e)}
+
+    out_path.parent.mkdir(parents=True, exist_ok=True)
+    out_path.write_text(json.dumps(out, ensure_ascii=False, indent=2), encoding='utf-8')
+    brief = {k: out.get(k) for k in ('passed', 'fixed_count', 'dynamic_unresolved', 'density_source', 'skipped', 'error')}
+    print(json.dumps({k: v for k, v in brief.items() if v is not None}, ensure_ascii=False))
+
+
+if __name__ == '__main__':
+    main()