Trae CN 划词翻译插件
一个专为 Trae CN 环境设计的 VSCode 划词翻译插件,集成 Trae CN 大模型,提供高质量的翻译服务。
功能特性
🚀 核心功能
- 智能划词翻译: 选中文本后按
Ctrl+T
即可快速翻译
- 自动语言检测: 智能识别源语言,无需手动选择
- 多语言支持: 支持中英日韩法德西俄等多种语言互译
- 翻译历史管理: 自动保存翻译记录,支持搜索和导出
- 浮窗显示: 翻译结果以浮窗形式显示,不干扰编码流程
🎨 用户界面
- 状态栏集成: 显示翻译状态和快捷访问
- 侧边栏面板: 翻译历史和设置管理
- 右键菜单: 便捷的上下文操作
- Trae CN 品牌主题: 统一的视觉风格
⚙️ 高级设置
- API 配置: 自定义 Trae CN API 端点和密钥
- 语言偏好: 设置默认源语言和目标语言
- 界面定制: 浮窗位置、显示时间等个性化选项
- 历史管理: 可配置历史记录数量限制
快速开始
安装插件
- 在 VSCode 扩展市场搜索 "Trae CN 划词翻译"
- 点击安装并重启 VSCode
- 在设置中配置 Trae CN API 密钥
基本使用
- 翻译文本: 选中要翻译的文本,按
Ctrl+T
- 查看历史: 按
Ctrl+H
打开翻译历史面板
- 打开设置: 按
Ctrl+Shift+T
或点击状态栏图标
- 导出历史: 在历史面板中点击导出按钮
快捷键
快捷键 |
功能 |
Ctrl+T |
翻译选中文本 |
Ctrl+H |
显示翻译历史 |
Ctrl+Shift+T |
打开设置面板 |
配置说明
API 配置
{
"trae-cn-translator.apiEndpoint": "https://api.trae.cn",
"trae-cn-translator.apiKey": "your-api-key-here"
}
语言设置
{
"trae-cn-translator.defaultSourceLanguage": "auto",
"trae-cn-translator.defaultTargetLanguage": "zh-CN",
"trae-cn-translator.autoDetectLanguage": true
}
界面设置
{
"trae-cn-translator.showFloatingWindow": true,
"trae-cn-translator.floatingWindowPosition": "cursor",
"trae-cn-translator.floatingWindowTimeout": 3000
}
历史记录
{
"trae-cn-translator.maxHistoryItems": 1000
}
支持的语言
- 🇨🇳 简体中文 (zh-CN)
- 🇹🇼 繁体中文 (zh-TW)
- 🇺🇸 英语 (en)
- 🇯🇵 日语 (ja)
- 🇰🇷 韩语 (ko)
- 🇫🇷 法语 (fr)
- 🇩🇪 德语 (de)
- 🇪🇸 西班牙语 (es)
- 🇷🇺 俄语 (ru)
开发指南
环境要求
- Node.js 18+
- VSCode 1.74.0+
- TypeScript 5.0+
本地开发
# 克隆项目
git clone <repository-url>
cd trae-cn-translator
# 安装依赖
npm install
# 编译项目
npm run compile
# 启动调试
# 按 F5 或在调试面板中选择 "Run Extension"
构建打包
# 构建生产版本
npm run package
# 生成 .vsix 文件
vsce package
项目结构
src/
├── extension.ts # 插件入口文件
├── types/ # TypeScript 类型定义
├── services/ # 核心服务
│ └── translationService.ts
├── handlers/ # 命令处理器
│ ├── translationHandler.ts
│ └── historyHandler.ts
└── providers/ # 数据提供者
├── historyProvider.ts
└── settingsProvider.ts
API 接口
翻译接口
POST /api/v1/translate
{
"text": "Hello World",
"source_language": "en",
"target_language": "zh-CN"
}
语言检测
POST /api/v1/detect-language
{
"text": "Hello World"
}
支持语言列表
GET /api/v1/languages
故障排除
常见问题
Q: 翻译失败,显示 API 密钥无效
A: 请检查设置中的 API 密钥是否正确配置
Q: 翻译速度较慢
A: 请检查网络连接,或尝试更换 API 端点
Q: 历史记录丢失
A: 历史记录保存在 VSCode 的全局状态中,重装插件不会丢失
Q: 快捷键冲突
A: 可在 VSCode 键盘快捷方式设置中自定义快捷键
调试模式
- 打开 VSCode 开发者工具 (
Ctrl+Shift+I
)
- 查看控制台输出
- 检查网络请求状态
更新日志
v1.0.0 (2025-01-11)
- 🎉 首次发布
- ✨ 支持划词翻译功能
- ✨ 集成 Trae CN 大模型 API
- ✨ 翻译历史记录管理
- ✨ 多语言支持
- ✨ 浮窗显示翻译结果
- ✨ 完整的设置界面
贡献指南
欢迎提交 Issue 和 Pull Request!
- Fork 本项目
- 创建特性分支 (
git checkout -b feature/AmazingFeature
)
- 提交更改 (
git commit -m 'Add some AmazingFeature'
)
- 推送到分支 (
git push origin feature/AmazingFeature
)
- 打开 Pull Request
许可证
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情
联系我们
- 项目主页: [GitHub Repository]
- 问题反馈: [GitHub Issues]
- 邮箱: support@trae.cn
享受高效的翻译体验! 🚀