STranslate 划词翻译与 OCR 接入 QCode 图文教程(Windows 11 一步一图)

跟着 13 步、13 张截图,在 Windows 11 上装好 STranslate 2.0.12,把 OpenAI 插件指向 QCode 接口,选中英文按 Alt+D 就能看到中文译文。

更新于 2026-11-23

需要 API Key? 前往注册 →端点与 Base URL →

本页目录

照着下面 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,并在控制台复制好 cr_ 开头的 API 密钥。还没有账号?先注册 QCode,在定价页选一个方案,再到控制台创建密钥。
  • 浏览器能打开 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」按钮用橙色 ① 标出,点它会跳到官方发布页

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

认准官方说的两个 Windows 文件

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

STranslate 官方安装文档页面:①「前往下载」按钮,② 安装版文件名 STranslate-win-Setup.exe,③ 便携版文件名 STranslate-win-Portable.zip

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

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

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

STranslate 首次启动的「欢迎使用 STranslate」向导第 1 页:①「语言」下拉框、②「颜色主题」下拉框、③ 右下角「下一个」按钮,底部显示 1/5

做对了你会看到:窗口标题是「欢迎使用 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,③ 右下角「完成」按钮

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

打开设置

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

STranslate 主翻译浮窗,顶部工具栏最右侧的齿轮图标用橙色 ① 标出,点它打开独立的「设置」窗口

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

认识设置里的两个入口

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

STranslate「设置」窗口:左侧导航里 ① 是「服务 → 文本翻译」,② 是「插件」,右侧是当前页内容

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

确认 OpenAI 插件已经装好

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

「设置 → 插件」页面:① 已安装列表里的 OpenAI 官方翻译插件,② 右上角的「市场」按钮

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

添加一个 OpenAI 翻译服务

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

「服务 → 文本翻译」页面:① 左下角「+ 添加」按钮,②「添加翻译服务」弹窗底部蓝色的「添加」按钮,弹窗里选中了「预装」中的 OpenAI

做对了你会看到:右侧出现 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 的完整聊天地址,密钥已打码

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

需要 API Key?

还没有 QCode 账号的话,先注册 QCode。想按用量付费,先买一个按量包,再到控制台创建密钥。复制 cr_ 开头的那一整串,粘到「密钥」框里就行。

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

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

「接口」输入框用 ① 标出,框里是 https://api.qcode.cc/openai/v1/chat/completions;框正下方的灰色小字用 ② 标出,显示完全相同的最终请求地址

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

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

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

点「校验」,确认能连通

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

滚动到 OpenAI 配置区底部的「校验」卡片:① 蓝色「校验」按钮,② 按钮右侧绿色的「验证成功」提示

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

卡住了?点完显示 401 或 404

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

选中英文,按 Alt + D 看译文

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

在记事本里选中英文后按 Alt + D 弹出 STranslate 浮窗:① 浮窗上方的原文框,② 下方的 OpenAI 服务卡片及中文译文

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

卡住了?按了热键没有反应

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

在「关于」页核对版本

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

「设置 → 关于」页面:① 版本号 2.0.12,② 右侧的「向导」按钮,旁边还有「检查更新」和「赞助」

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

验证成功

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

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

全部完成

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

常见报错

报错原文 原因 怎么办
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 密钥带了空格、引号或中文标点,或者复制时少了几位 回控制台重新复制 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)。

相关文档

开始使用 QCode

一把 API Key 同时用于 Claude Code、Codex 等工具;按 token 计费,各模型单价见 qcode.cc/models

企业团队版 →