autosnippet 3.0.1 → 3.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +230 -324
- package/bin/api-server.js +1 -1
- package/bin/cli.js +204 -244
- package/bin/mcp-server.js +5 -3
- package/config/knowledge-base.config.js +132 -132
- package/dashboard/dist/assets/{icons-CEfgGaZi.js → icons-Cdq22n2i.js} +95 -100
- package/dashboard/dist/assets/index-ClkyPkDX.js +133 -0
- package/dashboard/dist/assets/index-t4QrJwv1.css +1 -0
- package/dashboard/dist/index.html +3 -3
- package/lib/bootstrap.js +8 -8
- package/lib/cli/AiScanService.js +86 -40
- package/lib/cli/KnowledgeSyncService.js +113 -74
- package/lib/cli/SetupService.js +439 -277
- package/lib/cli/UpgradeService.js +63 -100
- package/lib/core/AstAnalyzer.js +276 -597
- package/lib/core/ast/ProjectGraph.js +101 -40
- package/lib/core/ast/ensure-grammars.js +232 -0
- package/lib/core/ast/index.js +115 -0
- package/lib/core/ast/lang-dart.js +661 -0
- package/lib/core/ast/lang-go.js +530 -0
- package/lib/core/ast/lang-java.js +435 -0
- package/lib/core/ast/lang-javascript.js +272 -0
- package/lib/core/ast/lang-kotlin.js +423 -0
- package/lib/core/ast/lang-objc.js +388 -0
- package/lib/core/ast/lang-python.js +371 -0
- package/lib/core/ast/lang-swift.js +337 -0
- package/lib/core/ast/lang-typescript.js +503 -0
- package/lib/core/capability/CapabilityProbe.js +18 -9
- package/lib/core/constitution/Constitution.js +2 -3
- package/lib/core/constitution/ConstitutionValidator.js +65 -24
- package/lib/core/discovery/DartDiscoverer.js +534 -0
- package/lib/core/discovery/DiscovererRegistry.js +83 -0
- package/lib/core/discovery/GenericDiscoverer.js +225 -0
- package/lib/core/discovery/GoDiscoverer.js +541 -0
- package/lib/core/discovery/JvmDiscoverer.js +506 -0
- package/lib/core/discovery/NodeDiscoverer.js +466 -0
- package/lib/core/discovery/ProjectDiscoverer.js +93 -0
- package/lib/core/discovery/PythonDiscoverer.js +338 -0
- package/lib/core/discovery/SpmDiscoverer.js +5 -0
- package/lib/core/discovery/index.js +53 -0
- package/lib/core/enhancement/EnhancementPack.js +71 -0
- package/lib/core/enhancement/EnhancementRegistry.js +47 -0
- package/lib/core/enhancement/android-enhancement.js +102 -0
- package/lib/core/enhancement/django-enhancement.js +70 -0
- package/lib/core/enhancement/fastapi-enhancement.js +63 -0
- package/lib/core/enhancement/go-grpc-enhancement.js +152 -0
- package/lib/core/enhancement/go-web-enhancement.js +201 -0
- package/lib/core/enhancement/index.js +65 -0
- package/lib/core/enhancement/node-server-enhancement.js +88 -0
- package/lib/core/enhancement/react-enhancement.js +86 -0
- package/lib/core/enhancement/spring-enhancement.js +112 -0
- package/lib/core/enhancement/vue-enhancement.js +96 -0
- package/lib/core/gateway/Gateway.js +8 -9
- package/lib/core/gateway/GatewayActionRegistry.js +1 -1
- package/lib/core/permission/PermissionManager.js +12 -8
- package/lib/domain/index.js +13 -9
- package/lib/domain/knowledge/KnowledgeEntry.js +111 -101
- package/lib/domain/knowledge/KnowledgeRepository.js +0 -1
- package/lib/domain/knowledge/Lifecycle.js +22 -22
- package/lib/domain/knowledge/index.js +9 -12
- package/lib/domain/knowledge/values/Constraints.js +31 -21
- package/lib/domain/knowledge/values/Content.js +21 -13
- package/lib/domain/knowledge/values/Quality.js +31 -18
- package/lib/domain/knowledge/values/Reasoning.js +20 -12
- package/lib/domain/knowledge/values/Relations.js +37 -25
- package/lib/domain/knowledge/values/Stats.js +18 -12
- package/lib/domain/knowledge/values/index.js +4 -3
- package/lib/domain/snippet/Snippet.js +35 -10
- package/lib/external/ai/AiFactory.js +48 -16
- package/lib/external/ai/AiProvider.js +184 -90
- package/lib/external/ai/providers/ClaudeProvider.js +25 -12
- package/lib/external/ai/providers/GoogleGeminiProvider.js +59 -30
- package/lib/external/ai/providers/MockProvider.js +9 -3
- package/lib/external/ai/providers/OpenAiProvider.js +51 -29
- package/lib/external/mcp/McpServer.js +66 -36
- package/lib/external/mcp/errorHandler.js +23 -11
- package/lib/external/mcp/handlers/LanguageExtensions.js +138 -53
- package/lib/external/mcp/handlers/TargetClassifier.js +52 -16
- package/lib/external/mcp/handlers/bootstrap/pipeline/BootstrapSnapshot.js +81 -20
- package/lib/external/mcp/handlers/bootstrap/pipeline/EpisodicMemory.js +71 -42
- package/lib/external/mcp/handlers/bootstrap/pipeline/IncrementalBootstrap.js +9 -17
- package/lib/external/mcp/handlers/bootstrap/pipeline/ToolResultCache.js +14 -9
- package/lib/external/mcp/handlers/bootstrap/pipeline/dimension-context.js +15 -7
- package/lib/external/mcp/handlers/bootstrap/pipeline/orchestrator.js +352 -153
- package/lib/external/mcp/handlers/bootstrap/pipeline/tier-scheduler.js +52 -12
- package/lib/external/mcp/handlers/bootstrap/skills.js +143 -39
- package/lib/external/mcp/handlers/bootstrap.js +691 -168
- package/lib/external/mcp/handlers/browse.js +66 -22
- package/lib/external/mcp/handlers/candidate.js +118 -35
- package/lib/external/mcp/handlers/consolidated.js +49 -17
- package/lib/external/mcp/handlers/guard.js +104 -39
- package/lib/external/mcp/handlers/knowledge.js +60 -36
- package/lib/external/mcp/handlers/search.js +43 -14
- package/lib/external/mcp/handlers/skill.js +120 -45
- package/lib/external/mcp/handlers/structure.js +240 -86
- package/lib/external/mcp/handlers/system.js +42 -12
- package/lib/external/mcp/handlers/wiki.js +58 -33
- package/lib/external/mcp/tools.js +306 -123
- package/lib/http/HttpServer.js +72 -47
- package/lib/http/middleware/RateLimiter.js +5 -3
- package/lib/http/middleware/errorHandler.js +6 -1
- package/lib/http/middleware/requestLogger.js +14 -3
- package/lib/http/middleware/roleResolver.js +30 -23
- package/lib/http/routes/ai.js +387 -265
- package/lib/http/routes/auth.js +81 -61
- package/lib/http/routes/candidates.js +430 -320
- package/lib/http/routes/commands.js +289 -189
- package/lib/http/routes/extract.js +158 -125
- package/lib/http/routes/guardRules.js +309 -217
- package/lib/http/routes/knowledge.js +213 -154
- package/lib/http/routes/modules.js +578 -0
- package/lib/http/routes/monitoring.js +6 -6
- package/lib/http/routes/recipes.js +104 -93
- package/lib/http/routes/search.js +361 -305
- package/lib/http/routes/skills.js +145 -98
- package/lib/http/routes/snippets.js +42 -30
- package/lib/http/routes/spm.js +3 -405
- package/lib/http/routes/violations.js +113 -93
- package/lib/http/routes/wiki.js +211 -170
- package/lib/http/utils/routeHelpers.js +3 -1
- package/lib/http/utils/sse-sessions.js +16 -6
- package/lib/http/utils/sse.js +15 -5
- package/lib/infrastructure/audit/AuditLogger.js +5 -2
- package/lib/infrastructure/audit/AuditStore.js +10 -7
- package/lib/infrastructure/cache/CacheService.js +3 -1
- package/lib/infrastructure/cache/GraphCache.js +8 -4
- package/lib/infrastructure/cache/UnifiedCacheAdapter.js +1 -1
- package/lib/infrastructure/config/ConfigLoader.js +9 -5
- package/lib/infrastructure/config/Defaults.js +30 -10
- package/lib/infrastructure/config/Paths.js +28 -8
- package/lib/infrastructure/config/TriggerSymbol.js +22 -10
- package/lib/infrastructure/database/DatabaseConnection.js +15 -10
- package/lib/infrastructure/database/migrations/001_initial_schema.js +0 -1
- package/lib/infrastructure/external/ClipboardManager.js +6 -2
- package/lib/infrastructure/external/NativeUi.js +50 -43
- package/lib/infrastructure/external/OpenBrowser.js +14 -17
- package/lib/infrastructure/external/XcodeAutomation.js +14 -258
- package/lib/infrastructure/logging/Logger.js +46 -30
- package/lib/infrastructure/monitoring/ErrorTracker.js +7 -5
- package/lib/infrastructure/monitoring/PerformanceMonitor.js +12 -4
- package/lib/infrastructure/paths/HeaderResolver.js +25 -9
- package/lib/infrastructure/paths/PathFinder.js +34 -12
- package/lib/infrastructure/plugin/PluginManager.js +26 -8
- package/lib/infrastructure/realtime/RealtimeService.js +2 -2
- package/lib/infrastructure/vector/Chunker.js +22 -7
- package/lib/infrastructure/vector/IndexingPipeline.js +46 -22
- package/lib/infrastructure/vector/JsonVectorAdapter.js +90 -53
- package/lib/infrastructure/vector/VectorStore.js +28 -10
- package/lib/injection/ServiceContainer.js +247 -93
- package/lib/platform/ios/index.js +63 -0
- package/lib/platform/ios/routes/spm.js +437 -0
- package/lib/platform/ios/snippet/PlaceholderConverter.js +55 -0
- package/lib/platform/ios/snippet/XcodeCodec.js +112 -0
- package/lib/{service → platform/ios}/spm/DependencyGraph.js +41 -17
- package/lib/{service → platform/ios}/spm/PackageSwiftParser.js +41 -14
- package/lib/{service → platform/ios}/spm/PolicyEngine.js +9 -4
- package/lib/platform/ios/spm/SpmDiscoverer.js +122 -0
- package/lib/{service → platform/ios}/spm/SpmService.js +385 -127
- package/lib/{service/automation → platform/ios/xcode}/SaveEventFilter.js +8 -7
- package/lib/platform/ios/xcode/XcodeAutomation.js +350 -0
- package/lib/{service/automation → platform/ios/xcode}/XcodeIntegration.js +325 -145
- package/lib/repository/base/BaseRepository.js +7 -9
- package/lib/repository/knowledge/KnowledgeRepository.impl.js +98 -75
- package/lib/repository/token/TokenUsageStore.js +4 -2
- package/lib/service/automation/ActionPipeline.js +1 -1
- package/lib/service/automation/AutomationOrchestrator.js +8 -4
- package/lib/service/automation/ContextCollector.js +7 -5
- package/lib/service/automation/DirectiveDetector.js +23 -16
- package/lib/service/automation/FileWatcher.js +112 -56
- package/lib/service/automation/TriggerResolver.js +6 -4
- package/lib/service/automation/handlers/AlinkHandler.js +24 -12
- package/lib/service/automation/handlers/CreateHandler.js +19 -20
- package/lib/service/automation/handlers/DraftHandler.js +14 -8
- package/lib/service/automation/handlers/GuardHandler.js +93 -63
- package/lib/service/automation/handlers/HeaderHandler.js +1 -6
- package/lib/service/automation/handlers/SearchHandler.js +155 -88
- package/lib/service/bootstrap/BootstrapTaskManager.js +77 -35
- package/lib/service/candidate/SimilarityService.js +25 -9
- package/lib/service/chat/AnalystAgent.js +50 -24
- package/lib/service/chat/CandidateGuardrail.js +143 -17
- package/lib/service/chat/ChatAgent.js +655 -260
- package/lib/service/chat/ContextWindow.js +116 -71
- package/lib/service/chat/ConversationStore.js +77 -36
- package/lib/service/chat/EpisodicConsolidator.js +47 -23
- package/lib/service/chat/HandoffProtocol.js +98 -22
- package/lib/service/chat/Memory.js +34 -14
- package/lib/service/chat/ProducerAgent.js +40 -20
- package/lib/service/chat/ProjectSemanticMemory.js +109 -78
- package/lib/service/chat/ReasoningLayer.js +148 -70
- package/lib/service/chat/ReasoningTrace.js +44 -32
- package/lib/service/chat/TaskPipeline.js +39 -19
- package/lib/service/chat/ToolRegistry.js +48 -29
- package/lib/service/chat/WorkingMemory.js +44 -18
- package/lib/service/chat/tools.js +1096 -494
- package/lib/service/context/RecipeExtractor.js +132 -51
- package/lib/service/cursor/CursorDeliveryPipeline.js +82 -37
- package/lib/service/cursor/KnowledgeCompressor.js +25 -22
- package/lib/service/cursor/RulesGenerator.js +13 -7
- package/lib/service/cursor/SkillsSyncer.js +77 -27
- package/lib/service/cursor/TokenBudget.js +2 -2
- package/lib/service/cursor/TopicClassifier.js +54 -20
- package/lib/service/guard/ComplianceReporter.js +55 -43
- package/lib/service/guard/ExclusionManager.js +67 -29
- package/lib/service/guard/GuardCheckEngine.js +381 -86
- package/lib/service/guard/GuardFeedbackLoop.js +22 -10
- package/lib/service/guard/GuardService.js +29 -19
- package/lib/service/guard/RuleLearner.js +55 -23
- package/lib/service/guard/SourceFileCollector.js +27 -20
- package/lib/service/guard/ViolationsStore.js +43 -38
- package/lib/service/knowledge/CodeEntityGraph.js +147 -82
- package/lib/service/knowledge/ConfidenceRouter.js +12 -10
- package/lib/service/knowledge/KnowledgeFileWriter.js +147 -56
- package/lib/service/knowledge/KnowledgeGraphService.js +81 -34
- package/lib/service/knowledge/KnowledgeService.js +222 -112
- package/lib/service/module/ModuleService.js +969 -0
- package/lib/service/quality/FeedbackCollector.js +27 -15
- package/lib/service/quality/QualityScorer.js +78 -24
- package/lib/service/recipe/RecipeCandidateValidator.js +110 -44
- package/lib/service/recipe/RecipeParser.js +78 -45
- package/lib/service/search/CoarseRanker.js +43 -28
- package/lib/service/search/CrossEncoderReranker.js +32 -21
- package/lib/service/search/InvertedIndex.js +21 -7
- package/lib/service/search/MultiSignalRanker.js +90 -28
- package/lib/service/search/RetrievalFunnel.js +45 -24
- package/lib/service/search/SearchEngine.js +255 -103
- package/lib/service/skills/EventAggregator.js +32 -15
- package/lib/service/skills/SignalCollector.js +140 -64
- package/lib/service/skills/SkillAdvisor.js +79 -42
- package/lib/service/skills/SkillHooks.js +16 -14
- package/lib/service/snippet/PlaceholderConverter.js +5 -0
- package/lib/service/snippet/SnippetFactory.js +116 -99
- package/lib/service/snippet/SnippetInstaller.js +234 -62
- package/lib/service/snippet/codecs/SnippetCodec.js +67 -0
- package/lib/service/snippet/codecs/VSCodeCodec.js +102 -0
- package/lib/service/snippet/codecs/XcodeCodec.js +5 -0
- package/lib/service/wiki/WikiGenerator.js +637 -263
- package/lib/shared/DimensionCopyRegistry.js +472 -0
- package/lib/shared/LanguageService.js +399 -0
- package/lib/shared/PathGuard.js +45 -28
- package/lib/shared/RecipeReadinessChecker.js +72 -12
- package/lib/shared/constants.js +41 -41
- package/lib/shared/errors/BaseError.js +2 -2
- package/lib/shared/errors/index.js +4 -4
- package/lib/shared/similarity.js +25 -8
- package/lib/shared/token-utils.js +6 -2
- package/lib/shared/utils/common.js +12 -4
- package/package.json +49 -13
- package/scripts/bench-real-projects.mjs +256 -0
- package/scripts/build-native-ui.js +30 -30
- package/scripts/clear-old-vector-index.js +5 -35
- package/scripts/clear-vector-cache.js +7 -37
- package/scripts/collect-test-project-stats.mjs +160 -0
- package/scripts/diagnose-mcp.js +41 -32
- package/scripts/ensure-parse-package.js +6 -9
- package/scripts/generate-recipe-drafts.js +116 -77
- package/scripts/init-db.js +3 -20
- package/scripts/init-snippets.js +305 -0
- package/scripts/init-vector-db.js +173 -170
- package/scripts/install-cursor-skill.js +148 -104
- package/scripts/install-full.js +8 -21
- package/scripts/install-vscode-copilot.js +146 -145
- package/scripts/migrate-md-to-knowledge.mjs +139 -151
- package/scripts/postinstall-safe.js +5 -17
- package/scripts/recipe-audit.js +106 -82
- package/scripts/release.js +283 -323
- package/scripts/setup-mcp-config.js +60 -52
- package/scripts/verify-context-api.js +20 -20
- package/skills/autosnippet-analysis/SKILL.md +10 -6
- package/skills/autosnippet-candidates/SKILL.md +27 -26
- package/skills/autosnippet-coldstart/SKILL.md +555 -38
- package/skills/autosnippet-concepts/SKILL.md +349 -337
- package/skills/autosnippet-create/SKILL.md +5 -5
- package/skills/autosnippet-reference-dart/SKILL.md +543 -0
- package/skills/autosnippet-reference-go/SKILL.md +539 -0
- package/skills/autosnippet-reference-java/SKILL.md +534 -0
- package/skills/autosnippet-reference-jsts/SKILL.md +41 -9
- package/skills/autosnippet-reference-kotlin/SKILL.md +526 -0
- package/skills/autosnippet-reference-objc/SKILL.md +29 -6
- package/skills/autosnippet-reference-python/SKILL.md +800 -0
- package/skills/autosnippet-reference-swift/SKILL.md +70 -14
- package/skills/autosnippet-structure/SKILL.md +4 -4
- package/templates/cursor-rules/autosnippet-conventions.mdc +2 -2
- package/templates/recipes-setup/README.md +2 -2
- package/templates/recipes-setup/_template.md +1 -1
- package/dashboard/dist/assets/index-Bun3ld_J.css +0 -1
- package/dashboard/dist/assets/index-_Sk_Dmg3.js +0 -143
- package/resources/asd-entry/main.swift +0 -159
- package/scripts/build-asd-entry.js +0 -51
- package/scripts/init-xcode-snippets.js +0 -311
- package/template.json +0 -39
|
@@ -6,11 +6,46 @@
|
|
|
6
6
|
|
|
7
7
|
// 场景权重配置
|
|
8
8
|
const SCENARIO_WEIGHTS = {
|
|
9
|
-
lint:
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
9
|
+
lint: {
|
|
10
|
+
relevance: 0.4,
|
|
11
|
+
authority: 0.25,
|
|
12
|
+
recency: 0.15,
|
|
13
|
+
popularity: 0.1,
|
|
14
|
+
difficulty: 0.05,
|
|
15
|
+
seasonality: 0.05,
|
|
16
|
+
},
|
|
17
|
+
generate: {
|
|
18
|
+
relevance: 0.3,
|
|
19
|
+
authority: 0.2,
|
|
20
|
+
recency: 0.1,
|
|
21
|
+
popularity: 0.2,
|
|
22
|
+
difficulty: 0.1,
|
|
23
|
+
seasonality: 0.1,
|
|
24
|
+
},
|
|
25
|
+
search: {
|
|
26
|
+
relevance: 0.3,
|
|
27
|
+
authority: 0.2,
|
|
28
|
+
recency: 0.15,
|
|
29
|
+
popularity: 0.15,
|
|
30
|
+
difficulty: 0.1,
|
|
31
|
+
seasonality: 0.1,
|
|
32
|
+
},
|
|
33
|
+
learning: {
|
|
34
|
+
relevance: 0.2,
|
|
35
|
+
authority: 0.15,
|
|
36
|
+
recency: 0.05,
|
|
37
|
+
popularity: 0.1,
|
|
38
|
+
difficulty: 0.3,
|
|
39
|
+
seasonality: 0.2,
|
|
40
|
+
},
|
|
41
|
+
default: {
|
|
42
|
+
relevance: 0.3,
|
|
43
|
+
authority: 0.2,
|
|
44
|
+
recency: 0.15,
|
|
45
|
+
popularity: 0.15,
|
|
46
|
+
difficulty: 0.1,
|
|
47
|
+
seasonality: 0.1,
|
|
48
|
+
},
|
|
14
49
|
};
|
|
15
50
|
|
|
16
51
|
/**
|
|
@@ -20,22 +55,30 @@ export class RelevanceSignal {
|
|
|
20
55
|
compute(candidate, context) {
|
|
21
56
|
let score = candidate.bm25Score || candidate.score || 0;
|
|
22
57
|
const query = (context.query || '').toLowerCase();
|
|
23
|
-
if (!query)
|
|
58
|
+
if (!query) {
|
|
59
|
+
return Math.min(score, 1.0);
|
|
60
|
+
}
|
|
24
61
|
|
|
25
62
|
const title = (candidate.title || '').toLowerCase();
|
|
26
63
|
const trigger = (candidate.trigger || '').toLowerCase();
|
|
27
64
|
const content = (candidate.content || candidate.code || '').toLowerCase();
|
|
28
65
|
|
|
29
66
|
// trigger 精确匹配 boost(最高优先级)
|
|
30
|
-
if (trigger
|
|
67
|
+
if (trigger?.includes(query)) {
|
|
68
|
+
score += 0.4;
|
|
69
|
+
}
|
|
31
70
|
// 标题精确匹配 boost
|
|
32
|
-
if (title.includes(query))
|
|
71
|
+
if (title.includes(query)) {
|
|
72
|
+
score += 0.3;
|
|
73
|
+
}
|
|
33
74
|
// 标题单词匹配
|
|
34
75
|
const queryWords = query.split(/\s+/);
|
|
35
|
-
const titleHits = queryWords.filter(w => title.includes(w)).length;
|
|
76
|
+
const titleHits = queryWords.filter((w) => title.includes(w)).length;
|
|
36
77
|
score += (titleHits / queryWords.length) * 0.2;
|
|
37
78
|
// 内容匹配
|
|
38
|
-
if (content.includes(query))
|
|
79
|
+
if (content.includes(query)) {
|
|
80
|
+
score += 0.1;
|
|
81
|
+
}
|
|
39
82
|
|
|
40
83
|
return Math.min(score, 1.0);
|
|
41
84
|
}
|
|
@@ -47,9 +90,15 @@ export class RelevanceSignal {
|
|
|
47
90
|
export class AuthoritySignal {
|
|
48
91
|
compute(candidate) {
|
|
49
92
|
let score = 0;
|
|
50
|
-
if (candidate.qualityScore)
|
|
51
|
-
|
|
52
|
-
|
|
93
|
+
if (candidate.qualityScore) {
|
|
94
|
+
score += (candidate.qualityScore / 100) * 0.5;
|
|
95
|
+
}
|
|
96
|
+
if (candidate.authorityScore) {
|
|
97
|
+
score += candidate.authorityScore * 0.3;
|
|
98
|
+
}
|
|
99
|
+
if (candidate.usageCount > 0) {
|
|
100
|
+
score += Math.min(candidate.usageCount / 100, 1) * 0.2;
|
|
101
|
+
}
|
|
53
102
|
return Math.min(score || 0.5, 1.0);
|
|
54
103
|
}
|
|
55
104
|
}
|
|
@@ -60,16 +109,23 @@ export class AuthoritySignal {
|
|
|
60
109
|
export class RecencySignal {
|
|
61
110
|
compute(candidate) {
|
|
62
111
|
const updated = candidate.updatedAt || candidate.lastModified || candidate.createdAt;
|
|
63
|
-
if (!updated)
|
|
112
|
+
if (!updated) {
|
|
113
|
+
return 0.5;
|
|
114
|
+
}
|
|
64
115
|
// 自动识别秒级/毫秒级 Unix 时间戳 (秒级 ≤ 9999999999 即 2286 年)
|
|
65
|
-
const ts =
|
|
66
|
-
|
|
67
|
-
|
|
116
|
+
const ts =
|
|
117
|
+
typeof updated === 'number' && updated > 0 && updated <= 9999999999
|
|
118
|
+
? updated * 1000
|
|
119
|
+
: typeof updated === 'number'
|
|
120
|
+
? updated
|
|
121
|
+
: new Date(updated).getTime();
|
|
68
122
|
const ageMs = Date.now() - ts;
|
|
69
|
-
if (ageMs < 0)
|
|
123
|
+
if (ageMs < 0) {
|
|
124
|
+
return 1.0; // 未来时间戳视为最新
|
|
125
|
+
}
|
|
70
126
|
const ageDays = ageMs / (1000 * 60 * 60 * 24);
|
|
71
127
|
// 指数衰减:半衰期 90 天
|
|
72
|
-
return Math.exp(-
|
|
128
|
+
return Math.exp((-Math.LN2 * ageDays) / 90);
|
|
73
129
|
}
|
|
74
130
|
}
|
|
75
131
|
|
|
@@ -106,8 +162,12 @@ export class DifficultySignal {
|
|
|
106
162
|
export class SeasonalitySignal {
|
|
107
163
|
compute(candidate, context) {
|
|
108
164
|
// 简单实现:语言/框架匹配加分
|
|
109
|
-
if (context.language && candidate.language === context.language)
|
|
110
|
-
|
|
165
|
+
if (context.language && candidate.language === context.language) {
|
|
166
|
+
return 0.8;
|
|
167
|
+
}
|
|
168
|
+
if (context.category && candidate.category === context.category) {
|
|
169
|
+
return 0.6;
|
|
170
|
+
}
|
|
111
171
|
return 0.5;
|
|
112
172
|
}
|
|
113
173
|
}
|
|
@@ -121,11 +181,11 @@ export class MultiSignalRanker {
|
|
|
121
181
|
|
|
122
182
|
constructor(options = {}) {
|
|
123
183
|
this.#signals = {
|
|
124
|
-
relevance:
|
|
125
|
-
authority:
|
|
126
|
-
recency:
|
|
127
|
-
popularity:
|
|
128
|
-
difficulty:
|
|
184
|
+
relevance: new RelevanceSignal(),
|
|
185
|
+
authority: new AuthoritySignal(),
|
|
186
|
+
recency: new RecencySignal(),
|
|
187
|
+
popularity: new PopularitySignal(),
|
|
188
|
+
difficulty: new DifficultySignal(),
|
|
129
189
|
seasonality: new SeasonalitySignal(),
|
|
130
190
|
};
|
|
131
191
|
this.#scenarioWeights = { ...SCENARIO_WEIGHTS, ...options.scenarioWeights };
|
|
@@ -138,12 +198,14 @@ export class MultiSignalRanker {
|
|
|
138
198
|
* @returns {Array} — sorted candidates with rankerScore
|
|
139
199
|
*/
|
|
140
200
|
rank(candidates, context = {}) {
|
|
141
|
-
if (!candidates || candidates.length === 0)
|
|
201
|
+
if (!candidates || candidates.length === 0) {
|
|
202
|
+
return [];
|
|
203
|
+
}
|
|
142
204
|
|
|
143
205
|
const scenario = context.scenario || context.intent || 'default';
|
|
144
206
|
const weights = this.#scenarioWeights[scenario] || this.#scenarioWeights.default;
|
|
145
207
|
|
|
146
|
-
const scored = candidates.map(candidate => {
|
|
208
|
+
const scored = candidates.map((candidate) => {
|
|
147
209
|
const signals = {};
|
|
148
210
|
let totalScore = 0;
|
|
149
211
|
|
|
@@ -6,10 +6,10 @@
|
|
|
6
6
|
* Layer 4: Context-Aware Reranking (对话历史提升)
|
|
7
7
|
*/
|
|
8
8
|
|
|
9
|
-
import { buildInvertedIndex, lookup, tokenize } from './InvertedIndex.js';
|
|
10
|
-
import { MultiSignalRanker } from './MultiSignalRanker.js';
|
|
11
9
|
import { CoarseRanker } from './CoarseRanker.js';
|
|
12
10
|
import { CrossEncoderReranker } from './CrossEncoderReranker.js';
|
|
11
|
+
import { buildInvertedIndex, lookup, tokenize } from './InvertedIndex.js';
|
|
12
|
+
import { MultiSignalRanker } from './MultiSignalRanker.js';
|
|
13
13
|
|
|
14
14
|
export class RetrievalFunnel {
|
|
15
15
|
#multiSignalRanker;
|
|
@@ -37,14 +37,20 @@ export class RetrievalFunnel {
|
|
|
37
37
|
* @returns {Array} — ranked results
|
|
38
38
|
*/
|
|
39
39
|
async execute(query, candidates, context = {}) {
|
|
40
|
-
if (!candidates || candidates.length === 0)
|
|
41
|
-
|
|
40
|
+
if (!candidates || candidates.length === 0) {
|
|
41
|
+
return [];
|
|
42
|
+
}
|
|
43
|
+
if (!query) {
|
|
44
|
+
return candidates;
|
|
45
|
+
}
|
|
42
46
|
|
|
43
47
|
// Layer 1: Keyword Filter — 倒排索引快速召回
|
|
44
48
|
let results = this.#keywordFilter(query, candidates);
|
|
45
49
|
|
|
46
50
|
// 如果关键词无结果,退回全量
|
|
47
|
-
if (results.length === 0)
|
|
51
|
+
if (results.length === 0) {
|
|
52
|
+
results = [...candidates];
|
|
53
|
+
}
|
|
48
54
|
|
|
49
55
|
// Layer 2: Semantic Rerank — 向量/Jaccard 相似度重排
|
|
50
56
|
results = await this.#semanticRerank(query, results);
|
|
@@ -68,8 +74,10 @@ export class RetrievalFunnel {
|
|
|
68
74
|
const index = buildInvertedIndex(candidates);
|
|
69
75
|
const matchedIndices = lookup(index, query);
|
|
70
76
|
|
|
71
|
-
if (matchedIndices.length === 0)
|
|
72
|
-
|
|
77
|
+
if (matchedIndices.length === 0) {
|
|
78
|
+
return [];
|
|
79
|
+
}
|
|
80
|
+
return matchedIndices.map((idx) => candidates[idx]);
|
|
73
81
|
}
|
|
74
82
|
|
|
75
83
|
/**
|
|
@@ -85,29 +93,42 @@ export class RetrievalFunnel {
|
|
|
85
93
|
* - 语言匹配 +10%
|
|
86
94
|
*/
|
|
87
95
|
#contextAwareRerank(candidates, context) {
|
|
88
|
-
if (!context.sessionHistory || context.sessionHistory.length === 0)
|
|
96
|
+
if (!context.sessionHistory || context.sessionHistory.length === 0) {
|
|
97
|
+
return candidates;
|
|
98
|
+
}
|
|
89
99
|
|
|
90
100
|
// 收集会话中的关键词
|
|
91
101
|
const sessionKeywords = new Set();
|
|
92
102
|
for (const turn of context.sessionHistory) {
|
|
93
103
|
const tokens = tokenize(turn.content || turn.rawInput || '');
|
|
94
|
-
for (const t of tokens)
|
|
104
|
+
for (const t of tokens) {
|
|
105
|
+
sessionKeywords.add(t);
|
|
106
|
+
}
|
|
95
107
|
}
|
|
96
108
|
|
|
97
|
-
return candidates
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
109
|
+
return candidates
|
|
110
|
+
.map((candidate) => {
|
|
111
|
+
let boost = 0;
|
|
112
|
+
const text = [candidate.title, candidate.trigger, candidate.content]
|
|
113
|
+
.filter(Boolean)
|
|
114
|
+
.join(' ')
|
|
115
|
+
.toLowerCase();
|
|
116
|
+
|
|
117
|
+
// 会话上下文匹配
|
|
118
|
+
const textTokens = tokenize(text);
|
|
119
|
+
const sessionOverlap = textTokens.filter((t) => sessionKeywords.has(t)).length;
|
|
120
|
+
if (sessionOverlap > 0) {
|
|
121
|
+
boost += 0.2 * Math.min(sessionOverlap / 5, 1);
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
// 语言匹配
|
|
125
|
+
if (context.language && candidate.language === context.language) {
|
|
126
|
+
boost += 0.1;
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
const contextScore = (candidate.rankerScore || candidate.coarseScore || 0) * (1 + boost);
|
|
130
|
+
return { ...candidate, contextScore, contextBoost: boost };
|
|
131
|
+
})
|
|
132
|
+
.sort((a, b) => b.contextScore - a.contextScore);
|
|
112
133
|
}
|
|
113
134
|
}
|