@harmonyos-arkts/d2h 0.1.11 → 0.1.13

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

@@ -1,179 +1,179 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""第 2/3 步 —— 还原每个被标记图标的正确 vp 尺寸。
-
-公式
-  HarmonyOS 中 `resources/base/media`（无密度限定符）里的位图按其字面像素尺寸
-  当作 vp 渲染。源位图来自某个 Android 密度桶（如 drawable-xxhdpi /
-  mipmap-xxhdpi = 3 倍）。因此图标被设计显示的尺寸是：
-        标称 vp = 源像素 / 源密度倍数
-  我们从 HarmonyOS media 文件读像素尺寸，从 Android 源目录名取倍数。宽和高
-  分别独立相除，所以真实宽高比得以保留（这正是修复「失真 / 比例错」的关键）。
-
-倍数从何而来
-  1. 给了 --android-res 时，由图标的源目录（如 mipmap-xxhdpi）决定。Android
-     工程可能多模块 —— 把每个 res 根都传进来（如 app/src/main/res 与
-     base/src/main/res）。
-  2. 否则回退到 --density（默认 3.0 = xxhdpi，现代 app 最常见的单一桶）。输出
-     会标出 assumed 项，便于人工核对。
-
-输出
-  打印表格并写出 icon_plan.json {icon: {w,h,px,density,src}}。
-  找不到 raster 的图标（动态引用、纯 SVG shape、矢量图）列为 UNRESOLVED 供手工处理。
-
-用法
-  python icon_dims.py --report icon_report.json \
-      --media entry/src/main/resources/base/media \
-      --android-res /path/app/src/main/res /path/base/src/main/res
-  python icon_dims.py --report icon_report.json --density 3      # 无 Android 源
-  python icon_dims.py --media .../media --icons ic_a,ic_b        # 临时查询
-"""
-import os, re, json, struct, glob, argparse
-
-DENSITY = {'ldpi': 0.75, 'mdpi': 1.0, 'tvdpi': 1.33, 'hdpi': 1.5,
-           'xhdpi': 2.0, 'xxhdpi': 3.0, 'xxxhdpi': 4.0}
-
-
-def webp_size(p):
-    d = open(p, 'rb').read(40)
-    if d[:4] != b'RIFF' or d[8:12] != b'WEBP':
-        return None
-    f = d[12:16]
-    if f == b'VP8 ':
-        return struct.unpack('<H', d[26:28])[0] & 0x3fff, struct.unpack('<H', d[28:30])[0] & 0x3fff
-    if f == b'VP8L':
-        b = d[21:25]
-        v = b[0] | b[1] << 8 | b[2] << 16 | b[3] << 24
-        return (v & 0x3fff) + 1, ((v >> 14) & 0x3fff) + 1
-    if f == b'VP8X':
-        return (d[24] | d[25] << 8 | d[26] << 16) + 1, (d[27] | d[28] << 8 | d[29] << 16) + 1
-    return None
-
-
-def png_size(p):
-    d = open(p, 'rb').read(24)
-    return struct.unpack('>II', d[16:24])
-
-
-def svg_size(p):
-    h = open(p, encoding='utf-8', errors='ignore').read(400)
-    m = re.search(r'width="([0-9.]+)"[^>]*height="([0-9.]+)"', h)
-    if m:
-        return float(m.group(1)), float(m.group(2))
-    m = re.search(r'viewBox="[\d.]+ [\d.]+ ([\d.]+) ([\d.]+)"', h)
-    return (float(m.group(1)), float(m.group(2))) if m else None
-
-
-def media_size(media_dir, name):
-    for ext, fn in (('.webp', webp_size), ('.png', png_size), ('.jpg', png_size), ('.svg', svg_size)):
-        p = os.path.join(media_dir, name + ext)
-        if os.path.exists(p):
-            try:
-                return fn(p), ext
-            except Exception:
-                return None, ext
-    return None, None
-
-
-def src_multiplier(res_roots, name):
-    best = None
-    for root in res_roots:
-        for hit in glob.glob(f'{root}/*/{name}.*'):
-            folder = os.path.basename(os.path.dirname(hit))
-            for k, v in DENSITY.items():
-                if folder.endswith('-' + k) or folder.endswith(k):
-                    if best is None or v > best[0]:
-                        best = (v, folder)
-    return best
-
-
-def find_media_dir():
-    # 排除非工程目录（skill 模板 / 依赖 / 构建产物 / 隐藏目录），避免 os.walk 误入
-    # .claude/skills/.../template/AppScope/resources/base/media 等 fixture。
-    skip = {'.git', '.hvigor', '.idea', '.claude', '.cxt',
-            'oh_modules', 'node_modules', 'build', 'template'}
-    candidates = []
-    for base, dirs, _ in os.walk('.'):
-        dirs[:] = [d for d in dirs if d not in skip and not d.startswith('.')]
-        if base.replace('\\', '/').endswith('resources/base/media'):
-            candidates.append(base)
-    if not candidates:
-        return None
-    # 优先工程模块媒体（*/src/main/resources/base/media）而非 app 级 AppScope 或其它
-    for c in candidates:
-        if '/src/main/resources/' in c.replace('\\', '/'):
-            return c
-    return candidates[0]
-
-
-def build_plan(names, media, android_res, density):
-    """对一组图标名，逐个 媒体像素 ÷ 源密度 算出标称 vp，返回 (plan, unresolved)。
-
-    被 icon_dims.main() 与 icon_autofix.py 共用。
-      names       : 图标名列表（不含扩展名）
-      media       : HarmonyOS base/media 目录
-      android_res : Android res 根列表（空/None → 用 density 回退）
-      density     : 回退密度倍数
-    返回 plan = {icon: {w,h,px,density,src,ext}}；unresolved = 找不到 raster 的图标名列表。
-    """
-    plan, unresolved = {}, []
-    for ic in names:
-        sz, ext = media_size(media, ic)
-        if sz is None:
-            unresolved.append(ic)
-            continue
-        mult = src_multiplier(android_res, ic) if android_res else None
-        m = mult[0] if mult else density
-        src = mult[1] if mult else f'assumed {density}x'
-        w, h = sz
-        vw, vh = max(1, round(w / m)), max(1, round(h / m))
-        plan[ic] = {'w': vw, 'h': vh, 'px': [round(w), round(h)], 'density': m, 'src': src, 'ext': ext}
-    return plan, unresolved
-
-
-def main():
-    ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
-    ap.add_argument('--report', default='icon_report.json')
-    ap.add_argument('--media', help='HarmonyOS base/media 目录（默认：自动发现）')
-    ap.add_argument('--android-res', nargs='*', default=[], help='用于密度查找的 Android res 根')
-    ap.add_argument('--density', type=float, default=3.0, help='回退密度倍数（默认 3 = xxhdpi）')
-    ap.add_argument('--icons', help='逗号分隔的图标名，临时查询（替代 --report）')
-    ap.add_argument('--json', default='icon_plan.json')
-    a = ap.parse_args()
-
-    media = a.media or find_media_dir()
-    if not media:
-        print('未找到 resources/base/media —— 请用 --media 指定。')
-        return
-
-    if a.icons:
-        names = [n.strip() for n in a.icons.split(',') if n.strip()]
-    else:
-        rep = json.load(open(a.report, encoding='utf-8'))
-        names = sorted({f['icon'] for f in rep['flagged'] if f.get('icon')})
-
-    print(f"media: {media}")
-    print(f"密度来源: {a.android_res or f'回退 {a.density}x'}\n")
-    print(f"{'图标':40} {'像素':12} {'密度':16} {'-> vp (w x h)'}")
-    print('-' * 86)
-    plan, unresolved = build_plan(names, media, a.android_res or None, a.density)
-    for ic in names:
-        if ic in plan:
-            p = plan[ic]
-            px = f"{p['px'][0]}x{p['px'][1]}"
-            print(f"{ic:40} {px:12} {p['src']:16} -> {p['w']} x {p['h']}")
-        else:
-            label = '(无 raster)'
-            blank = ''
-            print(f"{ic:40} {label:12} {blank:16} -> 手工处理（动态 / svg shape / 矢量图）")
-
-    json.dump(plan, open(a.json, 'w', encoding='utf-8'), ensure_ascii=False, indent=2)
-    print(f'\n已写出 {a.json}（{len(plan)} 个图标）。')
-    if unresolved:
-        print(f'UNRESOLVED（{len(unresolved)}）—— 手工解析资源后，用 --icons <名字> 重跑来测尺寸：'
-              f'{", ".join(unresolved)}')
-    print(f'请审核 icon_plan.json，然后：python icon_fix.py --plan {a.json} --report {a.report}（加 --apply 落盘）')
-
-
-if __name__ == '__main__':
-    main()
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""第 2/3 步 —— 还原每个被标记图标的正确 vp 尺寸。
+
+公式
+  HarmonyOS 中 `resources/base/media`（无密度限定符）里的位图按其字面像素尺寸
+  当作 vp 渲染。源位图来自某个 Android 密度桶（如 drawable-xxhdpi /
+  mipmap-xxhdpi = 3 倍）。因此图标被设计显示的尺寸是：
+        标称 vp = 源像素 / 源密度倍数
+  我们从 HarmonyOS media 文件读像素尺寸，从 Android 源目录名取倍数。宽和高
+  分别独立相除，所以真实宽高比得以保留（这正是修复「失真 / 比例错」的关键）。
+
+倍数从何而来
+  1. 给了 --android-res 时，由图标的源目录（如 mipmap-xxhdpi）决定。Android
+     工程可能多模块 —— 把每个 res 根都传进来（如 app/src/main/res 与
+     base/src/main/res）。
+  2. 否则回退到 --density（默认 3.0 = xxhdpi，现代 app 最常见的单一桶）。输出
+     会标出 assumed 项，便于人工核对。
+
+输出
+  打印表格并写出 icon_plan.json {icon: {w,h,px,density,src}}。
+  找不到 raster 的图标（动态引用、纯 SVG shape、矢量图）列为 UNRESOLVED 供手工处理。
+
+用法
+  python icon_dims.py --report icon_report.json \
+      --media entry/src/main/resources/base/media \
+      --android-res /path/app/src/main/res /path/base/src/main/res
+  python icon_dims.py --report icon_report.json --density 3      # 无 Android 源
+  python icon_dims.py --media .../media --icons ic_a,ic_b        # 临时查询
+"""
+import os, re, json, struct, glob, argparse
+
+DENSITY = {'ldpi': 0.75, 'mdpi': 1.0, 'tvdpi': 1.33, 'hdpi': 1.5,
+           'xhdpi': 2.0, 'xxhdpi': 3.0, 'xxxhdpi': 4.0}
+
+
+def webp_size(p):
+    d = open(p, 'rb').read(40)
+    if d[:4] != b'RIFF' or d[8:12] != b'WEBP':
+        return None
+    f = d[12:16]
+    if f == b'VP8 ':
+        return struct.unpack('<H', d[26:28])[0] & 0x3fff, struct.unpack('<H', d[28:30])[0] & 0x3fff
+    if f == b'VP8L':
+        b = d[21:25]
+        v = b[0] | b[1] << 8 | b[2] << 16 | b[3] << 24
+        return (v & 0x3fff) + 1, ((v >> 14) & 0x3fff) + 1
+    if f == b'VP8X':
+        return (d[24] | d[25] << 8 | d[26] << 16) + 1, (d[27] | d[28] << 8 | d[29] << 16) + 1
+    return None
+
+
+def png_size(p):
+    d = open(p, 'rb').read(24)
+    return struct.unpack('>II', d[16:24])
+
+
+def svg_size(p):
+    h = open(p, encoding='utf-8', errors='ignore').read(400)
+    m = re.search(r'width="([0-9.]+)"[^>]*height="([0-9.]+)"', h)
+    if m:
+        return float(m.group(1)), float(m.group(2))
+    m = re.search(r'viewBox="[\d.]+ [\d.]+ ([\d.]+) ([\d.]+)"', h)
+    return (float(m.group(1)), float(m.group(2))) if m else None
+
+
+def media_size(media_dir, name):
+    for ext, fn in (('.webp', webp_size), ('.png', png_size), ('.jpg', png_size), ('.svg', svg_size)):
+        p = os.path.join(media_dir, name + ext)
+        if os.path.exists(p):
+            try:
+                return fn(p), ext
+            except Exception:
+                return None, ext
+    return None, None
+
+
+def src_multiplier(res_roots, name):
+    best = None
+    for root in res_roots:
+        for hit in glob.glob(f'{root}/*/{name}.*'):
+            folder = os.path.basename(os.path.dirname(hit))
+            for k, v in DENSITY.items():
+                if folder.endswith('-' + k) or folder.endswith(k):
+                    if best is None or v > best[0]:
+                        best = (v, folder)
+    return best
+
+
+def find_media_dir():
+    # 排除非工程目录（skill 模板 / 依赖 / 构建产物 / 隐藏目录），避免 os.walk 误入
+    # .claude/skills/.../template/AppScope/resources/base/media 等 fixture。
+    skip = {'.git', '.hvigor', '.idea', '.claude', '.cxt',
+            'oh_modules', 'node_modules', 'build', 'template'}
+    candidates = []
+    for base, dirs, _ in os.walk('.'):
+        dirs[:] = [d for d in dirs if d not in skip and not d.startswith('.')]
+        if base.replace('\\', '/').endswith('resources/base/media'):
+            candidates.append(base)
+    if not candidates:
+        return None
+    # 优先工程模块媒体（*/src/main/resources/base/media）而非 app 级 AppScope 或其它
+    for c in candidates:
+        if '/src/main/resources/' in c.replace('\\', '/'):
+            return c
+    return candidates[0]
+
+
+def build_plan(names, media, android_res, density):
+    """对一组图标名，逐个 媒体像素 ÷ 源密度 算出标称 vp，返回 (plan, unresolved)。
+
+    被 icon_dims.main() 与 icon_autofix.py 共用。
+      names       : 图标名列表（不含扩展名）
+      media       : HarmonyOS base/media 目录
+      android_res : Android res 根列表（空/None → 用 density 回退）
+      density     : 回退密度倍数
+    返回 plan = {icon: {w,h,px,density,src,ext}}；unresolved = 找不到 raster 的图标名列表。
+    """
+    plan, unresolved = {}, []
+    for ic in names:
+        sz, ext = media_size(media, ic)
+        if sz is None:
+            unresolved.append(ic)
+            continue
+        mult = src_multiplier(android_res, ic) if android_res else None
+        m = mult[0] if mult else density
+        src = mult[1] if mult else f'assumed {density}x'
+        w, h = sz
+        vw, vh = max(1, round(w / m)), max(1, round(h / m))
+        plan[ic] = {'w': vw, 'h': vh, 'px': [round(w), round(h)], 'density': m, 'src': src, 'ext': ext}
+    return plan, unresolved
+
+
+def main():
+    ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
+    ap.add_argument('--report', default='icon_report.json')
+    ap.add_argument('--media', help='HarmonyOS base/media 目录（默认：自动发现）')
+    ap.add_argument('--android-res', nargs='*', default=[], help='用于密度查找的 Android res 根')
+    ap.add_argument('--density', type=float, default=3.0, help='回退密度倍数（默认 3 = xxhdpi）')
+    ap.add_argument('--icons', help='逗号分隔的图标名，临时查询（替代 --report）')
+    ap.add_argument('--json', default='icon_plan.json')
+    a = ap.parse_args()
+
+    media = a.media or find_media_dir()
+    if not media:
+        print('未找到 resources/base/media —— 请用 --media 指定。')
+        return
+
+    if a.icons:
+        names = [n.strip() for n in a.icons.split(',') if n.strip()]
+    else:
+        rep = json.load(open(a.report, encoding='utf-8'))
+        names = sorted({f['icon'] for f in rep['flagged'] if f.get('icon')})
+
+    print(f"media: {media}")
+    print(f"密度来源: {a.android_res or f'回退 {a.density}x'}\n")
+    print(f"{'图标':40} {'像素':12} {'密度':16} {'-> vp (w x h)'}")
+    print('-' * 86)
+    plan, unresolved = build_plan(names, media, a.android_res or None, a.density)
+    for ic in names:
+        if ic in plan:
+            p = plan[ic]
+            px = f"{p['px'][0]}x{p['px'][1]}"
+            print(f"{ic:40} {px:12} {p['src']:16} -> {p['w']} x {p['h']}")
+        else:
+            label = '(无 raster)'
+            blank = ''
+            print(f"{ic:40} {label:12} {blank:16} -> 手工处理（动态 / svg shape / 矢量图）")
+
+    json.dump(plan, open(a.json, 'w', encoding='utf-8'), ensure_ascii=False, indent=2)
+    print(f'\n已写出 {a.json}（{len(plan)} 个图标）。')
+    if unresolved:
+        print(f'UNRESOLVED（{len(unresolved)}）—— 手工解析资源后，用 --icons <名字> 重跑来测尺寸：'
+              f'{", ".join(unresolved)}')
+    print(f'请审核 icon_plan.json，然后：python icon_fix.py --plan {a.json} --report {a.report}（加 --apply 落盘）')
+
+
+if __name__ == '__main__':
+    main()

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

@@ -1,119 +1,119 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""第 3/3 步 —— 把还原出的尺寸插入 .ets 源码。
-
-实时重扫（因此对行号位移健壮），对 icon_plan.json 中存在的每个欠约束静态图标：
-  - 既无 width 又无 height  -> 插入  .width(W)  .height(H)   （固定标称 vp）
-  - 恰好只有一维            -> 插入  .aspectRatio(W/H)       （保留有意的那一维，
-        如满宽横幅的 width('100%')，只修比例）
-新修饰符插入在 `Image(...)` 开头之后、与原链同缩进，从而与 `.objectFit(...)` 等干净组合。
-
-动态源图片（Image(this.foo())、三元 Image(cond ? a : b)、Builder `Image(param)`）
-不自动改 —— 只报告，便于解析底层资源、用 icon_dims.py --icons 查尺寸后手工改。
-
-安全
-  默认 dry-run（打印将要做的改动）。加 --apply 才落盘。
-  调用前记录允许修改的文件范围；需要恢复时只撤销本次输出清单中的修改，
-  不得暂存、提交或整体回滚调用方已有改动。
-
-用法
-  python icon_fix.py --plan icon_plan.json --report icon_report.json            # dry-run
-  python icon_fix.py --plan icon_plan.json --report icon_report.json --apply    # 落盘
-"""
-import os, re, json, argparse
-
-
-def chain_end(lines, i):
-    base = len(lines[i]) - len(lines[i].lstrip())
-    j = i + 1
-    while j < len(lines):
-        if lines[j].strip() == '':
-            j += 1
-            continue
-        if (len(lines[j]) - len(lines[j].lstrip())) <= base:
-            break
-        j += 1
-    return j
-
-
-def apply_fixes(plan, report, apply=True):
-    """对 report 标记的文件实时重扫，按 plan 给欠约束静态图标插入尺寸。
-
-    被 icon_fix.main() 与 icon_autofix.py 共用。
-      plan   : {icon: {w,h,...}}（icon_dims.build_plan 产出）
-      report : icon_report.json 内容（取 flagged 的文件集合作为作用域）
-      apply  : True 落盘，False 仅计算（dry-run）
-    返回 (applied, dynamic)：applied 为修复描述行列表，dynamic 为动态源待手工项。
-    """
-    files = sorted({f['file'] for f in report['flagged']})  # 仅针对被标记的文件
-    applied, dynamic = [], []
-    for path in files:
-        if not os.path.exists(path):
-            continue
-        lines = open(path, encoding='utf-8').read().split('\n')
-        edits = []
-        for i, ln in enumerate(lines):
-            st = ln.lstrip()
-            if st.startswith('*') or st.startswith('//') or st.startswith('/*'):
-                continue
-            code = ln.split('//')[0]
-            if not re.search(r'\bImage\(', code):
-                continue
-            end = chain_end(lines, i)
-            win = '\n'.join(lines[i + 1:end])
-            has_w, has_h = '.width(' in win, '.height(' in win
-            has_size, has_aspect = '.size(' in win, '.aspectRatio(' in win
-            has_weight = '.layoutWeight(' in win
-            w100, h100 = ".width('100%')" in win, ".height('100%')" in win
-            ok = has_size or (has_w and has_h) or ((has_w ^ has_h) and (has_aspect or has_weight))
-            if ok or (w100 and h100):
-                continue
-            m = re.search(r"(?:app|sys)\.media\.([A-Za-z0-9_]+)", code)
-            if not m:
-                dynamic.append(f'{path}:{i + 1}  {st[:55]}')
-                continue
-            icon = m.group(1)
-            if icon not in plan:
-                continue
-            w, h = plan[icon]['w'], plan[icon]['h']
-            ind = ' ' * ((len(lines[i + 1]) - len(lines[i + 1].lstrip())) if i + 1 < end else (len(ln) - len(st)) + 2)
-            if not has_w and not has_h:
-                ins = [f'{ind}.width({w})', f'{ind}.height({h})']
-                kind = f'w/h {w}x{h}'
-            else:
-                ratio = round(w / h, 4)
-                ins = [f'{ind}.aspectRatio({ratio})']
-                kind = f'aspectRatio {ratio} ({"W" if has_w else "H"} set)'
-            edits.append((i, ins))
-            applied.append(f'{os.path.basename(path)}:{i + 1}  {icon:34} -> {kind}')
-        if edits and apply:
-            for i, ins in sorted(edits, reverse=True):
-                lines[i + 1:i + 1] = ins
-            open(path, 'w', encoding='utf-8').write('\n'.join(lines))
-    return applied, dynamic
-
-
-def main():
-    ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
-    ap.add_argument('--plan', default='icon_plan.json')
-    ap.add_argument('--report', default='icon_report.json')
-    ap.add_argument('--apply', action='store_true', help='落盘（默认 dry-run）')
-    a = ap.parse_args()
-
-    plan = json.load(open(a.plan, encoding='utf-8'))
-    rep = json.load(open(a.report, encoding='utf-8'))
-    applied, dynamic = apply_fixes(plan, rep, apply=a.apply)
-
-    verb = '已落盘' if a.apply else '将要修复（dry-run）'
-    print(f'== {verb}：{len(applied)} 处 ==')
-    for s in sorted(applied):
-        print('  ' + s)
-    print(f'\n== 动态源（手工解析，见 SKILL.md）：{len(dynamic)} ==')
-    for d in dynamic:
-        print('  ' + d)
-    if not a.apply:
-        print('\n仅 dry-run。加 --apply 落盘，然后重跑 icon_audit.py + 编译。')
-
-
-if __name__ == '__main__':
-    main()
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""第 3/3 步 —— 把还原出的尺寸插入 .ets 源码。
+
+实时重扫（因此对行号位移健壮），对 icon_plan.json 中存在的每个欠约束静态图标：
+  - 既无 width 又无 height  -> 插入  .width(W)  .height(H)   （固定标称 vp）
+  - 恰好只有一维            -> 插入  .aspectRatio(W/H)       （保留有意的那一维，
+        如满宽横幅的 width('100%')，只修比例）
+新修饰符插入在 `Image(...)` 开头之后、与原链同缩进，从而与 `.objectFit(...)` 等干净组合。
+
+动态源图片（Image(this.foo())、三元 Image(cond ? a : b)、Builder `Image(param)`）
+不自动改 —— 只报告，便于解析底层资源、用 icon_dims.py --icons 查尺寸后手工改。
+
+安全
+  默认 dry-run（打印将要做的改动）。加 --apply 才落盘。
+  调用前记录允许修改的文件范围；需要恢复时只撤销本次输出清单中的修改，
+  不得暂存、提交或整体回滚调用方已有改动。
+
+用法
+  python icon_fix.py --plan icon_plan.json --report icon_report.json            # dry-run
+  python icon_fix.py --plan icon_plan.json --report icon_report.json --apply    # 落盘
+"""
+import os, re, json, argparse
+
+
+def chain_end(lines, i):
+    base = len(lines[i]) - len(lines[i].lstrip())
+    j = i + 1
+    while j < len(lines):
+        if lines[j].strip() == '':
+            j += 1
+            continue
+        if (len(lines[j]) - len(lines[j].lstrip())) <= base:
+            break
+        j += 1
+    return j
+
+
+def apply_fixes(plan, report, apply=True):
+    """对 report 标记的文件实时重扫，按 plan 给欠约束静态图标插入尺寸。
+
+    被 icon_fix.main() 与 icon_autofix.py 共用。
+      plan   : {icon: {w,h,...}}（icon_dims.build_plan 产出）
+      report : icon_report.json 内容（取 flagged 的文件集合作为作用域）
+      apply  : True 落盘，False 仅计算（dry-run）
+    返回 (applied, dynamic)：applied 为修复描述行列表，dynamic 为动态源待手工项。
+    """
+    files = sorted({f['file'] for f in report['flagged']})  # 仅针对被标记的文件
+    applied, dynamic = [], []
+    for path in files:
+        if not os.path.exists(path):
+            continue
+        lines = open(path, encoding='utf-8').read().split('\n')
+        edits = []
+        for i, ln in enumerate(lines):
+            st = ln.lstrip()
+            if st.startswith('*') or st.startswith('//') or st.startswith('/*'):
+                continue
+            code = ln.split('//')[0]
+            if not re.search(r'\bImage\(', code):
+                continue
+            end = chain_end(lines, i)
+            win = '\n'.join(lines[i + 1:end])
+            has_w, has_h = '.width(' in win, '.height(' in win
+            has_size, has_aspect = '.size(' in win, '.aspectRatio(' in win
+            has_weight = '.layoutWeight(' in win
+            w100, h100 = ".width('100%')" in win, ".height('100%')" in win
+            ok = has_size or (has_w and has_h) or ((has_w ^ has_h) and (has_aspect or has_weight))
+            if ok or (w100 and h100):
+                continue
+            m = re.search(r"(?:app|sys)\.media\.([A-Za-z0-9_]+)", code)
+            if not m:
+                dynamic.append(f'{path}:{i + 1}  {st[:55]}')
+                continue
+            icon = m.group(1)
+            if icon not in plan:
+                continue
+            w, h = plan[icon]['w'], plan[icon]['h']
+            ind = ' ' * ((len(lines[i + 1]) - len(lines[i + 1].lstrip())) if i + 1 < end else (len(ln) - len(st)) + 2)
+            if not has_w and not has_h:
+                ins = [f'{ind}.width({w})', f'{ind}.height({h})']
+                kind = f'w/h {w}x{h}'
+            else:
+                ratio = round(w / h, 4)
+                ins = [f'{ind}.aspectRatio({ratio})']
+                kind = f'aspectRatio {ratio} ({"W" if has_w else "H"} set)'
+            edits.append((i, ins))
+            applied.append(f'{os.path.basename(path)}:{i + 1}  {icon:34} -> {kind}')
+        if edits and apply:
+            for i, ins in sorted(edits, reverse=True):
+                lines[i + 1:i + 1] = ins
+            open(path, 'w', encoding='utf-8').write('\n'.join(lines))
+    return applied, dynamic
+
+
+def main():
+    ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
+    ap.add_argument('--plan', default='icon_plan.json')
+    ap.add_argument('--report', default='icon_report.json')
+    ap.add_argument('--apply', action='store_true', help='落盘（默认 dry-run）')
+    a = ap.parse_args()
+
+    plan = json.load(open(a.plan, encoding='utf-8'))
+    rep = json.load(open(a.report, encoding='utf-8'))
+    applied, dynamic = apply_fixes(plan, rep, apply=a.apply)
+
+    verb = '已落盘' if a.apply else '将要修复（dry-run）'
+    print(f'== {verb}：{len(applied)} 处 ==')
+    for s in sorted(applied):
+        print('  ' + s)
+    print(f'\n== 动态源（手工解析，见 SKILL.md）：{len(dynamic)} ==')
+    for d in dynamic:
+        print('  ' + d)
+    if not a.apply:
+        print('\n仅 dry-run。加 --apply 落盘，然后重跑 icon_audit.py + 编译。')
+
+
+if __name__ == '__main__':
+    main()