# STranslate 划词翻译与 OCR 接入 QCode：Windows 11 图文教程

照着下面 13 步做，你会在 Windows 11 上装好划词翻译工具 STranslate，并让它通过 QCode 把随手选中的英文立刻翻成中文。


**一句话答案**：在 STranslate 的「设置 → 服务 → 文本翻译」里添加「OpenAI」服务，把「接口」填 `https://api.qcode.cc/openai/v1/chat/completions`、「密钥」填 `cr_` 开头的 QCode 密钥、模型填 `gpt-6.2-sol`，点「校验」看到绿色「验证成功」，之后选中英文按 `Alt + D` 就能翻译。

| 项 | 填写 |
|---|---|
| 接入地址 | `https://api.qcode.cc/openai/v1/chat/completions` |
| API 模式 | `Chat Completions` |
| 密钥 | `cr_xxxxxxxx` |
| 模型 | `gpt-6.2-sol` |

核对于 2026-11-22 · STranslate 2.0.12 · Windows 11



- **适用系统**：Windows 10 / 11（64 位）
- **软件版本**：STranslate 2.0.12
- **截图更新于**：2026-11
- **预计用时**：10 分钟
- **需要准备**：一个 `cr_` 开头的 QCode API 密钥；能打开 `stranslate.zggsong.com`



- 电脑是 Windows 10 / 11（64 位），能正常上网，下载安装包大约需要 60 MB 空间
- 已经注册 QCode.cc，并在[控制台](https://qcode.cc/dashboard)复制好 `cr_` 开头的 API 密钥。还没有账号？先[注册 QCode](https://qcode.cc/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-stranslate-before)，在[定价页](https://qcode.cc/pricing?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-stranslate-before)选一个方案，再到[控制台](https://qcode.cc/dashboard)创建密钥。
- 浏览器能打开 `stranslate.zggsong.com` 和 `github.com`（安装包放在 GitHub 的发布页上）
- 系统里已经装好 .NET 10 桌面运行时（.NET 10 Desktop Runtime）；没装也不影响下载，第一次启动会弹英文提示框，按提示装上就好


## 下载与安装

STranslate 是开源、免登录的 Windows 划词翻译小工具：选中文字按一下热键，译文就弹出来；它还带截图翻译和 OCR（文字识别）。Windows 上官方给了两个文件，新手直接用安装版：

- `STranslate-win-Setup.exe`：安装版，双击就装好，装到 `C:\Users\{用户名}\AppData\Local\STranslate`，配置存在 `C:\Users\{用户名}\AppData\Roaming\STranslate`；
- `STranslate-win-Portable.zip`：便携版，解压到一个文件夹就能用，配置写在软件目录下的 `PortableConfig`。

官方入口只有两个：官网 <https://stranslate.zggsong.com/>（首屏「下载 STranslate」按钮）和官方发布页 <https://github.com/STranslate/STranslate/releases>。官方安装说明在 <https://stranslate.zggsong.com/docs/install/>。如果启动时提示缺少运行环境，按提示装 .NET 10 Desktop Runtime，下载页是 <https://dotnet.microsoft.com/en-us/download/dotnet/10.0>。

不同地区的网络情况不一样，先选你所在的地区：

**中国大陆**

- 打开官网 **stranslate.zggsong.com**，点首屏的「下载 STranslate」，会跳到 GitHub 的发布页。
- GitHub 网页偶尔打不开或很慢，过一会儿再点一次即可；也可以在发布页的 Assets 里直接下载 `STranslate-win-Setup.exe`。
- 启动时如果弹出英文框 `You must install .NET Desktop Runtime to run this application.`，点 `Download it now`，按引导装 **.NET 10 Desktop Runtime**（是 Desktop Runtime，不是 ASP.NET Runtime），装完重新打开 STranslate。
- 安装包大约 60 MB，下完再双击，别在浏览器里直接运行。


**其他地区（含欧洲、北美、日本）**

- 直接打开 <https://github.com/STranslate/STranslate/releases>，在最新版本里下载 `STranslate-win-Setup.exe`（安装版）。
- 也可以从官网 **stranslate.zggsong.com** 的「下载 STranslate」按钮进同一个页面。
- 喜欢便携版就下 `STranslate-win-Portable.zip`，解压到任意文件夹，双击里面的 `STranslate.exe`。
- 习惯命令行的可以用 Scoop：先 `scoop bucket add extras`，再 `scoop install extras/stranslate`。


## 跟着截图做：Windows 一步一图

下面 13 步，每步只做一件事。截图是中文界面，图上的橙色编号和正文里的 ①②③ 一一对应，正文写 ① 就点图上的 ① 那个位置。



### 打开官网，点「下载 STranslate」

在浏览器地址栏输入 `stranslate.zggsong.com` 打开官网。首屏正中间那个蓝色按钮就是 ① 指向的「下载 STranslate」，点它。

![浏览器打开 STranslate 官网首页 stranslate.zggsong.com，首屏的「下载 STranslate」按钮用橙色 ① 标出，点它会跳到官方发布页](https://docs.qcode.cc/static/images/tut/stranslate/202611/zh/01-download-home.webp)


做对了你会看到：浏览器新开一个标签页，地址栏是 `github.com/STranslate/STranslate/releases`，页面上列着最新版本的安装文件。




### 认准官方说的两个 Windows 文件

官方安装文档把 Windows 的两个文件写在同一页：① 是页面上的「前往下载」按钮，点了就跳到发布页；② 是安装版 `STranslate-win-Setup.exe`，新手用这个；③ 是便携版 `STranslate-win-Portable.zip`，解压即用、不写注册表。

![STranslate 官方安装文档页面：①「前往下载」按钮，② 安装版文件名 STranslate-win-Setup.exe，③ 便携版文件名 STranslate-win-Portable.zip](https://docs.qcode.cc/static/images/tut/stranslate/202611/zh/02-download-install-docs.webp)


做对了你会看到：页面上能一眼找到 `STranslate-win-Setup.exe` 这个名字，点「前往下载」后在 GitHub 页面里也能找到同名文件。




### 双击安装，在向导第 1 页选语言和主题

双击下载好的 `STranslate-win-Setup.exe`。它不弹安装向导，几秒就装完并自动打开，进入「欢迎使用 STranslate」向导（一共 5 页）。第 1 页是 ① 的「语言」和 ② 的「颜色主题」，都保持默认的「系统」和「跟随系统」就行，然后点 ③ 的「下一个」。

![STranslate 首次启动的「欢迎使用 STranslate」向导第 1 页：①「语言」下拉框、②「颜色主题」下拉框、③ 右下角「下一个」按钮，底部显示 1/5](https://docs.qcode.cc/static/images/tut/stranslate/202611/zh/03-welcome-language.webp)


做对了你会看到：窗口标题是「欢迎使用 STranslate」，底部写着 `1/5`，点「下一个」后翻到第 2 页。


**卡住了？双击后只弹出一个英文小窗口，没有向导**

那个窗口的提示是 `You must install .NET Desktop Runtime to run this application.`，意思是电脑缺 .NET 10 桌面运行时。点窗口里的 `Download it now`，按引导装 **.NET 10 Desktop Runtime** 的 64 位版本（不是 ASP.NET Runtime），装完重新双击 STranslate，就会正常进入欢迎向导。




### 核对热键，点「完成」

中间三页直接点「下一个」就行，一直来到第 5/5 页「快捷键」。① 是划词翻译的 `Alt + D`，本教程最后就靠它；② 是截图翻译的 `Alt + S`；确认这两个组合没被别的软件占用后，点 ③ 的「完成」。

![欢迎向导第 5/5 页「快捷键」：① 划词翻译 Alt + D，② 截图翻译 Alt + S，③ 右下角「完成」按钮](https://docs.qcode.cc/static/images/tut/stranslate/202611/zh/04-welcome-hotkeys.webp)


做对了你会看到：向导窗口关闭，屏幕中间弹出 STranslate 的主翻译浮窗。




### 打开设置

主浮窗很小，工具栏在最上面。点 ① 圈出的齿轮图标，就打开独立的「设置」窗口；记住你也可以随时按 `Ctrl + ,` 打开它。

![STranslate 主翻译浮窗，顶部工具栏最右侧的齿轮图标用橙色 ① 标出，点它打开独立的「设置」窗口](https://docs.qcode.cc/static/images/tut/stranslate/202611/zh/05-main-window.webp)


做对了你会看到：屏幕上多出一个标题为「设置」的大窗口，左边一列是导航。




### 认识设置里的两个入口

设置左侧导航里，本教程只用两处：① 是「服务」下面的「文本翻译」，所有翻译服务都在这里添加；② 是「插件」，用来确认 OpenAI 插件已经装好。

![STranslate「设置」窗口：左侧导航里 ① 是「服务 → 文本翻译」，② 是「插件」，右侧是当前页内容](https://docs.qcode.cc/static/images/tut/stranslate/202611/zh/06-settings-overview.webp)


做对了你会看到：左侧能看到展开的「服务」，下面有「文本翻译」「文本识别」「语音合成」「生词本」，再往下是「插件」「关于」。




### 确认 OpenAI 插件已经装好

点左侧的「插件」。OpenAI 官方翻译插件是随安装包一起装好的，不用另外下载：① 就是列表里的 `OpenAI`，副标题写着「适用于 STranslate 的 OpenAI 官方插件」。右上角 ② 是「市场」，那里是第三方扩展，这次不用管。

![「设置 → 插件」页面：① 已安装列表里的 OpenAI 官方翻译插件，② 右上角的「市场」按钮](https://docs.qcode.cc/static/images/tut/stranslate/202611/zh/07-plugins-builtin.webp)


做对了你会看到：列表里同时有 `OpenAI` 和 `OpenAI OCR`，不需要下载、也不需要重启软件。




### 添加一个 OpenAI 翻译服务

点左侧「服务 → 文本翻译」，这时右侧列表是空的。点左下角 ① 的「+ 添加」，在弹出的「添加翻译服务」窗口里选中「预装」分组中的「OpenAI」卡片，再点 ② 的「添加」。

![「服务 → 文本翻译」页面：① 左下角「+ 添加」按钮，②「添加翻译服务」弹窗底部蓝色的「添加」按钮，弹窗里选中了「预装」中的 OpenAI](https://docs.qcode.cc/static/images/tut/stranslate/202611/zh/08-add-openai-service.webp)


做对了你会看到：右侧出现 OpenAI 的配置表单，从上往下依次是「API 模式」「接口」「密钥」「请选择模型」。




### 打开开关，填好接口、密钥和模型

左边 `OpenAI` 卡片右侧的开关默认是关的，先点 ① 打开，不打开的话翻译时根本不会用到它。右边 ② 的「API 模式」保持 `Chat Completions`，不要选 `Responses`。接着在「接口」框里粘贴完整地址 `https://api.qcode.cc/openai/v1/chat/completions`，在「密钥」框里粘贴 `cr_` 开头的 QCode 密钥（图里已打码），最后点 ③ 的「请选择模型」，直接输入 `gpt-6.2-sol` 并回车。

![OpenAI 服务配置页：① 左侧 OpenAI 卡片右侧的启用开关已打开，②「API 模式」为 Chat Completions，③「请选择模型」里填的是 gpt-6.2-sol，接口框里是 api.qcode.cc 的完整聊天地址，密钥已打码](https://docs.qcode.cc/static/images/tut/stranslate/202611/zh/09-openai-config-filled.webp)


做对了你会看到：左边的开关变成打开状态，「接口」「密钥」「请选择模型」三个框里分别是完整地址、一长串 `cr_` 开头的密钥和 `gpt-6.2-sol`。


**需要 API Key？**

还没有 QCode 账号的话，先[注册 QCode](https://qcode.cc/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-stranslate-key)。想按用量付费，先买一个[按量包](https://qcode.cc/pay-as-you-go?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-stranslate-key)，再到[控制台](https://qcode.cc/dashboard)创建密钥。复制 `cr_` 开头的那一整串，粘到「密钥」框里就行。




### 核对「接口」下面那行最终地址

这个插件真正请求的地址，会实时显示在「接口」框正下方，是一行灰色小字。① 是「接口」输入框本身，② 是它下面的最终地址，必须正好是 `https://api.qcode.cc/openai/v1/chat/completions`。

![「接口」输入框用 ① 标出，框里是 https://api.qcode.cc/openai/v1/chat/completions；框正下方的灰色小字用 ② 标出，显示完全相同的最终请求地址](https://docs.qcode.cc/static/images/tut/stranslate/202611/zh/10-openai-final-url.webp)


做对了你会看到：灰色小字和你填的地址一模一样，末尾既没有多一层 `/v1`，也没有停在 `/v1` 上。


**卡住了？灰色小字显示的地址被截短了**

说明「接口」里少了 `/chat/completions`。这个插件只在接口路径是 `/` 或 `/v1` 时才会自动补 `/v1/chat/completions`，其他地址一律原样使用，所以带 `/openai` 前缀的 QCode 地址必须自己写全。改完再点一下别的输入框，让灰色小字刷新确认。




### 点「校验」，确认能连通

把右侧配置区往下滚到最底部，能看到 ① 的「校验」按钮，卡片说明是「测试 API 连接和配置是否正确」。点它，等一两秒，按钮右边会出现 ② 的绿色「验证成功」。

![滚动到 OpenAI 配置区底部的「校验」卡片：① 蓝色「校验」按钮，② 按钮右侧绿色的「验证成功」提示](https://docs.qcode.cc/static/images/tut/stranslate/202611/zh/11-openai-validate.webp)


做对了你会看到：按钮右边显示绿色「验证成功」，不是红色的报错文字。


**卡住了？点完显示 401 或 404**

先看「接口」下面的灰色小字是不是完整地址，再看「密钥」里有没有多空格、引号或中文标点。改完再点一次「校验」。两种情况的具体原因写在下面「常见报错」里。




### 选中英文，按 Alt + D 看译文

打开记事本，随便写一句英文（或者粘贴一段），用鼠标把它选中，然后按键盘上的 `Alt + D`。屏幕中间会弹出 STranslate 浮窗：① 是浮窗里回显的原文，② 是 `OpenAI` 服务卡片，卡片下面就是 QCode 返回的中文译文。

![在记事本里选中英文后按 Alt + D 弹出 STranslate 浮窗：① 浮窗上方的原文框，② 下方的 OpenAI 服务卡片及中文译文](https://docs.qcode.cc/static/images/tut/stranslate/202611/zh/12-translate-result.webp)


做对了你会看到：浮窗里有你刚选中的英文，`OpenAI` 卡片上显示本次耗时，下面是一段通顺的中文。


**卡住了？按了热键没有反应**

先确认 STranslate 还在后台运行（任务栏右下角有它的图标）。如果它开着却还是不弹窗，多半是 `Alt + D` 被别的软件占了：到「设置」里换一个组合键，或者点「关于 → 向导」重看一遍快捷键那一页。




### 在「关于」页核对版本

回到「设置」，点左侧最下面的「关于」。① 是当前版本号 `2.0.12`；以后想重看刚才的欢迎向导，点 ② 的「向导」就能重新打开那 5 页。

![「设置 → 关于」页面：① 版本号 2.0.12，② 右侧的「向导」按钮，旁边还有「检查更新」和「赞助」](https://docs.qcode.cc/static/images/tut/stranslate/202611/zh/13-about-version.webp)


做对了你会看到：「关于」页显示软件名 `STranslate` 和版本号 `2.0.12`，旁边是「检查更新」「向导」「赞助」三个按钮。




## 验证成功

四件事都对上，就说明 STranslate 已经稳稳接通 QCode：

- 「接口」下面的灰色小字是 `https://api.qcode.cc/openai/v1/chat/completions`，不多一层也不少一段；
- 点「校验」出现绿色「验证成功」，不是 `401` 或 `404`；
- 在记事本里选中英文按 `Alt + D`，浮窗里出现中文译文；
- 关掉 STranslate 再从桌面图标打开，「服务 → 文本翻译」里的 `OpenAI` 仍然是打开状态，密钥和模型都还在。


### 全部完成

你现在可以在 Windows 11 上选中任意英文，按 `Alt + D` 就看到中文译文；接口、密钥和模型都已经存好，不用每次重填。接下来可以：

- [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths)
- [国产模型接入](/docs/usage/cn-models)
- [工具兼容总览](/docs/ide/tool-compatibility)
- [故障排查](/docs/reference/troubleshooting)
- 接下来：在[定价页](https://qcode.cc/pricing?utm_source=docs.qcode.cc&utm_medium=tut_done&utm_campaign=knowledge_base&src=docs-ide-stranslate-done)比较各个方案
- 回到[控制台](https://qcode.cc/dashboard)查看用量和余额


## 常见报错

| 报错原文 | 原因 | 怎么办 |
|---|---|---|
| `You must install .NET Desktop Runtime to run this application.` | 电脑没装 .NET 10 桌面运行时，STranslate 起不来 | 点弹窗里的 `Download it now`，装 .NET 10 桌面运行时（Desktop Runtime）的 64 位版本，不是 ASP.NET Runtime；装完重新打开 STranslate |
| `ERR_CONNECTION_TIMED_OUT` | 打开 GitHub 发布页时连接超时，安装包下不下来 | 稍后再点一次官网的「下载 STranslate」；装好后按本教程把「接口」填成完整地址，点「校验」确认能连上 QCode |
| `404` | 「接口」只填到 `https://api.qcode.cc/openai/v1`，插件会原样请求，不会自动补 `/chat/completions` | 把「接口」改成完整路径 `https://api.qcode.cc/openai/v1/chat/completions`，再核对下方灰色小字是否一致 |
| `401` | 密钥带了空格、引号或中文标点，或者复制时少了几位 | 回[控制台](https://qcode.cc/dashboard)重新复制 `cr_` 开头的一整串，粘进「密钥」框后清掉首尾空格，再点「校验」 |

## 常见问题

### 密钥到期后怎么办？

分两种情况：**个人套餐**的密钥到期后不能续，只能重新开通、换一把新密钥，换完按第 9 步把「密钥」框里的旧值覆盖掉；**按量包**的密钥到期后再买一个包，同一把密钥会自动恢复，配置不用改。

### STranslate 需要注册或登录吗？

不需要。它完全在本地运行，不要求 OpenAI、微软或任何第三方账号，唯一要填的就是 QCode 的 `cr_` 密钥。

### 截图翻译和 OCR 也能走 QCode 吗？

能。「插件」页里除了 `OpenAI` 还有 `OpenAI OCR`，左侧服务树里也有「文本识别」。字段和划词翻译一样：「接口」填完整路径 `https://api.qcode.cc/openai/v1/chat/completions`，「密钥」填同一把 `cr_` 密钥，模型填 `gpt-6.2-sol`。本页截图覆盖的是划词翻译，OCR 部分照同样的字段填即可。

### 模型一定要用 gpt-6.2-sol 吗？

建议先用它：翻译速度快，返回的是干净的中文译文。想换更强的可以用 `gpt-6.2-astra`，日常划词翻译没必要。

### 翻译很慢、经常转圈怎么办？

先确认「接口」是完整地址、模型是 `gpt-6.2-sol`。网络到 `api.qcode.cc` 不稳时，可以把域名换成下面「其他接入点」里的亚洲或北美节点，路径保持不变。

## 参数说明

OpenAI 插件里这些字段的含义，照着填就行：

| 字段 | 填什么 | 说明 |
|---|---|---|
| API 模式 | `Chat Completions` | 另一项 `Responses` 是另一套 API，接 QCode 选 `Chat Completions` |
| 接口 | `https://api.qcode.cc/openai/v1/chat/completions` | 必须写完整路径；框下方灰色小字会实时显示最终请求地址 |
| 密钥 | `cr_xxxxxxxx` | QCode 的 API 密钥，以 `cr_` 开头 |
| 请选择模型 | `gpt-6.2-sol` | 可直接键入模型名后回车 |
| 提示词配置 | `翻译` | 默认即可 |
| 发送温度参数 | `Off` | 默认即可 |
| 温度控制 | `0.7` | 默认即可 |
| 附加请求参数 | 留空 | 不需要额外参数 |

## 为什么地址必须写全

这个插件会先看「接口」里的路径：只有路径是 `/` 或 `/v1` 时，它才自动补成 `/v1/chat/completions`；其他路径一律原样当请求地址。QCode 的地址带 `/openai` 前缀，属于「其他路径」，所以必须自己写到 `https://api.qcode.cc/openai/v1/chat/completions`。

如果哪天发现灰色小字被改短了，可以在地址末尾加一个 `#` 再保存：插件会把 `#` 去掉，并按 `#` 前面的完整地址请求。

## 其他接入点

三个接入域的业务能力完全一样，同一把密钥通用，只是网络路由不同。路径部分不用改，只换域名：

| 节点 | OpenAI 兼容（在 STranslate 里填这个完整地址） | Anthropic 兼容 |
|---|---|---|
| 全球 | `https://api.qcode.cc/openai/v1/chat/completions` | `https://api.qcode.cc/api` |
| 亚洲 | `https://asia.qcode.cc/openai/v1/chat/completions` | `https://asia.qcode.cc/api` |
| 北美 / 欧洲 | `https://us.qcode.cc/openai/v1/chat/completions` | `https://us.qcode.cc/api` |

`asia.qcode.cc` 和 `us.qcode.cc` 是可选的两个接入点，国内网络直连 `api.qcode.cc` 慢的时候再换。

## 关于模型

STranslate 的 OpenAI 翻译插件走的是 OpenAI 兼容协议，模型直接填模型名即可：

| 用途 | 推荐模型 | 说明 |
|---|---|---|
| 划词翻译（默认） | `gpt-6.2-sol` | 返回快、译文干净，本教程用的就是它 |
| 更高阶 | `gpt-6.2-astra` | 长句和术语多的段落更稳，消耗也更高 |
| 支持 Anthropic 协议的工具 | `claude-opus-5-5` | 走 `https://api.qcode.cc/api`；轻量场景可用 `claude-haiku-5-5` |

注意：Anthropic 兼容地址 `https://api.qcode.cc/api` 在 STranslate 的 OpenAI 插件里用不上，插件要的是上表第一行的 OpenAI 兼容路径。

## 安装版与便携版

| 项目 | 安装版 `STranslate-win-Setup.exe` | 便携版 `STranslate-win-Portable.zip` |
|---|---|---|
| 安装方式 | 双击自动装好，创建桌面快捷方式 | 解压到任意文件夹，双击里面的 `STranslate.exe` |
| 程序位置 | `C:\Users\{用户名}\AppData\Local\STranslate` | 你解压的那个文件夹 |
| 配置位置 | `C:\Users\{用户名}\AppData\Roaming\STranslate` | 软件目录下的 `PortableConfig` |
| 卸载 | 从「设置 → 应用」里卸载 | 直接删掉文件夹 |
| 适合谁 | 新手、长期使用 | 换电脑频繁、想带着配置走 |

安装版是当前用户安装，一般不会弹管理员权限确认；两种版本都可以不登录直接用。官方没有提供微软商店版本，也没有 winget 包，除直接下载外只额外支持 Scoop（`scoop bucket add extras`，然后 `scoop install extras/stranslate`）。

## 相关文档

- [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths) — 协议与地址的对照表
- [国产模型接入](/docs/usage/cn-models) — OpenAI 兼容端点可用的国产模型
- [工具兼容总览](/docs/ide/tool-compatibility) — 还有哪些软件能接 QCode
- [故障排查](/docs/reference/troubleshooting) — 连接类问题的通用排查顺序