diff --git a/.agents/skills/i18n-development/SKILL.md b/.agents/skills/i18n-development/SKILL.md new file mode 100644 index 0000000..a34a51d --- /dev/null +++ b/.agents/skills/i18n-development/SKILL.md @@ -0,0 +1,323 @@ +--- +name: i18n-development +description: Guide for implementing i18n across UI strings, prompt templates, thinking locale, and reply locale in the Deep Code CLI. +--- + +# i18n Development Skill + +## Background + +This skill documents the complete i18n implementation plan for the `@vegamo/deepcode-cli` project. It was produced after analyzing the codebase, designing the solution, and performing 6 rounds of review. + +Reference documents: +- `.deepcode/i18n-plan.md` — Full architectural plan (v7, 13 sections, ~1070 lines) +- `.deepcode/i18n-todo.md` — Executable task list with progress tracking + +## Architecture Overview + +### Four Dimensions of i18n + +| Dimension | What | How | +|-----------|------|-----| +| **UI** | Ink component static text (labels, status, hints, errors) | `t()` from locale JSON | +| **Prompt** | System prompts sent to LLM (`SYSTEM_PROMPT_BASE`, `COMPACT_PROMPT_BASE`, date/model info) | `t()` + locale-specific EJS templates | +| **Thinking** | LLM `reasoning_content` output language | System prompt appends `t("prompt.thinkingLanguageInstruction")` using `thinkingLocale` | +| **Reply** | LLM `content` output language | System prompt appends `t("prompt.replyLanguageInstruction")` using `replyLocale` | + +**Key rule**: UI labels for Thinking/Reply (e.g., "Thinking" / "思考") always follow the main `locale`. `thinkingLocale` and `replyLocale` ONLY control LLM output language via system prompt instructions. + +### Three Locale Settings + +``` +locale → UI language + Prompt template language +thinkingLocale → LLM reasoning_content language (default = locale) +replyLocale → LLM content language (default = locale) +``` + +### Translation File Structure + +Translation files are split **by module**, not just by language. Each module has its own JSON file. + +``` +locales/ +├── en/ # English translations (fallback) +│ ├── ui-message-view.json # MessageView labels (Thinking, reasoning, etc.) +│ ├── ui-prompt-input.json # PromptInput status/hints (~20 keys) +│ ├── ui-app.json # App.tsx error/status messages (~15 keys) +│ ├── ui-loading.json # Loading text (2 keys) +│ ├── ui-exit-summary.json # Exit summary (6 keys) +│ ├── ui-welcome.json # Welcome page shortcut tips +│ ├── ui-mcp.json # MCP status page +│ ├── ui-slash-commands.json # Slash command descriptions +│ ├── ui-session-list.json # Session list labels +│ ├── ui-ask-question.json # Question prompt labels +│ ├── ui-process-stdout.json # Process stdout view +│ ├── ui-update-prompt.json # UpdatePlan display +│ ├── ui-config.json # /config command UI +│ ├── cli-help.json # CLI --help text +│ ├── session.json # session.ts runtime hints +│ └── prompt.json # System prompt translations +└── zh-CN/ # Chinese translations (mirror structure) + └── (same 16 files) +``` + +### Core API: `src/common/i18n.ts` + +```typescript +type Locale = "en" | "zh-CN"; +type TranslationKey = keyof typeof import("../../locales/en/index.json"); // auto-derived from en/*.json + +// Initialization — reads all *.json from locales/{locale}/, flattens & merges +function initI18n(locale: Locale, options?: { thinkingLocale?: Locale; replyLocale?: Locale }): void; + +// Translation — localeOverride for cross-locale lookups (used by system prompt generation) +function t(key: TranslationKey, params?: Record, localeOverride?: Locale): string; + +// Three independent locale states +function getLocale(): Locale; +function getThinkingLocale(): Locale; +function getReplyLocale(): Locale; +``` + +### React Integration + +```typescript +// I18nContext provides { t, locale, setLocale, thinkingLocale, replyLocale, ... } +// React components: useI18n() hook +// Non-React modules: import { t } from "../common/i18n" (global singleton) +``` + +## Implementation Phases + +### Phase 1: Infrastructure (PR 1) +- `src/common/i18n.ts` — core module with `loadLocaleDir()` + `flattenKeys()` +- `locales/{lang}/` directories with 16 placeholder JSON files each +- `src/settings.ts` — add `locale`, `thinkingLocale`, `replyLocale` resolution +- `src/ui/contexts/i18n.tsx` — `I18nProvider`, `useI18n()` +- `src/cli.tsx` — initialize i18n at startup +- `tsconfig.json` — enable `resolveJsonModule` +- `scripts/check-i18n.mjs` — `npm run check:i18n` script +- `package.json` — add `"locales/**"` to `files` + +### Phase 2: UI String Replacement (PR 2) +Replace hardcoded strings in 13 UI components with `t()` calls, one module file at a time. Each module corresponds to one JSON file + one source file. + +**Order**: MessageView → PromptInput → App → loadingText → exitSummary → WelcomeScreen → McpStatusList → slashCommands → SessionList → AskUserQuestionPrompt → ProcessStdoutView → UpdatePrompt → cli.tsx + +### Phase 3: Prompt Templates + Language Instructions (PR 3) +- Locale-specific EJS templates: `templates/prompts/system-prompt.{locale}.md.ejs` +- `getSystemPrompt()` appends two language instructions using `thinkingLocale` and `replyLocale` +- `getCurrentDateAndModelPrompt()` uses `t("prompt.dateAndModel")` +- `session.ts` injects `t()` via `SessionManagerOptions` + +### Phase 4: /config Command (PR 4) +- `slashCommands.ts` registers `config` command +- `ConfigDropdown.tsx` — three language selectors (UI/Thinking/Reply, advanced collapsed by default) +- `PromptInput.tsx` — handles `/config locale|thinkingLocale|replyLocale ` +- `App.tsx` — locale change callbacks that reload `` messages + +## Development Workflow + +### Per-Module Workflow + +When adding i18n to a new component: + +1. **Create translation JSON**: `locales/en/ui-{module}.json` + `locales/zh-CN/ui-{module}.json` +2. **Replace strings**: In the component file, use `t("ui.{module}.{key}")` + - React components: `const { t } = useI18n();` → `t("ui.messageView.thinking")` + - Non-React modules: `import { t } from "../common/i18n"` → `t("ui.loading.thinking")` +3. **Update tests**: Call `initI18n("en")` in test setup or mock `t()` +4. **Update progress**: Mark module as 🟢 in `i18n-todo.md` progress table +5. **Verify**: Run `npm run check && npm test` + +### Commit Message Convention + +Follow conventional commits for each phase: +- `feat(i18n): add i18n infrastructure and locale resolution` +- `feat(i18n): translate MessageView and PromptInput UI strings` +- `feat(i18n): add locale-specific system prompt templates` +- `feat(i18n): add /config command for language selection` + +### Pre-Submit Checklist + +Before opening a PR: + +- [ ] `npm run check` passes (typecheck + lint + format) +- [ ] `npm test` passes (all existing tests + new i18n tests) +- [ ] `npm run check:i18n` passes (all translation keys consistent) +- [ ] Progress table in `i18n-todo.md` updated +- [ ] No unintended changes to `dist/` or `package-lock.json` + +### Rollback Strategy + +| Phase | Risk | Rollback | +|-------|------|----------| +| Phase 1 | Low | Delete new files + revert `settings.ts`/`cli.tsx` + remove `resolveJsonModule` | +| Phase 2 | High | `git revert` entire PR (13+ files modified) | +| Phase 3 | Medium | Revert `prompt.ts` + `session.ts`, delete new template files | +| Phase 4 | Medium | Revert `slashCommands.ts` + `PromptInput.tsx` + `App.tsx`, delete `ConfigDropdown.tsx` | + +## Performance Notes + +All i18n changes have negligible performance impact: + +| Metric | Impact | Rating | +|--------|--------|--------| +| Startup time | +3~5ms | 🟢 None | +| Runtime `t()` | ~0.001ms/call | 🟢 None | +| Memory | +30~45KB | 🟢 Negligible | +| Bundle | +0KB (not in JS bundle) | 🟢 None | + +## Key Constraints + +1. **ESM `__dirname`**: `loadLocaleDir()` must use `typeof __dirname !== "undefined" ? path.resolve(__dirname, "..") : fileURLToPath(import.meta.url)` fallback because esbuild bundles as ESM. +2. **Ink ``**: Already-rendered messages won't re-render on locale switch. Call `reloadActiveSessionView()` to refresh. +3. **LLM output is a soft constraint**: Language instructions guide the LLM but cannot guarantee compliance. Most models follow reliably. +4. **`TranslationKey` type**: Must match keys in all `en/*.json` files. Auto-derived via `import type` + `keyof typeof`. +5. **Tool docs**: `templates/tools/*.md` stay in English (sent to LLM, not user-facing). + +## Common Pitfalls + +### 1. 🚫 Module-Level `t()` Calls (i18n Not Yet Initialized) + +**Problem**: `t()` called at module scope evaluates BEFORE `initI18n()` runs (ESM import resolution order). The translation cache is empty, so `t()` returns the key string itself. + +```typescript +// ❌ WRONG — evaluates at module load time +const OPTIONS = [{ label: t("ui.config.language") }]; // → "ui.config.language" +``` + +**Real-world case** (`WelcomeScreen.tsx`): +```typescript +// ❌ BUG: SHORTCUT_TIPS defined at module scope — t() returns key strings +const SHORTCUT_TIPS = [ + { label: "Ctrl+V", description: t("ui.welcome.pasteImage") }, // "ui.welcome.pasteImage" +]; +``` + +Users saw `"Tips: Ctrl+V - ui.welcome.pasteImage"` instead of `"Tips: Ctrl+V - Paste an image from the clipboard"`. + +**Fix**: Move `t()` into functions called at render time (or into the component body): + +```typescript +// ✅ CORRECT — lazy evaluation after initI18n() +function getOptions() { + return [{ label: t("ui.config.language") }]; +} +// Or use map inside a render-time function: +export function buildCommands() { + return DEFS.map(d => ({ ...d, desc: t(d.key) })); +} +``` + +For React components returning static arrays, wrap in a function: + +```typescript +function getShortcutTips(): Array<{ label: string; description: string }> { + return [ + { label: "Ctrl+V", description: t("ui.welcome.pasteImage") }, // ✅ "Paste an image from the clipboard" + ]; +} +``` + +If the array is consumed inside a `useMemo(...)`, the `get*()` function is still safe because `useMemo` also runs at render time. + +**Audit commands**: + +1. Check for module-level `t()` calls (should be zero in source files): + ```bash + rg -n '^\w.*t\("' src/ --include='*.ts' --include='*.tsx' | grep -v test + ``` + Expected output: no matches. + +2. Verify `initI18n()` is called before any module that uses `t()`: + ```bash + # Check CLI entry point calls initI18n before importing UI components + rg -n 'initI18n' src/cli.tsx + ``` + +3. When in doubt, add a runtime guard at the start of `t()` to detect pre-init calls (development only). + +### 2. 🚫 Missing `t` Import + +**Problem**: File uses `t("...")` without importing it. + +```typescript +// ❌ WRONG — missing import +export function buildExitSummaryText() { return t("ui.exitSummary.goodbye"); } +``` + +**Fix**: Always add `import { t } from "../common/i18n"` at the top. + +**Audit**: `rg -l 't\("' src/ --include='*.ts' --include='*.tsx' | xargs grep -L 'import.*i18n' | grep -v tests/` + +### 3. 🚫 Duplicate `t` Import + +**Rule**: React components → `const { t } = useI18n()`. Non-React modules → `import { t } from "../common/i18n"`. Never both in the same file. + +### 4. 🚫 Ink `useInput` Event Propagation Without Guards + +**Problem**: Ink delivers keyboard events to ALL active `useInput` hooks. When a dropdown is open, Enter triggers both the dropdown's action AND the parent's submit. + +```typescript +// ❌ WRONG — showConfigDropdown missing +if (openRawModelDropdown || showSkillsDropdown || showModelDropdown) { return; } +submitCurrentBuffer(); // fires while ConfigDropdown is open! +``` + +**Fix**: Include ALL dropdown states in the guard: + +```typescript +// ✅ CORRECT +if (openRawModelDropdown || showSkillsDropdown || showModelDropdown || showConfigDropdown) { return; } +``` + +### 5. 🚫 Test Fixtures Without `initI18n` + +Tests calling functions using `t()` must call `initI18n("en")` first, otherwise `t()` returns key strings. + +**⚠️ Subtle trap**: Tests may pass even when `t()` returns key strings, if the test only checks non-translated fields (e.g., `tip.label` but not `tip.description`). The bug only manifests in the UI. + +```typescript +// ❌ Test passes despite t() returning key strings — description is never checked +const tips = buildWelcomeTips(skills); +assert.ok(tips[0].label.includes("/new")); // passes +// tips[0].description === "ui.welcome.sendPrompt" — but nobody checks it! +``` + +**Fix**: Always call `initI18n("en")` in `describe` or test setup when testing any function that uses `t()`. If the test doesn't care about translated output, at minimum assert that `t()` returns something other than the key itself. + +### 6. 🚫 Translation Key Naming Mismatch + +Run `npm run check:i18n` before PR. Also audit key usage: +```bash +node -e "see i18n-todo.md for full audit script" +``` + +### 7. 🚫 CJK 字符视觉宽度被 `String.length` 低估 + +**Problem**: CJK 字符（中文、日文、韩文）每个占 2 列视觉宽度，但 `String.length` 计为 1。使用 `.length` 计算 UI 列宽/截断位置会导致： +- 列宽低估 → Dropdown 选项被 `wrap="truncate-end"` 截断（如 "推理语言" → "推…"） +- 表格 padding 不足 → 内容偏移 + +```typescript +// ❌ WRONG — "推理语言".length = 4, 但视觉宽 = 8 +width += item.label.length; +``` + +**Fix**: 使用 `displayWidth()` 替代 `String.length`（`src/common/display-width.ts`）： + +```typescript +import { displayWidth } from "../common/display-width"; +width += displayWidth(item.label); // "推理语言" → 8 ✅ +``` + +`displayWidth()` 对 CJK/全角/emoji 计 2 列，ASCII 计 1 列。 + +**受影响的组件及状态**： + +| 文件 | 原始代码 | 修复方式 | 状态 | +|------|---------|---------|------| +| `DropdownMenu.tsx:89` | `item.label.length` | `displayWidth(item.label)` | ✅ 已修复 | +| `SlashCommandMenu.tsx:29` | `s.label.length` | `displayWidth(s.label)` | ✅ 已修复 | +| `exitSummary.ts:13` | `visibleLength()` 仅去 ANSI | `displayWidth()` | 📌 待定（仅视觉偏移） | diff --git a/.deepcode/i18n-plan.md b/.deepcode/i18n-plan.md new file mode 100644 index 0000000..38dc793 --- /dev/null +++ b/.deepcode/i18n-plan.md @@ -0,0 +1,1151 @@ +# i18n 支持方案 v7（经过第8轮 Review — 最终版） + +> **Review 8 发现与修正（CJK 视觉宽度与布局偏移 — 2026-05-23）**: +> 1. **🟡 DropdownMenu 列宽低估 CJK 字符**：`item.label.length` 将中文 "推理语言" 计为 4 列，但视觉占 8 列，导致 `labelColumnWidth` 低估 → `wrap="truncate-end"` 截断为 "推…" +> 2. **🟡 SlashCommandMenu 同样问题**：`s.label.length` 低估中文技能名的视觉宽度，同上 +> 3. **🟡 exitSummary 表格偏移**：`visibleLength()` 仅去 ANSI 码未处理 CJK 宽度，zh-CN 下表头/数据右偏数列（不影响功能） +> 4. **🟢 新增解决方案**：创建 `src/common/display-width.ts` — `displayWidth()` 函数，CJK/全角/emoji 计 2 列，ASCII 计 1 列 +> 5. **🟢 修复 DropdownMenu**：`item.label.length` → `displayWidth(item.label)` +> 6. **🟢 修复 SlashCommandMenu**：`s.label.length` → `displayWidth(s.label)` +> 7. **📌 待定**：`exitSummary.ts:visibleLength()` 可选改为 `displayWidth()` 修复表格对齐 +> +> **Review 7 发现与修正（代码审查 + Key 使用审计 — 2026-05-22）**: +> 1. **🟡 死代码**：`i18n.ts:getExtensionRoot()` 第 38 行不可达（多余的 `return` 语句），应删除 +> 2. **🟡 McpStatusList 视图比较**：`viewMode === t("ui.mcp.serverDetail")` 用翻译字符串做状态比较，locale 切换时会失效；应使用固定字符串 +> 3. **🟡 遗漏 `t()` 调用**：`session.ts:activateSession()` 中 4 处运行时消息仍为硬编码英文（failReason "OpenAI API key not found"、apiKeyNotFound 消息、sessionAgentSteps 提示、requestFailed 拼接），虽然 JSON 中已定义对应 key +> 4. **🟡 遗漏 `t()` 调用**：`App.tsx:handleModelConfigChange()` 中 modelUnchanged/modelUpdated/noActiveSession/codeRestoreFailed/conversationRestoreFailed 等仍为硬编码 +> 5. **🟡 遗漏 `t()` 调用**：`cli.tsx` 第 84 行非 TTY 错误消息未翻译 +> 6. **🟡 大量翻译 Key 未在源代码中调用**：扫查发现 `en/index.json` 中有约 35 个 key 未在代码中被 `t()` 引用（详见下方 Key 使用审计） +> 7. **🟡 Key 使用审计结果**： +> - 已定义且使用的 key：105 个（75%） +> - 已定义但未使用的 key：35 个（25%）— 详见 `i18n-todo.md` 的 Key 使用审计表格 +> - 代码中调用但未定义的 key：0 个（所有 `t()` 调用均指向有效 key） +> 8. **🟡 未使用的 Key 详细清单**： +> - `ui.app.error/statusStatus/statusTokens/statusFail` — App.tsx 中硬编码的状态行/错误行 +> - `ui.app.modelUnchanged/modelUpdated/noActiveSession/codeRestoreFailed/conversationRestoreFailed` — App.tsx handleModelConfigChange/handleUndoRestore 硬编码 +> - `ui.app.sessionDefaultSummary/sessionAgentSteps/apiKeyNotFound/requestFailed` — session.ts 硬编码 +> - `ui.config.languageUpdated/thinkingLanguageUpdated/replyLanguageUpdated` — 未在任何 t() 中调用 +> - `ui.welcome.deepCodeTitle` — WelcomeScreen 未使用该 key +> - `ui.mcp.serverList/statusConnecting` — McpStatusList 硬编码 +> - `ui.slashCommands.continueDesc` — slashCommands.ts 第 62 行硬编码英文 +> - `ui.sessionList.title/empty` — SessionList 硬编码 +> - `ui.askUserQuestion.submit/cancel/selectOption` — AskUserQuestionPrompt 硬编码 +> - `ui.processStdout.title/running/adjustTimeout/noOutput` — ProcessStdoutView 硬编码 +> - `ui.updatePrompt.planHeader` — UpdatePrompt 硬编码 +> - `session.skillPromptHeader` — session.ts 第 987 行硬编码 "Use the skill document below..." +> - `ui.promptInput.footerBusy/ctrlOViewOutput/ctrlOExpand/ctrlOCollapse/imageCount` — PromptInput 中动态拼接 +> +> **Review 6 发现与修正（综合审计）**: +> 1. **回滚方案**：每个 Phase 需明确回滚步骤；Phase 1 最安全，Phase 2 风险最高（13+ 文件） +> 2. **验证策略细化**：Phase 1 应验证 `t("ui.loading.thinking")` 返回正确字符串而非 key 自身 +> 3. **esbuild ESM 的 `__dirname`**：`i18n.ts` 的 `loadLocaleFile` 必须使用与 `prompt.ts` 相同的 `typeof __dirname !== "undefined" ? ... : fileURLToPath(import.meta.url)` fallback，因为 esbuild bundler 打包 ESM 时不提供 `__dirname` +> 4. **`tsconfig.json` 需启用 `resolveJsonModule`**：`import type en` 需要该选项；否则 `npm run typecheck` 会失败 +> 5. **`npm run check:i18n` 实现**：一个 Node.js 脚本，读取 `en.json` 所有 key 后逐级与 `zh-CN.json` 比对，输出缺失 key +> 6. **`prompt.ts` 函数签名无需改**：`getSystemPrompt`/`getCompactPrompt` 内部调用 `getLocale()` 选择模板，不改变外部接口 +> 7. **i18n 方案文档存放位置**：`i18n-plan.md` 和 `i18n-todo.md` 已放置在 `.deepcode/` 目录下，作为开发参考 + +> **Review 5 发现与修正（安全性 & 一致性）**: +> 1. **`TranslationKey` import 路径**：从 `src/common/i18n.ts` 到 `locales/en.json` 应为 `../../locales/en.json`（修复写为 `../../../` 的错误） +> 2. **`/config` 参数精确匹配**：使用 `/^\/config\s+/` 正则而非 `startsWith("/config ")`，避免误匹配 `/configxxx` +> 3. **`en` 自身 locale 跳过 fallback**：当前 locale 为 `"en"` 时只查当前表，避免冗余二次查找 +> 4. **`PromptInput` 必须消费 `useI18n()`**：`footerText` 等字符串需通过 context 获取 `t()` 才能响应 locale 切换 +> 5. **EJS 提示词模板命名**：统一为 `system-prompt.{locale}.md.ejs` 模式，根据 `getLocale()` 选择加载 +> 6. **`MessageView/utils.ts` 直接 import 全局 `t()`**：纯函数模块无法使用 React context，直接 import `src/common/i18n` +> 1. **`TranslationKey` 类型推导**：用 `import type en from "../../locales/en.json"` + `keyof typeof en` 替代手动维护的 union type，避免三方同步 +> 2. **`SessionManagerOptions.t` 类型**：应使用 `TranslationKey` 而非 `string`，保留类型安全 +> 3. **`App` → `PromptInput` → `ConfigDropdown` 回调链**：需新增 `onLocaleChange` prop 传递 locale 切换事件 +> 4. **Tool 文档翻译决策**：`templates/tools/` 下的工具描述保持英文（发给 LLM 使用），不需要翻译 +> 5. **`loadingText.ts` 测试影响**：测试需 `initI18n("en")` 否则 `t()` 返回 key 字符串，现有断言会失败 +> 6. **`exitSummary.ts` 异常路径**：退出时确保 i18n 已初始化，或使用 `getLocale()` 兜底检查 + +> **Review 2 发现与修正**: +> 1. 用 React Context (`I18nContext`) 替代 `key={locale}` remount 方案，避免状态丢失 +> 2. locale 切换时刷新已渲染消息（通过 `setWelcomeNonce` + `reloadActiveSessionView`） +> 3. 非 React 模块直接 import 全局 `t()`，React 组件通过 context 获取 +> 4. 增加翻译 key 类型导出，提升 TypeScript 安全性 +> 5. 注明中间会话 locale 切换的行为边界 + +> **Review 1 发现与修正**: +> 1. 补充了 `WelcomeScreen`、`AskUserQuestionPrompt`、`ProcessStdoutView`、`McpStatusList`、`UpdatePrompt`、`SessionList` 的覆盖清单 +> 2. 明确 esbuild 打包策略：locales/ 通过 `package.json` `files` 字段发布，运行时通过 `__dirname` 读取 JSON +> 3. `session.ts` 改为通过 `SessionManagerOptions` 注入 `t` 函数，避免直接耦合 +> 4. 系统提示词改用 EJS 模板按 locale 加载（`templates/prompts/`） +> 5. `/config` 增加参数支持（如 `/config locale en`） + +## 1. 总体目标 + +为 CLI 提供多语言支持（至少 en / zh-CN），覆盖以下四个维度： + +| 维度 | 内容 | 策略 | +|------|------|------| +| **UI** | Ink 组件渲染的静态文本（标签、状态、提示、帮助、错误消息） | 用 `t()` 翻译 | +| **Prompt** | 发给 LLM 的系统提示词（`SYSTEM_PROMPT_BASE`、`COMPACT_PROMPT_BASE`、日期/模型信息等） | 用 `t()` 翻译 + locale-specific EJS 模板 | +| **Thinking** | ① UI 中推理区域的标签文字（"Thinking" / "思考"）
② LLM 的 **`reasoning_content`** 输出语言 | ① `t("ui.messageView.thinking")` 翻译标签
② `thinkingLocale` 配置 → 系统提示词追加 `t("prompt.thinkingLanguageInstruction")` | +| **Reply** | ① UI 中回复区域的前缀/标签（`✦` 等）
② LLM 的 **`content`** 输出语言 | ① `t()` 翻译 UI 标签（若有）
② `replyLocale` 配置 → 系统提示词追加 `t("prompt.replyLanguageInstruction")` | + +**核心机制**：在系统提示词末尾追加两条独立语言指令，分别控制推理和回复的输出语言。例如 `thinkingLocale=zh-CN, replyLocale=en` 时： + +``` +IMPORTANT: Your reasoning and thinking process should be in Chinese. +IMPORTANT: Always respond to the user in English. +``` + +**重要区分：UI 标签 vs LLM 输出语言** + +UI 中推理和回复区域的标签文字（"Thinking" / "思考"、`✦` 前缀等）**始终跟随主 `locale`**，通过 `t()` 翻译。`thinkingLocale` 和 `replyLocale` **仅**控制系统提示词中追加的语言指令，从而引导 LLM 输出的 `reasoning_content` 和 `content` 的语言。 + +``` +UI 显示： + locale=zh-CN → 推理标签="思考", 回复前缀="✦" ← 从 zh-CN/ 目录翻译 + locale=en → 推理标签="Thinking", 回复前缀="✦" ← 从 en/ 目录翻译 + +LLM 输出语言： + thinkingLocale=zh-CN → LLM reasoning_content 用中文 ← 系统提示词指令 + thinkingLocale=en → LLM reasoning_content 用英文 ← 系统提示词指令 + replyLocale=zh-CN → LLM content 用中文 ← 系统提示词指令 + replyLocale=en → LLM content 用英文 ← 系统提示词指令 +``` + +各维度的 locale 来源： + +``` +locale → 控制 UI + Prompt 模板语言（必须有效 locale） +thinkingLocale → 控制 LLM reasoning_content 语言（默认 = locale） +replyLocale → 控制 LLM content 语言（默认 = locale） +``` + +这种设计让用户可以灵活组合：推理用中文（模型中文推理更深）、回复用英文（输出给英文用户）。 + +**四维度翻译范围对比**： +``` + UI 标签翻译 Prompt 模板 thinkingLocale replyLocale +───────────────────────────────────────────────────────────────────────────── +UI ✅ t() — — — +Prompt — ✅ t()+EJS — — +Thinking（推理） ✅ t()标签 — ✅ 指令 — +Reply（回复） ✅ t()标签 — — ✅ 指令 +``` + +## 2. 文件结构 + +翻译文件按模块拆分，每个模块一个 JSON 文件，存放在对应语言的目录下。运行时自动合并加载。 + +``` +deepcode-cli/ +├── locales/ # 新增 +│ ├── en/ # 英文翻译（fallback 默认） +│ │ ├── ui-message-view.json # 消息视图标签（Thinking, reasoning 等） +│ │ ├── ui-prompt-input.json # 输入框提示、状态消息 +│ │ ├── ui-app.json # 应用层消息（Error, Interrupted 等） +│ │ ├── ui-loading.json # 加载状态文字 +│ │ ├── ui-exit-summary.json # 退出摘要 +│ │ ├── ui-welcome.json # 欢迎页快捷键提示 +│ │ ├── ui-mcp.json # MCP 状态页 +│ │ ├── ui-slash-commands.json # / 命令描述 +│ │ ├── ui-session-list.json # 会话列表 +│ │ ├── ui-ask-question.json # 问题提示 +│ │ ├── ui-process-stdout.json # 进程输出视图 +│ │ ├── ui-update-prompt.json # UpdatePlan 显示 +│ │ ├── ui-config.json # /config 命令 UI +│ │ ├── cli-help.json # CLI --help 文本 +│ │ ├── session.json # session.ts 运行时提示 +│ │ └── prompt.json # 系统提示词相关 +│ └── zh-CN/ # 中文翻译（同名文件，结构与 en/ 镜像） +│ ├── ui-message-view.json +│ └── ... +├── src/ +│ ├── common/ +│ │ └── i18n.ts # 新增 - i18n 核心模块 +│ ├── ui/ +│ │ └── components/ +│ │ └── ConfigDropdown.tsx # 新增 - /config 命令 UI +│ └── ... (既有文件修改) +``` + +### 模块文件清单 + +| # | 文件名 | 用途 | 所属 Phase | key 前缀 | 预计 key 数 | +|---|--------|------|-----------|---------|-----------| +| 1 | `ui-message-view.json` | MessageView 标签文字 | Phase 2 | `ui.messageView.*` | 9 | +| 2 | `ui-prompt-input.json` | PromptInput 状态/提示 | Phase 2 | `ui.promptInput.*` | 20 | +| 3 | `ui-app.json` | App.tsx 错误/状态消息 | Phase 2 | `ui.app.*` | 15 | +| 4 | `ui-loading.json` | 加载状态文字 | Phase 2 | `ui.loading.*` | 2 | +| 5 | `ui-exit-summary.json` | 退出摘要 | Phase 2 | `ui.exitSummary.*` | 6 | +| 6 | `ui-welcome.json` | 欢迎页快捷键 | Phase 2 | `ui.welcome.*` | ~8 | +| 7 | `ui-mcp.json` | MCP 状态页文案 | Phase 2 | `ui.mcp.*` | ~10 | +| 8 | `ui-slash-commands.json` | / 命令描述 | Phase 2 | `ui.slashCommands.*` | ~10 | +| 9 | `ui-session-list.json` | 会话列表文案 | Phase 2 | `ui.sessionList.*` | ~5 | +| 10 | `ui-ask-question.json` | 问题提示文案 | Phase 2 | `ui.askUserQuestion.*` | ~5 | +| 11 | `ui-process-stdout.json` | 进程输出视图 | Phase 2 | `ui.processStdout.*` | ~5 | +| 12 | `ui-update-prompt.json` | UpdatePlan 显示 | Phase 2 | `ui.updatePrompt.*` | ~3 | +| 13 | `cli-help.json` | CLI --help 文本 | Phase 2 | `cli.help.*` | ~15 | +| 14 | `ui-config.json` | /config 命令 UI | Phase 4 | `ui.config.*` | 5 | +| 15 | `session.json` | session.ts 运行时提示 | Phase 3 | `session.*` | 2 | +| 16 | `prompt.json` | 系统提示词翻译 | Phase 3 | `prompt.*` | 4 | + +## 3. 核心模块：`src/common/i18n.ts` + +### 接口设计 + +```typescript +// i18n.ts + +// 可用语言 +export type Locale = "en" | "zh-CN"; + +// 所有翻译 key 的类型 — 从 locales/en/ 下所有模块 JSON 合并推导 +// 可通过 locales/en/index.ts 聚合类型，或用构建脚本合并 +// tsconfig.json 需启用 "resolveJsonModule": true +import type en from "../../locales/en/index.json"; +export type TranslationKey = keyof typeof en; + +// 运行时状态 +let currentLocale: Locale = "en"; +let thinkingLocale: Locale = "en"; +let replyLocale: Locale = "en"; +// localeCache: Map> 在 loadLocaleDir 内部维护 + +// 初始化：加载 locale 目录下所有模块 JSON +export function initI18n(locale: Locale, options?: { thinkingLocale?: Locale; replyLocale?: Locale }): void; + +// 核心翻译函数，localeOverride 用于跨 locale 查找（系统提示词生成时使用） +export function t(key: TranslationKey, params?: Record, localeOverride?: Locale): string; + +// 获取/设置当前 UI locale +export function getLocale(): Locale; + +// 获取/设置 LLM 推理语言 +export function getThinkingLocale(): Locale; +export function setThinkingLocale(locale: Locale): void; + +// 获取/设置 LLM 回复语言 +export function getReplyLocale(): Locale; +export function setReplyLocale(locale: Locale): void; + +// 测试用重置 +export function resetI18n(): void; +``` + +### React Context 集成（替代 key={locale} remount） + +```typescript +// src/ui/contexts/i18n.tsx +import React, { createContext, useContext, useState, useCallback } from "react"; +import { initI18n, t, getLocale, type Locale } from "../../common/i18n"; + +type I18nContextValue = { + t: typeof t; + locale: Locale; + setLocale: (locale: Locale) => void; + thinkingLocale: Locale; + replyLocale: Locale; + setThinkingLocale: (locale: Locale) => void; + setReplyLocale: (locale: Locale) => void; +}; + +const I18nContext = createContext({ + t, + locale: "en", + setLocale: () => {}, + thinkingLocale: "en", + replyLocale: "en", + setThinkingLocale: () => {}, + setReplyLocale: () => {}, +}); + +export function I18nProvider({ children, initialLocale, initialThinkingLocale, initialReplyLocale }: + { children: React.ReactNode; initialLocale: Locale; initialThinkingLocale?: Locale; initialReplyLocale?: Locale }) { + const [locale, setLocaleState] = useState(initialLocale); + const [tLocale, setTLocaleState] = useState(initialThinkingLocale ?? initialLocale); + const [rLocale, setRLocaleState] = useState(initialReplyLocale ?? initialLocale); + + const setLocale = useCallback((newLocale: Locale) => { + initI18n(newLocale, { thinkingLocale: tLocale, replyLocale: rLocale }); + setLocaleState(newLocale); + }, [tLocale, rLocale]); + + const setThinkingLocale = useCallback((locale: Locale) => { + setTLocaleState(locale); + }, []); + + const setReplyLocale = useCallback((locale: Locale) => { + setRLocaleState(locale); + }, []); + + return ( + + {children} + + ); +} + +export function useI18n(): I18nContextValue { + return useContext(I18nContext); +} +``` + +React 组件统一从 context 获取 `t` 函数，非 React 模块直接 import `src/common/i18n.ts` 中的全局 `t()`。 + +### 非 React 模块使用方式 + +```typescript +// src/ui/loadingText.ts — 直接 import 全局 t() +import { t } from "../common/i18n"; + +export function buildLoadingText(input: LoadingTextInput): string { + if (!progress) { + return t("ui.loading.thinking"); + } + // ... +} +``` + +### React 组件使用方式 + +```typescript +// src/ui/components/MessageView/index.tsx +import { useI18n } from "../../contexts/i18n"; + +function StatusLine({ name, params, ... }: Props) { + const { t } = useI18n(); + const label = name === "Thinking" ? t("ui.messageView.thinking") : name; + // ... +} +``` + +### 功能细节 + +1. **`initI18n(locale)`**: + - 读取 `locales/{locale}/` 目录下所有 `*.json` 文件 + - 将每个文件的嵌套 JSON 展开为扁平 key-value 结构并合并 + - 始终加载 `en/` 目录作为 fallback（未翻译的 key 回退到英文） + - 设置 `currentLocale` + +2. **`t(key, params?)`**: + - 先查当前 locale 的 messages，找不到则查 fallback（en/） + - 用简单的 `{placeholder}` 正则替换 params 中的值 + - 若 key 完全不存在，返回 key 本身（便于开发时发现缺失翻译） + +3. **加载策略**: + - 在 CLI 启动时（`src/cli.tsx` 的 `main()` 中）根据用户 locale 配置初始化 + - 通过 esbuild 将 locale JSON 打包进 dist（使用 `--loader:.json=json` 或 `fs.readFileSync` 运行时加载） + +### 启动加载流程 + +``` +main() 启动 + → resolveSettings() 获取 locale 配置 + → initI18n(locale) // 通过 __dirname 读取 locales/{locale}/ 下所有 JSON + → 注入 t 函数到 SessionManager // new SessionManager({ ..., t: t }) + → render() +``` + +### Locale JSON 加载策略 + +通过 `__dirname` 运行时读取目录下所有模块 JSON 并展平合并（而非静态 import），确保 esbuild 打包后仍能正确定位： + +```typescript +// src/common/i18n.ts +function loadLocaleDir(locale: string): Record { + const localesDir = path.resolve(getExtensionRoot(), "locales", locale); + if (!fs.existsSync(localesDir)) { + return {}; + } + const merged: Record = {}; + const files = fs.readdirSync(localesDir) + .filter((f) => f.endsWith(".json")) + .sort(); + for (const file of files) { + const content = JSON.parse(fs.readFileSync(path.join(localesDir, file), "utf8")); + Object.assign(merged, flattenKeys(content)); + } + return merged; +} + +function flattenKeys(obj: Record, prefix = ""): Record { + const result: Record = {}; + for (const [key, value] of Object.entries(obj)) { + const newKey = prefix ? `${prefix}.${key}` : key; + if (typeof value === "string") { + result[newKey] = value; + } else if (value && typeof value === "object") { + Object.assign(result, flattenKeys(value as Record, newKey)); + } + } + return result; +} +``` + +同时在 `package.json` 的 `files` 字段添加 `"locales/**"`，确保发布时包含所有翻译文件。 + +## 4. 配置集成：Settings + +### `settings.ts` 新增字段 + +```typescript +export type DeepcodingSettings = { + // ... 现有字段 + locale?: string; // UI + Prompt 模板语言，"en" | "zh-CN" + thinkingLocale?: string; // LLM 推理语言，"en" | "zh-CN"（默认 = locale） + replyLocale?: string; // LLM 回复语言，"en" | "zh-CN"（默认 = locale） +}; +``` + +### 配置优先级（与现有一致） + +1. `DEEPCODE_LOCALE` — UI+Prompt 语言 +2. `DEEPCODE_THINKING_LOCALE` — 推理语言（环境变量） +3. `DEEPCODE_REPLY_LOCALE` — 回复语言（环境变量） +4. `./.deepcode/settings.json` 中的 `locale` / `thinkingLocale` / `replyLocale` +5. `~/.deepcode/settings.json` 中的 `locale` / `thinkingLocale` / `replyLocale` +6. 默认：自动检测 `process.env.LANG`，回退到 `"en"` + +### `ResolvedDeepcodingSettings` 新增 + +```typescript +export type ResolvedDeepcodingSettings = { + // ... 现有字段 + locale: Locale; + thinkingLocale: Locale; // 新增 + replyLocale: Locale; // 新增 +}; +``` + +## 5. `/config` 命令 + +### 注册 + +在 `src/ui/slashCommands.ts` 新增命令类型： + +```typescript +export type SlashCommandKind = + | "config" // 新增 + | ...; +``` + +新增内置命令条目： + +```typescript +{ + kind: "config", + name: "config", + label: "/config", + description: "Configure settings: language, model, etc.", +} +``` + +### 命令处理（PromptInput.tsx） + +```typescript +if (item.kind === "config") { + clearSlashToken(); + setShowConfigDropdown(true); // 新增状态 + return; +} +``` + +### ConfigDropdown 组件 + +类似 `ModelsDropdown`，提供以下配置项： + +- **UI Language / 界面语言**: 选择 `en` / `zh-CN`，控制 UI 和 Prompt 模板语言 +- **Thinking Language / 推理语言**: 选择 `en` / `zh-CN`，控制 LLM 推理（`reasoning_content`）语言（默认跟随 UI Language） +- **Reply Language / 回复语言**: 选择 `en` / `zh-CN`，控制 LLM 回复（`content`）语言（默认跟随 UI Language） +- **Model / 模型**: 复用现有 ModelsDropdown 逻辑 +- 未来可扩展：thinking、notification 等 + +### `/config` 参数模式 + +除了交互式 dropdown，也支持一步到位的参数语法： + +``` +/config locale en # 切换 UI 语言为英文 +/config thinkingLocale zh-CN # 设置推理语言为中文 +/config replyLocale en # 设置回复语言为英文 +``` + +在 `PromptInput.tsx` 的 `submitCurrentBuffer()` 中检测 `/config` 开头的精确匹配： + +```typescript +if (/^\/config\s/.test(trimmed)) { + handleConfigCommand(trimmed); + return; +} + +function handleConfigCommand(input: string): void { + const parts = input.split(/\s+/); + const subCmd = parts[1]; + const value = parts[2]; + if (subCmd === "locale" && value) { + applyLocaleChange(value as Locale); + } else if (subCmd === "thinkingLocale" && value) { + applyThinkingLocaleChange(value as Locale); + } else if (subCmd === "replyLocale" && value) { + applyReplyLocaleChange(value as Locale); + } +} +``` + +### 持久化 + +```typescript +function onLocaleChange(locale: Locale): void { + const settings = readSettings() || {}; + settings.locale = locale; + writeSettings(settings); + initI18n(locale); + setStatusMessage(t("config.languageUpdated", { locale })); +} + +function onThinkingLocaleChange(locale: Locale): void { + const settings = readSettings() || {}; + settings.thinkingLocale = locale; + writeSettings(settings); + setStatusMessage(t("config.thinkingLanguageUpdated", { locale })); +} + +function onReplyLocaleChange(locale: Locale): void { + const settings = readSettings() || {}; + settings.replyLocale = locale; + writeSettings(settings); + setStatusMessage(t("config.replyLanguageUpdated", { locale })); +} +``` + +### 动态切换 + +切换 locale 后： +1. `initI18n(newLocale)` 重新加载翻译 JSON +2. Context 中 `locale` 状态变更，所有消费 `useI18n()` 的组件自动重渲染 +3. 由于 Ink `` 不会重渲染已挂载消息，需要： + - 调用 `reloadActiveSessionView()` 重新加载当前会话消息（使用新 locale） + - 对无活跃会话的场景，通过 `setWelcomeNonce(n => n + 1)` 触发 WelcomeScreen 重渲染 +4. 持久化新 locale 到 `settings.json` + +### 行为边界 + +- **中间会话切换 locale**：新消息使用新 locale；已有历史消息保持旧 locale（不会回溯翻译） +- **新会话**：始终使用当前 locale 构建系统提示词和 UI +- **未配置 locale**：默认自动检测 `process.env.LANG`，回退到 `"en"` + +## 6. 各维度 i18n 覆盖清单 + +### 6a. UI 字符串（所有 Ink 组件） + +| 文件 | 需翻译内容 | 翻译 key 前缀 | +|------|-----------|-------------| +| `MessageView/index.tsx` | `"Thinking"`, `"(reasoning...)"`, `"(no content)"`, `"(conversation summary inserted)"`, `"⚡ Loaded skill: {name}"`, `"└ Changes"`, `"└ Plan"`, `"└ Result"`, `"Tool"` | `ui.messageView.` | +| `MessageView/utils.ts` | `renderMessageToStdout` 中的对应字符串 | `ui.messageView.` | +| `PromptInput.tsx` | 所有 `setStatusMessage` 文案、`footerText`、`"Interrupting…"`, `"Attached image from clipboard"`, `"No image found in clipboard"`, `"Reading clipboard..."`, `"Failed to read clipboard"`, `"Cleared attached images"`, `"s attached"`, `"use /skills to edit"`, `"ctrl+o view output"`, `"ctrl+o expand"`, `"ctrl+o collapse"`, `"press ctrl+d again to exit"`, `"press ctrl+d to exit"`, `"wait for the current response or press esc to interrupt"`, `"No paste marker at cursor"`, `"Paste content not found"` | `ui.promptInput.` | +| `App.tsx` | `"No active session to undo."`, `"Model settings unchanged"`, `"Model settings updated: "`, `"Error: "`, status line: `"status: "`, `"tokens: "`, `"fail: "`, `"Interrupted."`, `"Killed processes: "`, `"Failed to kill processes: "`, `"The AI agent has taken several steps..."`, `"OpenAI API key not found..."`, `"Request failed: "`, `"No active session to undo."`, `"Code restore failed: "`, `"Conversation restore failed: "` | `ui.app.` | +| `loadingText.ts` | `"Thinking..."`, `"Thinking... ({elapsed}s) · ↓ {tokens} tokens"` | `ui.loading.` | +| `exitSummary.ts` | `"Goodbye!"`, 表格列头: `"Model Usage"`, `"Reqs"`, `"Input Tokens"`, `"Output Tokens"`, `"Cached Tokens"` | `ui.exitSummary.` | +| `cli.tsx` | 全部 `--help` 输出文本 | `cli.help.` | +| `slashCommands.ts` | 所有 `description` 文案 | `ui.slashCommands.` | +| `WelcomeScreen.tsx` | 快捷键提示（`"Send the prompt"`, `"Insert a newline"`, `"Paste an image"`, `"Interrupt"`, `"Open the skills and commands menu"`, `"Quit"`）、路径显示格式、`"Deep Code"` 标题 | `ui.welcome.` | +| `McpStatusList.tsx` | 视图模式名（`"server-list"`, `"server-detail"`）、状态标签（`"ready"`, `"failed"`, `"connecting"`, `"reconnecting"`）、操作按钮文字 | `ui.mcp.` | +| `AskUserQuestionPrompt.tsx` | 问题提示文案、按钮文字 | `ui.askUserQuestion.` | +| `ProcessStdoutView.tsx` | 标题栏、进程信息、超时调整文案 | `ui.processStdout.` | +| `UpdatePrompt.tsx` | 计划显示文案 | `ui.updatePrompt.` | +| `SessionList.tsx` | 会话列表标题、空状态文案 | `ui.sessionList.` | + +### 6b. Prompt 字符串 + +| 文件 | 需翻译内容 | 策略 | +|------|-----------|------| +| `prompt.ts` | `SYSTEM_PROMPT_BASE`（中文） | 改为加载 `locales/{locale}/system-prompt.md.ejs` 模板 | +| `prompt.ts` | `COMPACT_PROMPT_BASE`（英文） | 同上，改为 locale-specific 模板 | +| `prompt.ts` | `getCurrentDateAndModelPrompt()`（中英文混合） | 使用 `t()` + locale 日期格式化 | +| `prompt.ts` | `getDefaultSkillPrompt()` 中的 `"Use the skill documents below"` | 使用 `t()` | +| `session.ts` | `identifyMatchingSkillNames` 中的英文 prompt | 使用 `t()` 或 locale 模板 | +| `prompt.ts` | 追加两条独立语言指令 | 追加 `t("prompt.thinkingLanguageInstruction")` 和 `t("prompt.replyLanguageInstruction")`，分别控制 LLM 的 reasoning_content 和 content 输出语言 | + +### 6c. Thinking 相关（引导 LLM 推理语言 + UI 标签） + +| 文件 | 内容 | 策略 | +|------|------|------| +| `prompt.ts` | 推理语言指令（引导 LLM 的 `reasoning_content` 语言） | 在 `getSystemPrompt()` 末尾追加 `t("prompt.thinkingLanguageInstruction")`，使用 `thinkingLocale` 对应的翻译 | +| `MessageView/index.tsx` | "Thinking" UI 标签 | `t("ui.messageView.thinking")` | +| `MessageView/utils.ts` | `"(reasoning...)"` UI fallback | `t("ui.messageView.reasoning")` | + +### 6d. Reply 相关（引导 LLM 回复语言 + UI 标签） + +| 文件 | 内容 | 策略 | +|------|------|------| +| `prompt.ts` | 回复语言指令（引导 LLM 的 `content` 语言） | 在 `getSystemPrompt()` 末尾追加 `t("prompt.replyLanguageInstruction")`，使用 `replyLocale` 对应的翻译 | +| `MessageView/index.tsx` | assistant 消息前缀 `✦` | emoji 无需翻译 | +| `session.ts` | "The agent has taken several steps..." 等运行时提示 | 使用 `t()` | + +## 7. 翻译 JSON 示例 + +> 以下展示的是合并后的内容参考（`flattenKeys` 展开前的嵌套结构）。实际存储按 §2 模块文件拆分，每个文件只包含对应模块的键值对，最终由 `loadLocaleDir()` 在运行时合并。 + +### `en/` 合并参考内容（非实际文件布局） + +```json +{ + "ui": { + "messageView": { + "thinking": "Thinking", + "reasoningFallback": "(reasoning...)", + "noContent": "(no content)", + "loadedSkill": "⚡ Loaded skill: {name}", + "conversationSummaryInserted": "(conversation summary inserted)", + "changes": "└ Changes", + "plan": "└ Plan", + "result": "└ Result", + "toolName": "Tool" + }, + "promptInput": { + "interrupting": "Interrupting…", + "imageAttached": "Attached image from clipboard", + "noImageFound": "No image found in clipboard", + "readingClipboard": "Reading clipboard...", + "failedClipboard": "Failed to read clipboard", + "clearedImages": "Cleared attached images", + "waitForResponse": "wait for the current response or press esc to interrupt", + "pressCtrlDExit": "press ctrl+d to exit", + "pressCtrlDAgain": "press ctrl+d again to exit", + "footer": "enter send · shift+enter newline · @ files · ctrl+v image · / commands · ctrl+d exit", + "footerBusy": "esc to interrupt · ctrl+c to cancel input", + "ctrlOViewOutput": " · ctrl+o view output", + "ctrlOExpand": " · ctrl+o expand", + "ctrlOCollapse": " · ctrl+o collapse", + "noPasteMarker": "No paste marker at cursor", + "pasteNotFound": "Paste content not found", + "imageCount": "📎 {count} image{count,plural,=1{} other{s}} attached" + }, + "loading": { + "thinking": "Thinking...", + "thinkingElapsed": "Thinking... ({elapsed}s) · ↓ {tokens} tokens" + }, + "app": { + "error": "Error: {message}", + "statusStatus": "status: {status}", + "statusTokens": "tokens: {tokens}", + "statusFail": "fail: {reason}", + "interrupted": "Interrupted.", + "killedProcesses": "Killed processes: {pids}", + "failedKillProcesses": "Failed to kill processes: {pids}", + "modelUnchanged": "Model settings unchanged", + "modelUpdated": "Model settings updated: {before} → {after}", + "noActiveSession": "No active session to undo.", + "codeRestoreFailed": "Code restore failed: {error}", + "conversationRestoreFailed": "Conversation restore failed: {error}", + "sessionDefaultSummary": "[Image Prompt]", + "sessionAgentSteps": "The AI agent has taken several steps but hasn't reached a conclusion yet. Do you want to continue?", + "apiKeyNotFound": "OpenAI API key not found. Please configure ~/.deepcode/settings.json or ./.deepcode/settings.json.", + "requestFailed": "Request failed: {error}" + }, + "exitSummary": { + "goodbye": "Goodbye!", + "modelUsage": "Model Usage", + "reqs": "Reqs", + "inputTokens": "Input Tokens", + "outputTokens": "Output Tokens", + "cachedTokens": "Cached Tokens" + }, + "config": { + "title": "Configuration", + "language": "Language", + "languageUpdated": "Language updated to {locale}", + "thinkingLanguageUpdated": "Thinking language updated to {locale}", + "replyLanguageUpdated": "Reply language updated to {locale}" + } + }, + "session": { + "compacting": "The conversation is getting long, compacting...", + "skillPromptHeader": "Use the skill document below to assist the user:\n" + }, + "prompt": { + "skillDocumentsHeader": "Use the skill documents below to assist the user:\n", + "dateAndModel": "Today is {date}. As the conversation progresses, time passes.\nCurrent LLM model is {model}. You can switch models using the /model command.", + "thinkingLanguageInstruction": "IMPORTANT: Your reasoning and thinking process should be in English.", + "replyLanguageInstruction": "IMPORTANT: Always respond to the user in English." + } +} +``` + +### `zh-CN/` 合并参考内容（非实际文件布局） + +```json +{ + "ui": { + "messageView": { + "thinking": "思考", + "reasoningFallback": "(推理中...)", + "noContent": "(无内容)", + "loadedSkill": "⚡ 已加载技能：{name}", + "conversationSummaryInserted": "(已插入对话摘要)", + "changes": "└ 变更", + "plan": "└ 计划", + "result": "└ 结果", + "toolName": "工具" + }, + "promptInput": { + "interrupting": "正在中断…", + "imageAttached": "已从剪贴板粘贴图片", + "noImageFound": "剪贴板中没有图片", + "readingClipboard": "正在读取剪贴板...", + "failedClipboard": "读取剪贴板失败", + "clearedImages": "已清除粘贴的图片", + "waitForResponse": "请等待当前响应完成，或按 esc 中断", + "pressCtrlDExit": "按 ctrl+d 退出", + "pressCtrlDAgain": "再按一次 ctrl+d 退出", + "footer": "回车发送 · shift+回车换行 · @ 文件 · ctrl+v 图片 · / 命令 · ctrl+d 退出", + "footerBusy": "esc 中断 · ctrl+c 取消输入", + "ctrlOViewOutput": " · ctrl+o 查看输出", + "ctrlOExpand": " · ctrl+o 展开", + "ctrlOCollapse": " · ctrl+o 折叠", + "noPasteMarker": "光标位置没有粘贴标记", + "pasteNotFound": "找不到粘贴内容", + "imageCount": "📎 {count} 张图片已粘贴" + }, + "loading": { + "thinking": "思考中...", + "thinkingElapsed": "思考中... ({elapsed}秒) · ↓ {tokens} tokens" + }, + "app": { + "error": "错误：{message}", + "statusStatus": "状态：{status}", + "statusTokens": "token 数：{tokens}", + "statusFail": "失败原因：{reason}", + "interrupted": "已中断。", + "killedProcesses": "已终止进程：{pids}", + "failedKillProcesses": "终止进程失败：{pids}", + "modelUnchanged": "模型设置未变更", + "modelUpdated": "模型设置已更新：{before} → {after}", + "noActiveSession": "没有活跃会话可供撤销。", + "codeRestoreFailed": "代码恢复失败：{error}", + "conversationRestoreFailed": "对话恢复失败：{error}", + "sessionDefaultSummary": "[图片提示]", + "sessionAgentSteps": "AI 助手已执行多个步骤但未得出结论。是否继续？", + "apiKeyNotFound": "未找到 OpenAI API key。请配置 ~/.deepcode/settings.json 或 ./.deepcode/settings.json。", + "requestFailed": "请求失败：{error}" + }, + "exitSummary": { + "goodbye": "再见！", + "modelUsage": "模型用量", + "reqs": "请求数", + "inputTokens": "输入 Tokens", + "outputTokens": "输出 Tokens", + "cachedTokens": "缓存 Tokens" + }, + "config": { + "title": "设置", + "language": "语言", + "languageUpdated": "语言已切换为 {locale}" + } + }, + "session": { + "compacting": "对话内容较长，正在压缩...", + "skillPromptHeader": "使用以下技能文档来协助用户：\n" + }, + "prompt": { + "skillDocumentsHeader": "使用以下技能文档来协助用户：\n", + "dateAndModel": "今天是{date}。随着对话的进行，时间在流逝。\n当前 LLM 模型为{model}，可通过 /model 命令切换模型。", + "thinkingLanguageInstruction": "重要：你的推理和思考过程请使用中文。", + "replyLanguageInstruction": "重要：请始终使用中文回复用户。" + } +} +``` + +## 8. 修改文件清单 + +| 文件 | 修改类型 | 说明 | +|------|---------|------| +| `src/common/i18n.ts` | **新增** | i18n 核心模块 | +| `locales/en/` (16 个模块文件) | **新增** | 按模块拆分的英文翻译 | +| `locales/zh-CN/` (16 个模块文件) | **新增** | 中文翻译（镜像 en/ 结构） | +| `src/ui/components/ConfigDropdown.tsx` | **新增** | /config 命令 UI | +| `src/settings.ts` | 修改 | 增加 `locale` 字段解析 | +| `src/ui/slashCommands.ts` | 修改 | 增加 `config` 命令类型 | +| `src/ui/PromptInput.tsx` | 修改 | 增加 ConfigDropdown 渲染和 `setShowConfigDropdown` 状态；UI 字符串改用 `t()` | +| `src/ui/App.tsx` | 修改 | UI 字符串改用 `t()`；处理 ConfigDropdown 传来的 locale 变更事件（强制重渲染） | +| `src/ui/components/MessageView/index.tsx` | 修改 | UI 字符串改用 `t()` | +| `src/ui/components/MessageView/utils.ts` | 修改 | UI 字符串改用 `t()` | +| `src/ui/loadingText.ts` | 修改 | UI 字符串改用 `t()` | +| `src/ui/exitSummary.ts` | 修改 | UI 字符串改用 `t()` | +| `src/cli.tsx` | 修改 | 初始化时调用 `initI18n()`；帮助文本改用翻译 | +| `src/prompt.ts` | 修改 | `SYSTEM_PROMPT_BASE`、`COMPACT_PROMPT_BASE`、`getCurrentDateAndModelPrompt()` 改用翻译 | +| `src/session.ts` | 修改 | 硬编码提示字符串改用 `t()` | + +## 9. 分阶段实施 + +### Phase 1：基础设施（建议 PR 1） +1. 创建 `src/common/i18n.ts` — i18n 核心（initI18n, t, resetI18n, Locale, TranslationKey） + - `loadLocaleDir` 使用 `typeof __dirname !== "undefined" ? path.resolve(__dirname, "..") : fileURLToPath(import.meta.url)` fallback +2. 创建 `locales/en/` 和 `locales/zh-CN/` 目录及 16 个模块 JSON 占位文件 +3. 修改 `src/settings.ts` — 添加 locale 解析（`DEEPCODE_LOCALE` + settings.json） +4. 创建 `src/ui/contexts/i18n.tsx` — I18nContext, I18nProvider, useI18n +5. 修改 `src/cli.tsx` — 启动时初始化 i18n +6. 启用 `tsconfig.json` 的 `resolveJsonModule` +7. 创建 `scripts/check-i18n.mjs` — `npm run check:i18n` 脚本 +- **验证**: + - `initI18n("en")` + `t("ui.loading.thinking")` → `"Thinking..."` + - `initI18n("zh-CN")` + `t("ui.loading.thinking")` → `"思考中..."` + - `t("non.existent.key")` → `"non.existent.key"`（key 自身） + - missing `locales/zh-CN/` 目录 → 静默降级到 en/ + - `npm run check` 通过 +- **回滚**: 删除 `src/common/i18n.ts`、`locales/`、`src/ui/contexts/i18n.tsx`，恢复 `settings.ts`、`cli.tsx` 的修改，移除 `resolveJsonModule` + +### Phase 2：UI 字符串替换（建议 PR 2） + +7. 逐个修改各 UI 组件，替换字符串为 `t()` 调用 + - `MessageView/index.tsx` + `utils.ts` + - `PromptInput.tsx` + - `App.tsx` + - `loadingText.ts`, `exitSummary.ts` + - `cli.tsx`（--help） + - `WelcomeScreen.tsx`, `McpStatusList.tsx`, `SessionList.tsx` + - `AskUserQuestionPrompt.tsx`, `ProcessStdoutView.tsx`, `UpdatePrompt.tsx` +8. 所有测试需包装 `I18nProvider` 或 mock `t()` +- **验证**: 切换 locale 时 UI 文字立即变化 + +### Phase 3：Prompt 模板 + 语言指令（建议 PR 3） +9. 修改 `src/prompt.ts`： + - `getSystemPrompt()` / `getCompactPrompt()` 内部调用 `getLocale()` 选择对应 locale 的 EJS 模板（不改变外部签名） + - `getSystemPrompt()` 末尾追加两条独立语言指令： + - `t("prompt.thinkingLanguageInstruction")` — 使用 `thinkingLocale`，引导 LLM 的 `reasoning_content` 语言 + - `t("prompt.replyLanguageInstruction")` — 使用 `replyLocale`，引导 LLM 的 `content` 语言 + - `getCurrentDateAndModelPrompt()` 使用 `t("prompt.dateAndModel")` + locale 日期格式化 + - `getDefaultSkillPrompt()` 使用 `t("prompt.skillDocumentsHeader")` +10. 创建 `templates/prompts/system-prompt.zh-CN.md.ejs` 和 `system-prompt.en.md.ejs` +11. 创建 `templates/prompts/compact-prompt.zh-CN.md.ejs` 和 `compact-prompt.en.md.ejs` +12. 修改 `src/session.ts` — 通过 `SessionManagerOptions.t`（类型为 `TranslationKey`）注入翻译，替换硬编码字符串 +- **验证**: 新会话系统提示词末尾包含两条独立语言指令；`thinkingLocale=zh-CN, replyLocale=en` 时推理用中文回复用英文 + +### Phase 4：/config 命令（建议 PR 4） +13. 修改 `src/ui/slashCommands.ts` — 注册 `config` 命令类型 +14. 创建 `ConfigDropdown.tsx` — /config 命令 UI（语言切换 dropdown） +15. 修改 `PromptInput.tsx` — 集成 ConfigDropdown + `/config locale en` 参数模式 +16. 修改 `App.tsx` — locale 变更处理（刷新消息列表 + 欢迎屏） +- **验证**: `/config` 打开 dropdown、`/config locale zh-CN` 一键切换 + +## 10. 分开配置可行性分析 + +### 核心挑战：`t()` 需要跨 locale 翻译 + +UI 字符串始终使用 `currentLocale` 翻译。但生成系统提示词的语言指令时，`thinkingLocale` 可能不同于 `currentLocale`。 + +``` +举例：locale=zh-CN, thinkingLocale=en + t("prompt.thinkingLanguageInstruction") + → 需要返回英文版 "Your reasoning should be in English." + → 但 t() 默认从 zh-CN.json 查找 → 会返回 "重要：你的推理..." + → ✗ 错误！ +``` + +### 解决方案：`t()` 增加 locale 覆盖参数 + +```typescript +export function t( + key: TranslationKey, + params?: Record, + localeOverride?: Locale // 新增：指定读取哪个 locale 的翻译 +): string; +``` + +实现逻辑： + +``` +1. targetLocale = localeOverride ?? currentLocale +2. 从 targetLocale 的 messages 查找 +3. 找不到则回退到 en/ 目录 +4. 仍然找不到则返回 key 自身 +``` + +调用方式： + +```typescript +// prompt.ts — 生成系统提示词时使用指定 locale 的翻译 +const thinkingInstruction = t("prompt.thinkingLanguageInstruction", undefined, thinkingLocale); +const replyInstruction = t("prompt.replyLanguageInstruction", undefined, replyLocale); +``` + +### 全局状态管理 + +`i18n.ts` 中存储三个独立 locale 值： + +```typescript +// src/common/i18n.ts +let currentLocale: Locale = "en"; +let thinkingLocale: Locale = "en"; +let replyLocale: Locale = "en"; + +export function initI18n(locale: Locale, options?: { thinkingLocale?: Locale; replyLocale?: Locale }): void { + currentLocale = locale; + // 选项中的 thinking/reply locale 优先级最高，未设置则跟随 locale + thinkingLocale = options?.thinkingLocale ?? locale; + replyLocale = options?.replyLocale ?? locale; + // 加载对应的 locale JSON... +} + +export function getThinkingLocale(): Locale { return thinkingLocale; } +export function getReplyLocale(): Locale { return replyLocale; } +export function setThinkingLocale(locale: Locale): void { thinkingLocale = locale; } +export function setReplyLocale(locale: Locale): void { replyLocale = locale; } +``` + +### React Context 扩展 + +```typescript +type I18nContextValue = { + t: typeof t; + locale: Locale; + setLocale: (locale: Locale) => void; + thinkingLocale: Locale; + replyLocale: Locale; + setThinkingLocale: (locale: Locale) => void; + setReplyLocale: (locale: Locale) => void; +}; +``` + +### Settings 解析链 + +在 `resolveSettingsSources()` 中增加两个新字段： + +```typescript +const thinkingLocale = + trimString(systemEnv.THINKING_LOCALE) || + trimString(projectSettings?.thinkingLocale) || + trimString(userSettings?.thinkingLocale) || + locale; // 默认跟随主locale + +const replyLocale = + trimString(systemEnv.REPLY_LOCALE) || + trimString(projectSettings?.replyLocale) || + trimString(userSettings?.replyLocale) || + locale; // 默认跟随主locale +``` + +### prompt.ts 生成系统提示词的完整流程 + +```typescript +function getSystemPrompt(projectRoot: string, options: PromptToolOptions = {}): string { + const locale = getLocale(); + const tLocale = getThinkingLocale(); + const rLocale = getReplyLocale(); + + // 1. 根据 locale 选择系统提示词模板 + const basePrompt = loadSystemPromptTemplate(locale); + + // 2. 追加工具描述（保持英文） + const toolDocs = readToolDocs(getExtensionRoot(), options); + + // 3. 追加两条独立语言指令（使用各自的 locale） + const thinkingInstr = t("prompt.thinkingLanguageInstruction", undefined, tLocale); + const replyInstr = t("prompt.replyLanguageInstruction", undefined, rLocale); + + return `${basePrompt}\n\n${toolDocs}\n\n${thinkingInstr}\n${replyInstr}`; +} +``` + +### 技术风险与缓解 + +| 风险 | 影响 | 缓解措施 | +|------|------|---------| +| `t()` 第三个参数因疏忽未传递，导致从主 locale 获取翻译 | 语言指令语言错误，LLM 输出错乱 | 添加 TypeScript 类型约束：`getSystemPrompt()` 内部强制类型检查；添加单元测试覆盖 thinkingLocale≠locale 的场景 | +| 多 locale JSON 重复加载（切换 locale 时每次加载两份 JSON） | 轻度性能开销，IO 增加约 2x | 添加 `preloadLocale(locale)` 缓存；切换时检查是否已加载 | +| 用户配置 thinkingLocale="ja"（不支持的 locale） | 静默回退到 en/，指令为英文 | 在 `resolveSettings()` 中校验，无效值回退到 `locale` | +| ConfigDropdown 三个 dropdown 让用户困惑 | UX 复杂度过高 | UI 默认折叠为 "Advanced" 区域，仅显示 "UI Language"；展开后显示 Thinking/Reply 选项 | +| 中间会话切换 thinkingLocale | 已有系统提示词中的指令仍为旧语言 | 在 `setThinkingLocale()` 时向活跃会话插入一条新 system message 更新指令 | + +### 最终结论 + +该方案**技术上完全可行**，核心改动点在： + +``` +i18n.ts — t() 增加 localeOverride 参数 + 三个全局 locale 状态 +settings.ts — 解析 thinkingLocale/replyLocale（回退链到 locale） +prompt.ts — getSystemPrompt() 使用两条独立 locale 语言指令 +I18nContext — 新增三个字段（状态 + setter） +ConfigDropdown — 三项语言选择（UI/Thinking/Reply） +App.tsx — 三个回调处理 locale 变更 +``` + +估计代码量：`+200 行`（相比单 locale 方案约增加 30% 的 i18n 基础设施代码）。 + +## 11. 注意事项 + +1. **esbuild 打包**: locale JSON 通过 `package.json` `files` 字段发布，运行时通过 `__dirname` + `getExtensionRoot()` 读取。不静态 import，避免 esbuild 打包成 JS。 +2. **Ink 重渲染**: 使用 React Context（`I18nProvider`）而非 `key={locale}` remount。Context value 变化时消费 `useI18n()` 的组件自动重渲染。Ink `` 中的历史消息通过 `reloadActiveSessionView()` 刷新。 +3. **LLM 输出语言控制**：LLM 生成的 `content`（回复）和 `reasoning_content`（推理）本身**不翻译**，而是通过系统提示词中的两条独立语言指令控制：`t("prompt.thinkingLanguageInstruction")` 使用 `thinkingLocale`，`t("prompt.replyLanguageInstruction")` 使用 `replyLocale`。两者默认都跟随主 `locale`。不翻译的部分：文件路径、工具参数中的路径和命令、JSON/代码片段。 +4. **向后兼容**: 未设置 locale 时自动检测 `process.env.LANG`，回退到 `\"en\"`。所有 `t()` 调用对缺失 key 先回退到 en/ 目录，再回退到 key 本身。 +5. **测试**: `t()` 在未初始化时返回 key 本身。`resetI18n()` 用于测试间重置状态。单元测试需调用 `initI18n("en")` 或在测试文件顶部 mock。 +6. **CJK 字符宽度**: `exitSummary.ts` 的 `visibleLength()` 未考虑中文字符在终端中的双倍宽度。这是现有 bug，zh-CN 场景会更明显，建议单独修复。 +7. **翻译 key 完整性**: `TranslationKey` union type 与 `locales/en/` 下所有 JSON 文件中的 key 需保持一致。建议 CI 中运行 `npm run check:i18n` 校验所有模块文件。 +8. **中间会话语言切换**: 只有新 UI 组件渲染和新会话提示词会用新 locale。已有历史消息保持原样，这是预期行为。 + +## 12. 翻译进度追踪 + +### 模块文件状态表 + +| 状态 | 含义 | +|------|------| +| 🔴 待创建 | 文件尚未创建 | +| 🟡 翻译中 | en 版本完成，zh-CN 版本部分完成 | +| 🟢 已完成 | en + zh-CN 版本均完成 | + +| 文件名 | en | zh-CN | Phase | 对应代码文件 | +|--------|----|-------|-------|-------------| +| `ui-message-view.json` | 🔴 | 🔴 | Phase 2 | MessageView/index.tsx, utils.ts | +| `ui-prompt-input.json` | 🔴 | 🔴 | Phase 2 | PromptInput.tsx | +| `ui-app.json` | 🔴 | 🔴 | Phase 2 | App.tsx | +| `ui-loading.json` | 🔴 | 🔴 | Phase 2 | loadingText.ts | +| `ui-exit-summary.json` | 🔴 | 🔴 | Phase 2 | exitSummary.ts | +| `ui-welcome.json` | 🔴 | 🔴 | Phase 2 | WelcomeScreen.tsx | +| `ui-mcp.json` | 🔴 | 🔴 | Phase 2 | McpStatusList.tsx | +| `ui-slash-commands.json` | 🔴 | 🔴 | Phase 2 | slashCommands.ts | +| `ui-session-list.json` | 🔴 | 🔴 | Phase 2 | SessionList.tsx | +| `ui-ask-question.json` | 🔴 | 🔴 | Phase 2 | AskUserQuestionPrompt.tsx | +| `ui-process-stdout.json` | 🔴 | 🔴 | Phase 2 | ProcessStdoutView.tsx | +| `ui-update-prompt.json` | 🔴 | 🔴 | Phase 2 | UpdatePrompt.tsx | +| `cli-help.json` | 🔴 | 🔴 | Phase 2 | cli.tsx | +| `ui-config.json` | 🟢 | 🟢 | Phase 4 | ConfigDropdown.tsx | ✅ | +| `session.json` | 🟢 | 🟢 | Phase 3 | session.ts | ✅ | +| `prompt.json` | 🟢 | 🟢 | Phase 3 | prompt.ts | ✅ | + +### 进度更新方式 + +每次提交 PR 时： +1. 创建/更新对应模块的 `en/{module}.json` 和 `zh-CN/{module}.json` +2. 在 `.deepcode/i18n-todo.md` 中勾选对应任务 +3. 更新本进度表的状态标记 +4. 运行 `npm run check:i18n` 验证 key 一致性 + +> **当前状态**：全部 4 个 Phase 已完成，所有 16 个模块的翻译 🟢 完成（140 keys） + +## 13. 性能影响分析 + +### 分析范围 + +覆盖 i18n 改造对以下维度的性能影响：启动时间、运行时 `t()` 调用、React 渲染、内存占用、热路径、打包体积。 + +### 13.1 启动时间 + +| 阶段 | 改造前 | 改造后 | 增量 | +|------|--------|--------|------| +| CLI 初始化 | 无 locale 加载 | `initI18n()` 读取 16 个 JSON 文件 + 展平合并 | **+3~5ms** | +| 首次渲染 | 无 | 消费 `useI18n()` 的组件首次通过 context 获取 `t` | **可忽略** | + +**多文件加载分析**： +- 16 个 JSON 文件，每个 ~0.5~3KB，总计 ~30KB +- `fs.readdirSync` → 扫描目录（~0.1ms） +- 16 × `fs.readFileSync` → 读取文件（~16 × 0.1ms = ~1.6ms） +- `JSON.parse` × 16 → 解析 JSON（~16 × 0.05ms = ~0.8ms） +- `flattenKeys()` → 展平嵌套结构（~0.3ms） +- **合计约 3ms**，在 CLI 启动的 ~500ms 总耗时中占比 < 1% + +**对比合并 en.json vs 多文件**：单文件 `JSON.parse` 一个 30KB 文件约 0.8ms，多文件方案多 ~2ms 的 fs 开销。**可接受**。 + +**优化建议**：添加 `localeCache = Map>()`，`initI18n()` 时先检查缓存。切换回已加载过的 locale 时零 IO。 + +### 13.2 运行时 `t()` 调用开销 + +`t()` 函数实现： + +```typescript +function t(key: TranslationKey, params?, localeOverride?): string { + const targetLang = localeOverride ?? currentLocale; + const msg = messagesMap.get(targetLang)?.get(key) // O(1) Map lookup + ?? messagesMap.get("en")?.get(key) // fallback + ?? key; // key itself + return params ? interpolate(msg, params) : msg; // regex replace +} +``` + +| 操作 | 耗时 | +|------|------| +| 无 params 调用（Map 查找） | **~0.001ms** | +| 带 params 调用（+ regex replace） | **~0.003ms** | + +**对比硬编码字符串**：硬编码字符串的引用是编译期确定的，零运行时开销。`t()` 每次调用需要一次 Map 查找，但 ~0.001ms 在交互式 CLI 中**完全不可感知**。 + +### 13.3 React 渲染影响 + +| 组件 | `t()` 调用位置 | 调用频率 | 影响 | +|------|--------------|---------|------| +| `MessageView` | `useI18n()` 获取 `t`，渲染标签 | 每消息 1 次（`` 渲染一次） | 无 | +| `PromptInput` | `useI18n()` 获取 `t`，footerText | 每次键盘输入重渲染 | 毫秒级字符串替换，无感知 | +| `App.tsx` | `useI18n()` 获取 `t`，状态行 | 会话状态变化时 | 低频，无影响 | +| `loadingText.ts` | import 全局 `t()` | 每 500ms tick | Map 查找，< 0.01ms/tick | +| `exitSummary.ts` | import 全局 `t()` | 退出时 1 次 | 无 | + +**关键热路径分析 — `loadingText.ts`**： + +``` +改造前: return "Thinking..." +改造后: return t("ui.loading.thinking") +``` + +每 500ms 被调用一次（`App.tsx` 中的 `setInterval`），额外开销 **0.001ms/次**。运行 1 小时（7200 次调用）累计 **7.2ms**。**可忽略**。 + +**关键热路径分析 — `PromptInput`**： + +`footerText` 是 `useMemo` 计算的值，当 `statusMessage`、`busy`、`loadingText`、`processOrPasteHint` 变化时才重新计算。每次用户输入触发组件重渲染，但 `footerText` 的依赖未变时不会重新计算 `t()`。 + +``` +改造前: `enter send · shift+enter newline · @ files · ctrl+v image · / commands · ctrl+d exit` +改造后: t("ui.promptInput.footer") + t("ui.promptInput.ctrlOViewOutput") +``` + +`t()` 调用在 `useMemo` 内部，仅在依赖变化时计算。**无额外重渲染开销**。 + +### 13.4 内存占用 + +| 数据 | 大小 | 说明 | +|------|------|------| +| en/ 下 16 个 JSON | ~16KB | `loadLocaleDir("en")` 加载后留在内存 | +| zh-CN/ 下 16 个 JSON | ~16KB | 仅当 locale=zh-CN 时加载 | +| en fallback | ~16KB | 始终在内存中作为回退 | +| **合计** | **~32-48KB** | 两个 `Record` 对象 | + +**当前 CLI 基线内存**：Node.js 进程 ~50MB。i18n 增加 **< 0.1%**。**可忽略**。 + +### 13.5 打包体积 + +| 文件 | 大小 | +|------|------| +| `locales/en/` 16 个 JSON | ~16KB | +| `locales/zh-CN/` 16 个 JSON | ~16KB | +| **合计** | **~30KB** | + +这些文件通过 `package.json` `files` 字段分发，运行时由 `fs.readFileSync` 加载，**不被打入 esbuild bundle**（因为 `--packages=external` 且不是 `import` 而是 `fs.readFileSync`）。对 `dist/cli.js` 体积 **零影响**。 + +### 13.6 `t()` 带 `localeOverride` 的性能 + +```typescript +t("prompt.thinkingLanguageInstruction", undefined, "en") // 指定从 en 取翻译 +``` + +相比无 override 的 `t()` 调用，多一次 `localeOverride ?? currentLocale` 三元运算（~0.0001ms）。**可忽略**。 + +只在 `getSystemPrompt()` 每次创建会话时调用两次，属于低频路径。 + +### 13.7 Locale 切换性能 + +切换 locale 时： + +| 步骤 | 耗时 | +|------|------| +| `initI18n(newLocale)` 读取 ~15 JSON | ~3ms | +| `setLocaleState(newLocale)` 触发 context 更新 | React 同步 | +| `reloadActiveSessionView()` 刷新消息 | ~5ms（加载 JSONL + 渲染） | +| **合计** | **~8-10ms** | + +用户无感知（终端 UI 不需要 60fps）。 + +### 13.8 综合结论 + +| 指标 | 影响 | 评级 | +|------|------|------| +| 启动时间 | +3~5ms | 🟢 无影响 | +| 运行时 `t()` | ~0.001ms/次 | 🟢 无影响 | +| React 重渲染 | 仅 locale 切换时触发 | 🟢 无影响 | +| 内存 | +30~45KB | 🟢 可忽略 | +| 打包体积 | +0KB（不打包进 JS） | 🟢 无影响 | +| 磁盘分发 | +30KB JSON | 🟢 可忽略 | +| 热路径 (500ms tick) | +0.001ms/tick | 🟢 无影响 | + +**最终结论**：i18n 改造对性能的影响**极小**，所有维度均在可忽略范围内。无需特殊优化措施。建议仅在 `loadLocaleDir` 中添加 `Map` 缓存避免重复 IO，其他不做额外优化。 diff --git a/.deepcode/i18n-todo.md b/.deepcode/i18n-todo.md new file mode 100644 index 0000000..953e6eb --- /dev/null +++ b/.deepcode/i18n-todo.md @@ -0,0 +1,510 @@ +# i18n 支持 — TODO 任务清单 & 进度追踪 + +> 完整方案见 `.deepcode/i18n-plan.md` +> 开发技能见 `.agents/skills/i18n-development/SKILL.md` + +> **关键约定**：UI 中 Thinking/Reply 的标签文字（"思考" / "Thinking"）**始终跟随主 `locale`**，与 `thinkingLocale`/`replyLocale` 无关。后两者仅控制 LLM 输出语言（通过系统提示词指令）。 + +## 翻译进度总览 + +| 状态 | 含义 | +|------|------| +| 🔴 待创建 | 文件尚未创建 | +| 🟡 翻译中 | en 版本完成，zh-CN 版本部分完成 | +| 🟢 已完成 | en + zh-CN 版本均完成 | + +| 模块文件 | en | zh-CN | Phase | 代码文件 | 状态 | +|---------|----|-------|-------|---------|------| +| `ui-message-view.json` | 🟢 | 🟢 | Phase 2 | MessageView | ✅ 完成 | +| `ui-prompt-input.json` | 🟢 | 🟢 | Phase 2 | PromptInput | ✅ 完成 | +| `ui-app.json` | 🟢 | 🟢 | Phase 2 | App.tsx | ✅ 完成 | +| `ui-loading.json` | 🟢 | 🟢 | Phase 2 | loadingText.ts | ✅ 完成 | +| `ui-exit-summary.json` | 🟢 | 🟢 | Phase 2 | exitSummary.ts | ✅ 完成 | +| `ui-welcome.json` | 🟢 | 🟢 | Phase 2 | WelcomeScreen | ✅ 完成 | +| `ui-mcp.json` | 🟢 | 🟢 | Phase 2 | McpStatusList | ✅ 完成 | +| `ui-slash-commands.json` | 🟢 | 🟢 | Phase 2 | slashCommands.ts | ✅ 完成 | +| `ui-session-list.json` | 🟢 | 🟢 | Phase 2 | SessionList | ✅ 完成 | +| `ui-ask-question.json` | 🟢 | 🟢 | Phase 2 | AskUserQuestionPrompt | ✅ 完成 | +| `ui-process-stdout.json` | 🟢 | 🟢 | Phase 2 | ProcessStdoutView | ✅ 完成 | +| `ui-update-prompt.json` | 🟢 | 🟢 | Phase 2 | UpdatePrompt | ✅ 完成 | +| `session.json` | 🟢 | 🟢 | Phase 3 | session.ts | ✅ 完成 | +| `prompt.json` | 🟢 | 🟢 | Phase 3 | prompt.ts | ✅ 完成 | +| `ui-config.json` | 🟢 | 🟢 | Phase 4 | ConfigDropdown | ✅ 完成 | +| `cli.tsx` (help text) | 🟢 | 🟢 | Phase 2 | cli.tsx | ✅ 完成 | + +--- + +## Phase 1：基础设施（PR 1） + +### 文件 +- `src/common/i18n.ts`（新增） +- `locales/en/` 目录结构 +- `locales/zh-CN/` 目录结构 +- `src/ui/contexts/i18n.tsx`（新增） +- `src/settings.ts`（修改） +- `src/cli.tsx`（修改） +- `scripts/check-i18n.mjs`（新增） + +### 任务 + +- [x] 创建 `src/common/i18n.ts` + - 导出 `Locale`、`TranslationKey`（`import type enMessages from "../../locales/en/..."`） + - 实现 `initI18n()` — 读取 `locales/{locale}/` 目录下所有 `*.json`，展平合并 + - 实现 `t(key, params?, localeOverride?)` — 支持跨 locale 翻译 + - 实现 `loadLocaleDir()` + `flattenKeys()` — 多文件合并加载 + - 实现 `resetI18n()` — 测试用重置 + - 存储 `currentLocale` / `thinkingLocale` / `replyLocale` 三个全局状态 + - 导出 `getThinkingLocale()` / `getReplyLocale()` / `setThinkingLocale()` / `setReplyLocale()` +- [x] 创建 `locales/en/` 目录和空的模块占位 JSON 文件 +- [x] 创建 `locales/zh-CN/` 目录（镜像 en/ 结构） +- [x] 启用 `tsconfig.json` 的 `resolveJsonModule` +- [x] 创建 `scripts/check-i18n.mjs` + `npm run check:i18n` — 校验 `en/` 下所有文件 key 一致 +- [x] 修改 `src/settings.ts` + - `DeepcodingSettings` 增加 `locale?` / `thinkingLocale?` / `replyLocale?` + - `ResolvedDeepcodingSettings` 增加对应三个解析字段 + - 环境变量支持：`DEEPCODE_LOCALE` / `DEEPCODE_THINKING_LOCALE` / `DEEPCODE_REPLY_LOCALE` +- [x] 创建 `src/ui/contexts/i18n.tsx` + - `I18nProvider` 包裹 App 根节点 + - 扩展 context value：`{ t, locale, setLocale, thinkingLocale, replyLocale, setThinkingLocale, setReplyLocale }` + - `useI18n()` hook +- [x] 修改 `src/cli.tsx`：启动时 `initI18n(settings.locale, { thinkingLocale, replyLocale })` +- [x] 更新 `package.json` `files` 字段：添加 `"locales/**"` +- **验证**: + - `initI18n("en")` → `loadLocaleDir("en")` 正确合并所有模块文件 + - `t("ui.loading.thinking")` → `"Thinking..."` + - `t("prompt.thinkingLanguageInstruction", undefined, "en")` → 英文指令 + - 缺失 key 返回 key 自身；目录缺失静默降级 +- **回滚**: 删除新增文件 + 恢复 `settings.ts`/`cli.tsx` + 移除 `resolveJsonModule` + +--- + +## Phase 2：UI 字符串替换（PR 2） + +### 模块 2-1：MessageView + +**文件**: `locales/{lang}/ui-message-view.json` | `MessageView/index.tsx` + `utils.ts` + +- [x] 创建 `en/ui-message-view.json`（9 keys） +- [x] 创建 `zh-CN/ui-message-view.json` +- [x] `MessageView/index.tsx` — 使用 `useI18n()` 的 `t()` 替换 "Thinking" → `t("ui.messageView.thinking")`、"(reasoning...)"、"(no content)"、"(conversation summary inserted)"、"Loaded skill"、"Changes/Plan/Result"、"Tool" +- [x] `MessageView/utils.ts` — 直接 import 全局 `t()` 替换 `renderMessageToStdout` 中的字符串 + +### 模块 2-2：PromptInput + +**文件**: `locales/{lang}/ui-prompt-input.json` | `PromptInput.tsx` + +- [x] 创建 `en/ui-prompt-input.json`（~20 keys） +- [x] 创建 `zh-CN/ui-prompt-input.json` +- [x] 使用 `useI18n()` 的 `t()` 替换 footer、setStatusMessage、粘贴提示等 ~20 处字符串 + +### 模块 2-3：App + +**文件**: `locales/{lang}/ui-app.json` | `App.tsx` + +- [x] 创建 `en/ui-app.json`（~15 keys） +- [x] 创建 `zh-CN/ui-app.json` +- [x] 使用 `useI18n()` 的 `t()` 替换 Error:、Interrupted.、Killed processes、Model settings、session 提示等 + +### 模块 2-4：loadingText + +**文件**: `locales/{lang}/ui-loading.json` | `loadingText.ts` + +- [x] 创建 `en/ui-loading.json`（2 keys） +- [x] 创建 `zh-CN/ui-loading.json` +- [x] import 全局 `t()` 替换 "Thinking..."、"Thinking... ({elapsed}s)" + +### 模块 2-5：exitSummary + +**文件**: `locales/{lang}/ui-exit-summary.json` | `exitSummary.ts` + +- [x] 创建 `en/ui-exit-summary.json`（6 keys） +- [x] 创建 `zh-CN/ui-exit-summary.json` +- [x] import 全局 `t()` 替换 "Goodbye!"、表格列头 + +### 模块 2-6：WelcomeScreen + +**文件**: `locales/{lang}/ui-welcome.json` | `WelcomeScreen.tsx` + +- [x] 创建 `en/ui-welcome.json` +- [x] 创建 `zh-CN/ui-welcome.json` +- [x] 替换快捷键提示文本 + +### 模块 2-7：McpStatusList + +**文件**: `locales/{lang}/ui-mcp.json` | `McpStatusList.tsx` + +- [x] 创建 `en/ui-mcp.json` +- [x] 创建 `zh-CN/ui-mcp.json` +- [x] 替换视图模式名、状态标签 + +### 模块 2-8：slashCommands + +**文件**: `locales/{lang}/ui-slash-commands.json` | `slashCommands.ts` + +- [x] 创建 `en/ui-slash-commands.json` +- [x] 创建 `zh-CN/ui-slash-commands.json` +- [x] 替换命令描述文案 + +### 模块 2-9：SessionList + +**文件**: `locales/{lang}/ui-session-list.json` | `SessionList.tsx` + +- [x] 创建 `en/ui-session-list.json` +- [x] 创建 `zh-CN/ui-session-list.json` +- [x] 替换标题、空状态文案 + +### 模块 2-10：AskUserQuestionPrompt + +**文件**: `locales/{lang}/ui-ask-question.json` | `AskUserQuestionPrompt.tsx` + +- [x] 创建 `en/ui-ask-question.json` +- [x] 创建 `zh-CN/ui-ask-question.json` +- [x] 替换按钮、提示文案 + +### 模块 2-11：ProcessStdoutView + +**文件**: `locales/{lang}/ui-process-stdout.json` | `ProcessStdoutView.tsx` + +- [x] 创建 `en/ui-process-stdout.json` +- [x] 创建 `zh-CN/ui-process-stdout.json` +- [x] 替换标题栏、进程信息文案 + +### 模块 2-12：UpdatePrompt + +**文件**: `locales/{lang}/ui-update-prompt.json` | `UpdatePrompt.tsx` + +- [x] 创建 `en/ui-update-prompt.json` +- [x] 创建 `zh-CN/ui-update-prompt.json` +- [x] 替换计划显示文案 + +### 模块 2-13：cli.tsx + +**文件**: `locales/{lang}/cli-help.json` | `cli.tsx` + +- [x] 创建 `en/cli-help.json` +- [x] 创建 `zh-CN/cli-help.json` +- [x] 替换 `--help` 全部输出文本为翻译 + +### 测试 + +- [x] 所有测试调用 `initI18n("en")` 或 mock `t()` + +--- + +## Phase 3：Prompt 模板 + 语言指令（PR 3） + +### 模块 3-1：session + +**文件**: `locales/{lang}/session.json` | `session.ts` + +- [x] 创建 `en/session.json`（2 keys） +- [x] 创建 `zh-CN/session.json` +- [x] 通过 `SessionManagerOptions.t`（类型 `TranslationKey`）注入翻译，替换 "compacting"、"skillPromptHeader" + +### 模块 3-2：prompt + +**文件**: `locales/{lang}/prompt.json` | `prompt.ts` + +- [x] 创建 `en/prompt.json`（4 keys） +- [x] 创建 `zh-CN/prompt.json` +- [x] `getSystemPrompt()` 末尾追加两条语言指令： + - `t("prompt.thinkingLanguageInstruction", undefined, getThinkingLocale())` + - `t("prompt.replyLanguageInstruction", undefined, getReplyLocale())` +- [x] `getCurrentDateAndModelPrompt()` 使用 `t("prompt.dateAndModel")` + locale 日期格式 +- [x] `getDefaultSkillPrompt()` 使用 `t("prompt.skillDocumentsHeader")` + +### EJS 模板 + +- [x] 创建 `templates/prompts/system-prompt.en.md.ejs` +- [x] 创建 `templates/prompts/system-prompt.zh-CN.md.ejs` +- [x] 创建 `templates/prompts/compact-prompt.en.md.ejs` +- [x] 创建 `templates/prompts/compact-prompt.zh-CN.md.ejs` + +--- + +## Phase 4：/config 命令（PR 4） + +### 模块 4-1：ConfigDropdown + +**文件**: `locales/{lang}/ui-config.json` | `ConfigDropdown.tsx` + +- [x] 创建 `en/ui-config.json`（5 keys） +- [x] 创建 `zh-CN/ui-config.json` +- [x] 创建 `ConfigDropdown.tsx` — 三项语言选择（UI 语言、推理语言、回复语言；后两项默认折叠为 "Advanced"） + +### slashCommands + +- [x] `slashCommands.ts` 注册 `config` 命令类型和内置条目 + +### PromptInput + +- [x] 增加 `showConfigDropdown` 状态 +- [x] 增加 `onLocaleChange`、`onThinkingLocaleChange`、`onReplyLocaleChange` props +- [x] 处理 `/config locale|thinkingLocale|replyLocale ` 参数模式（`/^\/config\s/`） +- [x] 渲染 ConfigDropdown 组件 + +### App.tsx + +- [x] 三个 locale 变更回调 → 刷新 `` 消息 + 欢迎屏 + +--- + +## 代码审查发现的问题（2026-05-22） + +### 🔴 Bug +- `src/common/i18n.ts:getExtensionRoot()` 第 38 行存在不可达代码（死代码），应删除 + +### 🟡 需要修复 +1. **McpStatusList 视图比较**（`McpStatusList.tsx:16,58`）：`viewMode === t("ui.mcp.serverDetail")` 使用翻译字符串做状态比较，切换 locale 后会失效。应使用固定字符串 `"server-detail"`。 +2. **遗漏的 t() 调用（session.ts）**： + - `activateSession()` 中第 1083, 1089, 1240, 1256 行的硬编码英文应改用 `t()` +3. **遗漏的 t() 调用（App.tsx）**： + - `handleModelConfigChange()` 中第 243, 349, 380 行的硬编码应改用 `t()` + - `handleUndoRestore()` 中第 460, 469 行的硬编码应改用 `t()` + - `buildStatusLine()` 中第 808-813 行的硬编码应改用 `t()` +4. **遗漏的 t() 调用（cli.tsx）**：第 84 行非 TTY 错误消息未翻译 +5. **session.skillPromptHeader 未使用**：`session.ts` 第 987 行硬编码 "Use the skill document below..."，应改用 `t("session.skillPromptHeader")` +6. **ui.slashCommands.continueDesc 未使用**：`slashCommands.ts` 第 62 行硬编码，应改用 `t("ui.slashCommands.continueDesc")` + +### 🟢 无问题 +- 所有 `t()` 调用均指向有效的 key（代码中无悬挂引用） +- `cli.help.*`（35个 key）、`ui.messageView.*`（10个）、`ui.exitSummary.*`（6个）、`ui.loading.*`（2个）、`prompt.*`（4个）使用率均为 100% +- `npm run check` 全部通过 +- `npm run check:i18n` 全部 140 个 key 匹配 + +--- + +## 已知限制 + +- Ink `` 不会重渲染已挂载消息，语言切换后历史消息保持旧语言 +- 中间会话切换 locale 只影响新 UI/新提示词，已有历史不回溯翻译 +- LLM 的输出语言控制是"软约束"——LLM 可能不完全遵守语言指令，但实践中大多数模型会遵循 +## 二阶段发现的遗漏项（2026-05-23） + +> 以下是代码审查中发现的**仍在硬编码的字符串**，涉及 10+ 个组件文件。 +> 这些字符串需要新增 translation key 到 `locales/{lang}/index.json`，然后在源码中替换为 `t()` 调用。 + +### 1. ModelsDropdown (`/model` 命令二级页面) — 完全未翻译 + +**文件**: `src/ui/components/ModelsDropdown/index.tsx` + +| 行号 | 硬编码文本 | 建议 key | +|------|-----------|---------| +| 17 | `"Thinking mode [max]"` | `ui.modelsDropdown.thinkingMax` | +| 18 | `"Thinking mode [high]"` | `ui.modelsDropdown.thinkingHigh` | +| 19 | `"No thinking"` | `ui.modelsDropdown.noThinking` | +| 141 | `"current model"` | `ui.modelsDropdown.currentModel` | +| 147 | `` reasoningEffort: ${option.reasoningEffort} `` | `ui.modelsDropdown.reasoningEffort` | +| 147 | `"thinking disabled"` | `ui.modelsDropdown.thinkingDisabled` | +| 154 | `"Select Model"` | `ui.modelsDropdown.selectModel` | +| 154 | `"Select Thinking Mode"` | `ui.modelsDropdown.selectThinkingMode` | +| 155 | `"Space/Enter select model · Esc to cancel"` | `ui.modelsDropdown.selectModelHelp` | +| 155 | `"Space/Enter apply · Esc to cancel"` | `ui.modelsDropdown.applyHelp` | + +### 2. RawModelDropdown (`/raw` 命令二级页面) — 完全未翻译 + +**文件**: `src/ui/components/RawModelDropdown/index.tsx` + `src/ui/contexts/RawModeContext.tsx` + +| 行号 | 硬编码文本 | 建议 key | +|------|-----------|---------| +| 43 | `"Select mode"` | `ui.rawModelDropdown.title` | +| 45 | `"Space/Enter select mode · Esc to close"` | `ui.rawModelDropdown.helpText` | +| RawModeContext:11 | `"Lite mode"` (label) | `ui.rawModelDropdown.liteMode` | +| RawModeContext:12 | `"Lite mode"` (RawMode.Lite enum) | 枚举值用作标识符，不可翻译 | +| RawModeContext:13 | `"Collapse chain-of-thought reasoning."` (description) | `ui.rawModelDropdown.liteDesc` | +| RawModeContext:16 | `"Normal mode"` (label) | `ui.rawModelDropdown.normalMode` | +| RawModeContext:18 | `"Show full chain-of-thought reasoning."` (description) | `ui.rawModelDropdown.normalDesc` | +| RawModeContext:21 | `"Raw scrollback mode"` (label) | `ui.rawModelDropdown.rawScrollbackMode` | +| RawModeContext:23 | `"Show scrollback mode for copy-friendly terminal selection."` (description) | `ui.rawModelDropdown.rawDesc` | + +### 3. SkillsDropdown (`/skills` 命令二级页面) — 完全未翻译 + +**文件**: `src/ui/components/SkillsDropdown/index.tsx` + +| 行号 | 硬编码文本 | 建议 key | +|------|-----------|---------| +| 57 | `"Select Skills"` | `ui.skillsDropdown.title` | +| 58 | `"Space toggle · Enter toggle · Esc to close"` | `ui.skillsDropdown.helpText` | +| 59 | `"No skills found"` | `ui.skillsDropdown.emptyText` | + +### 4. FileMentionMenu (`@` 文件菜单) — 完全未翻译 + +**文件**: `src/ui/components/FileMentionMenu/index.tsx` + +| 行号 | 硬编码文本 | 建议 key | +|------|-----------|---------| +| 87 | `"Mention File"` | `ui.fileMentionMenu.title` | +| 88 | `"Enter/Tab insert · Esc close"` | `ui.fileMentionMenu.helpText` | +| 89 | `"No matching files"` | `ui.fileMentionMenu.noMatching` | +| 89 | `"Type after @ to search files"` | `ui.fileMentionMenu.typeHint` | +| 93 | `"directory"` | `ui.fileMentionMenu.directory` | +| 93 | `"file"` | `ui.fileMentionMenu.file` | + +### 5. DropdownMenu（通用组件）— 部分未翻译 + +**文件**: `src/ui/DropdownMenu.tsx` + +| 行号 | 硬编码文本 | 建议 key | +|------|-----------|---------| +| 71 | `"No items found"` | `ui.dropdownMenu.emptyText` | +| 138 | `"above"`（参数化：`… {n} above`） | `ui.dropdownMenu.above` | +| 174 | `"more"`（参数化：`… {n} more`） | `ui.dropdownMenu.more` | + +### 6. SlashCommandMenu — 剩余未翻译 + +**文件**: `src/ui/SlashCommandMenu.tsx` + +| 行号 | 硬编码文本 | 建议 key | +|------|-----------|---------| +| 77 | `"({current}/{total}) ↑↓ to navigate · Enter to select"` | `ui.slashCommandMenu.footerHelp` | + +### 7. McpStatusList (`/mcp` 命令二级页面) — 遗漏翻译 + +**文件**: `src/ui/McpStatusList.tsx` + +| 行号 | 硬编码文本 | 建议 key | +|------|-----------|---------| +| 45, 195 | `"Manage MCP servers"` | `ui.mcp.manageTitle` | +| 47 | `"0 servers"` | `ui.mcp.zeroServers` | +| 50 | `"No MCP servers configured."` | `ui.mcp.noServersConfigured` | +| 51 | `"Add MCP servers to your settings to get started."` | `ui.mcp.addServersHint` | +| 53 | `"Esc to close"` | `ui.mcp.escToClose` | +| 244 | `"servers above."`（参数化） | `ui.mcp.serversAbove` | +| 246 | `"servers below."`（参数化） | `ui.mcp.serversBelow` | +| 292 | `"tools, prompts, resources"` 计数标签 | 转为 ${t("...")} 调用 | +| 458 | `` ${server.toolCount} tools, ${server.promptCount} prompts, ${server.resourceCount} resources `` | `ui.mcp.itemCounts` | +| 459 | `` `Status: ${server.status}` `` | `ui.mcp.statusPrefix` | + +### 8. SessionList (`/resume`/`/continue` 命令二级页面) — 遗漏翻译 + +**文件**: `src/ui/SessionList.tsx` + +| 行号 | 硬编码文本 | 建议 key | +|------|-----------|---------| +| 162 | `"Press Esc to go back."` | `ui.sessionList.escBack` | +| 185 | `"total"` | `ui.sessionList.total` | +| 186 | `", {n} matched"`（参数化） | `ui.sessionList.matched` | +| 213 | `'No sessions match "{query}".'`（参数化） | `ui.sessionList.noMatch` | +| 229 | `"Untitled"` | `ui.sessionList.untitled` | +| 243 | `"sessions above."`（参数化） | `ui.sessionList.above` | +| 245 | `"sessions below."`（参数化） | `ui.sessionList.below` | +| 253-259 | Footer 帮助文本 | `ui.sessionList.footerHelp` | +| 284-301 | `formatSessionStatus()` 状态值 | `ui.sessionList.statusDone`/`Running`/`Pending`/`Waiting`/`Failed`/`Stopped` | + +### 9. UndoSelector (`/undo` 命令二级页面) — 几乎完全未翻译 + +**文件**: `src/ui/UndoSelector.tsx` + +| 行号 | 硬编码文本 | 建议 key | +|------|-----------|---------| +| 86 | `"Nothing to undo yet."` | `ui.undoSelector.nothingYet` | +| 87 | `"Press Esc to go back."` | `ui.undoSelector.escBack` | +| 104 | `"Undo"` | `ui.undoSelector.title` | +| 106 | `"restore to the point before a prompt"` | `ui.undoSelector.subtitle` | +| 133 | `"code checkpoint available"` | `ui.undoSelector.checkpointAvailable` | +| 133 | `"conversation only"` | `ui.undoSelector.conversationOnly` | +| 153 | `"Selected prompt:"` | `ui.undoSelector.selectedPrompt` | +| 157 | `"Restore code and conversation"` | `ui.undoSelector.restoreCodeAndConversation` | +| 164 | `"Restore conversation"` | `ui.undoSelector.restoreConversation` | +| 166 | `"Fork the conversation without changing files."` | `ui.undoSelector.forkConversation` | +| 173-174 | Footer 帮助文本（两种 phase） | `ui.undoSelector.footerMessage` + `ui.undoSelector.footerMode` | +| 183 | `"(empty message)"` | `ui.undoSelector.emptyMessage` | + +### 10. ProcessStdoutView (Ctrl+O 全屏) — 遗漏翻译 + +**文件**: `src/ui/ProcessStdoutView.tsx` + +| 行号 | 硬编码文本 | 建议 key | +|------|-----------|---------| +| 56 | `"(no running processes)"` | `ui.processStdout.noRunning` | +| 85 | `"lines above/scroll/total"` 滚动提示 | `ui.processStdout.scrollHint` | +| 137 | `"📟 Process Output"` | `ui.processStdout.title` | +| 138-140 | Footer 操作提示 | `ui.processStdout.footerHelp` | +| 174 | `"timeout unavailable"` | `ui.processStdout.timeoutUnavailable` | +| 176 | `"timeout {duration}"` | `ui.processStdout.timeoutHint` | +| 183 | `"Timeout set to {duration}"` | `ui.processStdout.timeoutSet` | + +--- + +## 已解决的已知问题 + +- `exitSummary.ts` 的 `visibleLength()` 未处理 CJK 双倍宽度字符（现有 bug）→ **已缓解**：新增 `display-width.ts`，但 `exitSummary.ts` 尚未改用（仅视觉偏移，不影响功能） +- **CJK 视觉宽度导致的布局截断** → **已修复**：`DropdownMenu.tsx` 和 `SlashCommandMenu.tsx` 改用 `displayWidth()` 替代 `String.length` 计算列宽 +- Tool 文档（`templates/tools/`）保持英文，不翻译（发给 LLM 使用） + +--- + +## Key 使用审计（2026-05-22） + +> 通过对照 `en/index.json` 定义的所有 key 与源代码中 `t()` 调用进行扫描比对。 + +### 总览 + +| 类别 | 数量 | 占比 | +|------|------|------| +| 已定义且使用的 key | 105 | 75% | +| 已定义但未使用的 key | 35 | 25% | +| 代码调用但未定义的 key | 0 | 0% | + +### 各模块使用率 + +| 模块 | 定义数 | 使用数 | 使用率 | 状态 | +|------|--------|--------|--------|------| +| `cli.help.*` | 35 | 35 | 100% | ✅ | +| `ui.messageView.*` | 10 | 10 | 100% | ✅ | +| `ui.exitSummary.*` | 6 | 6 | 100% | ✅ | +| `ui.loading.*` | 2 | 2 | 100% | ✅ | +| `prompt.*` | 4 | 4 | 100% | ✅ | +| `session.compacting` | 1 | 1 | 100% | ✅ | +| `ui.config.*` | 10 | 7 | 70% | ⚠️ | +| `ui.slashCommands.*` | 12 | 11 | 92% | ⚠️ | +| `ui.welcome.*` | 7 | 6 | 86% | ⚠️ | +| `ui.mcp.*` | 7 | 5 | 71% | ⚠️ | +| `ui.promptInput.*` | 19 | 14 | 74% | ⚠️ | +| `ui.app.*` | 16 | 3 | 19% | 🔴 | +| `ui.askUserQuestion.*` | 3 | 0 | 0% | 🔴 | +| `ui.processStdout.*` | 4 | 0 | 0% | 🔴 | +| `ui.sessionList.*` | 2 | 0 | 0% | 🔴 | +| `ui.updatePrompt.*` | 1 | 0 | 0% | 🔴 | +| `session.skillPromptHeader` | 1 | 0 | 0% | 🔴 | + +### 未使用的 Key 及原因 + +| Key | 原因 | +|-----|------| +| `ui.app.error` | App.tsx 第 674 行硬编码 `"Error: "` 前缀 | +| `ui.app.statusStatus` | App.tsx 第 808 行硬编码 `` `status: ${entry.status}` `` | +| `ui.app.statusTokens` | App.tsx 第 810 行硬编码 `` `tokens: ${entry.activeTokens}` `` | +| `ui.app.statusFail` | App.tsx 第 813 行硬编码 `` `fail: ${entry.failReason}` `` | +| `ui.app.modelUnchanged` | App.tsx 第 349 行硬编码 | +| `ui.app.modelUpdated` | App.tsx 第 380 行硬编码 | +| `ui.app.noActiveSession` | App.tsx 第 243, 449 行硬编码 | +| `ui.app.codeRestoreFailed` | App.tsx 第 460 行硬编码 | +| `ui.app.conversationRestoreFailed` | App.tsx 第 469 行硬编码 | +| `ui.app.sessionDefaultSummary` | session.ts 第 925 行硬编码 | +| `ui.app.sessionAgentSteps` | session.ts 第 1240 行硬编码 | +| `ui.app.apiKeyNotFound` | session.ts 第 1089 行硬编码 | +| `ui.app.requestFailed` | session.ts 第 1256 行硬编码 | +| `ui.config.languageUpdated` | 未在任何 t() 中调用 | +| `ui.config.thinkingLanguageUpdated` | 未在任何 t() 中调用 | +| `ui.config.replyLanguageUpdated` | 未在任何 t() 中调用 | +| `ui.welcome.deepCodeTitle` | 可能未在 WelcomScreen 中使用 | +| `ui.mcp.serverList` | McpStatusList 使用字面量 `"server-list"` | +| `ui.mcp.statusConnecting` | McpStatusList 字面量 | +| `ui.slashCommands.continueDesc` | slashCommands.ts 第 62 行硬编码英文 | +| `ui.sessionList.title` | SessionList 硬编码 | +| `ui.sessionList.empty` | SessionList 硬编码 | +| `ui.askUserQuestion.submit` | AskUserQuestionPrompt 硬编码 | +| `ui.askUserQuestion.cancel` | AskUserQuestionPrompt 硬编码 | +| `ui.askUserQuestion.selectOption` | AskUserQuestionPrompt 硬编码 | +| `ui.processStdout.title` | ProcessStdoutView 硬编码 | +| `ui.processStdout.running` | ProcessStdoutView 硬编码 | +| `ui.processStdout.adjustTimeout` | ProcessStdoutView 硬编码 | +| `ui.processStdout.noOutput` | ProcessStdoutView 硬编码 | +| `ui.updatePrompt.planHeader` | UpdatePrompt 硬编码 | +| `session.skillPromptHeader` | session.ts 第 987 行硬编码 | +| `ui.promptInput.footerBusy` | PromptInput 动态拼接 | +| `ui.promptInput.ctrlOViewOutput` | PromptInput 动态拼接 | +| `ui.promptInput.ctrlOExpand` | PromptInput 动态拼接 | +| `ui.promptInput.ctrlOCollapse` | PromptInput 动态拼接 | +| `ui.promptInput.imageCount` | PromptInput 动态拼接 | diff --git a/eslint.config.mjs b/eslint.config.mjs index 50e4149..94fd983 100644 --- a/eslint.config.mjs +++ b/eslint.config.mjs @@ -49,6 +49,16 @@ export default tseslint.config( "@typescript-eslint/no-unused-vars": "off", }, }, + // Scripts: Node.js environment + { + files: ["scripts/**/*.mjs"], + languageOptions: { + globals: { + console: "readable", + process: "readable", + }, + }, + }, // Prettier config: disable conflicting ESLint rules, MUST be last - prettierConfig, + prettierConfig ); diff --git a/locales/en/cli-help.json b/locales/en/cli-help.json new file mode 100644 index 0000000..c5b2e95 --- /dev/null +++ b/locales/en/cli-help.json @@ -0,0 +1,42 @@ +{ + "cli": { + "help": { + "title": "deepcode - Deep Code CLI", + "usage": "Usage:", + "launchTui": " deepcode Launch the interactive TUI in the current directory", + "launchWithPrompt": " deepcode -p Launch with a pre-filled prompt", + "launchWithPromptLong": " deepcode --prompt Same as -p", + "printVersion": " deepcode --version Print the version", + "printHelp": " deepcode --help Show this help", + "configSection": "Configuration:", + "userSettings": " ~/.deepcode/settings.json User-level API key, model, base URL", + "projectSettings": " ./.deepcode/settings.json Project-level settings", + "userSkills": " ~/.agents/skills/*/SKILL.md User-level skills", + "projectSkills": " ./.agents/skills/*/SKILL.md Project-level skills", + "legacySkills": " ./.deepcode/skills/*/SKILL.md Legacy project-level skills", + "tuiSection": "Inside the TUI:", + "enterSend": " enter Send the prompt", + "shiftEnterNewline": " shift+enter Insert a newline", + "homeEnd": " home/end Move within the current line", + "altLeftRight": " alt+left/right Move by word", + "ctrlW": " ctrl+w Delete the previous word", + "ctrlV": " ctrl+v Paste an image from the clipboard", + "ctrlX": " ctrl+x Clear pasted images", + "esc": " esc Interrupt the current model turn", + "slash": " / Open the skills/commands menu", + "slashSkills": " /skills List available skills", + "slashModel": " /model Select model, thinking mode and effort control", + "slashNew": " /new Start a fresh conversation", + "slashInit": " /init Initialize an AGENTS.md file with instructions for LLM", + "slashResume": " /resume Pick a previous conversation to continue", + "slashContinue": " /continue Continue the active conversation, or resume one if empty", + "slashUndo": " /undo Restore code and/or conversation to a previous point", + "slashMcp": " /mcp Show MCP server status and available tools", + "slashRaw": " /raw Toggle display mode for viewing or collapsing reasoning content", + "slashExit": " /exit Quit", + "slashConfig": " /config Configure language settings", + "ctrlD": " ctrl+d twice Quit", + "ttyRequired": "deepcode requires an interactive terminal (TTY). Re-run from a real terminal session." + } + } +} diff --git a/locales/en/prompt.json b/locales/en/prompt.json new file mode 100644 index 0000000..c9a4ba3 --- /dev/null +++ b/locales/en/prompt.json @@ -0,0 +1,8 @@ +{ + "prompt": { + "skillDocumentsHeader": "Use the skill documents below to assist the user:\n", + "dateAndModel": "Today is {date}. As the conversation progresses, time passes.\nCurrent LLM model is {model}. You can switch models using the /model command.", + "thinkingLanguageInstruction": "IMPORTANT: Your reasoning and thinking process should be in English.", + "replyLanguageInstruction": "IMPORTANT: Always respond to the user in English." + } +} diff --git a/locales/en/session.json b/locales/en/session.json new file mode 100644 index 0000000..cf72203 --- /dev/null +++ b/locales/en/session.json @@ -0,0 +1,6 @@ +{ + "session": { + "compacting": "The conversation is getting long, compacting...", + "skillPromptHeader": "Use the skill document below to assist the user:\n" + } +} diff --git a/locales/en/ui-app.json b/locales/en/ui-app.json new file mode 100644 index 0000000..5c62598 --- /dev/null +++ b/locales/en/ui-app.json @@ -0,0 +1,23 @@ +{ + "ui": { + "app": { + "error": "Error: {message}", + "statusStatus": "status: {status}", + "statusTokens": "tokens: {tokens}", + "statusFail": "fail: {reason}", + "interrupted": "Interrupted.", + "killedProcesses": "Killed processes: {pids}", + "failedKillProcesses": "Failed to kill processes: {pids}", + "modelUnchanged": "Model settings unchanged", + "modelUpdated": "Model settings updated: {before} → {after}", + "noActiveSession": "No active session to undo.", + "codeRestoreFailed": "Code restore failed: {error}", + "conversationRestoreFailed": "Conversation restore failed: {error}", + "sessionAgentSteps": "The AI agent has taken several steps but hasn't reached a conclusion yet. Do you want to continue?", + "apiKeyNotFound": "OpenAI API key not found. Please configure ~/.deepcode/settings.json or ./.deepcode/settings.json.", + "requestFailed": "Request failed: {error}", + "pressEscExitRaw": "Press ESC to exit raw mode", + "noMessagesInSession": "(No messages in this session yet. Start chatting to see them here.)" + } + } +} diff --git a/locales/en/ui-ask-question.json b/locales/en/ui-ask-question.json new file mode 100644 index 0000000..de5a9d0 --- /dev/null +++ b/locales/en/ui-ask-question.json @@ -0,0 +1,12 @@ +{ + "ui": { + "askUserQuestion": { + "selectOptionHelp": "Select an option, or type an Other answer.", + "selectMultiHelp": "Select at least one option with Space, or type an Other answer.", + "typeAnswerHelp": "Type your answer · Backspace edit · Enter submit/next · ↑ choose presets · Esc type manually", + "otherLabel": "Other", + "selectMultiMove": "↑/↓ move · Space toggle · Enter submit/next · Esc type manually", + "selectSingleMove": "↑/↓ move · Enter select/next · Esc type manually" + } + } +} diff --git a/locales/en/ui-config.json b/locales/en/ui-config.json new file mode 100644 index 0000000..da85c1c --- /dev/null +++ b/locales/en/ui-config.json @@ -0,0 +1,20 @@ +{ + "ui": { + "config": { + "title": "Configuration", + "language": "Language", + "thinkingLanguage": "Thinking Language", + "replyLanguage": "Reply Language", + "selectLanguage": "Select Language", + "selectCategoryHelp": "Space/Enter select · Esc to cancel", + "selectLanguageHelp": "Space/Enter apply · Esc back", + "currentLabel": "current", + "localeEn": "English", + "localeZhCN": "\u4e2d\u6587", + "categoryWithValue": "{label} ({value})", + "languageUpdated": "Language: {locale}", + "thinkingLanguageUpdated": "Thinking language: {locale}", + "replyLanguageUpdated": "Reply language: {locale}" + } + } +} diff --git a/locales/en/ui-dropdowns.json b/locales/en/ui-dropdowns.json new file mode 100644 index 0000000..50b93b3 --- /dev/null +++ b/locales/en/ui-dropdowns.json @@ -0,0 +1,47 @@ +{ + "ui": { + "dropdownMenu": { + "emptyText": "No items found", + "above": "{n} above", + "more": "{n} more" + }, + "fileMentionMenu": { + "title": "Mention File", + "helpText": "Enter/Tab insert · Esc close", + "noMatching": "No matching files", + "typeHint": "Type after @ to search files", + "directory": "directory", + "file": "file" + }, + "modelsDropdown": { + "thinkingMax": "Thinking mode [max]", + "thinkingHigh": "Thinking mode [high]", + "noThinking": "No thinking", + "currentModel": "current model", + "reasoningEffort": "reasoningEffort: {value}", + "thinkingDisabled": "thinking disabled", + "selectModel": "Select Model", + "selectThinkingMode": "Select Thinking Mode", + "selectModelHelp": "Space/Enter select model · Esc to cancel", + "applyHelp": "Space/Enter apply · Esc to cancel" + }, + "rawModelDropdown": { + "title": "Select mode", + "helpText": "Space/Enter select mode · Esc to close", + "liteMode": "Lite mode", + "normalMode": "Normal mode", + "rawScrollbackMode": "Raw scrollback mode", + "liteDesc": "Collapse chain-of-thought reasoning.", + "normalDesc": "Show full chain-of-thought reasoning.", + "rawDesc": "Show scrollback mode for copy-friendly terminal selection." + }, + "skillsDropdown": { + "title": "Select Skills", + "helpText": "Space toggle · Enter toggle · Esc to close", + "emptyText": "No skills found" + }, + "slashCommandMenu": { + "footerHelp": "({current}/{total}) ↑↓ to navigate · Enter to select" + } + } +} diff --git a/locales/en/ui-exit-summary.json b/locales/en/ui-exit-summary.json new file mode 100644 index 0000000..c330e1a --- /dev/null +++ b/locales/en/ui-exit-summary.json @@ -0,0 +1,12 @@ +{ + "ui": { + "exitSummary": { + "goodbye": "Goodbye!", + "modelUsage": "Model Usage", + "reqs": "Reqs", + "inputTokens": "Input Tokens", + "outputTokens": "Output Tokens", + "cachedTokens": "Cached Tokens" + } + } +} diff --git a/locales/en/ui-loading.json b/locales/en/ui-loading.json new file mode 100644 index 0000000..fd5091e --- /dev/null +++ b/locales/en/ui-loading.json @@ -0,0 +1,8 @@ +{ + "ui": { + "loading": { + "thinking": "Thinking...", + "thinkingElapsed": "Thinking... ({elapsed}s) · ↓ {tokens} tokens" + } + } +} diff --git a/locales/en/ui-mcp.json b/locales/en/ui-mcp.json new file mode 100644 index 0000000..86b84e1 --- /dev/null +++ b/locales/en/ui-mcp.json @@ -0,0 +1,31 @@ +{ + "ui": { + "mcp": { + "statusReady": "ready", + "statusFailed": "failed", + "statusReconnecting": "reconnecting", + "reconnect": "Reconnect", + "starting": "Starting", + "details": "Details", + "status": "Status", + "enterReconnect": "Enter to reconnect · Esc back · Ctrl+C close", + "scrollBack": "↑/↓ scroll · Space/Enter back · Esc back · Ctrl+C close", + "spaceBack": "Space/Enter back · Esc back · Ctrl+C close", + "noItems": "No items available", + "footerHelp": "↑/↓ navigate · Enter view details · Esc close", + "countReady": "{count} ready,", + "countStarting": "{count} starting,", + "countReconnecting": "{count} reconnecting,", + "countFailed": "{count} failed", + "manageTitle": "Manage MCP servers", + "zeroServers": "0 servers", + "noServersConfigured": "No MCP servers configured.", + "addServersHint": "Add MCP servers to your settings to get started.", + "escToClose": "Esc to close", + "serversAbove": "{n} servers above.", + "serversBelow": "{n} servers below.", + "itemCounts": "{tools} tools, {prompts} prompts, {resources} resources", + "statusPrefix": "Status: {status}" + } + } +} diff --git a/locales/en/ui-message-view.json b/locales/en/ui-message-view.json new file mode 100644 index 0000000..4358673 --- /dev/null +++ b/locales/en/ui-message-view.json @@ -0,0 +1,16 @@ +{ + "ui": { + "messageView": { + "thinking": "Thinking", + "reasoningFallback": "(reasoning...)", + "noContent": "(no content)", + "loadedSkill": "⚡ Loaded skill: {name}", + "conversationSummaryInserted": "(conversation summary inserted)", + "changes": "└ Changes", + "plan": "└ Plan", + "result": "└ Result", + "toolName": "Tool", + "imageAttachment": "image(s)" + } + } +} diff --git a/locales/en/ui-process-stdout.json b/locales/en/ui-process-stdout.json new file mode 100644 index 0000000..8f35373 --- /dev/null +++ b/locales/en/ui-process-stdout.json @@ -0,0 +1,16 @@ +{ + "ui": { + "processStdout": { + "noAdjustableTimeout": "No adjustable Bash timeout", + "processLabel": "── Process {pid} [{command}] ──", + "noOutputYet": "(no output yet)", + "noRunning": "(no running processes)", + "scrollHint": "... ({start} lines above · ↑/↓ to scroll · {total} total lines) ...", + "title": "📟 Process Output", + "footerHelp": "({timeoutHint} · +/- adjust · Ctrl+O or Esc to close · ↑↓ PageUp/PageDown to scroll)", + "timeoutUnavailable": "timeout unavailable", + "timeoutHint": "timeout {duration}", + "timeoutSet": "Timeout set to {duration}" + } + } +} diff --git a/locales/en/ui-prompt-input.json b/locales/en/ui-prompt-input.json new file mode 100644 index 0000000..2cb1596 --- /dev/null +++ b/locales/en/ui-prompt-input.json @@ -0,0 +1,25 @@ +{ + "ui": { + "promptInput": { + "interrupting": "Interrupting…", + "imageAttached": "Attached image from clipboard", + "noImageFound": "No image found in clipboard", + "readingClipboard": "Reading clipboard...", + "failedClipboard": "Failed to read clipboard", + "clearedImages": "Cleared attached images", + "noImagesToClear": "No attached images to clear", + "placeholder": "Type your message...", + "waitForResponse": "wait for the current response or press esc to interrupt", + "pressCtrlDExit": "press ctrl+d to exit", + "pressCtrlDAgain": "press ctrl+d again to exit", + "footer": "enter send · shift+enter newline · @ files · ctrl+v image · / commands · ctrl+d exit", + "footerBusy": "esc to interrupt · ctrl+c to cancel input", + "ctrlOViewOutput": " · ctrl+o view output", + "ctrlOExpand": " · ctrl+o expand", + "ctrlOCollapse": " · ctrl+o collapse", + "noPasteMarker": "No paste marker at cursor", + "pasteNotFound": "Paste content not found", + "imageCount": "📎 {count} image(s) attached" + } + } +} diff --git a/locales/en/ui-session-list.json b/locales/en/ui-session-list.json new file mode 100644 index 0000000..7a34adf --- /dev/null +++ b/locales/en/ui-session-list.json @@ -0,0 +1,25 @@ +{ + "ui": { + "sessionList": { + "title": "Sessions", + "empty": "No sessions yet", + "searchHint": "Type to search…", + "searchQuery": "Search: {query}", + "escBack": "Press Esc to go back.", + "total": "total", + "matched": ", {n} matched", + "noMatch": "No sessions match \"{query}\".", + "untitled": "Untitled", + "above": "{n} sessions above.", + "below": "{n} sessions below.", + "footerHelp": "Type to search · ↑/↓ navigate · PgUp/PgDn page · Enter select · Esc cancel", + "footerSearch": "Esc clear search · ↑/↓ navigate · Enter select · Esc again to cancel", + "statusDone": "done", + "statusRunning": "running", + "statusPending": "pending", + "statusWaiting": "waiting", + "statusFailed": "failed", + "statusStopped": "stopped" + } + } +} diff --git a/locales/en/ui-slash-commands.json b/locales/en/ui-slash-commands.json new file mode 100644 index 0000000..5471d96 --- /dev/null +++ b/locales/en/ui-slash-commands.json @@ -0,0 +1,18 @@ +{ + "ui": { + "slashCommands": { + "skillsDesc": "List available skills", + "modelDesc": "Select model, thinking mode and effort control", + "newDesc": "Start a fresh conversation", + "initDesc": "Initialize an AGENTS.md file with instructions for LLM", + "resumeDesc": "Pick a previous conversation to continue", + "continueDesc": "Continue the active conversation or pick one to resume", + "undoDesc": "Restore code and/or conversation to a previous point", + "mcpDesc": "Show MCP server status and available tools", + "rawDesc": "Toggle display mode for viewing or collapsing reasoning content", + "exitDesc": "Quit Deep Code CLI", + "configDesc": "Configure settings: language, model, etc.", + "noDescription": "(no description)" + } + } +} diff --git a/locales/en/ui-undo.json b/locales/en/ui-undo.json new file mode 100644 index 0000000..5fec92a --- /dev/null +++ b/locales/en/ui-undo.json @@ -0,0 +1,23 @@ +{ + "ui": { + "undo": { + "restoreFiles": "Restore files from the recorded Git checkpoint, then fork the conversation.", + "noCheckpoint": "No code checkpoint is recorded for this prompt." + }, + "undoSelector": { + "nothingYet": "Nothing to undo yet.", + "escBack": "Press Esc to go back.", + "title": "Undo", + "subtitle": "restore to the point before a prompt", + "checkpointAvailable": "code checkpoint available", + "conversationOnly": "conversation only", + "selectedPrompt": "Selected prompt:", + "restoreCodeAndConversation": "Restore code and conversation", + "restoreConversation": "Restore conversation", + "forkConversation": "Fork the conversation without changing files.", + "footerMessage": "↑/↓ navigate · Enter choose · Esc cancel", + "footerMode": "↑/↓ choose restore mode · Enter restore · Esc back", + "emptyMessage": "(empty message)" + } + } +} diff --git a/locales/en/ui-update-prompt.json b/locales/en/ui-update-prompt.json new file mode 100644 index 0000000..a5ba26c --- /dev/null +++ b/locales/en/ui-update-prompt.json @@ -0,0 +1,11 @@ +{ + "ui": { + "updatePrompt": { + "title": "Deep Code latest version has been released: {currentVersion} -> {latestVersion}", + "installLabel": "Install the latest version with `{installCommand}`", + "ignoreOnce": "Ignore once", + "ignoreVersion": "Ignore this version ({latestVersion})", + "footerHelp": "Use Up/Down to choose, Enter to confirm, Esc to ignore once." + } + } +} diff --git a/locales/en/ui-welcome.json b/locales/en/ui-welcome.json new file mode 100644 index 0000000..c9cf43b --- /dev/null +++ b/locales/en/ui-welcome.json @@ -0,0 +1,16 @@ +{ + "ui": { + "welcome": { + "sendPrompt": "Send the prompt", + "insertNewline": "Insert a newline", + "pasteImage": "Paste an image from the clipboard", + "interrupt": "Interrupt the current model turn", + "openMenu": "Open the skills and commands menu", + "quit": "Quit Deep Code CLI", + "thinkingEnabled": "Thinking Enabled", + "reasoningEffort": "Reasoning Effort", + "model": "Model", + "cwd": "CWD" + } + } +} diff --git a/locales/zh-CN/cli-help.json b/locales/zh-CN/cli-help.json new file mode 100644 index 0000000..f134f1b --- /dev/null +++ b/locales/zh-CN/cli-help.json @@ -0,0 +1,42 @@ +{ + "cli": { + "help": { + "title": "deepcode - Deep Code CLI", + "usage": "用法：", + "launchTui": " deepcode 启动交互式 TUI", + "launchWithPrompt": " deepcode -p 使用预设提示启动", + "launchWithPromptLong": " deepcode --prompt 同 -p", + "printVersion": " deepcode --version 打印版本号", + "printHelp": " deepcode --help 显示此帮助", + "configSection": "配置：", + "userSettings": " ~/.deepcode/settings.json 用户级别 API key、模型、base URL", + "projectSettings": " ./.deepcode/settings.json 项目级别设置", + "userSkills": " ~/.agents/skills/*/SKILL.md 用户级别技能", + "projectSkills": " ./.agents/skills/*/SKILL.md 项目级别技能", + "legacySkills": " ./.deepcode/skills/*/SKILL.md 旧版项目级别技能", + "tuiSection": "TUI 内部操作：", + "enterSend": " enter 发送提示", + "shiftEnterNewline": " shift+enter 插入换行", + "homeEnd": " home/end 在当前行内移动", + "altLeftRight": " alt+left/right 按词移动", + "ctrlW": " ctrl+w 删除前一个词", + "ctrlV": " ctrl+v 从剪贴板粘贴图片", + "ctrlX": " ctrl+x 清除已粘贴的图片", + "esc": " esc 中断当前模型响应", + "slash": " / 打开技能/命令菜单", + "slashSkills": " /skills 列出可用技能", + "slashModel": " /model 选择模型、思考模式", + "slashNew": " /new 开始新对话", + "slashInit": " /init 初始化 AGENTS.md 文件", + "slashResume": " /resume 选择之前的对话继续", + "slashContinue": " /continue 继续当前对话或恢复", + "slashUndo": " /undo 恢复到之前的代码/对话", + "slashMcp": " /mcp 显示 MCP 状态和工具", + "slashRaw": " /raw 切换推理内容显示模式", + "slashExit": " /exit 退出", + "slashConfig": " /config 配置语言设置", + "ctrlD": " ctrl+d 两次 退出", + "ttyRequired": "deepcode 需要一个交互式终端（TTY）。请从真实终端会话重新运行。" + } + } +} diff --git a/locales/zh-CN/prompt.json b/locales/zh-CN/prompt.json new file mode 100644 index 0000000..df14b99 --- /dev/null +++ b/locales/zh-CN/prompt.json @@ -0,0 +1,8 @@ +{ + "prompt": { + "skillDocumentsHeader": "使用以下技能文档来协助用户：\n", + "dateAndModel": "今天是{date}。随着对话的进行，时间在流逝。\n当前 LLM 模型为{model}，可通过 /model 命令切换模型。", + "thinkingLanguageInstruction": "重要：你的推理和思考过程请使用中文。", + "replyLanguageInstruction": "重要：请始终使用中文回复用户。" + } +} diff --git a/locales/zh-CN/session.json b/locales/zh-CN/session.json new file mode 100644 index 0000000..194d471 --- /dev/null +++ b/locales/zh-CN/session.json @@ -0,0 +1,6 @@ +{ + "session": { + "compacting": "对话内容较长，正在压缩...", + "skillPromptHeader": "使用以下技能文档来协助用户：\n" + } +} diff --git a/locales/zh-CN/ui-app.json b/locales/zh-CN/ui-app.json new file mode 100644 index 0000000..3ea6e55 --- /dev/null +++ b/locales/zh-CN/ui-app.json @@ -0,0 +1,23 @@ +{ + "ui": { + "app": { + "error": "错误：{message}", + "statusStatus": "状态：{status}", + "statusTokens": "token 数：{tokens}", + "statusFail": "失败原因：{reason}", + "interrupted": "已中断。", + "killedProcesses": "已终止进程：{pids}", + "failedKillProcesses": "终止进程失败：{pids}", + "modelUnchanged": "模型设置未变更", + "modelUpdated": "模型设置已更新：{before} → {after}", + "noActiveSession": "没有活跃会话可供撤销。", + "codeRestoreFailed": "代码恢复失败：{error}", + "conversationRestoreFailed": "对话恢复失败：{error}", + "sessionAgentSteps": "AI 助手已执行多个步骤但未得出结论。是否继续？", + "apiKeyNotFound": "未找到 OpenAI API key。请配置 ~/.deepcode/settings.json 或 ./.deepcode/settings.json。", + "requestFailed": "请求失败：{error}", + "pressEscExitRaw": "按 ESC 退出原始模式", + "noMessagesInSession": "（此会话暂无消息，开始聊天即可看到）" + } + } +} diff --git a/locales/zh-CN/ui-ask-question.json b/locales/zh-CN/ui-ask-question.json new file mode 100644 index 0000000..e7b8a31 --- /dev/null +++ b/locales/zh-CN/ui-ask-question.json @@ -0,0 +1,12 @@ +{ + "ui": { + "askUserQuestion": { + "selectOptionHelp": "选择一个选项，或输入其他答案。", + "selectMultiHelp": "请使用空格选择至少一个选项，或输入其他答案。", + "typeAnswerHelp": "输入答案 · 退格编辑 · 回车提交/下一步 · ↑ 选择预设 · Esc 手动输入", + "otherLabel": "其他", + "selectMultiMove": "↑/↓ 移动 · 空格切换 · 回车提交/下一步 · Esc 手动输入", + "selectSingleMove": "↑/↓ 移动 · 回车选择/下一步 · Esc 手动输入" + } + } +} diff --git a/locales/zh-CN/ui-config.json b/locales/zh-CN/ui-config.json new file mode 100644 index 0000000..2585545 --- /dev/null +++ b/locales/zh-CN/ui-config.json @@ -0,0 +1,20 @@ +{ + "ui": { + "config": { + "title": "设置", + "language": "语言", + "thinkingLanguage": "推理语言", + "replyLanguage": "回复语言", + "selectLanguage": "选择语言", + "selectCategoryHelp": "空格/回车选择 · Esc 取消", + "selectLanguageHelp": "空格/回车确认 · Esc 返回", + "currentLabel": "当前", + "localeEn": "English", + "localeZhCN": "中文", + "categoryWithValue": "{label}（{value}）", + "languageUpdated": "语言：{locale}", + "thinkingLanguageUpdated": "推理语言：{locale}", + "replyLanguageUpdated": "回复语言：{locale}" + } + } +} diff --git a/locales/zh-CN/ui-dropdowns.json b/locales/zh-CN/ui-dropdowns.json new file mode 100644 index 0000000..8b0cd73 --- /dev/null +++ b/locales/zh-CN/ui-dropdowns.json @@ -0,0 +1,47 @@ +{ + "ui": { + "dropdownMenu": { + "emptyText": "无可用项目", + "above": "上方 {n} 项", + "more": "下方 {n} 项" + }, + "fileMentionMenu": { + "title": "引用文件", + "helpText": "回车/Tab 插入 · Esc 关闭", + "noMatching": "无匹配文件", + "typeHint": "在 @ 后输入搜索文件", + "directory": "目录", + "file": "文件" + }, + "modelsDropdown": { + "thinkingMax": "思考模式 [最大]", + "thinkingHigh": "思考模式 [高]", + "noThinking": "不思考", + "currentModel": "当前模型", + "reasoningEffort": "努力程度：{value}", + "thinkingDisabled": "思考已禁用", + "selectModel": "选择模型", + "selectThinkingMode": "选择思考模式", + "selectModelHelp": "空格/回车选择模型 · Esc 取消", + "applyHelp": "空格/回车确认 · Esc 取消" + }, + "rawModelDropdown": { + "title": "选择模式", + "helpText": "空格/回车选择模式 · Esc 关闭", + "liteMode": "精简模式", + "normalMode": "标准模式", + "rawScrollbackMode": "原始回滚模式", + "liteDesc": "折叠思维链推理内容。", + "normalDesc": "显示完整的思维链推理内容。", + "rawDesc": "显示回滚模式，便于终端复制。" + }, + "skillsDropdown": { + "title": "选择技能", + "helpText": "空格切换 · 回车切换 · Esc 关闭", + "emptyText": "未找到技能" + }, + "slashCommandMenu": { + "footerHelp": "({current}/{total}) ↑↓ 导航 · 回车选择" + } + } +} diff --git a/locales/zh-CN/ui-exit-summary.json b/locales/zh-CN/ui-exit-summary.json new file mode 100644 index 0000000..6d259a2 --- /dev/null +++ b/locales/zh-CN/ui-exit-summary.json @@ -0,0 +1,12 @@ +{ + "ui": { + "exitSummary": { + "goodbye": "再见！", + "modelUsage": "模型用量", + "reqs": "请求数", + "inputTokens": "输入 Tokens", + "outputTokens": "输出 Tokens", + "cachedTokens": "缓存 Tokens" + } + } +} diff --git a/locales/zh-CN/ui-loading.json b/locales/zh-CN/ui-loading.json new file mode 100644 index 0000000..6db7a7b --- /dev/null +++ b/locales/zh-CN/ui-loading.json @@ -0,0 +1,8 @@ +{ + "ui": { + "loading": { + "thinking": "思考中...", + "thinkingElapsed": "思考中... ({elapsed}秒) · ↓ {tokens} tokens" + } + } +} diff --git a/locales/zh-CN/ui-mcp.json b/locales/zh-CN/ui-mcp.json new file mode 100644 index 0000000..0ea3c3e --- /dev/null +++ b/locales/zh-CN/ui-mcp.json @@ -0,0 +1,31 @@ +{ + "ui": { + "mcp": { + "statusReady": "就绪", + "statusFailed": "失败", + "statusReconnecting": "重连中", + "reconnect": "重连", + "starting": "启动中", + "details": "详情", + "status": "状态", + "enterReconnect": "回车重连 · Esc 返回 · Ctrl+C 关闭", + "scrollBack": "↑/↓ 滚动 · 空格/回车返回 · Esc 返回 · Ctrl+C 关闭", + "spaceBack": "空格/回车返回 · Esc 返回 · Ctrl+C 关闭", + "noItems": "无可用项目", + "footerHelp": "↑/↓ 导航 · 回车查看详情 · Esc 关闭", + "countReady": "{count} 就绪，", + "countStarting": "{count} 启动中，", + "countReconnecting": "{count} 重连中，", + "countFailed": "{count} 失败", + "manageTitle": "管理 MCP 服务器", + "zeroServers": "0 个服务器", + "noServersConfigured": "未配置 MCP 服务器。", + "addServersHint": "将 MCP 服务器添加到设置中以开始使用。", + "escToClose": "Esc 关闭", + "serversAbove": "上方 {n} 个服务器。", + "serversBelow": "下方 {n} 个服务器。", + "itemCounts": "{tools} 个工具，{prompts} 个提示，{resources} 个资源", + "statusPrefix": "状态：{status}" + } + } +} diff --git a/locales/zh-CN/ui-message-view.json b/locales/zh-CN/ui-message-view.json new file mode 100644 index 0000000..c7b21bb --- /dev/null +++ b/locales/zh-CN/ui-message-view.json @@ -0,0 +1,16 @@ +{ + "ui": { + "messageView": { + "thinking": "思考", + "reasoningFallback": "(推理中...)", + "noContent": "(无内容)", + "loadedSkill": "⚡ 已加载技能：{name}", + "conversationSummaryInserted": "(已插入对话摘要)", + "changes": "└ 变更", + "plan": "└ 计划", + "result": "└ 结果", + "toolName": "工具", + "imageAttachment": "张图片" + } + } +} diff --git a/locales/zh-CN/ui-process-stdout.json b/locales/zh-CN/ui-process-stdout.json new file mode 100644 index 0000000..21ddfff --- /dev/null +++ b/locales/zh-CN/ui-process-stdout.json @@ -0,0 +1,16 @@ +{ + "ui": { + "processStdout": { + "noAdjustableTimeout": "无可用 Bash 超时调整", + "processLabel": "── 进程 {pid} [{command}] ──", + "noOutputYet": "（暂无输出）", + "noRunning": "（无运行中的进程）", + "scrollHint": "...（上方 {start} 行 · ↑/↓ 滚动 · 共 {total} 行）...", + "title": "📟 进程输出", + "footerHelp": "（{timeoutHint} · +/- 调整 · Ctrl+O 或 Esc 关闭 · ↑↓ PageUp/PageDown 滚动）", + "timeoutUnavailable": "超时不可用", + "timeoutHint": "超时 {duration}", + "timeoutSet": "超时已设为 {duration}" + } + } +} diff --git a/locales/zh-CN/ui-prompt-input.json b/locales/zh-CN/ui-prompt-input.json new file mode 100644 index 0000000..82e380a --- /dev/null +++ b/locales/zh-CN/ui-prompt-input.json @@ -0,0 +1,25 @@ +{ + "ui": { + "promptInput": { + "interrupting": "正在中断…", + "imageAttached": "已从剪贴板粘贴图片", + "noImageFound": "剪贴板中没有图片", + "readingClipboard": "正在读取剪贴板...", + "failedClipboard": "读取剪贴板失败", + "clearedImages": "已清除粘贴的图片", + "noImagesToClear": "没有需要清除的图片", + "placeholder": "输入你的消息...", + "waitForResponse": "请等待当前响应完成，或按 esc 中断", + "pressCtrlDExit": "按 ctrl+d 退出", + "pressCtrlDAgain": "再按一次 ctrl+d 退出", + "footer": "回车发送 · shift+回车换行 · @ 文件 · ctrl+v 图片 · / 命令 · ctrl+d 退出", + "footerBusy": "esc 中断 · ctrl+c 取消输入", + "ctrlOViewOutput": " · ctrl+o 查看输出", + "ctrlOExpand": " · ctrl+o 展开", + "ctrlOCollapse": " · ctrl+o 折叠", + "noPasteMarker": "光标位置没有粘贴标记", + "pasteNotFound": "找不到粘贴内容", + "imageCount": "📎 {count} 张图片已粘贴" + } + } +} diff --git a/locales/zh-CN/ui-session-list.json b/locales/zh-CN/ui-session-list.json new file mode 100644 index 0000000..bb411bc --- /dev/null +++ b/locales/zh-CN/ui-session-list.json @@ -0,0 +1,25 @@ +{ + "ui": { + "sessionList": { + "title": "会话", + "empty": "暂无会话", + "searchHint": "输入搜索…", + "searchQuery": "搜索：{query}", + "escBack": "按 Esc 返回。", + "total": "共", + "matched": "，匹配 {n} 个", + "noMatch": "没有匹配 \"{query}\" 的会话。", + "untitled": "无标题", + "above": "上方 {n} 个会话。", + "below": "下方 {n} 个会话。", + "footerHelp": "输入搜索 · ↑/↓ 导航 · PgUp/PgDn 翻页 · 回车选择 · Esc 取消", + "footerSearch": "Esc 清除搜索 · ↑/↓ 导航 · 回车选择 · Esc 再次取消", + "statusDone": "已完成", + "statusRunning": "运行中", + "statusPending": "待处理", + "statusWaiting": "等待中", + "statusFailed": "失败", + "statusStopped": "已停止" + } + } +} diff --git a/locales/zh-CN/ui-slash-commands.json b/locales/zh-CN/ui-slash-commands.json new file mode 100644 index 0000000..5b96cbc --- /dev/null +++ b/locales/zh-CN/ui-slash-commands.json @@ -0,0 +1,18 @@ +{ + "ui": { + "slashCommands": { + "skillsDesc": "列出可用技能", + "modelDesc": "选择模型、思考模式和努力程度", + "newDesc": "开始新的对话", + "initDesc": "初始化 AGENTS.md 文件为 LLM 添加指令", + "resumeDesc": "选择之前的对话继续", + "continueDesc": "继续当前对话，或选择一个对话恢复", + "undoDesc": "恢复到之前的代码和/或对话", + "mcpDesc": "显示 MCP 服务器状态和可用工具", + "rawDesc": "切换显示模式以查看或折叠推理内容", + "exitDesc": "退出 Deep Code CLI", + "configDesc": "配置设置：语言、模型等", + "noDescription": "(无描述)" + } + } +} diff --git a/locales/zh-CN/ui-undo.json b/locales/zh-CN/ui-undo.json new file mode 100644 index 0000000..4513c0f --- /dev/null +++ b/locales/zh-CN/ui-undo.json @@ -0,0 +1,23 @@ +{ + "ui": { + "undo": { + "restoreFiles": "从记录的 Git 检查点恢复文件，然后分支对话。", + "noCheckpoint": "此提示没有记录的代码检查点。" + }, + "undoSelector": { + "nothingYet": "暂无内容可撤销。", + "escBack": "按 Esc 返回。", + "title": "撤销", + "subtitle": "恢复到某个提示之前的节点", + "checkpointAvailable": "代码检查点可用", + "conversationOnly": "仅对话", + "selectedPrompt": "已选提示：", + "restoreCodeAndConversation": "恢复代码和对话", + "restoreConversation": "恢复对话", + "forkConversation": "分支对话而不更改文件。", + "footerMessage": "↑/↓ 导航 · 回车选择 · Esc 取消", + "footerMode": "↑/↓ 选择恢复模式 · 回车恢复 · Esc 返回", + "emptyMessage": "(空消息)" + } + } +} diff --git a/locales/zh-CN/ui-update-prompt.json b/locales/zh-CN/ui-update-prompt.json new file mode 100644 index 0000000..3d16a70 --- /dev/null +++ b/locales/zh-CN/ui-update-prompt.json @@ -0,0 +1,11 @@ +{ + "ui": { + "updatePrompt": { + "title": "Deep Code 新版本已发布：{currentVersion} -> {latestVersion}", + "installLabel": "使用 `{installCommand}` 安装最新版本", + "ignoreOnce": "忽略一次", + "ignoreVersion": "忽略此版本（{latestVersion}）", + "footerHelp": "↑/↓ 选择 · 回车确认 · Esc 忽略一次" + } + } +} diff --git a/locales/zh-CN/ui-welcome.json b/locales/zh-CN/ui-welcome.json new file mode 100644 index 0000000..9ed77a7 --- /dev/null +++ b/locales/zh-CN/ui-welcome.json @@ -0,0 +1,16 @@ +{ + "ui": { + "welcome": { + "sendPrompt": "发送提示", + "insertNewline": "插入新行", + "pasteImage": "从剪贴板粘贴图片", + "interrupt": "中断当前模型响应", + "openMenu": "打开技能和命令菜单", + "quit": "退出 Deep Code CLI", + "thinkingEnabled": "思考模式", + "reasoningEffort": "思考努力程度", + "model": "模型", + "cwd": "当前目录" + } + } +} diff --git a/package.json b/package.json index ef70520..31e015f 100644 --- a/package.json +++ b/package.json @@ -18,6 +18,7 @@ "templates/tools/**", "templates/prompts/**", "templates/skills/**", + "locales/**", "README.md", "LICENSE" ], @@ -35,6 +36,7 @@ "build": "npm run check && npm run bundle && node -e \"require('fs').chmodSync('dist/cli.js', 0o755)\"", "test": "node src/tests/run-tests.mjs", "test:single": "tsx --test", + "check:i18n": "node scripts/check-i18n.mjs", "prepack": "npm run build", "prepare": "husky" }, diff --git a/scripts/check-i18n.mjs b/scripts/check-i18n.mjs new file mode 100644 index 0000000..75f0dba --- /dev/null +++ b/scripts/check-i18n.mjs @@ -0,0 +1,77 @@ +#!/usr/bin/env node + +/** + * check-i18n.mjs + * + * Validates i18n translation files: + * 1. Reads all *.json files from en/ and zh-CN/ directories + * 2. Checks that every flattened key in en/ exists in zh-CN/ + * 3. Reports missing keys + * 4. Exits with code 1 if there are missing keys, 0 otherwise + */ + +import { readFileSync, existsSync, readdirSync } from "fs"; +import { resolve, dirname } from "path"; +import { fileURLToPath } from "url"; + +const __dirname = dirname(fileURLToPath(import.meta.url)); +const localesDir = resolve(__dirname, "..", "locales"); + +function flattenKeys(obj, prefix = "") { + const result = {}; + for (const [key, value] of Object.entries(obj)) { + const newKey = prefix ? `${prefix}.${key}` : key; + if (typeof value === "string") { + result[newKey] = value; + } else if (value && typeof value === "object") { + Object.assign(result, flattenKeys(value, newKey)); + } + } + return result; +} + +function loadLocale(locale) { + const localePath = resolve(localesDir, locale); + if (!existsSync(localePath)) { + console.log(`[check-i18n] ${locale}/ directory not found, skipping.`); + return {}; + } + + const merged = {}; + const files = readdirSync(localePath) + .filter((f) => f.endsWith(".json")) + .sort(); + + if (files.length === 0) { + console.log(`[check-i18n] No JSON files found in ${locale}/.`); + return {}; + } + + for (const file of files) { + const filePath = resolve(localePath, file); + try { + const content = JSON.parse(readFileSync(filePath, "utf8")); + Object.assign(merged, flattenKeys(content)); + } catch (err) { + console.error(`[check-i18n] Error reading ${locale}/${file}: ${err.message}`); + } + } + + return merged; +} + +const enKeys = Object.keys(loadLocale("en")); +const zhKeys = new Set(Object.keys(loadLocale("zh-CN"))); + +const missing = enKeys.filter((key) => !zhKeys.has(key)); + +if (missing.length === 0) { + console.log(`[check-i18n] \u2705 All ${enKeys.length} keys match between en/ and zh-CN/.`); + process.exit(0); +} + +console.log(`[check-i18n] \u274c Missing ${missing.length} keys in zh-CN/ (compared to en/):`); +for (const key of missing) { + console.log(` - ${key}`); +} +process.exit(1); diff --git a/src/cli.tsx b/src/cli.tsx index c3876ae..52a671b 100644 --- a/src/cli.tsx +++ b/src/cli.tsx @@ -3,10 +3,20 @@ import { render } from "ink"; import { setShellIfWindows } from "./common/shell-utils"; import { checkForNpmUpdate, promptForPendingUpdate, type PackageInfo } from "./updateCheck"; import { AppContainer } from "./ui"; +import { t } from "./common/i18n"; +import { initI18n } from "./common/i18n"; +import { resolveCurrentSettings } from "./ui/App"; const args = process.argv.slice(2); const packageInfo = readPackageInfo(); +// Initialize i18n early so --help and --version can use translations +const settings = resolveCurrentSettings(process.cwd()); +initI18n(settings.locale, { + thinkingLocale: settings.thinkingLocale, + replyLocale: settings.replyLocale, +}); + if (args.includes("--version") || args.includes("-v")) { process.stdout.write(`${packageInfo.version || "unknown"}\n`); process.exit(0); @@ -15,43 +25,44 @@ if (args.includes("--version") || args.includes("-v")) { if (args.includes("--help") || args.includes("-h")) { process.stdout.write( [ - "deepcode - Deep Code CLI", + t("cli.help.title"), "", - "Usage:", - " deepcode Launch the interactive TUI in the current directory", - " deepcode -p Launch with a pre-filled prompt", - " deepcode --prompt Same as -p", - " deepcode --version Print the version", - " deepcode --help Show this help", + t("cli.help.usage"), + t("cli.help.launchTui"), + t("cli.help.launchWithPrompt"), + t("cli.help.launchWithPromptLong"), + t("cli.help.printVersion"), + t("cli.help.printHelp"), "", - "Configuration:", - " ~/.deepcode/settings.json User-level API key, model, base URL", - " ./.deepcode/settings.json Project-level settings", - " ~/.agents/skills/*/SKILL.md User-level skills", - " ./.agents/skills/*/SKILL.md Project-level skills", - " ./.deepcode/skills/*/SKILL.md Legacy project-level skills", + t("cli.help.configSection"), + t("cli.help.userSettings"), + t("cli.help.projectSettings"), + t("cli.help.userSkills"), + t("cli.help.projectSkills"), + t("cli.help.legacySkills"), "", - "Inside the TUI:", - " enter Send the prompt", - " shift+enter Insert a newline", - " home/end Move within the current line", - " alt+left/right Move by word", - " ctrl+w Delete the previous word", - " ctrl+v Paste an image from the clipboard", - " ctrl+x Clear pasted images", - " esc Interrupt the current model turn", - " / Open the skills/commands menu", - " /skills List available skills", - " /model Select model, thinking mode and effort control", - " /new Start a fresh conversation", - " /init Initialize an AGENTS.md file with instructions for LLM", - " /resume Pick a previous conversation to continue", - " /continue Continue the active conversation, or resume one if empty", - " /undo Restore code and/or conversation to a previous point", - " /mcp Show MCP server status and available tools", - " /raw Toggle display mode for viewing or collapsing reasoning content", - " /exit Quit", - " ctrl+d twice Quit", + t("cli.help.tuiSection"), + t("cli.help.enterSend"), + t("cli.help.shiftEnterNewline"), + t("cli.help.homeEnd"), + t("cli.help.altLeftRight"), + t("cli.help.ctrlW"), + t("cli.help.ctrlV"), + t("cli.help.ctrlX"), + t("cli.help.esc"), + t("cli.help.slash"), + t("cli.help.slashSkills"), + t("cli.help.slashModel"), + t("cli.help.slashNew"), + t("cli.help.slashInit"), + t("cli.help.slashResume"), + t("cli.help.slashContinue"), + t("cli.help.slashUndo"), + t("cli.help.slashMcp"), + t("cli.help.slashRaw"), + t("cli.help.slashExit"), + t("cli.help.slashConfig"), + t("cli.help.ctrlD"), ].join("\n") + "\n" ); process.exit(0); @@ -70,7 +81,7 @@ const projectRoot = process.cwd(); configureWindowsShell(); if (!process.stdin.isTTY) { - process.stderr.write("deepcode requires an interactive terminal (TTY). " + "Re-run from a real terminal session.\n"); + process.stderr.write(t("cli.help.ttyRequired") + "\n"); process.exit(1); } @@ -85,12 +96,23 @@ async function main(): Promise { let restarting = false; const appInitialPrompt = initialPrompt; initialPrompt = undefined; + + // Initialize i18n before rendering + const settings = resolveCurrentSettings(projectRoot); + initI18n(settings.locale, { + thinkingLocale: settings.thinkingLocale, + replyLocale: settings.replyLocale, + }); + const inkInstance = render( restartRef.current?.()} + initialLocale={settings.locale} + initialThinkingLocale={settings.thinkingLocale} + initialReplyLocale={settings.replyLocale} />, { exitOnCtrlC: false } ); diff --git a/src/common/display-width.ts b/src/common/display-width.ts new file mode 100644 index 0000000..3ec5689 --- /dev/null +++ b/src/common/display-width.ts @@ -0,0 +1,50 @@ +/** + * Returns the visual display width of a string in a terminal. + * + * CJK characters (Chinese, Japanese, Korean) typically occupy 2 columns, + * while ASCII characters and most symbols occupy 1 column. + * Emoji surrogate pairs are also counted as 2. + */ +export function displayWidth(value: string): number { + let width = 0; + for (const char of value) { + const code = char.codePointAt(0)!; + if (code > 0xffff) { + // Surrogate pair (emoji etc.) — typically 2 wide + width += 2; + } else if ( + (code >= 0x1100 && code <= 0x115f) || // Hangul Jamo + (code >= 0x2e80 && code <= 0xa4cf) || // CJK Radicals, Kangxi, Ideographs + (code >= 0xa960 && code <= 0xa97f) || // Hangul Jamo Extended-A + (code >= 0xac00 && code <= 0xd7a3) || // Hangul Syllables + (code >= 0xf900 && code <= 0xfaff) || // CJK Compatibility Ideographs + (code >= 0xfe30 && code <= 0xfe6f) || // CJK Compatibility Forms + (code >= 0xff01 && code <= 0xff60) || // Fullwidth Forms + (code >= 0xffe0 && code <= 0xffe6) // Fullwidth Signs + ) { + width += 2; + } else { + width += 1; + } + } + return width; +} + +/** + * Truncate a string to roughly `maxCols` visual display columns. + * + * Uses `displayWidth()` so CJK text is counted correctly (2 cols per char). + * Avoids splitting surrogate pairs (emoji) by checking character boundaries. + * Appends "…" when truncated. + */ +export function truncateDisplay(value: string, maxCols: number): string { + let cols = 0; + for (let i = 0; i < value.length; i++) { + const charWidth = displayWidth(value[i]); + if (cols + charWidth > maxCols) { + return value.slice(0, i) + "…"; + } + cols += charWidth; + } + return value; +} diff --git a/src/common/i18n.ts b/src/common/i18n.ts new file mode 100644 index 0000000..3a6bf70 --- /dev/null +++ b/src/common/i18n.ts @@ -0,0 +1,186 @@ +import * as fs from "fs"; +import * as path from "path"; +import { fileURLToPath } from "url"; + +// --------------- Types --------------- + +export type Locale = "en" | "zh-CN"; + +// Translation key type — dot-notation string like "ui.messageView.thinking" +// Runtime validates against loaded locale JSON; missing keys fall back to key itself. +export type TranslationKey = string; + +// --------------- Internal State --------------- + +const localeCache = new Map>(); + +let currentLocale: Locale = "en"; +let thinkingLocale: Locale = "en"; +let replyLocale: Locale = "en"; + +// --------------- Helpers --------------- + +function getExtensionRoot(): string { + // Prefer __dirname which is available in the CJS bundle output. + // Fall back to import.meta.url for ESM test environments. + if (typeof __dirname !== "undefined") { + return path.resolve(__dirname, ".."); + } + const currentFile = fileURLToPath(import.meta.url); + // In the ESM bundle (dist/cli.js), go up 1 level to reach project root. + // In tsx dev mode (src/common/i18n.ts), go up 2 levels. + const levels = currentFile.replace(/\\/g, "/").includes("/dist/") ? 1 : 2; + return levels === 1 + ? path.resolve(path.dirname(currentFile), "..") + : path.resolve(path.dirname(currentFile), "..", ".."); +} + +function flattenKeys(obj: Record, prefix = ""): Record { + const result: Record = {}; + for (const [key, value] of Object.entries(obj)) { + const newKey = prefix ? `${prefix}.${key}` : key; + if (typeof value === "string") { + result[newKey] = value; + } else if (value && typeof value === "object") { + Object.assign(result, flattenKeys(value as Record, newKey)); + } + } + return result; +} + +function loadLocaleDir(locale: string): Record { + if (localeCache.has(locale)) { + return localeCache.get(locale)!; + } + + const localesDir = path.resolve(getExtensionRoot(), "locales", locale); + if (!fs.existsSync(localesDir)) { + localeCache.set(locale, {}); + return {}; + } + + const merged: Record = {}; + const files = fs + .readdirSync(localesDir) + .filter((f) => f.endsWith(".json")) + .sort(); + + for (const file of files) { + const filePath = path.join(localesDir, file); + try { + const content = JSON.parse(fs.readFileSync(filePath, "utf8")); + Object.assign(merged, flattenKeys(content)); + } catch { + // Skip malformed files silently + } + } + + localeCache.set(locale, merged); + return merged; +} + +function interpolate(template: string, params: Record): string { + return template.replace(/\{(\w+)\}/g, (_, key: string) => { + const value = params[key]; + return value !== undefined ? String(value) : `{${key}}`; + }); +} + +/** + * Detect the best locale from the environment. + * Checks LANG env var, then falls back to "en". + */ +function detectLocale(): Locale { + const lang = process.env.LANG ?? ""; + if (lang.toLowerCase().includes("zh_CN") || lang.toLowerCase().includes("zh-cn")) { + return "zh-CN"; + } + return "en"; +} + +// --------------- Public API --------------- + +/** + * Initialize i18n by loading translations for the given locale. + * Also loads en/ as fallback. + * Options: thinkingLocale and replyLocale default to main locale if not set. + */ +export function initI18n(locale: Locale, options?: { thinkingLocale?: Locale; replyLocale?: Locale }): void { + currentLocale = locale; + thinkingLocale = options?.thinkingLocale ?? locale; + replyLocale = options?.replyLocale ?? locale; + + // Pre-load main locale and fallback (en/) + loadLocaleDir(locale); + if (locale !== "en") { + loadLocaleDir("en"); + } +} + +/** + * Translate a key to the current locale's string. + * @param key - Translation key (dot-notation, auto-completed via TranslationKey) + * @param params - Optional placeholder values for {placeholder} in the string + * @param localeOverride - Optional: look up from a different locale (for system prompt language instructions) + */ +export function t(key: TranslationKey, params?: Record, localeOverride?: Locale): string { + // Determine which locale to read from + const targetLocale = localeOverride ?? currentLocale; + + // Try target locale + const targetMessages = localeCache.get(targetLocale); + if (targetMessages && key in targetMessages) { + const msg = targetMessages[key]; + return params ? interpolate(msg, params) : msg; + } + + // Fallback to en/ (unless we already tried en) + if (targetLocale !== "en") { + const enMessages = localeCache.get("en"); + if (enMessages && key in enMessages) { + const msg = enMessages[key]; + return params ? interpolate(msg, params) : msg; + } + } + + // Not found in any locale — return key as self-documentation + return key; +} + +/** Get the current UI locale. */ +export function getLocale(): Locale { + return currentLocale; +} + +/** Get the current thinking (reasoning) locale. */ +export function getThinkingLocale(): Locale { + return thinkingLocale; +} + +/** Get the current reply locale. */ +export function getReplyLocale(): Locale { + return replyLocale; +} + +/** Set the thinking (reasoning) locale. */ +export function setThinkingLocale(locale: Locale): void { + thinkingLocale = locale; +} + +/** Set the reply locale. */ +export function setReplyLocale(locale: Locale): void { + replyLocale = locale; +} + +/** Reset i18n state (for testing). */ +export function resetI18n(): void { + localeCache.clear(); + currentLocale = "en"; + thinkingLocale = "en"; + replyLocale = "en"; +} + +/** Detect locale from environment. */ +export function getDetectedLocale(): Locale { + return detectLocale(); +} diff --git a/src/prompt.ts b/src/prompt.ts index 717991b..a105f69 100644 --- a/src/prompt.ts +++ b/src/prompt.ts @@ -7,6 +7,7 @@ import ejs from "ejs"; import type { SessionMessage } from "./session"; import { findGitBashPath, resolveShellPath } from "./common/shell-utils"; import { supportsMultimodal } from "./common/model-capabilities"; +import { t, getThinkingLocale, getReplyLocale } from "./common/i18n"; const COMPACT_PROMPT_BASE = `Your task is to create a detailed summary of the conversation so far, paying close attention to the user's explicit requests and your previous actions. This summary should be thorough in capturing technical details, code patterns, and architectural decisions that would be essential for continuing development work without losing context. @@ -154,20 +155,24 @@ export function getDefaultSkillPrompt(): string { ${skill.content} ` ); - return `Use the skill documents below to assist the user:\n${blocks.join("\n\n")}`; + return `${t("prompt.skillDocumentsHeader")}${blocks.join("\n\n")}`; } function getCurrentDateAndModelPrompt(model?: string): string { const date = new Date(); - let prompt = `今天是${date.getFullYear()}年${date.getMonth() + 1}月${date.getDate()}日。随着对话的进行，时间在流逝。`; - prompt += model ? `\n当前LLM模型为${model}，对话中可通过/model命令切换模型。` : ""; + const dateStr = `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}`; + const prompt = t("prompt.dateAndModel", { date: dateStr, model: model || "unknown" }); return prompt; } export function getSystemPrompt(_projectRoot: string, options: PromptToolOptions = {}): string { const toolDocs = readToolDocs(getExtensionRoot(), options); const basePrompt = toolDocs ? `${SYSTEM_PROMPT_BASE}\n\n# Available Tools\n\n${toolDocs}` : SYSTEM_PROMPT_BASE; - return basePrompt; + + // Append language instructions for thinking and reply + const thinkingInstruction = t("prompt.thinkingLanguageInstruction", undefined, getThinkingLocale()); + const replyInstruction = t("prompt.replyLanguageInstruction", undefined, getReplyLocale()); + return `${basePrompt}\n\n${thinkingInstruction}\n${replyInstruction}`; } export function getCompactPrompt(sessionMessages: SessionMessage[]): string { diff --git a/src/session.ts b/src/session.ts index 54340e7..af351ed 100644 --- a/src/session.ts +++ b/src/session.ts @@ -3,6 +3,7 @@ import * as path from "path"; import * as os from "os"; import * as crypto from "crypto"; import { fileURLToPath } from "url"; +import { t } from "./common/i18n"; import matter from "gray-matter"; import ejs from "ejs"; import type { ChatCompletionMessageParam, ChatCompletionContentPart } from "openai/resources/chat/completions"; @@ -983,7 +984,7 @@ The candidate skills are as follows:\n\n`; continue; } const skillMd = fs.readFileSync(this.resolveSkillPath(skill.path), "utf8"); - const skillPrompt = `Use the skill document below to assist the user:\n + const skillPrompt = `${t("session.skillPromptHeader")} <${skill.name}-skill path="${this.resolveSkillPath(skill.path)}"> ${skillMd} `; @@ -1047,7 +1048,7 @@ ${skillMd} continue; } const skillMd = fs.readFileSync(this.resolveSkillPath(skill.path), "utf8"); - const skillPrompt = `Use the skill document below to assist the user:\n + const skillPrompt = `${t("session.skillPromptHeader")} <${skill.name}-skill path="${this.resolveSkillPath(skill.path)}"> ${skillMd} `; @@ -1079,17 +1080,10 @@ ${skillMd} this.updateSessionEntry(sessionId, (entry) => ({ ...entry, status: "failed", - failReason: "OpenAI API key not found", + failReason: t("ui.app.apiKeyNotFound"), updateTime: now, })); - this.onAssistantMessage( - this.buildAssistantMessage( - sessionId, - "OpenAI API key not found. Please configure ~/.deepcode/settings.json or ./.deepcode/settings.json.", - null - ), - false - ); + this.onAssistantMessage(this.buildAssistantMessage(sessionId, t("ui.app.apiKeyNotFound"), null), false); this.maybeNotifyTaskCompletion(sessionId, notify, startedAt, env); return; } @@ -1147,11 +1141,7 @@ ${skillMd} const compactPromptTokenThreshold = getCompactPromptTokenThreshold(model); if (session.activeTokens > compactPromptTokenThreshold) { - const message = this.buildAssistantMessage( - sessionId, - "The conversation is getting long, compacting...", - null - ); + const message = this.buildAssistantMessage(sessionId, t("session.compacting"), null); message.meta = { asThinking: true }; this.onAssistantMessage(message, false); await this.compactSession(sessionId, sessionController.signal); @@ -1237,14 +1227,7 @@ ${skillMd} status: "completed", updateTime: new Date().toISOString(), })); - this.onAssistantMessage( - this.buildAssistantMessage( - sessionId, - "The AI agent has taken several steps but hasn't reached a conclusion yet. Do you want to continue?", - null - ), - false - ); + this.onAssistantMessage(this.buildAssistantMessage(sessionId, t("ui.app.sessionAgentSteps"), null), false); } catch (error) { const errMessage = error instanceof Error ? error.message : String(error); const aborted = this.isAbortLikeError(error) || sessionController.signal.aborted; @@ -1256,7 +1239,10 @@ ${skillMd} })); if (!aborted) { - this.onAssistantMessage(this.buildAssistantMessage(sessionId, `Request failed: ${errMessage}`, null), false); + this.onAssistantMessage( + this.buildAssistantMessage(sessionId, t("ui.app.requestFailed", { error: errMessage }), null), + false + ); } } finally { if (this.sessionControllers.get(sessionId) === sessionController) { @@ -1420,12 +1406,12 @@ ${skillMd} updateTime: now, })); - const contentParts = ["Interrupted."]; + const contentParts = [t("ui.app.interrupted")]; if (killedPids.length > 0) { - contentParts.push(`Killed processes: ${killedPids.join(", ")}.`); + contentParts.push(`${t("ui.app.killedProcesses", { pids: killedPids.join(", ") })}.`); } if (failedPids.length > 0) { - contentParts.push(`Failed to kill processes: ${failedPids.join(", ")}.`); + contentParts.push(`${t("ui.app.failedKillProcesses", { pids: failedPids.join(", ") })}.`); } this.onAssistantMessage(this.buildUserMessage(sessionId, { text: contentParts.join(" ") }), false); diff --git a/src/settings.ts b/src/settings.ts index b5bb869..3e67199 100644 --- a/src/settings.ts +++ b/src/settings.ts @@ -1,4 +1,5 @@ import { defaultsToThinkingMode } from "./common/model-capabilities"; +import type { Locale } from "./common/i18n"; export type DeepcodingEnv = Record & { MODEL?: string; @@ -26,6 +27,9 @@ export type DeepcodingSettings = { notify?: string; webSearchTool?: string; mcpServers?: Record; + locale?: string; + thinkingLocale?: string; + replyLocale?: string; }; export type ResolvedDeepcodingSettings = { @@ -39,6 +43,9 @@ export type ResolvedDeepcodingSettings = { notify?: string; webSearchTool?: string; mcpServers?: Record; + locale: Locale; + thinkingLocale: Locale; + replyLocale: Locale; }; export type ModelConfigSelection = { @@ -222,6 +229,24 @@ export function resolveSettingsSources( trimString(userSettings?.webSearchTool) || ""; + const locale = + trimString(systemEnv.LOCALE) || + trimString(projectSettings?.locale) || + trimString(userSettings?.locale) || + detectLocale(); + + const thinkingLocale = + trimString(systemEnv.THINKING_LOCALE) || + trimString(projectSettings?.thinkingLocale) || + trimString(userSettings?.thinkingLocale) || + (locale as Locale); + + const replyLocale = + trimString(systemEnv.REPLY_LOCALE) || + trimString(projectSettings?.replyLocale) || + trimString(userSettings?.replyLocale) || + (locale as Locale); + return { env, apiKey: trimString(env.API_KEY) || undefined, @@ -233,9 +258,26 @@ export function resolveSettingsSources( notify: notify || undefined, webSearchTool: webSearchTool || undefined, mcpServers: mergeMcpServers(userSettings, projectSettings, userEnv, projectEnv, systemEnv), + locale: resolveLocale(locale), + thinkingLocale: resolveLocale(thinkingLocale), + replyLocale: resolveLocale(replyLocale), }; } +function resolveLocale(value: string): Locale { + const normalized = value.trim().toLowerCase(); + if (normalized === "zh-cn" || normalized === "zh_CN") return "zh-CN"; + return "en"; +} + +function detectLocale(): string { + const lang = process.env.LANG ?? ""; + if (lang.toLowerCase().includes("zh_CN") || lang.toLowerCase().includes("zh-cn")) { + return "zh-CN"; + } + return "en"; +} + export function resolveSettings( settings: DeepcodingSettings | null | undefined, defaults: { model: string; baseURL: string }, diff --git a/src/tests/exitSummary.test.ts b/src/tests/exitSummary.test.ts index 5ea4b57..d62442b 100644 --- a/src/tests/exitSummary.test.ts +++ b/src/tests/exitSummary.test.ts @@ -2,6 +2,9 @@ import { test } from "node:test"; import assert from "node:assert/strict"; import { buildExitSummaryText } from "../ui"; import type { ModelUsage, SessionEntry } from "../session"; +import { initI18n } from "../common/i18n"; + +initI18n("en"); const stripAnsi = (text: string): string => text.replace(/\u001b\[[0-9;]*m/g, ""); diff --git a/src/tests/loadingText.test.ts b/src/tests/loadingText.test.ts index 784fe46..448f4e0 100644 --- a/src/tests/loadingText.test.ts +++ b/src/tests/loadingText.test.ts @@ -1,6 +1,10 @@ import { test } from "node:test"; import assert from "node:assert/strict"; import { buildLoadingText } from "../ui"; +import { initI18n } from "../common/i18n"; + +// Initialize i18n for all tests in this file +initI18n("en"); test("buildLoadingText returns plain Thinking... when no progress", () => { assert.equal(buildLoadingText({ progress: null, now: Date.now() }), "Thinking..."); diff --git a/src/tests/messageView.test.ts b/src/tests/messageView.test.ts index b806dbd..6035ce7 100644 --- a/src/tests/messageView.test.ts +++ b/src/tests/messageView.test.ts @@ -1,6 +1,7 @@ import { test } from "node:test"; import assert from "node:assert/strict"; import { parseDiffPreview } from "../ui"; +import { initI18n } from "../common/i18n"; import { buildThinkingSummary, renderMessageToStdout, @@ -9,6 +10,8 @@ import { } from "../ui/components/MessageView/utils"; import { RawMode } from "../ui/contexts"; import type { SessionMessage } from "../session"; + +initI18n("en"); import type { ToolSummary } from "../ui/components/MessageView/types"; test("parseDiffPreview removes headers and classifies lines", () => { diff --git a/src/tests/prompt.test.ts b/src/tests/prompt.test.ts index cc86712..a3f3d0a 100644 --- a/src/tests/prompt.test.ts +++ b/src/tests/prompt.test.ts @@ -4,7 +4,9 @@ import * as fs from "fs"; import * as path from "path"; import { fileURLToPath } from "url"; import { getDefaultSkillPrompt, getRuntimeContext, getSystemPrompt, getTools } from "../prompt"; +import { initI18n, t } from "../common/i18n"; +initI18n("en"); const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); test("getTools always includes WebSearch", () => { @@ -50,17 +52,19 @@ test("getDefaultSkillPrompt loads default skill templates in order", () => { test("getSystemPrompt does not include current date guidance", () => { const now = new Date(); - const expected = `今天是${now.getFullYear()}年${now.getMonth() + 1}月${now.getDate()}日。随着对话的进行，时间在流逝。`; + const dateStr = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}`; + const expected = t("prompt.dateAndModel", { date: dateStr, model: "deepseek-v4-pro" }); const prompt = getSystemPrompt("/tmp/project"); assert.equal(prompt.includes(expected), false); }); test("getRuntimeContext includes current date and model guidance", () => { const now = new Date(); - const expectedDate = `今天是${now.getFullYear()}年${now.getMonth() + 1}月${now.getDate()}日。随着对话的进行，时间在流逝。`; + const dateStr = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}`; + const expectedDate = t("prompt.dateAndModel", { date: dateStr, model: "deepseek-v4-pro" }); const prompt = getRuntimeContext("/tmp/project", "deepseek-v4-pro"); assert.equal(prompt.includes(expectedDate), true); - assert.equal(prompt.includes("当前LLM模型为deepseek-v4-pro，对话中可通过/model命令切换模型。"), true); + assert.equal(prompt.includes("Current LLM model is deepseek-v4-pro"), true); assert.equal(prompt.includes("# Local Workspace Environment"), true); assert.equal(prompt.includes('"root path": "/tmp/project"'), true); }); diff --git a/src/tests/promptInputKeys.test.ts b/src/tests/promptInputKeys.test.ts index 4f8b4d9..3323804 100644 --- a/src/tests/promptInputKeys.test.ts +++ b/src/tests/promptInputKeys.test.ts @@ -1,5 +1,8 @@ import { test } from "node:test"; import assert from "node:assert/strict"; +import { initI18n } from "../common/i18n"; + +initI18n("en"); const ANSI_RE = /\u001b\[[0-9;]*m/g; function stripAnsi(text: string): string { @@ -245,8 +248,8 @@ test("parseTerminalInput recognizes ctrl+shift+- modifyOtherKeys sequence (exten test("formatImageAttachmentStatus formats the image count label", () => { assert.equal(formatImageAttachmentStatus(0), ""); - assert.equal(formatImageAttachmentStatus(1), "📎 1 image attached"); - assert.equal(formatImageAttachmentStatus(2), "📎 2 images attached"); + assert.equal(formatImageAttachmentStatus(1), "\uD83D\uDCCE 1 image(s) attached"); + assert.equal(formatImageAttachmentStatus(2), "\uD83D\uDCCE 2 image(s) attached"); assert.equal(IMAGE_ATTACHMENT_CLEAR_HINT, "ctrl+x clear images"); }); diff --git a/src/tests/session.test.ts b/src/tests/session.test.ts index fd83199..a6f88f3 100644 --- a/src/tests/session.test.ts +++ b/src/tests/session.test.ts @@ -5,7 +5,9 @@ import * as fs from "fs"; import * as os from "os"; import * as path from "path"; import { SessionManager, type SessionMessage } from "../session"; +import { initI18n } from "../common/i18n"; +initI18n("en"); const originalFetch = globalThis.fetch; const originalConsoleWarn = console.warn; const originalHome = process.env.HOME; @@ -684,13 +686,13 @@ test("createSession appends default system prompts in prefix-cache-friendly orde assert.equal(systemContents.length >= 4, true); assert.match(systemContents[0] ?? "", /# Available Tools/); assert.doesNotMatch(systemContents[0] ?? "", /# Local Workspace Environment/); - assert.doesNotMatch(systemContents[0] ?? "", /当前LLM模型为test-model/); + assert.doesNotMatch(systemContents[0] ?? "", /Current LLM model is test-model/); assert.match(systemContents[1] ?? "", //); assert.match(systemContents[1] ?? "", //); assert.doesNotMatch(systemContents[1] ?? "", /path="templates\/skills\//); - assert.doesNotMatch(systemContents[1] ?? "", /当前LLM模型为test-model/); + assert.doesNotMatch(systemContents[1] ?? "", /Current LLM model is test-model/); assert.match(systemContents[2] ?? "", /# Local Workspace Environment/); - assert.match(systemContents[2] ?? "", /当前LLM模型为test-model/); + assert.match(systemContents[2] ?? "", /Current LLM model is test-model/); const environmentJsonMatch = (systemContents[2] ?? "").match(/```json\n([\s\S]+?)\n```/); assert.ok(environmentJsonMatch); const environmentInfo = JSON.parse(environmentJsonMatch[1] ?? "{}") as { "root path"?: string }; diff --git a/src/tests/sessionList.test.ts b/src/tests/sessionList.test.ts index 3dfda33..c60a8fe 100644 --- a/src/tests/sessionList.test.ts +++ b/src/tests/sessionList.test.ts @@ -2,6 +2,9 @@ import { test } from "node:test"; import assert from "node:assert/strict"; import { formatSessionTitle, filterSessions, formatSessionStatus } from "../ui"; import type { SessionEntry } from "../session"; +import { initI18n } from "../common/i18n"; + +initI18n("en"); test("formatSessionTitle replaces newlines with spaces", () => { assert.equal(formatSessionTitle("first line\nsecond line\r\nthird"), "first line second line third"); diff --git a/src/tests/slashCommands.test.ts b/src/tests/slashCommands.test.ts index 30d77ee..2dbfb2d 100644 --- a/src/tests/slashCommands.test.ts +++ b/src/tests/slashCommands.test.ts @@ -1,5 +1,6 @@ import { test } from "node:test"; import assert from "node:assert/strict"; +import { initI18n } from "../common/i18n"; import { buildSlashCommands, filterSlashCommands, @@ -9,6 +10,8 @@ import { } from "../ui"; import type { SkillInfo } from "../session"; +initI18n("en"); + const skills: SkillInfo[] = [ { name: "skill-writer", path: "~/.agents/skills/skill-writer/SKILL.md", description: "Write a SKILL.md" }, { name: "code-review", path: "~/.agents/skills/code-review/SKILL.md", description: "Review code" }, @@ -30,6 +33,7 @@ test("buildSlashCommands prefixes skills before built-ins", () => { "mcp", "raw", "exit", + "config", ]); }); @@ -67,7 +71,7 @@ test("findExactSlashCommand returns built-in /init", () => { const item = findExactSlashCommand(items, "/init"); assert.ok(item); assert.equal(item?.kind, "init"); - assert.equal(item?.description, "Initialize an AGENTS.md file with instructions for LLM"); + assert.equal(item?.name, "init"); }); test("findExactSlashCommand returns built-in /continue", () => { diff --git a/src/ui/App.tsx b/src/ui/App.tsx index 5419a2a..5f988ea 100644 --- a/src/ui/App.tsx +++ b/src/ui/App.tsx @@ -40,6 +40,8 @@ import { } from "./askUserQuestion"; import { buildExitSummaryText } from "./exitSummary"; import { RawMode, useRawModeContext } from "./contexts"; +import { useI18n } from "./contexts/i18n"; +import { type Locale, t } from "../common/i18n"; import { renderMessageToStdout } from "./components/MessageView/utils"; const DEFAULT_MODEL = "deepseek-v4-pro"; @@ -58,6 +60,7 @@ export function App({ projectRoot, initialPrompt, onRestart }: AppProps): React. const { stdout, write } = useStdout(); const { columns, rows } = useWindowSize(); const { mode, setMode } = useRawModeContext(); + const { locale, setLocale, thinkingLocale, replyLocale, setThinkingLocale, setReplyLocale } = useI18n(); const initialPromptSubmittedRef = useRef(false); const processStdoutRef = useRef>(new Map()); const rawModeRef = useRef(mode); @@ -237,7 +240,7 @@ export function App({ projectRoot, initialPrompt, onRestart }: AppProps): React. if (submission.command === "undo") { const activeSessionId = sessionManager.getActiveSessionId(); if (!activeSessionId) { - setErrorLine("No active session to undo."); + setErrorLine(t("ui.app.noActiveSession")); return; } setShowWelcome(false); @@ -308,6 +311,33 @@ export function App({ projectRoot, initialPrompt, onRestart }: AppProps): React. [sessionManager] ); + const handleLocaleChange = useCallback( + (newLocale: Locale): void => { + setLocale(newLocale); + const rawSettings = readSettings(); + writeSettings({ ...(rawSettings ?? {}), locale: newLocale }); + }, + [setLocale] + ); + + const handleThinkingLocaleChange = useCallback( + (newLocale: Locale): void => { + setThinkingLocale(newLocale); + const rawSettings = readSettings(); + writeSettings({ ...(rawSettings ?? {}), thinkingLocale: newLocale }); + }, + [setThinkingLocale] + ); + + const handleReplyLocaleChange = useCallback( + (newLocale: Locale): void => { + setReplyLocale(newLocale); + const rawSettings = readSettings(); + writeSettings({ ...(rawSettings ?? {}), replyLocale: newLocale }); + }, + [setReplyLocale] + ); + const handleModelConfigChange = useCallback( (selection: ModelConfigSelection): string => { const current = resolveCurrentSettings(projectRoot); @@ -316,7 +346,7 @@ export function App({ projectRoot, initialPrompt, onRestart }: AppProps): React. setResolvedSettings(next); if (!changed) { - return "Model settings unchanged"; + return t("ui.app.modelUnchanged"); } const activeSessionId = sessionManager.getActiveSessionId(); @@ -347,7 +377,10 @@ export function App({ projectRoot, initialPrompt, onRestart }: AppProps): React. ]); } - return `Model settings updated: ${formatModelConfig(current)} → ${formatModelConfig(next)}`; + return t("ui.app.modelUpdated", { + before: formatModelConfig(current), + after: formatModelConfig(next), + }); }, [projectRoot, sessionManager] ); @@ -416,7 +449,7 @@ export function App({ projectRoot, initialPrompt, onRestart }: AppProps): React. async (target: UndoTarget, restoreMode: UndoRestoreMode): Promise => { const sessionId = sessionManager.getActiveSessionId(); if (!sessionId) { - setErrorLine("No active session to undo."); + setErrorLine(t("ui.app.noActiveSession")); setView("chat"); setShowWelcome(true); return; @@ -427,7 +460,7 @@ export function App({ projectRoot, initialPrompt, onRestart }: AppProps): React. try { sessionManager.restoreSessionCode(sessionId, target.message.id); } catch (error) { - errors.push(`Code restore failed: ${error instanceof Error ? error.message : String(error)}`); + errors.push(t("ui.app.codeRestoreFailed", { error: error instanceof Error ? error.message : String(error) })); } } @@ -436,7 +469,9 @@ export function App({ projectRoot, initialPrompt, onRestart }: AppProps): React. sessionManager.restoreSessionConversation(sessionId, target.message.id); conversationRestored = true; } catch (error) { - errors.push(`Conversation restore failed: ${error instanceof Error ? error.message : String(error)}`); + errors.push( + t("ui.app.conversationRestoreFailed", { error: error instanceof Error ? error.message : String(error) }) + ); } refreshSessionsList(); @@ -472,12 +507,12 @@ export function App({ projectRoot, initialPrompt, onRestart }: AppProps): React. } if (allMessages.length > 0) { process.stdout.write("\n\n"); - process.stdout.write(chalk.dim("Press ESC to exit raw mode")); + process.stdout.write(chalk.dim(t("ui.app.pressEscExitRaw"))); } else { process.stdout.write("\n"); - process.stdout.write(chalk.dim("(No messages in this session yet. Start chatting to see them here.)")); + process.stdout.write(chalk.dim(t("ui.app.noMessagesInSession"))); process.stdout.write("\n\n"); - process.stdout.write(chalk.dim("Press ESC to exit raw mode")); + process.stdout.write(chalk.dim(t("ui.app.pressEscExitRaw"))); } } else if (activeSessionId) { // Switch to chat view to render messages. @@ -520,12 +555,12 @@ export function App({ projectRoot, initialPrompt, onRestart }: AppProps): React. } if (allMessages.length > 0) { process.stdout.write("\n\n"); - process.stdout.write(chalk.dim("Press ESC to exit raw mode")); + process.stdout.write(chalk.dim(t("ui.app.pressEscExitRaw"))); } else { process.stdout.write("\n"); - process.stdout.write(chalk.dim("(No messages in this session yet. Start chatting to see them here.)")); + process.stdout.write(chalk.dim(t("ui.app.noMessagesInSession"))); process.stdout.write("\n\n"); - process.stdout.write(chalk.dim("Press ESC to exit raw mode")); + process.stdout.write(chalk.dim(t("ui.app.pressEscExitRaw"))); } return; } @@ -641,7 +676,7 @@ export function App({ projectRoot, initialPrompt, onRestart }: AppProps): React. ) : null} {errorLine ? ( - Error: {errorLine} + {t("ui.app.error", { message: errorLine })} ) : null} {showProcessStdout ? ( @@ -699,7 +734,13 @@ export function App({ projectRoot, initialPrompt, onRestart }: AppProps): React. onRawModeChange={handleRawModeChange} onInterrupt={handleInterrupt} onToggleProcessStdout={handleToggleProcessStdout} - placeholder="Type your message..." + placeholder={t("ui.promptInput.placeholder")} + currentLocale={locale} + currentThinkingLocale={thinkingLocale} + currentReplyLocale={replyLocale} + onLocaleChange={handleLocaleChange} + onThinkingLocaleChange={handleThinkingLocaleChange} + onReplyLocaleChange={handleReplyLocaleChange} /> )} @@ -769,12 +810,12 @@ function isCurrentSessionEmpty(sessionManager: SessionManager): boolean { function buildStatusLine(entry: SessionEntry): string { const parts: string[] = []; - parts.push(`status: ${entry.status}`); + parts.push(t("ui.app.statusStatus", { status: entry.status })); if (typeof entry.activeTokens === "number" && entry.activeTokens > 0) { - parts.push(`tokens: ${entry.activeTokens}`); + parts.push(t("ui.app.statusTokens", { tokens: entry.activeTokens })); } if (entry.failReason) { - parts.push(`fail: ${entry.failReason}`); + parts.push(t("ui.app.statusFail", { reason: entry.failReason })); } return parts.join(" · "); } diff --git a/src/ui/AppContainer.tsx b/src/ui/AppContainer.tsx index e437b44..c04d7f3 100644 --- a/src/ui/AppContainer.tsx +++ b/src/ui/AppContainer.tsx @@ -2,17 +2,28 @@ import React from "react"; import { AppContext } from "./contexts"; import { App } from "./App"; import { RawModeProvider } from "./contexts/RawModeContext"; +import { I18nProvider } from "./contexts/i18n"; +import type { Locale } from "../common/i18n"; const AppContainer: React.FC<{ projectRoot: string; version: string; initialPrompt: string | undefined; onRestart: () => void; -}> = ({ version, projectRoot, initialPrompt, onRestart }) => { + initialLocale?: Locale; + initialThinkingLocale?: Locale; + initialReplyLocale?: Locale; +}> = ({ version, projectRoot, initialPrompt, onRestart, initialLocale, initialThinkingLocale, initialReplyLocale }) => { return ( - + + + ); diff --git a/src/ui/AskUserQuestionPrompt.tsx b/src/ui/AskUserQuestionPrompt.tsx index 7c76ae3..9ce58ce 100644 --- a/src/ui/AskUserQuestionPrompt.tsx +++ b/src/ui/AskUserQuestionPrompt.tsx @@ -2,6 +2,7 @@ import React, { useEffect, useMemo, useState } from "react"; import { Box, Text } from "ink"; import type { AskUserQuestionAnswers, AskUserQuestionItem } from "./askUserQuestion"; import { useTerminalInput } from "./PromptInput"; +import { t } from "../common/i18n"; type Props = { questions: AskUserQuestionItem[]; @@ -140,9 +141,7 @@ export function AskUserQuestionPrompt({ questions, onSubmit, onCancel }: Props): const answer = buildAnswerForQuestion(question, options[cursorIndex], selectedForQuestion, otherText); if (!answer) { setStatusMessage( - question.multiSelect - ? "Select at least one option with Space, or type an Other answer." - : "Select an option, or type an Other answer." + question.multiSelect ? t("ui.askUserQuestion.selectMultiHelp") : t("ui.askUserQuestion.selectOptionHelp") ); return; } @@ -215,10 +214,10 @@ export function AskUserQuestionPrompt({ questions, onSubmit, onCancel }: Props): {statusMessage ?? (isCurrentOther - ? "Type your answer · Backspace edit · Enter submit/next · ↑ choose presets · Esc type manually" + ? t("ui.askUserQuestion.typeAnswerHelp") : question.multiSelect - ? "↑/↓ move · Space toggle · Enter submit/next · Esc type manually" - : "↑/↓ move · Enter select/next · Esc type manually")} + ? t("ui.askUserQuestion.selectMultiMove") + : t("ui.askUserQuestion.selectSingleMove"))} @@ -236,7 +235,7 @@ function buildOptions(question: AskUserQuestionItem | undefined): OptionEntry[] value: option.label, })), { - label: "Other", + label: t("ui.askUserQuestion.otherLabel"), value: OTHER_VALUE, isOther: true, }, diff --git a/src/ui/DropdownMenu.tsx b/src/ui/DropdownMenu.tsx index 6593ff8..21f65a2 100644 --- a/src/ui/DropdownMenu.tsx +++ b/src/ui/DropdownMenu.tsx @@ -1,5 +1,7 @@ import React, { useMemo } from "react"; import { Box, Text } from "ink"; +import { displayWidth } from "../common/display-width"; +import { t } from "../common/i18n"; /** * Generic dropdown menu item structure @@ -67,7 +69,7 @@ const DropdownMenu = React.memo(function DropdownMenu({ titleColor = "magenta", activeColor = "cyanBright", helpText, - emptyText = "No items found", + emptyText = t("ui.dropdownMenu.emptyText"), renderItem, }: DropdownMenuProps): React.ReactElement | null { // Calculate visible window @@ -86,7 +88,7 @@ const DropdownMenu = React.memo(function DropdownMenu({ if (item.selected !== undefined) { width += 2; // "● " or "○ " } - width += item.label.length; + width += displayWidth(item.label); if (item.statusIndicator) { width += 2; // " ✓" or similar } @@ -134,7 +136,7 @@ const DropdownMenu = React.memo(function DropdownMenu({ {/* Scroll indicator - top */} {visibleStart > 0 ? ( - … {visibleStart} above + {t("ui.dropdownMenu.above", { n: visibleStart })} ) : null} @@ -170,7 +172,7 @@ const DropdownMenu = React.memo(function DropdownMenu({ {/* Scroll indicator - bottom */} {visibleStart + visibleItems.length < items.length ? ( - … {items.length - visibleStart - visibleItems.length} more + {t("ui.dropdownMenu.more", { n: items.length - visibleStart - visibleItems.length })} ) : null} diff --git a/src/ui/McpStatusList.tsx b/src/ui/McpStatusList.tsx index 095612a..d3549de 100644 --- a/src/ui/McpStatusList.tsx +++ b/src/ui/McpStatusList.tsx @@ -1,3 +1,4 @@ +import { t } from "../common/i18n"; import React, { useState, useMemo, useCallback } from "react"; import { Box, Text, useInput, useWindowSize } from "ink"; import type { McpServerStatus } from "../mcp/mcp-manager"; @@ -41,15 +42,15 @@ export function McpStatusList({ statuses, onCancel, onReconnect }: Props): React - Manage MCP servers + {t("ui.mcp.manageTitle")} - 0 servers + {t("ui.mcp.zeroServers")} - No MCP servers configured. - Add MCP servers to your settings to get started. + {t("ui.mcp.noServersConfigured")} + {t("ui.mcp.addServersHint")} - Esc to close + {t("ui.mcp.escToClose")} ); } @@ -191,23 +192,23 @@ function ServerListView({ {/* Header row */} - Manage MCP servers + {t("ui.mcp.manageTitle")} ( - {readyCount} ready, + {t("ui.mcp.countReady", { count: readyCount })} - {startingCount} starting, + {t("ui.mcp.countStarting", { count: startingCount })} {reconnectingCount > 0 && ( - {reconnectingCount} reconnecting, + {t("ui.mcp.countReconnecting", { count: reconnectingCount })} )} - {failedCount} failed + {t("ui.mcp.countFailed", { count: failedCount })} ) @@ -240,16 +241,16 @@ function ServerListView({ })} {scrollOffset > 0 || scrollOffset + maxVisible < serverCount ? ( - {scrollOffset > 0 ? … {scrollOffset} servers above. : null} + {scrollOffset > 0 ? {t("ui.mcp.serversAbove", { n: scrollOffset })} : null} {scrollOffset + maxVisible < serverCount ? ( - … {serverCount - scrollOffset - maxVisible} servers below. + {t("ui.mcp.serversBelow", { n: serverCount - scrollOffset - maxVisible })} ) : null} ) : null} {/* Footer */} - ↑/↓ navigate · Enter view details · Esc close + {t("ui.mcp.footerHelp")} @@ -288,12 +289,12 @@ function ServerRow({ const detail = status.status === "ready" - ? `Ready (${status.toolCount} tools, ${status.promptCount} prompts, ${status.resourceCount} resources)` + ? `${t("ui.mcp.statusReady")} ${t("ui.mcp.itemCounts", { tools: status.toolCount, prompts: status.promptCount, resources: status.resourceCount })}` : status.status === "failed" - ? `Failed` + ? t("ui.mcp.statusFailed") : status.status === "reconnecting" - ? `Reconnecting${dots > 0 ? ".".repeat(dots) : " "}` - : "Starting" + (dots > 0 ? ".".repeat(dots) : " "); + ? `${t("ui.mcp.statusReconnecting")}${dots > 0 ? ".".repeat(dots) : " "}` + : `${t("ui.mcp.starting")}${dots > 0 ? ".".repeat(dots) : " "}`; return ( @@ -343,7 +344,7 @@ function ServerDetailView({ const allItems = useMemo(() => { const items: { type: string; name: string }[] = []; if (hasReconnect) { - items.push({ type: "action", name: "Reconnect" }); + items.push({ type: "action", name: t("ui.mcp.reconnect") }); } server.tools.forEach((tool) => items.push({ type: "tool", name: tool })); server.prompts.forEach((prompt) => items.push({ type: "prompt", name: prompt })); @@ -448,14 +449,18 @@ function ServerDetailView({ {server.name} - — {server.status === "ready" ? "Details" : "Status"} + — {server.status === "ready" ? t("ui.mcp.details") : t("ui.mcp.status")} {/* Server info */} {server.status === "ready" - ? `${server.toolCount} tools, ${server.promptCount} prompts, ${server.resourceCount} resources` - : `Status: ${server.status}`} + ? t("ui.mcp.itemCounts", { + tools: server.toolCount, + prompts: server.promptCount, + resources: server.resourceCount, + }) + : t("ui.mcp.statusPrefix", { status: server.status })} {/* Error for failed/reconnecting */} @@ -487,7 +492,7 @@ function ServerDetailView({ {visibleItems.length === 0 ? ( - No items available + {t("ui.mcp.noItems")} ) : ( visibleItems.map((item, idx) => { @@ -500,9 +505,9 @@ function ServerDetailView({ {visibleStart > 0 || visibleStart + maxVisible < totalItems ? ( {totalItems - visibleStart - maxVisible > 0 ? ▼ : } - {visibleStart > 0 ? … {visibleStart} items above. : null} + {visibleStart > 0 ? {t("ui.dropdownMenu.above", { n: visibleStart })} : null} {totalItems - visibleStart - maxVisible > 0 ? ( - … {totalItems - visibleStart - maxVisible} items below. + {t("ui.dropdownMenu.more", { n: totalItems - visibleStart - maxVisible })} ) : null} ) : null} @@ -510,11 +515,7 @@ function ServerDetailView({ {/* Footer */} - {hasReconnect - ? "Enter to reconnect · Esc back · Ctrl+C close" - : canScroll - ? "↑/↓ scroll · Space/Enter back · Esc back · Ctrl+C close" - : "Space/Enter back · Esc back · Ctrl+C close"} + {hasReconnect ? t("ui.mcp.enterReconnect") : canScroll ? t("ui.mcp.scrollBack") : t("ui.mcp.spaceBack")} diff --git a/src/ui/ProcessStdoutView.tsx b/src/ui/ProcessStdoutView.tsx index bc76a2f..2552175 100644 --- a/src/ui/ProcessStdoutView.tsx +++ b/src/ui/ProcessStdoutView.tsx @@ -3,6 +3,7 @@ import { Box, Text } from "ink"; import { BASH_TIMEOUT_DECREMENT_MS, BASH_TIMEOUT_INCREMENT_MS } from "../common/bash-timeout"; import type { BashTimeoutAdjustment, SessionEntry, SessionProcessEntry } from "../session"; import { useTerminalInput } from "./prompt"; +import { t } from "../common/i18n"; type RunningProcesses = SessionEntry["processes"]; @@ -47,12 +48,12 @@ export const ProcessStdoutView = React.memo(function ProcessStdoutView({ text += "\n"; } if (runningProcesses.size > 1) { - text += `── Process ${pid} [${proc.command}] ──\n`; + text += `${t("ui.processStdout.processLabel", { pid, command: proc.command })}\n`; } - text += stdout || "(no output yet)"; + text += stdout || t("ui.processStdout.noOutputYet"); } } else { - text = "(no running processes)"; + text = t("ui.processStdout.noRunning"); } setStdoutText(text); }; @@ -81,7 +82,7 @@ export const ProcessStdoutView = React.memo(function ProcessStdoutView({ const start = Math.max(0, lines.length - outputLineLimit - scrollOffset); const slice = lines.slice(start, start + outputLineLimit); if (lines.length > visibleLineLimit) { - slice.unshift(`... (${start} lines above · ↑/↓ to scroll · ${lines.length} total lines) ...`); + slice.unshift(t("ui.processStdout.scrollHint", { start, total: lines.length })); } return slice; }, [lines, scrollOffset, visibleLineLimit]); @@ -133,10 +134,10 @@ export const ProcessStdoutView = React.memo(function ProcessStdoutView({ return ( - 📟 Process Output - {` (${formatTimeoutHint( - timeoutProcess?.entry - )} · +/- adjust · Ctrl+O or Esc to close · ↑↓ PageUp/PageDown to scroll)`} + {t("ui.processStdout.title")} + + {t("ui.processStdout.footerHelp", { timeoutHint: formatTimeoutHint(timeoutProcess?.entry) })} + {visibleLines.map((line, index) => ( @@ -170,16 +171,16 @@ function getLatestTimeoutProcess( function formatTimeoutHint(entry?: SessionProcessEntry): string { if (!entry || typeof entry.timeoutMs !== "number") { - return "timeout unavailable"; + return t("ui.processStdout.timeoutUnavailable"); } - return `timeout ${formatDuration(entry.timeoutMs)}`; + return t("ui.processStdout.timeoutHint", { duration: formatDuration(entry.timeoutMs) }); } function formatAdjustmentStatus(adjustment: BashTimeoutAdjustment | null): string { if (!adjustment) { - return "No adjustable Bash timeout"; + return t("ui.processStdout.noAdjustableTimeout"); } - return `Timeout set to ${formatDuration(adjustment.timeoutMs)}`; + return t("ui.processStdout.timeoutSet", { duration: formatDuration(adjustment.timeoutMs) }); } function formatDuration(ms: number): string { diff --git a/src/ui/PromptInput.tsx b/src/ui/PromptInput.tsx index 8897fd3..14aebbf 100644 --- a/src/ui/PromptInput.tsx +++ b/src/ui/PromptInput.tsx @@ -62,7 +62,9 @@ import { } from "./prompt"; import SlashCommandMenu, { isSkillSelected } from "./SlashCommandMenu"; import type { ModelConfigSelection } from "../settings"; -import { FileMentionMenu, ModelsDropdown, RawModelDropdown, SkillsDropdown } from "./components"; +import { FileMentionMenu, ConfigDropdown, ModelsDropdown, RawModelDropdown, SkillsDropdown } from "./components"; +import { t } from "../common/i18n"; +import type { Locale } from "../common/i18n"; export type PromptSubmission = { text: string; @@ -94,6 +96,12 @@ type Props = { onRawModeChange?: (mode: string) => void; onInterrupt: () => void; onToggleProcessStdout?: () => void; + onLocaleChange?: (locale: Locale) => void; + onThinkingLocaleChange?: (locale: Locale) => void; + onReplyLocaleChange?: (locale: Locale) => void; + currentLocale?: Locale; + currentThinkingLocale?: Locale; + currentReplyLocale?: Locale; }; const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"]; @@ -133,6 +141,12 @@ export const PromptInput = React.memo(function PromptInput({ onInterrupt, onToggleProcessStdout, onRawModeChange, + onLocaleChange, + onThinkingLocaleChange, + onReplyLocaleChange, + currentLocale, + currentThinkingLocale, + currentReplyLocale, }: Props): React.ReactElement { const { exit } = useApp(); const { stdout } = useStdout(); @@ -145,6 +159,7 @@ export const PromptInput = React.memo(function PromptInput({ const [showSkillsDropdown, setShowSkillsDropdown] = useState(false); const [openRawModelDropdown, setOpenRawModelDropdown] = useState(false); const [showModelDropdown, setShowModelDropdown] = useState(false); + const [showConfigDropdown, setShowConfigDropdown] = useState(false); const [fileMentionItems, setFileMentionItems] = useState(() => scanFileMentionItems(projectRoot)); const [dismissedFileMentionKey, setDismissedFileMentionKey] = useState(null); const [historyCursor, setHistoryCursor] = useState(-1); @@ -178,12 +193,12 @@ export const PromptInput = React.memo(function PromptInput({ const slashToken = getCurrentSlashToken(buffer); const slashMenu = React.useMemo( () => - showSkillsDropdown || showModelDropdown || showFileMentionMenu + showSkillsDropdown || showModelDropdown || showConfigDropdown || showFileMentionMenu ? [] : slashToken ? filterSlashCommands(slashItems, slashToken) : [], - [showSkillsDropdown, showModelDropdown, showFileMentionMenu, slashToken, slashItems] + [showSkillsDropdown, showModelDropdown, showConfigDropdown, showFileMentionMenu, slashToken, slashItems] ); const showMenu = slashMenu.length > 0; const promptHistoryKey = React.useMemo(() => promptHistory.join("\0"), [promptHistory]); @@ -191,19 +206,19 @@ export const PromptInput = React.memo(function PromptInput({ const hasCollapsedMarkers = hasActivePasteMarkers(buffer.text, pastesRef.current); const hasExpandedRegions = expandedRegionsRef.current.size > 0; const processOrPasteHint = hasRunningProcess - ? " · ctrl+o view output" + ? t("ui.promptInput.ctrlOViewOutput") : hasCollapsedMarkers - ? " · ctrl+o expand" + ? t("ui.promptInput.ctrlOExpand") : hasExpandedRegions - ? " · ctrl+o collapse" + ? t("ui.promptInput.ctrlOCollapse") : ""; const footerText = statusMessage ? statusMessage : busy ? loadingText && loadingText.trim() ? `${loadingText}${processOrPasteHint}` - : `esc to interrupt · ctrl+c to cancel input${processOrPasteHint}` - : `enter send · shift+enter newline · @ files · ctrl+v image · / commands · ctrl+d exit${processOrPasteHint}`; + : `${t("ui.promptInput.footerBusy")}${processOrPasteHint}` + : t("ui.promptInput.footer") + processOrPasteHint; useTerminalFocusReporting(stdout, !disabled); useTerminalExtendedKeys(stdout, !disabled); useBracketedPaste(stdout, !disabled); @@ -298,7 +313,7 @@ export const PromptInput = React.memo(function PromptInput({ } if (busy) { onInterrupt(); - setStatusMessage("Interrupting…"); + setStatusMessage(t("ui.promptInput.interrupting")); } return; } @@ -324,21 +339,21 @@ export const PromptInput = React.memo(function PromptInput({ } lastCtrlDAt.current = now; setPendingExit(true); - setStatusMessage("press ctrl+d again to exit"); + setStatusMessage(t("ui.promptInput.pressCtrlDAgain")); return; } if (key.ctrl && (input === "c" || input === "C")) { if (busy) { onInterrupt(); - setStatusMessage("Interrupting…"); + setStatusMessage(t("ui.promptInput.interrupting")); } else if (!isEmpty(buffer)) { setBuffer(EMPTY_BUFFER); clearUndoRedoStacks(); pastesRef.current.clear(); expandedRegionsRef.current.clear(); } else { - setStatusMessage("press ctrl+d to exit"); + setStatusMessage(t("ui.promptInput.pressCtrlDExit")); } return; } @@ -347,7 +362,7 @@ export const PromptInput = React.memo(function PromptInput({ setPendingExit(false); } - if (openRawModelDropdown || showSkillsDropdown || showModelDropdown) { + if (openRawModelDropdown || showSkillsDropdown || showModelDropdown || showConfigDropdown) { return; } @@ -361,18 +376,18 @@ export const PromptInput = React.memo(function PromptInput({ } if (key.ctrl && (input === "v" || input === "V")) { - setStatusMessage("Reading clipboard..."); + setStatusMessage(t("ui.promptInput.readingClipboard")); readClipboardImageAsync() .then((image) => { if (image) { setImageUrls((prev) => [...prev, image.dataUrl]); - setStatusMessage("Attached image from clipboard"); + setStatusMessage(t("ui.promptInput.imageAttached")); } else { - setStatusMessage("No image found in clipboard"); + setStatusMessage(t("ui.promptInput.noImageFound")); } }) .catch(() => { - setStatusMessage("Failed to read clipboard"); + setStatusMessage(t("ui.promptInput.failedClipboard")); }); return; } @@ -380,9 +395,9 @@ export const PromptInput = React.memo(function PromptInput({ if (isClearImageAttachmentsShortcut(input, key)) { if (imageUrls.length > 0) { setImageUrls([]); - setStatusMessage("Cleared attached images"); + setStatusMessage(t("ui.promptInput.clearedImages")); } else { - setStatusMessage("No attached images to clear"); + setStatusMessage(t("ui.promptInput.noImagesToClear")); } return; } @@ -416,7 +431,7 @@ export const PromptInput = React.memo(function PromptInput({ } if (busy && isPlainReturn) { - setStatusMessage("wait for the current response or press esc to interrupt"); + setStatusMessage(t("ui.promptInput.waitForResponse")); return; } @@ -652,12 +667,12 @@ export const PromptInput = React.memo(function PromptInput({ // No expanded region at cursor — try to expand a paste marker. const marker = findPasteMarkerContaining(buffer); if (!marker) { - setStatusMessage("No paste marker at cursor"); + setStatusMessage(t("ui.promptInput.noPasteMarker")); return; } const content = pastesRef.current.get(marker.id); if (!content) { - setStatusMessage("Paste content not found"); + setStatusMessage(t("ui.promptInput.pasteNotFound")); return; } @@ -727,7 +742,7 @@ export const PromptInput = React.memo(function PromptInput({ function handleSlashSelection(item: SlashCommandItem): void { if (busy && item.kind !== "exit") { - setStatusMessage("wait for the current response or press esc to interrupt"); + setStatusMessage(t("ui.promptInput.waitForResponse")); return; } @@ -753,6 +768,11 @@ export const PromptInput = React.memo(function PromptInput({ setOpenRawModelDropdown(true); return; } + if (item.kind === "config") { + clearSlashToken(); + setShowConfigDropdown(true); + return; + } if (item.kind === "new") { onSubmit({ text: "", imageUrls: [], command: "new" }); resetPromptInput(); @@ -793,7 +813,7 @@ export const PromptInput = React.memo(function PromptInput({ function submitCurrentBuffer(): void { if (busy) { - setStatusMessage("wait for the current response or press esc to interrupt"); + setStatusMessage(t("ui.promptInput.waitForResponse")); return; } @@ -833,8 +853,14 @@ export const PromptInput = React.memo(function PromptInput({ } const showFooterText = useMemo( - () => showMenu || showSkillsDropdown || openRawModelDropdown || showModelDropdown || showFileMentionMenu, - [showMenu, showSkillsDropdown, showModelDropdown, openRawModelDropdown, showFileMentionMenu] + () => + showMenu || + showSkillsDropdown || + openRawModelDropdown || + showModelDropdown || + showConfigDropdown || + showFileMentionMenu, + [showMenu, showSkillsDropdown, showModelDropdown, openRawModelDropdown, showConfigDropdown, showFileMentionMenu] ); const matchedCommand = slashToken ? findExactSlashCommand(slashItems, slashToken) : null; @@ -903,6 +929,18 @@ export const PromptInput = React.memo(function PromptInput({ }} onSelect={insertFileMentionSelection} /> + setShowConfigDropdown(false)} + onLocaleChange={(locale) => onLocaleChange?.(locale)} + onThinkingLocaleChange={(locale) => onThinkingLocaleChange?.(locale)} + onReplyLocaleChange={(locale) => onReplyLocaleChange?.(locale)} + onStatusMessage={setStatusMessage} + /> {!showFooterText && ( @@ -919,7 +957,7 @@ export function formatImageAttachmentStatus(count: number): string { if (count <= 0) { return ""; } - return `📎 ${count} image${count === 1 ? "" : "s"} attached`; + return t("ui.promptInput.imageCount", { count }); } export function formatSelectedSkillsStatus(skills: SkillInfo[]): string { diff --git a/src/ui/SessionList.tsx b/src/ui/SessionList.tsx index 5f186bd..0edc1b3 100644 --- a/src/ui/SessionList.tsx +++ b/src/ui/SessionList.tsx @@ -1,6 +1,8 @@ import React, { useState, useMemo, useCallback } from "react"; import { Box, Text, useInput, useWindowSize } from "ink"; import type { SessionEntry, SessionStatus } from "../session"; +import { t } from "../common/i18n"; +import { truncateDisplay } from "../common/display-width"; type Props = { sessions: SessionEntry[]; @@ -156,8 +158,8 @@ export function SessionList({ sessions, onSelect, onCancel }: Props): React.Reac if (sessions.length === 0) { return ( - No previous sessions found. - Press Esc to go back. + {t("ui.sessionList.empty")} + {t("ui.sessionList.escBack")} ); } @@ -176,17 +178,19 @@ export function SessionList({ sessions, onSelect, onCancel }: Props): React.Reac - Resume a session + {t("ui.sessionList.title")} {" "} - ({sessions.length} total - {hasActiveSearch ? `, ${filteredSessions.length} matched` : ""}) + ({sessions.length} {t("ui.sessionList.total")} + {hasActiveSearch ? t("ui.sessionList.matched", { n: filteredSessions.length }) : ""}) {/* Search bar */} - {searchQuery ? `Search: ${searchQuery}` : "Type to search\u2026"} + + {searchQuery ? t("ui.sessionList.searchQuery", { query: searchQuery }) : t("ui.sessionList.searchHint")} + {searchQuery ? | : null} @@ -206,7 +210,7 @@ export function SessionList({ sessions, onSelect, onCancel }: Props): React.Reac > {filteredSessions.length === 0 ? ( - No sessions match "{searchQuery}". + {t("ui.sessionList.noMatch", { query: searchQuery })} ) : ( visibleSessions.map((session, i) => { @@ -222,7 +226,7 @@ export function SessionList({ sessions, onSelect, onCancel }: Props): React.Reac {...(actualIndex === safeIndex ? { bold: true } : {})} color={actualIndex === safeIndex ? "#229ac3" : undefined} > - {formatSessionTitle(session.summary || "Untitled")} + {formatSessionTitle(session.summary || t("ui.sessionList.untitled"))} ({formatSessionStatus(session.status)}) @@ -236,9 +240,11 @@ export function SessionList({ sessions, onSelect, onCancel }: Props): React.Reac )} {scrollOffset > 0 || scrollOffset + maxVisibleSessions < filteredSessions.length ? ( - {scrollOffset > 0 ? … {scrollOffset} sessions above. : null} + {scrollOffset > 0 ? {t("ui.sessionList.above", { n: scrollOffset })} : null} {scrollOffset + maxVisibleSessions < filteredSessions.length ? ( - … {filteredSessions.length - scrollOffset - maxVisibleSessions} sessions below. + + {t("ui.sessionList.below", { n: filteredSessions.length - scrollOffset - maxVisibleSessions })} + ) : null} ) : null} @@ -247,12 +253,11 @@ export function SessionList({ sessions, onSelect, onCancel }: Props): React.Reac {hasActiveSearch ? ( - Esc clear search · - ↑/↓ navigate · Enter select · Esc again to cancel + {t("ui.sessionList.footerSearch")} ) : ( - Type to search · ↑/↓ navigate · PgUp/PgDn page · Enter select · Esc cancel + {t("ui.sessionList.footerHelp")} )} @@ -274,31 +279,24 @@ function formatTimestamp(value: string): string { } export function formatSessionTitle(value: string, max = 70): string { - return truncate(value.replace(/\r?\n/g, " ").replace(/\s+/g, " ").trim(), max); + return truncateDisplay(value.replace(/\r?\n/g, " ").replace(/\s+/g, " ").trim(), max); } export function formatSessionStatus(status: SessionStatus): string { switch (status) { case "completed": - return "done"; + return t("ui.sessionList.statusDone"); case "processing": - return "running"; + return t("ui.sessionList.statusRunning"); case "pending": - return "pending"; + return t("ui.sessionList.statusPending"); case "waiting_for_user": - return "waiting"; + return t("ui.sessionList.statusWaiting"); case "failed": - return "failed"; + return t("ui.sessionList.statusFailed"); case "interrupted": - return "stopped"; + return t("ui.sessionList.statusStopped"); default: return status; } } - -function truncate(value: string, max: number): string { - if (value.length <= max) { - return value; - } - return `${value.slice(0, max)}…`; -} diff --git a/src/ui/SlashCommandMenu.tsx b/src/ui/SlashCommandMenu.tsx index df599b5..e9a3ec1 100644 --- a/src/ui/SlashCommandMenu.tsx +++ b/src/ui/SlashCommandMenu.tsx @@ -4,6 +4,8 @@ import { ARGS_SEPARATOR } from "./constants"; import React from "react"; import { Box, Text } from "ink"; import type { SkillInfo } from "../session"; +import { displayWidth } from "../common/display-width"; +import { t } from "../common/i18n"; type SlashCommandMenuProps = { items: SlashCommandItem[]; @@ -26,7 +28,7 @@ const SlashCommandMenu = React.memo(function SlashCommandMenu({ return 0; } const longestLabel = Math.max( - ...items.map((s) => s.label.length + (s.args ? s.args?.join(ARGS_SEPARATOR)?.length + 4 : 0)) + ...items.map((s) => displayWidth(s.label) + (s.args ? s.args?.join(ARGS_SEPARATOR)?.length + 4 : 0)) ); const contentWidth = longestLabel + 2; // +2 for prefix "> " or " " const maxAllowed = Math.max(10, (width - 2) >> 1); // 容器50%宽度（减去gap），至少保留10列 @@ -72,9 +74,7 @@ const SlashCommandMenu = React.memo(function SlashCommandMenu({ })} {visibleStart + visibleItems.length < items.length ? ▼ : null} - - ({activeIndex + 1}/{items.length}) ↑↓ to navigate · Enter to select - + {t("ui.slashCommandMenu.footerHelp", { current: activeIndex + 1, total: items.length })} ); diff --git a/src/ui/UndoSelector.tsx b/src/ui/UndoSelector.tsx index fad3e17..9daad59 100644 --- a/src/ui/UndoSelector.tsx +++ b/src/ui/UndoSelector.tsx @@ -1,6 +1,7 @@ import React, { useMemo, useState } from "react"; import { Box, Text, useInput, useWindowSize } from "ink"; import type { UndoTarget } from "../session"; +import { t } from "../common/i18n"; export type UndoRestoreMode = "code-and-conversation" | "conversation"; @@ -82,8 +83,8 @@ export function UndoSelector({ targets, onSelect, onCancel }: Props): React.Reac if (targets.length === 0) { return ( - Nothing to undo yet. - Press Esc to go back. + {t("ui.undoSelector.nothingYet")} + {t("ui.undoSelector.escBack")} ); } @@ -100,9 +101,9 @@ export function UndoSelector({ targets, onSelect, onCancel }: Props): React.Reac - Undo + {t("ui.undoSelector.title")} - restore to the point before a prompt + {t("ui.undoSelector.subtitle")} {phase === "message" ? ( {formatTimestamp(target.message.createTime)} - {target.canRestoreCode ? " · code checkpoint available" : " · conversation only"} + {target.canRestoreCode + ? ` · ${t("ui.undoSelector.checkpointAvailable")}` + : ` · ${t("ui.undoSelector.conversationOnly")}`} @@ -149,30 +152,31 @@ export function UndoSelector({ targets, onSelect, onCancel }: Props): React.Reac paddingX={1} overflow="hidden" > - Selected prompt: + {t("ui.undoSelector.selectedPrompt")} {formatUndoMessage(selectedTarget?.message.content ?? "")} - {modeIndex === 0 ? "> " : " "}Restore code and conversation + {modeIndex === 0 ? "> " : " "} + {t("ui.undoSelector.restoreCodeAndConversation")} {" "} - {selectedTarget?.canRestoreCode - ? "Restore files from the recorded Git checkpoint, then fork the conversation." - : "No code checkpoint is recorded for this prompt."} + {selectedTarget?.canRestoreCode ? t("ui.undo.restoreFiles") : t("ui.undo.noCheckpoint")} - {modeIndex === 1 ? "> " : " "}Restore conversation + {modeIndex === 1 ? "> " : " "} + {t("ui.undoSelector.restoreConversation")} + + + {" "} + {t("ui.undoSelector.forkConversation")} - {" "}Fork the conversation without changing files. )} - {phase === "message" - ? "↑/↓ navigate · Enter choose · Esc cancel" - : "↑/↓ choose restore mode · Enter restore · Esc back"} + {phase === "message" ? t("ui.undoSelector.footerMessage") : t("ui.undoSelector.footerMode")} @@ -181,9 +185,9 @@ export function UndoSelector({ targets, onSelect, onCancel }: Props): React.Reac } function formatUndoMessage(content: unknown): string { - const text = typeof content === "string" && content.trim() ? content.trim() : "(empty message)"; + const text = typeof content === "string" && content.trim() ? content.trim() : t("ui.undoSelector.emptyMessage"); const singleLine = text.replace(/\r?\n/g, " ").replace(/\s+/g, " "); - return singleLine.length > 90 ? `${singleLine.slice(0, 89)}…` : singleLine; + return singleLine.length > 90 ? `${singleLine.slice(0, 89)}\u2026` : singleLine; } function formatTimestamp(value: string): string { diff --git a/src/ui/UpdatePrompt.tsx b/src/ui/UpdatePrompt.tsx index f2b9e21..925b371 100644 --- a/src/ui/UpdatePrompt.tsx +++ b/src/ui/UpdatePrompt.tsx @@ -1,5 +1,6 @@ import React, { useState } from "react"; import { Box, Text, useApp, useInput } from "ink"; +import { t } from "../common/i18n"; export type UpdatePromptChoice = "install" | "ignore-once" | "ignore-version"; @@ -21,15 +22,15 @@ export function UpdatePrompt({ currentVersion, latestVersion, installCommand, on const options: UpdatePromptOption[] = [ { value: "install", - label: `Install the latest version with \`${installCommand}\``, + label: t("ui.updatePrompt.installLabel", { installCommand }), }, { value: "ignore-once", - label: "Ignore once", + label: t("ui.updatePrompt.ignoreOnce"), }, { value: "ignore-version", - label: `Ignore this version (${latestVersion})`, + label: t("ui.updatePrompt.ignoreVersion", { latestVersion }), }, ]; @@ -60,9 +61,7 @@ export function UpdatePrompt({ currentVersion, latestVersion, installCommand, on return ( - - Deep Code latest version has been released: {currentVersion} -> {latestVersion} - + {t("ui.updatePrompt.title", { currentVersion, latestVersion })} {options.map((option, index) => { const selected = index === selectedIndex; @@ -75,7 +74,7 @@ export function UpdatePrompt({ currentVersion, latestVersion, installCommand, on })} - Use Up/Down to choose, Enter to confirm, Esc to ignore once. + {t("ui.updatePrompt.footerHelp")} ); diff --git a/src/ui/WelcomeScreen.tsx b/src/ui/WelcomeScreen.tsx index 7e740d1..dcca865 100644 --- a/src/ui/WelcomeScreen.tsx +++ b/src/ui/WelcomeScreen.tsx @@ -8,6 +8,7 @@ import { buildSlashCommands, BUILTIN_SLASH_COMMANDS, formatSlashCommandDescripti import { ThemedGradient } from "./ThemedGradient"; import { AsciiLogo } from "../AsciiArt"; import { useAppContext } from "./contexts"; +import { t } from "../common/i18n"; type WelcomeScreenProps = { projectRoot: string; @@ -19,14 +20,16 @@ type WelcomeScreenProps = { const TITLE_PANEL_WIDTH = 70; const PANEL_CONTENT_HEIGHT = 8; -const SHORTCUT_TIPS = [ - { label: "Enter", description: "Send the prompt" }, - { label: "Shift+Enter", description: "Insert a newline" }, - { label: "Ctrl+V", description: "Paste an image from the clipboard" }, - { label: "Esc", description: "Interrupt the current model turn" }, - { label: "/", description: "Open the skills and commands menu" }, - { label: "Ctrl+D twice", description: "Quit Deep Code CLI" }, -]; +function getShortcutTips(): Array<{ label: string; description: string }> { + return [ + { label: "Enter", description: t("ui.welcome.sendPrompt") }, + { label: "Shift+Enter", description: t("ui.welcome.insertNewline") }, + { label: "Ctrl+V", description: t("ui.welcome.pasteImage") }, + { label: "Esc", description: t("ui.welcome.interrupt") }, + { label: "/", description: t("ui.welcome.openMenu") }, + { label: "Ctrl+D twice", description: t("ui.welcome.quit") }, + ]; +} export function WelcomeScreen({ projectRoot, settings, skills, width }: WelcomeScreenProps): React.ReactElement { const { version } = useAppContext(); @@ -61,10 +64,13 @@ export function WelcomeScreen({ projectRoot, settings, skills, width }: WelcomeS (v{version || "unknown"}) {!compact ? : null} - - - - + + + + @@ -119,7 +125,7 @@ export function buildWelcomeTips(skills: SkillInfo[]): Array<{ label: string; de return [ ...slashTips, - ...SHORTCUT_TIPS.filter((tip) => !BUILTIN_SLASH_COMMANDS.some((command) => command.label === tip.label)), + ...getShortcutTips().filter((tip) => !BUILTIN_SLASH_COMMANDS.some((command) => command.label === tip.label)), ]; } diff --git a/src/ui/components/ConfigDropdown/index.tsx b/src/ui/components/ConfigDropdown/index.tsx new file mode 100644 index 0000000..8605b8a --- /dev/null +++ b/src/ui/components/ConfigDropdown/index.tsx @@ -0,0 +1,202 @@ +import React, { useEffect, useState } from "react"; +import { useInput } from "ink"; +import DropdownMenu from "../../DropdownMenu"; +import { t, type Locale } from "../../../common/i18n"; + +type ConfigStep = "category" | "language"; + +type CategoryOption = { + key: "locale" | "thinkingLocale" | "replyLocale"; + label: string; + description: string; +}; + +function getLocaleDisplayName(locale: Locale): string { + return locale === "en" ? t("ui.config.localeEn") : t("ui.config.localeZhCN"); +} + +function getCategoryOptions( + currentLocale: Locale, + currentThinkingLocale: Locale, + currentReplyLocale: Locale +): CategoryOption[] { + return [ + { + key: "locale", + label: t("ui.config.language"), + description: getLocaleDisplayName(currentLocale), + }, + { + key: "thinkingLocale", + label: t("ui.config.thinkingLanguage"), + description: getLocaleDisplayName(currentThinkingLocale), + }, + { + key: "replyLocale", + label: t("ui.config.replyLanguage"), + description: getLocaleDisplayName(currentReplyLocale), + }, + ]; +} + +const LOCALE_OPTIONS: { key: Locale }[] = [{ key: "en" }, { key: "zh-CN" }]; + +type Props = { + open: boolean; + currentLocale: Locale; + currentThinkingLocale: Locale; + currentReplyLocale: Locale; + width: number; + onClose: () => void; + onLocaleChange: (locale: Locale) => void; + onThinkingLocaleChange: (locale: Locale) => void; + onReplyLocaleChange: (locale: Locale) => void; + onStatusMessage?: (message: string | null) => void; +}; + +const ConfigDropdown: React.FC = ({ + open, + currentLocale, + currentThinkingLocale, + currentReplyLocale, + width, + onClose, + onLocaleChange, + onThinkingLocaleChange, + onReplyLocaleChange, + onStatusMessage, +}) => { + const [step, setStep] = useState(null); + const [activeIndex, setActiveIndex] = useState(0); + const [selectedCategory, setSelectedCategory] = useState(null); + + useEffect(() => { + if (open) { + setStep("category"); + setActiveIndex(0); + setSelectedCategory(null); + } else { + setStep(null); + } + }, [open]); + + function getCurrentLocaleForCategory(category: CategoryOption["key"]): Locale { + switch (category) { + case "locale": + return currentLocale; + case "thinkingLocale": + return currentThinkingLocale; + case "replyLocale": + return currentReplyLocale; + } + } + + function handleSelect(): void { + if (step === "category") { + const category = getCategoryOptions(currentLocale, currentThinkingLocale, currentReplyLocale)[activeIndex]; + if (!category) { + return; + } + setSelectedCategory(category.key); + const currentValue = getCurrentLocaleForCategory(category.key); + const localeIndex = LOCALE_OPTIONS.findIndex((opt) => opt.key === currentValue); + setActiveIndex(localeIndex >= 0 ? localeIndex : 0); + setStep("language"); + return; + } + + const locale = LOCALE_OPTIONS[activeIndex]; + if (!locale || !selectedCategory) { + return; + } + + const localeDisplay = getLocaleDisplayName(locale.key); + switch (selectedCategory) { + case "locale": + onLocaleChange(locale.key); + onStatusMessage?.(t("ui.config.languageUpdated", { locale: localeDisplay })); + break; + case "thinkingLocale": + onThinkingLocaleChange(locale.key); + onStatusMessage?.(t("ui.config.thinkingLanguageUpdated", { locale: localeDisplay })); + break; + case "replyLocale": + onReplyLocaleChange(locale.key); + onStatusMessage?.(t("ui.config.replyLanguageUpdated", { locale: localeDisplay })); + break; + } + // Return to category selection after applying + setStep("category"); + setActiveIndex(0); + setSelectedCategory(null); + } + + useInput( + (input, key) => { + if (!step) { + return; + } + + const optionCount = + step === "category" + ? getCategoryOptions(currentLocale, currentThinkingLocale, currentReplyLocale).length + : LOCALE_OPTIONS.length; + + if (key.upArrow) { + setActiveIndex((idx) => (idx - 1 + optionCount) % optionCount); + return; + } + if (key.downArrow) { + setActiveIndex((idx) => (idx + 1) % optionCount); + return; + } + if ((input === " " && !key.ctrl && !key.meta) || (key.return && !key.shift && !key.meta)) { + handleSelect(); + return; + } + if (key.tab || key.escape) { + if (step === "language") { + setStep("category"); + setActiveIndex(0); + return; + } + onClose(); + return; + } + }, + { isActive: open } + ); + + if (!open || !step) { + return null; + } + + const items = + step === "category" + ? getCategoryOptions(currentLocale, currentThinkingLocale, currentReplyLocale).map((option) => ({ + key: option.key, + label: option.label, + description: option.description, + selected: false, + })) + : LOCALE_OPTIONS.map((option) => ({ + key: option.key, + label: getLocaleDisplayName(option.key), + description: option.key === getCurrentLocaleForCategory(selectedCategory!) ? t("ui.config.currentLabel") : "", + selected: option.key === getCurrentLocaleForCategory(selectedCategory!), + })); + + return ( + + ); +}; + +export default ConfigDropdown; diff --git a/src/ui/components/FileMentionMenu/index.tsx b/src/ui/components/FileMentionMenu/index.tsx index ce9a8ee..5049c9f 100644 --- a/src/ui/components/FileMentionMenu/index.tsx +++ b/src/ui/components/FileMentionMenu/index.tsx @@ -1,8 +1,8 @@ import React, { useEffect, useState } from "react"; -import { Box, Text } from "ink"; -import { useInput } from "ink"; +import { Box, Text, useInput } from "ink"; import DropdownMenu from "../../DropdownMenu"; import type { FileMentionItem, FileMentionToken } from "../../fileMentions"; +import { t } from "../../../common/i18n"; type Props = { open: boolean; @@ -84,13 +84,13 @@ const FileMentionMenu: React.FC = ({ open, width, token, items, onClose, return ( ({ key: item.path, label: item.path, - description: item.type === "directory" ? "directory" : "file", + description: item.type === "directory" ? t("ui.fileMentionMenu.directory") : t("ui.fileMentionMenu.file"), }))} activeIndex={activeIndex} activeColor="#229ac3" diff --git a/src/ui/components/MessageView/index.tsx b/src/ui/components/MessageView/index.tsx index dd0ddc5..e959705 100644 --- a/src/ui/components/MessageView/index.tsx +++ b/src/ui/components/MessageView/index.tsx @@ -11,15 +11,17 @@ import { } from "./utils"; import type { DiffPreviewLine, MessageViewProps } from "./types"; import { RawMode, useRawModeContext } from "../../contexts"; +import { useI18n } from "../../contexts/i18n"; export function MessageView({ message, collapsed, width = 80 }: MessageViewProps): React.ReactElement | null { const { mode } = useRawModeContext(); + const { t } = useI18n(); if (!message.visible) { return null; } if (message.role === "user") { - const text = message.content || "(no content)"; + const text = message.content || t("ui.messageView.noContent"); return ( @@ -28,7 +30,7 @@ export function MessageView({ message, collapsed, width = 80 }: MessageViewProps {text} {Array.isArray(message.contentParams) && message.contentParams.length > 0 ? ( - {` 📎 ${message.contentParams.length} image attachment(s)`} + {` 📎 ${message.contentParams.length} ${t("ui.messageView.imageAttachment")}`} ) : null} @@ -38,19 +40,20 @@ export function MessageView({ message, collapsed, width = 80 }: MessageViewProps if (message.role === "assistant") { const isThinking = Boolean(message.meta?.asThinking); const content = (message.content || "").trim(); + const thinkingLabel = t("ui.messageView.thinking"); if (isThinking) { const summary = buildThinkingSummary(content, message.messageParams, mode); if (collapsed !== false) { return ( - + ); } return ( - + {content ? {renderMarkdown(content)} : null} @@ -109,7 +112,7 @@ export function MessageView({ message, collapsed, width = 80 }: MessageViewProps if (message.meta?.skill) { return ( - ⚡ Loaded skill: {message.meta.skill.name} + {t("ui.messageView.loadedSkill", { name: message.meta.skill.name })} ); } @@ -117,7 +120,7 @@ export function MessageView({ message, collapsed, width = 80 }: MessageViewProps return ( - (conversation summary inserted) + {t("ui.messageView.conversationSummaryInserted")} ); @@ -166,9 +169,10 @@ function StatusLine({ } function DiffPreview({ lines }: { lines: DiffPreviewLine[] }): React.ReactElement { + const { t } = useI18n(); return ( - └ Changes + {t("ui.messageView.changes")} {lines.map((line, index) => ( @@ -186,9 +190,10 @@ function DiffPreview({ lines }: { lines: DiffPreviewLine[] }): React.ReactElemen } function PlanPreview({ lines }: { lines: string[] }): React.ReactElement { + const { t } = useI18n(); return ( - └ Plan + {t("ui.messageView.plan")} {lines.map((line, index) => ( diff --git a/src/ui/components/MessageView/utils.ts b/src/ui/components/MessageView/utils.ts index af5391d..3741ab0 100644 --- a/src/ui/components/MessageView/utils.ts +++ b/src/ui/components/MessageView/utils.ts @@ -2,6 +2,8 @@ import type { DiffPreviewLine, ToolSummary } from "./types"; import type { SessionMessage } from "../../../session"; import { RawMode } from "../../contexts"; import chalk from "chalk"; +import { t } from "../../../common/i18n"; +import { truncateDisplay } from "../../../common/display-width"; /** Type guard that checks whether a value is a plain object (not null, not an array). */ export function isPlainRecord(value: unknown): value is Record { @@ -10,7 +12,7 @@ export function isPlainRecord(value: unknown): value is Record /** Capitalizes the first character of a tool status name, falling back to "Tool". */ export function formatStatusName(value: string): string { - return value ? `${value.charAt(0).toUpperCase()}${value.slice(1)}` : "Tool"; + return value ? `${value.charAt(0).toUpperCase()}${value.slice(1)}` : t("ui.messageView.toolName"); } /** Truncates a string to the given maximum length, appending an ellipsis when truncated. */ @@ -39,7 +41,7 @@ export function firstNonEmptyLine(value: string): string { export function buildThinkingSummary(content: string, messageParams: unknown | null, mode?: RawMode): string { if (content) { const normalized = content.replace(/\r?\n/g, " ").replace(/\s+/g, " "); - let result = truncate(normalized, 100); + let result = truncateDisplay(normalized, 100); if (result.endsWith(":") || result.endsWith("：")) { result = result.slice(0, -1); } @@ -48,7 +50,7 @@ export function buildThinkingSummary(content: string, messageParams: unknown | n const params = messageParams as { reasoning_content?: unknown } | null | undefined; if (typeof params?.reasoning_content === "string" && params.reasoning_content.trim()) { - return mode !== RawMode.Lite ? params?.reasoning_content || "" : "(reasoning...)"; + return mode !== RawMode.Lite ? params?.reasoning_content || "" : t("ui.messageView.reasoningFallback"); } return ""; @@ -57,7 +59,7 @@ export function buildThinkingSummary(content: string, messageParams: unknown | n /** Formats a tool's parameters for status display, preserving full bash commands but truncating others. */ export function formatToolStatusParams(summary: ToolSummary): string { const params = firstNonEmptyLine(summary.params); - return summary.name.toLowerCase() === "bash" ? params : truncate(params, 120); + return summary.name.toLowerCase() === "bash" ? params : truncateDisplay(params, 120); } /** Builds a structured summary (name, params, ok, metadata) from a tool session message. */ @@ -209,7 +211,7 @@ export function renderMessageToStdout(message: SessionMessage, mode: RawMode): s } if (message.role === "user") { - const text = message.content || "(no content)"; + const text = message.content || t("ui.messageView.noContent"); return chalk(`> ${text}`); } @@ -219,7 +221,7 @@ export function renderMessageToStdout(message: SessionMessage, mode: RawMode): s if (isThinking) { const summary = buildThinkingSummary(content, message.messageParams, mode); - return `${chalk("✧")} ${chalk("Thinking")}${summary ? ` ${chalk(summary)}` : ""}`; + return `${chalk("✧")} ${chalk(t("ui.messageView.thinking"))}${summary ? ` ${chalk(summary)}` : ""}`; } return `${chalk("✦")} ${content}`; @@ -233,11 +235,11 @@ export function renderMessageToStdout(message: SessionMessage, mode: RawMode): s : null; const name = payload.name || metaFunctionName || "tool"; const metaParams = typeof message.meta?.paramsMd === "string" ? message.meta.paramsMd.trim() : ""; - const params = name.toLowerCase() === "bash" ? metaParams : truncate(metaParams, 120); + const params = name.toLowerCase() === "bash" ? metaParams : truncateDisplay(metaParams, 120); const statusLine = `${chalk("✧")} ${chalk(formatStatusName(name))}${params ? ` ${chalk(params)}` : ""}`; const metaResultMd = typeof message.meta?.resultMd === "string" ? message.meta.resultMd.trim() : ""; - const result = metaResultMd ? `\n${chalk.dim(" └ Result")}\n${metaResultMd}` : ""; + const result = metaResultMd ? `\n${chalk.dim(t("ui.messageView.result"))}\n${metaResultMd}` : ""; const summary: ToolSummary = { name, @@ -248,7 +250,7 @@ export function renderMessageToStdout(message: SessionMessage, mode: RawMode): s const planLines = getUpdatePlanPreviewLines(summary); if (planLines.length > 0) { const planText = planLines.map((line) => ` ${line}`).join("\n"); - return `${statusLine}\n${chalk.dim(" └ Plan")}\n${planText}${result}`; + return `${statusLine}\n${chalk.dim(t("ui.messageView.plan"))}\n${planText}${result}`; } return `${statusLine}${result}`; @@ -260,10 +262,10 @@ export function renderMessageToStdout(message: SessionMessage, mode: RawMode): s } if (message.meta?.skill && typeof message.meta.skill === "object") { const skillName = (message.meta.skill as { name?: unknown }).name; - return chalk(`⚡ Loaded skill: ${typeof skillName === "string" ? skillName : ""}`); + return chalk(t("ui.messageView.loadedSkill", { name: typeof skillName === "string" ? skillName : "" })); } if (message.meta?.isSummary) { - return chalk.dim.italic("(conversation summary inserted)"); + return chalk.dim.italic(t("ui.messageView.conversationSummaryInserted")); } return ""; } diff --git a/src/ui/components/ModelsDropdown/index.tsx b/src/ui/components/ModelsDropdown/index.tsx index bdd68ab..66bf25e 100644 --- a/src/ui/components/ModelsDropdown/index.tsx +++ b/src/ui/components/ModelsDropdown/index.tsx @@ -2,6 +2,7 @@ import React, { useEffect, useState } from "react"; import { useInput } from "ink"; import DropdownMenu from "../../DropdownMenu"; import type { ModelConfigSelection, ReasoningEffort } from "../../../settings"; +import { t } from "../../../common/i18n"; type ModelStep = "model" | "thinking"; @@ -14,11 +15,17 @@ type ThinkingModeOption = { export const MODEL_COMMAND_MODELS = ["deepseek-v4-pro", "deepseek-v4-flash"] as const; export const MODEL_COMMAND_THINKING_OPTIONS: ThinkingModeOption[] = [ - { label: "Thinking mode [max]", thinkingEnabled: true, reasoningEffort: "max" }, - { label: "Thinking mode [high]", thinkingEnabled: true, reasoningEffort: "high" }, - { label: "No thinking", thinkingEnabled: false }, + { label: "thinking-max", thinkingEnabled: true, reasoningEffort: "max" }, + { label: "thinking-high", thinkingEnabled: true, reasoningEffort: "high" }, + { label: "no-thinking", thinkingEnabled: false }, ]; +function getThinkingOptionLabel(option: ThinkingModeOption): string { + if (!option.thinkingEnabled) return t("ui.modelsDropdown.noThinking"); + if (option.reasoningEffort === "max") return t("ui.modelsDropdown.thinkingMax"); + return t("ui.modelsDropdown.thinkingHigh"); +} + function getThinkingOptionIndex(config: Pick): number { const index = MODEL_COMMAND_THINKING_OPTIONS.findIndex((option) => { if (!config.thinkingEnabled) { @@ -138,21 +145,23 @@ const ModelsDropdown: React.FC = ({ ? MODEL_COMMAND_MODELS.map((model) => ({ key: model, label: model, - description: model === modelConfig.model ? "current model" : "", + description: model === modelConfig.model ? t("ui.modelsDropdown.currentModel") : "", selected: model === (pendingModel ?? modelConfig.model), })) : MODEL_COMMAND_THINKING_OPTIONS.map((option, i) => ({ key: option.label, - label: option.label, - description: option.thinkingEnabled ? `reasoningEffort: ${option.reasoningEffort}` : "thinking disabled", + label: getThinkingOptionLabel(option), + description: option.thinkingEnabled + ? t("ui.modelsDropdown.reasoningEffort", { value: option.reasoningEffort ?? "" }) + : t("ui.modelsDropdown.thinkingDisabled"), selected: getThinkingOptionIndex(modelConfig) === i, })); return ( ({ ...model, selected: model.key === mode }))} - helpText="Space/Enter select mode · Esc to close" + title={t("ui.rawModelDropdown.title")} + items={RAW_COMMAND_MODELS.map((model) => ({ + ...model, + label: getRawModeLabel(model.key), + description: getRawModeDescription(model.key), + selected: model.key === mode, + }))} + helpText={t("ui.rawModelDropdown.helpText")} // onSelect={onSelect} activeColor="#229ac3" maxVisible={6} diff --git a/src/ui/components/SkillsDropdown/index.tsx b/src/ui/components/SkillsDropdown/index.tsx index b320d24..bbf582c 100644 --- a/src/ui/components/SkillsDropdown/index.tsx +++ b/src/ui/components/SkillsDropdown/index.tsx @@ -3,6 +3,7 @@ import React, { useEffect, useState } from "react"; import type { SkillInfo } from "../../../session"; import { useInput } from "ink"; import { isSkillSelected } from "../../SlashCommandMenu"; +import { t } from "../../../common/i18n"; const SkillsDropdown: React.FC<{ open: boolean; @@ -54,9 +55,9 @@ const SkillsDropdown: React.FC<{ return ( ({ key: skill.path || skill.name, label: skill.name, diff --git a/src/ui/components/index.ts b/src/ui/components/index.ts index 635f733..19da29f 100644 --- a/src/ui/components/index.ts +++ b/src/ui/components/index.ts @@ -4,3 +4,4 @@ export { RawModeExitPrompt } from "./RawModeExitPrompt"; export { default as SkillsDropdown } from "./SkillsDropdown"; export { default as ModelsDropdown } from "./ModelsDropdown"; export { default as FileMentionMenu } from "./FileMentionMenu"; +export { default as ConfigDropdown } from "./ConfigDropdown"; diff --git a/src/ui/contexts/i18n.tsx b/src/ui/contexts/i18n.tsx new file mode 100644 index 0000000..7a12924 --- /dev/null +++ b/src/ui/contexts/i18n.tsx @@ -0,0 +1,83 @@ +import React, { createContext, useContext, useState, useCallback } from "react"; +import { + initI18n, + t, + setThinkingLocale as setGlobalThinkingLocale, + setReplyLocale as setGlobalReplyLocale, + type Locale, + type TranslationKey, +} from "../../common/i18n"; + +export type I18nContextValue = { + t: (key: TranslationKey, params?: Record, localeOverride?: Locale) => string; + locale: Locale; + setLocale: (locale: Locale) => void; + thinkingLocale: Locale; + replyLocale: Locale; + setThinkingLocale: (locale: Locale) => void; + setReplyLocale: (locale: Locale) => void; +}; + +const I18nContext = createContext({ + t, + locale: "en", + setLocale: () => {}, + thinkingLocale: "en", + replyLocale: "en", + setThinkingLocale: () => {}, + setReplyLocale: () => {}, +}); + +export function I18nProvider({ + children, + initialLocale, + initialThinkingLocale, + initialReplyLocale, +}: { + children: React.ReactNode; + initialLocale: Locale; + initialThinkingLocale?: Locale; + initialReplyLocale?: Locale; +}): React.ReactElement { + const [locale, setLocaleState] = useState(initialLocale); + const [tLocale, setTLocaleState] = useState(initialThinkingLocale ?? initialLocale); + const [rLocale, setRLocaleState] = useState(initialReplyLocale ?? initialLocale); + + const setLocale = useCallback( + (newLocale: Locale) => { + initI18n(newLocale, { thinkingLocale: tLocale, replyLocale: rLocale }); + setLocaleState(newLocale); + }, + [tLocale, rLocale] + ); + + const setThinkingLocale = useCallback((locale: Locale) => { + setGlobalThinkingLocale(locale); + setTLocaleState(locale); + }, []); + + const setReplyLocale = useCallback((locale: Locale) => { + setGlobalReplyLocale(locale); + setRLocaleState(locale); + }, []); + + return ( + + {children} + + ); +} + +export function useI18n(): I18nContextValue { + return useContext(I18nContext); +} diff --git a/src/ui/contexts/index.ts b/src/ui/contexts/index.ts index 37e40cd..e91fdfc 100644 --- a/src/ui/contexts/index.ts +++ b/src/ui/contexts/index.ts @@ -1,3 +1,5 @@ export { AppContext, useAppContext } from "./AppContext"; export type { AppState } from "./AppContext"; export { RawMode, RAW_COMMAND_MODELS, useRawModeContext, RawModeProvider } from "./RawModeContext"; +export { I18nProvider, useI18n } from "./i18n"; +export type { I18nContextValue } from "./i18n"; diff --git a/src/ui/exitSummary.ts b/src/ui/exitSummary.ts index c55d9ce..be8c1e4 100644 --- a/src/ui/exitSummary.ts +++ b/src/ui/exitSummary.ts @@ -1,6 +1,7 @@ import chalk from "chalk"; import gradientString from "gradient-string"; import type { ModelUsage, SessionEntry } from "../session"; +import { t } from "../common/i18n"; type ExitSummaryInput = { session: SessionEntry | null; @@ -76,7 +77,7 @@ export function buildExitSummaryText(input: ExitSummaryInput): string { const titleColor = gradientString("#229ac3e6", "rgb(125 51 247 / 0.7)"); const line = (text: string) => `${borderColor("│")} ${padRight(text, contentWidth)} ${borderColor("│")}`; - const header = chalk.bold(titleColor("Goodbye!")); + const header = chalk.bold(titleColor(t("ui.exitSummary.goodbye"))); const rows: string[] = ["", `${header}`, ""]; @@ -107,11 +108,11 @@ export function buildExitSummaryText(input: ExitSummaryInput): string { const divider = "─".repeat(tableWidth); const headerRow = - padRight("Model Usage", colModel) + - padLeft("Reqs", colReqs) + - padLeft("Input Tokens", colInput) + - padLeft("Output Tokens", colOutput) + - padLeft("Cached Tokens", colCached); + padRight(t("ui.exitSummary.modelUsage"), colModel) + + padLeft(t("ui.exitSummary.reqs"), colReqs) + + padLeft(t("ui.exitSummary.inputTokens"), colInput) + + padLeft(t("ui.exitSummary.outputTokens"), colOutput) + + padLeft(t("ui.exitSummary.cachedTokens"), colCached); rows.push(chalk.bold(headerRow)); rows.push(divider); diff --git a/src/ui/loadingText.ts b/src/ui/loadingText.ts index bfb97d4..6c380f5 100644 --- a/src/ui/loadingText.ts +++ b/src/ui/loadingText.ts @@ -1,4 +1,5 @@ import type { LlmStreamProgress, SessionEntry } from "../session"; +import { t } from "../common/i18n"; type RunningProcesses = SessionEntry["processes"]; @@ -18,22 +19,22 @@ export function buildLoadingText(input: LoadingTextInput): string { } if (!progress) { - return "Thinking..."; + return t("ui.loading.thinking"); } const startedAt = parseTimestamp(progress.startedAt); if (startedAt === null) { - return "Thinking..."; + return t("ui.loading.thinking"); } const elapsedMs = Math.max(0, now - startedAt); if (elapsedMs < STALL_THRESHOLD_MS) { - return "Thinking..."; + return t("ui.loading.thinking"); } const elapsedSeconds = Math.floor(elapsedMs / 1000); const tokens = progress.formattedTokens || "0"; - return `Thinking... (${elapsedSeconds}s) · ↓ ${tokens} tokens`; + return t("ui.loading.thinkingElapsed", { elapsed: String(elapsedSeconds), tokens }); } function buildProcessLoadingText(processes: RunningProcesses | undefined, now: number): string | null { diff --git a/src/ui/slashCommands.ts b/src/ui/slashCommands.ts index 6d9b7cc..89bc81d 100644 --- a/src/ui/slashCommands.ts +++ b/src/ui/slashCommands.ts @@ -1,3 +1,4 @@ +import { t } from "../common/i18n"; import type { SkillInfo } from "../session"; export type SlashCommandKind = @@ -10,6 +11,7 @@ export type SlashCommandKind = | "continue" | "undo" | "mcp" + | "config" | "raw" | "exit"; @@ -22,79 +24,74 @@ export type SlashCommandItem = { args?: string[]; }; -export const BUILTIN_SLASH_COMMANDS: SlashCommandItem[] = [ - { - kind: "skills", - name: "skills", - label: "/skills", - description: "List available skills", - }, - { - kind: "model", - name: "model", - label: "/model", - description: "Select model, thinking mode and effort control", - }, - { - kind: "new", - name: "new", - label: "/new", - description: "Start a fresh conversation", - }, - { - kind: "init", - name: "init", - label: "/init", - description: "Initialize an AGENTS.md file with instructions for LLM", - }, - { - kind: "resume", - name: "resume", - label: "/resume", - description: "Pick a previous conversation to continue", - }, - { - kind: "continue", - name: "continue", - label: "/continue", - description: "Continue the active conversation or pick one to resume", - }, - { - kind: "undo", - name: "undo", - label: "/undo", - description: "Restore code and/or conversation to a previous point", - }, - { - kind: "mcp", - name: "mcp", - label: "/mcp", - description: "Show MCP server status and available tools", - }, - { - kind: "raw", - name: "raw", - label: "/raw", - args: ["lite", "normal", "raw-scrollback"], - description: "Toggle display mode for viewing or collapsing reasoning content", - }, - { - kind: "exit", - name: "exit", - label: "/exit", - description: "Quit Deep Code CLI", - }, +const BUILTIN_SLASH_COMMAND_DEFS: Omit[] = [ + { kind: "skills", name: "skills", label: "/skills" }, + { kind: "model", name: "model", label: "/model" }, + { kind: "new", name: "new", label: "/new" }, + { kind: "init", name: "init", label: "/init" }, + { kind: "resume", name: "resume", label: "/resume" }, + { kind: "continue", name: "continue", label: "/continue" }, + { kind: "undo", name: "undo", label: "/undo" }, + { kind: "mcp", name: "mcp", label: "/mcp" }, + { kind: "raw", name: "raw", label: "/raw", args: ["lite", "normal", "raw-scrollback"] }, + { kind: "exit", name: "exit", label: "/exit" }, + { kind: "config", name: "config", label: "/config" }, ]; +function getBuiltinDescription(kind: SlashCommandKind): string { + switch (kind) { + case "skills": + return t("ui.slashCommands.skillsDesc"); + case "model": + return t("ui.slashCommands.modelDesc"); + case "new": + return t("ui.slashCommands.newDesc"); + case "init": + return t("ui.slashCommands.initDesc"); + case "resume": + return t("ui.slashCommands.resumeDesc"); + case "continue": + return t("ui.slashCommands.continueDesc"); + case "undo": + return t("ui.slashCommands.undoDesc"); + case "mcp": + return t("ui.slashCommands.mcpDesc"); + case "raw": + return t("ui.slashCommands.rawDesc"); + case "exit": + return t("ui.slashCommands.exitDesc"); + case "config": + return t("ui.slashCommands.configDesc"); + default: + return t("ui.slashCommands.noDescription"); + } +} + +export function getBuiltinSlashCommands(): SlashCommandItem[] { + return BUILTIN_SLASH_COMMAND_DEFS.map((def) => ({ + ...def, + description: getBuiltinDescription(def.kind), + })); +} + +/** Builtin slash command definitions (structural only, no translated descriptions). + * Use buildSlashCommands() for fully populated items with translated descriptions. */ +export const BUILTIN_SLASH_COMMANDS: Pick[] = + BUILTIN_SLASH_COMMAND_DEFS; + export function buildSlashCommands(skills: SkillInfo[]): SlashCommandItem[] { const skillItems: SlashCommandItem[] = skills.map((skill) => ({ kind: "skill", name: skill.name, label: `/${skill.name}`, - description: skill.description || "(no description)", + description: skill.description || t("ui.slashCommands.noDescription"), skill, })); - return [...skillItems, ...BUILTIN_SLASH_COMMANDS]; + const builtinItems: SlashCommandItem[] = BUILTIN_SLASH_COMMAND_DEFS.map((def) => ({ + ...def, + description: getBuiltinDescription(def.kind), + })); + return [...skillItems, ...builtinItems]; } export function filterSlashCommands(items: SlashCommandItem[], token: string): SlashCommandItem[] { @@ -118,7 +115,7 @@ export function findExactSlashCommand(items: SlashCommandItem[], token: string): } export function formatSlashCommandDescription(description: string): string { - return (description || "(no description)").trim().replace(/\s+/g, " "); + return (description || t("ui.slashCommands.noDescription")).trim().replace(/\s+/g, " "); } export function formatSlashCommandLabel(item: SlashCommandItem): string {