1. 为什么要在 Windows 上折腾 simple-one-api 和沉浸式翻译如果你平时看英文文档、追 GitHub issue、读论文大概率装过沉浸式翻译这类浏览器插件。它默认走的是各家翻译接口但用久了你会发现两个问题一是想换成 DeepSeek 这类性价比高的模型时插件里没有现成选项二是手里攒了好几个平台的 KeyOpenAI 一个、DeepSeek 一个、讯飞一个每换一个工具就要重新填一遍管理起来很乱。simple-one-api 这个开源项目正好解决第一个问题。它是一个用 Go 写的单可执行文件服务把 OpenAI 兼容接口、DeepSeek、千帆、讯飞星火、腾讯混元、MiniMax 这些平台的接口统一成一套 OpenAI 格式的 API。你在本地跑起来之后对外只暴露一个端口、一个统一 Key任何支持自定义 OpenAI 接口的客户端都能接进来沉浸式翻译就是其中之一。这篇内容面向的是 Windows 用户尤其是刚接触本地服务、看官方 README 有点懵的新手。我会把 simple-one-api 的 Windows 本地部署流程拆成可复制的命令再演示怎么在沉浸式翻译里新增一个 deepseek-v1 翻译服务最后用 TaoToken 的统一 Key 通道做一次连通性验证让你从「服务启动」到「翻译生效」完整跑通一遍。核心检索词先摆出来simple-one-api 是一个 OpenAI 接口适配层能做什么——把多平台大模型 API 统一成一个入口适合谁——需要在一个客户端里切换多个模型、又不想反复改配置的人。下面进入实操。2. TaoToken 统一 Key 接入前的准备工作在动手部署之前先把「Key 从哪来」这件事理清楚否则后面配置文件里填什么会卡住。simple-one-api 的 config.json 里有一个对外统一 Key 的概念客户端拿这个 Key 访问本地服务本地服务再拿各个平台真实的 Key 去请求上游。也就是说你至少需要两类 Key一类是 simple-one-api 自己生成的「本地统一 Key」随便设一个字符串就行另一类是上游模型的真实 Key比如 DeepSeek 官方给的、或者通过 TaoToken 拿到的统一 Key。这里我推荐用 TaoToken 的方式接入。原因是它把多个模型的调用收敛到一个 Key 和一套 Base URL 上你不需要为每个平台单独注册、单独充值、单独记 Key。对于 simple-one-api 这种「一个配置文件管多个模型」的场景用统一 Key 能少填很多字段配置也更干净。TaoToken 的官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址后面不加 UTM 参数。你需要先去控制台创建一个 API Key控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页面在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。创建好之后先复制出来等会儿要填进 config.json。如果你只是想先验证模型能不能通可以用模型对话页面快速试一下https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。长期做编码或者跑 Agent 的话可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到字段不清楚的时候翻一下。另外Windows 上要跑 simple-one-api需要确认两件事一是装了 Go 环境如果你选择源码编译二是 9090 端口没被占用。Go 的安装包去官网下载 msi 一路下一步就行装完在 PowerShell 里敲go version能看到版本号就说明好了。端口检查可以用netstat -ano | findstr 9090没输出就说明空闲。准备工作做完接下来进入真正的部署环节。3. simple-one-api 的 Windows 本地部署与 config.json 配置这一节是全文技术含量最高的部分我会把 clone、编译、配置、启动四步都写清楚配置文件片段可以直接复制。3.1 拉取源码与编译先建一个工作目录比如D:\dev\simple-one-api然后在 PowerShell 里执行cd D:\dev git clone https://github.com/fruitbars/simple-one-api.git cd simple-one-api项目是 Go 写的编译之前确认 Go 环境正常go version如果提示找不到命令说明 Go 没装好或者没加进 PATH回去检查安装步骤。确认没问题后在项目根目录执行编译go build -o simple-one-api.exe编译成功后目录里会多出一个simple-one-api.exe。如果你不想编译也可以直接去项目的 Releases 页面下载现成的 exe效果一样。我试过两种方式编译出来的体积略小一点但差别不大。3.2 config.json 的结构说明项目根目录有一个config.json这是整个服务的核心配置。它的外层是服务级设置内层是各个模型的接入信息。先看外层几个关键字段{ api_key: sk-local-123456, load_balancing: random, server_port: 9090 }api_key是对外的统一 Key客户端访问本地服务时填这个你可以自己改成任意字符串。load_balancing指定多个模型时的选择策略填random就是随机挑一个。server_port是对外端口默认 9090没被占用就别改。3.3 增加 deepseek-v1 模型配置接下来是重点在 models 里增加 DeepSeek 的接入。用 TaoToken 统一 Key 的话配置片段如下{ models: [ { name: deepseek-v1, model: deepseek-chat, type: openai, base_url: https://taotoken.net/api/v1, api_key: sk-你的TaoToken密钥 } ] }这里几个字段要对应清楚name是你在客户端里调用的模型名也就是沉浸式翻译里要填的那个model是上游真实模型 IDtype填openai表示走 OpenAI 兼容协议base_url填 TaoToken 的 API 地址加/v1api_key填你在控制台创建的那个 Key。把这段合并进完整的 config.json 后保存文件。注意 JSON 格式很严格多一个逗号都会导致启动失败建议用 VS Code 这类带校验的编辑器改。3.4 启动服务配置改完双击simple-one-api.exe或者在 PowerShell 里执行.\simple-one-api.exe看到类似server started on port 9090的输出就说明服务起来了。这个黑框窗口不要关关了服务就停了。想后台运行的话可以用Start-Process -NoNewWindow .\simple-one-api.exe或者干脆开一个专门的终端窗口挂着。到这一步本地服务已经就绪对外地址是http://localhost:9090/v1统一 Key 是你在 config.json 里设的那个。4. 沉浸式翻译新增 deepseek-v1 翻译服务的配置步骤服务跑起来之后接下来把它接进沉浸式翻译。整个过程分三步打开自定义 API 设置、填写接口信息、验证翻译生效。4.1 打开沉浸式翻译的自定义翻译服务在浏览器里点开沉浸式翻译的扩展图标进入设置页面找到「翻译服务」这一栏。往下翻会看到「自定义 API」或者「添加自定义翻译服务」的入口。不同版本位置略有差异但关键词都是「自定义」。点进去之后界面会让你填几个字段名称、接口地址、API Key、模型名。这几个字段正好对应我们前面 config.json 里的配置。4.2 填写接口信息按下面这样填名称可以写deepseek-v1-local方便自己识别。接口地址填http://localhost:9090/v1/chat/completions注意这里要带上完整的路径不能只填到/v1。API Key 填 config.json 里的api_key比如sk-local-123456。模型名填deepseek-v1也就是 config.json 里 models 的name字段。填完之后保存。有些版本的沉浸式翻译会要求你点一下「测试」按钮如果返回正常就说明连通了。4.3 设为默认翻译服务并验证保存后回到翻译服务列表把刚添加的deepseek-v1-local设为默认。然后随便打开一个英文网页右键选择「翻译网页」或者用快捷键触发翻译。如果页面上英文被替换成中文说明整条链路通了浏览器 → 本地 simple-one-api → TaoToken → DeepSeek。如果翻译没反应先看 simple-one-api 的黑框窗口有没有请求日志输出。有日志说明请求到了本地服务问题可能出在上游没日志说明沉浸式翻译没发出去检查接口地址和端口。5. 常见报错排查401、local proxy failed 与 reading choices部署和接入过程中最容易卡在几个典型报错上。这一节把真实遇到过的错误和对应解法列出来对照着查能省不少时间。5.1 401 Unauthorized这个报错通常出现在两个位置。一是沉浸式翻译调用本地服务时返回 401说明你填的 API Key 和 config.json 里的api_key不一致回去核对一下注意有没有多余空格。二是 simple-one-api 请求上游时返回 401说明 config.json 里 models 的api_key填错了或者 TaoToken 的 Key 已经失效。去控制台重新生成一个替换进去再重启服务。5.2 local proxy failed这个报错一般出现在沉浸式翻译侧提示本地代理失败。原因通常是 simple-one-api 服务没启动或者端口被占用后服务实际没起来。先在 PowerShell 里执行netstat -ano | findstr 9090看端口有没有在监听。如果没有回到项目目录重新启动 exe观察黑框里有没有报错。常见的是 config.json 格式错误导致启动中断用 JSON 校验工具过一遍。5.3 reading choices 相关报错如果日志里出现类似reading choices或者cannot read property choices的提示说明上游返回的结构和预期不符。这种情况多半是base_url或model字段填错了。比如 base_url 少写了/v1或者 model 填了一个上游不存在的 ID。用 TaoToken 的话base_url 固定是https://taotoken.net/api/v1model 填deepseek-chat这类真实 ID不要填deepseek-v1那是本地别名。5.4 OAuth 与鉴权类问题如果你在配置过程中看到 OAuth 相关的提示通常是因为误用了需要 OAuth 流程的接入方式。simple-one-api 走的是 API Key 鉴权不涉及 OAuth。检查一下是不是把某个需要网页授权的平台配置混进来了。用 TaoToken 统一 Key 的话全程只需要一个 API Key不存在 OAuth 环节。排查的时候有个通用思路先确认本地服务活着再确认本地 Key 对得上最后确认上游 Key 和地址对得上。三层逐一排除基本都能定位到问题。6. 从本地服务到统一 Key 的完整闭环把上面几步串起来你现在的状态应该是Windows 上跑着一个 simple-one-api 服务config.json 里配了 deepseek-v1 指向 TaoToken沉浸式翻译通过本地端口调用这个模型网页翻译正常工作。这套结构的好处是扩展性强。以后想加新模型比如再加一个gpt-4o-mini只需要在 config.json 的 models 数组里追加一段重启服务沉浸式翻译里换个模型名就行不用改任何客户端代码。TaoToken 的统一 Key 让上游鉴权也保持单一入口不用为每个平台单独维护密钥。如果你后面要做更复杂的编码任务或者跑 Agent可以看看 Coding Plan 那套方案接入方式和这里一致只是使用场景不同。文档里对各个字段有更细的说明遇到 config.json 里不确定的字段翻一下 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 基本都能找到答案。最后留一个实用技巧config.json 改完之后建议先备份一份config.json.bak下次改崩了直接还原比重头写快得多。服务启动的黑框窗口可以最小化但别关养成习惯之后这套本地翻译链路会一直稳定跑着。
1. 为什么要在 Windows 上折腾 simple-one-api 和沉浸式翻译如果你平时看英文文档、追 GitHub issue、读论文大概率装过沉浸式翻译这类浏览器插件。它默认走的是各家翻译接口但用久了你会发现两个问题一是想换成 DeepSeek 这类性价比高的模型时插件里没有现成选项二是手里攒了好几个平台的 KeyOpenAI 一个、DeepSeek 一个、讯飞一个每换一个工具就要重新填一遍管理起来很乱。simple-one-api 这个开源项目正好解决第一个问题。它是一个用 Go 写的单可执行文件服务把 OpenAI 兼容接口、DeepSeek、千帆、讯飞星火、腾讯混元、MiniMax 这些平台的接口统一成一套 OpenAI 格式的 API。你在本地跑起来之后对外只暴露一个端口、一个统一 Key任何支持自定义 OpenAI 接口的客户端都能接进来沉浸式翻译就是其中之一。这篇内容面向的是 Windows 用户尤其是刚接触本地服务、看官方 README 有点懵的新手。我会把 simple-one-api 的 Windows 本地部署流程拆成可复制的命令再演示怎么在沉浸式翻译里新增一个 deepseek-v1 翻译服务最后用 TaoToken 的统一 Key 通道做一次连通性验证让你从「服务启动」到「翻译生效」完整跑通一遍。核心检索词先摆出来simple-one-api 是一个 OpenAI 接口适配层能做什么——把多平台大模型 API 统一成一个入口适合谁——需要在一个客户端里切换多个模型、又不想反复改配置的人。下面进入实操。2. TaoToken 统一 Key 接入前的准备工作在动手部署之前先把「Key 从哪来」这件事理清楚否则后面配置文件里填什么会卡住。simple-one-api 的 config.json 里有一个对外统一 Key 的概念客户端拿这个 Key 访问本地服务本地服务再拿各个平台真实的 Key 去请求上游。也就是说你至少需要两类 Key一类是 simple-one-api 自己生成的「本地统一 Key」随便设一个字符串就行另一类是上游模型的真实 Key比如 DeepSeek 官方给的、或者通过 TaoToken 拿到的统一 Key。这里我推荐用 TaoToken 的方式接入。原因是它把多个模型的调用收敛到一个 Key 和一套 Base URL 上你不需要为每个平台单独注册、单独充值、单独记 Key。对于 simple-one-api 这种「一个配置文件管多个模型」的场景用统一 Key 能少填很多字段配置也更干净。TaoToken 的官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址后面不加 UTM 参数。你需要先去控制台创建一个 API Key控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页面在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。创建好之后先复制出来等会儿要填进 config.json。如果你只是想先验证模型能不能通可以用模型对话页面快速试一下https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。长期做编码或者跑 Agent 的话可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到字段不清楚的时候翻一下。另外Windows 上要跑 simple-one-api需要确认两件事一是装了 Go 环境如果你选择源码编译二是 9090 端口没被占用。Go 的安装包去官网下载 msi 一路下一步就行装完在 PowerShell 里敲go version能看到版本号就说明好了。端口检查可以用netstat -ano | findstr 9090没输出就说明空闲。准备工作做完接下来进入真正的部署环节。3. simple-one-api 的 Windows 本地部署与 config.json 配置这一节是全文技术含量最高的部分我会把 clone、编译、配置、启动四步都写清楚配置文件片段可以直接复制。3.1 拉取源码与编译先建一个工作目录比如D:\dev\simple-one-api然后在 PowerShell 里执行cd D:\dev git clone https://github.com/fruitbars/simple-one-api.git cd simple-one-api项目是 Go 写的编译之前确认 Go 环境正常go version如果提示找不到命令说明 Go 没装好或者没加进 PATH回去检查安装步骤。确认没问题后在项目根目录执行编译go build -o simple-one-api.exe编译成功后目录里会多出一个simple-one-api.exe。如果你不想编译也可以直接去项目的 Releases 页面下载现成的 exe效果一样。我试过两种方式编译出来的体积略小一点但差别不大。3.2 config.json 的结构说明项目根目录有一个config.json这是整个服务的核心配置。它的外层是服务级设置内层是各个模型的接入信息。先看外层几个关键字段{ api_key: sk-local-123456, load_balancing: random, server_port: 9090 }api_key是对外的统一 Key客户端访问本地服务时填这个你可以自己改成任意字符串。load_balancing指定多个模型时的选择策略填random就是随机挑一个。server_port是对外端口默认 9090没被占用就别改。3.3 增加 deepseek-v1 模型配置接下来是重点在 models 里增加 DeepSeek 的接入。用 TaoToken 统一 Key 的话配置片段如下{ models: [ { name: deepseek-v1, model: deepseek-chat, type: openai, base_url: https://taotoken.net/api/v1, api_key: sk-你的TaoToken密钥 } ] }这里几个字段要对应清楚name是你在客户端里调用的模型名也就是沉浸式翻译里要填的那个model是上游真实模型 IDtype填openai表示走 OpenAI 兼容协议base_url填 TaoToken 的 API 地址加/v1api_key填你在控制台创建的那个 Key。把这段合并进完整的 config.json 后保存文件。注意 JSON 格式很严格多一个逗号都会导致启动失败建议用 VS Code 这类带校验的编辑器改。3.4 启动服务配置改完双击simple-one-api.exe或者在 PowerShell 里执行.\simple-one-api.exe看到类似server started on port 9090的输出就说明服务起来了。这个黑框窗口不要关关了服务就停了。想后台运行的话可以用Start-Process -NoNewWindow .\simple-one-api.exe或者干脆开一个专门的终端窗口挂着。到这一步本地服务已经就绪对外地址是http://localhost:9090/v1统一 Key 是你在 config.json 里设的那个。4. 沉浸式翻译新增 deepseek-v1 翻译服务的配置步骤服务跑起来之后接下来把它接进沉浸式翻译。整个过程分三步打开自定义 API 设置、填写接口信息、验证翻译生效。4.1 打开沉浸式翻译的自定义翻译服务在浏览器里点开沉浸式翻译的扩展图标进入设置页面找到「翻译服务」这一栏。往下翻会看到「自定义 API」或者「添加自定义翻译服务」的入口。不同版本位置略有差异但关键词都是「自定义」。点进去之后界面会让你填几个字段名称、接口地址、API Key、模型名。这几个字段正好对应我们前面 config.json 里的配置。4.2 填写接口信息按下面这样填名称可以写deepseek-v1-local方便自己识别。接口地址填http://localhost:9090/v1/chat/completions注意这里要带上完整的路径不能只填到/v1。API Key 填 config.json 里的api_key比如sk-local-123456。模型名填deepseek-v1也就是 config.json 里 models 的name字段。填完之后保存。有些版本的沉浸式翻译会要求你点一下「测试」按钮如果返回正常就说明连通了。4.3 设为默认翻译服务并验证保存后回到翻译服务列表把刚添加的deepseek-v1-local设为默认。然后随便打开一个英文网页右键选择「翻译网页」或者用快捷键触发翻译。如果页面上英文被替换成中文说明整条链路通了浏览器 → 本地 simple-one-api → TaoToken → DeepSeek。如果翻译没反应先看 simple-one-api 的黑框窗口有没有请求日志输出。有日志说明请求到了本地服务问题可能出在上游没日志说明沉浸式翻译没发出去检查接口地址和端口。5. 常见报错排查401、local proxy failed 与 reading choices部署和接入过程中最容易卡在几个典型报错上。这一节把真实遇到过的错误和对应解法列出来对照着查能省不少时间。5.1 401 Unauthorized这个报错通常出现在两个位置。一是沉浸式翻译调用本地服务时返回 401说明你填的 API Key 和 config.json 里的api_key不一致回去核对一下注意有没有多余空格。二是 simple-one-api 请求上游时返回 401说明 config.json 里 models 的api_key填错了或者 TaoToken 的 Key 已经失效。去控制台重新生成一个替换进去再重启服务。5.2 local proxy failed这个报错一般出现在沉浸式翻译侧提示本地代理失败。原因通常是 simple-one-api 服务没启动或者端口被占用后服务实际没起来。先在 PowerShell 里执行netstat -ano | findstr 9090看端口有没有在监听。如果没有回到项目目录重新启动 exe观察黑框里有没有报错。常见的是 config.json 格式错误导致启动中断用 JSON 校验工具过一遍。5.3 reading choices 相关报错如果日志里出现类似reading choices或者cannot read property choices的提示说明上游返回的结构和预期不符。这种情况多半是base_url或model字段填错了。比如 base_url 少写了/v1或者 model 填了一个上游不存在的 ID。用 TaoToken 的话base_url 固定是https://taotoken.net/api/v1model 填deepseek-chat这类真实 ID不要填deepseek-v1那是本地别名。5.4 OAuth 与鉴权类问题如果你在配置过程中看到 OAuth 相关的提示通常是因为误用了需要 OAuth 流程的接入方式。simple-one-api 走的是 API Key 鉴权不涉及 OAuth。检查一下是不是把某个需要网页授权的平台配置混进来了。用 TaoToken 统一 Key 的话全程只需要一个 API Key不存在 OAuth 环节。排查的时候有个通用思路先确认本地服务活着再确认本地 Key 对得上最后确认上游 Key 和地址对得上。三层逐一排除基本都能定位到问题。6. 从本地服务到统一 Key 的完整闭环把上面几步串起来你现在的状态应该是Windows 上跑着一个 simple-one-api 服务config.json 里配了 deepseek-v1 指向 TaoToken沉浸式翻译通过本地端口调用这个模型网页翻译正常工作。这套结构的好处是扩展性强。以后想加新模型比如再加一个gpt-4o-mini只需要在 config.json 的 models 数组里追加一段重启服务沉浸式翻译里换个模型名就行不用改任何客户端代码。TaoToken 的统一 Key 让上游鉴权也保持单一入口不用为每个平台单独维护密钥。如果你后面要做更复杂的编码任务或者跑 Agent可以看看 Coding Plan 那套方案接入方式和这里一致只是使用场景不同。文档里对各个字段有更细的说明遇到 config.json 里不确定的字段翻一下 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 基本都能找到答案。最后留一个实用技巧config.json 改完之后建议先备份一份config.json.bak下次改崩了直接还原比重头写快得多。服务启动的黑框窗口可以最小化但别关养成习惯之后这套本地翻译链路会一直稳定跑着。
文法与四元式：IF-ELSE翻译程序的核心实现)
