aifastdb 2.2.6 → 2.3.8

package/dist/carpool/carpool-matcher.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * Carpool Matcher - Matching Engine
+ *
+ * 拼车匹配引擎：过滤、评分、排序。
+ * 综合社交信任度、历史评分、路线匹配度、发布时间来排序搜索结果。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CarpoolMatcher = void 0;
+const DEFAULT_WEIGHTS = {
+    trust: 0.4,
+    rating: 0.3,
+    route: 0.2,
+    freshness: 0.1,
+};
+// ============================================================================
+// Matcher Class
+// ============================================================================
+class CarpoolMatcher {
+    constructor(weights) {
+        this.weights = { ...DEFAULT_WEIGHTS, ...weights };
+    }
+    /**
+     * 计算路线匹配度（0~1）
+     *
+     * 匹配规则：出发地和目的地各占 50%
+     * - 区级匹配：100%
+     * - 市级匹配：80%
+     * - 省级匹配：60%
+     * - 不匹配：0%
+     */
+    calculateRouteMatch(tripOrigin, tripDest, filterOrigin, filterDest) {
+        let originScore = 1.0; // 未指定过滤条件时默认满分
+        let destScore = 1.0;
+        if (filterOrigin) {
+            originScore = this.locationMatch(tripOrigin, filterOrigin);
+        }
+        if (filterDest) {
+            destScore = this.locationMatch(tripDest, filterDest);
+        }
+        return (originScore + destScore) / 2;
+    }
+    /**
+     * 计算综合匹配分数（0~100）
+     */
+    calculateMatchScore(trip, trustScore, personRating, filter) {
+        const reasons = [];
+        // 1. 信任度分 (0~1)
+        const trustPart = trustScore.score;
+        if (trustScore.level === 'trusted')
+            reasons.push('直接好友');
+        else if (trustScore.level === 'semi_trusted')
+            reasons.push(trustScore.reason);
+        else if (trustScore.level === 'known')
+            reasons.push(trustScore.reason);
+        // 2. 历史评分 (0~1, 归一化 0~5 → 0~1)
+        const ratingPart = personRating / 5.0;
+        if (personRating >= 4.5)
+            reasons.push('好评如潮');
+        else if (personRating >= 4.0)
+            reasons.push('口碑良好');
+        // 3. 路线匹配度 (0~1)
+        const filterOrigin = {};
+        const filterDest = {};
+        if (filter?.origin_province)
+            filterOrigin.province = filter.origin_province;
+        if (filter?.origin_city)
+            filterOrigin.city = filter.origin_city;
+        if (filter?.destination_province)
+            filterDest.province = filter.destination_province;
+        if (filter?.destination_city)
+            filterDest.city = filter.destination_city;
+        const routePart = this.calculateRouteMatch(trip.properties.origin, trip.properties.destination, Object.keys(filterOrigin).length > 0 ? filterOrigin : undefined, Object.keys(filterDest).length > 0 ? filterDest : undefined);
+        if (routePart >= 0.9)
+            reasons.push('路线高度吻合');
+        else if (routePart >= 0.7)
+            reasons.push('路线基本吻合');
+        // 4. 新鲜度 (0~1, 7天内线性衰减)
+        const ageMs = Date.now() - trip.created_at;
+        const ageDays = ageMs / (1000 * 60 * 60 * 24);
+        const freshnessPart = Math.max(0, 1 - ageDays / 7);
+        if (freshnessPart > 0.8)
+            reasons.push('新发布');
+        // 综合加权
+        const score = (trustPart * this.weights.trust +
+            ratingPart * this.weights.rating +
+            routePart * this.weights.route +
+            freshnessPart * this.weights.freshness) * 100;
+        return {
+            score: Math.round(Math.min(100, Math.max(0, score)) * 10) / 10,
+            reasons,
+        };
+    }
+    /**
+     * 对匹配结果排序
+     */
+    rankResults(results) {
+        return results.sort((a, b) => b.match_score - a.match_score);
+    }
+    // ==========================================================================
+    // Internal Helpers
+    // ==========================================================================
+    /**
+     * 计算位置匹配度（0~1）
+     */
+    locationMatch(actual, filter) {
+        // 如果过滤条件中有区级
+        if (filter.district && actual.district) {
+            if (actual.district === filter.district &&
+                actual.city === filter.city &&
+                actual.province === filter.province) {
+                return 1.0;
+            }
+        }
+        // 市级匹配
+        if (filter.city) {
+            if (actual.city === filter.city && actual.province === (filter.province ?? actual.province)) {
+                return 0.8;
+            }
+        }
+        // 省级匹配
+        if (filter.province) {
+            if (actual.province === filter.province) {
+                return 0.6;
+            }
+            return 0.0; // 省份不匹配
+        }
+        // 未指定，默认满分
+        return 1.0;
+    }
+}
+exports.CarpoolMatcher = CarpoolMatcher;
+//# sourceMappingURL=carpool-matcher.js.map

package/dist/carpool/carpool-matcher.js.map

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

package/dist/carpool/carpool-matcher.test.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * CarpoolMatcher & TrustEvaluator - Unit Tests
+ *
+ * 匹配引擎与社交信任评估的细粒度单元测试。
+ * 覆盖路线匹配、综合评分、排序、信任等级计算等。
+ */
+export {};
+//# sourceMappingURL=carpool-matcher.test.d.ts.map

package/dist/carpool/carpool-matcher.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"carpool-matcher.test.d.ts","sourceRoot":"","sources":["../../ts/carpool/carpool-matcher.test.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/carpool/carpool-matcher.test.js

@@ -0,0 +1,403 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * CarpoolMatcher & TrustEvaluator - Unit Tests
+ *
+ * 匹配引擎与社交信任评估的细粒度单元测试。
+ * 覆盖路线匹配、综合评分、排序、信任等级计算等。
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const social_graph_v2_1 = require("../social-graph-v2");
+const carpool_matcher_1 = require("./carpool-matcher");
+const trust_evaluator_1 = require("./trust-evaluator");
+const types_1 = require("./types");
+// ============================================================================
+// Test Utilities
+// ============================================================================
+let passed = 0;
+let failed = 0;
+const failures = [];
+function assert(condition, message) {
+    if (condition) {
+        passed++;
+        console.log(`  ✅ ${message}`);
+    }
+    else {
+        failed++;
+        failures.push(message);
+        console.log(`  ❌ ${message}`);
+    }
+}
+function section(name) {
+    console.log(`\n━━━ ${name} ━━━`);
+}
+/** 创建模拟 CarpoolTrip 用于纯逻辑测试 */
+function mockTrip(overrides) {
+    const { id = `trip-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`, created_at = Date.now(), ...propOverrides } = overrides ?? {};
+    return {
+        id,
+        name: '测试行程',
+        entity_type: types_1.ENTITY_TYPE_CARPOOL_TRIP,
+        created_at,
+        updated_at: created_at,
+        properties: {
+            trip_type: 'offer',
+            departure_date: '2026-02-20',
+            origin: { province: '北京', city: '北京', district: '朝阳区' },
+            destination: { province: '河南', city: '漯河' },
+            max_passengers: 3,
+            current_passengers: 0,
+            gender_requirement: 'any',
+            price_type: 'share_cost',
+            status: 'open',
+            ...propOverrides,
+        },
+    };
+}
+function mockTrustScore(overrides) {
+    return {
+        score: 0.5,
+        level: 'semi_trusted',
+        reason: '测试信任',
+        mutual_friends_count: 0,
+        social_distance: 2,
+        ...overrides,
+    };
+}
+// ============================================================================
+// CarpoolMatcher Tests
+// ============================================================================
+async function main() {
+    console.log('🧪 CarpoolMatcher & TrustEvaluator 单元测试\n');
+    // ==========================================================================
+    // Part 1: CarpoolMatcher - 路线匹配
+    // ==========================================================================
+    section('calculateRouteMatch - 区级匹配');
+    {
+        const matcher = new carpool_matcher_1.CarpoolMatcher();
+        const origin = { province: '北京', city: '北京', district: '朝阳区' };
+        const dest = { province: '河南', city: '漯河', district: '源汇区' };
+        // 完全匹配（区级）
+        const score1 = matcher.calculateRouteMatch(origin, dest, { province: '北京', city: '北京', district: '朝阳区' }, { province: '河南', city: '漯河', district: '源汇区' });
+        assert(Math.abs(score1 - 1.0) < 0.01, `区级完全匹配: ${score1} ≈ 1.0`);
+    }
+    section('calculateRouteMatch - 市级匹配');
+    {
+        const matcher = new carpool_matcher_1.CarpoolMatcher();
+        const origin = { province: '北京', city: '北京', district: '朝阳区' };
+        const dest = { province: '河南', city: '漯河' };
+        const score = matcher.calculateRouteMatch(origin, dest, { province: '北京', city: '北京' }, { province: '河南', city: '漯河' });
+        assert(Math.abs(score - 0.8) < 0.01, `市级匹配: ${score} ≈ 0.8`);
+    }
+    section('calculateRouteMatch - 省级匹配');
+    {
+        const matcher = new carpool_matcher_1.CarpoolMatcher();
+        const origin = { province: '北京', city: '北京' };
+        const dest = { province: '河南', city: '漯河' };
+        const score = matcher.calculateRouteMatch(origin, dest, { province: '北京' }, { province: '河南' });
+        assert(Math.abs(score - 0.6) < 0.01, `省级匹配: ${score} ≈ 0.6`);
+    }
+    section('calculateRouteMatch - 不匹配');
+    {
+        const matcher = new carpool_matcher_1.CarpoolMatcher();
+        const origin = { province: '北京', city: '北京' };
+        const dest = { province: '河南', city: '漯河' };
+        const score = matcher.calculateRouteMatch(origin, dest, { province: '上海' }, { province: '广东' });
+        assert(Math.abs(score - 0.0) < 0.01, `完全不匹配: ${score} ≈ 0.0`);
+    }
+    section('calculateRouteMatch - 部分过滤');
+    {
+        const matcher = new carpool_matcher_1.CarpoolMatcher();
+        const origin = { province: '北京', city: '北京' };
+        const dest = { province: '河南', city: '漯河' };
+        // 只过滤出发地
+        const score1 = matcher.calculateRouteMatch(origin, dest, { city: '北京' }, undefined);
+        assert(score1 > 0.8, `只过滤出发地: ${score1} > 0.8`);
+        // 只过滤目的地
+        const score2 = matcher.calculateRouteMatch(origin, dest, undefined, { province: '河南' });
+        assert(score2 > 0.7, `只过滤目的地: ${score2} > 0.7`);
+        // 不过滤
+        const score3 = matcher.calculateRouteMatch(origin, dest, undefined, undefined);
+        assert(Math.abs(score3 - 1.0) < 0.01, `无过滤默认满分: ${score3} ≈ 1.0`);
+    }
+    section('calculateRouteMatch - 出发匹配/目的不匹配');
+    {
+        const matcher = new carpool_matcher_1.CarpoolMatcher();
+        const origin = { province: '北京', city: '北京' };
+        const dest = { province: '河南', city: '漯河' };
+        const score = matcher.calculateRouteMatch(origin, dest, { province: '北京', city: '北京' }, { province: '广东', city: '广州' });
+        // origin: 0.8 (市级), dest: 0.0 (省不匹配) → avg = 0.4
+        assert(Math.abs(score - 0.4) < 0.01, `出发匹配+目的不匹配: ${score} ≈ 0.4`);
+    }
+    // ==========================================================================
+    // Part 2: CarpoolMatcher - 综合评分
+    // ==========================================================================
+    section('calculateMatchScore - 高信任+高评分');
+    {
+        const matcher = new carpool_matcher_1.CarpoolMatcher();
+        const trip = mockTrip();
+        const trust = mockTrustScore({ score: 1.0, level: 'trusted' });
+        const { score, reasons } = matcher.calculateMatchScore(trip, trust, 5.0, {
+            origin_city: '北京',
+            destination_province: '河南',
+        });
+        assert(score > 70, `高信任+高评分: ${score} > 70`);
+        assert(reasons.includes('直接好友'), '原因包含 "直接好友"');
+        assert(reasons.includes('好评如潮'), '原因包含 "好评如潮"');
+    }
+    section('calculateMatchScore - 低信任+低评分');
+    {
+        const matcher = new carpool_matcher_1.CarpoolMatcher();
+        const trip = mockTrip({ created_at: Date.now() - 7 * 24 * 60 * 60 * 1000 });
+        const trust = mockTrustScore({ score: 0.1, level: 'stranger' });
+        const { score, reasons } = matcher.calculateMatchScore(trip, trust, 2.0, {
+            origin_city: '上海',
+            destination_province: '广东',
+        });
+        assert(score < 30, `低信任+低评分+不匹配: ${score} < 30`);
+        assert(!reasons.includes('直接好友'), '不包含 "直接好友"');
+    }
+    section('calculateMatchScore - 新鲜度影响');
+    {
+        const matcher = new carpool_matcher_1.CarpoolMatcher();
+        const trust = mockTrustScore({ score: 0.5 });
+        // 刚发布
+        const freshTrip = mockTrip({ created_at: Date.now() });
+        const { score: freshScore } = matcher.calculateMatchScore(freshTrip, trust, 3.0);
+        // 7天前发布
+        const oldTrip = mockTrip({ created_at: Date.now() - 7 * 24 * 60 * 60 * 1000 });
+        const { score: oldScore } = matcher.calculateMatchScore(oldTrip, trust, 3.0);
+        assert(freshScore > oldScore, `新行程分(${freshScore}) > 旧行程分(${oldScore})`);
+    }
+    section('calculateMatchScore - 自定义权重');
+    {
+        // 完全看信任
+        const trustOnlyMatcher = new carpool_matcher_1.CarpoolMatcher({ trust: 1.0, rating: 0, route: 0, freshness: 0 });
+        const trip = mockTrip();
+        const highTrust = mockTrustScore({ score: 1.0, level: 'trusted' });
+        const lowTrust = mockTrustScore({ score: 0.1, level: 'stranger' });
+        const { score: highScore } = trustOnlyMatcher.calculateMatchScore(trip, highTrust, 3.0);
+        const { score: lowScore } = trustOnlyMatcher.calculateMatchScore(trip, lowTrust, 3.0);
+        assert(highScore > lowScore * 5, `纯信任权重: 高(${highScore}) >> 低(${lowScore})`);
+    }
+    section('calculateMatchScore - 评分4.0~4.5 区间原因');
+    {
+        const matcher = new carpool_matcher_1.CarpoolMatcher();
+        const trip = mockTrip();
+        const trust = mockTrustScore({ score: 0.7, level: 'semi_trusted', reason: '2个共同好友' });
+        const { reasons: r1 } = matcher.calculateMatchScore(trip, trust, 4.5);
+        assert(r1.includes('好评如潮'), '4.5分 → 好评如潮');
+        const { reasons: r2 } = matcher.calculateMatchScore(trip, trust, 4.2);
+        assert(r2.includes('口碑良好'), '4.2分 → 口碑良好');
+        const { reasons: r3 } = matcher.calculateMatchScore(trip, trust, 3.5);
+        assert(!r3.includes('好评如潮') && !r3.includes('口碑良好'), '3.5分 → 无评分原因');
+    }
+    section('calculateMatchScore - 分数范围 0~100');
+    {
+        const matcher = new carpool_matcher_1.CarpoolMatcher();
+        const trip = mockTrip();
+        // 最高可能分
+        const { score: maxScore } = matcher.calculateMatchScore(trip, mockTrustScore({ score: 1.0 }), 5.0);
+        assert(maxScore <= 100, `最高分 ${maxScore} <= 100`);
+        assert(maxScore >= 0, `最高分 ${maxScore} >= 0`);
+        // 最低可能分
+        const { score: minScore } = matcher.calculateMatchScore(mockTrip({ created_at: 0 }), mockTrustScore({ score: 0 }), 0, { origin_city: '不存在' });
+        assert(minScore >= 0, `最低分 ${minScore} >= 0`);
+        assert(minScore <= 100, `最低分 ${minScore} <= 100`);
+    }
+    // ==========================================================================
+    // Part 3: CarpoolMatcher - 排序
+    // ==========================================================================
+    section('rankResults');
+    {
+        const matcher = new carpool_matcher_1.CarpoolMatcher();
+        const mockEntity = (name) => ({
+            id: name,
+            name,
+            entity_type: 'person',
+            created_at: Date.now(),
+            updated_at: Date.now(),
+            properties: {},
+        });
+        const results = [
+            {
+                trip: mockTrip({ id: 'trip-low' }),
+                publisher: mockEntity('P1'),
+                match_score: 30,
+                match_reasons: [],
+                trust_score: mockTrustScore(),
+                available_seats: 2,
+            },
+            {
+                trip: mockTrip({ id: 'trip-high' }),
+                publisher: mockEntity('P2'),
+                match_score: 90,
+                match_reasons: [],
+                trust_score: mockTrustScore(),
+                available_seats: 1,
+            },
+            {
+                trip: mockTrip({ id: 'trip-mid' }),
+                publisher: mockEntity('P3'),
+                match_score: 60,
+                match_reasons: [],
+                trust_score: mockTrustScore(),
+                available_seats: 3,
+            },
+        ];
+        const ranked = matcher.rankResults(results);
+        assert(ranked[0].trip.id === 'trip-high', '排序: 最高分在前');
+        assert(ranked[1].trip.id === 'trip-mid', '排序: 中间分在中');
+        assert(ranked[2].trip.id === 'trip-low', '排序: 最低分在后');
+    }
+    // ==========================================================================
+    // Part 4: TrustEvaluator
+    // ==========================================================================
+    const tmpDir = path.join(os.tmpdir(), `carpool-trust-test-${Date.now()}`);
+    fs.mkdirSync(tmpDir, { recursive: true });
+    const graph = new social_graph_v2_1.SocialGraphV2({ path: tmpDir, shardCount: 2 });
+    const trustEval = new trust_evaluator_1.TrustEvaluator(graph);
+    // 创建测试人员
+    const alice = graph.addPerson({ name: 'Alice' }).id;
+    const bob = graph.addPerson({ name: 'Bob' }).id;
+    const charlie = graph.addPerson({ name: 'Charlie' }).id;
+    const dave = graph.addPerson({ name: 'Dave' }).id;
+    const eve = graph.addPerson({ name: 'Eve' }).id;
+    const frank = graph.addPerson({ name: 'Frank' }).id;
+    section('TrustEvaluator - 同一人');
+    {
+        const score = trustEval.evaluate(alice, alice);
+        assert(score.score === 1.0, '同一人信任分 1.0');
+        assert(score.level === 'trusted', '信任等级 trusted');
+        assert(score.social_distance === 0, '社交距离 0');
+    }
+    section('TrustEvaluator - 直接好友');
+    {
+        graph.addFriend(alice, bob);
+        const score = trustEval.evaluate(alice, bob);
+        assert(score.score === 1.0, '直接好友信任分 1.0');
+        assert(score.level === 'trusted', '信任等级 trusted');
+        assert(score.social_distance === 1, '社交距离 1');
+        assert(score.reason === '直接好友', '原因: 直接好友');
+    }
+    section('TrustEvaluator - 同事/同学关系');
+    {
+        // 用 putRelation 创建 colleague 关系
+        graph.putRelation(alice, charlie, 'colleague', 0.8, false);
+        const score = trustEval.evaluate(alice, charlie);
+        assert(Math.abs(score.score - 0.85) < 0.01, `同事信任分: ${score.score} ≈ 0.85`);
+        assert(score.level === 'semi_trusted', '信任等级 semi_trusted');
+        assert(score.reason === '同事', '原因: 同事');
+    }
+    section('TrustEvaluator - knows 关系');
+    {
+        graph.putRelation(alice, dave, 'knows', 0.5, false);
+        const score = trustEval.evaluate(alice, dave);
+        assert(Math.abs(score.score - 0.7) < 0.01, `认识关系信任分: ${score.score} ≈ 0.7`);
+        assert(score.level === 'semi_trusted', '信任等级 semi_trusted');
+        assert(score.reason === '认识的人', '原因: 认识的人');
+    }
+    section('TrustEvaluator - 共同好友');
+    {
+        // eve ← 好友 → alice, eve ← 好友 → frank，但 alice 和 frank 没有直接关系
+        graph.addFriend(alice, eve);
+        graph.addFriend(frank, eve);
+        const score = trustEval.evaluate(alice, frank);
+        // 有共同好友 eve
+        assert(score.score >= 0.7, `共同好友信任分: ${score.score} >= 0.7`);
+        assert(score.level === 'semi_trusted' || score.level === 'known', `信任等级: ${score.level}`);
+    }
+    section('TrustEvaluator - 陌生人');
+    {
+        const stranger = graph.addPerson({ name: 'Stranger' }).id;
+        const score = trustEval.evaluate(alice, stranger);
+        assert(score.score <= 0.3, `陌生人信任分: ${score.score} <= 0.3`);
+        assert(score.level === 'stranger' || score.level === 'known', `信任等级: ${score.level}`);
+    }
+    section('TrustEvaluator - evaluateBatch');
+    {
+        const targets = [bob, charlie, dave];
+        const results = trustEval.evaluateBatch(alice, targets);
+        assert(results.size === 3, 'evaluateBatch 返回 3 个结果');
+        assert(results.has(bob), '包含 Bob');
+        assert(results.has(charlie), '包含 Charlie');
+        assert(results.has(dave), '包含 Dave');
+        // Bob 是直接好友，分数应最高
+        const bobScore = results.get(bob);
+        const daveScore = results.get(dave);
+        assert(bobScore.score >= daveScore.score, 'Bob（好友）信任分 >= Dave（认识）');
+    }
+    section('TrustEvaluator - 信任等级排序一致性');
+    {
+        const stranger = graph.addPerson({ name: 'Stranger2' }).id;
+        const colleague = graph.addPerson({ name: 'Colleague2' }).id;
+        graph.putRelation(alice, colleague, 'colleague', 0.8, false);
+        const friendScore = trustEval.evaluate(alice, bob);
+        const colleagueScore = trustEval.evaluate(alice, colleague);
+        const strangerScore = trustEval.evaluate(alice, stranger);
+        assert(friendScore.score >= colleagueScore.score, '好友 >= 同事');
+        assert(colleagueScore.score >= strangerScore.score, '同事 >= 陌生人');
+        const levelPriority = {
+            trusted: 3, semi_trusted: 2, known: 1, stranger: 0,
+        };
+        assert(levelPriority[friendScore.level] >= levelPriority[colleagueScore.level], '好友等级 >= 同事等级');
+        assert(levelPriority[colleagueScore.level] >= levelPriority[strangerScore.level], '同事等级 >= 陌生人等级');
+    }
+    // ==========================================================================
+    // Summary
+    // ==========================================================================
+    console.log('\n' + '='.repeat(60));
+    console.log(`CarpoolMatcher & TrustEvaluator 单元测试完成: ${passed} 通过, ${failed} 失败`);
+    if (failures.length > 0) {
+        console.log('\n失败用例:');
+        failures.forEach(f => console.log(`  - ${f}`));
+    }
+    console.log('='.repeat(60));
+    // 清理
+    try {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    }
+    catch { }
+    process.exit(failed > 0 ? 1 : 0);
+}
+main().catch(err => {
+    console.error('测试运行失败:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=carpool-matcher.test.js.map

package/dist/carpool/carpool-matcher.test.js.map

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

package/dist/carpool/carpool-privacy.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Carpool Privacy - Contact Encryption & Visibility Control (T20.3)
+ *
+ * 隐私安全模块：
+ * 1. 联系方式加密存储与脱敏展示
+ * 2. 行程可见性控制（公开/好友可见/私密）
+ * 3. 基于社交关系的信息访问控制
+ */
+import type { SocialGraphV2 } from '../social-graph-v2';
+import type { TripDetail, TrustLevel } from './types';
+/** 行程可见性级别 */
+export type VisibilityLevel = 'public' | 'friends_only' | 'friends_of_friends' | 'private';
+/** 隐私配置 */
+export interface PrivacyConfig {
+    /** 加密密钥（用于联系方式加密） */
+    encryptionKey?: string;
+    /** 默认可见性 */
+    defaultVisibility?: VisibilityLevel;
+    /** 联系方式展示给哪些信任等级 */
+    contactVisibleTo?: TrustLevel[];
+}
+/** 脱敏后的行程详情 */
+export interface SanitizedTripDetail extends Omit<TripDetail, 'trip'> {
+    trip: TripDetail['trip'] & {
+        /** 联系方式是否可见 */
+        contact_visible: boolean;
+    };
+}
+export declare class CarpoolPrivacy {
+    private graph;
+    private config;
+    constructor(graph: SocialGraphV2, config?: PrivacyConfig);
+    /**
+     * 加密联系方式（用于存储）
+     *
+     * 使用 XOR + Base64 的简单对称加密方案。
+     * 生产环境应替换为 AES-256-GCM 等强加密。
+     */
+    encryptContact(plainText: string): string;
+    /**
+     * 解密联系方式
+     */
+    decryptContact(encrypted: string): string;
+    /**
+     * 手机号脱敏: 138****1234
+     */
+    maskPhone(phone: string): string;
+    /**
+     * 微信号脱敏: wx***56
+     */
+    maskWechat(wechat: string): string;
+    /**
+     * 通用脱敏
+     */
+    maskContact(value: string, type?: string): string;
+    /**
+     * 判断某用户是否可以查看行程的联系方式
+     *
+     * @param viewerId - 查看者 ID
+     * @param publisherId - 发布者 ID
+     * @param visibility - 行程可见性级别
+     * @returns 是否可见
+     */
+    canViewContact(viewerId: string, publisherId: string, visibility?: VisibilityLevel): boolean;
+    /**
+     * 对行程详情进行隐私过滤
+     *
+     * 根据查看者与发布者的关系，决定是否展示联系方式原文或脱敏版。
+     */
+    sanitizeTripDetail(detail: TripDetail, viewerId: string, visibility?: VisibilityLevel): SanitizedTripDetail;
+}
+//# sourceMappingURL=carpool-privacy.d.ts.map