wayscriber 是一款运行在 Linux 上的实时绘图叠层工具（Written in Rust），可以当作白板或黑板使用，也能叠加在任意应用上做标注、演示和截图。本文带你快速上手它的三大核心能力：自定义画板、网格背景纸和多页管理——无论是在线课堂、技术分享还是代码评审，都能立刻用得上。

1. 一键切换：白板、黑板与透明叠层 🎨

wayscriber 启动后默认是透明叠层（Overlay），画布完全透明，笔迹直接浮在桌面应用之上。三组快捷键覆盖最常用的切换场景：

内置 5 块画板：Overlay（透明）、Whiteboard、Blackboard、Blueprint（蓝图）、Corkboard（软木板）。每块画板都有各自的背景色与默认笔色，并支持auto_adjust_pen自动根据背景对比度调整笔色——切到黑板不用手动换白色笔，体验非常顺。

各画板的模板定义在配置文件的[[boards.items]]段落中，官方示例文件可直接参考：

• 画板模板定义：config.example.toml
• 更多配色思路（黑板绿、复古 Sepia 等示例）：config.example.toml

2. 自定义画板：新建、重命名与改色 ✍️

2.1 九块画板槽位，数字键直达

画板最多支持 9 个槽位（[boards] max_count = 9），每块画板都有专属快捷键：

• Ctrl+Shift+1~Ctrl+Shift+9：直达第 1~9 块画板
• Ctrl+Shift+←/Ctrl+Shift+→：上一块 / 下一块画板
• Ctrl+Shift+N：新建画板
• Ctrl+Shift+D：复制当前画板
• Ctrl+Shift+Delete：删除当前画板

快捷键定义见：config.example.toml。

2.2 画板选择器：重命名、改色、固定

按Ctrl+Shift+B打开画板选择器（Board Picker），一个模态列表里集中完成所有画板管理：

• 列出全部画板及各自快捷键，并显示活动画板的页面数
• 支持行内重命名与点击色块改背景色
• 右键画板可执行Edit Paper…（编辑纸张）、Rename Board、Pin Board

⚠️ 小提示：选择器里的行内编辑只作用于当前运行会话，不会改写config.toml中的模板。想让新建会话都用你的自定义画板，请打开配置器（F11）的 Boards 页面编辑模板，对应实现见 boards.rs。

2.3 纯色画板自由平移

在白板等纯色画板上，按住Space+ 左键拖动即可平移整个画布；透明叠层保持锚定屏幕，不参与平移。若画平移偏了，从画布右键上下文菜单选择Reset Canvas Position即可归位。相关说明见 docs/CONFIG.md。

3. 网格背景：方格纸、等距线、等距点阵 📐

给画板铺一张"纸"，是 wayscriber 画板最实用的自定义项之一。每块纯色画板都支持网格纸背景：

# [[boards.items]] 内的写法 grid = { kind = "cartesian", spacing = 40 }

四种纸张样式（kind）与间距规则：

• spacing（间距）：8–200 逻辑像素的整数，方格纸对应正方形边长，等距纸对应等边三角形边长；20和40是两个很舒服的常用档位
• 类型定义与默认值见：board_grid.rs
• 完整文档（Board paper patterns 章节）：docs/CONFIG.md

3.1 不改文件也能改纸张：三种入口

1. 打开画板选择器（Ctrl+Shift+B），选中某块纯色画板后点击其色块，或按Ctrl+C
2. 命令面板（Ctrl+K）搜索Edit Board Paper
3. 画布右键菜单 →Boards子菜单 →Edit Board Paper…

编辑器里可选择样式、拖动滑杆或直接输入间距，预览确认后Apply生效，Escape取消草稿。

3.2 网格纸的行为细节（这些很加分）

• 纸张锚定在画板坐标系上，跟随平移和缩放，始终位于所有笔迹之后
• 纸张不可被选中、不可擦除，也不参与撤销/重做；"清空画布"只清笔迹，纸张保留
• 缩略图与画布 PNG/PDF 导出都会带上同样的纸张图案
• 网格线/点会自动与画板背景对比出合适深浅，缩放过小时自动淡化避免视觉噪音
• 配合[drawing] shape_recognition_grid_snap = true（默认开启），**形状笔（Shape Pen）**识别出的直线会吸附到网格线、矩形椭圆边吸附到方格线、三角形顶点吸附到等距点，手绘图瞬间整齐

4. 多页管理：让一块画板变成工作簿 📑

每块画板都拥有相互独立的页面，就像一本工作簿：第 1 页画系统架构图、第 2 页列讨论问题、第 3 页记结论，互不干扰。

快捷键定义见：config.example.toml。页面集合的数据模型实现在 pages.rs。

几个实用的多页特性：

• 平移位置逐页独立：纯色画板的平移偏移量按页存储，每页各记各的位置
• 页面计数随时可见：状态栏的 page badge（show_status_page_badge）与画板选择器都会显示当前页码
• 整板导出多页 PDF：export_board_pdf_file将活动画板所有页面导出为一个多页 PDF，export_all_boards_pdf_file则按画板顺序导出全部画板，非常适合把课堂/会议白板归档
• 工具栏的Pages区块（show_pages_section）与Boards区块（show_boards_section）提供鼠标操作入口，右键菜单的Pages子菜单同样可翻页管理

5. 实战工作流示例 💡

场景：一次技术分享会

1. Ctrl+W进入白板，先讲背景（第 1 页）
2. 按Ctrl+Alt+N新建页面，切到 Blueprint 画板（带网格的蓝色画板）画部署拓扑
3. 讲到细节时Ctrl+Shift+Delete前先用Ctrl+Alt+D复制页面留底
4. 演示结束，用 PDF 导出把整块画板的所有页面存档

场景：结对编程代码评审

保持透明叠层直接盖在编辑器上，用矩形、箭头、便签标注问题点；需要白板头脑风暴时Ctrl+W一键切入，讲完Ctrl+Shift+T秒回透明叠层。

写在最后

wayscriber 把"白板 + 黑板 + 叠层标注"整合在同一套快捷键体系里：9 块画板槽位、四种网格纸、逐板多页加整板 PDF 导出，基本覆盖了线上教学、远程演示和代码评审的全部刚需。建议先从本文的快捷键速查表开始练手感，再按需修改[[boards.items]]模板——完整配置参考见 docs/CONFIG.md 与中文说明 README.zh-CN.md。