@hupan56/wlkj 2.0.0

package/templates/qoder/scripts/common/terms.py

@@ -0,0 +1,234 @@
+# -*- coding: utf-8 -*-
+"""
+Unified business term mappings - SINGLE SOURCE OF TRUTH.
+
+Used by BOTH index builders (git_sync.py, parse_prds.py) and
+index consumers (search_index.py). Do NOT define local copies
+of these maps in other scripts - import from here.
+"""
+
+# Chinese term -> space-separated English search words.
+# Used for keyword search expansion.
+# 性能优化 A6: 从 40 词扩展到 ~120 词, 覆盖库存/采购/供应商/客户/财务/工单等通用业务域
+CN_MAP = {
+    # 考勤/人事
+    '考勤': 'attendance clock', '打卡': 'clock', '签到': 'sign',
+    '薪资': 'salary', '工资': 'salary', '请假': 'leave', '休假': 'leave',
+    '加班': 'overtime', '员工': 'employee staff', '用户': 'user',
+    '组织': 'org department', '部门': 'department', '岗位': 'position role',
+    '招聘': 'recruit hire', '培训': 'train training', '绩效': 'performance kpi',
+    '考勤机': 'clock device', '排班': 'schedule shift', '调班': 'shift change',
+    # 车辆/设备
+    '车辆': 'vehicle car', '设备': 'equipment asset device',
+    '资产': 'asset', '维修': 'maintain repair', '保养': 'maintenance',
+    '保险': 'insurance', '安全': 'safety', '年检': 'inspection annual',
+    '油耗': 'fuel oil', '里程': 'mileage distance', '行驶': 'drive travel',
+    '驾驶员': 'driver', '车队': 'fleet', '违章': 'violation traffic',
+    '事故': 'accident', 'GPS': 'gps location track',
+    # 品质/巡查
+    '品质': 'quality', '巡查': 'inspection patrol', '巡检': 'inspection patrol',
+    '检查': 'check inspect', '隐患': 'hazard risk', '整改': 'rectify fix',
+    '监控': 'monitor video', '告警': 'alarm alert', '预警': 'warning alert',
+    # 业务运营
+    '订单': 'order', '合同': 'contract', '项目': 'project',
+    '任务': 'task job', '工单': 'work order ticket',
+    '审批': 'approval audit', '流程': 'process workflow',
+    '报表': 'report', '统计': 'statistics stats', '分析': 'analysis',
+    '日志': 'log journal', '记录': 'record log',
+    '预算': 'budget', '费用': 'cost expense', '账单': 'bill invoice',
+    '结算': 'settlement', '报销': 'reimbursement expense',
+    # 库存/采购/供应链 (新增, A6)
+    '库存': 'inventory stock', '入库': 'inbound stockin warehouse',
+    '出库': 'outbound stockout', '盘点': 'inventory count check',
+    '采购': 'purchase procurement', '供应商': 'supplier vendor',
+    '物料': 'material item', '仓库': 'warehouse storage',
+    '调拨': 'transfer allocate', '领用': 'requisition issue',
+    # 客户/销售 (新增)
+    '客户': 'customer client', '销售': 'sale sell',
+    '报价': 'quote quotation', '商机': 'opportunity lead',
+    '联系人': 'contact', '回访': 'followup callback',
+    # 财务 (新增)
+    '发票': 'invoice receipt', '付款': 'payment pay',
+    '收款': 'receipt payment', '对账': 'reconcile reconciliation',
+    '税务': 'tax', '成本': 'cost', '利润': 'profit revenue',
+    '凭证': 'voucher certificate',
+    # 系统/权限
+    '权限': 'permission role', '角色': 'role', '登录': 'login auth',
+    '密码': 'password', '菜单': 'menu', '字典': 'dictionary dict',
+    '配置': 'config setting', '参数': 'param config',
+    '通知': 'notify notification', '消息': 'message notify',
+    '导入': 'import upload', '导出': 'export download',
+    # 通用
+    '在线率': 'online onlineRate', '状态': 'status state',
+    '版本': 'version', '模板': 'template', '标签': 'label tag',
+    '分类': 'category classify', '类型': 'type',
+    '地区': 'region area', '区域': 'zone region',
+    '时间': 'time date', '日期': 'date',
+}
+
+# Chinese business term -> code path/identifier patterns.
+# Used for PRD <-> code mapping AND keyword search expansion,
+# so building and querying use the same semantics.
+BUSINESS_PATH_MAP = {
+    '保险': ['insurance', 'Insurance', 'ins-', '/ins/', 'vehlife/insurance'],
+    '考勤': ['attendance', 'Attendance', 'clock', 'Clock', 'time/clock', 'TimeClock'],
+    '打卡': ['clock', 'Clock', 'photoClock', 'PhotoClock'],
+    '车辆': ['vehicle', 'Vehicle', 'veh', 'vehlife', '/veh/'],
+    '品质': ['quality', 'Quality', 'QualityInspection', 'patrol', 'Patrol'],
+    '巡查': ['inspection', 'Inspection', 'patrol', 'Patrol'],
+    '资产': ['asset', 'Asset', '/asset/'],
+    '设备': ['equipment', 'Equipment', 'device', 'Device'],
+    '维修': ['maintain', 'Maintain', 'repair', 'Repair', 'maintenance'],
+    '排班': ['schedule', 'Schedule', 'shift', 'Shift'],
+    '请假': ['leave', 'Leave', 'holiday', 'Holiday'],
+    '审批': ['approval', 'Approval', 'audit', 'Audit', 'workflow'],
+    '在线率': ['online', 'Online', 'onlineRate', 'OnlineRate'],
+    '告警': ['alarm', 'Alarm', 'alert', 'Alert'],
+    '油耗': ['fuel', 'Fuel', 'oil', 'Oil', 'oilConsumption'],
+    '里程': ['mileage', 'Mileage', 'distance', 'Distance'],
+    '薪资': ['salary', 'Salary', 'wage', 'Wage', 'pay', 'Pay'],
+    '报表': ['report', 'Report', 'statistics', 'Statistics'],
+    '统计': ['statistics', 'Statistics', 'stats', 'Stats'],
+    '年检': ['inspection', 'Inspection', 'annual', 'Annual', 'vehInspection'],
+    '预算': ['budget', 'Budget'],
+    '费用': ['cost', 'Cost', 'expense', 'Expense'],
+    '安全': ['safety', 'Safety', 'safe', 'Safe', 'ehs'],
+    '监控': ['monitor', 'Monitor', 'video', 'Video'],
+    'GPS': ['gps', 'GPS', 'location', 'Location', 'track', 'Track'],
+    '合同': ['contract', 'Contract'],
+    '组织': ['org', 'Org', 'department', 'Department'],
+    '员工': ['employee', 'Employee', 'staff', 'Staff', 'personnel'],
+    '权限': ['permission', 'Permission', 'role', 'Role', 'auth'],
+    '流程': ['workflow', 'Workflow', 'process', 'Process'],
+    # 新增 (A6 扩展)
+    '库存': ['inventory', 'Inventory', 'stock', 'Stock', '/stock/'],
+    '入库': ['inbound', 'Inbound', 'stockIn', 'StockIn'],
+    '出库': ['outbound', 'Outbound', 'stockOut', 'StockOut'],
+    '盘点': ['inventory', 'Inventory', 'count', 'Count', 'check', 'Check'],
+    '采购': ['purchase', 'Purchase', 'procurement', 'Procurement'],
+    '供应商': ['supplier', 'Supplier', 'vendor', 'Vendor'],
+    '仓库': ['warehouse', 'Warehouse', 'storage', 'Storage'],
+    '客户': ['customer', 'Customer', 'client', 'Client'],
+    '销售': ['sale', 'Sale', 'sell', 'Sell'],
+    '发票': ['invoice', 'Invoice', 'receipt', 'Receipt'],
+    '付款': ['payment', 'Payment', 'pay', 'Pay'],
+    '对账': ['reconcile', 'Reconcile', 'reconciliation'],
+    '登录': ['login', 'Login', 'auth', 'Auth', 'signin'],
+    '导入': ['import', 'Import', 'upload', 'Upload'],
+    '导出': ['export', 'Export', 'download', 'Download'],
+    '通知': ['notify', 'Notify', 'notification', 'Notification'],
+    '消息': ['message', 'Message', 'notify', 'Notify'],
+    '配置': ['config', 'Config', 'setting', 'Setting'],
+    '字典': ['dict', 'Dict', 'dictionary', 'Dictionary'],
+}
+
+# Chinese term -> single primary English keyword (derived from CN_MAP).
+# Used by PRD parsing where one canonical keyword is needed.
+CN_TO_EN = {cn: words.split()[0] for cn, words in CN_MAP.items()}
+
+
+def auto_expand_from_prds(prd_index_path=None, min_freq=2):
+    """从已收集的 PRD 自动挖掘高频中文业务词 (性能优化 A6)。
+
+    扫描 prd-index.json 的 cn_terms 字段, 把出现 ≥ min_freq 次且不在
+    静态 CN_MAP 里的词加到运行时映射 (不写回静态文件)。
+
+    Returns:
+        dict: 新增的 {cn: en_guess} 映射 (合并到 CN_MAP 运行时副本)。
+    """
+    import os as _os
+    import json as _json
+    if prd_index_path is None:
+        base = _os.path.dirname(_os.path.dirname(_os.path.dirname(
+            _os.path.dirname(_os.path.abspath(__file__)))))
+        prd_index_path = _os.path.join(base, 'data', 'index', 'prd-index.json')
+
+    extra = {}
+    try:
+        if not _os.path.isfile(prd_index_path):
+            return extra
+        with open(prd_index_path, encoding='utf-8') as f:
+            prd_idx = _json.load(f)
+        freq = {}
+        for prd_file, prd in prd_idx.items():
+            for term in (prd.get('cn_terms') or []):
+                term = str(term).strip()
+                if term and len(term) >= 2:
+                    freq[term] = freq.get(term, 0) + 1
+        for term, count in freq.items():
+            if count >= min_freq and term not in CN_MAP:
+                # 猜测: 用拼音首字母或直接小写 (无法转拼音就用原词小写)
+                # 简单方案: 直接 lowercase, 让英文索引做子串匹配
+                extra[term] = term.lower()
+    except Exception:
+        pass
+    return extra
+
+
+def get_cn_map_with_auto():
+    """返回静态 CN_MAP + PRD 自动挖掘的扩展 (运行时合并, 不写文件)。"""
+    merged = dict(CN_MAP)
+    merged.update(auto_expand_from_prds())
+    return merged
+
+# Stop words filtered out when extracting business terms from PRD text.
+# (Union of the lists previously duplicated in git_sync.py / parse_prds.py)
+PRD_STOP_WORDS = {
+    '需要', '可以', '使用', '进行', '功能', '实现', '显示', '支持', '包括', '或者',
+    '以及', '如果', '那么', '但是', '因为', '所以', '用户', '系统', '页面', '数据',
+    '信息', '操作', '管理', '列表', '详情', '新增', '修改', '删除', '查询', '搜索',
+    '筛选', '点击', '选择', '输入', '确认', '取消', '保存', '提交', '返回', '跳转',
+    '当前', '前端', '后端', '影响', '范围', '下拉', '条件', '字段', '全部', '异常',
+    '正常', '记录', '面板', '统计', '表页', '搜索表', '与其他', '表单', '背景',
+    '一个', '这个', '那个', '通过', '根据', '按照', '同时', '并且',
+    '要求', '需求', '描述', '说明', '备注', '注意', '重要', '优先', '级别',
+    '方案', '设计', '开发', '测试', '上线', '版本', '迭代', '更新', '发布',
+}
+
+# Platform alias -> project directory name under data/code/.
+# DEFAULTS for this repo; overridden/extended by config.yaml `platforms:`
+# (use get_platform_map() instead of reading this directly).
+PLATFORM_MAP = {
+    'web': 'fywl-ui', 'app': 'Carmg-H5', 'mobile': 'Carmg-H5',
+    'h5': 'Carmg-H5', 'pc': 'fywl-ui',
+    '管理端': 'fywl-ui', '移动端': 'Carmg-H5', '后台': 'fywl-ui',
+}
+
+_platform_cache = None
+
+
+def get_platform_map():
+    """Platform map merged from config.yaml (platforms:) over defaults.
+
+    config.yaml format:
+      platforms:
+        web: { project: fywl-ui, aliases: [pc, 管理端] }
+    This makes the knowledge graph portable to OTHER projects: point
+    config at different project dirs without touching code.
+    """
+    global _platform_cache
+    if _platform_cache is not None:
+        return _platform_cache
+    merged = dict(PLATFORM_MAP)
+    try:
+        import os
+        import yaml
+        base = os.path.dirname(os.path.dirname(os.path.dirname(
+            os.path.dirname(os.path.abspath(__file__)))))
+        cfg_path = os.path.join(base, '.qoder', 'config.yaml')
+        if os.path.isfile(cfg_path):
+            with open(cfg_path, encoding='utf-8') as f:
+                cfg = yaml.safe_load(f) or {}
+            platforms = cfg.get('platforms') or {}
+            if platforms:
+                merged = {}  # config fully defines the map when present
+                for key, p in platforms.items():
+                    if not isinstance(p, dict) or not p.get('project'):
+                        continue
+                    merged[key.lower()] = p['project']
+                    for alias in (p.get('aliases') or []):
+                        merged[str(alias).lower()] = p['project']
+    except Exception:
+        pass  # fall back to hardcoded defaults
+    _platform_cache = merged
+    return merged

package/templates/qoder/scripts/common/utf8.py

@@ -0,0 +1,38 @@
+# -*- coding: utf-8 -*-
+"""
+utf8.py - 统一的 stdout/stderr UTF-8 配置 (防御性)
+
+解决审计 C2: 10 个脚本的裸 sys.stdout.reconfigure(encoding='utf-8') 在
+stdout 被捕获时 (Qoder IDE 内嵌终端/管道) 会 AttributeError 崩溃。
+
+用法 (替换裸 reconfigure):
+    from common.utf8 import ensure_utf8_stdio
+    ensure_utf8_stdio()
+"""
+
+import sys
+
+
+def ensure_utf8_stdio() -> None:
+    """把 stdout/stderr 切到 UTF-8, 失败则忽略 (不崩溃)。
+
+    安全性:
+    - TextIOWrapper 有 reconfigure -> 切换
+    - 其他类型 (管道包装/None) -> 静默跳过
+    - 永远不抛异常
+    """
+    for stream_name in ("stdout", "stderr"):
+        stream = getattr(sys, stream_name, None)
+        if stream is None:
+            continue
+        reconfigure = getattr(stream, "reconfigure", None)
+        if reconfigure is None:
+            continue  # 不是 TextIOWrapper, 跳过
+        try:
+            reconfigure(encoding="utf-8", errors="replace")
+        except (TypeError, ValueError, OSError, IOError):
+            # errors 参数不支持或底层不可重配 -> 尝试仅 encoding
+            try:
+                reconfigure(encoding="utf-8")
+            except Exception:
+                pass  # 彻底失败也不阻塞脚本主逻辑

package/templates/qoder/scripts/context_pack.py

@@ -0,0 +1,196 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+QODER Context Pack - 一次调用返回写 PRD/原型所需的全部上下文
+
+替代原来的 5-6 次 search_index.py 调用, 大幅减少 AI 工具往返次数。
+
+Usage:
+  python context_pack.py <业务关键词> [--platform web|app|both] [--type table|form|detail|modal|dashboard]
+
+输出 (markdown, 供 AI 直接消化):
+  1. 相关代码文件 (keyword-index, 平台过滤)
+  2. 同类型页面真实示例 (style-index page_examples)
+  3. 相关字段规格 (field_map: 字段名->中文标题->样例文件)
+  4. 相关历史 PRD (prd-index)
+  5. 相关 API 端点 (api-index)
+  6. 设计 Token / 图标 / 模板 路径速查
+  7. Repo Wiki 提示 (如存在)
+"""
+
+import os
+import sys
+import json
+
+# UTF-8 stdio (防御性: stdout 被捕获时不崩溃)
+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 CN_MAP, BUSINESS_PATH_MAP, CN_TO_EN, 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')
+PLATFORM_MAP = get_platform_map()
+MIN_FUZZY_LEN = 4
+
+
+def load(filename):
+    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 expand_query(query):
+    words = []
+    if query in CN_MAP:
+        words.extend(CN_MAP[query].split())
+    if query in BUSINESS_PATH_MAP:
+        words.extend(p.strip('/-').lower() for p in BUSINESS_PATH_MAP[query])
+    return sorted(set(w.lower() for w in words)) or [query.lower()]
+
+
+def match_kw(word, kw):
+    w, k = word.lower(), kw.lower()
+    return w == k or (len(k) >= MIN_FUZZY_LEN and k in w) or (len(w) >= MIN_FUZZY_LEN and w in k)
+
+
+def plat_filter(files, target):
+    if not target:
+        return files
+    return [f for f in files if target.lower() in f.lower()]
+
+
+def main():
+    args = sys.argv[1:]
+    platform = None
+    page_type = None
+    if '--platform' in args:
+        i = args.index('--platform')
+        platform = args[i + 1] if i + 1 < len(args) else None
+        args = args[:i] + args[i + 2:]
+    if '--type' in args:
+        i = args.index('--type')
+        page_type = args[i + 1] if i + 1 < len(args) else None
+        args = args[:i] + args[i + 2:]
+    if not args:
+        print(__doc__)
+        return 1
+    query = args[0]
+
+    targets = []
+    if platform and platform.lower() not in ('both', '两端'):
+        targets = [PLATFORM_MAP.get(platform.lower(), platform)]
+    elif platform:
+        targets = sorted(set(PLATFORM_MAP.values()))
+
+    words = expand_query(query)
+    print('# Context Pack: {} (platform: {})'.format(query, platform or 'all'))
+    print('搜索词扩展: ' + ' '.join(words))
+
+    # ---- 1. 相关代码文件 ----
+    ki = load('keyword-index.json') or {}
+    hits = {}
+    for word in words:
+        for kw, files in ki.items():
+            if match_kw(word, kw):
+                fs = files if not targets else [f for t in targets for f in plat_filter(files, t)]
+                for f in fs:
+                    hits.setdefault(f, set()).add(kw)
+    ranked = sorted(hits.items(), key=lambda x: len(x[1]), reverse=True)[:12]
+    print('\n## 1. 相关代码文件 ({} 个, 取前 12)'.format(len(hits)))
+    for f, kws in ranked:
+        print('- {} (命中: {})'.format(f, ','.join(sorted(kws)[:3])))
+    if not hits:
+        print('- (无命中 — 换业务词重试, 或该功能为全新)')
+
+    # ---- 2. 同类型页面真实示例 ----
+    si = load('style-index.json') or {}
+    print('\n## 2. 同类页面示例 (风格锚点, 读 1-2 个)')
+    for proj, pdata in sorted((si.get('projects') or {}).items()):
+        if targets and proj not in targets:
+            continue
+        examples = pdata.get('page_examples', {})
+        for pt, fs in sorted(examples.items()):
+            if page_type and page_type.lower() not in pt.lower():
+                continue
+            if not page_type and pt == 'unknown':
+                continue
+            print('- [{}] {}: {}'.format(proj, pt, ' | '.join(fs[:3])))
+
+    # ---- 3. 相关字段规格 ----
+    fm = si.get('field_map') or {}
+    fhits = []
+    for field, info in fm.items():
+        fl = field.lower()
+        if any(w in fl for w in words if len(w) >= MIN_FUZZY_LEN):
+            fhits.append((info.get('count', 0), field, info))
+    fhits.sort(reverse=True)
+    print('\n## 3. 相关字段 (真实字段名->中文标题)')
+    for cnt, field, info in fhits[:10]:
+        print('- {} -> {} ({}x)'.format(field, '/'.join(info.get('titles', [])[:3]), cnt))
+    if not fhits:
+        print('- (无直接相关字段)')
+
+    # ---- 4. 相关历史 PRD ----
+    prds = load('prd-index.json') or {}
+    phits = []
+    for pf, prd in prds.items():
+        text = (prd.get('title', '') + ' ' + ' '.join(prd.get('keywords', []))).lower()
+        score = sum(2 for w in words if w in text) + (5 if query in prd.get('title', '') else 0)
+        if score:
+            phits.append((score, pf, prd.get('title', pf)))
+    phits.sort(reverse=True)
+    print('\n## 4. 相关历史 PRD (data/docs/prd/)')
+    for s, pf, title in phits[:5]:
+        print('- {} - {}'.format(pf, title[:60]))
+    if not phits:
+        print('- (无相关 PRD)')
+
+    # ---- 5. 相关 API ----
+    apis = load('api-index.json') or {}
+    ahits = [(ep, f) for ep, f in apis.items()
+             if any(w in ep.lower() or w in f.lower() for w in words if len(w) >= MIN_FUZZY_LEN)]
+    print('\n## 5. 相关 API (取前 8 / 共 {})'.format(len(ahits)))
+    for ep, f in sorted(ahits)[:8]:
+        print('- {} -> {}'.format(ep, f.split('/')[-1]))
+    if not ahits:
+        print('- (无相关 API)')
+
+    # ---- 6. 风格/图标/模板速查 ----
+    print('\n## 6. 风格真源速查')
+    print('- Web Token: data/index/vben-style-reference.json (primary=hsl(212 100% 45%))')
+    print('- 看板/大屏: data/index/chart-style-reference.json (大屏深蓝风 monitor / 浅色卡片风 workbench)')
+    print('- 图标 (禁 emoji): data/index/icon-reference.json (Web=antd 内联SVG, APP=vant 字体)')
+    print('- 模板: .qoder/templates/prototype-web.html / prototype-app.html')
+    print('- PRD 模板: .qoder/templates/prd-full-template.md / prd-quick-template.md')
+
+    # ---- 7. Repo Wiki ----
+    wikis = []
+    if os.path.isdir(os.path.join(BASE, '.qoder', 'repowiki')):
+        wikis.append('.qoder/repowiki/')
+    code_dir = os.path.join(BASE, 'data', 'code')
+    if os.path.isdir(code_dir):
+        for p in sorted(os.listdir(code_dir)):
+            if os.path.isdir(os.path.join(code_dir, p, '.qoder', 'repowiki')):
+                wikis.append('data/code/{}/.qoder/repowiki/'.format(p))
+    if wikis:
+        print('\n## 7. Repo Wiki 可用 (模块级文档, 优先参考)')
+        for w in wikis:
+            print('- ' + w)
+
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())