Plannotator 键盘快捷键完整参考：从绑定语法、四大 UI 表面到快捷键注册表运行时

【免费下载链接】plannotatorAnnotate and review coding agent plans and code diffs visually, share with your team, send feedback to agents with one click.项目地址https://gitcode.com/gh_mirrors/pl/plannotator点击查看免费下载本文基于 Plannotator 仓库的快捷键注册表shortcut registry源码给出计划评审、标注模式、目标设置与代码评审四大 UI 表面的全部键盘快捷键参考并深入讲解其绑定语法Mod、序列键、双击、hold、跨平台按键渲染规则以及从构建时文档生成到运行时事件分发的完整实现链路。读完你可以直接查阅任意界面的快捷键并理解如何安全地为 Plannotator 新增一条快捷键。快捷键参考页是如何生成的官方文档中的键盘快捷键参考页keyboard-shortcuts.md正文只有一行说明页面注释明确写道This page is auto-generated from the shortcut registry at build time. Editing the body below has no effect.也就是说该参考页不由文档本身维护而是在构建时从共享快捷键注册表自动生成。真正渲染页面的是 ShortcutReference.astro它遍历 shortcutReference.ts 导出的四个 surfaceplan-review、annotate-mode、goal-setup、code-review按 section 分组渲染出「Shortcut / Action / Notes」三列表格每个 surface 的 section 列表则由listRegistryShortcutSections对注册表求值得到。文档注释同时给出了维护入口要修改快捷键应编辑packages/ui/shortcuts/plan-review/或packages/ui/shortcuts/code-review/下对应的 scope 文件或各应用自身的packages/{editor,review-editor}/shortcuts.ts。本文的快捷键清单即从这些源码文件逐条提取与生成页内容一致。绑定语法与平台渲染规则理解快捷键表之前先理解注册表的绑定binding语法。核心定义在 core.tsbindings是字符串数组数组内多个绑定表示同一动作的替代键文档中渲染为or连接例如bindings: [ModShiftZ, ModY]显示为「ModShiftZ or ModY」Mod是跨平台修饰键在 macOS 上匹配Meta在其他平台匹配Ctrl见 matchesShortcutBinding 中requiresMod ! (event.metaKey || event.ctrlKey)的判断序列绑定用空格分隔键组G G、Alt Alt、Shift Shift表示双击double-tapAlt hold表示按住不放按键范围用特殊 token 表示A-Z匹配任意单个字母1-0匹配任意单个数字。所有 token 必须在白名单NAMED_TOKENS中core.ts#L42-L76Mod、Shift、Alt、Enter、Escape、Tab、Space、Backspace、Delete、方向键、Home/End、A-Z、1-0、hold、F1–F12以及作为目标键的标点. / [ ] { } ? $单个大写字母和数字除外。白名单是刻意显式维护的注释说明其目的就是让Cmd这类拼写错误在注册表校验阶段直接失败。按键在界面与文档中的渲染由formatKeycapToken/formatShortcutBindingTextcore.ts#L267-L331完成tokenmacOS 渲染非 macOS 渲染Mod⌘CtrlAlt⌥AltShift⇧ShiftEnter⏎↵EscapeEscEscAlt AltDouble-tap ⌥ / Double-tap Alt同左Alt holdHold ⌥ / Hold Alt同左本文表格统一使用跨平台写法Mod在 macOS 上按 Cmd在其他平台按 Ctrl。Plan review计划评审快捷键Plan review 表面的注册表由 packages/editor/shortcuts.ts 组装planReviewEditorSettingsShortcutsplan-editorscope 的设置子集含 submitPlan、quickSave、exitPlanDiff、printPlan 四个动作加上 11 个共享 scope。Actions快捷键动作说明ModEnterApprove / Send feedback无标注时执行批准有标注时发送反馈。ModSSave to notes app未配置默认笔记应用时打开 Export。EscapeClose diff view仅在 plan diff 打开时可用。ModPPrint打开浏览器打印对话框。Document View快捷键动作说明Mod.Toggle focus mode同时收起 Contents 侧栏与右侧面板再按一次恢复原先打开的状态。ModEToggle edit mode就地打开 markdown 源码编辑器并保持滚动位置再按一次提交编辑并返回标注。Input Method快捷键动作说明Althold按住Temporarily switch input method按住 Alt 在 Select 与 Pinpoint 输入方式间临时切换松开即还原。Alt双击Toggle input method双击 Alt 在 Select 与 Pinpoint 间切换直到再次切换。HTML AnnotateHTML 与 live app 表面快捷键动作说明ModShiftAToggle annotate mode启用/取消标注捕获把点击交还给页面。Esc 会退出 Annotate本键是重新进入的途径。ModShiftXShow or hide tools页头眼睛按钮显示或移除页面上所有浮动工具HTML 表面默认以工具隐藏状态打开。Annotation Mode标注模式快捷键动作说明Shift1Markup mode选中文字后打开标注工具栏。Shift2Comment mode选中文字后打开评论编辑器。Shift3Redline mode选中文字标记为删除。Shift4Label mode选中文字后打开快速标签选择器。Annotation Toolbar标注工具栏快捷键动作说明任意字母A-ZStart comment输入字母即以该字符开头打开评论编辑器。Alt数字1-0Apply toolbar label工具栏打开时应用对应预设标签。数字1-0Apply picker label快速标签选择器打开时可用。EscapeClose toolbar工具栏打开时可用。Comment Editor评论编辑器快捷键动作说明ModEnterSubmit comment评论编辑器打开时可用。词首输入/或$Reference an agent skill在评论编辑器词首输入/或$打开技能菜单继续输入过滤默认不预选任何行Enter 仍是换行用方向键或点击选中一行后 Enter 或 Tab 插入Escape 关闭菜单。EscapeClose comment评论编辑器打开时可用。Annotation Panel侧栏标注编辑快捷键动作说明ModEnterSave annotation edit在侧栏编辑标注时可用。EscapeCancel annotation edit在侧栏编辑标注时可用。Viewer查看器 / 图片灯箱快捷键动作说明ModCCopy selected text—EscapeClose image lightbox图片灯箱打开时可用。Vim selectionVim 式选择Vim 选择模式共 25 条绑定定义于 vimSelection.shortcuts.ts配套使用文档见 docs/vim-controls.md快捷键动作J移动到下一个 block 或语义同级节点K移动到上一个 block 或语义同级节点G G双击 G跳到文档开头ShiftG跳到文档结尾H移动到包含当前选中的目标targetL精化选择到子节点或文本V切换精确 Visual 选择ShiftV切换整块 Visual 选择W/B/E词尾 / 词首 / 词结束处移动0/$行首 / 行尾{/}上一个 / 下一个文本块O交换选择的两端Enter按当前标注模式使用选择Space打开标注动作C/D/M/T/Y评论 / 划线 / 标色 / 标签 / 复制当前选择或目标Escape取消当前 Vim 状态?显示/隐藏键位帮助Image Annotator图片标注器快捷键动作说明1/2/3Pen / Arrow / Circle 工具—ModZUndo—ModShiftZorModYRedo—EnterorEscapeSave and close annotator图片名输入框聚焦时Escape 先失焦、Enter 确认名称其余情况下两者都关闭标注器。History快捷键动作ModZUndo annotation changeModShiftZorModYRedo annotation changeAnnotate mode独立标注模式快捷键Annotate 表面的注册表在 packages/editor/shortcuts.ts#L106-L125 中组装与 plan review 共享上节列出的 11 个 scopeDocument View、Input Method、HTML Annotate、Annotation Mode、Annotation Toolbar、Comment Editor、Annotation Panel、Viewer、Vim selection、Image Annotator、History差异在自身特有 scopeActions快捷键动作说明ModEnterDone / Send feedback以页头显示为准触发自适应页头主按钮无内容时 Done门禁模式下为 Approve否则 Send Feedback。ModEnter备注框Send the note with the decision you picked决策控件的备注框打开时可用此时 Enter 只插入换行。Escape备注框Step back to the decision menu, keeping the note返回决策菜单并保留已输入备注。ModSSave to notes app同 plan review。ModPPrint同 plan review。Annotate Sidebar快捷键动作说明ModBToggle Contents sidebar—ModShiftBToggle Files sidebarFiles 标签页显示时可用。Shift双击Toggle Agent TUI sidebarAgent 控件显示时可用。值得注意的实现细节两个表面的plan-editorscope 是刻意拆分的子集——plan review 面使用submitPlan批准/反馈annotate 面使用submitAnnotationsDone/反馈二者虽同为ModEnter但语义与when守卫各不相同避免同一键位在不同表面触发错误动作。Goal setup目标设置快捷键Goal setup 表面注册表最小仅一个动作packages/editor/shortcuts.ts#L127-L151。快捷键动作说明ModEnterSubmit answers / facts提交捆绑的目标设置访谈或事实确认。从源码结构看共享 scope goalSetup.shortcuts.ts 目前是一个空shortcuts对象占位 scope该表面所有实际动作都来自编辑器侧的goalSetupEditorSettingsShortcuts。Code review代码评审快捷键Code review 表面的注册表由 packages/review-editor/shortcuts.ts#L113-L131 组装覆盖评审编辑器的全部界面Actions快捷键动作说明ModEnterApprove / Send feedback以页头显示为准无标注时 Approve否则 Send Feedback。ModShiftYCopy feedback to clipboard—Alt双击Toggle review destinationPR review 模式下在 platform 与 agent 之间切换评审目标。ModEnter备注框Send the note with the decision you picked决策控件备注框打开时可用Enter 只插入换行。Escape备注框Step back to the decision menu, keeping the note—Search快捷键动作说明ModFFocus search文件树搜索栏显示时可用。EnterorF3Next search result—ShiftEnterorShiftF3Previous search result—EscapeClear search / close panel—Layout快捷键动作说明ModBToggle file tree—Mod.Toggle review sidebar—ModShiftTToggle demo tour dialog仅 dev 构建可用。ModShiftGToggle guided review打开或关闭引导式评审全屏接管。File Actions快捷键动作说明VToggle file viewed标记当前 diff 文件为已查看在 all-files 视图中自动折叠。AStage current file支持暂存时可用PR review 模式下不可用。History快捷键动作ModZUndo annotation changeModShiftZorModYRedo annotation changeFile Navigation快捷键动作Jor↓下一个文件Kor↑上一个文件Home第一个文件End最后一个文件All-Files Diff View快捷键动作说明XCollapse / expand current fileall-files diff 面板激活时可用。ZRe-expand nearest collapsed file重新展开当前位置或上方最近的已折叠文件切换 viewed 状态也会触发折叠。CAdd file-scoped comment为当前文件打开文件级评论弹层。]/[滚动到下一个 / 上一个文件仅 all-files 面板。Review Annotation Toolbar快捷键动作说明ModEnterSubmit comment评审评论编辑器打开时可用。TabIndent suggested code在建议代码中插入缩进。EscapeClose comment editor—Suggestion Editor快捷键动作说明TabIndent插入空格展开的建议编辑器中可用。EscapeClose suggestion editor关闭弹窗建议文本保留在底层评论上。AI Assistant快捷键动作说明ModEnterSend messageAI 标签页与 Ask AI 内联输入框中可用。EscapeCancel inline AI inputAsk AI 内联输入框中可用。PR Comments / Tour Dialog快捷键动作说明ModShiftFFocus PR comments search评审侧栏的 PR Comments 标签页打开时可用。EscapeClose tour代码 tour 对话框打开时可用。运行时注册表如何变成按键行为定义只是数据真正驱动按键的是 runtime.ts 中的三个机制。单次按键分发useShortcutScope把 scope 挂到window/document/任意 EventTarget 上逐条bindings调用matchesShortcutBinding比对KeyboardEvent。handler 可以是纯函数也可以带when守卫例如「仅当灯箱打开时」匹配后按preventDefault标记决定是否阻止默认行为stopOnMatch默认 true决定首个匹配是否终止分发。handler 通过 ref 读取监听器生命周期只跟随 scope、target 与分发选项。序列绑定500ms 窗口含空格的绑定G G、Shift Shift不走单次匹配而是由useShortcutScope内部的序列状态机处理——首个键组命中后在SHORTCUT_SEQUENCE_WINDOW_MS 500毫秒窗口内等待后续键组命中前缀键会preventDefault以吞掉多余的输入字符匹配成功、窗口超时或按下无关键都会重置序列runtime.ts#L43、runtime.ts#L121-L214。双击useDoubleTapShortcuts默认 300ms 窗口Alt Alt这类双击绑定在keyup上检测——同一键在窗口内被单独按下并释放两次才触发。实现里有严格的「干净按压」判定按压期间混入其他修饰键、按下无关键、或中途发生鼠标点击如 ShiftClick 扩选都会使序列失效从而避免「打两个首字母大写单词」误触发 Alt 双击触发后重置时间戳也防止三次连点重复触发runtime.ts#L259-L352。跨 scope 仲裁的现状runtime.ts#L64-L70 的 TODO 注释明确说明当前尚无常跨 scope 仲裁——外层编辑器与内层对话框同时绑定Escape时两个监听器都会触发约定调用方用when守卫防止双重处理。阅读源码或编写新 handler 时应遵循这一约定。注册表校验与新增快捷键的正确姿势createShortcutRegistry在创建注册表时同步执行 validateShortcutRegistry任何违规直接抛错构建期/测试期失败而非运行时静默scopeid不得重复每条快捷键必须有非空section、非空descriptionbindings至少一条且每条的非空 token 必须全部通过NAMED_TOKENS 单字母 单数字的白名单校验拼写错误如Cmd会在这里失败mergeShortcutRegistries合并多个注册表时同样走完整校验。新增一条快捷键的完整路径是在对应 surface 的 scope 文件中添加动作条目plan/annotate 共享 scope 位于 packages/ui/shortcuts/plan-review/代码评审 scope 位于 packages/ui/shortcuts/code-review/应用级动作位于 packages/editor/shortcuts.ts 或 packages/review-editor/shortcuts.ts为每条提供description、bindings、section可选hint显示为文档表格的 Notes 列与displayOrder同一 section 内的稳定排序避免依赖对象键序在消费组件中用createShortcutScopeHook生成的 hook 绑定 handler双击绑定改用createDoubleTapShortcutsHook参考 packages/ui/shortcuts.test.ts 的既有测试模式为绑定匹配与注册表校验补测试。由于参考页在构建时从同一注册表渲染新增的快捷键会自动出现在官方文档的表格中——这正是「文档即源码」策略的价值所在快捷键文档永远不会与实际行为脱节。小结Plannotator 的键盘快捷键体系由三层构成packages/ui/shortcuts/中带校验与白名单的声明式注册表、packages/{editor,review-editor}/shortcuts.ts中按 surface 组装的注册表、以及runtime.ts中处理单次/序列/双击三种时序语义的分发运行时官方参考页则由构建管线从同一注册表生成。上文的四张快捷键总表与生成页内容一一对应可作为日常使用 Plannotator 各界面的完整快捷键速查。赞分享【免费下载链接】plannotatorAnnotate and review coding agent plans and code diffs visually, share with your team, send feedback to agents with one click.项目地址https://gitcode.com/gh_mirrors/pl/plannotator点击查看免费下载相关推荐Microsoft Outlook 键盘快捷键完全参考210 个快捷键速查表Microsoft Outlook 键盘快捷键完全参考210 个快捷键速查表 本文是仓库 source/_posts/outlook.md https://文档教程知识库Webflow 键盘快捷键速查表41 个快捷键完整指南Webflow 键盘快捷键速查表41 个快捷键完整指南 Webflow 是一款可视化网页设计工具开发者可以在无需手写 HTML/CSS 的情况下完成响应式文档教程知识库ChatGPT桌面应用快捷键图表打印版快捷键参考卡片ChatGPT桌面应用快捷键图表打印版快捷键参考卡片 你是否经常在使用ChatGPT桌面应用时忘记常用快捷键本文整理了一份实用的快捷键参考卡片包含窗口控制桌面应用AI 应用上一篇PowerToys Run URI 插件深度解析如何解析、解析校验并排序用户输入的 URI下一篇Pock容器化部署Docker使用指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考