Add Traditional Chinese (zh-TW) localization for GUI, README, and docs - #581
Add Traditional Chinese (zh-TW) localization for GUI, README, and docs#581letr1n1ty wants to merge 8 commits into
Conversation
Add a full Taiwan Traditional Chinese locale so Chinese users can pick Simplified or Traditional instead of a single generic "中文" option. - GUI: new zh-TW dictionary, locale wiring, uptime/token/status formatting - README: new README.zh-TW.md and language switcher links - Docs site: zh-tw locale, sidebar labels, landing/frontier copy - Tests: include zh-TW in locale coverage lists - Prefer 供應商 for provider wording in Traditional Chinese surfaces Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
Note Reviews pausedIt looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the Use the following commands to manage reviews:
Use the checkboxes below for quick actions:
📝 WalkthroughWalkthroughAdds Traditional Chinese ( ChangesDocumentation site localization
GUI localization
README and release documentation
Estimated code review effort: 3 (Moderate) | ~25 minutes Possibly related PRs
Suggested labels: Suggested reviewers: 🚥 Pre-merge checks | ✅ 4 | ❌ 1❌ Failed checks (1 warning)
✅ Passed checks (4 passed)
✨ Finishing Touches🧪 Generate unit tests (beta)
Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 26
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@docs-site/astro.config.mjs`:
- Line 91: Remove the zh-TW sidebar entries for “Grok Build” and “Windows
Memory” from the locale configuration in astro.config.mjs until their translated
pages exist, ensuring no links target missing files under the zh-tw
documentation tree.
In `@docs-site/src/components/Landing.astro`:
- Around line 64-72: Update the Traditional Chinese translation in the
quickstart entry for “Inject a provider into Codex” to use “供應商” instead of
“provider”; leave the other language translations unchanged.
In `@docs-site/src/content/docs/zh-tw/contributing.md`:
- Around line 47-49: Update the zh-tw documentation internal links to preserve
the Traditional Chinese locale: in
docs-site/src/content/docs/zh-tw/contributing.md lines 47-49 change the
deployment URL to /zh-tw/, and lines 113-118 change the Adapters link to
/zh-tw/reference/adapters/; in
docs-site/src/content/docs/zh-tw/getting-started/how-it-works.mdx lines 42-53
change Model Routing and Sidecars links to /zh-tw/guides/... paths, and lines
79-85 change the Architecture link to /zh-tw/reference/architecture/.
In `@docs-site/src/content/docs/zh-tw/getting-started/installation.md`:
- Around line 95-96: Update the internal links in
docs-site/src/content/docs/zh-tw/getting-started/installation.md lines 95-96 so
both next-step links use /zh-tw/. Also update
docs-site/src/content/docs/zh-tw/getting-started/quickstart.md lines 97-100 and
110-114, docs-site/src/content/docs/zh-tw/guides/claude-code.md lines 226-228,
docs-site/src/content/docs/zh-tw/guides/codex-app-models.md lines 46-49 and
110-113, docs-site/src/content/docs/zh-tw/guides/codex-integration.md lines 161
and 184, docs-site/src/content/docs/zh-tw/guides/model-routing.md line 78,
docs-site/src/content/docs/zh-tw/guides/providers.md lines 51, 81, 137-139,
174-176, 182-184, and 196-198, and
docs-site/src/content/docs/zh-tw/guides/sidecars.md lines 118-121 to the exact
/zh-tw/ destinations specified in the review, preserving each link’s target
anchor and ensuring all internal cross-links remain within the zh-TW locale.
In `@docs-site/src/content/docs/zh-tw/guides/claude-code.md`:
- Around line 18-29: Terminate the environment-variable table after the
CLAUDE_CODE_MAX_CONTEXT_TOKENS / DISABLE_COMPACT row by inserting a blank line
before the following sentence, so “你自行匯出的變數始終優先” renders as a paragraph.
In `@docs-site/src/content/docs/zh-tw/guides/providers.md`:
- Around line 72-79: Update the Kiro row in the provider table to escape or
otherwise preserve the pipe character in the `curl -fsSL
https://cli.kiro.dev/install | bash` command, keeping the content within the 備註
cell and maintaining the table’s four-column structure.
In `@docs-site/src/content/docs/zh-tw/guides/web-dashboard.md`:
- Around line 61-64: 更新 web-dashboard.md 中針對 multi_agent_v2 的 caution
說明，使其符合子代理介面的實際文件：說明 v2 支援 guidance，且具備部分或無歷史分支可使用 model 與 reasoning_effort
覆寫；移除「不會附加 v1 注入訊息」及「所有子代理繼承父模型」等不正確表述，並保留其不是代理側跨模型路由器的限制。
- Line 3: The zh-TW documentation uses inconsistent translations for “provider.”
Update docs-site/src/content/docs/zh-tw/guides/web-dashboard.md at lines 3, 6-7,
27, 34-35, 39, 52, 98-102, and 111 to consistently use「供應商」,
including「供應商數量」、「新增供應商」、「活動供應商」、「供應商允許清單」and「供應商設定」; translate natural-language
references while preserving endpoint identifiers. Update
docs-site/src/content/docs/zh-tw/reference/adapters.md at lines 6-7, 27-29,
40-47, and 108-113 to use「供應商」and「相容供應商」without changing identifiers such as
openai-responses, forward, key, Cursor IDs, or auth fields.
- Line 64: Update the localized links in
docs-site/src/content/docs/zh-tw/guides/web-dashboard.md lines 64 and 112-113 to
use the corresponding /zh-tw/ routes, and update
docs-site/src/content/docs/zh-tw/reference/adapters.md lines 20-23 and 48-50
similarly: replace /zh-cn/guides/sub-agent-surface/, /zh-cn/guides/sidecars/,
and /zh-cn/reference/architecture/#橋接器 with their /zh-tw/ equivalents. The
additional adapters.md lines 110-112 require no direct change unless they
contain the same localized-link issue.
In `@docs-site/src/content/docs/zh-tw/index.mdx`:
- Around line 2-3: Localize narrative uses of “provider” as 「供應商」 across all
specified sites: index.mdx lines 2-3; contributing.md lines 2-3 and 88-118; and
how-it-works.mdx lines 8-10, 42-57, and 79-85. Update headings, descriptions,
and explanatory prose only, preserving literal API names, identifiers, paths,
and code fields such as provider/model, defaultProvider, and
provider.noVisionModels.
In `@docs-site/src/content/docs/zh-tw/reference/adapters.md`:
- Around line 1-3: Update the frontmatter title in the zh-TW adapters
documentation from “Adapters” to “適配器”; leave adapter IDs, code blocks, and
other technical identifiers unchanged.
In `@docs-site/src/content/docs/zh-tw/reference/architecture.md`:
- Around line 12-35: Update the module-diagram code fence in the architecture
documentation to specify the text language identifier, using ```text while
preserving the existing tree contents unchanged.
In `@docs-site/src/content/docs/zh-tw/reference/configuration.md`:
- Around line 112-114: Update the fenced code block containing the
x-opencodex-api-key example to include an appropriate language identifier,
preferably text, while preserving the example content.
- Around line 11-14: Update the Traditional Chinese provider terminology at
docs-site/src/content/docs/zh-tw/reference/configuration.md lines 11-14,
docs-site/src/content/docs/zh-tw/reference/architecture.md lines 17-18, and
docs-site/src/content/docs/zh-tw/reference/cli.md lines 14-16 to use「供應商」in
translated prose. Preserve literal configuration keys, command syntax such as
`ocx init`, IDs, and adapter terminology unchanged.
- Line 144: Correct the shared zh-TW cross-link routing: in
docs-site/src/content/docs/zh-tw/reference/configuration.md at lines 144-144,
182-182, 217-218, and 323-323, replace each /zh-cn/ target with /zh-tw/; make
the same replacement in
docs-site/src/content/docs/zh-tw/reference/architecture.md at lines 8-8 and
146-147; and update the dashboard guide link in
docs-site/src/content/docs/zh-tw/reference/cli.md at lines 338-339 to
/zh-tw/guides/web-dashboard/.
In `@docs-site/src/data/frontier-i18n.ts`:
- Around line 340-375: Replace the Taiwan localization term 「價效比」 with 「性價比」 in
the affected entries, including frontier.chart.efficiency,
frontier.chartHint.efficiency, frontier.bestValue, frontier.rankingHint,
frontier.costKindEstimated, and frontier.chartValueDisabled, while preserving
the surrounding wording and meanings.
In `@gui/src/i18n/zh-TW.ts`:
- Line 1102: Update the user-visible translation value for
claude.systemEnvUnsupported to replace the Traditional Chinese typo “係統” with
“系統”, leaving the rest of the message unchanged.
- Line 217: Update the translation value for
dash.updateReason.latest_unavailable in the zh-TW locale to refer to the npm
registry rather than the npm login file, using wording equivalent to “無法連線 npm
registry.”
- Line 990: Update the codexAuth.reauthenticate translation in the zh-TW locale
from English to the existing Traditional Chinese wording 重新認證, matching the
translation used elsewhere in the same locale.
- Line 4: Complete the zhTW dictionary by adding translations for the missing
pws.noModelMatch and modal.baseUrlPlaceholder keys defined in en.ts, including
the additional occurrences identified by the review. Keep the zhTW Record<TKey,
string> contract satisfied and follow the existing translation structure.
- Around line 897-898: Update the `modal.baseUrlPlaceholderError` and
`modal.baseUrlPlaceholderHint` translations to retain the exact `{placeholder}`
interpolation token from `en.ts`; translate only the surrounding text so runtime
substitution replaces the token correctly.
In `@readme/README.zh-TW.md`:
- Around line 43-48: Update the fenced code blocks containing the ASCII diagram
and header example in README.zh-TW.md to specify the text language identifier,
changing each opening fence to ```text while preserving their contents and
closing fences.
- Around line 1-2: Update the user-facing Traditional Chinese prose in
README.zh-TW.md to use 供應商 consistently instead of English “provider”; preserve
technical identifiers such as provider/model, providers, and provider IDs, and
apply the same wording at all referenced occurrences.
- Line 127: In the uninstall description near the “乾淨退出，零殘留” text, remove the
duplicated character so `就就像` becomes `就像`, leaving the surrounding wording
unchanged.
In `@structure/06_docs-and-release.md`:
- Line 6: Update the locale statement in structure/06_docs-and-release.md to
include the configured Russian (/ru) and Japanese (/ja) routes alongside the
existing locales, keeping the documented inventory complete.
In `@tests/oauth-tos-warning.test.ts`:
- Line 76: Update the locale iteration in the OAuth key test to cover every
registered locale, including ru and ja. Prefer reusing the canonical locale list
from the shared i18n definition rather than maintaining a separate partial list,
while preserving the existing key validation for each locale.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: ASSERTIVE
Plan: Pro Plus
Run ID: e0158d39-5284-4b2e-9662-4c4e7bcbbf77
📒 Files selected for processing (55)
README.mddocs-site/astro.config.mjsdocs-site/src/components/FrontierBoards.astrodocs-site/src/components/Header.astrodocs-site/src/components/Landing.astrodocs-site/src/components/SiteJsonLd.astrodocs-site/src/content/docs/zh-tw/benchmarks/coding.mdxdocs-site/src/content/docs/zh-tw/benchmarks/frontend.mdxdocs-site/src/content/docs/zh-tw/benchmarks/index.mdxdocs-site/src/content/docs/zh-tw/benchmarks/intelligence.mdxdocs-site/src/content/docs/zh-tw/benchmarks/security.mdxdocs-site/src/content/docs/zh-tw/benchmarks/terminal.mdxdocs-site/src/content/docs/zh-tw/contributing.mddocs-site/src/content/docs/zh-tw/getting-started/how-it-works.mdxdocs-site/src/content/docs/zh-tw/getting-started/installation.mddocs-site/src/content/docs/zh-tw/getting-started/quickstart.mddocs-site/src/content/docs/zh-tw/guides/claude-code.mddocs-site/src/content/docs/zh-tw/guides/codex-app-models.mddocs-site/src/content/docs/zh-tw/guides/codex-integration.mddocs-site/src/content/docs/zh-tw/guides/model-ordering.mddocs-site/src/content/docs/zh-tw/guides/model-routing.mddocs-site/src/content/docs/zh-tw/guides/providers.mddocs-site/src/content/docs/zh-tw/guides/sidecars.mddocs-site/src/content/docs/zh-tw/guides/sub-agent-surface.mddocs-site/src/content/docs/zh-tw/guides/web-dashboard.mddocs-site/src/content/docs/zh-tw/index.mdxdocs-site/src/content/docs/zh-tw/reference/adapters.mddocs-site/src/content/docs/zh-tw/reference/architecture.mddocs-site/src/content/docs/zh-tw/reference/cli.mddocs-site/src/content/docs/zh-tw/reference/configuration.mddocs-site/src/data/README-frontier.mddocs-site/src/data/frontier-i18n.tsgui/scripts/sync-locale-keys.mjsgui/src/components/QuotaBars.tsxgui/src/format-tokens.tsgui/src/formatUptime.tsgui/src/i18n/en.tsgui/src/i18n/shared.tsgui/src/i18n/zh-TW.tsgui/src/status-codes.tsgui/tests/apikeys-layout.test.tsgui/tests/claude-auth-mode-badge.test.tsgui/tests/claude-desktop-locale.test.tsgui/tests/grok-page.test.tsgui/tests/subagents-classic.test.tsgui/tests/usage-grok-filter.test.tsgui/tests/usage-layout.test.tsreadme/README.ja.mdreadme/README.ko.mdreadme/README.ru.mdreadme/README.zh-CN.mdreadme/README.zh-TW.mdstructure/06_docs-and-release.mdtests/dashboard-uptime.test.tstests/oauth-tos-warning.test.ts
| ``` | ||
| Codex CLI / App / SDK ──/v1/responses──▶ opencodex ──▶ Any provider | ||
| │ | ||
| Anthropic · Google · xAI · Kimi · Ollama Cloud · Groq | ||
| OpenRouter · Azure · DeepSeek · GLM · …and OpenAI itself | ||
| ``` |
There was a problem hiding this comment.
📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win
Add language identifiers to the fenced blocks.
markdownlint-cli2 reports MD040 for the ASCII diagram and header example. Use text for both fences.
Proposed fix
-```
+```text
...
-```
+```textAlso applies to: 387-389
🧰 Tools
🪛 markdownlint-cli2 (0.23.0)
[warning] 43-43: Fenced code blocks should have a language specified
(MD040, fenced-code-language)
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@readme/README.zh-TW.md` around lines 43 - 48, Update the fenced code blocks
containing the ASCII diagram and header example in README.zh-TW.md to specify
the text language identifier, changing each opening fence to ```text while
preserving their contents and closing fences.
Source: Linters/SAST tools
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
This comment was marked as resolved.
This comment was marked as resolved.
Sorry, something went wrong.
Point zh-tw docs links at /zh-tw, add missing grok-build and windows-memory pages, polish GUI/README/frontier copy, and align Cursor nativeLocalExec plus headless CLI docs with English. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 9cf9efe4e5
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| @@ -0,0 +1,407 @@ | |||
| --- | |||
| title: 設定參考 | |||
| description: ~/.opencodex/config.json 的所有欄位 —— 頂層選項、provider 與 sidecar。 | |||
There was a problem hiding this comment.
The page claims to cover every config.json field, but it omits supported options already present in the English reference and src/types.ts, including claudeCode.authMode, the Claude body limits, modelMaxInputTokens, the output-token defaults, modelAdapters, and responsesItemIdRepair. Traditional Chinese users configuring these behaviors therefore cannot discover their valid schema, defaults, or safety constraints from the new reference; synchronize these entries and the repair example with the English source.
AGENTS.md reference: AGENTS.md:L96-L97
Useful? React with 👍 / 👎.
| | `CLAUDE_CODE_MAX_CONTEXT_TOKENS` / `DISABLE_COMPACT` | 設定 `maxContextTokens` 時使用的舊版上下文覆蓋項（條件注入） | | ||
| 你自行匯出的變數始終優先。額外引數會直接透傳：`ocx claude -p "hello"`。 | ||
|
|
||
| ## 系統環境整合（macOS） |
There was a problem hiding this comment.
After quickstart, this translation jumps directly to macOS environment integration and omits the English guide's Auth mode and Claude Desktop profile sections. As a result, zh-TW users are not told how Auto/Subscription/Proxy affects ANTHROPIC_AUTH_TOKEN and claude.ai connectors, or how to manage Desktop routes with ocx claude desktop and its apply/show/move/default/export/import commands; port those sections before this one.
AGENTS.md reference: AGENTS.md:L96-L97
Useful? React with 👍 / 👎.
| 使用 Codex 的 `low | medium | high | xhigh | max | ultra` 檔位；上游不支援的值會在傳送請求前完成 | ||
| 對映或下調。 | ||
|
|
||
| ## 代理連線錯誤 |
There was a problem hiding this comment.
This translation jumps from catalog synchronization directly to connection errors, omitting the English guide's external-provider-manager safeguard. When config.toml already selects a provider other than openai or opencodex, the injector intentionally leaves the file, profile, catalog/cache, and history untouched; without that section, zh-TW users can repeatedly run ocx start or ocx sync expecting routing to be injected and misdiagnose the unchanged configuration. Translate the ownership and recovery instructions here.
AGENTS.md reference: AGENTS.md:L96-L97
Useful? React with 👍 / 👎.
| └─────────────────────────────────────────────────────────────────────┘ | ||
| ``` | ||
|
|
||
| ## Sub-agent 模型選擇 |
There was a problem hiding this comment.
The localized lifecycle begins with sub-agent selection and omits the preceding account-selection section and routing diagram from the English source. Pool users therefore are not told that existing thread ids retain account affinity while only new sessions rebalance, or that 429 and 401/403 responses respectively trigger cooldown and reauthentication; add this section so users do not expect an active conversation to move accounts after a quota refresh.
AGENTS.md reference: AGENTS.md:L96-L97
Useful? React with 👍 / 👎.
| - **Codex 在哪裡能用，它就在哪裡能用。** 自動注入 Codex CLI、TUI、App 和 SDK。路由模型像原生模型一樣出現在 Codex 的模型選擇器裡。 | ||
| - **委派給合適的模型。** 在儀表板或 config 中把最多 5 個路由/原生模型放進 Codex 的 subagent 選擇器 —— 複雜任務交給 reasoning 模型，快速任務交給便宜模型。在 v2 多智慧體表面（GPT-5.6 Sol/Terra）上，代理會注入精簡的委派指引：首選子智慧體模型與 effort（`injectionModel` / `injectionEffort`）、featured 模型清單及各自支援的 effort 階梯，以及讓跨模型 `spawn_agent` 覆蓋得以應用的 `fork_turns` 規則。已知限制：原生父代理 spawn 路由子代理時，任務本文可能以後端加密形式到達而丟失（[#92](https://github.com/lidge-jun/opencodex/issues/92)）—— 需要可靠的跨 provider 委派請使用 v1 表面。想自訂文案，可在 `injectionPrompt` 中使用 `{{model}}` / `{{effort}}` / `{{roster}}` 預留位置。 | ||
| - **為 preview-gated OpenAI rollout 做好準備。** GPT-5.6 Sol/Terra/Luna 保留 upstream effort 階梯。Direct/Multi 使用 372k Codex 契約，OpenAI API 與 OpenRouter 使用 1.05M 後設資料。 | ||
| - **給任意模型超能力。** 非 OpenAI 模型也能透過你的 ChatGPT 登入上執行的 `gpt-5.4-mini` sidecar 獲得真正的網頁搜尋和圖片理解。 |
There was a problem hiding this comment.
This claims that sidecars universally run gpt-5.4-mini through a ChatGPT login, but the current implementation supports both OpenAI and Anthropic backends, automatically prefers a usable Anthropic OAuth account when no backend is explicit, and presents gpt-5.6-luna as the current OpenAI default while migrating explicitly stored legacy gpt-5.4-mini values. Users without ChatGPT credentials may incorrectly conclude that search and vision are unavailable, so update this highlight to describe backend selection and the current defaults.
Useful? React with 👍 / 👎.
| "debug.streamProvider": "Provider", | ||
| "debug.streamUsage": "Usage", | ||
| "debug.streamInjection": "Injection", |
There was a problem hiding this comment.
When the dashboard is switched to zh-TW, the Debug settings panel still renders its three primary stream labels as Provider, Usage, and Injection in English, and the nearby empty-state copy likewise embeds the English feature names. This leaves a frequently used diagnostic surface only partially localized and abandons the locale's otherwise consistent 供應商 terminology; translate these visible labels rather than copying the English values.
Useful? React with 👍 / 👎.
Backfill Auth mode and Desktop sections, account selection, external provider managers, missing config fields, debug stream labels, and align the README sidecar bullet with English. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
There was a problem hiding this comment.
Actionable comments posted: 4
Caution
Some comments are outside the diff and can’t be posted inline due to platform limitations.
⚠️ Outside diff range comments (1)
docs-site/src/content/docs/zh-tw/reference/configuration.md (1)
31-33: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick winApply the Traditional Chinese provider terminology consistently. The shared issue is untranslated narrative
providerwording in zh-TW prose; preserve technical identifiers and syntax exactly.
docs-site/src/content/docs/zh-tw/reference/configuration.md#L31-L33: use供應商in the top-level field descriptions while preservingdefaultProvider.docs-site/src/content/docs/zh-tw/reference/configuration.md#L57-L57: translate the narrative provider reference.docs-site/src/content/docs/zh-tw/reference/configuration.md#L138-L143: localize provider headings and prose without changing adapter IDs or configuration keys.docs-site/src/content/docs/zh-tw/reference/configuration.md#L161-L163: translate narrative authentication/provider wording.docs-site/src/content/docs/zh-tw/reference/configuration.md#L190-L198: localize the fixed-provider-endpoint explanation while preserving provider IDs.docs-site/src/content/docs/zh-tw/reference/configuration.md#L232-L236: translate the Cursor provider heading and prose.readme/README.zh-TW.md#L116-L146: translate narrative provider wording and use the localized新增供應商button label; preserveprovider/model.🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@docs-site/src/content/docs/zh-tw/reference/configuration.md` around lines 31 - 33, Standardize Traditional Chinese provider terminology across docs-site/src/content/docs/zh-tw/reference/configuration.md at lines 31-33, 57, 138-143, 161-163, 190-198, and 232-236 by using 供應商 in narrative descriptions, headings, authentication text, endpoint explanations, and Cursor content; preserve provider IDs, adapter IDs, configuration keys, and defaultProvider unchanged. Apply the same localization in readme/README.zh-TW.md lines 116-146, including the 新增供應商 button label, while preserving the literal provider/model syntax.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@docs-site/src/content/docs/zh-tw/getting-started/how-it-works.mdx`:
- Around line 66-68: Update the Vision sidecar documentation in the “Vision
sidecar” section to describe backend selection according to the sidecar
configuration contract rather than implying ChatGPT is always used. Document
support for Anthropic OAuth, automatic selection of an available backend when
none is specified, and fail-closed behavior when an explicitly selected backend
lacks credentials; apply the same correction to the related Web Search text and
ensure its model/backend is not documented as always gpt-5.6-luna. Keep the
Traditional Chinese page synchronized with the behavior described in the
referenced Claude Code guide.
In `@docs-site/src/content/docs/zh-tw/guides/grok-build.md`:
- Line 41: Fix the anchor mismatch in grok-build.md by adding the explicit id
manual-recipe-without-auto-registration to the heading 手動配方（不使用自動註冊）, or update
the preceding link to match the heading’s generated fragment. Preserve the
existing link target and section meaning.
In `@docs-site/src/content/docs/zh-tw/reference/cli.md`:
- Around line 175-184: Escape every literal pipe in the command cells of the CLI
reference table, including the alternatives in the 代理政策, 可觀測性, API 准入, Claude
Code, Grok Build, 執行期控制, and 離線設定 rows, so Markdown continues to parse exactly
two columns.
In `@docs-site/src/content/docs/zh-tw/reference/configuration.md`:
- Around line 214-218: Update the “custom-gateway” configuration example for the
openai-responses adapter so baseUrl is host-only and does not include /v1,
preserving the documented {baseUrl}/v1/responses URL construction.
---
Outside diff comments:
In `@docs-site/src/content/docs/zh-tw/reference/configuration.md`:
- Around line 31-33: Standardize Traditional Chinese provider terminology across
docs-site/src/content/docs/zh-tw/reference/configuration.md at lines 31-33, 57,
138-143, 161-163, 190-198, and 232-236 by using 供應商 in narrative descriptions,
headings, authentication text, endpoint explanations, and Cursor content;
preserve provider IDs, adapter IDs, configuration keys, and defaultProvider
unchanged. Apply the same localization in readme/README.zh-TW.md lines 116-146,
including the 新增供應商 button label, while preserving the literal provider/model
syntax.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: ASSERTIVE
Plan: Pro Plus
Run ID: 091ea306-b53a-487f-a5b7-a0527d5dfdce
📒 Files selected for processing (24)
docs-site/src/components/Landing.astrodocs-site/src/content/docs/zh-tw/contributing.mddocs-site/src/content/docs/zh-tw/getting-started/how-it-works.mdxdocs-site/src/content/docs/zh-tw/getting-started/installation.mddocs-site/src/content/docs/zh-tw/getting-started/quickstart.mddocs-site/src/content/docs/zh-tw/guides/claude-code.mddocs-site/src/content/docs/zh-tw/guides/codex-app-models.mddocs-site/src/content/docs/zh-tw/guides/codex-integration.mddocs-site/src/content/docs/zh-tw/guides/grok-build.mddocs-site/src/content/docs/zh-tw/guides/model-routing.mddocs-site/src/content/docs/zh-tw/guides/providers.mddocs-site/src/content/docs/zh-tw/guides/sidecars.mddocs-site/src/content/docs/zh-tw/guides/web-dashboard.mddocs-site/src/content/docs/zh-tw/index.mdxdocs-site/src/content/docs/zh-tw/reference/adapters.mddocs-site/src/content/docs/zh-tw/reference/architecture.mddocs-site/src/content/docs/zh-tw/reference/cli.mddocs-site/src/content/docs/zh-tw/reference/configuration.mddocs-site/src/content/docs/zh-tw/troubleshooting/windows-memory.mddocs-site/src/data/frontier-i18n.tsgui/src/i18n/zh-TW.tsreadme/README.zh-TW.mdstructure/06_docs-and-release.mdtests/oauth-tos-warning.test.ts
Align how-it-works sidecar steps with multi-backend selection, fix grok-build manual-recipe heading anchor, escape bare pipes in the headless CLI table, and use a host-only openai-responses baseUrl example so /v1 is not doubled. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
Please resolve conflicts. |
There was a problem hiding this comment.
Caution
Some comments are outside the diff and can’t be posted inline due to platform limitations.
⚠️ Outside diff range comments (1)
docs-site/astro.config.mjs (1)
85-108: 🎯 Functional Correctness | 🔴 Critical | ⚡ Quick winResolve the merge conflict before shipping.
Lines 85–108 still contain literal Git conflict markers, so
astro.config.mjscannot be parsed and the documentation build will fail. Resolve the two navigation lists into one validitemsarray, intentionally preserving thezh-TWtranslations and verifying any retained slug has matching localized content.🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@docs-site/astro.config.mjs` around lines 85 - 108, Resolve the conflict in the navigation items array by removing all Git conflict markers and combining the intended entries into one valid list. Preserve the zh-TW translations from the HEAD entries, retain the opencode entry from origin/dev, and verify every retained slug has corresponding localized content before completing the valid astro.config.mjs syntax.Sources: Path instructions, Linters/SAST tools
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Outside diff comments:
In `@docs-site/astro.config.mjs`:
- Around line 85-108: Resolve the conflict in the navigation items array by
removing all Git conflict markers and combining the intended entries into one
valid list. Preserve the zh-TW translations from the HEAD entries, retain the
opencode entry from origin/dev, and verify every retained slug has corresponding
localized content before completing the valid astro.config.mjs syntax.
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: ASSERTIVE
Plan: Pro Plus
Run ID: 90b20f01-3666-4716-9517-5775f6e1fbca
📒 Files selected for processing (3)
README.mddocs-site/astro.config.mjsgui/src/i18n/en.ts
Keep zh-TW sidebar translations while adding the new opencode guide entry from upstream, and bring the Traditional Chinese dictionary to full key parity with en after the dev merge. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@docs-site/astro.config.mjs`:
- Line 92: Synchronize the zh-TW navigation entry for the “opencode” item with
the available translated documentation: add a matching opencode.md or
opencode.mdx page under the zh-TW guides content, or remove/defer the zh-TW
navigation entry from the locale configuration if no translation is available.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: ASSERTIVE
Plan: Pro Plus
Run ID: f184752a-f664-4691-adda-a19d6d184872
📒 Files selected for processing (2)
docs-site/astro.config.mjsgui/src/i18n/zh-TW.ts
| { label: "Model Ordering", translations: { ko: "모델 정렬에 관하여", "zh-CN": "模型排序", "zh-TW": "模型排序", ru: "Сортировка моделей", ja: "モデルの並び順" }, slug: "guides/model-ordering" }, | ||
| { label: "Claude Code", translations: { ko: "Claude Code", "zh-CN": "Claude Code", "zh-TW": "Claude Code", ru: "Claude Code", ja: "Claude Code" }, slug: "guides/claude-code" }, | ||
| { label: "Grok Build", translations: { ko: "Grok Build", "zh-CN": "Grok Build", "zh-TW": "Grok Build", ru: "Grok Build", ja: "Grok Build" }, slug: "guides/grok-build" }, | ||
| { label: "opencode", translations: { ko: "opencode", "zh-CN": "opencode", "zh-TW": "opencode", ru: "opencode", ja: "opencode" }, slug: "guides/opencode" }, |
There was a problem hiding this comment.
🎯 Functional Correctness | 🟠 Major | ⚡ Quick win
Add the zh-TW opencode page or remove this sidebar entry.
Line 92 adds guides/opencode, but the supplied zh-TW documentation set does not include a matching opencode page. Without one, /zh-tw/guides/opencode can become a broken locale-scoped link. Add the translation or defer this navigation item.
#!/bin/bash
matches="$(fd -i '^opencode\.(md|mdx)$' docs-site/src/content/docs/zh-tw 2>/dev/null || true)"
test -n "$matches" || { echo "Missing zh-TW opencode page"; exit 1; }
printf '%s\n' "$matches"As per path instructions, documentation navigation must remain synchronized with translated locale pages.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@docs-site/astro.config.mjs` at line 92, Synchronize the zh-TW navigation
entry for the “opencode” item with the available translated documentation: add a
matching opencode.md or opencode.mdx page under the zh-TW guides content, or
remove/defer the zh-TW navigation entry from the locale configuration if no
translation is available.
Source: Path instructions
Translate the EN-only guides/opencode page so the zh-TW sidebar entry resolves, addressing the post-merge CodeRabbit finding.
Merge origin/dev (c0ad57a) into feat/zh-tw-localization. Keep zh-TW README/astro assets, absorb security advisory + account-pause copy, and add the 13 new codexAuth pause/resume strings to zh-TW.
2 participants
Summary
Test plan
Summary by CodeRabbit
/zh-twhosting, README language selector, locale-aware navigation/labels, and generated page metadata.