@wowok/agent-mcp 2.3.14 → 2.3.18

package/dist/knowledge/intent-metrics.js

@@ -0,0 +1,566 @@
+import { INDUSTRY_EVOLUTION_THRESHOLDS } from "./industry-evolution.js";
+export const BUILTIN_INTENT_SPECS = {
+    default: {
+        intent: "default",
+        display_name: "默认（Phase 4 原始模型）",
+        weights: {
+            completed_rate: 35,
+            dispute_rate: 25,
+            refund_rate: 15,
+            repeat_buyer_rate: 15,
+            cycle_efficiency: 10,
+        },
+        healthy_thresholds: {
+            completed_rate: 0.9,
+            dispute_rate: 0.05,
+            refund_rate: 0.05,
+            repeat_buyer_rate: 0.3,
+            cycle_efficiency: 24 * 7,
+        },
+        suggestion_triggers: [],
+        level_thresholds: { thriving: 85, healthy: 65, stressed: 45 },
+    },
+    growth: {
+        intent: "growth",
+        display_name: "增长（关注新客、复购、订单增速）",
+        weights: {
+            repeat_buyer_rate: 35,
+            completed_rate: 25,
+            dispute_rate: 15,
+            refund_rate: 10,
+            cycle_efficiency: 15,
+        },
+        healthy_thresholds: {
+            completed_rate: 0.85,
+            dispute_rate: 0.08,
+            repeat_buyer_rate: 0.25,
+            cycle_efficiency: 24 * 14,
+        },
+        suggestion_triggers: [
+            {
+                metric: "repeat_buyer_rate",
+                operator: ">=",
+                threshold: 0.3,
+                suggestion_type: "update_flywheel",
+                field: "flywheel.rewardStrategy",
+                suggested_value: "强化忠诚度 Reward + 阶梯复购奖励 + 推荐返现",
+                evidence_template: "增长意图下复购率 {value}% ≥ {threshold}%，建议强化忠诚度飞轮",
+                confidence: 0.85,
+                priority: "high",
+                target_roles: ["merchant"],
+            },
+            {
+                metric: "repeat_buyer_rate",
+                operator: "<",
+                threshold: 0.15,
+                suggestion_type: "update_flywheel",
+                field: "flywheel.rewardStrategy",
+                suggested_value: "首单奖励 + 7 日内复购折扣 + 推荐返现",
+                evidence_template: "增长意图下复购率 {value}% < {threshold}%，建议加强首单激励",
+                confidence: 0.75,
+                priority: "medium",
+                target_roles: ["merchant"],
+            },
+        ],
+        level_thresholds: { thriving: 80, healthy: 60, stressed: 40 },
+        role_advice_routing: {
+            user: ["关注复购 Reward 与推荐返现"],
+            merchant: ["强化忠诚度飞轮", "优化首单转化", "加大 Reward 投入"],
+            arbitrator: [],
+        },
+    },
+    retention: {
+        intent: "retention",
+        display_name: "留存（关注复购、争议、退款）",
+        weights: {
+            repeat_buyer_rate: 30,
+            dispute_rate: 30,
+            refund_rate: 25,
+            completed_rate: 15,
+            cycle_efficiency: 0,
+        },
+        healthy_thresholds: {
+            completed_rate: 0.8,
+            dispute_rate: 0.05,
+            refund_rate: 0.05,
+            repeat_buyer_rate: 0.25,
+        },
+        suggestion_triggers: [
+            {
+                metric: "dispute_rate",
+                operator: ">",
+                threshold: 0.1,
+                suggestion_type: "add_risk_check",
+                field: "risk_checks",
+                suggested_value: {
+                    id: "retention_dispute_check",
+                    description: "留存意图：争议率高，建议强制仲裁 + 赔偿金",
+                    weight: 35,
+                },
+                evidence_template: "留存意图下争议率 {value}% > {threshold}%，建议加强纠纷解决通道",
+                confidence: 0.85,
+                priority: "high",
+                target_roles: ["merchant", "arbitrator"],
+            },
+            {
+                metric: "refund_rate",
+                operator: ">",
+                threshold: 0.1,
+                suggestion_type: "adjust_preference",
+                field: "preference_template.require_arbitration",
+                suggested_value: true,
+                evidence_template: "留存意图下退款率 {value}% > {threshold}%，建议强制仲裁",
+                confidence: 0.8,
+                priority: "high",
+                target_roles: ["user", "merchant"],
+            },
+        ],
+        level_thresholds: { thriving: 80, healthy: 60, stressed: 45 },
+        role_advice_routing: {
+            user: ["优先选择有仲裁的商家", "关注退款政策"],
+            merchant: ["降低争议率", "优化退款流程", "加强交付质量"],
+            arbitrator: ["关注高争议行业", "主动提供纠纷解决通道"],
+        },
+    },
+    compliance: {
+        intent: "compliance",
+        display_name: "合规（关注仲裁、赔偿金、监管）",
+        weights: {
+            arbitration_coverage: 35,
+            compensation_coverage: 30,
+            dispute_rate: 20,
+            refund_rate: 15,
+            completed_rate: 0,
+            repeat_buyer_rate: 0,
+            cycle_efficiency: 0,
+        },
+        healthy_thresholds: {
+            arbitration_coverage: 1.0,
+            compensation_coverage: 0.8,
+            dispute_rate: 0.05,
+        },
+        suggestion_triggers: [
+            {
+                metric: "arbitration_coverage",
+                operator: "<",
+                threshold: 1.0,
+                suggestion_type: "adjust_preference",
+                field: "preference_template.require_arbitration",
+                suggested_value: true,
+                evidence_template: "合规意图下仲裁覆盖率 {value}% < 100%，建议强制配置仲裁",
+                confidence: 0.95,
+                priority: "high",
+                target_roles: ["merchant", "arbitrator"],
+            },
+            {
+                metric: "compensation_coverage",
+                operator: "<",
+                threshold: 0.8,
+                suggestion_type: "add_risk_check",
+                field: "risk_checks",
+                suggested_value: {
+                    id: "compliance_compensation_check",
+                    description: "合规意图：赔偿金覆盖率不足",
+                    weight: 40,
+                },
+                evidence_template: "合规意图下赔偿金覆盖率 {value}% < {threshold}%，建议增加赔偿金",
+                confidence: 0.9,
+                priority: "high",
+                target_roles: ["merchant"],
+            },
+        ],
+        level_thresholds: { thriving: 90, healthy: 70, stressed: 50 },
+        role_advice_routing: {
+            user: ["只与有仲裁的商家交易", "确认赔偿金充足"],
+            merchant: ["配置仲裁", "增加赔偿金", "合规优先"],
+            arbitrator: ["主动监控高监管行业", "提供合规咨询"],
+        },
+    },
+    efficiency: {
+        intent: "efficiency",
+        display_name: "效率（关注周期、里程碑、沟通）",
+        weights: {
+            cycle_efficiency: 45,
+            milestone_adoption: 25,
+            completed_rate: 20,
+            dispute_rate: 10,
+            refund_rate: 0,
+            repeat_buyer_rate: 0,
+        },
+        healthy_thresholds: {
+            cycle_efficiency: 24 * 3,
+            milestone_adoption: 0.6,
+            completed_rate: 0.9,
+        },
+        suggestion_triggers: [
+            {
+                metric: "cycle_efficiency",
+                operator: ">",
+                threshold: 24 * 14,
+                suggestion_type: "adjust_preference",
+                field: "preference_template.max_acceptable_cycle",
+                suggested_value: 14,
+                evidence_template: "效率意图下平均周期 {value} 小时 > {threshold} 小时，建议缩短最大可接受周期",
+                confidence: 0.8,
+                priority: "high",
+                target_roles: ["merchant"],
+            },
+            {
+                metric: "milestone_adoption",
+                operator: "<",
+                threshold: 0.4,
+                suggestion_type: "update_flywheel",
+                field: "flywheel.keyActions",
+                suggested_value: "增加里程碑节点 + 分阶段验收 Reward",
+                evidence_template: "效率意图下里程碑采用率 {value}% < {threshold}%，建议引入里程碑",
+                confidence: 0.75,
+                priority: "medium",
+                target_roles: ["merchant"],
+            },
+        ],
+        level_thresholds: { thriving: 85, healthy: 65, stressed: 45 },
+        role_advice_routing: {
+            user: ["优先选择有里程碑的商家"],
+            merchant: ["优化 Machine 节点拆分", "引入里程碑验收", "缩短交付周期"],
+            arbitrator: [],
+        },
+    },
+    trust_building: {
+        intent: "trust_building",
+        display_name: "信任建设（关注仲裁独立性、评价、赔偿金）",
+        weights: {
+            arbitration_coverage: 25,
+            compensation_coverage: 25,
+            review_openness: 20,
+            dispute_rate: 15,
+            completed_rate: 15,
+            repeat_buyer_rate: 0,
+            refund_rate: 0,
+            cycle_efficiency: 0,
+        },
+        healthy_thresholds: {
+            arbitration_coverage: 1.0,
+            compensation_coverage: 0.8,
+            review_openness: 0.5,
+            dispute_rate: 0.05,
+        },
+        suggestion_triggers: [
+            {
+                metric: "review_openness",
+                operator: "<",
+                threshold: 0.3,
+                suggestion_type: "update_flywheel",
+                field: "flywheel.trustSellingPoints",
+                suggested_value: "公开评价上链 + 带凭证评价权重更高",
+                evidence_template: "信任建设意图下评价公开度 {value}% < {threshold}%，建议引入公开评价",
+                confidence: 0.8,
+                priority: "medium",
+                target_roles: ["merchant"],
+            },
+            {
+                metric: "arbitration_coverage",
+                operator: "<",
+                threshold: 1.0,
+                suggestion_type: "add_risk_check",
+                field: "risk_checks",
+                suggested_value: {
+                    id: "trust_arbitration_check",
+                    description: "信任建设：仲裁未配置",
+                    weight: 35,
+                },
+                evidence_template: "信任建设意图下仲裁覆盖率 {value}% < 100%，建议强制配置仲裁",
+                confidence: 0.9,
+                priority: "high",
+                target_roles: ["merchant", "arbitrator"],
+            },
+        ],
+        level_thresholds: { thriving: 85, healthy: 65, stressed: 50 },
+        role_advice_routing: {
+            user: ["查看公开评价", "确认仲裁独立性"],
+            merchant: ["引入公开评价 Repository", "配置仲裁", "增加赔偿金"],
+            arbitrator: ["保持独立性", "主动公开判决理由"],
+        },
+    },
+    custom: {
+        intent: "custom",
+        display_name: "自定义（运行时注册）",
+        weights: {},
+        healthy_thresholds: {},
+        suggestion_triggers: [],
+    },
+};
+const intentRegistry = new Map();
+for (const [k, v] of Object.entries(BUILTIN_INTENT_SPECS)) {
+    intentRegistry.set(k, v);
+}
+export function registerIntentProfile(spec) {
+    if (!spec.intent || !spec.weights)
+        return false;
+    intentRegistry.set(spec.intent, spec);
+    return true;
+}
+export function getIntentProfile(intent) {
+    return intentRegistry.get(intent);
+}
+export function listIntents() {
+    return Array.from(intentRegistry.keys());
+}
+export function _resetIntentRegistryForTest() {
+    intentRegistry.clear();
+    for (const [k, v] of Object.entries(BUILTIN_INTENT_SPECS)) {
+        intentRegistry.set(k, v);
+    }
+}
+export function evaluateIndustryHealthByIntent(industry, metrics, intent = "default") {
+    const spec = intentRegistry.get(intent) ?? intentRegistry.get("default");
+    const weights = spec.weights;
+    const thresholds = spec.healthy_thresholds;
+    const totalWeight = Object.values(weights).reduce((s, w) => s + (w ?? 0), 0) || 100;
+    const strengths = [];
+    const weaknesses = [];
+    const recommendations = [];
+    if (metrics.sample_size < INDUSTRY_EVOLUTION_THRESHOLDS.min_sample_size) {
+        weaknesses.push(`样本量不足（${metrics.sample_size} < ${INDUSTRY_EVOLUTION_THRESHOLDS.min_sample_size}），评估置信度低`);
+        recommendations.push("继续累积订单数据以提升评估精度");
+    }
+    let healthScore = 0;
+    const wCompleted = weights.completed_rate ?? 0;
+    if (wCompleted > 0) {
+        const score = metrics.completed_rate * wCompleted;
+        healthScore += score;
+        const thr = thresholds.completed_rate ?? 0.9;
+        if (metrics.completed_rate >= thr) {
+            strengths.push(`完成率高（${Math.round(metrics.completed_rate * 100)}%）`);
+        }
+        else if (metrics.completed_rate < thr * 0.8) {
+            weaknesses.push(`完成率偏低（${Math.round(metrics.completed_rate * 100)}%）`);
+            recommendations.push("排查未完成订单根因，加强 Messenger 沟通");
+        }
+    }
+    const wDispute = weights.dispute_rate ?? 0;
+    if (wDispute > 0) {
+        const score = (1 - Math.min(1, metrics.dispute_rate)) * wDispute;
+        healthScore += score;
+        const thr = thresholds.dispute_rate ?? 0.05;
+        if (metrics.dispute_rate <= thr) {
+            strengths.push(`争议率低（${Math.round(metrics.dispute_rate * 100)}%）`);
+        }
+        else if (metrics.dispute_rate > thr * 2) {
+            weaknesses.push(`争议率高（${Math.round(metrics.dispute_rate * 100)}%）`);
+            recommendations.push("争议率超阈值，建议强制配置仲裁 + 赔偿金 + 交付 Guard");
+        }
+    }
+    const wRefund = weights.refund_rate ?? 0;
+    if (wRefund > 0) {
+        const score = (1 - Math.min(1, metrics.refund_rate)) * wRefund;
+        healthScore += score;
+        if (metrics.refund_rate > 0.2) {
+            weaknesses.push(`退款率高（${Math.round(metrics.refund_rate * 100)}%）`);
+            recommendations.push("退款率异常，建议检查交付质量或商品描述一致性");
+        }
+    }
+    const wRepeat = weights.repeat_buyer_rate ?? 0;
+    if (wRepeat > 0) {
+        const score = Math.min(1, metrics.repeat_buyer_rate) * wRepeat;
+        healthScore += score;
+        const thr = thresholds.repeat_buyer_rate ?? 0.25;
+        if (metrics.repeat_buyer_rate >= thr) {
+            strengths.push(`复购率高（${Math.round(metrics.repeat_buyer_rate * 100)}%）`);
+        }
+        else if (metrics.repeat_buyer_rate < thr * 0.5 && metrics.sample_size >= 20) {
+            weaknesses.push(`复购率低（${Math.round(metrics.repeat_buyer_rate * 100)}%）`);
+            recommendations.push("复购率低，建议设置忠诚度 Reward + 推荐返现");
+        }
+    }
+    const wCycle = weights.cycle_efficiency ?? 0;
+    if (wCycle > 0 && metrics.avg_cycle_hours > 0) {
+        const cycleScore = Math.max(0, Math.min(1, 1 - (metrics.avg_cycle_hours / 24 - 7) / 23));
+        healthScore += cycleScore * wCycle;
+        const thr = thresholds.cycle_efficiency ?? 24 * 7;
+        if (metrics.avg_cycle_hours <= thr) {
+            strengths.push(`交付周期短（${Math.round(metrics.avg_cycle_hours)} 小时）`);
+        }
+        else if (metrics.avg_cycle_hours > 24 * 30) {
+            weaknesses.push(`交付周期过长（${Math.round(metrics.avg_cycle_hours / 24)} 天）`);
+            recommendations.push("交付周期过长，建议优化 Machine 节点拆分");
+        }
+    }
+    const wArb = weights.arbitration_coverage ?? 0;
+    if (wArb > 0) {
+        const hasArbAnomaly = metrics.anomalies.some((a) => a.includes("仲裁"));
+        const coverage = hasArbAnomaly ? 0 : 1;
+        const score = coverage * wArb;
+        healthScore += score;
+        if (coverage < 1) {
+            weaknesses.push("仲裁覆盖率不足");
+            recommendations.push("建议强制配置仲裁（合规/信任意图下必备）");
+        }
+    }
+    const wComp = weights.compensation_coverage ?? 0;
+    if (wComp > 0) {
+        const hasCompAnomaly = metrics.anomalies.some((a) => a.includes("赔偿金"));
+        const coverage = hasCompAnomaly ? 0 : 1;
+        const score = coverage * wComp;
+        healthScore += score;
+        if (coverage < 0.8) {
+            weaknesses.push("赔偿金覆盖率不足");
+            recommendations.push("建议增加 compensation_fund 余额");
+        }
+    }
+    const wMilestone = weights.milestone_adoption ?? 0;
+    if (wMilestone > 0) {
+        const adoptionSignal = metrics.trait_signals.long_cycle === true ? 0.6 : 0.3;
+        const score = adoptionSignal * wMilestone;
+        healthScore += score;
+        if (adoptionSignal < 0.4) {
+            weaknesses.push("里程碑采用率低");
+            recommendations.push("建议引入里程碑节点 + 分阶段验收");
+        }
+    }
+    const wReview = weights.review_openness ?? 0;
+    if (wReview > 0) {
+        const hasReviewPattern = metrics.emerging_patterns.some((p) => p.includes("评价"));
+        const openness = hasReviewPattern ? 0.6 : 0.3;
+        const score = openness * wReview;
+        healthScore += score;
+        if (openness < 0.4) {
+            weaknesses.push("评价公开度低");
+            recommendations.push("建议引入公开评价 Repository");
+        }
+    }
+    const normalizedScore = Math.round((healthScore / totalWeight) * 100);
+    const lvlThr = spec.level_thresholds ?? {};
+    const thrivingThr = lvlThr.thriving ?? 85;
+    const healthyThr = lvlThr.healthy ?? 65;
+    const stressedThr = lvlThr.stressed ?? 45;
+    let level;
+    if (normalizedScore >= thrivingThr)
+        level = "thriving";
+    else if (normalizedScore >= healthyThr)
+        level = "healthy";
+    else if (normalizedScore >= stressedThr)
+        level = "stressed";
+    else
+        level = "declining";
+    return {
+        industry,
+        health_score: normalizedScore,
+        level,
+        strengths,
+        weaknesses,
+        recommendations,
+        trait_drift: undefined,
+    };
+}
+export function suggestIndustryUpdateByIntent(industry, metrics, intent = "default") {
+    if (metrics.sample_size < INDUSTRY_EVOLUTION_THRESHOLDS.min_sample_size) {
+        return [];
+    }
+    const spec = intentRegistry.get(intent) ?? intentRegistry.get("default");
+    const suggestions = [];
+    for (const trigger of spec.suggestion_triggers) {
+        const metricValue = getMetricValue(metrics, trigger.metric);
+        if (metricValue === undefined)
+            continue;
+        const matched = compareMetric(metricValue, trigger.operator, trigger.threshold);
+        if (matched) {
+            suggestions.push({
+                industry,
+                suggestion_type: trigger.suggestion_type,
+                field: trigger.field,
+                current_value: metricValue,
+                suggested_value: trigger.suggested_value,
+                evidence: renderEvidence(trigger.evidence_template, metricValue, trigger.threshold),
+                confidence: trigger.confidence,
+                priority: trigger.priority,
+            });
+        }
+    }
+    return suggestions;
+}
+function getMetricValue(metrics, dim) {
+    switch (dim) {
+        case "completed_rate": return metrics.completed_rate;
+        case "dispute_rate": return metrics.dispute_rate;
+        case "refund_rate": return metrics.refund_rate;
+        case "repeat_buyer_rate": return metrics.repeat_buyer_rate;
+        case "cycle_efficiency": return metrics.avg_cycle_hours;
+        case "arbitration_coverage":
+            return metrics.anomalies.some((a) => a.includes("仲裁")) ? 0 : 1;
+        case "compensation_coverage":
+            return metrics.anomalies.some((a) => a.includes("赔偿金")) ? 0 : 1;
+        case "milestone_adoption":
+            return metrics.trait_signals.long_cycle === true ? 0.6 : 0.3;
+        case "review_openness":
+            return metrics.emerging_patterns.some((p) => p.includes("评价")) ? 0.6 : 0.3;
+        default: return undefined;
+    }
+}
+function compareMetric(value, op, threshold) {
+    switch (op) {
+        case ">=": return value >= threshold;
+        case "<=": return value <= threshold;
+        case ">": return value > threshold;
+        case "<": return value < threshold;
+        case "==": return value === threshold;
+        default: return false;
+    }
+}
+function renderEvidence(template, value, threshold) {
+    return template
+        .replace(/\{value\}/g, String(Math.round(value * 100)))
+        .replace(/\{threshold\}/g, String(Math.round(threshold * 100)));
+}
+export function evaluateIndustryHealthMultiIntent(industry, metrics, intents) {
+    if (intents.length === 0) {
+        return evaluateIndustryHealthByIntent(industry, metrics, "default");
+    }
+    const totalWeight = intents.reduce((s, i) => s + i.weight, 0) || 1;
+    let combinedScore = 0;
+    const allStrengths = [];
+    const allWeaknesses = [];
+    const allRecommendations = [];
+    for (const { intent, weight } of intents) {
+        const report = evaluateIndustryHealthByIntent(industry, metrics, intent);
+        combinedScore += report.health_score * weight;
+        allStrengths.push(...report.strengths);
+        allWeaknesses.push(...report.weaknesses);
+        allRecommendations.push(...report.recommendations);
+    }
+    const finalScore = Math.round(combinedScore / totalWeight);
+    const strengths = Array.from(new Set(allStrengths));
+    const weaknesses = Array.from(new Set(allWeaknesses));
+    const recommendations = Array.from(new Set(allRecommendations));
+    let level;
+    if (finalScore >= 85)
+        level = "thriving";
+    else if (finalScore >= 65)
+        level = "healthy";
+    else if (finalScore >= 45)
+        level = "stressed";
+    else
+        level = "declining";
+    return {
+        industry,
+        health_score: finalScore,
+        level,
+        strengths,
+        weaknesses,
+        recommendations,
+        trait_drift: undefined,
+    };
+}
+export function getRoleAdvice(intent, role) {
+    const spec = intentRegistry.get(intent);
+    if (!spec?.role_advice_routing)
+        return [];
+    return spec.role_advice_routing[role] ?? [];
+}
+export function filterSuggestionsByRole(suggestions, role, triggers = []) {
+    return suggestions.filter((s) => {
+        const trigger = triggers.find((t) => t.suggestion_type === s.suggestion_type && t.field === s.field);
+        if (!trigger?.target_roles)
+            return true;
+        return trigger.target_roles.includes(role);
+    });
+}

package/dist/knowledge/process-model.d.ts

@@ -0,0 +1,24 @@
+export type PermissionScope = "organization" | "order" | "order_holder";
+export interface PermissionTypeDef {
+    name: "Permission" | "NamedOperator" | "OrderHolder";
+    scope: PermissionScope;
+    definedOn: string;
+    controls: string;
+    grantedBy: string;
+    example: string;
+}
+export declare const PERMISSION_TYPES: PermissionTypeDef[];
+export type GameElementType = "player" | "strategy" | "payoff" | "utility" | "equilibrium" | "information" | "sequence" | "repetition" | "commitment" | "punishment" | "reward" | "reputation" | "signaling" | "screening" | "bargaining" | "auction" | "mechanism" | "constraint" | "uncertainty" | "cooperation";
+export interface GameElementDef {
+    id: number;
+    type: GameElementType;
+    name: string;
+    description: string;
+    wowokApplication: string;
+    onChainMechanism: string;
+}
+export declare const GAME_ELEMENTS: GameElementDef[];
+export declare function getPermissionType(name: string): PermissionTypeDef | undefined;
+export declare function getGameElement(id: number): GameElementDef | undefined;
+export declare function getGameElementsByType(type: GameElementType): GameElementDef[];
+export declare const PROCESS_MODEL_VERSION = 1;