Ku3go KC Helper
KuCoin 国际化翻译辅助插件，在 JS/TS/JSX/TSX 文件中为 _t('key')、t('key')、$t('key')、_tHTML('key')、$tHTML('key') 等翻译函数调用提供行内翻译预览和悬停提示。
功能特性
- 行内翻译预览：在翻译函数调用后方直接显示对应的中文翻译（超长文本自动截断）
- 悬停详情：鼠标悬停时显示所有来源的翻译内容（📁 本地 / 🔑 Lokalise / 🧪 测试 CDN / 📡 正式 CDN）
- 四数据源并行加载：本地文件、Lokalise API、测试 CDN、正式 CDN 同时加载
- 差异提示：Lokalise / 测试 CDN / 正式 CDN 之间翻译不一致时显示 ⚠️ 提示
- 模糊搜索 Key：通过翻译文本反向查找 i18n key，支持 Lokalise API 跨语言搜索
- 自动检测 projectId：从
kudos.config.* / .neeko.config.js / .i18n.config.js / .env 文件中自动提取
- 自动搜索 locale 文件：在工作区中自动查找
zh_CN.json、zh_CN.js、zh_CN.ts 等文件
- 文件监听：locale 文件变更时自动重新加载翻译数据
使用方式
- 安装插件后打开任意包含翻译调用的 JS/TS 项目
- 插件自动激活，翻译文本会以行内注释形式显示在代码中
- 鼠标悬停可查看所有来源的完整翻译
- 命令面板运行
ku3go: Search Key 通过翻译文本反向搜索 key
- 命令面板运行
ku3go: Reload Translations 重新加载所有数据源
配置项
在 VS Code 设置中搜索 ku3go：
| 配置项 |
默认值 |
说明 |
ku3go.localeFile |
cdnAssets/static/locales/zh_CN.js |
locale 文件路径，支持绝对路径或工作区相对路径 |
ku3go.projectId |
(空) |
CDN/Lokalise projectId，留空则自动检测 |
ku3go.site |
global |
CDN 站点（global / australia / europe / thailand / turkey） |
ku3go.cdnLang |
zh_CN |
CDN 拉取的语言（如 zh_CN / en_US） |
ku3go.lokaliseApiKey |
(空) |
Lokalise API Key，留空则禁用 Lokalise 数据源 |
行内翻译优先级
本地 > Lokalise > 测试 CDN > 正式 CDN
支持的 locale 文件格式
- JSON：直接的
{ "key": "value" } 键值对
- JS：包含翻译对象的 JS 文件（如
_KC_PAGE_LANG_LOADER("xx", { ... })）
- TS：包含翻译对象的 TypeScript 文件
开发
pnpm install # 安装依赖
pnpm dev # 开发模式（lint + tsc watch）
F5 # 在 VS Code 中启动 Extension Development Host 调试
pnpm build # 构建 .vsix 包
pnpm publish # 发布到 VS Code Marketplace
许可证
MIT
| |
