autosnippet
Version:
Extract code patterns into a knowledge base for AI coding assistants
47 lines (46 loc) • 1.41 kB
TypeScript
/**
* §10.2 Search wire types — 搜索结果类型拆分
*
* 将 SearchResultItem 的 25+ optional 字段拆分为有意义的层次结构。
* 现有代码可继续使用 SearchResultItem；新代码应使用分层类型。
*/
/** 基础搜索命中 — 无论来源（FieldWeighted / Vector / Context）都具备的字段 */
export interface SearchHitBase {
id: string;
title: string;
trigger: string;
kind?: string;
language?: string;
category?: string;
knowledgeType?: string;
}
/** FieldWeighted 命中 — 附带加权分数 */
export interface WeightedHit extends SearchHitBase {
weightedScore: number;
matchedTokens?: string[];
}
/** Vector 命中 — 附带向量相似度 */
export interface VectorHit extends SearchHitBase {
vectorScore: number;
embeddingModel?: string;
}
/** 排序后的统一搜索结果 — API 响应中的单项 */
export interface RankedSearchItem extends SearchHitBase {
weightedScore?: number;
vectorScore?: number;
relevanceScore: number;
authorityScore: number;
recencyScore: number;
finalScore: number;
description?: string;
content?: string;
tags?: string[];
updatedAt?: string | null;
}
/** 搜索 API 响应 */
export interface SearchResponse {
items: RankedSearchItem[];
total: number;
query: string;
mode: 'weighted' | 'semantic' | 'hybrid' | 'context';
}