cc-translate 0.6.0 → 1.0.1

package/README.md

@@ -1,52 +1,106 @@
 # cc-translate
-一个基于Chat GPT的翻译库 🚀
 
-## 特征
-- 支持通过一种源语言翻译出多国语言
-- 默认使用gpt-4o模型进行翻译，你也可以设置.gpt-4o性价比更高
+An AI-powered i18n translation tool for JSON language files.
 
+## Features
 
-## 安装
+- Translate from one source language to multiple target languages.
+- Cache-based incremental translation (only changed keys are translated).
+- Concurrency queue with retry support for unstable API calls.
+- Real-time progress bars and final success/failure summary.
+- Cleaner logs for skipped files (`No content to translate` is aggregated).
+
+## Installation
 
 ```bash
+npm install cc-translate
+```
 
-# 使用 npm
-npm install cc-translate -D
+## Quick Start
 
-# 或者使用 yarn
-yarn add cc-translate -D
+```ts
+import path from "path";
+import { I18nTranslateAgent } from "cc-translate";
 
-```
+const root = process.cwd();
 
-## 快速开始
-
-```mjs
-// translate.mjs
-import {CwalletTranslate} from 'cc-translate';
-
-// 获取当前文件的完整路径
-const __dirname = import.meta.dirname;
-
-// 创建一个translate实例
-const client = new CwalletTranslate({
-  key: "your api key",
-  sourceLanguage: 'en',
-  // 缓存文件路径
-  cacheFileRootPath: path.resolve(__dirname, './cache'),
-  // 翻译源文件路径
-  fileRootPath: path.resolve(__dirname, './langs'),
-  // 调整翻译语境，告诉gpt我们的翻译要求。提高翻译准确性！
-  fineTune: ['我们是一个区块链钱包', '请使用行业专业术语并更切合生活的翻译',....],
-  // 需要翻译的语言列表
-  languages: [
-    'zh-CN',
-    'zh-TW',
-    'ja',
-    'ar',
-    ...
+const agent = new I18nTranslateAgent({
+  // Required: OpenAI client options
+  openaiClientConfig: {
+    apiKey: process.env.OPENAI_API_KEY!,
+    // baseURL: "https://api.openai.com/v1",
+  },
+
+  // Required
+  cacheFileRootPath: path.resolve(root, "./cache"),
+  fileRootPath: path.resolve(root, "./locales"),
+  languages: ["zh-CN", "ja", "ko"],
+
+  // Optional
+  sourceLanguage: "en",
+  outputRootPath: path.resolve(root, "./locales"),
+  concurrency: 8,
+  fineTune: [
+    "This is a crypto wallet product",
+    "Keep blockchain terms consistent",
   ],
-  // 输出文件路径
-  outputRootPath: path.resolve(__dirname, './langs'),
+  chatCompletionCreateParams: {
+    model: "gpt-4o",
+    temperature: 0.2,
+  },
 });
 
-```
+await agent.translate();
+```
+
+## Directory Layout
+
+```text
+your-project/
+├── locales/
+│   └── en/
+│       ├── common.json
+│       └── auth.json
+├── cache/
+│   ├── zh-CN/
+│   └── ja/
+└── scripts/translate.ts
+```
+
+## API
+
+### `I18nTranslateAgent`
+
+| Option | Type | Required | Description |
+| --- | --- | --- | --- |
+| `openaiClientConfig` | `ClientOptions` | Yes | OpenAI SDK client options (e.g. `apiKey`, `baseURL`) |
+| `cacheFileRootPath` | `string` | Yes | Cache root directory |
+| `fileRootPath` | `string` | Yes | Source locale root directory |
+| `languages` | `SupportLanguageType[]` | Yes | Target language codes |
+| `sourceLanguage` | `SupportLanguageType` | No | Source language, default `en` |
+| `outputRootPath` | `string` | No | Output directory, defaults to `fileRootPath` |
+| `concurrency` | `number` | No | Queue length, default `8` |
+| `fineTune` | `string[]` | No | Extra translation context lines |
+| `chatCompletionCreateParams` | `Partial<ChatCompletionCreateParams>` | No | Extra chat completion params |
+
+### Utility Exports
+
+```ts
+import {
+  generateCache,
+  deleteBatchCache,
+} from "cc-translate";
+```
+
+## Log Behavior
+
+During translation, skipped files with no diff/content are not printed one by one.
+They are aggregated into a single summary line to avoid noisy logs in large projects.
+
+## Changelog
+
+See `CHANGELOG.md`.
+
+## License
+
+ISC

package/index.d.ts

@@ -1,26 +1,37 @@
-import { OpenAI } from "openai";
-import { ICwalletTranslateParams, IJson, IOpenaiConfig, IOutputLanguageFile, ISingleTranslate, ITranslateChat, ITranslateChatResponse, SupportLanguageType } from "./types";
-export { testCompletions } from "./test/index.js";
+import { ClientOptions, OpenAI } from "openai";
+import { II18nTranslateAgentParams, IJson, IOutputLanguageFile, ISingleTranslate, ITranslateChat, ITranslateChatResponse, SupportLanguageType } from "./types";
+import { ChatCompletionCreateParams } from "openai/resources";
 export { generateCache, deleteBatchCache } from "./lib/cache/index.js";
-export declare class CwalletTranslate {
-    /** open ai api key  */
-    private OPENAI_KEY;
-    /** */
+export declare class I18nTranslateAgent {
+    /** 缓存文件根路径 */
     CACHE_ROOT_PATH: string;
+    /** 入口文件根路径 */
     ENTRY_ROOT_PATH: string;
+    /** 源语言 */
     /** default en */
     SOURCE_LANGUAGE: SupportLanguageType;
+    /** 输出文件根路径 */
     OUTPUT_ROOT_PATH: string | undefined;
+    /** 需要翻译的语言列表 */
     languages: SupportLanguageType[];
+    /** openai 客户端 */
     client: OpenAI | null;
-    /** default model gpt-4o */
-    openaiConfig: IOpenaiConfig;
+    /** 微调模型 */
     fineTune: string[];
-    baseURL: string;
-    constructor(params: ICwalletTranslateParams);
+    /** 翻译任务并发数（队列长度），完成一个即取下一个 */
+    concurrency: number;
+    /** openai 客户端配置 */
+    openaiClientConfig: ClientOptions;
+    /** openai 聊天完成创建参数 */
+    chatCompletionCreateParams: Partial<ChatCompletionCreateParams>;
+    constructor(params: II18nTranslateAgentParams);
+    /** 支持翻译的语言列表 */
     get supportLanguages(): import("./types").ILanguage[];
+    /** 输出文件根路径 */
     get outputPath(): string;
+    /** 搜索语言 */
     searchLanguage(code: SupportLanguageType): import("./types").ILanguage | undefined;
+    /** 创建openai客户端 */
     createOpenAIClient: () => void;
     /**
      * 翻译入口文件的所有支持的语言文件夹和其中的文件

package/index.js

@@ -12,38 +12,37 @@ import fs from "fs";
 import colors from "ansi-colors";
 import { OpenAI } from "openai";
 import cliProgress from "cli-progress";
-import { chunkArray, getRandomNumber, notExistsToCreateFile, readFileOfDirSync, readJsonFileSync, } from "./lib/utils.js";
+import { getRandomNumber, notExistsToCreateFile, readFileOfDirSync, readJsonFileSync, runWithConcurrencyLimit, } from "./lib/utils.js";
 import { getCacheFileSync, registerLanguageCacheFile, translateJSONDiffToJson, } from "./lib/cache/index.js";
 import { logErrorToFile } from "./lib/log/index.js";
 import { SUPPORT_LANGUAGE_MAP } from "./lib/support.js";
-export { testCompletions } from "./test/index.js";
 export { generateCache, deleteBatchCache } from "./lib/cache/index.js";
-const DEFAULT_OPENAI_CONFIG = {
+const DEFAULT_CHAT_COMPLETION_CREATE_PARAMS = {
     model: "gpt-4o",
 };
-export class CwalletTranslate {
+export class I18nTranslateAgent {
     constructor(params) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e, _f;
+        /** openai 客户端 */
         this.client = null;
+        /** 创建openai客户端 */
         this.createOpenAIClient = () => {
             /** 初始化openAi */
-            const client = new OpenAI({
-                apiKey: this.OPENAI_KEY,
-                baseURL: this.baseURL,
-            });
+            const client = new OpenAI(this.openaiClientConfig);
             this.client = client;
         };
         /**
          * 翻译入口文件的所有支持的语言文件夹和其中的文件
          */
         this.translate = () => __awaiter(this, void 0, void 0, function* () {
-            console.log("🚀 开始翻译");
-            console.log(`🚀 使用的模型: ${this.openaiConfig.model} 🚀`);
-            console.log(`🚀 微调: ${this.fineTune} 🚀`);
+            console.log("🚀 Start translation");
+            console.log(`🚀 Using model: ${this.chatCompletionCreateParams.model} 🚀`);
+            console.log(`🚀 Fine-tuning: ${this.fineTune.join(",")} 🚀`);
+            console.log(`🚀 Concurrency queue length: ${this.concurrency} 🚀`);
             const translateFolderPath = path.join(this.ENTRY_ROOT_PATH, this.SOURCE_LANGUAGE);
             // 翻译源语言问价夹下的所有json文件
             const translateFolders = yield readFileOfDirSync(translateFolderPath);
-            console.log("🚀 ~ 需要翻译语言的文件:", translateFolders);
+            console.log("🚀 ~ files to translate:", translateFolders, translateFolderPath);
             // 创建进度条
             const multiBar = new cliProgress.MultiBar({
                 clearOnComplete: false,
@@ -51,8 +50,8 @@ export class CwalletTranslate {
                 format: colors.cyan("{bar}") +
                     "| {percentage}% || {filename} {value}/{total} ",
             }, cliProgress.Presets.legacy);
-            let promises = [];
-            const arr = [];
+            const taskList = [];
+            const skippedNoContent = [];
             for (const item of this.supportLanguages) {
                 // 源语言不翻译
                 if (item.code === this.SOURCE_LANGUAGE)
@@ -60,10 +59,10 @@ export class CwalletTranslate {
                 for (const fileName of translateFolders) {
                     const translateJson = yield this.getTranslateContent(item.code, fileName);
                     if (!translateJson) {
-                        console.log(`${item.code}:${fileName} 没有需要翻译的内容`);
+                        skippedNoContent.push(`${item.code}:${fileName}`);
                         continue;
                     }
-                    arr.push(() => this.singleTranslate({
+                    taskList.push(() => this.singleTranslate({
                         language: item.code,
                         fileName,
                         multiBar,
@@ -71,12 +70,21 @@ export class CwalletTranslate {
                     }));
                 }
             }
-            promises = chunkArray(arr, 8);
-            for (const chunk of promises) {
-                yield Promise.all(chunk.map((fn) => fn()));
+            if (skippedNoContent.length > 0) {
+                const summary = skippedNoContent.length <= 5
+                    ? skippedNoContent.join(", ")
+                    : `${skippedNoContent.slice(0, 3).join(", ")} ... +${skippedNoContent.length - 3} more`;
+                console.log(`${colors.dim("Skipped (no content to translate):")} ${skippedNoContent.length} items${skippedNoContent.length <= 5 ? ` (${summary})` : ` — e.g. ${summary}`}`);
             }
+            // 并发队列：同时最多 concurrency 个任务，完成一个即从队列取下一个，避免长任务拖慢整批
+            const results = yield runWithConcurrencyLimit(taskList, this.concurrency);
             multiBar.stop();
-            console.log("🚀 翻译完毕");
+            const errorLength = results.filter((item) => item.status === "rejected").length;
+            if (errorLength > 0) {
+                console.log(`${colors.red("Translation failed")}: ${errorLength} tasks`);
+            }
+            console.log(`${colors.green("Translation completed")}: ${results.length} tasks`);
+            console.log(`${colors.green("Translation successful")}: ${results.length - errorLength} tasks`);
         });
         /**
          * 翻译单个文件
@@ -142,34 +150,31 @@ export class CwalletTranslate {
                     const targetLanguage = this.searchLanguage(language);
                     const originLanguage = this.searchLanguage(this.SOURCE_LANGUAGE);
                     if (!targetLanguage) {
-                        throw new Error(`不支持的语言：${language}`);
+                        throw new Error(`Unsupported language:${language}`);
                     }
                     if (!originLanguage) {
-                        throw new Error(`不支持的语言：${this.SOURCE_LANGUAGE}`);
+                        throw new Error(`Unsupported language:${this.SOURCE_LANGUAGE}`);
                     }
                     setTimeout(() => __awaiter(this, void 0, void 0, function* () {
                         var _a, _b, _c;
-                        const chatCompletion = yield this.client.chat.completions.create({
-                            model: (_a = this.openaiConfig) === null || _a === void 0 ? void 0 : _a.model,
-                            messages: [
+                        const chatCompletion = yield this.client.chat.completions.create(Object.assign(Object.assign({ model: (_a = this.chatCompletionCreateParams.model) !== null && _a !== void 0 ? _a : "gpt-4o" }, this.chatCompletionCreateParams), { stream: false, messages: [
                                 ...this.fineTune.map((val) => ({
                                     role: "system",
                                     content: val,
                                 })),
                                 {
                                     role: "system",
-                                    content: `请将${originLanguage.name}翻译成${targetLanguage.name}`,
+                                    content: `Please translate ${originLanguage.name} to ${targetLanguage.name}`,
                                 },
                                 {
                                     role: "system",
-                                    content: `翻译完成直接输出后对应意思的内容不要携带任何无关内容`,
+                                    content: `After translation is complete, directly output the corresponding meaning without any irrelevant content`,
                                 },
                                 {
                                     role: "user",
                                     content: value,
                                 },
-                            ],
-                        });
+                            ] }));
                         resolve({
                             key,
                             value: (_c = (_b = chatCompletion === null || chatCompletion === void 0 ? void 0 : chatCompletion.choices[0]) === null || _b === void 0 ? void 0 : _b.message.content) !== null && _c !== void 0 ? _c : value,
@@ -248,26 +253,40 @@ export class CwalletTranslate {
                 folderName: this.CACHE_ROOT_PATH,
             });
         });
-        this.OPENAI_KEY = params.key;
+        /** openai 客户端配置 */
+        this.openaiClientConfig = (_a = params.openaiClientConfig) !== null && _a !== void 0 ? _a : {};
+        /** openai 聊天完成创建参数 */
+        this.chatCompletionCreateParams =
+            (_b = params.chatCompletionCreateParams) !== null && _b !== void 0 ? _b : DEFAULT_CHAT_COMPLETION_CREATE_PARAMS;
+        /** 缓存文件根路径 */
         this.CACHE_ROOT_PATH = params.cacheFileRootPath;
+        /** 入口文件根路径 */
         this.ENTRY_ROOT_PATH = params.fileRootPath;
-        this.openaiConfig = (_a = params.openaiConfig) !== null && _a !== void 0 ? _a : DEFAULT_OPENAI_CONFIG;
-        this.SOURCE_LANGUAGE = (_b = params.sourceLanguage) !== null && _b !== void 0 ? _b : "en";
+        /** 源语言 */
+        this.SOURCE_LANGUAGE = (_c = params.sourceLanguage) !== null && _c !== void 0 ? _c : "en";
+        /** 输出文件根路径 */
         this.OUTPUT_ROOT_PATH = params.outputRootPath;
-        this.fineTune = params.fineTune;
-        this.languages = (_c = params.languages) !== null && _c !== void 0 ? _c : [];
-        this.baseURL = (_d = params.baseURL) !== null && _d !== void 0 ? _d : "";
+        /** 微调模型 */
+        this.fineTune = (_d = params.fineTune) !== null && _d !== void 0 ? _d : [];
+        /** 需要翻译的语言列表 */
+        this.languages = (_e = params.languages) !== null && _e !== void 0 ? _e : [];
+        /** 翻译任务并发数（队列长度），完成一个即取下一个 */
+        this.concurrency = (_f = params.concurrency) !== null && _f !== void 0 ? _f : 8;
+        /** 创建openai客户端 */
         this.createOpenAIClient();
     }
+    /** 支持翻译的语言列表 */
     get supportLanguages() {
         return Object.entries(SUPPORT_LANGUAGE_MAP)
             .map(([key, val]) => val)
             .filter(({ code }) => this.languages.includes(code) || code === this.SOURCE_LANGUAGE);
     }
+    /** 输出文件根路径 */
     get outputPath() {
         var _a;
         return (_a = this.OUTPUT_ROOT_PATH) !== null && _a !== void 0 ? _a : this.ENTRY_ROOT_PATH;
     }
+    /** 搜索语言 */
     searchLanguage(code) {
         return this.supportLanguages.find((item) => item.code === code);
     }

package/lib/utils.d.ts

@@ -23,4 +23,23 @@ export declare const isDirectoryPath: (path: string) => boolean;
 export declare const readFileOfDirSync: (dirPath: string) => string[];
 export declare function chunkArray<T extends object>(array: T[], chunkSize: number): T[][];
 export declare function intersection<T>(arr1: T[], arr2: T[]): T[];
+export type TaskResult<T> = {
+    status: "fulfilled";
+    value: T;
+} | {
+    status: "rejected";
+    reason: any;
+};
+/**
+ * 并发限制队列：同时最多运行 concurrency 个任务，任一任务完成后立即从队列取下一个执行，最大化利用并发槽位。
+ * @param tasks 返回 Promise 的函数数组（不立即执行，由队列按需执行）
+ * @param concurrency 并发数（队列长度）
+ */
+export declare function runWithConcurrencyLimit<T>(
+/** 返回 Promise 的函数数组（不立即执行，由队列按需执行） */
+tasks: (() => Promise<T>)[], 
+/** 并发数（队列长度） */
+concurrency: number, 
+/** 默认最大重试次数 */
+maxRetries?: number): Promise<TaskResult<T>[]>;
 //# sourceMappingURL=utils.d.ts.map

package/lib/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/lib/utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,SAAU,MAAM,SAGjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,SAAgB,MAAM,iBAUlD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,WAAY,qBAAqB,SAS3D,CAAC;AAEF,eAAO,MAAM,eAAe,QAAS,MAAM,OAAO,MAAM,WAEvD,CAAC;AAEF,eAAO,MAAM,eAAe,SAAU,MAAM,YAG3C,CAAC;AAEF,eAAO,MAAM,iBAAiB,YAAa,MAAM,aAKhD,CAAC;AAEF,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,SASzE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAczD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/lib/utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,SAAU,MAAM,SAGjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,SAAgB,MAAM,iBAUlD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,WAAY,qBAAqB,SAS3D,CAAC;AAEF,eAAO,MAAM,eAAe,QAAS,MAAM,OAAO,MAAM,WAEvD,CAAC;AAEF,eAAO,MAAM,eAAe,SAAU,MAAM,YAG3C,CAAC;AAEF,eAAO,MAAM,iBAAiB,YAAa,MAAM,aAKhD,CAAC;AAEF,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,SASzE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAczD;AAGD,MAAM,MAAM,UAAU,CAAC,CAAC,IACpB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACjC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,CAAC;AAExC;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,CAAC;AAC7C,sCAAsC;AACtC,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;AAC3B,gBAAgB;AAChB,WAAW,EAAE,MAAM;AACnB,eAAe;AACf,UAAU,GAAE,MAAU,GACrB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAgD1B"}

package/lib/utils.js

@@ -86,3 +86,61 @@ export function intersection(arr1, arr2) {
     }
     return [...intersectionSet];
 }
+/**
+ * 并发限制队列：同时最多运行 concurrency 个任务，任一任务完成后立即从队列取下一个执行，最大化利用并发槽位。
+ * @param tasks 返回 Promise 的函数数组（不立即执行，由队列按需执行）
+ * @param concurrency 并发数（队列长度）
+ */
+export function runWithConcurrencyLimit(tasks_1, concurrency_1) {
+    return __awaiter(this, arguments, void 0, function* (
+    /** 返回 Promise 的函数数组（不立即执行，由队列按需执行） */
+    tasks, 
+    /** 并发数（队列长度） */
+    concurrency, 
+    /** 默认最大重试次数 */
+    maxRetries = 3) {
+        if (tasks.length === 0)
+            return [];
+        // 新增：用于按顺序保存所有任务的结果
+        const results = new Array(tasks.length);
+        let index = 0;
+        function worker() {
+            return __awaiter(this, void 0, void 0, function* () {
+                while (true) {
+                    const currentIndex = index++;
+                    if (currentIndex >= tasks.length)
+                        return;
+                    let attempt = 0;
+                    let isSuccess = false;
+                    // 新增：容错与重试循环
+                    while (attempt < maxRetries && !isSuccess) {
+                        try {
+                            const result = yield tasks[currentIndex]();
+                            // 成功则记录结果，并跳出重试循环
+                            results[currentIndex] = { status: "fulfilled", value: result };
+                            isSuccess = true;
+                        }
+                        catch (error) {
+                            attempt++;
+                            console.warn(`[Task ${currentIndex}] 失败 (${attempt}/${maxRetries}):`, error);
+                            if (attempt >= maxRetries) {
+                                // 达到最大重试次数，依然失败，记录错误，让 worker 能够继续接手下一个任务
+                                results[currentIndex] = { status: "rejected", reason: error };
+                            }
+                            else {
+                                // 选做：在重试前稍微等一下（退避策略），避免被 API 连续限流拦截
+                                // 每次重试等待时间递增：1秒, 2秒...
+                                yield new Promise((resolve) => setTimeout(resolve, 1000 * attempt));
+                            }
+                        }
+                    }
+                }
+            });
+        }
+        const workerCount = Math.min(concurrency, tasks.length);
+        // 等待所有 worker 把活干完（由于内部有 try-catch，这里绝对不会被 reject）
+        yield Promise.all(Array.from({ length: workerCount }, () => worker()));
+        // 统一返回完整的结果数组，且顺序与传入的 tasks 完美对应
+        return results;
+    });
+}

package/package.json

@@ -1,47 +1,65 @@
 {
   "name": "cc-translate",
-  "version": "0.6.0",
+  "version": "1.0.1",
   "description": "A language translation tool based on OpenAI",
   "author": "maybe",
+  "license": "ISC",
+  "type": "module",
   "packageManager": "yarn@1.22.22",
+  "main": "./index.js",
+  "module": "./index.js",
   "types": "./index.d.ts",
-  "main": "./index.mjs",
-  "module": "./index.mjs",
-  "publishConfig": {
-    "access": "public"
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "require": "./index.js",
+      "default": "./index.js"
+    }
   },
-  "keywords": [
-    "translate",
-    "openai"
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "lib",
+    "types"
   ],
-  "license": "ISC",
+  "scripts": {
+    "compile": "tsc",
+    "prepublishOnly": "npm run compile",
+    "release": "npm run compile && npm publish"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/cctip/cwallet-translate-script.git"
   },
-  "homepage": "https://github.com/cctip/cwallet-translate-script",
-  "bugs": "https://github.com/xxx/cwallet-translate-script/issues",
-  "type": "module",
-  "scripts": {
-    "publish": "npx tsc && npm publish",
-    "compile": "tsc"
+  "homepage": "https://github.com/cctip/cwallet-translate-script#readme",
+  "bugs": {
+    "url": "https://github.com/cctip/cwallet-translate-script/issues"
   },
-  "exports": {
-    ".": {
-      "import": "./index.js",
-      "require": "./index.js"
-    }
+  "keywords": [
+    "translate",
+    "openai",
+    "i18n",
+    "translation",
+    "cli"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
   },
   "dependencies": {
-    "@google/genai": "^1.15.0",
+    "@google/genai": "^1.43.0",
     "ansi-colors": "^4.1.3",
     "cli-progress": "^3.12.0",
-    "openai": "^4.68.1",
-    "ts-node": "^10.9.2"
+    "openai": "^6.25.0"
   },
   "devDependencies": {
     "@types/cli-progress": "^3.11.6",
     "@types/node": "^22.7.9",
+    "ts-node": "^10.9.2",
     "typescript": "^5.6.3"
   }
 }

package/types/index.d.ts

@@ -1,5 +1,6 @@
 import { MultiBar } from "cli-progress";
-import OpenAI from "openai";
+import { ClientOptions } from "openai";
+import { ChatCompletionCreateParams } from "openai/resources";
 export interface ILanguage {
     /** 语言code */
     code: SupportLanguageType;
@@ -58,27 +59,29 @@ export interface ITranslateChatResponse {
     index: number;
     error?: Error;
 }
-export interface ICwalletTranslateParams {
-    key: string;
+export interface II18nTranslateAgentParams {
+    /** openai 客户端配置 */
+    openaiClientConfig: ClientOptions;
+    /** openai 聊天完成创建参数 */
+    chatCompletionCreateParams?: Partial<ChatCompletionCreateParams>;
+    /** 缓存文件根路径 */
     cacheFileRootPath: string;
-    /** await translate file root path */
+    /** 入口文件根路径 */
     fileRootPath: string;
-    fineTune: string[];
+    /** 源语言 */
+    /** default en */
+    sourceLanguage?: SupportLanguageType;
+    /** 需要翻译的语言列表 */
     languages: SupportLanguageType[];
+    /** 输出文件根路径 */
     outputRootPath?: string;
-    sourceLanguage?: SupportLanguageType;
-    openaiConfig?: IOpenaiConfig;
-    baseURL?: string;
+    /** 翻译任务并发数（队列长度），完成一个即取下一个 */
+    concurrency?: number;
+    /** 微调模型 */
+    fineTune?: string[];
 }
 export interface ITranslate {
 }
-export interface IOpenaiConfig {
-    model: OpenAI.Chat.ChatModel;
-}
-export interface ITestParams {
-    key: string;
-    question: string;
-}
 export interface IGenerateCacheParams {
     sourceFolderPath: string;
     sourceLanguage: SupportLanguageType;

package/types/index.d.ts.map

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

package/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EACL,uBAAuB,EACvB,KAAK,EACL,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAgBjB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAMvE,qBAAa,gBAAgB;IAC3B,uBAAuB;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,MAAM;IACN,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB;IACjB,eAAe,EAAE,mBAAmB,CAAC;IACrC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC7B,2BAA2B;IAC3B,YAAY,EAAE,aAAa,CAAC;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;gBAEJ,MAAM,EAAE,uBAAuB;IAa3C,IAAI,gBAAgB,kCAOnB;IAED,IAAI,UAAU,WAEb;IAED,cAAc,CAAC,IAAI,EAAE,mBAAmB;IAIxC,kBAAkB,aAQhB;IACF;;OAEG;IACH,SAAS,sBA0DP;IACF;;;;OAIG;IACH,eAAe,WAAkB,gBAAgB,mBAoD/C;IAEF;;;;;;;OAOG;IACH,aAAa,WAAY,cAAc,KAAG,OAAO,CAAC,sBAAsB,CAAC,CA2DvE;IACF;;;;;OAKG;IACH,mBAAmB,aACP,mBAAmB,YACnB,MAAM,KACf,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CA6B3B;IAEF;;;OAGG;IACH,kBAAkB,WAAkB,mBAAmB,mBAsCrD;CACH"}

package/src/fine-tuning/test.jsonl

@@ -1 +0,0 @@
-{"messages": [{"role": "system", "content": "你是一个翻译机器人"}, {"role": "user", "content": "将Reversal翻译成中文"}, {"role": "assistant", "content": "撤销"}]}