Overview Version History Q & A Rating & Review
支持大模型调用的 VSCode 代码注释翻译插件,作为 Comment Translate 的翻译源扩展
⚠️本插件不提供大模型Key,请自备Key
[简体中文 ]|English
✨ 特性
🤖 支持OpenAI和Gemini调用方式
🎯 对函数、类、变量等参数的智能命名,按照命名规则优化命名
🔄 对问题面板信息进行翻译
⌨️ 自定义提示词
⚡ 快速的翻译响应
🛠️ 灵活的配置选项
📦 安装
安装 Comment Translate
安装本插件Comment Translate for AI
在 VS Code 中打开命令面板 (Ctrl+Shift+P)
输入 "Comment Translate: Change translation source"
选择 "AI Translate" 作为翻译源
⚙️ 配置
在 VS Code 设置中配置以下选项:
配置项
说明
默认值
aiTranslate.largeModelApi
大模型 API 端点
-
aiTranslate.largeModelKey
API 密钥
-
aiTranslate.largeModelName
模型名称
-
aiTranslate.largeModelMaxTokens
最大 token 数
2048
aiTranslate.largeModelTemperature
大模型温度参数 (较低的值产生更确定的结果,较高的值产生更多样的结果)
0.5
aiTranslate.namingRules
命名规则
default(由AI自行判断)
aiTranslate.modelType
大模型类型
OpenAI
aiTranslate.filterThinkingContent
过滤深度思考思考内容
False
🚀 快速开始
配置 API 相关信息,请确保您使用的大模型服务商兼容OpenAI的API调用格式
Open AI官方文档
中国大陆地区推荐使用DeepSeek
不是广告,因为这个模型效果好而且token便宜推荐一下
配置完成后,请调用“Comment Translate”中的“Comment Translate:Change translate source”命令
选择翻译源为"AI translate"
怎么使用"AI命名"
右键鼠标→在列表中选择"注释翻译"→点击"AI命名"即可使用
将命名按照所选的命名格式翻译成英文
按照命名格式优化命名
自定义AI提示词
提示词中需要包含以下参数,参数内容由插件自动获取
自定义命名提示词
参数
说明
${variableName}
当前正在处理的变量名
必填
${paragraph}
变量所在的段落
必填
${languageId}
当前文件的语言标识
必填
${this._defaultOption.namingRules}
命名规则(由Ai Translate:Naming Rules控制)
选填
示例:请根据 ${languageId} 判断 "${paragraph}" 中的 "${variableName}" 是类名、方法名、函数名还是其他类型。
然后,根据 ${languageId} 的标准规范和命名规则 "${this._defaultOption.namingRules}",将 "${variableName}" 翻译为英文,使用专业术语,并直接返回 "${variableName}" 的翻译结果,无需任何解释或特殊符号。
自定义翻译提示词
参数
说明
${targetLang}
翻译时的目标语言
必填
${content}
需要翻译的内容
必填
示例:请充当翻译员,检查句子或词语是否准确,翻译自然、流畅且符合习惯用法,使用专业的计算机术语以确保注释或功能的准确翻译,无需添加不必要的内容。将以下文本翻译成${targetLang}:\n${content}`
问题面板信息翻译
将问题面板中的警告、报错等信息翻译成所选的语言
⚠️对语言的支持能力取决于你使用的模型
🤝 贡献
欢迎提交 Issue 和 Pull Request!
📝 更新日志
0.0.1
🎉 初始化项目
✨ 实现基本翻译功能
🔧 添加配置选项
0.0.2
0.0.3
0.0.4
🤖 添加AI命名功能,AI可以根据你的设定或者自行判断,对变量、函数、类等参数智能命名
🌐 添加了多语言环境的配置文件
0.0.5
0.0.6
0.0.7
0.0.8
0.0.9
🔄 优化大模型调用方式
➕ 添加谷歌Gemini大模型调用方式
1.0.0
1.0.1
🙏 致谢
本项目基于以下优秀的开源项目开发:
特别感谢:
📄 许可证说明
本项目采用 MIT License 许可证。
部分代码修改自 deepl-translate ,遵循其 MIT 许可证。