@thor123141245r/ai-translate 0.0.0 → 1.0.0

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 (需用户确认)

package/SKILL.md

@@ -1,103 +0,0 @@
----
-name: i18n-copywriter
-description: 为 i18n JSON（以 en.json 为准）生成与优化高转化率营销文案，并同步到多语言文件（如 de.json、fr.json）。仅在用户明确要求“优化/生成国际化文案、翻译 i18n JSON、为 landing page 写多语言文案”时使用；其余代码与通用翻译请求不要使用。
----
-
-# I18n Copywriter
-
-## Overview
-
-你是一名 landing page 资深国际化文案写手：先基于目标关键词做轻量网络调研，提炼用户需求与痛点，再以 `en.json` 为“单一事实来源”写出高转化英文文案，并将相同 key 结构同步到其他语言 JSON（如 `de.json`），保证占位符与“受保护关键词”不被硬翻译。
-
-使用这个 skill 时候不需要进入先写文档再写代码的流程，直接开始脚本翻译流程
-
-## 使用边界（非常重要）
-
-- 只处理“国际化文案”本身：`*.json` 文案内容（尤其是 `en.json` 及其同结构的多语言文件）。
-- 不做：业务逻辑改动、组件重构、通用逐字翻译、与 i18n 无关的改文案。
-- 不确定是否属于 i18n 文案任务时：先反问用户要改的 `en.json` 路径、目标页面与目标语言列表。
-
-## 你需要向用户确认的信息（缺一会显著降质量）
-
-- `en.json` 的真实路径（以及其他语言 JSON 所在目录）。
-- 本次要优化的页面或模块（例如 pricing、homepage hero、generator 区域）。
-- 目标关键词（可多个）：哪些词必须保留为英文不翻译（例如 `sora 2 video`）。
-- 目标语言：例如 `de, fr, ja, zh`。
-- 语气与品牌约束：更偏“极简理性”还是“强促销转化”。
-
-## 工作流（按顺序执行）
-
-### 1）锁定范围与“受保护关键词”
-
-- 从 `en.json` 中提取：品牌名、产品名、核心功能名、套餐名、以及用户指定的 SEO 关键词。
-- 建立“受保护关键词清单”：这些词在任何语言文件中都必须保持原样（不硬翻译、不改大小写）。
-- 典型例子：`Sora 2`、`Sora2 Cloud`、`sora 2 video`、`HD`、`Starter`、`Pro`、`Checkout`（以项目实际为准）。
-
-需要参考时：打开 `references/protected-terms.md`，按模板补齐。
-
-### 2）轻量网络调研（为“高转化文案”服务）
-
-- 用目标关键词做 3～6 次搜索，重点收集：用户常见需求、痛点、反对理由、对比方案（竞品/替代品）。
-- 输出为“洞察清单”：每条洞察对应 1 个文案策略（例如降低学习成本、强调速度、强调质量、强调可控性）。
-- 目标不是写报告，而是为文案提供“可用弹药”。
-
-### 3）先写好 `en.json`（单一事实来源）
-
-- 只改 value，不改 key，不引入新结构（除非用户明确新增文案点并同意加 key）。
-- 保留所有变量与占位符：例如 `{count}`、`{credits}`、`{{name}}`、`%s`（以文件实际为准）。
-- 保留受保护关键词：例如不要把 `sora 2 video` 翻译成任何语言。
-- Landing page 文案优先：短句、动词开头、清晰利益点、避免“空泛 AI 口号”。
-
-### 4）复制 `en.json` 到其他语言文件并做本地化改写
-
-- 每个语言文件应与 `en.json` 保持完全相同的 key 集合。
-- 先用 `en.json` 结构覆盖（缺失 key 补齐），再逐条替换为目标语言文案。
-- 禁止“硬翻译品牌/产品/关键词”：受保护关键词保持英文原样。
-
-### 5）一致性与质量检查（必做）
-
-- 运行 `scripts/check_i18n_keys.py` 确保各语言文件 key 集合一致。
-- 检查占位符是否被破坏（特别是 `{}`、`{{}}`、`%`、换行符）。
-- 检查“受保护关键词”是否被误翻译或改写。
-- 统一标点与引号风格（同一语言内一致）。
-
-## 常见硬性规则（避免踩坑）
-
-- 任何语言都不要翻译项目指定关键词。
-- 不要把 “产品名 + 功能名” 翻成“产品名 + 本地语言词”这种半截混搭（除非品牌策略要求）。
-- 如果英文里刻意使用了 SEO 关键词（例如 `sora 2 video`），其他语言也优先保留该关键词，并围绕它调整句子结构。
-
-## 资源
-
-- `scripts/check_i18n_keys.py`：检查各语言 JSON 是否与 `en.json` key 集合一致。
-- `scripts/sentence_json_translator.py`：逐句翻译 JSON 文案并回填结果，适合大段文案与输出可控场景。
-  - 常用参数：
-    - `--concurrency`：并发线程数，默认 6，可用 `CONTENT_LOCALIZE_CONCURRENCY` 覆盖。
-    - `--overwrite`：全量覆盖翻译，默认关闭（仅翻译缺失或等同英文的条目）。
-    - `--limit`：限制翻译条数，便于小范围验证。
-    - `--cache-file`：指定缓存文件路径，复用重复句子的翻译结果。
-    - `--protected-terms`：逗号分隔的受保护词列表，会写入系统提示。
-    - `--log-every`：进度输出步长，默认 20。
-- `references/protected-terms.md`：受保护关键词清单模板与维护规则。
-
-## 最小执行示例（给未来的你）
-
-用户请求：
-- “帮我优化 landing page 的 i18n 文案，`src/i18n/pages/pricing/en.json` 为准，同步到 `de/fr/ja`，关键词 `sora 2 video` 不要翻译。”
-
-你应输出：
-- 先给出 6～12 条“调研洞察 → 文案策略”的要点。
-- 完整更新 `en.json` 文案。
-- 复制并更新 `de.json / fr.json / ja.json`（同 key 结构）。
-- 跑一次 key 检查脚本并修复缺失 key。
-
-脚本示例（小范围验证）：
-```bash
-python3 /Users/thor/.codex/skills/i18n-copywriter/scripts/sentence_json_translator.py \\
-  src/i18n/pages/landing \\
-  --locales de,fr,ja \\
-  --concurrency 6 \\
-  --limit 20 \\
-  --cache-file .i18n-translation-cache.json \\
-  --protected-terms "Sora 2,Sora2 Cloud,sora 2 video"
-```

package/src/asyncTransform.ts

@@ -1,31 +0,0 @@
-import { Transform } from 'node:stream'
-
-export class AsyncTransform extends Transform {
-  static toString(chunk: Buffer | object, encoding: BufferEncoding | 'buffer') {
-    const enc = encoding !== 'buffer' ? encoding : undefined
-    return Buffer.isBuffer(chunk) ? chunk.toString(enc) : String(chunk)
-  }
-
-  _transform(
-    chunk: Buffer | object,
-    enc: BufferEncoding | 'buffer',
-    cb: (error?: Error | null) => void
-  ) {
-    this._asyncTransform(chunk, enc)
-      .then((wait) => {
-        if (wait) {
-          this.once('drain', () => cb())
-        } else {
-          cb()
-        }
-      })
-      .catch((err) => this.emit('error', err))
-  }
-
-  protected async _asyncTransform(
-    _chunk: Buffer | object,
-    _enc: BufferEncoding | 'buffer'
-  ): Promise<boolean | undefined> {
-    throw new Error('needs implementation')
-  }
-}

package/src/bin/ai-translate.ts

@@ -1,5 +0,0 @@
-#!/usr/bin/env node
-
-import { cli } from '../cli.js'
-
-await cli()