@sns-parse/core 0.3.0-alpha.1 → 0.4.0-alpha.10

package/lib/config.d.ts

@@ -22,6 +22,8 @@ export interface ConfigField {
     /** koishi 的 role：多行文本 / 密钥 */
     role?: 'textarea' | 'secret';
     hidden?: boolean;
+    /** 宿主 Schema 生成时的必填标记（仅 UI 层语义） */
+    required?: boolean;
     min?: number;
     max?: number;
     step?: number;
@@ -48,3 +50,8 @@ export declare function defineConfig(contribution: ConfigContribution): ConfigCo
  * 用于 core 汇总所有扩展与平台声明的配置。
  */
 export declare function mergeConfigContributions(lists: ConfigContribution[][]): ConfigContribution[];
+/**
+ * 由配置声明提取默认值表（CLI / 无 Schema 宿主用）：
+ * 平台开关等 object 字段展开为逐键默认值（如 { douyin: true, ... }）。
+ */
+export declare function defaultsFromContributions(contribs: ConfigContribution[]): Record<string, any>;

package/lib/config.js

@@ -11,6 +11,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defineConfig = defineConfig;
 exports.mergeConfigContributions = mergeConfigContributions;
+exports.defaultsFromContributions = defaultsFromContributions;
 /** 类型辅助：声明即校验 */
 function defineConfig(contribution) {
     return contribution;
@@ -36,3 +37,30 @@ function mergeConfigContributions(lists) {
     }
     return out;
 }
+function applyFieldDefault(target, f) {
+    if (f.type === 'object' && f.fields) {
+        const obj = {};
+        for (const sub of f.fields)
+            applyFieldDefault(obj, sub);
+        // object 自身 default 与子字段 default 合并（子字段优先）
+        target[f.key] = isPlainObject(f.default) ? { ...f.default, ...obj } : obj;
+        return;
+    }
+    if (f.default !== undefined)
+        target[f.key] = f.default;
+}
+function isPlainObject(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+/**
+ * 由配置声明提取默认值表（CLI / 无 Schema 宿主用）：
+ * 平台开关等 object 字段展开为逐键默认值（如 { douyin: true, ... }）。
+ */
+function defaultsFromContributions(contribs) {
+    const out = {};
+    for (const c of contribs) {
+        for (const f of c.fields)
+            applyFieldDefault(out, f);
+    }
+    return out;
+}

package/lib/engine/config-io.d.ts

@@ -0,0 +1,44 @@
+export declare const CONFIG_ENVELOPE_KIND = "sns-parse-config";
+export declare const CONFIG_ENVELOPE_VERSION = 1;
+/** 脱敏占位；导入时遇此值跳过（保留现有密钥） */
+export declare const MASK = "***";
+export interface ConfigEnvelope {
+    kind: typeof CONFIG_ENVELOPE_KIND;
+    version: number;
+    exportedAt: string;
+    pluginName: string;
+    redacted: boolean;
+    config: Record<string, any>;
+}
+/** 判断键名是否为敏感字段（另含 customHeaders[].value 等，由调用方逐层递归统一处理） */
+export declare function isSecretKey(key: string): boolean;
+/** 深度克隆并按敏感键名打码；数组原样保留（元素递归） */
+export declare function redactConfig(config: any): any;
+/** 构造导出信封 */
+export declare function createConfigEnvelope(config: any, opts?: {
+    pluginName?: string;
+    includeSecrets?: boolean;
+}): ConfigEnvelope;
+/** 序列化信封（pretty JSON） */
+export declare function serializeConfigEnvelope(env: ConfigEnvelope): string;
+export declare function isConfigEnvelope(x: any): x is ConfigEnvelope;
+/**
+ * 解析导入输入：接受
+ * - 信封 JSON
+ * - 裸配置对象 JSON
+ * - 旧版导出（无 kind，直接是配置）
+ */
+export declare function parseConfigInput(input: string): {
+    config: Record<string, any>;
+    envelope: boolean;
+    pluginName?: string;
+};
+/** 深度合并：对象递归合并，数组/标量直接替换；MASK 值跳过（保留现有） */
+export declare function mergeConfig(base: any, patch: any): any;
+/** 统计将被覆盖的顶层键，供 import/migrate 输出摘要 */
+export declare function diffKeys(base: any, patch: any): string[];
+export declare function overrideFilePath(baseDir: string | undefined, name: string): string;
+export declare function readOverride(baseDir: string | undefined, name: string): Record<string, any> | null;
+export declare function writeOverride(baseDir: string | undefined, name: string, config: Record<string, any>, pluginName?: string): string;
+/** 读覆盖文件并合并到 schema 配置之上（启动时调用） */
+export declare function applyOverrideToConfig(config: any, baseDir: string | undefined, name: string): any;

package/lib/engine/config-io.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MASK = exports.CONFIG_ENVELOPE_VERSION = exports.CONFIG_ENVELOPE_KIND = void 0;
+exports.isSecretKey = isSecretKey;
+exports.redactConfig = redactConfig;
+exports.createConfigEnvelope = createConfigEnvelope;
+exports.serializeConfigEnvelope = serializeConfigEnvelope;
+exports.isConfigEnvelope = isConfigEnvelope;
+exports.parseConfigInput = parseConfigInput;
+exports.mergeConfig = mergeConfig;
+exports.diffKeys = diffKeys;
+exports.overrideFilePath = overrideFilePath;
+exports.readOverride = readOverride;
+exports.writeOverride = writeOverride;
+exports.applyOverrideToConfig = applyOverrideToConfig;
+/**
+ * 配置导出 / 导入 / 迁移。
+ *
+ * 目的：新旧包使用不同命名空间（旧 video-parser-all / 新 sns-parse），
+ * koishi 配置键随之不同，因此提供可跨命名空间移植的配置信封。
+ *
+ * - 导出：默认脱敏（密钥打码 MASK），--include-secrets 才输出明文
+ * - 导入：深度合并进当前配置；MASK 值跳过（保留现有密钥）
+ * - 持久化：自管覆盖文件 <baseDir>/data/<name>/config.override.json
+ */
+const fs_1 = require("fs");
+const path_1 = require("path");
+exports.CONFIG_ENVELOPE_KIND = 'sns-parse-config';
+exports.CONFIG_ENVELOPE_VERSION = 1;
+/** 脱敏占位；导入时遇此值跳过（保留现有密钥） */
+exports.MASK = '***';
+/** 需要脱敏的键名（大小写不敏感） */
+const SECRET_KEYS = new Set([
+    'apikey', 'secretkey', 'secretid', 'accesskeyid', 'accesskeysecret',
+    'authtoken', 'ct0', 'twitterauthtoken', 'twitterct0', 'password',
+]);
+function isPlainObject(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+/** 判断键名是否为敏感字段（另含 customHeaders[].value 等，由调用方逐层递归统一处理） */
+function isSecretKey(key) {
+    return SECRET_KEYS.has(key.toLowerCase());
+}
+/** 深度克隆并按敏感键名打码；数组原样保留（元素递归） */
+function redactConfig(config) {
+    if (Array.isArray(config))
+        return config.map(redactConfig);
+    if (!isPlainObject(config))
+        return config;
+    const out = {};
+    for (const [k, v] of Object.entries(config)) {
+        if (isSecretKey(k) && typeof v === 'string' && v)
+            out[k] = exports.MASK;
+        else
+            out[k] = redactConfig(v);
+    }
+    return out;
+}
+/** 构造导出信封 */
+function createConfigEnvelope(config, opts = {}) {
+    const cfg = opts.includeSecrets ? JSON.parse(JSON.stringify(config ?? {})) : redactConfig(config);
+    return {
+        kind: exports.CONFIG_ENVELOPE_KIND,
+        version: exports.CONFIG_ENVELOPE_VERSION,
+        exportedAt: new Date().toISOString(),
+        pluginName: opts.pluginName || '',
+        redacted: !opts.includeSecrets,
+        config: cfg,
+    };
+}
+/** 序列化信封（pretty JSON） */
+function serializeConfigEnvelope(env) {
+    return JSON.stringify(env, null, 2);
+}
+function isConfigEnvelope(x) {
+    return !!x && typeof x === 'object' && x.kind === exports.CONFIG_ENVELOPE_KIND;
+}
+/**
+ * 解析导入输入：接受
+ * - 信封 JSON
+ * - 裸配置对象 JSON
+ * - 旧版导出（无 kind，直接是配置）
+ */
+function parseConfigInput(input) {
+    let data;
+    const text = (input || '').trim();
+    if (!text)
+        throw new Error('导入内容为空');
+    try {
+        data = JSON.parse(text);
+    }
+    catch (e) {
+        throw new Error(`导入内容不是合法 JSON：${e?.message || e}`);
+    }
+    if (isConfigEnvelope(data)) {
+        return { config: data.config || {}, envelope: true, pluginName: data.pluginName };
+    }
+    if (isPlainObject(data))
+        return { config: data, envelope: false };
+    throw new Error('导入内容既不是配置信封也不是配置对象');
+}
+/** 深度合并：对象递归合并，数组/标量直接替换；MASK 值跳过（保留现有） */
+function mergeConfig(base, patch) {
+    if (!isPlainObject(patch))
+        return patch;
+    const out = isPlainObject(base) ? { ...base } : {};
+    for (const [k, v] of Object.entries(patch)) {
+        if (v === exports.MASK)
+            continue;
+        out[k] = isPlainObject(v) && isPlainObject(out[k]) ? mergeConfig(out[k], v) : v;
+    }
+    return out;
+}
+/** 统计将被覆盖的顶层键，供 import/migrate 输出摘要 */
+function diffKeys(base, patch) {
+    if (!isPlainObject(patch))
+        return [];
+    const out = [];
+    for (const [k, v] of Object.entries(patch)) {
+        if (v === exports.MASK)
+            continue;
+        if (isPlainObject(v) && isPlainObject(base?.[k]))
+            out.push(...diffKeys(base[k], v).map(sub => `${k}.${sub}`));
+        else
+            out.push(k);
+    }
+    return out;
+}
+/* ---------- 覆盖文件持久化 ---------- */
+function overrideFilePath(baseDir, name) {
+    const root = baseDir || process.cwd();
+    return (0, path_1.join)(root, 'data', name, 'config.override.json');
+}
+function readOverride(baseDir, name) {
+    try {
+        const raw = (0, fs_1.readFileSync)(overrideFilePath(baseDir, name), 'utf8');
+        const data = JSON.parse(raw);
+        return isConfigEnvelope(data) ? data.config : (isPlainObject(data) ? data : null);
+    }
+    catch {
+        return null;
+    }
+}
+function writeOverride(baseDir, name, config, pluginName) {
+    const file = overrideFilePath(baseDir, name);
+    (0, fs_1.mkdirSync)((0, path_1.dirname)(file), { recursive: true });
+    const env = createConfigEnvelope(config, { pluginName: pluginName || name, includeSecrets: true });
+    (0, fs_1.writeFileSync)(file, serializeConfigEnvelope(env), 'utf8');
+    return file;
+}
+/** 读覆盖文件并合并到 schema 配置之上（启动时调用） */
+function applyOverrideToConfig(config, baseDir, name) {
+    const override = readOverride(baseDir, name);
+    return override ? mergeConfig(config, override) : config;
+}

package/lib/engine/config.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 引擎层配置声明（中立 DSL）：fetcher/parser/compose/sender/gateway 等引擎
+ * 自身读取的配置项，由 core 统一声明；koishi / CLI 兼容层据此生成 Schema 与默认值。
+ *
+ * 组序即 UI 展示序（koishi 兼容层在「发送策略」后插入扩展与平台的动态声明）。
+ */
+import { type ConfigContribution } from '../config';
+/** 引擎层配置声明（有序；组名即 UI 分组标题） */
+export declare function engineConfigContributions(): ConfigContribution[];

package/lib/engine/config.js

@@ -0,0 +1,265 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.engineConfigContributions = engineConfigContributions;
+/**
+ * 引擎层配置声明（中立 DSL）：fetcher/parser/compose/sender/gateway 等引擎
+ * 自身读取的配置项，由 core 统一声明；koishi / CLI 兼容层据此生成 Schema 与默认值。
+ *
+ * 组序即 UI 展示序（koishi 兼容层在「发送策略」后插入扩展与平台的动态声明）。
+ */
+const config_1 = require("../config");
+const PROXY_FIELDS = [
+    { key: 'enabled', type: 'boolean', default: false, description: '启用代理' },
+    {
+        key: 'protocol', type: 'union', default: 'http', description: '协议',
+        values: [
+            { value: 'http', description: 'HTTP' },
+            { value: 'https', description: 'HTTPS' },
+        ],
+    },
+    { key: 'host', type: 'string', default: '127.0.0.1', description: '地址' },
+    { key: 'port', type: 'number', default: 7890, description: '端口' },
+    {
+        key: 'auth', type: 'object', description: '认证',
+        fields: [
+            { key: 'username', type: 'string', default: '', description: '用户名' },
+            { key: 'password', type: 'string', default: '', description: '密码' },
+        ],
+    },
+];
+const AUTH_HEADER_FIELDS = [
+    {
+        key: 'authHeaderType', type: 'union', default: 'Bearer', description: '认证头类型',
+        values: [
+            { value: 'Bearer', description: 'Bearer' },
+            { value: 'X-API-Key', description: 'X-API-Key' },
+            { value: 'Custom', description: '自定义' },
+        ],
+    },
+    { key: 'customHeaderName', type: 'string', default: 'X-API-Key', description: '自定义头名称' },
+];
+const FIELD_MAPPING_FIELD = {
+    key: 'fieldMapping', type: 'string', role: 'textarea',
+    default: '{}', description: '字段映射 JSON',
+};
+const API_PLATFORM_VALUES = [
+    { value: 'bilibili', description: '哔哩哔哩' },
+    { value: 'douyin', description: '抖音' },
+    { value: 'kuaishou', description: '快手' },
+    { value: 'xiaohongshu', description: '小红书' },
+    { value: 'weibo', description: '微博' },
+    { value: 'xigua', description: '西瓜视频' },
+    { value: 'youtube', description: 'YouTube' },
+    { value: 'tiktok', description: 'TikTok' },
+    { value: 'acfun', description: 'AcFun（A站）' },
+    { value: 'zhihu', description: '知乎' },
+    { value: 'weishi', description: '微视' },
+    { value: 'huya', description: '虎牙' },
+    { value: 'haokan', description: '好看视频' },
+    { value: 'meipai', description: '美拍' },
+    { value: 'twitter', description: 'Twitter/X' },
+    { value: 'instagram', description: 'Instagram' },
+    { value: 'doubao', description: '豆包' },
+    { value: 'doubao_image', description: '豆包图片' },
+    { value: 'jimeng', description: '即梦' },
+    { value: 'oasis', description: '绿洲' },
+    { value: 'wechat_channel', description: '视频号' },
+    { value: 'lishi', description: '梨视频' },
+    { value: 'quanmin', description: '全民直播' },
+    { value: 'pipigx', description: '皮皮搞笑' },
+    { value: 'pipixia', description: '皮皮虾' },
+    { value: 'zuiyou', description: '最右' },
+    { value: 'toutiao', description: '今日头条' },
+];
+const GLOBAL_FIELD_MAPPING_DEFAULT = [
+    '{',
+    '  "title": "data.title",',
+    '  "desc": "data.description",',
+    '  "author": "data.author.name",',
+    '  "uid": "data.author.id",',
+    '  "avatar": "data.author.avatar",',
+    '  "cover": "data.cover_url",',
+    '  "video": "data.video_url",',
+    '  "video_backup": "data.video_qualities",',
+    '  "videos": "data.videos",',
+    '  "type": "data.type",',
+    '  "like": "data.statistics.likes",',
+    '  "comment": "data.statistics.comments",',
+    '  "collect": "data.statistics.favorites",',
+    '  "share": "data.statistics.shares",',
+    '  "play": "data.statistics.plays",',
+    '  "duration": "data.duration",',
+    '  "publishTime": "data.create_time",',
+    '  "music_title": "data.music.title",',
+    '  "music_author": "data.music.author",',
+    '  "music_cover": "data.music.cover",',
+    '  "music_url": "data.music.url"',
+    '}',
+].join('\n');
+/** 引擎层配置声明（有序；组名即 UI 分组标题） */
+function engineConfigContributions() {
+    return [
+        (0, config_1.defineConfig)({
+            group: '消息格式',
+            fields: [
+                {
+                    key: 'unifiedMessageFormat', type: 'string', role: 'textarea',
+                    default: '标题：${标题}\n作者：${作者}\n简介：${简介}\n正文：${正文}\n翻译（${翻译提供方}，${原文语言}）：${翻译}\n音乐标题：${音乐标题}\n音乐作者：${音乐作者}\n点赞：${点赞数}\n收藏：${收藏数}\n转发：${转发数}\n播放：${播放数}\n评论：${评论数}\n图片数量：${图片数量}',
+                    description: '消息文字模板，可用变量：${标题} ${作者} ${简介} ${正文}（纯文字作品正文，启用后该类作品不再显示为简介） ${翻译} ${翻译提供方} ${原文语言} ${视频时长} ${点赞数} ${收藏数} ${转发数} ${播放数} ${评论数} ${发布时间} ${图片数量} ${作者ID} ${音乐标题} ${音乐作者}（空行自动隐藏）',
+                },
+            ],
+        }),
+        (0, config_1.defineConfig)({
+            group: '媒体发送',
+            fields: [
+                { key: 'showImageText', type: 'boolean', default: true, description: '发送文字内容' },
+                { key: 'showCoverImage', type: 'boolean', default: true, description: '发送封面图片' },
+                { key: 'showCoverFile', type: 'boolean', default: true, description: '封面以图片形式发送（关闭则只发链接）' },
+                { key: 'showCoverText', type: 'boolean', default: true, description: '封面图前显示文字提示' },
+                { key: 'coverText', type: 'string', default: '封面：', description: '封面提示文字' },
+                { key: 'showImageFileNew', type: 'boolean', default: true, description: '图片以图片形式发送（关闭则只发链接）' },
+                { key: 'showAuthorAvatar', type: 'boolean', default: true, description: '发送作者头像' },
+                { key: 'showAuthorAvatarFile', type: 'boolean', default: true, description: '头像以图片形式发送（关闭则只发链接）' },
+                { key: 'showAuthorAvatarText', type: 'boolean', default: true, description: '头像前显示文字提示' },
+                { key: 'authorAvatarText', type: 'string', default: '作者头像：', description: '头像提示文字' },
+                { key: 'showMusicCover', type: 'boolean', default: true, description: '发送音乐封面' },
+                { key: 'showVideoFile', type: 'boolean', default: true, description: '视频以视频形式发送（关闭则只发链接）' },
+                { key: 'sendLiveMessage', type: 'boolean', default: true, description: '直播作品发文字消息（不发视频）' },
+                { key: 'mergeSameOriginImages', type: 'boolean', default: true, description: '同源切图内容识别合并（纯像素内容裁决，不依赖链接/文件名/色调风格）：网格/竖堆/横拼三种布局各自经接缝连续性验证（低频趋势延续+纹理能量可验证性），取证据最强者合并；均不过回退逐张；需 ffmpeg' },
+            ],
+        }),
+        (0, config_1.defineConfig)({
+            group: '音乐语音（需 silk 和 ffmpeg）',
+            fields: [
+                { key: 'showMusicVoice', type: 'boolean', default: false, description: '音乐链接以语音形式发送' },
+                { key: 'showMusicVoiceFile', type: 'boolean', default: true, description: '音乐是否以语音形式发送（关闭则只发送链接）' },
+            ],
+        }),
+        (0, config_1.defineConfig)({
+            group: 'GIF 转换',
+            fields: [
+                { key: 'gifConvertEnabled', type: 'boolean', default: true, description: '推文动图转 GIF 发送（ffmpeg 随插件自动安装，失败回退原视频）' },
+                { key: 'gifMaxWidth', type: 'number', min: 120, max: 1080, step: 1, default: 480, description: 'GIF 宽度 (px)' },
+                { key: 'gifFps', type: 'number', min: 5, max: 30, step: 1, default: 15, description: 'GIF 帧率' },
+                { key: 'gifMaxDurationSec', type: 'number', min: 1, max: 60, step: 1, default: 15, description: 'GIF 时长上限 (s)' },
+            ],
+        }),
+        (0, config_1.defineConfig)({
+            group: '性能与限制',
+            fields: [
+                { key: 'maxDescLength', type: 'number', min: 0, step: 1, default: 200, description: '简介长度上限' },
+                { key: 'maxConcurrent', type: 'number', min: 1, step: 1, default: 3, description: '解析最大并发数' },
+            ],
+        }),
+        (0, config_1.defineConfig)({
+            group: '发送策略',
+            fields: [
+                {
+                    key: 'sendStrategy', type: 'union', default: 'single', description: '发送策略',
+                    values: [
+                        { value: 'single', description: '单条整合（默认；图片过多/含视频自动回退合并转发）' },
+                        { value: 'split', description: '逐条分开发送（旧版行为）' },
+                    ],
+                },
+                { key: 'singleSendMaxImages', type: 'number', min: 1, default: 10, description: '单条消息最大图片数（超出回退合并转发）' },
+            ],
+        }),
+        (0, config_1.defineConfig)({
+            group: '网络与请求',
+            fields: [
+                { key: 'timeout', type: 'number', min: 0, step: 1, default: 180000, description: 'API 请求超时 (ms)' },
+                { key: 'videoSendTimeout', type: 'number', min: 0, step: 1, default: 180000, description: '消息发送超时 (ms)' },
+                { key: 'userAgent', type: 'string', default: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36', description: 'User-Agent' },
+                { key: 'proxy', type: 'object', description: 'HTTP/HTTPS 代理', fields: PROXY_FIELDS },
+                {
+                    key: 'customHeaders', type: 'array', default: [], description: '自定义请求头',
+                    itemFields: [
+                        { key: 'name', type: 'string', required: true, description: '头名称' },
+                        { key: 'value', type: 'string', required: true, description: '头值' },
+                    ],
+                },
+            ],
+        }),
+        (0, config_1.defineConfig)({
+            group: '发送与重试',
+            fields: [
+                { key: 'ignoreSendError', type: 'boolean', default: true, description: '忽略发送失败' },
+                { key: 'retryTimes', type: 'number', min: 0, default: 3, description: '重试次数' },
+                { key: 'retryInterval', type: 'number', min: 0, default: 1000, description: '重试间隔 (ms)' },
+                { key: 'enableForward', type: 'boolean', default: false, description: '合并转发（OneBot/Satori）' },
+            ],
+        }),
+        (0, config_1.defineConfig)({
+            group: '缓存与临时文件',
+            fields: [
+                { key: 'deduplicationInterval', type: 'number', min: 0, default: 180, description: '去重间隔 (s)' },
+                { key: 'enableDeduplication', type: 'boolean', default: true, description: '启用重复解析检测与提示' },
+                { key: 'cacheTTL', type: 'number', min: 0, default: 600, description: '缓存时间 (s)' },
+            ],
+        }),
+        (0, config_1.defineConfig)({
+            group: 'API 与平台',
+            fields: [
+                { key: 'primaryApiUrl', type: 'string', default: 'https://api.bugpk.com/api/short_videos', hidden: true },
+                { key: 'backupApiUrl', type: 'string', default: 'https://api.bugpk.com/api/svparse', hidden: true },
+                {
+                    key: 'customApis', type: 'array', default: [], description: '覆盖内置平台 API',
+                    itemFields: [
+                        { key: 'platform', type: 'union', required: true, description: '平台', values: API_PLATFORM_VALUES },
+                        { key: 'apiUrl', type: 'string', description: 'API 地址' },
+                        { key: 'apiKey', type: 'string', default: '', description: 'API Key' },
+                        ...AUTH_HEADER_FIELDS.map(f => ({ ...f })),
+                        FIELD_MAPPING_FIELD,
+                    ],
+                },
+                {
+                    key: 'customPlatforms', type: 'array', default: [], description: '自定义新平台',
+                    itemFields: [
+                        { key: 'name', type: 'string', required: true, description: '平台名称' },
+                        { key: 'exampleUrl', type: 'string', description: '示例链接' },
+                        { key: 'keywords', type: 'string', required: true, description: '关键词（逗号分隔）' },
+                        { key: 'apiUrl', type: 'string', required: true, description: '解析 API' },
+                        { key: 'apiKey', type: 'string', default: '', description: 'API Key' },
+                        ...AUTH_HEADER_FIELDS.map(f => ({ ...f })),
+                        FIELD_MAPPING_FIELD,
+                        { key: 'proxy', type: 'object', description: '独立代理（覆盖全局代理）', fields: PROXY_FIELDS },
+                    ],
+                },
+                {
+                    key: 'globalFieldMapping', type: 'string', role: 'textarea',
+                    default: GLOBAL_FIELD_MAPPING_DEFAULT, description: '全局字段映射 JSON',
+                },
+                { key: 'twitterAuthToken', type: 'string', default: '', role: 'secret', description: 'X 登录态 auth_token（解析需登录推文用，受 Cloudflare 指纹限制可能 403）' },
+                { key: 'twitterCt0', type: 'string', default: '', role: 'secret', description: 'X 登录态 ct0（与 auth_token 配对）' },
+                { key: 'tweetTranslateEnabled', type: 'boolean', default: true, description: '外语推文自动翻译（配置 X 登录态时用网页同源 Grok 翻译，否则通用翻译；附译文行）' },
+                {
+                    key: 'tweetTranslateLang', type: 'union', default: 'zh', description: '翻译目标语言',
+                    values: [
+                        { value: 'zh', description: '简体中文' },
+                        { value: 'zh-TW', description: '繁體中文' },
+                        { value: 'en', description: 'English' },
+                        { value: 'ja', description: '日本語' },
+                        { value: 'ko', description: '한국어' },
+                        { value: 'fr', description: 'Français' },
+                        { value: 'de', description: 'Deutsch' },
+                        { value: 'ru', description: 'Русский' },
+                        { value: 'es', description: 'Español' },
+                        { value: 'pt', description: 'Português' },
+                    ],
+                },
+                { key: 'apiKey', type: 'string', default: '', role: 'secret', description: '新网关 API Key（https://api-new.ifphp.com/auth/login 注册获取；留空用旧网关）' },
+            ],
+        }),
+        (0, config_1.defineConfig)({
+            group: '界面文本',
+            fields: [
+                { key: 'waitingTipText', type: 'string', default: '正在解析视频，请稍候...', description: '等待提示' },
+                { key: 'unsupportedPlatformText', type: 'string', default: '不支持该平台链接', description: '不支持提示' },
+                { key: 'invalidLinkText', type: 'string', default: '无效的视频链接', description: '无效链接提示' },
+                { key: 'parseErrorPrefix', type: 'string', default: '❌ 解析失败：', description: '错误前缀' },
+                { key: 'parseErrorItemFormat', type: 'string', default: '【${url}】: ${msg}', description: '错误格式' },
+                { key: 'deduplicationTipText', type: 'string', default: '链接 ${url} 在最近 ${interval} 秒内已解析过，已跳过。', description: '重复解析提示，支持变量 ${url} ${interval}' },
+            ],
+        }),
+    ];
+}

package/lib/engine/fetcher.d.ts

@@ -0,0 +1,21 @@
+import type { ParserRuntime } from './runtime';
+import type { ParsedData } from '../types';
+export declare function fetchApi(rt: ParserRuntime, url: string, type: string, fieldMapping?: Record<string, string>, platformConf?: any): Promise<ParsedData>;
+export declare function parseUrl(rt: ParserRuntime, url: string, type: string, fieldMapping?: Record<string, string>, platformConf?: any): Promise<{
+    success: true;
+    data: ParsedData;
+} | {
+    success: false;
+    msg: string;
+}>;
+export declare function processSingleUrl(rt: ParserRuntime, url: string, type: string, fieldMapping?: Record<string, string>, platformConf?: any): Promise<{
+    success: true;
+    data: {
+        text: string;
+        parsed: ParsedData;
+    };
+} | {
+    success: false;
+    msg: string;
+    url: string;
+}>;