@hupan56/wlkj 3.3.13 → 3.3.15

package/templates/qoder/scripts/validation/eval/prd_fidelity_flywheel.py

@@ -1,128 +1,128 @@
-"""prd_fidelity_flywheel.py — FW9 PRD 业务保真度飞轮（vs 真实 ICS schema，非结构代理）。
-
-用户根因：之前 FW2 量的是"6 章齐"（结构），不是"PRD 是不是这个业务的"（保真）。
-本尺子量 **schema 保真**：PRD 引用的表/列是不是 ICS 真实业务表列(db_tables/db_columns)，
-而非泛泛/编造。bare(无 schema grounding→编造表名) vs +真schema grounding(喂真表真列)。
-保真率 = PRD 提的表/列 ∈ 真实 schema 的比例；召回 = 该功能真表被提的比例。
-
-（原型颜色保真=eval_prd A2 读宿主真色板，云 KG 无设计系统表→那格 🖥️ 宿主；本尺子量可代理的 schema 保真）
-
-跑法: docker exec -i wlinkj-workspace-backend-1 python /app/scripts/validation/eval/prd_fidelity_flywheel.py
-"""
-import os
-import re
-import sys
-import json
-import time
-import urllib.request
-import urllib.error
-
-for _p in ("/app", os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "..", "..", ".."))):
-    if os.path.isdir(_p) and _p not in sys.path:
-        sys.path.insert(0, _p)
-
-from sqlalchemy import text  # noqa: E402
-from app.db import SessionLocal  # noqa: E402
-
-CHAT_URL = os.environ.get("ALI_CHAT_BASE", "").rstrip("/") + "/chat/completions"
-CHAT_KEY = os.environ.get("DASHSCOPE_API_KEY", "")
-MODEL = "qwen-turbo"
-FEATURES = [("车辆保险管理", "保险"), ("异常记录管理", "异常"), ("合同维护", "合同")]
-# 表名 token（t_xxx / tb_xxx / report_xxx 等）
-_TABLE_RE = re.compile(r'\b(t_[a-z_]+|tb_[a-z_]+|report_[a-z_]+|salary_[a-z_]+|[a-z]+_[a-z_]+_table)\b', re.IGNORECASE)
-
-
-def chat(prompt, max_tokens=900, timeout=90):
-    body = json.dumps({"model": MODEL, "messages": [{"role": "user", "content": prompt}],
-        "temperature": 0.2, "max_tokens": max_tokens}).encode()
-    for a in range(3):
-        try:
-            req = urllib.request.Request(CHAT_URL, data=body,
-                headers={"Authorization": f"Bearer {CHAT_KEY}", "Content-Type": "application/json"})
-            return json.loads(urllib.request.urlopen(req, timeout=timeout).read())["choices"][0]["message"]["content"]
-        except (urllib.error.URLError, TimeoutError, OSError, KeyError) as e:
-            if a < 2: time.sleep(1.0*(a+1))
-            else: return f"[ERR {repr(e)[:50]}]"
-
-
-def _q(s, sql, p=None):
-    try: return s.execute(text(sql), p or {}).fetchall()
-    except Exception:
-        try: s.rollback()
-        except Exception: pass
-        return []
-
-
-def real_schema(theme):
-    """该功能的真实业务表(db_tables) + 列(db_columns) = 业务保真 gold。"""
-    s = SessionLocal()
-    tabs = [r[0] for r in _q(s, "SELECT table_name FROM db_tables WHERE table_name ILIKE :p OR table_comment ILIKE :p LIMIT 15", {"p": f"%{theme}%"})]
-    cols = [r[0] for r in _q(s, "SELECT column_name FROM db_columns WHERE column_name ILIKE :p OR column_comment ILIKE :p LIMIT 15", {"p": f"%{theme}%"})]
-    all_tabs = set(r[0] for r in _q(s, "SELECT table_name FROM db_tables"))  # 全量真表(保真校验集)
-    s.close()
-    return tabs, cols, all_tabs
-
-
-def extract_tables(prd):
-    return set(m.lower() for m in _TABLE_RE.findall(prd))
-
-
-def fidelity(prd, gold_tabs, all_tabs):
-    """保真率 = PRD 提的表 ∈ 真实 schema 的比例；召回 = gold 表被提的比例。"""
-    mentioned = extract_tables(prd)
-    if not mentioned:
-        return 0.0, 0.0, 0
-    real_mentioned = mentioned & all_tabs
-    precision = len(real_mentioned) / len(mentioned)  # 保真：提的表是真的比例
-    recall = len(mentioned & set(t.lower() for t in gold_tabs)) / max(len(gold_tabs), 1)  # 召回：gold 表被提
-    return round(precision, 3), round(recall, 3), len(mentioned)
-
-
-def run():
-    rep = {"features": []}
-    for feat, theme in FEATURES:
-        gtabs, gcols, all_tabs = real_schema(theme)
-        schema_ctx = "真实业务表:\n" + "\n".join(gtabs[:12]) + "\n真实业务列:\n" + ", ".join(gcols[:12])
-        bare = chat(f"你是产品经理。为 ICS 系统「{feat}」写 PRD（含字段设计/数据表）。直接输出正文。")
-        scaff = chat(f"你是 ICS(车辆物联网)产品经理。为「{feat}」写 PRD（含字段设计/数据表）。\n"
-                     f"【业务 schema 接地】以下是该功能的真实业务表/列（均为真实存在）：\n{schema_ctx}\n"
-                     f"铁律：字段设计/数据表章节【必须把上面列出的真实业务表全部引用】，用真实表名，勿编造/勿省略。"
-                     f"直接输出 PRD 正文。")
-        bP, bR, bN = fidelity(bare, gtabs, all_tabs)
-        sP, sR, sN = fidelity(scaff, gtabs, all_tabs)
-        rep["features"].append({"feature": feat, "gold_tabs": len(gtabs),
-                                "bare_fidelity": bP, "bare_recall": bR, "bare_mentioned": bN,
-                                "scaffold_fidelity": sP, "scaffold_recall": sR, "scaffold_mentioned": sN})
-        print("  %s: gold表=%d | bare 保真=%.2f 召回=%.2f(提%d) | scaffold 保真=%.2f 召回=%.2f(提%d)" % (
-            feat, len(gtabs), bP, bR, bN, sP, sR, sN))
-    n = len(FEATURES) or 1
-    rep["agg"] = {
-        "bare_fidelity": round(sum(f["bare_fidelity"] for f in rep["features"])/n, 3),
-        "scaffold_fidelity": round(sum(f["scaffold_fidelity"] for f in rep["features"])/n, 3),
-        "bare_recall": round(sum(f["bare_recall"] for f in rep["features"])/n, 3),
-        "scaffold_recall": round(sum(f["scaffold_recall"] for f in rep["features"])/n, 3),
-    }
-    return rep
-
-
-def main():
-    import argparse
-    ap = argparse.ArgumentParser()
-    ap.add_argument("--json", action="store_true")
-    args = ap.parse_args()
-    r = run()
-    a = r["agg"]
-    if args.json:
-        print(json.dumps(r, ensure_ascii=False, indent=2))
-        return
-    print("\n## FW9 PRD 业务保真度飞轮（PRD 提的表 vs 真实 ICS schema）")
-    print("| 维度 | bare(无schema接地) | +真schema接地 |")
-    print("|---|---|---|")
-    print("| 保真率(提的表是真的) | %.0f%% | %.0f%% |" % (a["bare_fidelity"]*100, a["scaffold_fidelity"]*100))
-    print("| 召回(gold真表被提) | %.0f%% | %.0f%% |" % (a["bare_recall"]*100, a["scaffold_recall"]*100))
-    print("\n业务保真=PRD 引用的是 ICS 真实业务表(t_insurance_log 等),非编造/泛泛。"
-          "bare 编造表名→保真低；scaffold 接真 schema→保真高。")
-
-
-if __name__ == "__main__":
-    main()
+"""prd_fidelity_flywheel.py — FW9 PRD 业务保真度飞轮（vs 真实 ICS schema，非结构代理）。
+
+用户根因：之前 FW2 量的是"6 章齐"（结构），不是"PRD 是不是这个业务的"（保真）。
+本尺子量 **schema 保真**：PRD 引用的表/列是不是 ICS 真实业务表列(db_tables/db_columns)，
+而非泛泛/编造。bare(无 schema grounding→编造表名) vs +真schema grounding(喂真表真列)。
+保真率 = PRD 提的表/列 ∈ 真实 schema 的比例；召回 = 该功能真表被提的比例。
+
+（原型颜色保真=eval_prd A2 读宿主真色板，云 KG 无设计系统表→那格 🖥️ 宿主；本尺子量可代理的 schema 保真）
+
+跑法: docker exec -i wlinkj-workspace-backend-1 python /app/scripts/validation/eval/prd_fidelity_flywheel.py
+"""
+import os
+import re
+import sys
+import json
+import time
+import urllib.request
+import urllib.error
+
+for _p in ("/app", os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "..", "..", ".."))):
+    if os.path.isdir(_p) and _p not in sys.path:
+        sys.path.insert(0, _p)
+
+from sqlalchemy import text  # noqa: E402
+from app.db import SessionLocal  # noqa: E402
+
+CHAT_URL = os.environ.get("ALI_CHAT_BASE", "").rstrip("/") + "/chat/completions"
+CHAT_KEY = os.environ.get("DASHSCOPE_API_KEY", "")
+MODEL = "qwen-turbo"
+FEATURES = [("车辆保险管理", "保险"), ("异常记录管理", "异常"), ("合同维护", "合同")]
+# 表名 token（t_xxx / tb_xxx / report_xxx 等）
+_TABLE_RE = re.compile(r'\b(t_[a-z_]+|tb_[a-z_]+|report_[a-z_]+|salary_[a-z_]+|[a-z]+_[a-z_]+_table)\b', re.IGNORECASE)
+
+
+def chat(prompt, max_tokens=900, timeout=90):
+    body = json.dumps({"model": MODEL, "messages": [{"role": "user", "content": prompt}],
+        "temperature": 0.2, "max_tokens": max_tokens}).encode()
+    for a in range(3):
+        try:
+            req = urllib.request.Request(CHAT_URL, data=body,
+                headers={"Authorization": f"Bearer {CHAT_KEY}", "Content-Type": "application/json"})
+            return json.loads(urllib.request.urlopen(req, timeout=timeout).read())["choices"][0]["message"]["content"]
+        except (urllib.error.URLError, TimeoutError, OSError, KeyError) as e:
+            if a < 2: time.sleep(1.0*(a+1))
+            else: return f"[ERR {repr(e)[:50]}]"
+
+
+def _q(s, sql, p=None):
+    try: return s.execute(text(sql), p or {}).fetchall()
+    except Exception:
+        try: s.rollback()
+        except Exception: pass
+        return []
+
+
+def real_schema(theme):
+    """该功能的真实业务表(db_tables) + 列(db_columns) = 业务保真 gold。"""
+    s = SessionLocal()
+    tabs = [r[0] for r in _q(s, "SELECT table_name FROM db_tables WHERE table_name ILIKE :p OR table_comment ILIKE :p LIMIT 15", {"p": f"%{theme}%"})]
+    cols = [r[0] for r in _q(s, "SELECT column_name FROM db_columns WHERE column_name ILIKE :p OR column_comment ILIKE :p LIMIT 15", {"p": f"%{theme}%"})]
+    all_tabs = set(r[0] for r in _q(s, "SELECT table_name FROM db_tables"))  # 全量真表(保真校验集)
+    s.close()
+    return tabs, cols, all_tabs
+
+
+def extract_tables(prd):
+    return set(m.lower() for m in _TABLE_RE.findall(prd))
+
+
+def fidelity(prd, gold_tabs, all_tabs):
+    """保真率 = PRD 提的表 ∈ 真实 schema 的比例；召回 = gold 表被提的比例。"""
+    mentioned = extract_tables(prd)
+    if not mentioned:
+        return 0.0, 0.0, 0
+    real_mentioned = mentioned & all_tabs
+    precision = len(real_mentioned) / len(mentioned)  # 保真：提的表是真的比例
+    recall = len(mentioned & set(t.lower() for t in gold_tabs)) / max(len(gold_tabs), 1)  # 召回：gold 表被提
+    return round(precision, 3), round(recall, 3), len(mentioned)
+
+
+def run():
+    rep = {"features": []}
+    for feat, theme in FEATURES:
+        gtabs, gcols, all_tabs = real_schema(theme)
+        schema_ctx = "真实业务表:\n" + "\n".join(gtabs[:12]) + "\n真实业务列:\n" + ", ".join(gcols[:12])
+        bare = chat(f"你是产品经理。为 ICS 系统「{feat}」写 PRD（含字段设计/数据表）。直接输出正文。")
+        scaff = chat(f"你是 ICS(车辆物联网)产品经理。为「{feat}」写 PRD（含字段设计/数据表）。\n"
+                     f"【业务 schema 接地】以下是该功能的真实业务表/列（均为真实存在）：\n{schema_ctx}\n"
+                     f"铁律：字段设计/数据表章节【必须把上面列出的真实业务表全部引用】，用真实表名，勿编造/勿省略。"
+                     f"直接输出 PRD 正文。")
+        bP, bR, bN = fidelity(bare, gtabs, all_tabs)
+        sP, sR, sN = fidelity(scaff, gtabs, all_tabs)
+        rep["features"].append({"feature": feat, "gold_tabs": len(gtabs),
+                                "bare_fidelity": bP, "bare_recall": bR, "bare_mentioned": bN,
+                                "scaffold_fidelity": sP, "scaffold_recall": sR, "scaffold_mentioned": sN})
+        print("  %s: gold表=%d | bare 保真=%.2f 召回=%.2f(提%d) | scaffold 保真=%.2f 召回=%.2f(提%d)" % (
+            feat, len(gtabs), bP, bR, bN, sP, sR, sN))
+    n = len(FEATURES) or 1
+    rep["agg"] = {
+        "bare_fidelity": round(sum(f["bare_fidelity"] for f in rep["features"])/n, 3),
+        "scaffold_fidelity": round(sum(f["scaffold_fidelity"] for f in rep["features"])/n, 3),
+        "bare_recall": round(sum(f["bare_recall"] for f in rep["features"])/n, 3),
+        "scaffold_recall": round(sum(f["scaffold_recall"] for f in rep["features"])/n, 3),
+    }
+    return rep
+
+
+def main():
+    import argparse
+    ap = argparse.ArgumentParser()
+    ap.add_argument("--json", action="store_true")
+    args = ap.parse_args()
+    r = run()
+    a = r["agg"]
+    if args.json:
+        print(json.dumps(r, ensure_ascii=False, indent=2))
+        return
+    print("\n## FW9 PRD 业务保真度飞轮（PRD 提的表 vs 真实 ICS schema）")
+    print("| 维度 | bare(无schema接地) | +真schema接地 |")
+    print("|---|---|---|")
+    print("| 保真率(提的表是真的) | %.0f%% | %.0f%% |" % (a["bare_fidelity"]*100, a["scaffold_fidelity"]*100))
+    print("| 召回(gold真表被提) | %.0f%% | %.0f%% |" % (a["bare_recall"]*100, a["scaffold_recall"]*100))
+    print("\n业务保真=PRD 引用的是 ICS 真实业务表(t_insurance_log 等),非编造/泛泛。"
+          "bare 编造表名→保真低；scaffold 接真 schema→保真高。")
+
+
+if __name__ == "__main__":
+    main()

package/templates/qoder/scripts/validation/eval/prd_flywheel.py

@@ -1,148 +1,148 @@
-"""prd_flywheel.py — FW2 wl-prd 生成类质量飞轮（完整性/准确性 → 目标）。
-
-生成类维度(SPEC §1.1)：完整性(必要段数) / 准确性(gold 对齐) / 可用性(EVA≥80%)。
-飞轮：弱模型(bare prompt) vs +wl-prd scaffold(6章强制 + KG grounding) → 量
-  - 完整性 = 6 章命中 / 6（QUICK_SECTIONS，纯 regex）
-  - 现实锚定 = PRD 里出现的【KG 真实体名】数（bare 编造→少；scaffold 接地→多）
-→ 改 scaffold（强制章 + 接地）→ 重量 → 直到 完整性=6/6 + 锚定≥阈值。
-
-云端跑（DashScope 生 + PG 真实体）。eval_prd.py 是宿主 DuckDB 侧，本尺子是其云端同构代理。
-跑法: docker exec -i wlinkj-workspace-backend-1 python /app/scripts/validation/eval/prd_flywheel.py
-"""
-import os
-import re
-import sys
-import json
-import time
-import urllib.request
-import urllib.error
-
-for _p in ("/app", os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "..", "..", ".."))):
-    if os.path.isdir(_p) and _p not in sys.path:
-        sys.path.insert(0, _p)
-
-from sqlalchemy import text  # noqa: E402
-from app.db import SessionLocal  # noqa: E402
-
-CHAT_URL = os.environ.get("ALI_CHAT_BASE", "").rstrip("/") + "/chat/completions"
-CHAT_KEY = os.environ.get("DASHSCOPE_API_KEY", "")
-MODEL = "qwen-turbo"  # 弱模型（卖点：弱模型+工作流）
-QUICK_SECTIONS = ["功能入口", "需求背景", "需求说明", "影响范围", "验收标准", "不在本次范围"]
-FEATURES = ["车辆保养提醒", "考勤异常导出", "保险续保预警"]
-
-
-def chat(prompt, max_tokens=900, timeout=90):
-    body = json.dumps({"model": MODEL,
-        "messages": [{"role": "user", "content": prompt}],
-        "temperature": 0.2, "max_tokens": max_tokens}).encode()
-    for attempt in range(3):
-        try:
-            req = urllib.request.Request(CHAT_URL, data=body,
-                headers={"Authorization": f"Bearer {CHAT_KEY}", "Content-Type": "application/json"})
-            return json.loads(urllib.request.urlopen(req, timeout=timeout).read())["choices"][0]["message"]["content"]
-        except (urllib.error.URLError, TimeoutError, OSError, KeyError) as e:
-            if attempt < 2:
-                time.sleep(1.0 * (attempt + 1))
-            else:
-                return f"[ERR {repr(e)[:60]}]"
-
-
-def _q(s, sql, params=None):
-    try:
-        return s.execute(text(sql), params or {}).fetchall()
-    except Exception:
-        try:
-            s.rollback()
-        except Exception:
-            pass
-        return []
-
-
-def real_entities(theme, k=15):
-    """KG 里该主题的真实实体 (canonical, cn)（现实锚定 gold）。"""
-    s = SessionLocal()
-    rows = _q(s, "SELECT canonical, cn FROM entities WHERE (canonical ILIKE :p OR cn ILIKE :p) "
-                "AND canonical IS NOT NULL LIMIT :n", {"p": f"%{theme}%", "n": k})
-    s.close()
-    return [(r[0], r[1]) for r in rows if r[0]]
-
-
-def completeness(prd_text):
-    """6 章命中数（regex，接受 #/##/粗体/裸文本）。"""
-    hit = 0
-    for sec in QUICK_SECTIONS:
-        if re.search(r'#{0,3}\s*\*{0,2}' + sec, prd_text):
-            hit += 1
-    return hit
-
-
-def reality_anchor(prd_text, reals):
-    """PRD 里出现的 KG 真实体数（canonical 或 cn 命中任一即算；cn 中文名更易在散文出现）。"""
-    n = 0
-    for canon, cn in reals:
-        if (canon and canon in prd_text) or (cn and cn in prd_text):
-            n += 1
-    return n
-
-
-def gen_bare(feature):
-    return (f"你是产品经理。为「{feature}」功能写一份 PRD 需求文档。\n"
-            f"直接输出 PRD 正文。")
-
-
-def gen_scaffold(feature, grounding):
-    return (f"你是车辆物联网系统(ICS)的产品经理。为「{feature}」写一份 PRD。\n"
-            f"知识图谱检索到该功能相关的真实系统对象（字段/类/接口，均为真实存在）：\n{grounding}\n\n"
-            f"**铁律**：PRD 必须【完整含以下 6 章，每章一个 ## 标题，缺一不可】：\n"
-            f"## 功能入口\n## 需求背景\n## 需求说明\n## 影响范围\n## 验收标准\n## 不在本次范围\n"
-            f"PRD 里的字段名/接口名【必须用上面检索到的真实名称】，不要编造。直接输出 PRD 正文。")
-
-
-def run():
-    rep = {"model": MODEL, "features": []}
-    for feat in FEATURES:
-        reals = real_entities(feat.split("提醒")[0].split("导出")[0].split("预警")[0] or feat, 15)
-        ctx = "\n".join("%s (%s)" % (c, n) for c, n in reals[:15]) if reals else "(无检索结果)"
-        bare = chat(gen_bare(feat))
-        scaff = chat(gen_scaffold(feat, ctx))
-        b_cmp = completeness(bare)
-        s_cmp = completeness(scaff)
-        b_real = reality_anchor(bare, reals)
-        s_real = reality_anchor(scaff, reals)
-        rep["features"].append({"feature": feat, "real_n": len(reals),
-                                "bare_completeness": b_cmp, "scaffold_completeness": s_cmp,
-                                "bare_reality": b_real, "scaffold_reality": s_real})
-        print("  %s: 完整性 bare=%d/6 scaff=%d/6 | 锚定 bare=%d scaff=%d (gold=%d)" % (
-            feat, b_cmp, s_cmp, b_real, s_real, len(reals)))
-    n = len(FEATURES) or 1
-    rep["agg"] = {
-        "bare_completeness": round(sum(f["bare_completeness"] for f in rep["features"]) / n, 2),
-        "scaffold_completeness": round(sum(f["scaffold_completeness"] for f in rep["features"]) / n, 2),
-        "bare_reality": round(sum(f["bare_reality"] for f in rep["features"]) / n, 2),
-        "scaffold_reality": round(sum(f["scaffold_reality"] for f in rep["features"]) / n, 2),
-    }
-    return rep
-
-
-def main():
-    import argparse
-    ap = argparse.ArgumentParser()
-    ap.add_argument("--json", action="store_true")
-    args = ap.parse_args()
-    r = run()
-    a = r["agg"]
-    if args.json:
-        print(json.dumps(r, ensure_ascii=False, indent=2))
-        return
-    print("\n## FW2 wl-prd 生成类飞轮（完整性 6/6 + 现实锚定）")
-    print("| 维度 | bare(弱模型裸) | +wl-prd scaffold | 目标 |")
-    print("|---|---|---|---|")
-    print("| 完整性(章/6) | %.2f | %.2f | 6.0 |" % (a["bare_completeness"], a["scaffold_completeness"]))
-    print("| 现实锚定(真实体命中) | %.2f | %.2f | 高 |" % (a["bare_reality"], a["scaffold_reality"]))
-    cmp_met = a["scaffold_completeness"] >= 6.0
-    print("\n完整性达标(≥6/6)?" , "✓" if cmp_met else "✗ → 下轮：强章模板/Stop hook 拦缺章")
-    print("锚定提升:", "%+.2f" % (a["scaffold_reality"] - a["bare_reality"]), "(scaffold 接地 vs bare 编造)")
-
-
-if __name__ == "__main__":
-    main()
+"""prd_flywheel.py — FW2 wl-prd 生成类质量飞轮（完整性/准确性 → 目标）。
+
+生成类维度(SPEC §1.1)：完整性(必要段数) / 准确性(gold 对齐) / 可用性(EVA≥80%)。
+飞轮：弱模型(bare prompt) vs +wl-prd scaffold(6章强制 + KG grounding) → 量
+  - 完整性 = 6 章命中 / 6（QUICK_SECTIONS，纯 regex）
+  - 现实锚定 = PRD 里出现的【KG 真实体名】数（bare 编造→少；scaffold 接地→多）
+→ 改 scaffold（强制章 + 接地）→ 重量 → 直到 完整性=6/6 + 锚定≥阈值。
+
+云端跑（DashScope 生 + PG 真实体）。eval_prd.py 是宿主 DuckDB 侧，本尺子是其云端同构代理。
+跑法: docker exec -i wlinkj-workspace-backend-1 python /app/scripts/validation/eval/prd_flywheel.py
+"""
+import os
+import re
+import sys
+import json
+import time
+import urllib.request
+import urllib.error
+
+for _p in ("/app", os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "..", "..", ".."))):
+    if os.path.isdir(_p) and _p not in sys.path:
+        sys.path.insert(0, _p)
+
+from sqlalchemy import text  # noqa: E402
+from app.db import SessionLocal  # noqa: E402
+
+CHAT_URL = os.environ.get("ALI_CHAT_BASE", "").rstrip("/") + "/chat/completions"
+CHAT_KEY = os.environ.get("DASHSCOPE_API_KEY", "")
+MODEL = "qwen-turbo"  # 弱模型（卖点：弱模型+工作流）
+QUICK_SECTIONS = ["功能入口", "需求背景", "需求说明", "影响范围", "验收标准", "不在本次范围"]
+FEATURES = ["车辆保养提醒", "考勤异常导出", "保险续保预警"]
+
+
+def chat(prompt, max_tokens=900, timeout=90):
+    body = json.dumps({"model": MODEL,
+        "messages": [{"role": "user", "content": prompt}],
+        "temperature": 0.2, "max_tokens": max_tokens}).encode()
+    for attempt in range(3):
+        try:
+            req = urllib.request.Request(CHAT_URL, data=body,
+                headers={"Authorization": f"Bearer {CHAT_KEY}", "Content-Type": "application/json"})
+            return json.loads(urllib.request.urlopen(req, timeout=timeout).read())["choices"][0]["message"]["content"]
+        except (urllib.error.URLError, TimeoutError, OSError, KeyError) as e:
+            if attempt < 2:
+                time.sleep(1.0 * (attempt + 1))
+            else:
+                return f"[ERR {repr(e)[:60]}]"
+
+
+def _q(s, sql, params=None):
+    try:
+        return s.execute(text(sql), params or {}).fetchall()
+    except Exception:
+        try:
+            s.rollback()
+        except Exception:
+            pass
+        return []
+
+
+def real_entities(theme, k=15):
+    """KG 里该主题的真实实体 (canonical, cn)（现实锚定 gold）。"""
+    s = SessionLocal()
+    rows = _q(s, "SELECT canonical, cn FROM entities WHERE (canonical ILIKE :p OR cn ILIKE :p) "
+                "AND canonical IS NOT NULL LIMIT :n", {"p": f"%{theme}%", "n": k})
+    s.close()
+    return [(r[0], r[1]) for r in rows if r[0]]
+
+
+def completeness(prd_text):
+    """6 章命中数（regex，接受 #/##/粗体/裸文本）。"""
+    hit = 0
+    for sec in QUICK_SECTIONS:
+        if re.search(r'#{0,3}\s*\*{0,2}' + sec, prd_text):
+            hit += 1
+    return hit
+
+
+def reality_anchor(prd_text, reals):
+    """PRD 里出现的 KG 真实体数（canonical 或 cn 命中任一即算；cn 中文名更易在散文出现）。"""
+    n = 0
+    for canon, cn in reals:
+        if (canon and canon in prd_text) or (cn and cn in prd_text):
+            n += 1
+    return n
+
+
+def gen_bare(feature):
+    return (f"你是产品经理。为「{feature}」功能写一份 PRD 需求文档。\n"
+            f"直接输出 PRD 正文。")
+
+
+def gen_scaffold(feature, grounding):
+    return (f"你是车辆物联网系统(ICS)的产品经理。为「{feature}」写一份 PRD。\n"
+            f"知识图谱检索到该功能相关的真实系统对象（字段/类/接口，均为真实存在）：\n{grounding}\n\n"
+            f"**铁律**：PRD 必须【完整含以下 6 章，每章一个 ## 标题，缺一不可】：\n"
+            f"## 功能入口\n## 需求背景\n## 需求说明\n## 影响范围\n## 验收标准\n## 不在本次范围\n"
+            f"PRD 里的字段名/接口名【必须用上面检索到的真实名称】，不要编造。直接输出 PRD 正文。")
+
+
+def run():
+    rep = {"model": MODEL, "features": []}
+    for feat in FEATURES:
+        reals = real_entities(feat.split("提醒")[0].split("导出")[0].split("预警")[0] or feat, 15)
+        ctx = "\n".join("%s (%s)" % (c, n) for c, n in reals[:15]) if reals else "(无检索结果)"
+        bare = chat(gen_bare(feat))
+        scaff = chat(gen_scaffold(feat, ctx))
+        b_cmp = completeness(bare)
+        s_cmp = completeness(scaff)
+        b_real = reality_anchor(bare, reals)
+        s_real = reality_anchor(scaff, reals)
+        rep["features"].append({"feature": feat, "real_n": len(reals),
+                                "bare_completeness": b_cmp, "scaffold_completeness": s_cmp,
+                                "bare_reality": b_real, "scaffold_reality": s_real})
+        print("  %s: 完整性 bare=%d/6 scaff=%d/6 | 锚定 bare=%d scaff=%d (gold=%d)" % (
+            feat, b_cmp, s_cmp, b_real, s_real, len(reals)))
+    n = len(FEATURES) or 1
+    rep["agg"] = {
+        "bare_completeness": round(sum(f["bare_completeness"] for f in rep["features"]) / n, 2),
+        "scaffold_completeness": round(sum(f["scaffold_completeness"] for f in rep["features"]) / n, 2),
+        "bare_reality": round(sum(f["bare_reality"] for f in rep["features"]) / n, 2),
+        "scaffold_reality": round(sum(f["scaffold_reality"] for f in rep["features"]) / n, 2),
+    }
+    return rep
+
+
+def main():
+    import argparse
+    ap = argparse.ArgumentParser()
+    ap.add_argument("--json", action="store_true")
+    args = ap.parse_args()
+    r = run()
+    a = r["agg"]
+    if args.json:
+        print(json.dumps(r, ensure_ascii=False, indent=2))
+        return
+    print("\n## FW2 wl-prd 生成类飞轮（完整性 6/6 + 现实锚定）")
+    print("| 维度 | bare(弱模型裸) | +wl-prd scaffold | 目标 |")
+    print("|---|---|---|---|")
+    print("| 完整性(章/6) | %.2f | %.2f | 6.0 |" % (a["bare_completeness"], a["scaffold_completeness"]))
+    print("| 现实锚定(真实体命中) | %.2f | %.2f | 高 |" % (a["bare_reality"], a["scaffold_reality"]))
+    cmp_met = a["scaffold_completeness"] >= 6.0
+    print("\n完整性达标(≥6/6)?" , "✓" if cmp_met else "✗ → 下轮：强章模板/Stop hook 拦缺章")
+    print("锚定提升:", "%+.2f" % (a["scaffold_reality"] - a["bare_reality"]), "(scaffold 接地 vs bare 编造)")
+
+
+if __name__ == "__main__":
+    main()