Skip to content

feat(control-plane): add i18n for knowledge base and refine mental models - #3677

Open
Sanderhoff-alt wants to merge 1 commit into
vectorize-io:mainfrom
Sanderhoff-alt:feat/i18n-knowledge-base-and-mental-models
Open

feat(control-plane): add i18n for knowledge base and refine mental models#3677
Sanderhoff-alt wants to merge 1 commit into
vectorize-io:mainfrom
Sanderhoff-alt:feat/i18n-knowledge-base-and-mental-models

Conversation

@Sanderhoff-alt

@Sanderhoff-alt Sanderhoff-alt commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

Problem Description

  1. Missing i18n in Knowledge Base:
    • The Knowledge Base (knowledge-base-view.tsx) was untranslated across all non-English locale dictionaries (zh-CN, zh-TW, yue-Hant, ja, ko, es, fr, de, pt), with 32+ keys left as English fallback strings.
  2. Terminology & Translation Refinements:
    • Streamlined Chinese terminology for Knowledge Pages to 「知识页」 / 「知識頁」.
    • Refined documentsDescription across all 10 locales to accurately convey the memory extraction/retain pipeline instead of literal retention.
    • Simplified and clarified staleness status tooltips (staleAutoTitle, staleManualTitle, inSyncTitle) and history diff headers (basedOnDiff → 「依据对比」).
  3. Hardcoded User-Facing Strings:
    • Two UI strings in mental-models-view.tsx were hardcoded in English instead of using next-intl translation keys:
      • Clear content success toast (toast.success("Mental model content cleared"))
      • Detail view button (<Button>Open</Button>)

Proposed Solution

  1. Complete Multilingual Dictionaries for Knowledge Base:
    • Fully translated all knowledgeBase.* keys across all 10 supported locales:
      • en, zh-CN, zh-TW, yue-Hant, ja, ko, es, fr, de, pt.
      • Localized fieldSourceQuery, editSourceQueryHint, howDerived, backedBy, search, and folder/page CRUD dialogs.
  2. Refine Mental Models, Documents, and Diagnostics Localizations:
    • Streamlined Knowledge Pages to 知识页 (zh) / 知識頁 (zh-TW, yue).
    • Retained standard repository terminology for Source Query (源查询 / 來源查詢 / ソースクエリ / 소스 쿼리 / etc.) and Delta / Full refresh modes (增量 / 完整).
    • Clarified documentsDescription to accurately express document memory extraction across all 10 locales.
    • Clarified mental model staleness tooltips (staleAutoTitle, staleManualTitle, inSyncTitle) and simplified basedOnDiff to 「依据对比」 / 「依據對比」.
  3. Eliminate Hardcoded Strings in Components:
    • Connected toast.success(t("toastContentCleared")) and {t("actionOpenDetail")} in mental-models-view.tsx.
    • Added corresponding entries to all 10 message files.

Verification

  • i18n Static Check: Ran npm run i18n:check (tsx scripts/find-untranslated.ts), confirmed ✓ no hardcoded user-facing strings found.
  • Unit Tests:
    • Ran npx vitest run tests/messages/ (22/22 tests passed, verifying all static t(...) keys and message dictionaries across locales).
  • Pre-commit Hooks: Verified all lint and pre-commit checks pass cleanly.
  • Local Dev Server: Verified rendered UI and language switching on local Next.js dev server.

@Sanderhoff-alt
Sanderhoff-alt force-pushed the feat/i18n-knowledge-base-and-mental-models branch 7 times, most recently from f3212cc to 4d10581 Compare August 20, 2026 14:24
@Sanderhoff-alt Sanderhoff-alt changed the title feat(control-plane): add i18n for knowledge base and mental models across 10 languages feat(control-plane): add i18n for knowledge base and refine mental models Aug 20, 2026
@Sanderhoff-alt
Sanderhoff-alt force-pushed the feat/i18n-knowledge-base-and-mental-models branch 3 times, most recently from 487e3ff to 3b02533 Compare August 20, 2026 14:46
…dels

- Localize Knowledge Base module across all 10 locales (en, zh-CN, zh-TW,
  yue-Hant, ja, ko, es, fr, de, pt)
- Streamline Chinese terminology for Knowledge Pages to "知识页" / "知識頁"
- Retain standard terminology for Source Query and Delta/Full refresh
- Replace hardcoded strings in mental-models-view.tsx with i18n keys
- Refine document descriptions and fix legacy localization typos
@Sanderhoff-alt
Sanderhoff-alt force-pushed the feat/i18n-knowledge-base-and-mental-models branch from 3b02533 to 222c327 Compare August 20, 2026 14:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant