@sns-parse/ext-translate 0.1.0-alpha.1

package/lib/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @sns-parse/ext-translate：推文翻译（Google gtx + MyMemory 兜底）。
+ */
+import { translateText } from './translate';
+export { translateText, shouldSkipTranslate, langName } from './translate';
+export type { TranslateResult } from './translate';
+/** 组装为 core 扩展片段 */
+export declare function translateExtension(): {
+    translate: typeof translateText;
+};

package/lib/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.langName = exports.shouldSkipTranslate = exports.translateText = void 0;
+exports.translateExtension = translateExtension;
+/**
+ * @sns-parse/ext-translate：推文翻译（Google gtx + MyMemory 兜底）。
+ */
+const translate_1 = require("./translate");
+var translate_2 = require("./translate");
+Object.defineProperty(exports, "translateText", { enumerable: true, get: function () { return translate_2.translateText; } });
+Object.defineProperty(exports, "shouldSkipTranslate", { enumerable: true, get: function () { return translate_2.shouldSkipTranslate; } });
+Object.defineProperty(exports, "langName", { enumerable: true, get: function () { return translate_2.langName; } });
+/** 组装为 core 扩展片段 */
+function translateExtension() {
+    return { translate: translate_1.translateText };
+}

package/lib/translate.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 推文翻译：Google gtx 免费端点（无 Key、GET-only）。
+ *
+ * X 网页端的 Grok 翻译走私有通道（translations/show.json 已 404，GraphQL
+ * 仅返回 is_translatable 标志），无公开端点可调，故用通用翻译源。
+ * 译文存入 ParsedData.translation，经 ${翻译} 模板变量展示，空值行自动隐藏。
+ */
+import type { ParserRuntimeLike } from '@sns-parse/core';
+/** 判断是否需要跳过翻译（目标语系与推文语种相同 / 无语言内容） */
+export declare function shouldSkipTranslate(tweetLang: string | undefined, target: string): boolean;
+export declare function langName(code?: string): string;
+export interface TranslateResult {
+    text: string;
+    provider: 'Google' | 'MyMemory';
+}
+/** 翻译文本；失败返回 null（调用方保持无译文继续发送）。gtx 优先，MyMemory 兜底 */
+export declare function translateText(rt: ParserRuntimeLike, text: string, target: string, sourceLang?: string): Promise<TranslateResult | null>;

package/lib/translate.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldSkipTranslate = shouldSkipTranslate;
+exports.langName = langName;
+exports.translateText = translateText;
+const core_1 = require("@sns-parse/core");
+/** 判断是否需要跳过翻译（目标语系与推文语种相同 / 无语言内容） */
+function shouldSkipTranslate(tweetLang, target) {
+    if (!tweetLang)
+        return false;
+    const l = tweetLang.toLowerCase();
+    if (l === 'zxx' || l === 'und')
+        return l === 'zxx'; // zxx=无语言内容；und=未定则仍尝试
+    const t = target.toLowerCase();
+    if (t === 'zh')
+        return l === 'zh' || l.startsWith('zh-');
+    if (t === 'zh-tw')
+        return l === 'zh-tw' || l === 'zh-hant' || (l.startsWith('zh') && l !== 'zh-cn');
+    if (t === 'en')
+        return l === 'en';
+    return l === t;
+}
+/** 常见语种代码 → 中文名（未知代码原样展示） */
+const LANG_NAMES = {
+    fr: '法语', ja: '日语', ko: '韩语', en: '英语', zh: '中文', es: '西班牙语', pt: '葡萄牙语',
+    de: '德语', ru: '俄语', ar: '阿拉伯语', it: '意大利语', th: '泰语', vi: '越南语',
+    id: '印尼语', tr: '土耳其语', nl: '荷兰语', pl: '波兰语', hi: '印地语', uk: '乌克兰语',
+    sv: '瑞典语', no: '挪威语', fi: '芬兰语', da: '丹麦语', cs: '捷克语', ro: '罗马尼亚语',
+    hu: '匈牙利语', el: '希腊语', he: '希伯来语', fa: '波斯语', ur: '乌尔都语', ms: '马来语',
+    tl: '菲律宾语', ca: '加泰罗尼亚语', bg: '保加利亚语', hr: '克罗地亚语', sr: '塞尔维亚语',
+};
+function langName(code) {
+    if (!code)
+        return '';
+    const base = code.toLowerCase().split('-')[0];
+    if (base === 'und')
+        return '';
+    return LANG_NAMES[base] || code;
+}
+/** 翻译文本；失败返回 null（调用方保持无译文继续发送）。gtx 优先，MyMemory 兜底 */
+async function translateText(rt, text, target, sourceLang) {
+    if (!text)
+        return null;
+    const out = await viaGtx(rt, text, target);
+    if (out)
+        return { text: out, provider: 'Google' };
+    const backup = await viaMyMemory(rt, text, target, sourceLang);
+    if (backup)
+        return { text: backup, provider: 'MyMemory' };
+    return null;
+}
+/** Google gtx 免费端点（无 Key；sl=auto 自动检测源语种） */
+async function viaGtx(rt, text, target) {
+    const url = 'https://translate.googleapis.com/translate_a/single' +
+        `?client=gtx&sl=auto&dt=t&tl=${encodeURIComponent(target)}` +
+        `&q=${encodeURIComponent(text.slice(0, 2000))}`;
+    try {
+        const res = await rt.http.get(url, {
+            timeout: 15000,
+            headers: { 'User-Agent': rt.config.userAgent },
+        });
+        const data = res.data;
+        // gtx 响应形如 [[["译文","原文",null,null,10]],null,"fr",...]
+        if (Array.isArray(data?.[0])) {
+            const out = data[0].map((seg) => (typeof seg?.[0] === 'string' ? seg[0] : '')).join('').trim();
+            if (out)
+                return out;
+        }
+        (0, core_1.debugLog)('gtx 翻译响应结构异常，尝试备用通道');
+        return null;
+    }
+    catch (e) {
+        (0, core_1.debugLog)(`gtx 翻译失败：${e?.message || e}`);
+        return null;
+    }
+}
+/** MyMemory 备用（免费无 Key；需已知源语种，不支持 auto） */
+async function viaMyMemory(rt, text, target, sourceLang) {
+    const sl = normalizeLang(sourceLang);
+    if (!sl)
+        return null;
+    const tl = target.toLowerCase();
+    const url = 'https://api.mymemory.translated.net/get' +
+        `?q=${encodeURIComponent(text.slice(0, 500))}&langpair=${encodeURIComponent(sl + '|' + tl)}`;
+    try {
+        const res = await rt.http.get(url, { timeout: 15000, headers: { 'User-Agent': rt.config.userAgent } });
+        const out = res.data?.responseData?.translatedText;
+        if (typeof out === 'string' && out.trim() && !/^MYMEMORY WARNING/i.test(out))
+            return out.trim();
+        (0, core_1.debugLog)('MyMemory 翻译响应异常，放弃译文');
+        return null;
+    }
+    catch (e) {
+        core_1.logger.info(`推文翻译失败（跳过译文继续发送）：${e?.message || e}`);
+        return null;
+    }
+}
+function normalizeLang(lang) {
+    if (!lang)
+        return null;
+    const l = lang.toLowerCase();
+    if (l === 'und' || l === 'zxx')
+        return null;
+    if (l.startsWith('zh'))
+        return 'zh-CN';
+    return l.split('-')[0];
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@sns-parse/ext-translate",
+  "version": "0.1.0-alpha.1+upstream.1.6.7",
+  "description": "sns-parse 扩展：translate",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf lib",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@sns-parse/core": "^0.1.0",
+    "axios": "^1.16.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.3.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sns-parse/extensions.git",
+    "directory": "packages/ext-translate"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}