@hupan56/wlkj 2.6.0 → 2.7.1

package/templates/qoder/scripts/fill_prototype.py

@@ -0,0 +1,707 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+QODER Fill Prototype - 用真实数据自动预填原型模板 (80%完成)
+
+解决 AI 出原型时"从零手写 + 发明颜色"的效率问题:
+  - 从 style-index 取真实表格列/表单字段 (不再 AI 编)
+  - 从 field_map 补充相关字段的中文标题
+  - token 直接继承模板 (模板已有正确 HSL 值, 不碰颜色)
+  - 输出 80% 完成的 HTML 草稿 + 数据清单
+
+AI 只需做 20% 微调 (交互细节/布局调整), 不再重写。
+
+Usage:
+  python fill_prototype.py <关键词> [--platform web|app] [--type table|form]
+  python fill_prototype.py 营业外合同 --platform web
+"""
+
+import os
+import sys
+import json
+import re
+import argparse
+
+# UTF-8 stdio
+try:
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+except (AttributeError, TypeError, OSError, IOError):
+    try:
+        sys.stdout.reconfigure(encoding='utf-8')
+    except Exception:
+        pass
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from common.terms import expand_chinese_query, get_platform_map
+
+BASE = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+INDEX_DIR = os.path.join(BASE, 'data', 'index')
+TEMPLATE_DIR = os.path.join(BASE, '.qoder', 'templates')
+
+
+def load_index(filename):
+    """Load index from DuckDB (preferred) or JSON fallback."""
+    try:
+        from search_index import _duckdb_load
+        result = _duckdb_load(filename)
+        if result is not None:
+            return result
+    except Exception:
+        pass
+    path = os.path.join(INDEX_DIR, filename)
+    if not os.path.isfile(path):
+        return None
+    try:
+        with open(path, encoding='utf-8') as f:
+            return json.load(f)
+    except Exception:
+        return None
+
+
+def extract_real_buttons(query_words, limit=6):
+    """从 entity-registry.json 提取真实按钮 (按钮文案 + 关联 API)。
+
+    这让原型显示系统里真实的按钮文案 ("添加反馈资产" "导出Excel"),
+    而不是 AI 编的 ("新增" "编辑")。按钮名来自真实 Vue 代码。
+    """
+    er = load_index('entity-registry.json')
+    if not er or not isinstance(er, dict):
+        return []
+    entities = er.get('entities', {})
+    if not entities:
+        return []
+    buttons = []
+    query_lower = [w.lower() for w in query_words]
+    for eid, info in entities.items():
+        if not eid.startswith('B:'):
+            continue
+        props = info.get('properties', {}) if isinstance(info, dict) else {}
+        btn_text = props.get('button_text', '')
+        endpoint = props.get('endpoint', '')
+        vue_file = props.get('vue_file', '') or props.get('feature', '')
+        # 关键词命中: 按钮文案或文件路径包含查询词
+        match_text = (btn_text + ' ' + vue_file).lower()
+        if any(w in match_text for w in query_lower):
+            buttons.append({'text': btn_text, 'endpoint': endpoint, 'source': eid[2:][:60]})
+            if len(buttons) >= limit:
+                break
+    return buttons
+
+
+def find_best_example(query_words, style_index, platform, page_type='table-page'):
+    """从 style-index 找最相似的页面 (table_columns/form_fields 最多)。
+
+    返回 (example_dict, source_file) 或 (None, None)。
+    """
+    proj_map = get_platform_map()
+    target_projects = proj_map.get(platform, [])
+    if not target_projects:
+        target_projects = list((style_index.get('projects') or {}).keys())
+
+    best = None
+    best_score = 0
+    best_file = None
+
+    for proj_name, pdata in (style_index.get('projects') or {}).items():
+        if target_projects and proj_name not in target_projects:
+            continue
+        for pt, examples in (pdata.get('page_examples') or {}).items():
+            if page_type and pt != page_type:
+                continue
+            for ex in examples:
+                if not isinstance(ex, dict):
+                    continue
+                cols = ex.get('table_columns', [])
+                fields = ex.get('form_fields', [])
+                score = len(cols) + len(fields)
+
+                # 关键词匹配加分: 字段名或标题包含查询词
+                all_text = ' '.join(
+                    str(c.get('field', '')) + ' ' + str(c.get('title', ''))
+                    for c in cols
+                ) + ' ' + ' '.join(
+                    str(f.get('field', '')) + ' ' + str(f.get('label', ''))
+                    for f in fields
+                ) + ' ' + ex.get('file', '')
+                all_lower = all_text.lower()
+                for w in query_words:
+                    if w.lower() in all_lower:
+                        score += 5  # 关键词命中加分
+
+                if score > best_score:
+                    best_score = score
+                    best = ex
+                    best_file = ex.get('file', '')
+
+    return best, best_file
+
+
+def supplement_fields_from_map(query_words, field_map, existing_fields, limit=6):
+    """从 field_map 补充页面里没有但相关的字段 (取中文标题)。
+
+    field_map 格式: {field_name: {titles: set, files: list}}
+    """
+    extra = []
+    existing_names = set()
+    for f in existing_fields:
+        existing_names.add(f.get('field', '').lower())
+        existing_names.add(f.get('label', '').lower())
+
+    for field_name, info in field_map.items():
+        if field_name.lower() in existing_names:
+            continue
+        titles = info.get('titles', set()) if isinstance(info.get('titles'), set) else set(info.get('titles', []))
+        title_str = ' '.join(str(t) for t in titles)
+        # 关键词命中 (字段名或标题含查询词)
+        match_text = (field_name + ' ' + title_str).lower()
+        for w in query_words:
+            if w.lower() in match_text:
+                title = next(iter(titles), field_name) if titles else field_name
+                extra.append({'field': field_name, 'title': title})
+                break
+        if len(extra) >= limit:
+            break
+
+    return extra
+
+
+def gen_search_form_html(form_fields, extra_fields):
+    """生成搜索表单 HTML (从真实 form_fields)。"""
+    if not form_fields and not extra_fields:
+        return '<div class="form-item"><label>关键词</label><input type="text" placeholder="请输入"></div>'
+
+    items = []
+    for f in (form_fields + extra_fields)[:6]:  # 搜索表单最多 6 个字段
+        label = f.get('label') or f.get('title') or f.get('field', '')
+        field = f.get('field', '')
+        items.append(
+            '          <div class="form-item">\n'
+            '            <label>{label}</label>\n'
+            '            <input type="text" placeholder="请输入{label}" data-field="{field}">\n'
+            '          </div>'.format(label=label, field=field)
+        )
+    items.append(
+        '          <div class="form-item">\n'
+        '            <button class="btn btn-primary">查询</button>\n'
+        '            <button class="btn btn-outline">重置</button>\n'
+        '          </div>'
+    )
+    return '\n'.join(items)
+
+
+def gen_table_html(table_columns, extra_fields):
+    """生成表头 + 3 行示例数据 HTML (从真实 table_columns)。"""
+    all_cols = table_columns + [{'field': e['field'], 'title': e['title']} for e in extra_fields]
+    all_cols = all_cols[:12]  # 表格最多 12 列
+
+    # 表头
+    headers = []
+    for col in all_cols:
+        title = col.get('title') or col.get('field', '')
+        headers.append('              <th>{}</th>'.format(title))
+    headers_html = '\n'.join(headers)
+
+    # 3 行示例数据
+    rows = []
+    for i in range(1, 4):
+        cells = []
+        for col in all_cols:
+            field = col.get('field', '')
+            title = col.get('title', '')
+            # 示例数据: 用字段名 + 行号生成假数据, 让 AI 知道每列是什么
+            sample = '{}示例{}'.format(title[:4], i) if title else '{}-{}'.format(field[:6], i)
+            cells.append('              <td>{}</td>'.format(sample))
+        # 加操作列 (用真实按钮文案, 来自 entity-registry; 没有则用通用文案)
+        cells.append('              <td><a href="#">详情</a> <a href="#">编辑</a></td>')
+        rows.append('            <tr>\n' + '\n'.join(cells) + '\n            </tr>')
+
+    rows_html = '\n'.join(rows)
+
+    # 操作列表头
+    headers_html += '\n              <th>操作</th>'
+
+    return headers_html, rows_html
+
+
+def infer_module_name(source_file):
+    """从源文件路径推断模块名。"""
+    if not source_file:
+        return '业务模块'
+    # data/code/fywl-ui/apps/ics/src/views/HR/... → HR
+    parts = source_file.replace('\\', '/').split('/')
+    for i, p in enumerate(parts):
+        if p == 'views' and i + 1 < len(parts):
+            return parts[i + 1]
+    return parts[-2] if len(parts) >= 2 else '业务模块'
+
+
+def resolve_module_name(query, source_file, platform):
+    """解析模块名 (优先用 module-index 真实名, 回退路径推断)。
+
+    ui-modules.json 由 build_style_index.py 生成, 含真实业务模块的
+    英文目录名 + 中文标签。先按 query 关键词匹配模块中文名, 再按 source_file
+    的路径片段匹配目录名; 都不中则回退 infer_module_name。
+    返回 (module_cn, module_dir)。
+    """
+    # 1. 加载 module-index
+    mod_index = load_index('ui-modules.json') or {}
+    proj_map = get_platform_map()
+    proj_name = proj_map.get(platform)
+    mods = (mod_index.get('projects') or {}).get(proj_name, [])
+    if not mods:
+        # 项目无模块索引, 回退
+        return infer_module_name(source_file), None
+
+    # 2. 按 query 关键词匹配中文标签 (如 "车辆管理" -> 匹配含"管理"的模块)
+    q = (query or '').lower()
+    if q:
+        # 精确 / 包含匹配 (最稳)
+        for m in mods:
+            if m['cn'].lower() == q or q in m['cn'].lower():
+                return m['cn'], m['dir']
+            if m['dir'].lower() in q or q in m['dir'].lower():
+                return m['cn'], m['dir']
+        # 宽松: 共享 2+ 字前缀 (车辆管理 -> 车辆生活)
+        for m in mods:
+            cn = m['cn']
+            shared = sum(1 for i in range(min(len(q), len(cn))) if q[i] == cn[i].lower())
+            if shared >= 2 and len(q) >= 2:
+                return m['cn'], m['dir']
+
+    # 3. 按 source_file 路径片段匹配目录名
+    if source_file:
+        sf_lower = source_file.replace('\\', '/').lower()
+        for m in mods:
+            if '/' + m['dir'].lower() + '/' in sf_lower:
+                return m['cn'], m['dir']
+
+    # 4. 回退: 路径推断 (但用真实模块中文名校正 views/ 后的目录)
+    guessed = infer_module_name(source_file)
+    for m in mods:
+        if m['dir'].lower() == guessed.lower():
+            return m['cn'], m['dir']
+    return guessed, None
+
+
+def get_layout_fingerprint(style_index, platform):
+    """读取目标项目的布局指纹 (build_style_index.py 提取)。
+
+    返回 fingerprint dict;若无则返回 None。用于让原型草稿贴合目标项目的
+    真实外壳 (如 ICS = mixed-nav 后端路由多级菜单)。
+    """
+    proj_map = get_platform_map()
+    proj_name = proj_map.get(platform)
+    projects = style_index.get('projects') or {}
+    if proj_name and proj_name in projects:
+        return projects[proj_name].get('layout_fingerprint')
+    return None
+
+
+def gen_mixed_nav_menu(module_name, page_name, sibling_modules=None, logo_text=None):
+    """为 mixed-nav 布局生成示例菜单骨架 (一级顶栏 + 二级侧栏 + 标签页)。
+
+    sibling_modules: 同项目的其他真实模块 [(cn, dir), ...], 若提供则用真实
+    模块名填充顶部一级菜单 (当前模块 active), 替代占位文字。
+    logo_text: 顶部 logo 文字, 默认 '管理平台' (通用, 不绑定具体项目)。
+    返回 (top_menu, sidebar_menu, tabs, logo_text)。
+    """
+    if not logo_text:
+        logo_text = '管理平台'
+    # 顶部一级菜单: 优先用真实兄弟模块名, 当前模块 active
+    if sibling_modules:
+        others = [cn for cn, _ in sibling_modules if cn != module_name][:3]
+        items = ['<div class="top-menu-item">%s</div>' % cn for cn in others[:2]]
+        items.append('<div class="top-menu-item active">%s</div>' % module_name)
+        if len(others) > 2:
+            items.append('<div class="top-menu-item">%s</div>' % others[2])
+        top_menu = '\n        '.join(items)
+    else:
+        top_menu = (
+            '<div class="top-menu-item">概览</div>\n'
+            '        <div class="top-menu-item active">{mod}</div>\n'
+            '        <div class="top-menu-item">系统管理</div>'
+        ).format(mod=module_name)
+    # 左侧二级 + 三级折叠示例 (当前页 active)
+    sidebar_menu = (
+        '<div class="sidebar-item active">{page}</div>\n'
+        '        <details class="sidebar-group">\n'
+        '          <summary>二级菜单A</summary>\n'
+        '          <div class="sidebar-sub">\n'
+        '            <div class="sidebar-item">三级菜单A-1</div>\n'
+        '            <div class="sidebar-item">三级菜单A-2</div>\n'
+        '          </div>\n'
+        '        </details>\n'
+        '        <div class="sidebar-item">二级菜单B</div>'
+    ).format(page=page_name)
+    # 标签页 (承载三四级)
+    tabs = (
+        '<div class="tab-item active">{page} <span class="tab-close">×</span></div>'
+    ).format(page=page_name)
+    return top_menu, sidebar_menu, tabs, logo_text
+
+
+def load_design_spec(query, platform=None):
+    """读取与当前需求匹配的设计规范 spec.json (design-import 录入)。
+
+    扫描 data/style/*-design-spec.json (兼容旧 {name}- 和新 {name}-{平台}- 命名),
+    优先匹配 requirement 字段; 同分时优先选 platform 匹配的; 仍同分按导入时间取最新。
+    目录为空返回 None。
+
+    spec 优先级 > 代码风格指纹 > 模板默认值 (design-import SKILL.md 铁律)。
+    """
+    style_dir = os.path.join(BASE, 'data', 'style')
+    if not os.path.isdir(style_dir):
+        return None
+    candidates = []
+    for f in os.listdir(style_dir):
+        if not f.endswith('-design-spec.json'):
+            continue
+        path = os.path.join(style_dir, f)
+        try:
+            with open(path, encoding='utf-8') as fh:
+                spec = json.load(fh)
+        except Exception:
+            continue
+        req = (spec.get('requirement') or '').lower()
+        q = (query or '').lower()
+        spec_plat = (spec.get('platform') or '').lower()
+        # 匹配分: requirement 命中得高分, 否则低分
+        req_score = 10 if (q and q in req) else (5 if req else 0)
+        # 平台匹配加分 (同平台 spec 优先, 避免误用另一端的颜色)
+        plat_score = 3 if (platform and spec_plat == platform.lower()) else 0
+        score = req_score + plat_score
+        candidates.append((score, spec.get('imported_at', ''), spec))
+    if not candidates:
+        return None
+    candidates.sort(key=lambda x: (x[0], x[1]), reverse=True)
+    return candidates[0][2]
+
+
+def gen_menu_from_spec(spec, module_name, page_name):
+    """用 design-import 的 spec.layout/components 生成菜单骨架。
+
+    解析 spec 里关于侧边栏/菜单的自然语言描述 (如 "三级折叠, 二级手风琴",
+    "一级固定"), 生成对应 HTML 骨架。返回 (top_menu, sidebar_menu, tabs, logo_text)。
+    """
+    layout = spec.get('layout') or {}
+    comps = spec.get('components') or []
+    # 合并所有描述文本做关键词探测
+    desc_text = ' '.join([
+        layout.get('description', ''), layout.get('sidebar', ''), layout.get('content', '')
+    ] + [c.get('spec', '') for c in comps]).lower()
+
+    has_accordion = '手风琴' in desc_text or 'accordion' in desc_text
+    has_three = '三级' in desc_text or '3级' in desc_text
+    has_two = '二级' in desc_text or '2级' in desc_text
+
+    logo_text = '管理平台'
+    top_menu = (
+        '<div class="top-menu-item">{mod}</div>\n'
+        '        <div class="top-menu-item active">{mod}</div>'
+    ).format(mod=module_name)
+
+    # 侧边栏: 根据描述决定层级深度
+    parts = ['<div class="sidebar-item active">{page}</div>'.format(page=page_name)]
+    if has_three or has_accordion:
+        # 三级折叠 (spec 明确要求时) — 默认展开第一个
+        open_attr = ' open' if has_accordion else ''
+        parts.append(
+            '<details class="sidebar-group"{open}>\n'
+            '          <summary>二级菜单 (手风琴)</summary>\n'
+            '          <div class="sidebar-sub">\n'
+            '            <div class="sidebar-item">三级菜单-1</div>\n'
+            '            <div class="sidebar-item">三级菜单-2</div>\n'
+            '          </div>\n'
+            '        </details>'.format(open=open_attr)
+        )
+    elif has_two:
+        parts.append('<div class="sidebar-item">二级菜单</div>')
+    sidebar_menu = '\n        '.join(parts)
+
+    tabs = '<div class="tab-item active">{page} <span class="tab-close">×</span></div>'.format(page=page_name)
+    return top_menu, sidebar_menu, tabs, logo_text
+
+
+def gen_app_tabbar(query, sibling_modules=None):
+    """为 APP (Vant) 生成底部 TabBar (真实模块名 + Vant 字体图标)。
+
+    sibling_modules: [(cn, dir), ...] 来自 module-index。当前模块 active。
+    返回 tabbar HTML 字符串 (用 van-icon-* 字体图标, 绝不用 emoji)。
+    """
+    # 选 4 个 tab: 首页 + 当前模块 + 1-2 个相关模块 + 我的
+    others = [cn for cn, _ in (sibling_modules or []) if cn != query][:2]
+    items = ['<div class="tab-item active">\n      <i class="van-icon van-icon-wap-home-o tab-icon"></i><span>首页</span>\n    </div>']
+    if query:
+        items.append('<div class="tab-item">\n      <i class="van-icon van-icon-apps-o tab-icon"></i><span>%s</span>\n    </div>' % query)
+    for cn in others:
+        icon = 'van-icon-chart-trend-o' if '统计' in cn or '看板' in cn else 'van-icon-list-switching'
+        items.append('<div class="tab-item">\n      <i class="van-icon %s tab-icon"></i><span>%s</span>\n    </div>' % (icon, cn))
+    items.append('<div class="tab-item">\n      <i class="van-icon van-icon-user-o tab-icon"></i><span>我的</span>\n    </div>')
+    return '\n    '.join(items[:4])
+
+
+def main():
+    parser = argparse.ArgumentParser(description='用真实数据预填原型模板')
+    parser.add_argument('query', help='业务关键词 (如: 营业外合同)')
+    parser.add_argument('--platform', default='web', choices=['web', 'app'],
+                        help='平台 (默认 web)')
+    parser.add_argument('--type', default='table-page',
+                        choices=['table-page', 'form-page', 'detail-page', 'modal', 'dashboard'],
+                        help='页面类型 (默认 table-page)')
+    args = parser.parse_args()
+
+    # 平台守卫: 注意 --platform 有 default='web', 不能查 args.platform (永远非 None),
+    # 必须查 sys.argv 是否【显式】传了 --platform。否则违规调用会被默认值绕过。
+    from common.platform_guard import assert_platform_selected
+    assert_platform_selected(skill='wl-prd-full')
+
+    query = args.query.strip()
+    if not query:
+        print('Error: 关键词必填', file=sys.stderr)
+        return 1
+
+    # 1. 扩展查询词
+    words = expand_chinese_query(query)
+    if not words:
+        words = [query.lower()]
+    words_lower = [w.lower() for w in words]
+
+    # 2. 加载索引
+    style_index = load_index('ui-style.json') or {}
+    field_map = style_index.get('field_map') or {}
+
+    # 3. 找最佳参考页面
+    best_example, source_file = find_best_example(
+        words_lower, style_index, args.platform, args.type)
+
+    table_columns = []
+    form_fields = []
+    if best_example:
+        table_columns = best_example.get('table_columns', [])
+        form_fields = best_example.get('form_fields', [])
+
+    # 4. 从 field_map 补充相关字段
+    extra_fields = supplement_fields_from_map(words_lower, field_map, table_columns + form_fields)
+
+    # 4.5 从 entity-registry 提取真实按钮 (原型显示系统真实按钮文案, 不是 AI 编的)
+    real_buttons = extract_real_buttons(words_lower)
+
+    # 5. 读模板
+    template_name = 'prototype-web.html' if args.platform == 'web' else 'prototype-app.html'
+    template_path = os.path.join(TEMPLATE_DIR, template_name)
+    if not os.path.isfile(template_path):
+        print('Error: 模板不存在: {}'.format(template_path), file=sys.stderr)
+        return 1
+    with open(template_path, encoding='utf-8') as f:
+        template = f.read()
+
+    # 6. 填模板
+    module_name, module_dir = resolve_module_name(query, source_file, args.platform)
+    search_form_html = gen_search_form_html(form_fields, extra_fields)
+    headers_html, rows_html = gen_table_html(table_columns, extra_fields)
+
+    # 菜单骨架优先级: design-import spec > 布局指纹(mixed-nav) > 技术栈推测 > 诚实降级
+    # (design-import SKILL.md:72 "spec 优先级 > 代码风格 > PDF")
+    spec = load_design_spec(query, args.platform)
+    fp = get_layout_fingerprint(style_index, args.platform)
+    stack = (fp or {}).get('stack', 'unknown')
+    style_warning = ''  # 非空时表示风格不可靠, 需提示用户
+
+    if spec:
+        # 有设计规格: 用 spec 驱动菜单骨架 + token
+        top_menu, sidebar_menu, tabs, logo_text = gen_menu_from_spec(
+            spec, module_name, query)
+    elif fp and fp.get('layout') == 'mixed-nav':
+        # 无 spec 但项目是 mixed-nav (如 ICS): 用指纹示例骨架 + 真实兄弟模块名
+        mod_index = load_index('ui-modules.json') or {}
+        proj_name = get_platform_map().get(args.platform)
+        mods = (mod_index.get('projects') or {}).get(proj_name, [])
+        siblings = [(m['cn'], m['dir']) for m in mods if m.get('cn') != module_name]
+        top_menu, sidebar_menu, tabs, logo_text = gen_mixed_nav_menu(
+            module_name, query, siblings)
+    elif stack in ('vben-admin', 'ant-design-vue', 'element-plus', 'vant-mobile'):
+        # 无布局指纹但检测到技术栈: 给推测骨架, 标记低置信度让 AI 知道这是猜测
+        if args.platform == 'app' or stack == 'vant-mobile':
+            top_menu, sidebar_menu, tabs = '', '', ''
+            logo_text = '管理平台'
+        else:
+            top_menu, sidebar_menu, tabs, logo_text = gen_mixed_nav_menu(
+                module_name, query)
+        style_warning = (
+            '检测到技术栈: {} — 但没有 preferences.ts/设计稿, 骨架基于推测 (低置信度)。'
+            '请提供 1 个现有页面 URL/截图/设计稿, 我才能贴合你的真实风格。'.format(stack)
+        )
+    else:
+        # 完全未知: 不硬画, 诚实提示
+        top_menu, sidebar_menu, tabs, logo_text = '', '', '', '管理平台'
+        style_warning = (
+            '未检测到技术栈和风格参考 (stack={})。原型用通用占位骨架, 请勿直接使用。'
+            '请提供现有页面 URL/截图/设计稿, 或用 /design-import 录入设计规格。'.format(stack)
+        )
+    is_mixed = bool(spec or (fp and fp.get('layout') == 'mixed-nav'))
+
+    # 若 spec 提供了 design_tokens (--primary-color 等), 覆盖模板 :root
+    spec_tokens_html = ''
+    if spec and spec.get('design_tokens'):
+        token_lines = []
+        for var, val in spec['design_tokens'].items():
+            # spec 用 CSS 变量名 (--primary-color), 模板用 HSL 分量 (--primary)
+            # 直接注入额外变量, AI 微调时按需映射
+            token_lines.append('      %s: %s;' % (var, val))
+        if token_lines:
+            spec_tokens_html = '    /* design-import spec tokens (优先级最高) */\n' + '\n'.join(token_lines) + '\n'
+
+    filled = template
+    # 注入 spec token (若有) 到 :root 末尾
+    if spec_tokens_html:
+        # 锚点优先级: 通用锚点 (app+web 都有) > web 专用 mixed-nav > 兜底 :root 闭合
+        # (历史 bug: 旧版只认 mixed-nav 锚点, app 模板没有 → APP 端 spec 注入静默失败)
+        injected = False
+        for anchor in ('    /* design-import spec tokens anchor',
+                       '    /* mixed-nav shell widths'):
+            if anchor in filled:
+                filled = filled.replace(anchor, spec_tokens_html + '\n' + anchor, 1)
+                injected = True
+                break
+        if not injected:
+            # 兜底: 在第一个 :root { ... } 的闭合 } 前注入 (正则, 容错)
+            import re as _re
+            filled = _re.sub(r'(\s*:root\s*\{[^}]*?)(\n    \})',
+                             lambda m: m.group(1) + '\n' + spec_tokens_html.rstrip() + m.group(2),
+                             filled, count=1)
+    # inject layout_fingerprint real layout params (sidebar/topbar width)
+    # so AI does not guess widths - uses real values from ui-style.json
+    if fp:
+        _fp_ov = []
+        if str(fp.get('sidebar_width', '')).strip().isdigit():
+            _fp_ov.append('      --sidebar-width: {}px;'.format(fp['sidebar_width']))
+        if str(fp.get('topbar_height', '')).strip().isdigit():
+            _fp_ov.append('      --topbar-height: {}px;'.format(fp['topbar_height']))
+        if _fp_ov:
+            _fp_h = '    /* layout_fingerprint real layout (from ui-style.json) */' + chr(10) + chr(10).join(_fp_ov) + chr(10)
+            filled = filled.replace('    /* mixed-nav shell widths', _fp_h + '    /* mixed-nav shell widths')
+    filled = filled.replace('{{TITLE}}', query)
+    filled = filled.replace('{{LOGO_TEXT}}', logo_text)
+    filled = filled.replace('{{MODULE_NAME}}', module_name)
+    filled = filled.replace('{{PAGE_NAME}}', query)
+    filled = filled.replace('{{TOP_MENU}}', top_menu)
+    filled = filled.replace('{{SIDEBAR_MENU}}', sidebar_menu)
+    filled = filled.replace('{{TABS}}', tabs)
+    filled = filled.replace('{{SEARCH_FORM_FIELDS}}', search_form_html)
+    filled = filled.replace('{{TABLE_HEADERS}}', headers_html)
+    filled = filled.replace('{{TABLE_ROWS}}', rows_html)
+
+    # APP 专属占位符 (Vant tabbar + 主色)
+    if args.platform == 'app':
+        mod_index = load_index('ui-modules.json') or {}
+        proj_name = get_platform_map().get(args.platform)
+        mods = (mod_index.get('projects') or {}).get(proj_name, [])
+        siblings = [(m['cn'], m['dir']) for m in mods]
+        tabbar_html = gen_app_tabbar(module_name, siblings)
+        filled = filled.replace('{{TAB_BAR_ITEMS}}', tabbar_html)
+        filled = filled.replace('{{APP_PRIMARY}}', '#1989fa')
+    else:
+        # Web 模板无这些占位符, 无副作用
+        filled = filled.replace('{{TAB_BAR_ITEMS}}', '')
+        filled = filled.replace('{{APP_PRIMARY}}', '#1989fa')
+
+    # 7. 输出数据清单 (让 AI 知道用了什么真实数据)
+    print('=' * 60)
+    print('原型预填完成: {} ({} {})'.format(query, args.platform, args.type))
+    print('=' * 60)
+    print()
+    print('## 数据清单 (所有数据来自真实代码, 非编造)')
+    print()
+    if source_file:
+        print('参考页面: {}'.format(source_file))
+    else:
+        print('参考页面: (无精确匹配, 用模板默认值)')
+    print()
+
+    print('表格列 ({} 个, 来自真实代码):'.format(len(table_columns)))
+    for col in table_columns[:8]:
+        print('  - {} ({})'.format(col.get('title', '?'), col.get('field', '?')))
+    if len(table_columns) > 8:
+        print('  ... 共 {} 个'.format(len(table_columns)))
+    print()
+
+    print('表单字段 ({} 个):'.format(len(form_fields)))
+    for f in form_fields[:6]:
+        print('  - {} ({})'.format(f.get('label', '?'), f.get('field', '?')))
+    print()
+
+    if extra_fields:
+        print('field_map 补充字段 ({} 个, 关键词匹配):'.format(len(extra_fields)))
+        for e in extra_fields:
+            print('  - {} ({})'.format(e['title'], e['field']))
+        print()
+
+    # 真实按钮 (来自 entity-registry, 原型用这些文案而非 AI 编的)
+    if real_buttons:
+        print('真实按钮 ({} 个, 来自 entity-registry → 原型用这些文案):'.format(len(real_buttons)))
+        for b in real_buttons:
+            endpoint_str = ' → ' + b['endpoint'] if b['endpoint'] else ''
+            print('  - {}{}'.format(b['text'], endpoint_str))
+        print()
+    else:
+        print('真实按钮: (无精确匹配, 用通用文案: 新增/导出/导入/批量操作)')
+        print()
+
+    # 设计规格 (design-import spec) — 最高优先级, 有就用它
+    if spec:
+        print('★ 设计规格 (design-import spec, 优先级最高):')
+        print('  来源: {}'.format(spec.get('source', '?')))
+        print('  需求: {}'.format(spec.get('requirement', '?')))
+        layout = spec.get('layout') or {}
+        if layout.get('description'):
+            print('  布局: {}'.format(layout['description']))
+        comps = spec.get('components') or []
+        for c in comps:
+            if '菜单' in c.get('name', '') or 'menu' in c.get('name', '').lower():
+                print('  菜单组件: {}'.format(c.get('spec', '')))
+        if spec.get('design_tokens'):
+            print('  自定义 token 已注入模板 :root (见 HTML 注释)')
+        print('  ⚠️ 已按 spec 生成菜单骨架, 微调时保持 spec 描述的层级/折叠方式')
+        print()
+
+    # 风格不可靠警告 (技术栈推测或完全未知时)
+    if style_warning:
+        print('⚠️ 风格置信度低:')
+        print('  ' + style_warning)
+        print()
+
+    print('设计 Token: 继承模板 ({})'.format(template_name))
+    if fp:
+        print('  布局模式: {} (来自 style-index layout_fingerprint)'.format(fp.get('layout', '?')))
+        print('  路由模式: {} (backend=菜单来自后端接口, 需按 PRD 填菜单树)'.format(fp.get('access_mode', '?')))
+        if fp.get('sidebar_width'):
+            print('  侧边栏宽度: {}px'.format(fp['sidebar_width']))
+        if fp.get('color_primary'):
+            print('  主色: {} (Vben HSL, 已写入模板 :root, 勿改)'.format(fp['color_primary']))
+        print('  禁止: #1890ff (Ant Design 默认色, 非 Vben)')
+    elif args.platform == 'web':
+        print('  主色: hsl(214.58 86.34% 59.8%) (Vben, 模板内置, 勿改)')
+        print('  禁止: #1890ff (Ant Design 默认色, 非 Vben)')
+    print()
+    print('## AI 微调指南 (你只需做 20%)')
+    print('  1. 确认表格列/字段是否符合需求 (增删列)')
+    if is_mixed:
+        print('  2. ⚠️ 菜单层级: 模板已填 mixed-nav 示例骨架 (一级顶栏/二级侧栏/三级折叠/标签页)。')
+        print('     若 PRD 描述了侧边栏/菜单结构, 按它替换示例菜单, 不要退化成扁平单级!')
+        print('  3. 补充交互细节 (弹窗/Tab切换/三级折叠)')
+    else:
+        print('  2. 补充交互细节 (如侧边栏折叠/弹窗/Tab切换)')
+    print('  4. ⚠️ token (颜色/间距) 已正确, 不要改!')
+    print()
+
+    # 8. 输出 HTML 草稿 (用分隔符标记, AI 能识别)
+    print('## 预填 HTML 草稿 (80% 完成, 复制后微调)')
+    print('```html')
+    print(filled)
+    print('```')
+
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())