T3 Code 键盘快捷键Keybindings配置完全指南从配置文件到源码实现【免费下载链接】t3code项目地址: https://gitcode.com/GitHub_Trending/t3/t3codeT3 Code 在 Web 端与桌面端提供了统一的快捷键定制能力你可以通过Settings → Keybindings图形界面或直接编辑环境机器上的~/.t3/userdata/keybindings.json配置文件为任意命令绑定、调整或移除快捷键。阅读完本文你将掌握快捷键规则的完整 JSON 语法、when条件表达式的编写方法、规则优先级判定原理以及modw、退出快捷键等特殊行为的处理细节并能结合源码理解 T3 Code 从配置解析、校验到按键分发的完整链路。在何处配置快捷键快捷键配置入口为Settings → KeybindingsWeb 与桌面端均可使用。该页面会列出当前版本可用的命令 IDCommand ID及其默认快捷键你可以直接在页面上进行以下操作点击快捷键胶囊Pill进入录制状态按下新的组合键完成绑定编辑或可视化构建when条件表达式将自定义过的绑定Reset to default恢复默认值或直接Remove移除通过搜索框快速过滤命令页面会实时给出快捷键冲突警告与未知条件警告。从源码看这个页面由 KeybindingsSettings.tsx 实现其中KeybindingConflictWarning明确提示The most recent matching binding wins when both conditions can apply当两个条件同时满足时最近匹配的绑定生效这与下文将要讲解的优先级规则完全一致。直接编辑配置文件除了图形界面快捷键配置以 JSON 文件形式存放在环境所在机器上默认路径为~/.t3/userdata/keybindings.json该文件是一个规则数组JSON array of rules例如[ { key: modg, command: terminal.toggle }, { key: modshiftg, command: terminal.new, when: terminalFocus } ]配置文件由 T3 Code 负责生命周期管理首次启动时T3 Code 会用默认规则创建该文件后续启动时若产品新增了默认快捷键T3 Code 会把新默认值追加进去新默认值不会覆盖你已经自定义过的命令绑定若某个新默认值与你的自定义快捷键重叠由规则顺序详见优先级一节决定最终生效者无效规则会被忽略如果整个文件无法解析例如 JSON 语法错误T3 Code 将直接回退使用默认配置。服务端的解析、校验、合并与持久化逻辑集中在 keybindings.tsserver其文件头注释明确指出该模块负责 parsing, validation, merge, and persistence of user keybinding configuration而配置文件解析失败时抛出的KeybindingsConfigError定义于 packages/contracts/src/keybindings.ts会携带配置路径configPath与错误详情detail方便定位问题。规则Rule的基本形态每条规则由三个字段组成其中key与command为必填字段必填说明key是快捷键组合例如modgcommand是要触发的命令 ID例如terminal.togglewhen否条件表达式限制该快捷键在什么上下文下生效命令 ID 的合法范围在 packages/contracts/src/keybindings.ts 中命令 ID 通过 Schema 严格校验由两部分组成静态命令列表STATIC_KEYBINDING_COMMANDS包括界面类sidebar.toggle、commandPalette.toggle、filePicker.toggle、projectSearch.toggle、themeEditor.toggle、rightPanel.toggle、rightPanel.toggleMaximized、rightPanel.close、diff.toggle终端类terminal.toggle、terminal.split、terminal.splitVertical、terminal.new、terminal.close预览类preview.toggle、preview.refresh、preview.focusUrl、preview.zoomIn、preview.zoomOut、preview.resetZoom会话/编辑类composer.stash、chat.new、chat.newLocal、editor.openFavorite模型选择器modelPicker.toggle以及modelPicker.jump.1~modelPicker.jump.9线程类thread.stop、thread.previous、thread.next、thread.copyReference、thread.settle、thread.pin以及thread.jump.1~thread.jump.9。项目脚本命令遵循SCRIPT_RUN_COMMAND_PATTERN格式为script.{id}.run例如script.test.run。其中id必须匹配^[a-z0-9][a-z0-9-]*$小写字母/数字开头可含连字符且最长 24 个字符。校验相关的长度与数量限制同一文件还定义了以下硬性约束写入超限内容将被视为无效规则快捷键字符串key最长64字符MAX_KEYBINDING_VALUE_LENGTHwhen表达式最长256字符MAX_KEYBINDING_WHEN_LENGTHwhen表达式的嵌套深度最大64层MAX_WHEN_EXPRESSION_DEPTH整个配置文件最多256条规则MAX_KEYBINDINGS_COUNT。按键语法Key Syntax使用连接修饰键modifier与按键例如modshiftd或ctrll。修饰键分为两类mod跨平台抽象修饰键——在 macOS 上表示Command在其他平台表示Control平台具体修饰键cmd/meta对应 Command/Windows 键、ctrl/control、alt/option、shift。从 parseKeybindingShortcut 的实现可以看到解析细节字符串会先转为小写、按切分并 trim 每个 token然后逐个识别cmd/meta→metaKey、ctrl/control→ctrlKey、shift→shiftKey、alt/option→altKey、mod→modKey只有最后一个非修饰 token 会被当作按键本身key且space会被规范化为空格、esc被规范化为escape。这意味着每条规则中只能有一个按键Key修饰键可以任意组合大小写不敏感ModShiftD与modshiftd等价若 token 解析后存在空片段或没有按键部分该快捷键无效。mod键在运行时如何映射桌面与 Web 客户端的匹配逻辑位于 apps/web/src/keybindings.ts 的matchesShortcutModifiers当平台为 macOS 时modKey参与metaKey期望匹配否则参与ctrlKey期望匹配同时要求metaKey、ctrlKey、shiftKey、altKey四者与事件完全一致才命中。非拉丁键盘布局的兼容处理同文件中的resolveEventKeys还处理了一个细节当系统布局输出的是非拉丁字母如西里尔文、希腊文或 macOS 上Option修饰产生特殊符号时会以物理键位event.codeKeyA~KeyZ作为回退匹配反之如果布局已经产生拉丁字母则只按布局键匹配避免一个被重映射的物理键同时触发两个字母的快捷键从而遮蔽非 QWERTY 布局下的系统快捷键。When 条件表达式可用的上下文键context key当前包括上下文键含义terminalFocus内嵌终端获得焦点terminalOpen终端面板处于打开状态previewFocus预览区域获得焦点previewOpen预览处于打开状态modelPickerOpen模型选择器处于打开状态未知的上下文键一律求值为false见 evaluateWhenNode 中return Boolean(context[node.name])的兜底行为因此不用担心拼写错误导致报错但该规则将永远不会匹配。图形界面对此会给出Unknown condition警告——在 KeybindingsSettings.tsx 中未知条件仍可保存但提示may not match unless the runtime provides it。组合运算符支持!非、与、||或以及括号分组例如{ key: modj, command: terminal.toggle, when: terminalOpen !terminalFocus }该表达式的含义是仅当终端已打开且终端未获得焦点时modj才切换终端——即终端获得焦点时按键会原样输入到 shell而不是触发切换。服务端解析when表达式的过程见 parseKeybindingWhenExpression先通过tokenizeWhenExpression分词识别、||、!、(、)与标识符再递归下降解析为 AST抽象语法树。AST 节点类型定义在 packages/contracts/src/keybindings.ts 的KeybindingWhenNode中仅有四种identifier标识符、not、and、or客户端运行时evaluateWhenNode对 AST 直接求值。图形界面中的可视化构建器在 Settings 页面编辑when时并不强制手写表达式——WhenExpressionBuilderKeybindingsSettings.tsx同时提供可直接编辑的表达式输入框带实时语法校验与错误提示可视化节点编辑器支持添加/删除条件Condition、嵌套分组Group、切换and/or运算符以及取反Not修改会同步回写表达式文本。优先级Precedence规则当多个规则使用相同快捷键时最后一条按键与条件同时匹配的规则生效即使它属于不同的命令。因此如果你要让多个命令共享同一快捷键应把更具体的规则放在更通用的规则之后。这一行为有明确的源码实现依据在 resolveShortcutCommand 中匹配循环从数组末尾向前遍历for (let index keybindings.length - 1; index 0; index - 1)遇到第一个同时满足when条件与按键组合的规则即返回其命令。默认配置中就有典型的同键不同条件案例{ key: modw, command: terminal.close, when: terminalFocus }, { key: modw, command: rightPanel.close, when: !terminalFocus }终端获得焦点时modw关闭终端其余场景下关闭右侧面板——两条规则靠when条件互斥不会冲突。另外值得注意的是客户端解析配置时的前向兼容设计ResolvedKeybindingsConfig见 packages/contracts/src/keybindings.ts在解码时会丢弃客户端无法识别的规则比如该客户端版本发布后才新增的命令或when节点而不是让整个配置解析失败避免一个快捷键拖垮整条连接。具有特殊行为的命令thread.stopthread.stop用于中断当前线程中正在进行的回复running turn。它没有默认快捷键需要你在Settings → Keybindings中自行分配。chat.new 与 chat.newLocalchat.new开启新会话。当存在多个项目时可能会弹出项目选择器让你选择目标项目chat.newLocal跳过项目选择器直接创建新线程。两者均遵循你在新线程中设定的默认行为详见 new-thread defaults 一节。默认配置中两者均已绑定快捷键modn/modshiftn等且带!terminalFocus条件以避免干扰终端输入。保留快捷键modw 的行为与重新绑定在桌面端modw具有多级关闭语义按优先级依次是关闭获得焦点的终端terminal关闭当前激活的右侧面板标签页right-panel tab当没有可关闭的内容时关闭窗口。在浏览器中modw会关闭浏览器标签页浏览器自身行为T3 Code 无法拦截。因此如果你不希望误关浏览器标签建议为rightPanel.close和terminal.close重新绑定到一个可用快捷键例如altw。此外默认配置中大量规则都带有!terminalFocus条件目的是避免拦截终端输入——终端获得焦点时按键例如modl清屏等终端内快捷键应交给 shell 处理。当你重映射这些命令时若希望保持相同行为请保留这一条件。源码注释见 shouldShowThreadJumpHintsForModifiers也印证了这一点内嵌终端拥有焦点时按键会被 Ghostty 表面编码并直接写入 shell早于窗口级快捷键处理因此在终端聚焦时不会展示任何线程跳转快捷键提示。桌面端退出快捷键桌面端的退出快捷键为macOSCmdQWindows / LinuxCtrlQ默认采用Hold按住模式触发条件为按住 1.2 秒或在 500 毫秒内连续按两次。注意按住方式依赖系统的键盘重复keyboard repeat功能如果你禁用了键盘重复请改用双击方式或直接使用应用程序菜单退出。你可以在Settings → General → Confirmations → Quit shortcut中修改退出模式模式行为Hold默认按住 1.2 秒或 500ms 内双击Direct单击立即退出Double press仅支持连续按两次退出无论哪种模式从应用程序菜单选择Quit都会立即退出不受上述确认模式限制。默认快捷键一览完整默认配置定义在 packages/shared/src/keybindings.ts 的DEFAULT_KEYBINDINGS中以下是常用默认绑定mod在 macOS 为 Command其余平台为 Control快捷键命令条件modbsidebar.toggle—modjterminal.toggle—modaltbrightPanel.toggle—moddterminal.splitterminalFocusmodshiftdterminal.splitVerticalterminalFocusmodnterminal.newterminalFocusmodwterminal.closeterminalFocusmodwrightPanel.close!terminalFocusmodddiff.toggle!terminalFocusmodshiftjpreview.toggle—modrpreview.refreshpreviewFocusmod/modpreview.zoomInpreviewFocusmodkcommandPalette.toggle!terminalFocusmodpfilePicker.toggle!terminalFocusmodshiftfprojectSearch.toggle!terminalFocusmodscomposer.stash!terminalFocusmodn/modshiftochat.new!terminalFocusmodshiftnchat.newLocal!terminalFocusmodshiftmmodelPicker.toggle!terminalFocusmodoeditor.openFavorite—modshift[/modshift]thread.previous/thread.next—modshiftcthread.copyReference!terminalFocusmodshiftsthread.settle!terminalFocusmodshiftpthread.pin!terminalFocusmod1~mod9thread.jump.1~thread.jump.9—mod1~mod9modelPicker.jump.1~modelPicker.jump.9modelPickerOpen其中线程跳转thread.jump.N与模型选择器跳转modelPicker.jump.N命令由 packages/contracts/src/keybindings.ts 中的THREAD_JUMP_KEYBINDING_COMMANDS与MODEL_PICKER_JUMP_KEYBINDING_COMMANDS常量批量生成默认分别绑定到mod1~mod9模型选择器跳转额外要求modelPickerOpen条件因此与线程跳转不冲突。界面中按键标签的格式化如 macOS 下的⌘、⇧、⌥符号由 formatShortcutLabel 完成。总结T3 Code 的快捷键系统是一套声明式规则 严格校验 后绑定优先的完整方案规则存放在~/.t3/userdata/keybindings.json由服务端apps/server/src/keybindings.ts负责解析、校验、合并与持久化schema 约束定义在 packages/contracts/src/keybindings.ts客户端运行时apps/web/src/keybindings.ts负责按键分发与优先级判定。理解mod的跨平台映射、when表达式求值与最后匹配者胜出的优先级规则就能在不破坏终端输入的前提下构建一套贴合自己工作流的快捷键体系。【免费下载链接】t3code项目地址: https://gitcode.com/GitHub_Trending/t3/t3code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 T3 Code 键盘快捷键（Keybindings）配置完全指南：从配置文件到源码实现
T3 Code 键盘快捷键Keybindings配置完全指南从配置文件到源码实现【免费下载链接】t3code项目地址: https://gitcode.com/GitHub_Trending/t3/t3codeT3 Code 在 Web 端与桌面端提供了统一的快捷键定制能力你可以通过Settings → Keybindings图形界面或直接编辑环境机器上的~/.t3/userdata/keybindings.json配置文件为任意命令绑定、调整或移除快捷键。阅读完本文你将掌握快捷键规则的完整 JSON 语法、when条件表达式的编写方法、规则优先级判定原理以及modw、退出快捷键等特殊行为的处理细节并能结合源码理解 T3 Code 从配置解析、校验到按键分发的完整链路。在何处配置快捷键快捷键配置入口为Settings → KeybindingsWeb 与桌面端均可使用。该页面会列出当前版本可用的命令 IDCommand ID及其默认快捷键你可以直接在页面上进行以下操作点击快捷键胶囊Pill进入录制状态按下新的组合键完成绑定编辑或可视化构建when条件表达式将自定义过的绑定Reset to default恢复默认值或直接Remove移除通过搜索框快速过滤命令页面会实时给出快捷键冲突警告与未知条件警告。从源码看这个页面由 KeybindingsSettings.tsx 实现其中KeybindingConflictWarning明确提示The most recent matching binding wins when both conditions can apply当两个条件同时满足时最近匹配的绑定生效这与下文将要讲解的优先级规则完全一致。直接编辑配置文件除了图形界面快捷键配置以 JSON 文件形式存放在环境所在机器上默认路径为~/.t3/userdata/keybindings.json该文件是一个规则数组JSON array of rules例如[ { key: modg, command: terminal.toggle }, { key: modshiftg, command: terminal.new, when: terminalFocus } ]配置文件由 T3 Code 负责生命周期管理首次启动时T3 Code 会用默认规则创建该文件后续启动时若产品新增了默认快捷键T3 Code 会把新默认值追加进去新默认值不会覆盖你已经自定义过的命令绑定若某个新默认值与你的自定义快捷键重叠由规则顺序详见优先级一节决定最终生效者无效规则会被忽略如果整个文件无法解析例如 JSON 语法错误T3 Code 将直接回退使用默认配置。服务端的解析、校验、合并与持久化逻辑集中在 keybindings.tsserver其文件头注释明确指出该模块负责 parsing, validation, merge, and persistence of user keybinding configuration而配置文件解析失败时抛出的KeybindingsConfigError定义于 packages/contracts/src/keybindings.ts会携带配置路径configPath与错误详情detail方便定位问题。规则Rule的基本形态每条规则由三个字段组成其中key与command为必填字段必填说明key是快捷键组合例如modgcommand是要触发的命令 ID例如terminal.togglewhen否条件表达式限制该快捷键在什么上下文下生效命令 ID 的合法范围在 packages/contracts/src/keybindings.ts 中命令 ID 通过 Schema 严格校验由两部分组成静态命令列表STATIC_KEYBINDING_COMMANDS包括界面类sidebar.toggle、commandPalette.toggle、filePicker.toggle、projectSearch.toggle、themeEditor.toggle、rightPanel.toggle、rightPanel.toggleMaximized、rightPanel.close、diff.toggle终端类terminal.toggle、terminal.split、terminal.splitVertical、terminal.new、terminal.close预览类preview.toggle、preview.refresh、preview.focusUrl、preview.zoomIn、preview.zoomOut、preview.resetZoom会话/编辑类composer.stash、chat.new、chat.newLocal、editor.openFavorite模型选择器modelPicker.toggle以及modelPicker.jump.1~modelPicker.jump.9线程类thread.stop、thread.previous、thread.next、thread.copyReference、thread.settle、thread.pin以及thread.jump.1~thread.jump.9。项目脚本命令遵循SCRIPT_RUN_COMMAND_PATTERN格式为script.{id}.run例如script.test.run。其中id必须匹配^[a-z0-9][a-z0-9-]*$小写字母/数字开头可含连字符且最长 24 个字符。校验相关的长度与数量限制同一文件还定义了以下硬性约束写入超限内容将被视为无效规则快捷键字符串key最长64字符MAX_KEYBINDING_VALUE_LENGTHwhen表达式最长256字符MAX_KEYBINDING_WHEN_LENGTHwhen表达式的嵌套深度最大64层MAX_WHEN_EXPRESSION_DEPTH整个配置文件最多256条规则MAX_KEYBINDINGS_COUNT。按键语法Key Syntax使用连接修饰键modifier与按键例如modshiftd或ctrll。修饰键分为两类mod跨平台抽象修饰键——在 macOS 上表示Command在其他平台表示Control平台具体修饰键cmd/meta对应 Command/Windows 键、ctrl/control、alt/option、shift。从 parseKeybindingShortcut 的实现可以看到解析细节字符串会先转为小写、按切分并 trim 每个 token然后逐个识别cmd/meta→metaKey、ctrl/control→ctrlKey、shift→shiftKey、alt/option→altKey、mod→modKey只有最后一个非修饰 token 会被当作按键本身key且space会被规范化为空格、esc被规范化为escape。这意味着每条规则中只能有一个按键Key修饰键可以任意组合大小写不敏感ModShiftD与modshiftd等价若 token 解析后存在空片段或没有按键部分该快捷键无效。mod键在运行时如何映射桌面与 Web 客户端的匹配逻辑位于 apps/web/src/keybindings.ts 的matchesShortcutModifiers当平台为 macOS 时modKey参与metaKey期望匹配否则参与ctrlKey期望匹配同时要求metaKey、ctrlKey、shiftKey、altKey四者与事件完全一致才命中。非拉丁键盘布局的兼容处理同文件中的resolveEventKeys还处理了一个细节当系统布局输出的是非拉丁字母如西里尔文、希腊文或 macOS 上Option修饰产生特殊符号时会以物理键位event.codeKeyA~KeyZ作为回退匹配反之如果布局已经产生拉丁字母则只按布局键匹配避免一个被重映射的物理键同时触发两个字母的快捷键从而遮蔽非 QWERTY 布局下的系统快捷键。When 条件表达式可用的上下文键context key当前包括上下文键含义terminalFocus内嵌终端获得焦点terminalOpen终端面板处于打开状态previewFocus预览区域获得焦点previewOpen预览处于打开状态modelPickerOpen模型选择器处于打开状态未知的上下文键一律求值为false见 evaluateWhenNode 中return Boolean(context[node.name])的兜底行为因此不用担心拼写错误导致报错但该规则将永远不会匹配。图形界面对此会给出Unknown condition警告——在 KeybindingsSettings.tsx 中未知条件仍可保存但提示may not match unless the runtime provides it。组合运算符支持!非、与、||或以及括号分组例如{ key: modj, command: terminal.toggle, when: terminalOpen !terminalFocus }该表达式的含义是仅当终端已打开且终端未获得焦点时modj才切换终端——即终端获得焦点时按键会原样输入到 shell而不是触发切换。服务端解析when表达式的过程见 parseKeybindingWhenExpression先通过tokenizeWhenExpression分词识别、||、!、(、)与标识符再递归下降解析为 AST抽象语法树。AST 节点类型定义在 packages/contracts/src/keybindings.ts 的KeybindingWhenNode中仅有四种identifier标识符、not、and、or客户端运行时evaluateWhenNode对 AST 直接求值。图形界面中的可视化构建器在 Settings 页面编辑when时并不强制手写表达式——WhenExpressionBuilderKeybindingsSettings.tsx同时提供可直接编辑的表达式输入框带实时语法校验与错误提示可视化节点编辑器支持添加/删除条件Condition、嵌套分组Group、切换and/or运算符以及取反Not修改会同步回写表达式文本。优先级Precedence规则当多个规则使用相同快捷键时最后一条按键与条件同时匹配的规则生效即使它属于不同的命令。因此如果你要让多个命令共享同一快捷键应把更具体的规则放在更通用的规则之后。这一行为有明确的源码实现依据在 resolveShortcutCommand 中匹配循环从数组末尾向前遍历for (let index keybindings.length - 1; index 0; index - 1)遇到第一个同时满足when条件与按键组合的规则即返回其命令。默认配置中就有典型的同键不同条件案例{ key: modw, command: terminal.close, when: terminalFocus }, { key: modw, command: rightPanel.close, when: !terminalFocus }终端获得焦点时modw关闭终端其余场景下关闭右侧面板——两条规则靠when条件互斥不会冲突。另外值得注意的是客户端解析配置时的前向兼容设计ResolvedKeybindingsConfig见 packages/contracts/src/keybindings.ts在解码时会丢弃客户端无法识别的规则比如该客户端版本发布后才新增的命令或when节点而不是让整个配置解析失败避免一个快捷键拖垮整条连接。具有特殊行为的命令thread.stopthread.stop用于中断当前线程中正在进行的回复running turn。它没有默认快捷键需要你在Settings → Keybindings中自行分配。chat.new 与 chat.newLocalchat.new开启新会话。当存在多个项目时可能会弹出项目选择器让你选择目标项目chat.newLocal跳过项目选择器直接创建新线程。两者均遵循你在新线程中设定的默认行为详见 new-thread defaults 一节。默认配置中两者均已绑定快捷键modn/modshiftn等且带!terminalFocus条件以避免干扰终端输入。保留快捷键modw 的行为与重新绑定在桌面端modw具有多级关闭语义按优先级依次是关闭获得焦点的终端terminal关闭当前激活的右侧面板标签页right-panel tab当没有可关闭的内容时关闭窗口。在浏览器中modw会关闭浏览器标签页浏览器自身行为T3 Code 无法拦截。因此如果你不希望误关浏览器标签建议为rightPanel.close和terminal.close重新绑定到一个可用快捷键例如altw。此外默认配置中大量规则都带有!terminalFocus条件目的是避免拦截终端输入——终端获得焦点时按键例如modl清屏等终端内快捷键应交给 shell 处理。当你重映射这些命令时若希望保持相同行为请保留这一条件。源码注释见 shouldShowThreadJumpHintsForModifiers也印证了这一点内嵌终端拥有焦点时按键会被 Ghostty 表面编码并直接写入 shell早于窗口级快捷键处理因此在终端聚焦时不会展示任何线程跳转快捷键提示。桌面端退出快捷键桌面端的退出快捷键为macOSCmdQWindows / LinuxCtrlQ默认采用Hold按住模式触发条件为按住 1.2 秒或在 500 毫秒内连续按两次。注意按住方式依赖系统的键盘重复keyboard repeat功能如果你禁用了键盘重复请改用双击方式或直接使用应用程序菜单退出。你可以在Settings → General → Confirmations → Quit shortcut中修改退出模式模式行为Hold默认按住 1.2 秒或 500ms 内双击Direct单击立即退出Double press仅支持连续按两次退出无论哪种模式从应用程序菜单选择Quit都会立即退出不受上述确认模式限制。默认快捷键一览完整默认配置定义在 packages/shared/src/keybindings.ts 的DEFAULT_KEYBINDINGS中以下是常用默认绑定mod在 macOS 为 Command其余平台为 Control快捷键命令条件modbsidebar.toggle—modjterminal.toggle—modaltbrightPanel.toggle—moddterminal.splitterminalFocusmodshiftdterminal.splitVerticalterminalFocusmodnterminal.newterminalFocusmodwterminal.closeterminalFocusmodwrightPanel.close!terminalFocusmodddiff.toggle!terminalFocusmodshiftjpreview.toggle—modrpreview.refreshpreviewFocusmod/modpreview.zoomInpreviewFocusmodkcommandPalette.toggle!terminalFocusmodpfilePicker.toggle!terminalFocusmodshiftfprojectSearch.toggle!terminalFocusmodscomposer.stash!terminalFocusmodn/modshiftochat.new!terminalFocusmodshiftnchat.newLocal!terminalFocusmodshiftmmodelPicker.toggle!terminalFocusmodoeditor.openFavorite—modshift[/modshift]thread.previous/thread.next—modshiftcthread.copyReference!terminalFocusmodshiftsthread.settle!terminalFocusmodshiftpthread.pin!terminalFocusmod1~mod9thread.jump.1~thread.jump.9—mod1~mod9modelPicker.jump.1~modelPicker.jump.9modelPickerOpen其中线程跳转thread.jump.N与模型选择器跳转modelPicker.jump.N命令由 packages/contracts/src/keybindings.ts 中的THREAD_JUMP_KEYBINDING_COMMANDS与MODEL_PICKER_JUMP_KEYBINDING_COMMANDS常量批量生成默认分别绑定到mod1~mod9模型选择器跳转额外要求modelPickerOpen条件因此与线程跳转不冲突。界面中按键标签的格式化如 macOS 下的⌘、⇧、⌥符号由 formatShortcutLabel 完成。总结T3 Code 的快捷键系统是一套声明式规则 严格校验 后绑定优先的完整方案规则存放在~/.t3/userdata/keybindings.json由服务端apps/server/src/keybindings.ts负责解析、校验、合并与持久化schema 约束定义在 packages/contracts/src/keybindings.ts客户端运行时apps/web/src/keybindings.ts负责按键分发与优先级判定。理解mod的跨平台映射、when表达式求值与最后匹配者胜出的优先级规则就能在不破坏终端输入的前提下构建一套贴合自己工作流的快捷键体系。【免费下载链接】t3code项目地址: https://gitcode.com/GitHub_Trending/t3/t3code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考