Dragon Translate (VS Code 翻译与变量命名插件)

一款轻量、极速的 VS Code 翻译与变量命名插件。无需离开编辑器，按快捷键呼出输入框，输入中文后选择目标格式（小驼峰、下划线、常量大写或原样输出），一键翻译并自动复制到系统剪贴板！

✨ 核心特性

• 开箱即用，免配置：默认采用微软必应 (Bing) 大模型直连翻译端点（免注册、无需 Key、免翻墙国内秒级直连）。
• 两步流式按键体验：
  1. 按快捷键弹出输入框输入中文，按 Enter；
  2. 弹出的格式列表中通过上下键选择目标格式（如 camelCase / snake_case 等），再次按 Enter；
  3. 后台极速翻译，转换格式后自动写入系统剪贴板并弹出 Toast 成功通知！
• 智能记忆偏好：自动记忆你最近一次选择的命名格式并置顶标记（★ 最近使用），连续翻译变量时无需重复翻选。
• 纯剪贴板流：严格只写入剪贴板，不破坏当前编辑器光标与选区，由你自主决定何时在何处 Cmd+V / Ctrl+V 粘贴。
• 丰富的命名格式支持：
  • Raw (原文)：保持原句翻译（如 "Get user information"，适用于注释或提交日志）
  • camelCase：小驼峰（如 getUserInfo）
  • PascalCase：大驼峰（如 GetUserInfo）
  • snake_case：下划线（如 get_user_info）
  • CONSTANT_CASE：全大写常量（如 GET_USER_INFO）
  • kebab-case：短横线（如 get-user-info）
  • Title Case：首字母大写（如 Get User Info）
  • lower case：小写空格（如 get user info）
• 多引擎与商业扩展：默认必应免配置极速翻译；支持在设置中配置百度翻译开放平台（每月免费 100 万字符）、有道智云官方 API，失败自动无缝降级到必应。

⌨️ 快捷键

💡 你可以随时在 VS Code 的 键盘快捷方式（Preferences: Open Keyboard Shortcuts）中搜索 Dragon Translate 自定义为你最舒适的快捷键。

⚙️ 设置选项 (Settings)

进入 VS Code 设置，搜索 translateDragon：

🛠️ 本地开发与调试

本插件项目已预置 VS Code 调试配置：

1. 打开本项目工作区。
2. 在 VS Code 中按下 F5（或在“运行和调试”侧边栏点击 Run Extension）。
3. 系统将自动编译并在新的扩展宿主窗口（Extension Development Host）中启动。
4. 在新窗口中按下 Cmd + Alt + T（Mac）或 Ctrl + Alt + T（Win），输入中文并回车，体验完整流程！

项目命令

• 运行测试：npm test
• 类型检查：npm run compile
• 构建打包：npm run build
• 生产优化打包：npm run package

📦 打包与发布到 VS Code 插件市场

1. 本地打包为 .vsix 文件

如果仅需在本地测试或分享给好友安装：

npm run vscode:package

执行后会在根目录生成 dragon-translate-0.0.1.vsix，在 VS Code 插件视图中点击右上角 ... -> 从 VSIX 安装... (Install from VSIX...) 即可直接安装。

2. 通过命令行一键发布到 VS Code 市场

发布需要用到微软 Azure DevOps 提供的 Personal Access Token (PAT) 作为身份凭据。

步骤 1：获取发布身份凭证 (PAT Token)

1. 访问并登录 Azure DevOps（使用注册 Publisher 的同一个微软账号）。
2. 若首次访问，按页面提示创建一个免费 Organization（如已有组织直接进入）。
3. 点击页面右上角用户头像左侧的 User settings（齿轮/用户小图标） -> 选择 Personal access tokens。
4. 点击 + New Token 创建新令牌：
   • Name: 填 vscode-publish（任意）
   • Organization: ⚠️ 必须选择 All accessible organizations（如果选特定组织，vsce 会验证失败）
   • Expiration: 建议选择 30 天或 90 天
   • Scopes: 选择 Custom defined -> 点击底部的 Show all scopes 展开所有权限 -> 找到 Marketplace，勾选 Acquire 与 Publish（或直接选 Full access）
5. 点击 Create，并立即复制保存生成的 Token 字符串（离开页面后无法再次查看）。

步骤 2：命令行发布

在项目根目录运行以下命令即可完成全自动打包并上传：

# 直接使用令牌发布
npx @vscode/vsce publish -p <你的PAT令牌> --allow-missing-repository --no-dependencies

# 或者先登录并保存凭据（后续只需运行 npm run vscode:publish）：
npx @vscode/vsce login translate-dragon
# 终端提示时输入刚才复制的 PAT 令牌，登录成功后直接执行：
npm run vscode:publish

发布完成后，Marketplace 会进行数分钟的自动合规扫描，通过后即可在 VS Code 市场全局搜索并安装！