@shulex/cxclawctl 0.0.0-stage → 0.1.2

package/skills/delivery/scripts/gen_report.py

@@ -0,0 +1,208 @@
+"""
+HTML report generator for delivery skill.
+
+Reads classification results (workspace/state/delivery/progress.json -> results_path) and
+renders a polished HTML report under workspace/outputs/delivery/.
+
+Usage:
+  python3 scripts/gen_report.py [--brand "Acme"]
+"""
+
+import os, sys
+sys.path.insert(0, os.path.join(os.environ.get("SOLVEA_LIB_DIR", os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "..", "__lib__"))), "skill-runtime"))
+from bootstrap import *
+
+import json, argparse
+from uuid import uuid4
+
+
+def _read_state() -> dict:
+    _sf = STATE_DIR / "progress.json"
+    if _sf.exists():
+        try:
+            return json.loads(_sf.read_text(encoding="utf-8"))
+        except Exception:
+            pass
+    return {}
+
+
+def _write_state(data: dict) -> None:
+    _sf = STATE_DIR / "progress.json"
+    _sf.parent.mkdir(parents=True, exist_ok=True)
+    _sf.write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
+
+from render import render_html
+
+COLOR_PALETTE = [
+    "#ef4444", "#f97316", "#eab308", "#22c55e",
+    "#14b8a6", "#3b82f6", "#8b5cf6", "#ec4899",
+    "#06b6d4", "#84cc16",
+]
+
+CIRCLE_NUMS = "①②③④⑤⑥⑦⑧⑨⑩"
+
+
+def build_config_from_results(results, brand_name=""):
+    def uid():
+        return uuid4().hex
+
+    agents = []
+    all_intents = results.get("intents", []) + results.get("new_intents", [])
+    meta = results.get("meta", {})
+    total = meta.get("total", 0)
+
+    for i, intent in enumerate(all_intents):
+        sub_intents = intent.get("sub_intents", [])
+        is_new = intent.get("is_new", False)
+        agent_id = f"intent-{i}"
+
+        l2_nodes = []
+        for j, s in enumerate(sub_intents):
+            sample_preview = s["samples"][0][:50] + "..." if s.get("samples") else ""
+            l2_nodes.append({
+                "id": f"n2-{uid()[:8]}",
+                "name": s["name"],
+                "desc": f"{s['pct']:.1f}% — {sample_preview}" if sample_preview else f"{s['pct']:.1f}%",
+                "count": s["count"],
+                "definition": s.get("definition", ""),
+                "is_shared": False,
+                "shared_agents": [],
+                "samples": s.get("samples", []),
+            })
+
+        nodes_ac = []
+        for s in sub_intents[:3]:
+            nodes_ac.append({
+                "name": f"节点 · {s['name']}",
+                "trigger": f"客户投诉：{s['name']}",
+                "action": f"<code>LLM</code> 处理 {s['name']}，引导解决",
+            })
+
+        agents.append({
+            "id": agent_id,
+            "name": f"{CIRCLE_NUMS[i % len(CIRCLE_NUMS)]} {intent['name']}",
+            "color": COLOR_PALETTE[i % len(COLOR_PALETTE)],
+            "l1_intents": [intent["name"]],
+            "total_count": intent["count"],
+            "total_pct": intent["pct"],
+            "is_new": is_new,
+            "intent_config": {
+                "definition": intent.get("definition", ""),
+                "excludes": [],
+                "examples": intent.get("samples", [])[:3],
+                "covers": [s["name"] for s in sub_intents],
+            },
+            "agent_config": {
+                "type": "chatflow",
+                "nodes": nodes_ac,
+                "footer": f"<b>结束：</b>解决{intent['name']}问题 / 转人工",
+            },
+            "l2_nodes": l2_nodes,
+        })
+
+    edges = []
+    for a in agents:
+        ag_html_id = f"ag-{a['id'].replace('_', '-')}"
+        color = a.get("color", "#6b7280")
+        for node in a["l2_nodes"]:
+            count = node.get("count", 0)
+            if count > 0:
+                edges.append({"from": ag_html_id, "to": node["id"], "count": count, "color": color})
+
+    total_nodes = sum(len(a["l2_nodes"]) for a in agents)
+    n_known = meta.get("n_known", len(results.get("intents", [])))
+    n_new = meta.get("n_new", len(results.get("new_intents", [])))
+
+    rows = []
+    for a in agents:
+        n = len(a["l2_nodes"])
+        badge = f"{n} 节点 ✓" if n <= 2 else (f"{n} 节点 ⚠️" if n <= 3 else f"{n} 节点 ❌")
+        rows.append({
+            "agent_name": a["name"],
+            "color": a["color"],
+            "node_count": n,
+            "badge": badge,
+        })
+
+    l2_total = sum(s["count"] for intent in all_intents for s in intent.get("sub_intents", []))
+    opt_notes = (
+        f"✅ 已知意图 {n_known} 个，新发现意图 {n_new} 个，共 {n_known + n_new} 个 L1 意图\n\n"
+        f"📊 数据基础：{total:,} 条对话 / L2 分类：{l2_total:,} 条"
+    )
+    if n_new > 0:
+        new_names = [i["name"] for i in results.get("new_intents", [])]
+        opt_notes += f"\n\n⚡ 新发现意图：{' · '.join(new_names)}"
+
+    return {
+        "agents": agents,
+        "filter_block": {"types": ["未分类投诉"], "count": 0},
+        "node_summary": {
+            "rows": rows,
+            "total_nodes": total_nodes,
+            "optimization_notes": opt_notes,
+        },
+        "shared_nodes": [],
+        "edges": edges,
+    }
+
+
+def _resolve_results_path(state: dict) -> str:
+    path = state.get("results_path")
+    if not path:
+        raise FileNotFoundError(
+            "No results_path in state. Run classify.py first."
+        )
+    if not os.path.exists(path):
+        raise FileNotFoundError(
+            f"Results file missing: {path}. Run classify.py first."
+        )
+    return path
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Generate delivery intent classification HTML report")
+    parser.add_argument("--brand", default="")
+    parser.add_argument("--results", default=None,
+                        help="Override results JSON path (default: read from progress.json)")
+    args = parser.parse_args()
+
+    if args.results:
+        results_path = args.results
+        if not os.path.exists(results_path):
+            raise FileNotFoundError(f"Results file missing: {results_path}")
+    else:
+        state = _read_state()
+        results_path = _resolve_results_path(state)
+
+    with open(results_path) as f:
+        results = json.load(f)
+
+    config = build_config_from_results(results, brand_name=args.brand)
+
+    meta = results.get("meta", {})
+    data_compat = {
+        "_meta": {"total": meta.get("total", 0), "brand": args.brand},
+        "tree": {},
+        "turn_distribution": {},
+        "fuzzy_samples": {},
+    }
+
+    project_id = os.environ.get("SOLVEA_PROJECT_ID", "")
+    html = render_html(config, data_compat, brand=args.brand, project_id=project_id)
+
+    OUTPUTS_DIR.mkdir(parents=True, exist_ok=True)
+    report_path = str(OUTPUTS_DIR / f"report_{timestamp()}.html")
+    with open(report_path, "w", encoding="utf-8") as f:
+        f.write(html)
+    print(f"[gen_report] Report -> {report_path}")
+
+    state = _read_state()
+    state["report_path"] = report_path
+    state["updated_at"] = timestamp()
+    _write_state(state)
+
+    print(f"[gen_report] Done.")
+
+
+if __name__ == "__main__":
+    main()

package/skills/delivery/scripts/plan.py

@@ -0,0 +1,163 @@
+#!/usr/bin/env python3
+"""Delivery 顶层状态规划器。
+
+只维护 `/workspace/state/delivery/progress.json`，不执行 intent / KB / batch
+等底层能力。其他 skill 的状态只通过路径引用记录在本文件中。
+"""
+import os, sys
+sys.path.insert(0, os.path.join(os.environ.get("SOLVEA_LIB_DIR", os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "..", "__lib__"))), "skill-runtime"))
+from bootstrap import *  # noqa: F401,F403
+
+import argparse
+import json
+from datetime import datetime, timezone
+from typing import Any
+
+
+STATE_FILE = STATE_DIR / "progress.json"
+
+STATUS_ORDER = [
+    "empty",
+    "classified",
+    "agents_created",
+    "kb_done",
+    "regression_done",
+    "done",
+]
+
+
+def default_state() -> dict[str, Any]:
+    return {
+        "status": "empty",
+        "tenant": SOLVEA_TENANT_ID or "",
+        "brand_name": "",
+        "intent": {
+            "progress_path": "/workspace/state/delivery/progress.json",
+            "classification_report_path": "",
+            "classification_excel_path": "",
+            "created_log_path": "",
+        },
+        "kb": {
+            "required": True,
+            "source_url": "",
+            "directory_plan_path": "",
+            "qa_plan_path": "",
+            "upload_result_path": "",
+        },
+        "regression": {
+            "input_path": "",
+            "touch_point": "LIVE_CHAT",
+            "results_path": "",
+            "report_html": "",
+            "report_md": "",
+        },
+        "updated_at": "",
+    }
+
+
+def merge_dict(base: dict[str, Any], patch: dict[str, Any]) -> None:
+    for key, value in patch.items():
+        if isinstance(value, dict) and isinstance(base.get(key), dict):
+            merge_dict(base[key], value)
+        else:
+            base[key] = value
+
+
+def read_state() -> dict[str, Any]:
+    if not STATE_FILE.exists():
+        return default_state()
+    try:
+        loaded = json.loads(STATE_FILE.read_text(encoding="utf-8"))
+    except Exception:
+        return default_state()
+    state = default_state()
+    merge_dict(state, loaded)
+    return state
+
+
+def write_state(state: dict[str, Any]) -> None:
+    state["updated_at"] = datetime.now(timezone.utc).isoformat()
+    STATE_FILE.parent.mkdir(parents=True, exist_ok=True)
+    STATE_FILE.write_text(json.dumps(state, ensure_ascii=False, indent=2), encoding="utf-8")
+
+
+def set_path(state: dict[str, Any], dotted_key: str, raw_value: str) -> None:
+    parts = [p for p in dotted_key.split(".") if p]
+    if not parts:
+        raise ValueError("empty key")
+    cur = state
+    for part in parts[:-1]:
+        nxt = cur.get(part)
+        if not isinstance(nxt, dict):
+            nxt = {}
+            cur[part] = nxt
+        cur = nxt
+    value: Any = raw_value
+    if raw_value.lower() == "true":
+        value = True
+    elif raw_value.lower() == "false":
+        value = False
+    elif raw_value.startswith("[") or raw_value.startswith("{"):
+        value = json.loads(raw_value)
+    cur[parts[-1]] = value
+
+
+def recommendation(status: str) -> str:
+    return {
+        "empty": "下一步：读取 delivery/interfaces/classify.md，确认从 xlsx 分类还是固定 7 意图开始。",
+        "classified": "下一步：展示分类结果并等待用户确认；确认后调用 /skills/delivery/scripts/create_agents.py --mode delivery。",
+        "agents_created": "下一步：进入 KB 阶段；如用户声称已有 KB，先 list-directories / list-knowledge 验证。",
+        "kb_done": "下一步：读取 delivery/interfaces/delivery-test.md，确认回归数据来源和 touch-point。",
+        "regression_done": "下一步：汇总 KPI 报告和失败明细，确认交付完成。",
+        "done": "当前 Delivery 已完成；如需重跑，请明确要重跑的阶段。",
+    }.get(status, "状态未知：请检查 progress.json。")
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="Delivery top-level progress planner")
+    parser.add_argument("--init", action="store_true", help="Create progress.json if missing")
+    parser.add_argument("--status", choices=STATUS_ORDER, help="Update top-level status")
+    parser.add_argument("--tenant", default=None)
+    parser.add_argument("--brand-name", default=None)
+    parser.add_argument("--set", action="append", default=[], metavar="KEY=VALUE",
+                        help="Set a dotted state path, e.g. intent.created_log_path=/workspace/...")
+    parser.add_argument("--json", action="store_true", help="Print JSON only")
+    args = parser.parse_args()
+
+    existed = STATE_FILE.exists()
+    state = read_state()
+    changed = False
+
+    if args.init and not existed:
+        changed = True
+    if args.status:
+        state["status"] = args.status
+        changed = True
+    if args.tenant is not None:
+        state["tenant"] = args.tenant
+        changed = True
+    if args.brand_name is not None:
+        state["brand_name"] = args.brand_name
+        changed = True
+    for item in args.set:
+        if "=" not in item:
+            raise SystemExit(f"--set expects KEY=VALUE, got: {item}")
+        key, value = item.split("=", 1)
+        set_path(state, key, value)
+        changed = True
+
+    if changed:
+        write_state(state)
+
+    if args.json:
+        print(json.dumps(state, ensure_ascii=False, indent=2))
+        return
+
+    print(f"Delivery progress: {STATE_FILE}")
+    print(f"status={state.get('status')} tenant={state.get('tenant') or '-'} brand={state.get('brand_name') or '-'}")
+    print(recommendation(str(state.get("status") or "")))
+    print(json.dumps(state, ensure_ascii=False, indent=2))
+
+
+if __name__ == "__main__":
+    main()