@hupan56/wlkj 2.7.11 → 3.0.0

package/templates/qoder/scripts/{eval_prd.py → report/eval_prd.py}

@@ -1,5 +1,11 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
+# v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
+import os as _o, sys as _s
+_cp = _o.path.join(_o.path.dirname(_o.path.dirname(_o.path.abspath(__file__))), 'common')
+if _cp not in _s.path: _s.path.insert(0, _cp)
+from bootstrap import setup; setup()
+
 """
 QODER EVA - PRD/原型 自动评估 (快且准的"准"侧自动指标)
 
@@ -14,7 +20,7 @@ Usage:
   A3 模板完整 (30分): PRD 包含团队模板必需章节的比例
      -> 保证团队章程的模板结构不丢
 
-结果追加到 .qoder/learning/eval-history.jsonl (本机), 供 /wl-status 趋势展示。
+结果追加到 data/learning/eval-history.jsonl (本机), 供 /wl-status 趋势展示。
 Exit: 0 = 总分>=80, 1 = 不达标 (发布前应修复)
 """
 
@@ -36,7 +42,7 @@ sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
 BASE = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
 INDEX_DIR = os.path.join(BASE, 'data', 'index')
 TPL_DIR = os.path.join(BASE, '.qoder', 'templates')
-HISTORY = os.path.join(BASE, '.qoder', 'learning', 'eval-history.jsonl')
+HISTORY = os.path.join(BASE, 'data', 'learning', 'eval-history.jsonl')
 
 # 完整模板必需章节 (prd-full-template.md) / Mini 模板必需章节
 FULL_SECTIONS = ['版本信息', '变更日志', '名词解释', '需求背景', '需求来源', '产品现状',
@@ -185,10 +191,17 @@ def score_reality(prd_text):
     if checked == 0:
         return 1.0, '未引用具体字段/API (零星文案类需求正常)', []
     ratio = hits / checked
+    # 图谱覆盖度感知: 防止"认真写 API 引用但图谱没覆盖"比"啥都不写"分还低。
+    kg_api_count = len(api_paths)
+    if kg_api_count < 10 and ratio < 0.5 and hits == 0:
+        ratio = max(ratio, 0.5)
+        note_suffix = '(图谱API稀疏, 已软保底)'
+    else:
+        note_suffix = ''
     db_note = ('，其中 %d 个由数据库层确认' % db_bonus) if db_bonus else ''
     layer_note = ('(双层: 代码+数据库)' if db_cols else '(代码层)')
-    return ratio, '{}/{} 个字段/API 引用可在图谱中找到{}{}'.format(
-        hits, checked, layer_note, db_note), misses[:8]
+    return ratio, '{}/{} 个字段/API 引用可在图谱中找到{}{}{}'.format(
+        hits, checked, layer_note, db_note, note_suffix), misses[:8]
 
 
 # ============================================================
@@ -257,6 +270,13 @@ def score_template(prd_text):
 # ============================================================
 
 def main():
+    """v3.0: 接入 Result + contract 校验 (让设计模式真落地)。
+
+    改动:
+    1. 评估前先 validate_contract (软校验, 无契约头降级不阻塞)
+    2. 用 Result 表达三级结果 (PASS/WARN/FAIL), 替代裸 return 0/1
+    3. graceful_error 装饰器统一输出
+    """
     if len(sys.argv) < 2:
         print(__doc__)
         return 1
@@ -264,9 +284,35 @@ def main():
     html_path = sys.argv[2] if len(sys.argv) > 2 else None
 
     if not os.path.isfile(prd_path):
-        print('PRD 不存在: ' + prd_path)
+        print('[FAIL] PRD 不存在: ' + prd_path)
         return 1
 
+    # v3.0 接入: 角色边界校验 (guard.py, 软提示不阻塞)
+    # eval_prd 是 PRD 发布的必经质量门, 在这里检查"当前角色能否产出 prd"
+    # 越权 → 打印提示但不 return(降级, 让用户自己决定是否继续)
+    try:
+        from common.guard import check_produce
+        gr = check_produce('prd')
+        if gr.is_warn:
+            print(gr.msg)
+            if gr.hint:
+                print('  -> ' + gr.hint)
+    except Exception:
+        pass  # guard 不可用不影响评估
+
+    # v3.0 接入: 契约校验 (软, 无@contract头则降级不阻塞)
+    try:
+        from common.contract import validate_contract
+        cr = validate_contract(prd_path)
+        if cr.is_warn:
+            print(cr.msg)  # WARN: 无契约头或字段警告, 提示但不阻塞
+        elif cr.ok and cr.code not in ('no_contract', 'no_schema', 'ok'):
+            print(cr.msg)
+            if cr.hint:
+                print('  -> ' + cr.hint)
+    except Exception:
+        pass  # 契约校验失败不影响评估
+
     # 用程序化 API 评估 (重构后 main 只是 CLI 包装)
     from common.eval_api import evaluate, format_report
     try:
@@ -278,10 +324,23 @@ def main():
     # 打印人类可读报告
     print(format_report(result))
 
-    # 详细 misses (补充 format_report 之外的细节)
-    if result.get('msg2') and '非真源颜色' in str(result.get('msg2', '')):
-        # msg2 已含信息, 此处可补 unknown 列表 —— 但 evaluate 已合并进 misses
-        pass
+    # v3.0 接入: 用 Result 表达三级 (PASS ≥80 / WARN 60-80 / FAIL <60)
+    # 现状是二值 passed, 这里加 WARN 中间档, 让"差一点的 PRD"能带警告发布
+    from common.result import Result, CODE
+    pct = result.get('pct', 0)
+    if result['passed']:
+        verdict = Result.success(msg='✓ PASS ({}%)'.format(pct), data=result)
+    elif pct >= 60:
+        verdict = Result.warning(
+            '⚠ WARN ({}%): 低于80但有内容, 可带警告发布'.format(pct),
+            code=CODE.BELOW_THRESH, data=result,
+        )
+    else:
+        verdict = Result.failure(
+            '✗ FAIL ({}%): 低于60, 需修复'.format(pct),
+            code=CODE.BELOW_THRESH,
+            hint='检查字段锚定(A1)和模板完整(A3)',
+        )
 
     # 记录历史 (原子追加, 防并发损坏)
     try:
@@ -295,11 +354,12 @@ def main():
             'a3_template': result['r3'],
             'score_pct': result['pct'],
             'passed': result['passed'],
+            'verdict': verdict.code,  # v3.0: 记录三级判定
         }, timeout=10)
     except Exception:
         pass  # 历史记录失败不影响评估结果
 
-    # 埋点: PRD 评估结果反馈给 learning 引擎 (prd_accepted / prd_rejected)
+    # 埋点: PRD 评估结果反馈给 learning 引擎
     try:
         from learn import record_feedback
         event = 'prd_accepted' if result['passed'] else 'prd_rejected'
@@ -311,7 +371,9 @@ def main():
     except Exception:
         pass  # 埋点失败不影响评估
 
-    return 0 if result['passed'] else 1
+    # exit code: PASS=0, WARN=0(可继续), FAIL=1
+    # (WARN 不阻塞发布, 与方案"eval_prd 三级门禁"一致)
+    return 0 if verdict.ok else 1
 
 
 if __name__ == '__main__':

package/templates/qoder/scripts/{export.py → report/export.py}

@@ -1,5 +1,11 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
+# v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
+import os as _o, sys as _s
+_cp = _o.path.join(_o.path.dirname(_o.path.dirname(_o.path.abspath(__file__))), 'common')
+if _cp not in _s.path: _s.path.insert(0, _cp)
+from bootstrap import setup; setup()
+
 """
 export.py - 集成导出工具 (阶段 C)
 
@@ -470,6 +476,13 @@ def main():
     p_cg = sub.add_parser('callgraph', help='Java 调用图')
     p_cg.add_argument('--class', dest='class_name', help='查询指定类的依赖')
 
+    p_dx = sub.add_parser('docx', help='PRD导出Word(M5)')
+    p_dx.add_argument('prd', help='PRD md文件')
+    p_dx.add_argument('-o', '--output')
+    p_pf = sub.add_parser('pdf', help='PRD导出HTML(浏览器打印为PDF)')
+    p_pf.add_argument('prd', help='PRD md文件')
+    p_pf.add_argument('-o', '--output')
+
     args = parser.parse_args()
     if not args.format:
         parser.print_help()
@@ -482,6 +495,56 @@ def main():
     elif args.format == 'callgraph':
         return export_callgraph(class_name=args.class_name)
 
+    elif args.format == 'docx':
+        return export_docx(args.prd, args.output)
+    elif args.format == 'pdf':
+        return export_pdf(args.prd, args.output)
+
+
+def export_docx(prd_path, output=None):
+    """PRD markdown -> Word docx (M5)。用 python-docx, 纯Python不依赖pandoc。"""
+    if not os.path.isfile(prd_path):
+        print('PRD 不存在: %s' % prd_path); return 1
+    try:
+        from docx import Document
+    except ImportError:
+        print('python-docx 未装。pip install python-docx'); return 1
+    doc = Document()
+    with open(prd_path, encoding='utf-8') as f:
+        for line in f:
+            ln = line.rstrip('\n'); s = ln.strip()
+            if s.startswith('# '): doc.add_heading(s[2:], level=1)
+            elif s.startswith('## '): doc.add_heading(s[3:], level=2)
+            elif s.startswith('### '): doc.add_heading(s[4:], level=3)
+            elif s.startswith('- ') or s.startswith('* '): doc.add_paragraph(s[2:], style='List Bullet')
+            elif s.startswith('<!--'): pass
+            elif s == '': pass
+            else: doc.add_paragraph(s)
+    if not output: output = os.path.splitext(prd_path)[0] + '.docx'
+    doc.save(output)
+    print('OK Word: %s' % output); return 0
+
+
+def export_pdf(prd_path, output=None):
+    """PRD markdown -> HTML (浏览器Ctrl+P另存PDF) (M5)。避免wkhtmltopdf重依赖。"""
+    if not os.path.isfile(prd_path):
+        print('PRD 不存在: %s' % prd_path); return 1
+    try:
+        import markdown as md
+    except ImportError:
+        print('markdown 未装。pip install markdown'); return 1
+    with open(prd_path, encoding='utf-8') as f:
+        body = md.markdown(f.read(), extensions=['tables', 'fenced_code'])
+    html = ('<!DOCTYPE html><html lang="zh"><head><meta charset="UTF-8"><style>'
+            'body{font-family:"Microsoft YaHei",sans-serif;max-width:800px;margin:40px auto;line-height:1.6}'
+            'h1{border-bottom:2px solid #333}h2{border-bottom:1px solid #999;margin-top:24px}'
+            'table{border-collapse:collapse;width:100%}th,td{border:1px solid #ccc;padding:6px}th{background:#f5f5f5}'
+            '@media print{body{margin:20px}}</style></head><body>' + body + '</body></html>')
+    if not output: output = os.path.splitext(prd_path)[0] + '.html'
+    with open(output, 'w', encoding='utf-8') as f:
+        f.write(html)
+    print('OK HTML: %s (浏览器打开 Ctrl+P 另存PDF)' % output); return 0
+
 
 if __name__ == '__main__':
     sys.exit(main())

package/templates/qoder/scripts/{fill_prototype.py → report/fill_prototype.py}

@@ -1,5 +1,11 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
+# v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
+import os as _o, sys as _s
+_cp = _o.path.join(_o.path.dirname(_o.path.dirname(_o.path.abspath(__file__))), 'common')
+if _cp not in _s.path: _s.path.insert(0, _cp)
+from bootstrap import setup; setup()
+
 """
 QODER Fill Prototype - 用真实数据自动预填原型模板 (80%完成)