@sns-parse/core 0.6.0-alpha.1 → 0.6.0-alpha.2

package/lib/engine/config.js

@@ -261,5 +261,14 @@ function engineConfigContributions() {
                 { key: 'deduplicationTipText', type: 'string', default: '链接 ${url} 在最近 ${interval} 秒内已解析过，已跳过。', description: '重复解析提示，支持变量 ${url} ${interval}' },
             ],
         }),
+        (0, config_1.defineConfig)({
+            group: '通用链接解析（预留）',
+            fields: [
+                { key: 'genericParseEnabled', type: 'boolean', default: false, description: '对未命中平台声明的链接启用通用解析（预留：暂无实现，开启不生效）' },
+                { key: 'genericLlmBaseUrl', type: 'string', default: '', description: 'LLM 接口 Base URL（OpenAI 兼容格式；预留字段，暂不消费）' },
+                { key: 'genericLlmModel', type: 'string', default: '', description: 'LLM 模型名（预留字段，暂不消费）' },
+                { key: 'genericLlmApiKey', type: 'string', default: '', role: 'secret', description: 'LLM API Key（预留字段，暂不消费）' },
+            ],
+        }),
     ];
 }

package/lib/engine/generic.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 通用链接解析（预留，暂不实现）：对未命中任何平台声明的链接的基础解析能力。
+ *
+ * 设计：
+ * - 经 'parse.generic' 工作流阶段调度（见 workflow/hooks.ts）；
+ * - 基线实现 = 未实现（返回 null）——链路保持现状：非平台链接不进入解析流程；
+ * - 后续实现可由宿主或扩展 replace('parse.generic') 注入
+ *   （OG 元信息抽取 / 页面结构化 / LLM 归纳，source 字段标注来源）；
+ * - LLM 接口仅预留契约：engineConfigContributions() 的「通用链接解析（预留）」组
+ *   提供 baseUrl/model/apiKey 配置位，暂无消费方，开关默认关闭。
+ */
+export interface GenericLinkInput {
+    url: string;
+}
+export interface GenericLinkResult {
+    title?: string;
+    desc?: string;
+    images: string[];
+    /** 解析来源：og=OG 元信息 / html=页面结构化 / llm=模型归纳 */
+    source?: 'og' | 'html' | 'llm';
+}
+/** LLM 增强预留接口（字段与「通用链接解析（预留）」配置组一一对应） */
+export interface LlmOptions {
+    baseUrl?: string;
+    apiKey?: string;
+    model?: string;
+}
+/** 通用解析器实现契约（replace('parse.generic') 的注入形态） */
+export interface GenericLinkParser {
+    parse(input: GenericLinkInput, rt: any): Promise<GenericLinkResult | null>;
+}

package/lib/engine/generic.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * 通用链接解析（预留，暂不实现）：对未命中任何平台声明的链接的基础解析能力。
+ *
+ * 设计：
+ * - 经 'parse.generic' 工作流阶段调度（见 workflow/hooks.ts）；
+ * - 基线实现 = 未实现（返回 null）——链路保持现状：非平台链接不进入解析流程；
+ * - 后续实现可由宿主或扩展 replace('parse.generic') 注入
+ *   （OG 元信息抽取 / 页面结构化 / LLM 归纳，source 字段标注来源）；
+ * - LLM 接口仅预留契约：engineConfigContributions() 的「通用链接解析（预留）」组
+ *   提供 baseUrl/model/apiKey 配置位，暂无消费方，开关默认关闭。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/index.d.ts

@@ -21,6 +21,7 @@ export * from './engine/config';
 export * from './engine/platform-config';
 export * from './engine/translate';
 export * from './engine/parser';
+export * from './engine/generic';
 export * from './engine/fetcher';
 export * from './engine/compose';
 export * from './engine/forward';

package/lib/index.js

@@ -37,6 +37,7 @@ __exportStar(require("./engine/config"), exports);
 __exportStar(require("./engine/platform-config"), exports);
 __exportStar(require("./engine/translate"), exports);
 __exportStar(require("./engine/parser"), exports);
+__exportStar(require("./engine/generic"), exports);
 __exportStar(require("./engine/fetcher"), exports);
 __exportStar(require("./engine/compose"), exports);
 __exportStar(require("./engine/forward"), exports);

package/lib/workflow/default.js

@@ -59,6 +59,9 @@ async function sendDispatch(rt, input) {
 function createDefaultPipeline(rt) {
     const p = new hooks_1.Pipeline(rt);
     p.replace('parse', (input, r) => fetcher.fetchApi(r, input.url, input.type, input.fieldMapping, input.platformConf));
+    // 通用链接解析（预留）：基线=未实现（null）——非平台链接不进入解析流程；
+    // 后续由宿主/扩展 replace 注入（OG/HTML/LLM，契约见 engine/generic.ts）
+    p.replace('parse.generic', async () => null);
     p.replace('translate', async () => null);
     p.replace('media.image', async (input) => ({ kind: 'raw', url: input.url }));
     p.replace('media.video', async (input) => ({ kind: 'raw', url: input.videoUrl }));

package/lib/workflow/hooks.d.ts

@@ -13,7 +13,8 @@ import type { ParsedData } from '../types';
 import type { ImageOutcome, VideoOutcome, TranslateResult, GifOptions, MediaKind, VideoMeta } from '../extensions';
 import type { ProcessedItem, MessageUnit } from '../engine/compose';
 import type { OutboundSender, SessionLike } from '../sender';
-export type StageName = 'parse' | 'translate' | 'media.image' | 'media.video' | 'media.merged' | 'merge' | 'transcode' | 'compose' | 'send';
+import type { GenericLinkInput, GenericLinkResult } from '../engine/generic';
+export type StageName = 'parse' | 'parse.generic' | 'translate' | 'media.image' | 'media.video' | 'media.merged' | 'merge' | 'transcode' | 'compose' | 'send';
 export interface ParseInput {
     url: string;
     type: string;
@@ -67,6 +68,10 @@ export interface StageIO {
         input: ParseInput;
         output: ParsedData;
     };
+    'parse.generic': {
+        input: GenericLinkInput;
+        output: GenericLinkResult | null;
+    };
     translate: {
         input: TranslateInput;
         output: TranslateResult | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sns-parse/core",
-  "version": "0.6.0-alpha.1+upstream.1.6.7",
+  "version": "0.6.0-alpha.2+upstream.1.6.7",
   "description": "sns-parse 核心：契约、宿主抽象、配置 DSL 与解析引擎（fetcher/parser/翻译/X 原生解析/合并/GIF/TLS 指纹客户端）",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",