在windows电脑上本地部署superdoctranslator进行文档翻译

本文档基于superdoctranslator软件的开发者缘恕在github 上上传的源文档进行。

同学GnaChill整理的ttxt文档基础上进行补充的图片截图版文档。后续安装遇到了一些问题，GnaChill指导我做了一些修改，后续顺利安装完成。

txt版本粘贴：

1.通过网盘分享的文件：layover-pdf.zip
链接: https://pan.baidu.com/s/1n1jTWk6aVw_kZEjvwD3FIQ?pwd=fb4k 提取码: fb4k
通过上面的链接下载压缩包，然后解压到想解压的地方

2.在windows命令行（这个不知道怎么打开就百度吧），通过下面的命令安装miniconda，主要是可以自动安装python和管理环境，如果电脑上已经有python的觉得不会破坏环境的也可以不装：

如果是powershell，请执行：

    wget "https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe" -outfile ".\miniconda.exe"
    
    Start-Process -FilePath ".\miniconda.exe" -ArgumentList "/S" -Wait

    del .\miniconda.exe
    
如果是 cmd 请执行：

    curl https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -o .\miniconda.exe
    
    start /wait "" .\miniconda.exe /S

    del .\miniconda.exe
    
下面这两条命令和所用命令工具无关
conda init

conda create -n pdf(pdf就是环境名，可以换成你想要的，记得删掉括号和括号里的文字) python=3.8（也可以不指定）

3.安装完conda环境后执行下面的命令激活环境：

conda activate pdf（这个就是你自己设置的环境名字）

4.然后用 cd 命令转到你解压的文件夹下，具体找文件夹路径的方式不会的也请百度一下。
 
比如：cd D:\layover-pdf\（因为我直接放在D盘下了，cd要带上的，别忘了）

然后执行  pip install -r requirements.txt 如果有让你输入y和n的，统一输入y

安装完后输入python3 app.py
然后在浏览器访问http://localhost:9000/，就和你平常输网址一样（不会的也请百度一下，或者问deepseek）

使用完毕可以直接关闭命令行，以后再想使用请重复第3步和第4步

2025.05.29更新

发现一个bug，请在对应的环境下用pip install pydantic==2.10.6修复

图文详细版

一、源文件下载

登录网址：https://github.com/chaodreaming/layover-pdf

1.复制网址到浏览器，打开页面

2.下载源文件压缩包，并解压缩

（1）如果不知道怎么下载的话，可以直接从这个云盘中获取。

链接: https://pan.baidu.com/s/1n1jTWk6aVw_kZEjvwD3FIQ?pwd=fb4k 提取码: fb4k

（2）如果想自己下载github上的文件，可以采用下面这个方式

登录网站：https://minhaskamal.github.io/DownGit/#/home

把 https://github.com/chaodreaming/layover-pdf 网页粘贴到downgit中的输入框中

上述下载方法来源于知乎：🤣 Github | 如何在Github上只下载一个文件或文件夹！？ - 知乎

二、使用powershell 安装miniconda

1.打开powershell

2.使用powershell 安装miniconda

wget "https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe" -outfile ".\miniconda.exe"

写入完成，显示如下页面

Start-Process -FilePath ".\miniconda.exe" -ArgumentList "/S" -Wait

显示安装完成

    del .\miniconda.exe

输入这个代码第一遍powershell无变化，输入第二次时会显示该路径不存在。

windows开始——点击全部————可以看到Anaconda(miniconda3)

3.打开Anacoda Powershell Prompt初始化miniconda

输入 

conda init

4.配置conda环境并激活

conda create -n pdf(pdf就是环境名，可以换成你想要的，记得删掉括号和括号里的文字) python=3.9（也可以不指定）

conda create -n pdf python=3.9

输入后进行安装：-，安装完成后得到如下界面

继续输入y

三、使用Anaconda(miniconda3)安装python和管理环境

输入代码conda activate pdf

conda activate pdf

四、使用源程序，并获取翻译所在的网址

1.使用然后用 cd 命令转到你解压的文件夹

输入代码：cd +复制的内容

cd D:\sueperdoctranslater\layover-pdf\layover-pdf-main

输入代码：pip install -r requirements.txt

pip install -r requirements.txt

输入后会显示一直向下更新的代码，得到如下结果

输入代码：python app.py

python app.py

更新一长串之后得到一个网址：http://localhost:9000/

出现网址后，页面后续报error,此时打开网址http://localhost:9000/也报错。

需要继续安装'gradio'

pip install gradio

出现上述报错的问题，输入代码回退到之前的版本

pip install pydantic==2.10.6

出现服务监听所有网络接口的网址。

使用时，使用本地广播网址进入翻译页面：http://localhost:9000

五、翻译网站配置

1.在翻译网页上点击API_Key 注册页面

注册API，得到自己的账号密码

点击添加新的API

自行输入一个自己喜欢的名字

2.点击创建后出现API key，点击复制

将复制的API key粘贴至API秘钥窗口

3.上传文件，开始翻译

上传一个文件后（示例），在上传源文件处会显示上传的文件名

处理日志处会显示开始处理

找到翻译结果下载处，点击文件进行下载

打开文件检查，已经翻译完成

六、后续使用该软件进行翻译

重复步骤3和步骤4

步骤3 输入代码conda activate pdf，激活环境

conda activate pdf

步骤4

输入代码1：cd +源文件所在的main文件夹地址

cd D:\sueperdoctranslater\layover-pdf\layover-pdf-main

输入代码2：pip install -r requirements.txt

pip install -r requirements.txt

输入代码3：python app.py

python app.py

登录本地广播网址：http://localhost:9000

来到翻译页面（如果不知道如何使用，请返回五、查看）

备注：本人不是计算机专业出身，可能有很多术语存在错误。大家发现问题的话请在帖子下面留言，我看到就即时修改嘻嘻嘻 ：）