@thor123141245r/ai-translate 0.0.0 → 1.0.1

package/dist/i18n/translate.js

@@ -0,0 +1,199 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { logger } from '../logger.js';
+import { alignStructure } from './align.js';
+import { extractLeafStrings } from './extract.js';
+import { getAtPath, setAtPath, pathToString } from './json-path.js';
+import { protectPlaceholders, restorePlaceholders } from './placeholders.js';
+import { TranslationCache } from './cache.js';
+import { i18nBatchPromptInvoke, i18nRepairPromptInvoke } from './prompt.js';
+import { parseJsonArray } from './parse.js';
+import { getLanguageName } from '../prompt.js';
+const log = logger('i18n');
+const isNonEmptyString = (v) => typeof v === 'string' && v.trim().length > 0;
+const deepClone = (v) => JSON.parse(JSON.stringify(v));
+const readJsonFile = (file) => {
+    const raw = fs.readFileSync(file, 'utf-8');
+    return JSON.parse(raw);
+};
+const writeJsonFile = (file, obj) => {
+    fs.writeFileSync(file, JSON.stringify(obj, null, 2) + '\n', 'utf-8');
+};
+const chunkUnits = (units, maxItems, maxChars) => {
+    const batches = [];
+    let cur = [];
+    let curChars = 0;
+    const pushCur = () => {
+        if (!cur.length)
+            return;
+        batches.push(cur);
+        cur = [];
+        curChars = 0;
+    };
+    for (const u of units) {
+        const estimated = u.protectedText.length + 40;
+        if (cur.length >= maxItems || (cur.length > 0 && curChars + estimated > maxChars)) {
+            pushCur();
+        }
+        cur.push(u);
+        curChars += estimated;
+    }
+    pushCur();
+    return batches;
+};
+const buildCacheKey = (opts) => `${opts.sourceLang}|${opts.targetLang}|${pathToString(opts.path)}|${opts.text}`;
+const translateBatch = async (opts) => {
+    const itemsJson = JSON.stringify(opts.items);
+    const messages = await i18nBatchPromptInvoke({
+        sourceLanguage: opts.sourceLanguage,
+        targetLanguage: opts.targetLanguage,
+        itemsJson
+    });
+    const result = await opts.model.invoke(messages);
+    try {
+        return parseJsonArray(String(result.content ?? ''));
+    }
+    catch (err) {
+        // One repair attempt: ask the model to output valid JSON only.
+        const expectedIds = opts.items.map((it) => it.id);
+        const repair = await i18nRepairPromptInvoke({
+            sourceLanguage: opts.sourceLanguage,
+            targetLanguage: opts.targetLanguage,
+            expectedIds,
+            badOutput: String(result.content ?? '')
+        });
+        const repaired = await opts.model.invoke(repair);
+        return parseJsonArray(String(repaired.content ?? ''));
+    }
+};
+export const translateI18nDir = async (opts) => {
+    const { baseDir, sourceLang, targets, mode, dryRun = false, fileName, batchMaxItems = 40, batchMaxChars = 6000, cacheFile } = opts.options;
+    if (!targets.length)
+        throw new Error('targets is required');
+    const sourceFileName = fileName || `${sourceLang}.json`;
+    const sourceFile = path.resolve(baseDir, sourceFileName);
+    if (!fs.existsSync(sourceFile)) {
+        throw new Error(`source file not found: ${sourceFile}`);
+    }
+    const cache = new TranslationCache(cacheFile);
+    cache.load();
+    const sourceJson = readJsonFile(sourceFile);
+    const sourceLeaves = extractLeafStrings(sourceJson);
+    const stats = [];
+    for (const targetLang of targets) {
+        const targetFileName = `${targetLang}.json`;
+        const targetFile = path.resolve(baseDir, targetFileName);
+        const targetJsonRaw = fs.existsSync(targetFile) ? readJsonFile(targetFile) : undefined;
+        const alignedTarget = alignStructure(sourceJson, targetJsonRaw, mode);
+        const targetJson = deepClone(alignedTarget);
+        const units = [];
+        let skippedExisting = 0;
+        let usedCache = 0;
+        for (let i = 0; i < sourceLeaves.length; i++) {
+            const { path: p, value: sourceText } = sourceLeaves[i];
+            if (!sourceText || sourceText.trim() === '')
+                continue;
+            const existing = getAtPath(targetJson, p);
+            if (mode === 'fill' && isNonEmptyString(existing)) {
+                skippedExisting++;
+                continue;
+            }
+            const cacheKey = buildCacheKey({
+                sourceLang,
+                targetLang,
+                path: p,
+                text: sourceText
+            });
+            const cached = cache.get(cacheKey);
+            if (cached) {
+                usedCache++;
+                setAtPath(targetJson, p, cached);
+                continue;
+            }
+            const { tokens, protectedText } = protectPlaceholders(sourceText);
+            const id = `k${String(units.length + 1).padStart(6, '0')}`;
+            units.push({
+                id,
+                path: p,
+                sourceText,
+                protectedText,
+                tokens
+            });
+        }
+        const totalStrings = sourceLeaves.filter((x) => x.value.trim().length > 0).length;
+        if (dryRun) {
+            stats.push({
+                targetLang,
+                sourceFile,
+                targetFile,
+                totalStrings,
+                skippedExisting,
+                toTranslate: units.length,
+                translated: 0,
+                failed: 0,
+                usedCache
+            });
+            continue;
+        }
+        const batches = chunkUnits(units, batchMaxItems, batchMaxChars);
+        let translated = 0;
+        let failed = 0;
+        for (let bi = 0; bi < batches.length; bi++) {
+            const batch = batches[bi];
+            const items = batch.map((u) => ({ id: u.id, text: u.protectedText }));
+            try {
+                const out = await translateBatch({
+                    model: opts.model,
+                    sourceLanguage: getLanguageName(sourceLang),
+                    targetLanguage: getLanguageName(targetLang),
+                    items
+                });
+                const outMap = new Map(out.map((x) => [x.id, x.text]));
+                for (const u of batch) {
+                    const translatedText = outMap.get(u.id);
+                    if (!translatedText) {
+                        failed++;
+                        // fall back to English to keep JSON valid and predictable
+                        setAtPath(targetJson, u.path, u.sourceText);
+                        continue;
+                    }
+                    const restored = restorePlaceholders(translatedText, u.tokens);
+                    setAtPath(targetJson, u.path, restored);
+                    translated++;
+                    const cacheKey = buildCacheKey({
+                        sourceLang,
+                        targetLang,
+                        path: u.path,
+                        text: u.sourceText
+                    });
+                    cache.set(cacheKey, restored);
+                }
+            }
+            catch (err) {
+                log.error({ err, targetLang, batch: bi + 1, batches: batches.length });
+                // degrade: keep source for this batch
+                for (const u of batch) {
+                    failed++;
+                    setAtPath(targetJson, u.path, u.sourceText);
+                }
+            }
+        }
+        writeJsonFile(targetFile, targetJson);
+        stats.push({
+            targetLang,
+            sourceFile,
+            targetFile,
+            totalStrings,
+            skippedExisting,
+            toTranslate: units.length,
+            translated,
+            failed,
+            usedCache
+        });
+    }
+    if (!dryRun) {
+        cache.save();
+    }
+    return stats;
+};
+//# sourceMappingURL=translate.js.map

package/dist/i18n/translate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.js","sourceRoot":"","sources":["../../src/i18n/translate.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { AiTranslateTransform, modelFactory } from './model.js';
 export { promptInvoke, languages } from './prompt.js';
 export { TextSplitterStream, recursiveChunkTextSplitter, getFormatByExtension } from './split.js';
+export { translateI18nDir } from './i18n/translate.js';
 export type { Metadata, ModelFactoryOptions } from './model.js';
 export type { TextSplitterParams, Separator } from './split.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACrB,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAC/D,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACrB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,YAAY,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAC/D,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export { AiTranslateTransform, modelFactory } from './model.js';
 export { promptInvoke, languages } from './prompt.js';
 export { TextSplitterStream, recursiveChunkTextSplitter, getFormatByExtension } from './split.js';
+export { translateI18nDir } from './i18n/translate.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACrB,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACrB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thor123141245r/ai-translate",
-  "version": "0.0.0",
+  "version": "1.0.1",
   "publishConfig": {
     "access": "public"
   },
@@ -17,6 +17,11 @@
       "default": "./dist/index.js"
     }
   },
+  "files": [
+    "dist",
+    "README.md",
+    "README.zh-CN.md"
+  ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "dev:cli": "tsx src/bin/ai-translate.ts",

package/.agentdocs/code-changes/2026-01-22/AI/347/277/273/350/257/221/345/231/250TS/345/256/236/347/216/260-/345/256/236/347/216/260.md

@@ -1,22 +0,0 @@
-作者:Codex|创建时间:2026-01-22 23:35
-
-# 变更概述
-基于方案实现 TypeScript 版本的 AI 翻译器：按官方库结构复刻核心流程，补齐模块分层、CLI 入口、配置与日志策略，并提供最小验证脚本与中文说明。
-
-# 变更清单
-- [x] 引入并对齐 ai-translate 的核心 API 与流程
-- [x] 新增 TypeScript 目录结构与模块实现
-- [x] 新增 CLI 或脚本入口
-- [x] 配置与日志策略落地
-- [x] 中文使用文档更新
-- [x] 最小测试或验证脚本补齐
-
-# 关键设计对齐
-- 模块分层：配置解析层、翻译执行层、文件读写层、日志层
-- 复用优先：最大限度遵循官方库结构与命名
-- 日志策略：开发环境整对象打印，生产环境精简敏感信息
-
-# 待确认事项状态
-- 是否要求完全对齐官方库的所有导出与命令参数：未确认
-- 是否需要发布为独立 npm 包：未确认
-- 是否要兼容现有 Python 脚本的输入格式：未确认

package/.agentdocs/code-changes/2026-01-23/CLI/345/210/206/345/217/221-npx/345/256/236/347/216/260.md

@@ -1,18 +0,0 @@
-作者:Codex|创建时间:2026-01-23 04:18
-
-# 变更概述
-为 CLI 增加可通过 npx/pnpx 直接执行的分发配置，更新包名与发布设置，并补充中文使用说明。
-
-# 变更清单
-- [x] package.json 发布与 bin 配置调整
-- [x] README 增加 npx/pnpx 使用说明
-- [x] 本地构建与验证
-
-# 关键设计对齐
-- bin 入口保持 ai-translate
-- npm 包名为 @thor123141245r/ai-translate
-- 发布为 public
-
-# 待确认事项状态
-- 采用哪个 npm 包名：@thor123141245r/ai-translate（已确认）
-- 是否允许发布到 npm：允许，public（已确认）

package/.agentdocs/code-changes/2026-01-23/sora-watermask-remover-/345/233/275/351/231/205/345/214/226/347/277/273/350/257/221-/345/256/236/347/216/260.md

@@ -1,37 +0,0 @@
-作者: Codex | 创建时间: 2026-01-23 21:35
-
-# sora-watermask-remover 国际化翻译实现
-
-## 变更概述
-- 使用脚本 `sentence_json_translator.py` 基于 `en.json` 翻译并覆盖目录内全部语言文件
-- 保持受保护关键词 `sora watermask remover` 原样
-- 保留专有名词与产品名：Sora、Sora2 Cloud、OpenAI Pro、HD、15s
-
-## 执行方式
-- 脚本位置：`/Users/thor/.codex/skills/i18n-copywriter/scripts/sentence_json_translator.py`
-- 目标目录：`/Users/thor/Github/sora2.cloud-main/src/i18n/pages/sora-watermask-remover`
-- 运行参数要点：
-  - `--overwrite` 全量覆盖
-  - `--protected-terms "sora watermask remover,Sora,Sora2 Cloud,OpenAI Pro,HD,15s"`
-  - 由于接口偶发 SSL 握手失败，启用 `CONTENT_LOCALIZE_INSECURE=1` 并提高重试次数
-
-## 涉及文件
-- `/Users/thor/Github/sora2.cloud-main/src/i18n/pages/sora-watermask-remover/ar.json`
-- `/Users/thor/Github/sora2.cloud-main/src/i18n/pages/sora-watermask-remover/de.json`
-- `/Users/thor/Github/sora2.cloud-main/src/i18n/pages/sora-watermask-remover/es.json`
-- `/Users/thor/Github/sora2.cloud-main/src/i18n/pages/sora-watermask-remover/fr.json`
-- `/Users/thor/Github/sora2.cloud-main/src/i18n/pages/sora-watermask-remover/he.json`
-- `/Users/thor/Github/sora2.cloud-main/src/i18n/pages/sora-watermask-remover/hi.json`
-- `/Users/thor/Github/sora2.cloud-main/src/i18n/pages/sora-watermask-remover/id.json`
-- `/Users/thor/Github/sora2.cloud-main/src/i18n/pages/sora-watermask-remover/ja.json`
-- `/Users/thor/Github/sora2.cloud-main/src/i18n/pages/sora-watermask-remover/km.json`
-- `/Users/thor/Github/sora2.cloud-main/src/i18n/pages/sora-watermask-remover/ru.json`
-- `/Users/thor/Github/sora2.cloud-main/src/i18n/pages/sora-watermask-remover/th.json`
-- `/Users/thor/Github/sora2.cloud-main/src/i18n/pages/sora-watermask-remover/zh.json`
-
-## 验证
-- JSON 解析检查通过
-- key 集合与 `en.json` 完全一致
-
-## 备注
-- 本次翻译为脚本输出结果，如需人工润色可在此基础上微调

package/.agentdocs/code-changes/2026-01-23//351/205/215/347/275/256/350/257/273/345/217/226-/347/216/257/345/242/203/345/217/230/351/207/217/344/274/230/345/205/210-/345/256/236/347/216/260.md

@@ -1,22 +0,0 @@
-作者:Codex|创建时间:2026-01-23 21:06
-
-# 实现说明
-- 新增运行时配置解析 让 apiKey 与 baseUrl 优先取环境变量
-- 调整模型工厂 避免空 apiKey 覆盖 SDK 默认环境变量读取
-- README 增补环境变量优先级与变量名说明
-
-# 变更清单
-- src/cli.ts
-  - 新增 baseUrl schema
-  - 新增 resolveRuntimeConfig 处理环境变量优先级
-- src/model.ts
-  - apiKey baseUrl 仅在有效值时注入
-  - openai deepseek 使用 configuration baseURL
-  - ollama 使用 baseUrl
-- README.md
-  - 增加环境变量优先级与变量列表
-
-# 自测要点
-- 设置环境变量后 即使配置文件不同仍以环境变量为准
-- 未设置环境变量时 使用配置文件
-- 不设置 apiKey 时 SDK 自动读取自身环境变量

package/.agentdocs/plans/2026-01-22/AI/347/277/273/350/257/221/345/231/250TS/345/256/236/347/216/260-/344/274/230/345/214/226/346/226/271/346/241/210.md

@@ -1,67 +0,0 @@
-作者:Codex|创建时间:2026-01-22 23:30
-
-# 背景
-当前项目只有 Python 脚本实现。需要参考 `ai-translate` 的源码，在本仓库实现一套 TypeScript 版本，保证功能对齐与可复用。
-
-# 目标
-- 基于官方库源码，实现等价的 TypeScript 模块与对外 API
-- 保持结构清晰可维护，避免超 500 行文件
-- 形成可执行的本地脚本与最小测试覆盖
-
-# 范围
-- 新增 TypeScript 实现与必要的运行脚本
-- 新增或更新配置与文档
-- 不改动数据库迁移文件
-
-# 方案概述
-以“标准化与生态复用”为优先策略：先安装并审阅 `ai-translate` 源码，梳理其导出接口与核心流程，再在本仓库实现等价模块与 CLI 或脚本入口，确保行为与输入输出一致。
-
-```mermaid
-flowchart TD
-  A[安装依赖] --> B[读取源码]
-  B --> C[整理接口]
-  C --> D[设计模块]
-  D --> E[实现功能]
-  E --> F[编写测试]
-  F --> G[更新文档]
-```
-
-# 关键设计
-- 模块分层：配置解析层、翻译执行层、文件读写层、日志层
-- 复用策略：最大限度遵循官方库结构与命名，避免自研偏离
-- 日志策略：开发环境整对象打印，生产环境精简敏感信息
-
-```mermaid
-flowchart LR
-  A[输入源文件] --> B[解析配置]
-  B --> C[调用翻译引擎]
-  C --> D[写入目标文件]
-  D --> E[输出结果]
-```
-
-# 实施步骤
-1. 安装 `ai-translate` 并定位源码入口
-2. 梳理导出 API 与关键执行流程
-3. 设计 TypeScript 目录结构与模块边界
-4. 实现核心功能并补齐类型定义
-5. 编写最小可用测试或验证脚本
-6. 补充中文说明文档与使用示例
-
-# 验收标准
-- 与官方库的核心功能等价，输入输出一致
-- 新增 ts 文件均小于 500 行
-- 可以通过脚本完成一次实际翻译流程
-- 中文文档完整可读
-
-# 需求清单
-- [ ] 安装并分析 `ai-translate` 源码
-- [ ] TypeScript 版本的核心翻译功能
-- [ ] CLI 或脚本入口
-- [ ] 配置与日志策略
-- [ ] 中文使用文档
-- [ ] 基础测试或验证脚本
-
-# 待确认事项
-- 是否要求完全对齐官方库的所有导出与命令参数 (需用户确认)
-- 是否需要发布为独立 npm 包 (需用户确认)
-- 是否要兼容现有 Python 脚本的输入格式 (需用户确认)

package/.agentdocs/plans/2026-01-23/CLI/345/210/206/345/217/221-npx/346/226/271/346/241/210.md

@@ -1,60 +0,0 @@
-作者:Codex|创建时间:2026-01-23 04:10
-
-# 背景
-当前仓库已具备 `ai-translate` CLI，但还未完成可通过 `npx/pnpx` 直接执行的分发形态。
-
-# 目标
-- 让用户通过 `npx` 或 `pnpx` 直接执行 `ai-translate` CLI
-- 保持单人团队可维护规模
-- 维持现有接口与配置逻辑
-
-# 范围
-- package.json 配置与发布相关设置
-- 文档更新
-- 不涉及迁移文件
-
-# 方案概述
-1) 规范包名与 bin 输出，使 `npx <包名>` 直接可用
-2) 调整发布配置，避免 private 阻断
-3) 在 README 增加 `npx/pnpx` 使用说明
-
-```mermaid
-flowchart TD
-  A[确认包名] --> B[配置 bin]
-  B --> C[取消私有设置]
-  C --> D[更新文档]
-  D --> E[本地验证]
-```
-
-# 关键设计
-- bin 入口保持 `ai-translate` 命令
-- `npx` 触发时使用包名执行（需 npm 包名可用）
-- `pnpx` 行为与 `npx` 一致
-
-```mermaid
-flowchart LR
-  A[用户执行 npx] --> B[下载包]
-  B --> C[执行 bin]
-  C --> D[调用 CLI]
-```
-
-# 实施步骤
-1. 确认 npm 包名与发布范围
-2. 调整 package.json: name、private、bin、exports
-3. README 添加 npx 与 pnpx 的示例
-4. 本地 build 与 npx 验证
-
-# 验收标准
-- `npx <包名>` 可直接执行
-- `pnpx <包名>` 可直接执行
-- README 有中文使用说明
-
-# 需求清单
-- [ ] 确认包名与是否发布
-- [ ] 完成 package.json 配置
-- [ ] README 更新
-- [ ] 本地验证
-
-# 待确认事项
-- 采用哪个 npm 包名 (需用户确认)
-- 是否允许发布到 npm（需用户确认）

package/.agentdocs/plans/2026-01-23/sora-watermask-remover-/345/233/275/351/231/205/345/214/226/347/277/273/350/257/221-/344/274/230/345/214/226/346/226/271/346/241/210.md

@@ -1,51 +0,0 @@
-作者: Codex | 创建时间: 2026-01-23 21:15
-
-# sora-watermask-remover 国际化翻译优化方案
-
-## 背景与目标
-当前目录 `/Users/thor/Github/sora2.cloud-main/src/i18n/pages/sora-watermask-remover` 下存在多语言 JSON。需要以 `en.json` 为单一事实来源，对所有语言文件进行完整本地化翻译与一致性校验，确保营销页面文案统一、可发布、且受保护关键词不被误译。
-
-## 范围
-- 仅处理该目录下 i18n JSON 文案内容
-- 不改动业务逻辑与组件
-- 不新增迁移文件
-
-## 受保护关键词策略
-- 从 `en.json` 与项目命名中抽取品牌与关键词
-- 受保护关键词在任何语言中保持英文原样
-
-## 方案概述
-1. 读取 `en.json`，确认 key 结构与文案目标
-2. 建立受保护关键词清单并确认
-3. 对比所有语言文件，补齐缺失 key 并对齐结构
-4. 逐语言翻译与本地化，避免硬翻译品牌与关键词
-5. 运行 key 一致性检查与占位符检查
-
-## 流程图
-```mermaid
-flowchart TD
-  A[读取英文文案] --> B[整理受保护关键词]
-  B --> C[对齐所有语言结构]
-  C --> D[逐语言本地化翻译]
-  D --> E[一致性与占位符检查]
-  E --> F[输出最终多语言文件]
-```
-
-## 影响评估
-- 仅修改 JSON 文案内容
-- 不涉及代码逻辑与运行时行为
-
-## 验证方案
-- 运行 `scripts/check_i18n_keys.py` 校验 key 一致性
-- 抽样核对受保护关键词与占位符
-
-## 需求清单
-- [ ] 完整翻译并本地化所有语言 JSON
-- [ ] 受保护关键词保持英文原样
-- [ ] 所有语言与 `en.json` key 完全一致
-- [ ] 输出可直接发布的营销文案
-
-## 待确认事项
-- 目标语言清单是否为目录内全部语言文件（ar de es fr he hi id ja km ru th zh）(需用户确认)
-- 受保护关键词清单与大小写规则（如 Sora 2 Sora2 Cloud OpenAI Pro HD 15s sora watermask remover）(需用户确认)
-- 文案语气与风格偏好（理性简洁或强转化促销）(需用户确认)

package/.agentdocs/plans/2026-01-23//351/205/215/347/275/256/350/257/273/345/217/226-/347/216/257/345/242/203/345/217/230/351/207/217/344/274/230/345/205/210-/344/274/230/345/214/226/346/226/271/346/241/210.md

@@ -1,80 +0,0 @@
-作者:Codex|创建时间:2026-01-23 21:06
-
-# 目标
-- 让 apiKey 与 baseUrl 优先从环境变量读取
-- 兼容已有配置文件与 CLI 写入配置
-- 明确并文档化配置优先级与环境变量名称
-
-# 方案概述
-- 新增统一的配置解析流程
-- 以 环境变量 为最高优先级 其次配置文件 最后默认值
-- 仅在有值时向模型构造函数注入 apiKey 与 baseUrl 避免空值覆盖
-
-```mermaid
-flowchart TD
-  A[启动命令] --> B[读取环境变量]
-  B --> C[读取配置文件]
-  C --> D[合并配置]
-  D --> E[构建模型]
-  E --> F[执行翻译]
-```
-
-# 配置优先级
-- 环境变量优先级高于配置文件
-- 配置文件高于代码默认值
-- 未设置的字段不写入模型参数
-
-```mermaid
-flowchart LR
-  A[环境变量有值] --> D[使用环境变量]
-  B[环境变量无值] --> C[读取配置]
-  C --> D
-  D --> E[合并默认值]
-```
-
-# 环境变量规划
-- 通用变量
-  - AI_TRANSLATE_API_KEY
-  - AI_TRANSLATE_BASE_URL
-- 兼容主流 SDK 变量
-  - OPENAI_API_KEY
-  - OPENAI_BASE_URL
-  - ANTHROPIC_API_KEY
-  - MISTRAL_API_KEY
-  - DEEPSEEK_API_KEY
-  - OLLAMA_BASE_URL
-
-```mermaid
-sequenceDiagram
-  participant CLI
-  participant 配置管理
-  participant 模型工厂
-  CLI->>配置管理: 读取环境变量
-  配置管理->>配置管理: 合并配置文件
-  配置管理->>模型工厂: 输出最终配置
-```
-
-# 影响范围
-- src/cli.ts
-  - 新增 baseUrl schema
-  - 引入配置解析函数
-- src/model.ts
-  - 去除空 apiKey 注入
-  - 按 provider 注入 baseUrl
-- README.md
-  - 增补环境变量说明与优先级
-
-# 实施步骤
-1. 新增配置解析函数并接入 CLI
-2. 调整模型工厂的 apiKey 与 baseUrl 注入策略
-3. 更新 README 使用说明与示例
-
-# 验收清单
-- [ ] 设置环境变量后 即使配置文件不同仍以环境变量生效
-- [ ] 未设置环境变量时 使用配置文件值
-- [ ] 未配置 apiKey 时不再覆盖 SDK 默认取值逻辑
-- [ ] README 清晰说明优先级与变量名称
-
-# 待确认事项
-- [ ] 是否接受新增 AI_TRANSLATE_API_KEY 与 AI_TRANSLATE_BASE_URL 作为通用环境变量 (需用户确认)
-- [ ] 是否需要同时支持 provider 专属 baseUrl 变量 如 DEEPSEEK_BASE_URL (需用户确认)