ULI Translation 翻译插件
这是一个支持百度翻译API和腾讯云翻译API的VSCode翻译插件，支持多语言翻译、本地缓存和性能监控功能。
功能特性
- 支持多语言翻译，可选择百度翻译API或腾讯云翻译API
- 本地缓存翻译结果，提高翻译效率
- 缓存性能监控，确保响应时间在500ms内
- 自动提示清理缓存，优化性能
- 支持腾讯云机器翻译API的高级功能
使用要求
- 需要百度翻译API的AppID和密钥，或腾讯云翻译API的SecretId和SecretKey
- 需要VSCode 1.60.0或更高版本
扩展设置
本扩展提供以下设置项：
百度翻译API设置
uliTranslation.baidu.appId: 百度翻译API的AppIDuliTranslation.baidu.key: 百度翻译API的密钥uliTranslation.baidu.salt: 百度翻译API的salt值（可选）
腾讯云翻译API设置
uliTranslation.tencent.secretId: 腾讯云API的SecretIduliTranslation.tencent.secretKey: 腾讯云API的SecretKeyuliTranslation.tencent.region: 腾讯云API的地域，默认为ap-guangzhouuliTranslation.tencent.projectId: 腾讯云项目ID，默认为0
缓存设置
uliTranslation.cache.enable: 启用/禁用翻译缓存功能uliTranslation.cache.maxSizeMB: 设置缓存大小上限（MB），建议保持在20MB以内以确保响应时间在500ms内uliTranslation.cache.expirationDays: 翻译缓存的过期天数，默认为3天
已知问题
- 当缓存大小超过20MB时，响应时间可能会超过500ms
- 首次翻译需要联网获取结果
- 腾讯云翻译API单次请求文本长度限制为2000字符
- 腾讯云翻译API有调用频率限制，过于频繁的请求可能会被限流
腾讯云翻译API使用说明
配置腾讯云翻译API
- 首先，您需要在腾讯云官网申请机器翻译服务，获取SecretId和SecretKey
- 在VS Code中，打开设置（文件 > 首选项 > 设置），搜索"uliTranslation.tencent"
- 填写以下配置项：
uliTranslation.tencent.secretId: 您的腾讯云API SecretIduliTranslation.tencent.secretKey: 您的腾讯云API SecretKeyuliTranslation.tencent.region: 可选，腾讯云API地域，默认为ap-guangzhouuliTranslation.tencent.projectId: 可选，腾讯云项目ID，默认为0
切换翻译API
本插件支持在百度翻译API和腾讯云翻译API之间切换。系统会根据您的配置自动选择可用的翻译API：
- 如果您只配置了百度翻译API的AppID和密钥，系统将使用百度翻译API
- 如果您只配置了腾讯云翻译API的SecretId和SecretKey，系统将使用腾讯云翻译API
- 如果您同时配置了两种API，系统将优先使用腾讯云翻译API
腾讯云翻译API特点
- 支持多种语言之间的互译
- 支持自动语言检测（源语言设置为"auto"）
- 单次请求文本长度限制为2000字符
- 遵循腾讯云API 3.0签名v3的安全认证
- 提供详细的错误信息和故障排除提示
性能指标查看
您可以通过以下两种方式查看翻译插件的性能指标：
方式一：通过命令面板查看
- 在 VS Code 中按下
Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）打开命令面板
- 在命令面板中输入
uli-translation.showCacheMetrics 或搜索 "显示翻译缓存性能指标"
- 选择该命令后，将弹出一个信息提示框，显示以下性能指标：
- 缓存命中率（百分比）
- 平均响应时间（毫秒）
- 当前缓存大小（以人类可读的格式显示，如 KB 或 MB）
方式二：通过性能警告提示查看
当翻译缓存的响应时间超过 500ms 时，系统会自动弹出警告提示：
- 警告提示会显示当前响应时间，并提供三个选项："清空缓存"、"查看性能指标"和"忽略"
- 点击"查看性能指标"按钮，将显示与方式一相同的性能指标信息
性能指标说明
- 缓存命中率：表示从缓存中成功获取翻译结果的请求比例，命中率越高表示缓存效率越好
- 平均响应时间：表示从缓存获取翻译结果的平均时间，理想情况下应保持在 500ms 以内
- 缓存大小：当前缓存占用的存储空间，默认限制为 20MB
此外，插件还会每 10 分钟自动在 VS Code 输出面板的 "ULI Translation" 频道中记录一次性能指标，您可以通过查看输出面板来监控长期的性能趋势。
如果您发现性能指标不理想（如响应时间过长），可以考虑清空缓存以提高性能。
发布说明
1.0.0
- 初始版本发布
- 支持多语言翻译（基于百度翻译API）
- 本地缓存翻译结果
1.1.0
- 添加缓存性能监控功能
- 优化缓存大小默认值为20MB
- 添加响应时间监控和警告
- 添加缓存性能指标查看命令
- 添加清空缓存命令
1.2.0
- 添加腾讯云机器翻译API支持
- 优化翻译API错误处理
- 添加腾讯云API配置选项
- 支持在百度翻译和腾讯云翻译之间切换
祝您使用愉快！
| |
