本地网关与命令行
通过本地 API 和 CLI 自动化翻译工作流
仅监听本机 127.0.0.1:11899 的本地 HTTP 回环网关与原生命令行工具，让 Raycast、Alfred、Cursor 与 Python 脚本无缝调用你的个性化记忆翻译引擎。
本地回环网关架构（Loopback Only）
在 iTrans 设置中启用本地网关后，系统将在本地回环地址 127.0.0.1:11899 启动轻量级 HTTP REST 服务。该端口严格限制仅本机访问，绝不对局域网或外部互联网开放，保障绝对的数据安全性。
| 请求方式 | 端点路径 | 功能描述 |
|---|---|---|
| POST | /v1/translate |
调用指定引擎执行文本翻译，自动应用个人术语记忆 |
| GET | /v1/memory |
以标准 JSON 格式导出本地个人翻译记忆库 |
| GET | /v1/knowledge-base |
查看当前已加载的行业专有知识库分类与词条 |
| POST | /v1/knowledge-base/import |
批量导入自定义 JSON 或 CSV 行业专业术语库 |
| GET | /v1/stats |
读取本地翻译调用频次、耗时与 Token 统计 |
| GET | /v1/version |
查询当前 iTrans 运行版本与构建编号 |
调用范例：cURL 与 Python 脚本
通过命令行 cURL 快速发起翻译：
curl -X POST http://127.0.0.1:11899/v1/translate \
-H "Content-Type: application/json" \
-d '{
"text": "Evaluating zero-shot transfer capabilities.",
"source_lang": "en",
"target_lang": "zh-CN",
"engine": "deepseek"
}'
在 Python 脚本中调用（零外部第三方库依赖）：
import urllib.request, json
payload = json.dumps({
"text": "prompt caching reduces inference latency.",
"source_lang": "en",
"target_lang": "zh-CN",
"engine": "deepseek"
}).encode('utf-8')
req = urllib.request.Request(
"http://127.0.0.1:11899/v1/translate",
data=payload,
headers={"Content-Type": "application/json"}
)
with urllib.request.urlopen(req) as resp:
data = json.loads(resp.read().decode())
print(data.get("translated_text"))
原生 CLI 终端命令行交互
开发者还可在 zsh 或 bash 终端中直接运行二进制文件实现命令行划词与快捷查询：
# 执行直接文本翻译
/Applications/iTrans.app/Contents/MacOS/cduyzhTranslator --translate "Hello world" --engine deepseek
# 导出本地用量与术语记忆
/Applications/iTrans.app/Contents/MacOS/cduyzhTranslator --stats
/Applications/iTrans.app/Contents/MacOS/cduyzhTranslator --memory
将 iTrans 接入你的自动化工作流
立即下载 iTrans，为本地智能体与脚本赋予强大的术语感知翻译能力。