Skip to content

docs(zh-cn): 补上 keybinds 页面缺失的「绑定值」小节 - #58017

Closed
Kissshot-2003 wants to merge 0 commit into
anomalyco:devfrom
Kissshot-2003:zh-cn-keybind-binding-values
Closed

Kissshot-2003 wants to merge 0 commit into
anomalyco:devfrom
Kissshot-2003:zh-cn-keybind-binding-values

Conversation

@Kissshot-2003

@Kissshot-2003 Kissshot-2003 commented Oct 22, 2026 •

Copy link
Copy Markdown

Issue for this PR

Refs #57623

Type of change

  • Bug fix
  • New feature
  • Refactor / code improvement
  • Documentation

What does this PR do?

The Chinese keybinds page is missing a section the English page has.

The English keybinds.mdx documents ## Binding Values: a binding value may be one shortcut, several comma-separated shortcuts, an array, or an object with key, event, preventDefault or fallthrough. The zh-cn copy never got that section, so a Chinese reader has no way to learn from the docs how to configure more than one shortcut for a binding.

This PR adds the missing section to packages/web/src/content/docs/zh-cn/keybinds.mdx, in the same position it occupies in the English page (between ## 前导键 and ## 禁用快捷键).

The terminology follows the page's existing choices and the zh-cn glossary: keybind / shortcut are 快捷键, and since ## Disable Keybind is already 禁用快捷键 here, ## Binding Values is 绑定值. The code block, the config keys and the schema URL are identical to the English page.

The reason the section is missing is the frozen locale sync described in #57623: docs-locale-sync.yml has its job disabled with if: false, so the Chinese copy stopped following the English one. I did not touch the workflow, because whether the sync should point at the v1 tree or the v2 tree is a question about which one is canonical, and #57623 already asks it. This PR just fills the specific gap.

How did you verify your code works?

  • Confirmed the section is absent from the Chinese copy and present in the English one, by comparing the heading lists of packages/web/src/content/docs/keybinds.mdx and packages/web/src/content/docs/zh-cn/keybinds.mdx, skipping lines inside fenced code blocks.
  • Checked the section against the English source it translates, and against the neighbouring Chinese sections for tone and for the terms already used on the page.
  • Built the v1 documentation site with bun run build from packages/web, which is the tree this page belongs to. The build also regenerates the config schema, so it covers the generated-output check as well.

Screenshots / recordings

Not a UI change.

Checklist

  • I have tested my changes locally
  • I have not included unrelated changes in this PR

@opencode-agent opencode-agent Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks good to me. The new 绑定值 section matches the English "Binding Values" section in content and position, and the example is identical. I checked that the forms it describes (a comma-separated string, an array, or an object with key/event/preventDefault/fallthrough) match the keybind schema in packages/tui/src/config/keybind.ts. It uses the page's existing term for keybind (快捷键). Docs only, so there was nothing to run.

Public API: unchanged.

Optional, for a later PR rather than this one: other parts of this page also lag behind the English page. The 禁用快捷键 section doesn't mention that false also works besides "none", and the 前导键 section is missing the paragraphs on the default subagent navigation keybinds and leader_timeout.

Related: #57623

This branch had an error being deployed

1 failed deployment
dev — 248bfbe1 Deployed Oct 22, 2026 by rekram1-node via deploy #14653
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