STranslate 划词翻译与 OCR 接入 QCode 图文教程(Windows 11 一步一图)
跟着 13 步、13 张截图,在 Windows 11 上装好 STranslate 2.0.12,把 OpenAI 插件指向 QCode 接口,选中英文按 Alt+D 就能看到中文译文。
需要 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
下载与安装¶
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」,点它。

做对了你会看到:浏览器新开一个标签页,地址栏是 github.com/STranslate/STranslate/releases,页面上列着最新版本的安装文件。
认准官方说的两个 Windows 文件¶
官方安装文档把 Windows 的两个文件写在同一页:① 是页面上的「前往下载」按钮,点了就跳到发布页;② 是安装版 STranslate-win-Setup.exe,新手用这个;③ 是便携版 STranslate-win-Portable.zip,解压即用、不写注册表。

做对了你会看到:页面上能一眼找到 STranslate-win-Setup.exe 这个名字,点「前往下载」后在 GitHub 页面里也能找到同名文件。
双击安装,在向导第 1 页选语言和主题¶
双击下载好的 STranslate-win-Setup.exe。它不弹安装向导,几秒就装完并自动打开,进入「欢迎使用 STranslate」向导(一共 5 页)。第 1 页是 ① 的「语言」和 ② 的「颜色主题」,都保持默认的「系统」和「跟随系统」就行,然后点 ③ 的「下一个」。

做对了你会看到:窗口标题是「欢迎使用 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;确认这两个组合没被别的软件占用后,点 ③ 的「完成」。

做对了你会看到:向导窗口关闭,屏幕中间弹出 STranslate 的主翻译浮窗。
打开设置¶
主浮窗很小,工具栏在最上面。点 ① 圈出的齿轮图标,就打开独立的「设置」窗口;记住你也可以随时按 Ctrl + , 打开它。

做对了你会看到:屏幕上多出一个标题为「设置」的大窗口,左边一列是导航。
认识设置里的两个入口¶
设置左侧导航里,本教程只用两处:① 是「服务」下面的「文本翻译」,所有翻译服务都在这里添加;② 是「插件」,用来确认 OpenAI 插件已经装好。

做对了你会看到:左侧能看到展开的「服务」,下面有「文本翻译」「文本识别」「语音合成」「生词本」,再往下是「插件」「关于」。
确认 OpenAI 插件已经装好¶
点左侧的「插件」。OpenAI 官方翻译插件是随安装包一起装好的,不用另外下载:① 就是列表里的 OpenAI,副标题写着「适用于 STranslate 的 OpenAI 官方插件」。右上角 ② 是「市场」,那里是第三方扩展,这次不用管。

做对了你会看到:列表里同时有 OpenAI 和 OpenAI OCR,不需要下载、也不需要重启软件。
添加一个 OpenAI 翻译服务¶
点左侧「服务 → 文本翻译」,这时右侧列表是空的。点左下角 ① 的「+ 添加」,在弹出的「添加翻译服务」窗口里选中「预装」分组中的「OpenAI」卡片,再点 ② 的「添加」。

做对了你会看到:右侧出现 OpenAI 的配置表单,从上往下依次是「API 模式」「接口」「密钥」「请选择模型」。
打开开关,填好接口、密钥和模型¶
左边 OpenAI 卡片右侧的开关默认是关的,先点 ① 打开,不打开的话翻译时根本不会用到它。右边 ② 的「API 模式」保持 Chat Completions,不要选 Responses。接着在「接口」框里粘贴完整地址 https://api.qcode.cc/openai/v1/chat/completions,在「密钥」框里粘贴 cr_ 开头的 QCode 密钥(图里已打码),最后点 ③ 的「请选择模型」,直接输入 gpt-6.2-sol 并回车。

做对了你会看到:左边的开关变成打开状态,「接口」「密钥」「请选择模型」三个框里分别是完整地址、一长串 cr_ 开头的密钥和 gpt-6.2-sol。
核对「接口」下面那行最终地址¶
这个插件真正请求的地址,会实时显示在「接口」框正下方,是一行灰色小字。① 是「接口」输入框本身,② 是它下面的最终地址,必须正好是 https://api.qcode.cc/openai/v1/chat/completions。

做对了你会看到:灰色小字和你填的地址一模一样,末尾既没有多一层 /v1,也没有停在 /v1 上。
卡住了?灰色小字显示的地址被截短了
说明「接口」里少了 /chat/completions。这个插件只在接口路径是 / 或 /v1 时才会自动补 /v1/chat/completions,其他地址一律原样使用,所以带 /openai 前缀的 QCode 地址必须自己写全。改完再点一下别的输入框,让灰色小字刷新确认。
点「校验」,确认能连通¶
把右侧配置区往下滚到最底部,能看到 ① 的「校验」按钮,卡片说明是「测试 API 连接和配置是否正确」。点它,等一两秒,按钮右边会出现 ② 的绿色「验证成功」。

做对了你会看到:按钮右边显示绿色「验证成功」,不是红色的报错文字。
卡住了?点完显示 401 或 404
先看「接口」下面的灰色小字是不是完整地址,再看「密钥」里有没有多空格、引号或中文标点。改完再点一次「校验」。两种情况的具体原因写在下面「常见报错」里。
选中英文,按 Alt + D 看译文¶
打开记事本,随便写一句英文(或者粘贴一段),用鼠标把它选中,然后按键盘上的 Alt + D。屏幕中间会弹出 STranslate 浮窗:① 是浮窗里回显的原文,② 是 OpenAI 服务卡片,卡片下面就是 QCode 返回的中文译文。

做对了你会看到:浮窗里有你刚选中的英文,OpenAI 卡片上显示本次耗时,下面是一段通顺的中文。
卡住了?按了热键没有反应
先确认 STranslate 还在后台运行(任务栏右下角有它的图标)。如果它开着却还是不弹窗,多半是 Alt + D 被别的软件占了:到「设置」里换一个组合键,或者点「关于 → 向导」重看一遍快捷键那一页。
在「关于」页核对版本¶
回到「设置」,点左侧最下面的「关于」。① 是当前版本号 2.0.12;以后想重看刚才的欢迎向导,点 ② 的「向导」就能重新打开那 5 页。

做对了你会看到:「关于」页显示软件名 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)。
相关文档¶
- 接入点与 API 格式 — 协议与地址的对照表
- 国产模型接入 — OpenAI 兼容端点可用的国产模型
- 工具兼容总览 — 还有哪些软件能接 QCode
- 故障排查 — 连接类问题的通用排查顺序
开始使用 QCode
一把 API Key 同时用于 Claude Code、Codex 等工具;按 token 计费,各模型单价见 qcode.cc/models