键盘快捷键
VizChat 所有常用键盘快捷键:工作区、画布、Storyboard、聊天、文件树。
本页覆盖当前版本内置的快捷键。macOS 使用 Cmd,Windows/Linux 使用 Ctrl。在输入框(input / textarea / contenteditable)聚焦时,大多数全局快捷键会自动禁用,避免与文本输入冲突。
工作区全局
在工作区界面(侧边栏、聊天、工作台)任意位置生效。
| 快捷键 | 作用 |
|---|---|
Cmd / Ctrl + K | 快速打开(文件 / 我的组件 / 我的模板) |
Cmd / Ctrl + B | 折叠 / 展开左侧栏 |
Cmd / Ctrl + S | 立即保存(见下) |
? | 打开快捷键帮助面板 |
Cmd / Ctrl + Z | 撤销当前文件的上一步改动 |
Cmd / Ctrl + Shift + Z | 重做刚撤销的改动 |
关于撤销:撤销只作用于当前打开的那个文件——看着 A 按撤销不会回退 B。AI 一轮回复里的多处改动算一步,一次撤销整轮退回;对话记录会保留,并标注该轮已撤销。AI 消息下方还有「撤销此轮」按钮,点它会先列出本轮涉及的文件、逐份标明会怎么处理:已被后续修改覆盖的文件标「本次不回退」,那部分请在对应文件里用 Cmd / Ctrl + Z 逐步撤销;AI 改动时没有打开的文件标「不在撤销范围」——它没有被任何东西覆盖,只是从未被记录过,Cmd / Ctrl + Z 同样够不着。撤销历史存在当前标签页里,刷新或关闭页面即清空(已保存的改动本身不受影响)。若文件在别处被改过(另一个标签页、另一台设备),本页的撤销历史会失效——这是为了避免覆盖掉别人的改动。
工作台标签栏右上角还有撤销 / 重做按钮与一个修改历史入口(时钟图标)。历史是一条完整的线:「当前」标记之下是可撤销的过去,之上是已撤销、还能重做的未来——点任意一个节点即可一次跳到那一刻。未来节点只在你真正产生新改动时才消失。AI 那些节点还能跳到聊天里对应的消息。
关于 Cmd + S:文档是自动保存的(编辑时失焦或停止输入片刻即写入),这个键的作用是立即冲掉等待中的保存,同时拦下浏览器的「保存网页」对话框。确有内容被写出时会提示「已保存」;没有待保存内容时不做任何提示。
画布内同样生效。 画布运行在独立的安全沙箱(跨域 iframe)中,浏览器不会把其中的按键直接传给外层界面,因此画布会把这些快捷键转交给工作区执行。唯一的例外是焦点落在组件的展开编辑视图里时——那是再内一层的沙箱,此时请先点击它外面的区域再按。
画布内
焦点在画布中时生效。
| 快捷键 | 作用 |
|---|---|
Cmd / Ctrl + C | 复制选中的组件 |
Cmd / Ctrl + V | 粘贴组件 |
Backspace / Delete | 删除选中的组件 |
Cmd / Ctrl + 点击 | 加选 / 减选多个组件 |
| 拖拽空白处 | 框选多个组件 |
Space + 拖拽 | 平移画布 |
| 滚轮 / 触控板捏合 | 缩放画布 |
Esc | 取消选中 |
只读场景(如从组件市场预览他人模板)下复制、粘贴与删除不可用。
Storyboard 播放模式
下列快捷键仅在 Storyboard 模式(非输入聚焦)生效:
| 快捷键 | 作用 |
|---|---|
↑ | 上一个 Slide |
↓ | 下一个 Slide |
← | 上一句(跨 Slide 边界) |
→ | 下一句 |
Space | 开始 / 暂停自动播放(完成态再次按会重播) |
F | 切换全屏演示模式 |
聊天与输入
| 快捷键 | 作用 |
|---|---|
Enter | 发送消息 |
Shift + Enter | 换行 |
Esc | 关闭 @提及下拉 / 取消编辑 |
@ | 触发 mention 搜索(文件;@widget: 搜组件) |
/ | 触发斜杠命令菜单 |
IME 兼容性:中文 / 日文 / 韩文输入法合成态按下 Enter 时不会发送消息,而是让 IME 完成候选词选择。内部通过 isComposing + onCompositionStart/End 实现,不需要用户额外处理。
文件树与工作区
| 快捷键 | 作用 |
|---|---|
Enter(行聚焦) | 打开文件 / 确认重命名 |
Esc | 取消重命名 |
| 右键 / 长按 | 弹出上下文菜单 |
仍未覆盖的场景
跨文件的全文搜索与自定义快捷键目前都没有。Cmd / Ctrl + K 能按名字找文件、组件与模板,但不搜文件内容。这两项如果对你重要,欢迎在 issue 里说明场景。