TranslationToolbox

Automatically detects text selection in VS Code editor and displays translation results in a hover tooltip without modifying editor content. Routes short phrases to Youdao's proprietary API for fast dictionary-style translation, while routing longer text or Japanese-containing selections to Doubao LLM via Volcano Ark. The routing decision is made client-side based on text length heuristics and character set detection (kana detection for Japanese), eliminating unnecessary API calls for short terms.

Extension automatically activates when VS Code window loads without requiring manual trigger or configuration. Uses VS Code's activation event system to register hover listeners and command handlers immediately upon window completion, eliminating cold-start friction. The activation is transparent to the user — translation functionality is immediately available without any setup steps beyond initial API key configuration.

Allows users to specify which Doubao model to use for long-text translation by entering a model ID from Volcano Ark console (e.g., 'Doubao-1.5-pro-32k'). Additionally supports customization of the system prompt (role definition) sent to Doubao, enabling users to override the default multi-language-to-Chinese translation behavior with custom instructions. Configuration is stored in VS Code settings and validated via a built-in connectivity test function that verifies API key and model availability before use.

Detects presence of Japanese kana characters (hiragana, katakana) in selected text and automatically routes such selections exclusively to Doubao LLM, bypassing Youdao API entirely. This routing decision is made client-side before API calls are initiated, preventing unnecessary Youdao requests for Japanese text. The detection mechanism is character-set based (likely Unicode range checking for kana blocks U+3040-U+309F and U+30A0-U+30FF) and is non-configurable.

Provides an optional command palette entry ('translate' command) that can be invoked via keyboard shortcut (Ctrl+Alt+T on Windows/Linux, Cmd+Alt+T on macOS) to explicitly trigger translation of the current selection. This complements the default hover-based interaction, allowing users who prefer explicit command invocation or have keybinding muscle memory to trigger translation without hovering. The command executes the same routing logic and API calls as hover-triggered translation, but requires deliberate user action.

Routes text selections below an undocumented length threshold to Youdao's proprietary suggestion API for fast, dictionary-style translation. Youdao API is non-configurable (no API key or model selection available) and operates as a closed black-box service. The extension handles authentication and request formatting internally, presenting results in the same hover tooltip as Doubao translations. Youdao is selected for short text to minimize latency compared to LLM-based approaches.

Provides a built-in test function accessible from VS Code settings UI or command palette that validates Doubao API key and model ID connectivity before translations are attempted. The test function sends a minimal request to Volcano Ark API to verify authentication and model availability, providing immediate feedback on configuration correctness. This reduces trial-and-error debugging by catching misconfigured credentials or unavailable models before they cause translation failures.

Displays translation results in a VS Code hover tooltip overlay that appears when user hovers over selected text. The tooltip is read-only and non-interactive — translations cannot be edited, copied directly from the tooltip, or inserted into the editor. This design keeps the editor content pristine and prevents accidental modifications, but limits the utility of translation results to viewing only. The tooltip automatically dismisses when the user moves the mouse away or continues editing.

Accepts text input in any language and translates to Chinese by default, using a built-in system prompt that targets Chinese output. The default system prompt is non-configurable for users who want to keep default behavior, but can be overridden by users who want to customize the target language or translation style. The extension does not explicitly document which input languages are supported by Youdao or Doubao, leaving language coverage unclear.