W WPMMCC ATS / 使用帮助
English

自动翻译与 Worker 配置指南

自动翻译属于可选的高级能力，由配套的免费、本地优先程序 — WPTSALL 客户端 承担。通过将耗时的 AI 文本处理工作与 WordPress Web 服务器彻底解耦，高并发翻译任务绝不会影响线上前台的响应速度。

无云端厂商锁定： WPTSALL 客户端运行在您的本地计算机或私有云服务器上。站长自备 AI 接口凭据（DeepSeek、OpenAI、Claude、DeepL、本地 Ollama 等），直接按官方账单价格结算，无中间商点数加价。

1. 在 WordPress 插件中启用客户端 API

首先在 WordPress 后台生成连接授权凭据：

  1. 登录 wp-admin，进入 WPTSALL → 任务管理 → 授权。
  2. 开启 启用客户端 API 开关。
  3. 系统将生成两项关键安全凭据：
    • 路由密钥（Route Secret）： 一个高熵不可猜测的随机串，构成私有 REST 端点路径的一部分：
      /wp-json/wptsall/v2/{route_secret}/client/...
    • 设备级令牌（Device-Scoped Token）： 专为当前设备签发的 Bearer 访问令牌，权限严格受限于任务认领与译文写回。
  4. 点击 保存授权。
安全澄清： 设备级令牌仅用于接口调用的身份验证，并非商业许可证密钥。站长可随时在此界面撤销、重置或吊销令牌。

2. 安装 WPTSALL 客户端

WPTSALL 客户端采用 Rust 语言编写，具备极高的执行效率与低内存占用。同一套核心支持两种运行形态：

  • 原生桌面应用（Desktop）： 适用于 Linux、macOS 与 Windows 的图形界面程序。
  • 本地无头 WebUI（Headless）： 适用于本地开发或私有服务器的轻量后台程序，提供运行在 http://127.0.0.1:8977 的 Web 交互界面。

常驻后台 WebUI 服务（默认端口 8977）两步安装——下载、审阅后再运行：

  • Linux / macOS： 
    curl -fsSL -o install.sh https://raw.githubusercontent.com/wpmmcc/wptsall-client-releases/main/install.sh
less install.sh    # 先审阅脚本再运行
sh install.sh
  • Windows（PowerShell）： 
    irm https://raw.githubusercontent.com/wpmmcc/wptsall-client-releases/main/install.ps1 -OutFile install.ps1
Get-Content install.ps1    # 先审阅脚本再运行
powershell -ExecutionPolicy Bypass -File .\install.ps1
客户端专属指南： 涵盖 Desktop 桌面端运行、Linux systemd 与 macOS LaunchAgent 自启动服务配置、Windows 开机启动快捷方式、minisign 签名 OTA 升级、彻底卸载与数据保留规则，以及完整环境变量参数说明，请查阅独立的 WPTSALL 客户端安装与运维全指南 →。

3. 将客户端对接至 WordPress 站点

  1. 启动 WPTSALL 客户端，点击 添加站点。
  2. 填写站点备注名称（例如 官方商城主站）。
  3. 输入 站点基础 URL（例如 https://www.example.com）。
  4. 粘贴在步骤 1 中生成的 路由密钥（Route Secret） 与 设备级令牌。
  5. 点击 测试连接。客户端完成 Protocol v2 握手校验后，站点状态将显示为“已连接”。

4. 配置翻译厂商与模型

WPTSALL 客户端允许站长接入任何兼容 HTTP(S) 的翻译服务提供方。在客户端的 设置 → 厂商 中选择需要的服务：

  • DeepSeek： 翻译质量极其优异且成本经济（支持 deepseek-chat）。
  • OpenAI： 原生支持 gpt-4o 与 gpt-4o-mini 等主流多语言大模型。
  • Anthropic Claude： 支持 claude-3-5-sonnet 的高质量上下文翻译。
  • DeepL API： 专业的神经机器翻译，支持语气（正式/非正式）控制。
  • 本地 Ollama / vLLM： 100% 离线、私密的本地翻译，调用运行在 http://localhost:11434 的开源模型（如 qwen2.5 等）。

所有厂商的 API Key 与访问凭据均加密保存在本机 SQLite 数据库（~/.local/share/wptsall-client/runtime/wptsall.db）中，绝不上报任何外部第三方云端。

5. 运行 Worker 翻译任务

完成站点与模型配置后，在客户端切换至 Worker 标签页：

  • 单次执行模式（Run Once）： 客户端一次性从 WordPress 认领当前所有待翻译任务，逐项请求配置的模型接口并将译文写回，随后安全退出。适合与定时脚本（Cron Job）或站长手动按需触发配合使用。
  • 持续守护模式（Continuous Daemon）： 客户端在后台常驻运行，按设定的时间间隔（如每 60 秒）自动检查 WordPress 中是否有新发布的文章或发生变更的内容，实现全自动静默翻译。

6. 隐私边界与幂等写回保障

严格幂等性（Idempotency）： 所有写回请求均附带唯一的任务签名与冲突锁。如果在翻译批次进行过程中遇到网络闪断或超时，重新执行 Worker 完全安全，绝不会产生重复数据或损坏已有文章。

架构安全与数据隐私边界再次声明：

  • WordPress 插件本身从不向任何第三方服务器发起对外请求。
  • 客户端仅与站长配置的 WordPress 站点 URL 以及站长选定的翻译接口通信。
  • 整个数据链路中没有任何 SaaS 中转节点或托管账户介入。