源语言	目标语言	源语言	目标语言	源语言	目标语言
德	俄	俄	德	法	德
德	法	俄	法	法	俄
德	繁	俄	繁	法	繁
德	韩	俄	韩	法	韩
德	葡	俄	葡	法	葡
德	日	俄	日	法	日
德	泰	俄	泰	法	泰
德	言	俄	言	法	言
德	英	俄	英	法	英
德	粤	俄	粤	法	粤
德	中	俄	中	法	中
源语言	目标语言	源语言	目标语言	源语言	目标语言
繁	德	韩	德	葡	德
繁	俄	韩	俄	葡	俄
繁	法	韩	法	葡	法
繁	韩	韩	繁	葡	繁
繁	葡	韩	葡	葡	韩
繁	日	韩	日	葡	日
繁	泰	韩	泰	葡	泰
繁	言	韩	言	葡	言
繁	英	韩	英	葡	英
繁	粤	韩	粤	葡	粤
繁	中	韩	中	葡	中
源语言	目标语言	源语言	目标语言	源语言	目标语言
日	德	泰	德	言	德
日	俄	泰	俄	言	俄
日	法	泰	法	言	法
日	繁	泰	繁	言	繁
日	韩	泰	韩	言	韩
日	葡	泰	葡	言	葡
日	泰	泰	日	言	日
日	言	泰	言	言	泰
日	英	泰	英	言	英
日	粤	泰	粤	言	粤
日	中	泰	中	言	中
源语言	目标语言	源语言	目标语言	源语言	目标语言
英	德	粤	德	中	德
英	俄	粤	俄	中	俄
英	法	粤	法	中	法
英	繁	粤	繁	中	繁
英	韩	粤	韩	中	韩
英	葡	粤	葡	中	葡
英	日	粤	日	中	日
英	泰	粤	泰	中	泰
英	言	粤	言	中	言
英	粤	粤	英	中	英
英	中	粤	中	中	粤

提示

"繁" 指繁体中文
"言" 指文言文
表格展示了所有110种双向翻译组合

配置说明

插件配置

在使用翻译功能前，需要在Koishi配置文件中添加百度翻译API的配置：

// koishi.config.ts
export default {
  plugins: {
    'smmcat-translate': {
      appId: 'your-baidu-app-id',      // 百度翻译API App ID
      secretKey: 'your-baidu-secret'   // 百度翻译API密钥
    }
  }
}

获取API密钥

访问百度翻译开放平台
注册账号并创建应用
获取App ID和Secret Key
在插件配置中填写相应信息

使用限制

频率限制

免费版：每月200万字符翻译额度
标准版：每月1000万字符翻译额度
高级版：每月1亿字符翻译额度

字符限制

单次请求最大长度：6000字节
建议单次翻译文本不超过5000字符

语言支持

支持110种语言双向翻译
包括主流语言、方言和文言文
支持自动语言检测

错误处理

常见错误信息

错误代码	说明	解决方法
52001	请求超时	检查网络连接，稍后重试
52002	系统错误	服务端问题，稍后重试
52003	未授权用户	检查API密钥配置是否正确
54000	必填参数为空	检查翻译文本是否为空
54001	签名错误	检查API密钥和签名算法
54003	访问频率受限	降低请求频率
54004	账户余额不足	充值或等待下月重置
54005	长query请求频繁	减少长文本翻译频率
58000	客户端IP非法	检查IP白名单设置
58001	译文语言方向不支持	检查语言对是否支持

使用建议

批量翻译：对于长文本，建议分段翻译
语言检测：插件会自动检测源语言，无需手动指定
缓存机制：相同文本的翻译结果会被缓存，提高响应速度
错误重试：遇到网络错误时，插件会自动重试

高级功能

自定义翻译方向

虽然插件支持自动语言检测，但也可以通过特定格式强制指定翻译方向：

翻译 <源语言>-<目标语言> <文本>

示例：

翻译 中-英 你好世界
翻译 英-日 hello world

多语言混合翻译

插件支持在单次请求中翻译包含多种语言的混合文本，自动识别并分别翻译。

性能优化

响应时间：通常在1-3秒内完成翻译
并发处理：支持多用户同时使用
内存管理：自动清理缓存，避免内存泄漏

实际应用场景

学习交流

语言学习：快速查询单词和短语的翻译
文档阅读：翻译外文技术文档和论文
跨文化交流：在群聊中帮助不同语言用户沟通

工作场景

代码注释：翻译代码中的英文注释
技术文档：翻译API文档和开发手册
邮件沟通：翻译商务邮件内容

日常使用

旅游准备：翻译目的地语言的关键短语
购物海淘：翻译商品描述和用户评价
新闻阅读：翻译外文新闻和资讯

常见问题解答

Q: 翻译结果不准确怎么办？

A: 翻译质量受多种因素影响，包括：

文本的复杂程度和语境
语言对的专业性
翻译模型的训练数据

建议：

简化句子结构
避免使用过于专业的术语
分段翻译长文本

Q: 如何提高翻译速度？

确保网络连接稳定
避免在高峰期大量使用
使用缓存功能（相同文本会缓存结果）

Q: 支持哪些特殊语言？

A: 除了主流语言外，还支持：

文言文（古汉语）
粤语
繁体中文
多种方言和少数民族语言

Q: 翻译服务是否收费？

A: 百度翻译API提供免费额度，超出后需要付费。具体费用请参考百度翻译开放平台的定价策略。

Q: 如何检查翻译插件是否正常工作？

A: 可以尝试翻译简单的测试文本，如"hello"或"你好"，如果返回正确结果说明插件运行正常。

最佳实践

分段翻译：对于长文档，分段翻译可以获得更好的结果
上下文保持：尽量保持原文的上下文信息
术语统一：对于专业术语，建议建立术语表
质量检查：重要翻译建议人工校对
合理使用：遵守API使用限制，避免滥用

注意事项

请勿使用翻译功能进行违法或不当内容的翻译
重要文档建议进行人工校对
遵守百度翻译API的使用条款和限制