gpt-po
Version:
command tool for translate po files by gpt
103 lines (77 loc) • 4.32 kB
Markdown
# PO文件CHATGPT翻译工具
[](https://npmjs.org/package/gpt-po)
[](https://npmjs.org/package/gpt-po)
gettext(po)文件翻译工具，支持自定义系统提示词和用户字典，支持翻译指定的po文件到指定的目标语言，支持根据pot文件更新po文件。
使用其他语言阅读：[English](./README.md) | 简体中文
<a href="https://buymeacoffee.com/ryanhex" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/default-red.png" alt="请我喝杯咖啡" height="41" width="174"></a>
## 安装
```
npm install gpt-po
```
使用此工具前先设置 `OPENAI_API_KEY`，Windows中使用 `set OPENAI_API_KEY=<key>`, Linux中 `export OPENAI_API_KEY=<key>`
**建议使用付费的OpenAI API以提高翻译速度，免费的OpenAI API速度较慢（一分钟3条一天200条），且有使用限制。**
*国内用户要设置`HTTPS_PROXY`环境变量上梯子才能用*
### 环境变量
- `OPENAI_API_KEY`: OpenAI API密钥。
- `OPENAI_API_HOST`: OpenAI API主机（默认：https://api.openai.com）。
- `OPENAI_MODEL_TMP`: OpenAI模型温度（默认：0.1）。
## 常见用法
- `gpt-po sync --po <file> --pot <file>` 根据 pot 文件更新 po 文件，同时保留原有翻译。
- `gpt-po --po <file>` 将指定的 po 文件翻译成目标语言。
- `gpt-po --po <file> --lang <lang>` 将指定的 po 文件翻译成目标语言（覆盖 po 文件中指定的语言）。
- `gpt-po --dir .` 将当前目录下的所有 po 文件翻译成目标语言。
- `gpt-po userdict` 修改或查看用户词典。
- `gpt-po userdict --explore` 浏览用户词典，如果您想添加新词典或修改现有词典，词典可以命名为 `dictionary-<lang>.json`，例如 `dictionary-zh.json` 是简体中文词典。
```
用法: gpt-po [options] [command]
通过 gpt 翻译 po 文件的命令工具
选项:
-V, --version 输出版本号
-h, --help 显示命令帮助
命令:
translate [options] 翻译 po 文件（默认命令）
sync [options] 根据 pot 文件更新 po 文件
userdict [options] 打开/编辑用户词典
remove [options] 通过选项删除 po 条目
help [command] 显示命令帮助
```
```
用法: gpt-po [options]
翻译 po 文件（默认命令）
选项:
-k, --key <key> openai api key (环境变量: OPENAI_API_KEY)
--host <host> openai api host (环境变量: OPENAI_API_HOST)
--model <model> openai 模型 (默认: "gpt-4o-mini", 环境变量: OPENAI_MODEL)
--po <file> po 文件路径
--dir <dir> po 文件目录
-src, --source <lang> 源语言 (默认: "english")
--verbose 显示详细日志
-l, --lang <lang> 目标语言 (ISO 639-1 代码)
-o, --output <file> 输出文件路径，默认覆盖 po 文件
--context <file> 上下文文件路径（为机器人提供额外的上下文）
--context-length <length> 每次 API 请求中源字符串（msgid）的最大累计长度（默认：2000，环境变量：API_CONTEXT_LENGTH）
--timeout <ms> API 请求超时时间（单位：毫秒，默认：20000，环境变量：API_TIMEOUT）
-h, --help 显示命令帮助
```
```
用法: gpt-po remove [options]
通过选项删除 po 条目
选项:
--po <file> po 文件路径
--fuzzy 删除模糊条目
-obs, --obsolete 删除过时条目
-ut, --untranslated 删除未翻译条目
-t, --translated 删除已翻译条目
-tnf, --translated-not-fuzzy 删除已翻译但不是模糊的条目
-ft, --fuzzy-translated 删除模糊翻译条目
-rc, --reference-contains <text> 删除引用包含文本的条目，文本可以是正则表达式，例如 /text/ig
-h, --help 显示命令帮助
```
```
用法: gpt-po sync [options]
从 pot 文件中更新条目到 po 文件
Options:
--po <file> po 文件路径
--pot <file> pot 文件路径
-h, --help 显示命令帮助
```