@usethink/cf-core 0.3.0

package/dist/features/payment/registry.js

@@ -0,0 +1,65 @@
+/**
+ * 支付功能模块 — Provider 注册表
+ *
+ * per-request 工厂模式：根据 env 中配置的凭证，自动实例化已配置的渠道。
+ * 支持从 DB 加载加密配置（通过 dbConfigs 参数），数据库中的配置优先于环境变量。
+ * 优先级由调用方传入 factory 数组的顺序决定。
+ *
+ * @example
+ * ```ts
+ * import { createProviderRegistry, stripeFactory, alipayFactory } from "@usethink/cf-core/features/payment";
+ *
+ * // 纯环境变量模式（向后兼容）
+ * const registry = createProviderRegistry(env, [stripeFactory, alipayFactory]);
+ *
+ * // 混合模式：DB 配置优先于 env var
+ * const registry = createProviderRegistry(env, factories, dbConfigs);
+ * const provider = registry.selectOnline();
+ * ```
+ */
+/**
+ * 创建 per-request 的 Provider 注册表。
+ *
+ * 配置加载优先级（高到低）：
+ * 1. dbConfigs[factory.name].config — 数据库中的支付配置（解密后）
+ * 2. env — 环境变量（兜底）
+ *
+ * 当 dbConfigs 存在且 enabled=true 时，DB 配置覆盖 env 中同名的键。
+ */
+export function createProviderRegistry(env, factories, dbConfigs) {
+    const registry = new Map();
+    for (const factory of factories) {
+        // 检查是否有 DB 配置
+        const dbEntry = dbConfigs?.[factory.name];
+        if (dbEntry?.enabled && dbEntry.config) {
+            // DB 配置优先：将 DB 配置合入 env（DB 值覆盖 env 同名键）
+            const mergedEnv = { ...env, ...dbEntry.config };
+            if (factory.fromDbConfig) {
+                // 工厂有专用方法则直接调用
+                registry.set(factory.name, factory.fromDbConfig(dbEntry.config));
+            }
+            else if (factory.isAvailable(mergedEnv)) {
+                // 否则合入 env 后走标准 create 路径
+                registry.set(factory.name, factory.create(mergedEnv));
+            }
+        }
+        else if (factory.isAvailable(env)) {
+            // 无 DB 配置，走环境变量路径
+            registry.set(factory.name, factory.create(env));
+        }
+    }
+    const sorted = [...factories].sort((a, b) => a.priority - b.priority);
+    return {
+        get(name) { return registry.get(name); },
+        selectOnline() {
+            for (const f of sorted) {
+                const p = registry.get(f.name);
+                if (p)
+                    return p;
+            }
+            return null;
+        },
+        list() { return [...registry.keys()]; },
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/features/payment/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../features/payment/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAkBH;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAA4B,EAC5B,SAA4B,EAC5B,SAA+B;IAE/B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEpD,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;QAChC,cAAc;QACd,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAE1C,IAAI,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACvC,wCAAwC;YACxC,MAAM,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAEhD,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;gBACzB,eAAe;gBACf,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YACnE,CAAC;iBAAM,IAAI,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1C,0BAA0B;gBAC1B,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,kBAAkB;YAClB,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAEtE,OAAO;QACL,GAAG,CAAC,IAAI,IAAI,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxC,YAAY;YACV,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACvB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC/B,IAAI,CAAC;oBAAE,OAAO,CAAC,CAAC;YAClB,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,KAAK,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;KACxC,CAAC;AACJ,CAAC"}

package/dist/features/payment/types.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 支付功能模块 — 类型定义
+ *
+ * 纯接口文件，零运行时依赖。
+ * 所有支付 Provider 实现都必须实现 PaymentProvider 接口。
+ */
+export interface CreatePaymentInput {
+    orderNo: string;
+    amountCents: number;
+    currency: string;
+    notifyUrl: string;
+    returnUrl?: string;
+    description?: string;
+    metadata?: Record<string, string>;
+}
+export interface CreatePaymentResult {
+    providerTradeNo?: string;
+    qrCode?: string;
+    redirectUrl?: string;
+    raw?: Record<string, unknown>;
+}
+export interface CallbackResult {
+    orderNo: string;
+    providerTradeNo: string;
+    amountCents: number;
+    currency: string;
+    paidAt: string;
+    raw?: Record<string, unknown>;
+}
+export interface QueryStatusResult {
+    paid: boolean;
+    providerTradeNo?: string;
+}
+export interface RefundInput {
+    providerTradeNo: string;
+    refundCents: number;
+    reason?: string;
+    refundNo?: string;
+}
+export interface RefundResult {
+    success: boolean;
+    providerRefundNo?: string;
+    status: string;
+}
+export interface PaymentProvider {
+    readonly name: string;
+    readonly displayName: string;
+    readonly supportedCurrencies: string[];
+    createPayment(input: CreatePaymentInput): Promise<CreatePaymentResult>;
+    verifyCallback(params: Record<string, string>): Promise<CallbackResult>;
+    queryStatus?(tradeNo: string): Promise<QueryStatusResult>;
+    refund?(input: RefundInput): Promise<RefundResult>;
+}
+export interface ProviderRegistry {
+    get(name: string): PaymentProvider | undefined;
+    selectOnline(): PaymentProvider | null;
+    list(): string[];
+}
+export interface ProviderFactory {
+    name: string;
+    priority: number;
+    isAvailable(env: Record<string, unknown>): boolean;
+    create(env: Record<string, unknown>): PaymentProvider;
+    /**
+     * 从数据库解密后的配置创建 Provider。
+     * 可选方法——未实现时，注册表会将 config 合入 env 再调用 create()。
+     *
+     * @param config - 解密后的扁平配置对象（键名与 env var 一致，如 { ZPAY_PID: "xxx" }）
+     */
+    fromDbConfig?(config: Record<string, unknown>): PaymentProvider;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/features/payment/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../features/payment/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IACvC,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACvE,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACxE,WAAW,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC1D,MAAM,CAAC,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACpD;AAMD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IAC/C,YAAY,IAAI,eAAe,GAAG,IAAI,CAAC;IACvC,IAAI,IAAI,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;IACnD,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAAC;IAEtD;;;;;OAKG;IACH,YAAY,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAAC;CACjE"}

package/dist/features/payment/types.js

@@ -0,0 +1,8 @@
+/**
+ * 支付功能模块 — 类型定义
+ *
+ * 纯接口文件，零运行时依赖。
+ * 所有支付 Provider 实现都必须实现 PaymentProvider 接口。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/features/payment/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../features/payment/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/features/thompson-router/index.d.ts

@@ -0,0 +1,101 @@
+/**
+ * thompson-router — Thompson Sampling 智能路由插件
+ *
+ * 基于贝叶斯多臂老虎机算法的渠道选择器：
+ * - 自动探索-利用平衡（新渠道多尝试，好渠道多使用）
+ * - Beta 分布建模成功率（α=成功次数, β=失败次数）
+ * - 自动故障转移（选中渠道失败时切换到下一候选）
+ * - 可选多维度评分（成功率+价格+延迟+容量+趋势）
+ *
+ * 来源：vcode src/services/channel-router.ts + channel-scorer.ts
+ */
+export interface ChannelCandidate {
+    id: string;
+    name: string;
+    /** Beta 分布参数 α（成功次数 + 先验） */
+    alpha: number;
+    /** Beta 分布参数 β（失败次数 + 先验） */
+    beta: number;
+    /** 是否启用 */
+    enabled: boolean;
+    /** 优先级权重（越小越优先，用于同分时排序） */
+    priority?: number;
+    /** 扩展元数据 */
+    metadata?: Record<string, unknown>;
+}
+export interface RouteDecision {
+    /** 选中的渠道 ID */
+    channelId: string;
+    /** 渠道名称 */
+    channelName: string;
+    /** 采样得分 */
+    score: number;
+    /** 候选数量 */
+    candidateCount: number;
+    /** 决策时间 */
+    timestamp: string;
+}
+export interface ThompsonRouterConfig {
+    /** Beta 分布先验参数（默认 α=1, β=1，即均匀分布） */
+    priorAlpha?: number;
+    priorBeta?: number;
+    /** 最小样本量（低于此值的渠道会被优先探索） */
+    minSamples?: number;
+}
+/**
+ * Thompson Sampling 渠道路由器
+ *
+ * @example
+ * ```ts
+ * import { ThompsonRouter } from "@usethink/cf-core/plugins/thompson-router";
+ *
+ * const router = new ThompsonRouter();
+ *
+ * // 从数据库加载候选渠道
+ * const candidates: ChannelCandidate[] = [
+ *   { id: "5sim", name: "5sim.net", alpha: 15, beta: 3, enabled: true },
+ *   { id: "grizzly", name: "GrizzlySMS", alpha: 10, beta: 5, enabled: true },
+ * ];
+ *
+ * // 选择最佳渠道
+ * const decision = router.select(candidates);
+ * console.log(decision.channelName); // 大概率选中 5sim（成功率更高）
+ *
+ * // 反馈结果（更新 Beta 参数）
+ * router.recordSuccess(candidates, "5sim"); // α += 1
+ * router.recordFailure(candidates, "5sim"); // β += 1
+ * ```
+ */
+export declare class ThompsonRouter {
+    readonly name = "thompson-router";
+    readonly version = "0.1.0";
+    private config;
+    constructor(config?: ThompsonRouterConfig);
+    /**
+     * Thompson Sampling 选择最佳渠道
+     */
+    select(candidates: ChannelCandidate[]): RouteDecision;
+    /**
+     * 选择渠道并支持自动故障转移
+     */
+    selectWithFailover(candidates: ChannelCandidate[], maxAttempts?: number): RouteDecision[];
+    /**
+     * 记录成功（更新 α 参数）
+     */
+    recordSuccess(candidates: ChannelCandidate[], channelId: string): void;
+    /**
+     * 记录失败（更新 β 参数）
+     */
+    recordFailure(candidates: ChannelCandidate[], channelId: string): void;
+}
+/**
+ * Wilson Score Interval — 小样本成功率估计
+ *
+ * 比简单 success/total 更可靠，被 Reddit/Google 等用于排序。
+ *
+ * @param successes 成功次数
+ * @param total 总次数
+ * @param z 置信水平（默认 1.96 = 95%）
+ */
+export declare function wilsonScore(successes: number, total: number, z?: number): number;
+//# sourceMappingURL=index.d.ts.map

package/dist/features/thompson-router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../features/thompson-router/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA8CD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,OAAO,WAAW;IAE3B,OAAO,CAAC,MAAM,CAAiC;gBAEnC,MAAM,GAAE,oBAAyB;IAQ7C;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,gBAAgB,EAAE,GAAG,aAAa;IA8CrD;;OAEG;IACH,kBAAkB,CAChB,UAAU,EAAE,gBAAgB,EAAE,EAC9B,WAAW,SAAI,GACd,aAAa,EAAE;IAgBlB;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,gBAAgB,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKtE;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,gBAAgB,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;CAIvE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,SAAO,GAAG,MAAM,CAO9E"}

package/dist/features/thompson-router/index.js

@@ -0,0 +1,186 @@
+/**
+ * thompson-router — Thompson Sampling 智能路由插件
+ *
+ * 基于贝叶斯多臂老虎机算法的渠道选择器：
+ * - 自动探索-利用平衡（新渠道多尝试，好渠道多使用）
+ * - Beta 分布建模成功率（α=成功次数, β=失败次数）
+ * - 自动故障转移（选中渠道失败时切换到下一候选）
+ * - 可选多维度评分（成功率+价格+延迟+容量+趋势）
+ *
+ * 来源：vcode src/services/channel-router.ts + channel-scorer.ts
+ */
+// ═══════════════════════════════════════════════════════════════════════════════
+// 统计采样工具
+// ═══════════════════════════════════════════════════════════════════════════════
+/** Marsaglia-Tsang 方法生成 Gamma 分布随机数 */
+function sampleGamma(shape) {
+    if (shape < 1) {
+        return sampleGamma(shape + 1) * Math.pow(Math.random(), 1 / shape);
+    }
+    const d = shape - 1 / 3;
+    const c = 1 / Math.sqrt(9 * d);
+    while (true) {
+        let x;
+        let v;
+        do {
+            x = gaussianRandom();
+            v = 1 + c * x;
+        } while (v <= 0);
+        v = v * v * v;
+        const u = Math.random();
+        if (u < 1 - 0.0331 * x * x * x * x)
+            return d * v;
+        if (Math.log(u) < 0.5 * x * x + d * (1 - v + Math.log(v)))
+            return d * v;
+    }
+}
+/** Box-Muller 变换生成标准正态分布 */
+function gaussianRandom() {
+    let u = 0, v = 0;
+    while (u === 0)
+        u = Math.random();
+    while (v === 0)
+        v = Math.random();
+    return Math.sqrt(-2 * Math.log(u)) * Math.cos(2 * Math.PI * v);
+}
+/** 从 Beta(α, β) 分布采样 */
+function sampleBeta(alpha, beta) {
+    const x = sampleGamma(alpha);
+    const y = sampleGamma(beta);
+    return x / (x + y);
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// ThompsonRouter
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Thompson Sampling 渠道路由器
+ *
+ * @example
+ * ```ts
+ * import { ThompsonRouter } from "@usethink/cf-core/plugins/thompson-router";
+ *
+ * const router = new ThompsonRouter();
+ *
+ * // 从数据库加载候选渠道
+ * const candidates: ChannelCandidate[] = [
+ *   { id: "5sim", name: "5sim.net", alpha: 15, beta: 3, enabled: true },
+ *   { id: "grizzly", name: "GrizzlySMS", alpha: 10, beta: 5, enabled: true },
+ * ];
+ *
+ * // 选择最佳渠道
+ * const decision = router.select(candidates);
+ * console.log(decision.channelName); // 大概率选中 5sim（成功率更高）
+ *
+ * // 反馈结果（更新 Beta 参数）
+ * router.recordSuccess(candidates, "5sim"); // α += 1
+ * router.recordFailure(candidates, "5sim"); // β += 1
+ * ```
+ */
+export class ThompsonRouter {
+    name = "thompson-router";
+    version = "0.1.0";
+    config;
+    constructor(config = {}) {
+        this.config = {
+            priorAlpha: config.priorAlpha ?? 1,
+            priorBeta: config.priorBeta ?? 1,
+            minSamples: config.minSamples ?? 5,
+        };
+    }
+    /**
+     * Thompson Sampling 选择最佳渠道
+     */
+    select(candidates) {
+        const eligible = candidates.filter((c) => c.enabled);
+        if (eligible.length === 0) {
+            throw new Error("No eligible channel candidates");
+        }
+        if (eligible.length === 1) {
+            return {
+                channelId: eligible[0].id,
+                channelName: eligible[0].name,
+                score: 1,
+                candidateCount: 1,
+                timestamp: new Date().toISOString(),
+            };
+        }
+        // 优先探索样本不足的渠道
+        const underExplored = eligible.filter((c) => (c.alpha + c.beta) < this.config.minSamples + this.config.priorAlpha + this.config.priorBeta);
+        const pool = underExplored.length > 0 ? underExplored : eligible;
+        // 对每个候选渠道从 Beta(α, β) 采样
+        let bestCandidate = pool[0];
+        let bestScore = -1;
+        for (const candidate of pool) {
+            const alpha = candidate.alpha + this.config.priorAlpha;
+            const beta = candidate.beta + this.config.priorBeta;
+            const score = sampleBeta(alpha, beta);
+            if (score > bestScore || (score === bestScore && (candidate.priority ?? 100) < (bestCandidate.priority ?? 100))) {
+                bestScore = score;
+                bestCandidate = candidate;
+            }
+        }
+        return {
+            channelId: bestCandidate.id,
+            channelName: bestCandidate.name,
+            score: bestScore,
+            candidateCount: eligible.length,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    /**
+     * 选择渠道并支持自动故障转移
+     */
+    selectWithFailover(candidates, maxAttempts = 3) {
+        const decisions = [];
+        const remaining = [...candidates];
+        for (let i = 0; i < Math.min(maxAttempts, remaining.length); i++) {
+            const decision = this.select(remaining);
+            decisions.push(decision);
+            // 移除已选渠道，下次选择时跳过
+            const idx = remaining.findIndex((c) => c.id === decision.channelId);
+            if (idx >= 0)
+                remaining.splice(idx, 1);
+            if (remaining.length === 0)
+                break;
+        }
+        return decisions;
+    }
+    /**
+     * 记录成功（更新 α 参数）
+     */
+    recordSuccess(candidates, channelId) {
+        const channel = candidates.find((c) => c.id === channelId);
+        if (channel)
+            channel.alpha += 1;
+    }
+    /**
+     * 记录失败（更新 β 参数）
+     */
+    recordFailure(candidates, channelId) {
+        const channel = candidates.find((c) => c.id === channelId);
+        if (channel)
+            channel.beta += 1;
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// Wilson Score 成功率估计（小样本更可靠）
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Wilson Score Interval — 小样本成功率估计
+ *
+ * 比简单 success/total 更可靠，被 Reddit/Google 等用于排序。
+ *
+ * @param successes 成功次数
+ * @param total 总次数
+ * @param z 置信水平（默认 1.96 = 95%）
+ */
+export function wilsonScore(successes, total, z = 1.96) {
+    if (total === 0)
+        return 0;
+    const p = successes / total;
+    const denominator = 1 + z * z / total;
+    const centre = p + z * z / (2 * total);
+    const adjustment = z * Math.sqrt((p * (1 - p) + z * z / (4 * total)) / total);
+    return (centre - adjustment) / denominator;
+}
+//# sourceMappingURL=index.js.map

package/dist/features/thompson-router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../features/thompson-router/index.ts"],"names":[],"mappings":"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"}

package/dist/features/webhook/index.d.ts

@@ -0,0 +1,76 @@
+/**
+ * webhook — Webhook 通知插件
+ *
+ * 支持：
+ * - 多 URL 通知（逗号分隔）
+ * - HMAC-SHA256 签名
+ * - 5s 超时 + 最多 2 次重试
+ * - 事件类型过滤
+ *
+ * 来源：xtools src/services/webhook.ts
+ */
+export interface WebhookConfig {
+    /** 通知 URL（支持多个，逗号分隔） */
+    urls: string;
+    /** HMAC-SHA256 签名密钥（可选） */
+    secret?: string;
+    /** 请求超时（毫秒，默认 5000） */
+    timeoutMs?: number;
+    /** 最大重试次数（默认 2） */
+    maxRetries?: number;
+}
+export interface WebhookPayload {
+    /** 事件类型 */
+    event: string;
+    /** 事件时间 ISO 8601 */
+    timestamp: string;
+    /** 事件数据 */
+    data: Record<string, unknown>;
+}
+export interface WebhookResult {
+    ok: boolean;
+    url: string;
+    status?: number;
+    error?: string;
+}
+/**
+ * Webhook 通知服务
+ *
+ * @example
+ * ```ts
+ * import { WebhookService } from "@usethink/cf-core/plugins/webhook";
+ *
+ * const webhook = new WebhookService({
+ *   urls: "https://hooks.example.com/a,https://hooks.example.com/b",
+ *   secret: "my-secret",
+ * });
+ *
+ * await webhook.notify("order.paid", { orderId: "123", amount: 9900 });
+ * ```
+ */
+export declare class WebhookService {
+    readonly name = "webhook";
+    readonly version = "0.1.0";
+    private urls;
+    private secret?;
+    private timeoutMs;
+    private maxRetries;
+    constructor(config: WebhookConfig);
+    /**
+     * 发送通知到所有 URL
+     */
+    notify(event: string, data: Record<string, unknown>): Promise<WebhookResult[]>;
+    /**
+     * 发送通知到单个 URL
+     */
+    private sendToUrl;
+    /**
+     * HMAC-SHA256 签名
+     */
+    private sign;
+    /**
+     * 是否有可用的 URL
+     */
+    get isConfigured(): boolean;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/features/webhook/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../features/webhook/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,OAAO,WAAW;IAE3B,OAAO,CAAC,IAAI,CAAW;IACvB,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,aAAa;IAUjC;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAmBpF;;OAEG;YACW,SAAS;IAuDvB;;OAEG;YACW,IAAI;IAYlB;;OAEG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;CACF"}

package/dist/features/webhook/index.js

@@ -0,0 +1,127 @@
+/**
+ * webhook — Webhook 通知插件
+ *
+ * 支持：
+ * - 多 URL 通知（逗号分隔）
+ * - HMAC-SHA256 签名
+ * - 5s 超时 + 最多 2 次重试
+ * - 事件类型过滤
+ *
+ * 来源：xtools src/services/webhook.ts
+ */
+// ═══════════════════════════════════════════════════════════════════════════════
+// WebhookService
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Webhook 通知服务
+ *
+ * @example
+ * ```ts
+ * import { WebhookService } from "@usethink/cf-core/plugins/webhook";
+ *
+ * const webhook = new WebhookService({
+ *   urls: "https://hooks.example.com/a,https://hooks.example.com/b",
+ *   secret: "my-secret",
+ * });
+ *
+ * await webhook.notify("order.paid", { orderId: "123", amount: 9900 });
+ * ```
+ */
+export class WebhookService {
+    name = "webhook";
+    version = "0.1.0";
+    urls;
+    secret;
+    timeoutMs;
+    maxRetries;
+    constructor(config) {
+        this.urls = config.urls
+            .split(",")
+            .map((u) => u.trim())
+            .filter((u) => u.startsWith("http"));
+        this.secret = config.secret;
+        this.timeoutMs = config.timeoutMs ?? 5000;
+        this.maxRetries = config.maxRetries ?? 2;
+    }
+    /**
+     * 发送通知到所有 URL
+     */
+    async notify(event, data) {
+        if (this.urls.length === 0)
+            return [];
+        const payload = {
+            event,
+            timestamp: new Date().toISOString(),
+            data,
+        };
+        const results = [];
+        for (const url of this.urls) {
+            const result = await this.sendToUrl(url, payload);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * 发送通知到单个 URL
+     */
+    async sendToUrl(url, payload) {
+        const body = JSON.stringify(payload);
+        const headers = {
+            "Content-Type": "application/json",
+            "X-Webhook-Event": payload.event,
+            "X-Webhook-Timestamp": payload.timestamp,
+        };
+        if (this.secret) {
+            const signature = await this.sign(body);
+            headers["X-Webhook-Signature"] = signature;
+        }
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            try {
+                const controller = new AbortController();
+                const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+                const res = await fetch(url, {
+                    method: "POST",
+                    headers,
+                    body,
+                    signal: controller.signal,
+                });
+                clearTimeout(timeout);
+                if (res.ok) {
+                    return { ok: true, url, status: res.status };
+                }
+                if (res.status >= 400 && res.status < 500) {
+                    return { ok: false, url, status: res.status, error: `HTTP ${res.status}` };
+                }
+                if (attempt < this.maxRetries) {
+                    await new Promise((r) => setTimeout(r, 1000 * (attempt + 1)));
+                    continue;
+                }
+                return { ok: false, url, status: res.status, error: `HTTP ${res.status} after ${this.maxRetries + 1} attempts` };
+            }
+            catch (err) {
+                const errMsg = err instanceof Error ? err.message : String(err);
+                if (attempt < this.maxRetries) {
+                    await new Promise((r) => setTimeout(r, 1000 * (attempt + 1)));
+                    continue;
+                }
+                return { ok: false, url, error: errMsg };
+            }
+        }
+        return { ok: false, url, error: "unexpected" };
+    }
+    /**
+     * HMAC-SHA256 签名
+     */
+    async sign(body) {
+        const key = await crypto.subtle.importKey("raw", new TextEncoder().encode(this.secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+        const signature = await crypto.subtle.sign("HMAC", key, new TextEncoder().encode(body));
+        return [...new Uint8Array(signature)].map((b) => b.toString(16).padStart(2, "0")).join("");
+    }
+    /**
+     * 是否有可用的 URL
+     */
+    get isConfigured() {
+        return this.urls.length > 0;
+    }
+}
+//# sourceMappingURL=index.js.map