这个VSCode扩展允许你将Jupyter Notebook (.ipynb)文件中的英文Markdown单元格翻译成中文。支持多种翻译引擎,包括传统翻译API(百度、有道、Google)和大模型API(OpenAI、Azure OpenAI)。
- 一键翻译当前打开的Jupyter Notebook中的所有英文Markdown单元格
- 支持多种翻译引擎:
- 百度翻译API
- 有道翻译API
- Google翻译API
- OpenAI (GPT) API
- Azure OpenAI API
- 模拟翻译(测试用)
- 自定义翻译配置,包括API密钥、模型选择和提示词设置
- 自动检测单元格语言,只翻译英文单元格
- 保留原始格式和Markdown标记
- 翻译进度指示器,支持取消操作
- 在VSCode中打开一个.ipynb文件
- 通过以下任一方式运行翻译命令:
- 右键单击编辑器,在上下文菜单中选择"翻译Notebook Markdown单元格 (英译汉)"
- 按下Ctrl+Shift+P打开命令面板,输入并选择"翻译Notebook Markdown单元格 (英译汉)"
- 在弹出的选择框中选择要使用的翻译引擎
- 如果是首次使用所选引擎,系统会提示输入相关API配置信息
- 等待翻译完成
- 通过以下任一方式打开配置界面:
- 右键单击编辑器,在上下文菜单中选择"配置Notebook Markdown翻译引擎"
- 按下Ctrl+Shift+P打开命令面板,输入并选择"配置Notebook Markdown翻译引擎"
- 选择要配置的翻译引擎
- 根据提示输入相关配置信息
你也可以直接在VSCode的设置中修改配置:
- 打开VSCode设置(文件 > 首选项 > 设置,或按Ctrl+,)
- 搜索"ipynbTranslator"
- 调整相关设置
需要在百度翻译开放平台注册并创建应用,获取APPID和密钥。
配置项:
- APPID: 应用ID
- 密钥: 应用密钥
需要在有道智云注册并创建应用,获取应用ID和应用密钥。
配置项:
- 应用ID: 应用的ID
- 应用密钥: 应用的密钥
需要在Google Cloud Platform创建项目,启用Cloud Translation API,并生成API密钥。
配置项:
- API密钥: Google Cloud API密钥
需要在OpenAI平台注册账号并获取API密钥。
配置项:
- API密钥: OpenAI API密钥
- 模型: 使用的模型,如"gpt-3.5-turbo"、"gpt-4"等
- 提示词: 引导大模型进行翻译的提示词
- API端点: API请求的URL(可选,用于自定义API代理)
需要在Azure Portal创建Azure OpenAI资源,并部署相应的模型。
配置项:
- API密钥: Azure OpenAI API密钥
- 部署ID: 模型部署的ID
- API端点: Azure OpenAI服务的端点URL
- 提示词: 引导大模型进行翻译的提示词
以下是一些针对大模型翻译的提示词示例:
请将以下英文Markdown内容翻译成中文,保持所有的Markdown格式和标签不变:
请将以下英文Markdown内容翻译成中文,这是一篇学术论文的内容,请使用恰当的学术用语进行翻译,保持所有的Markdown格式和标签不变:
你是一位精通编程和技术文档翻译的专家。请将以下英文Markdown内容翻译成中文,这是一篇技术文档,包含代码示例和技术术语,请准确翻译术语并保持代码块不变,同时保持所有的Markdown格式和标签不变:
- 下载插件的VSIX文件
- 在VSCode中,点击扩展视图图标
- 点击"..."菜单,选择"从VSIX安装..."
- 选择下载的VSIX文件
- 克隆这个仓库
- 在项目根目录运行
npm install
- 运行
npm run compile
- 按下F5开始调试
- 翻译会直接修改当前文件,建议在翻译前备份原始文件
- 若单元格已包含中文内容,将跳过翻译
- 大模型翻译通常更适合保留原始格式,但可能会有更长的响应时间
- 提示词对大模型翻译质量有重要影响,可以根据需要进行调整
- 记忆上次选择的翻译引擎
- 支持翻译选定的单元格而非整个文件
- 添加翻译历史记录
- 支持自定义翻译规则和术语表
- 添加批量处理多个文件的功能
- 添加翻译质量评估功能
- 支持更多大模型服务提供商