边画，边让故事成形。

各版本发布日期以更新日志为准；用版本先后顺序区分迭代。0.1–0.6 对应早期六次测试，内部候选改进归入 1.0。旧包和源码标签保留原编号，便于回溯；本手册不附旧版程序。

共 27 项对照

比较对象固定为项目使用的 Pencil2D v0.7.2。这里只把本分支实际实现的差异列为新增或改动。

上图来自 1.1.1 的实际 Qt 控件渲染与合成输入测试，可点击放大。

▶ 播放↺ 重播轮盘松键选择演示进度

0:00

GIF 原图 ↗下载 GIF

新增 · 相机和刚才画的那一层，一键往返

1. 在画布上按 Tab 打开轮盘。
2. 点击中央的相机／纸张按钮，切到相机层并启用相机工具。
3. 再打开轮盘，点击同一按钮，回到刚才的位图层，同时恢复绘画工具。

不会把你的外圈工具挤走。也可以右键一个外圈圆钮，绑定“相机层 / 绘画层”，沿用按住 Tab 后松键确认的方式。

什么情况下不会选中？

从没碰到圆钮就直接滑到远处、回到中心、跨出已激活的扇区、进入菜单 / 标题栏或窗口外，都会取消当前候选。按 Esc 或再按一次 Tab 可以收起。

▶ 播放↺ 重播相机旋转演示进度

0:00

GIF 原图 ↗下载 GIF

相机操作支持撤销、重做和保存。做相机运动时，在相机层选好相应关键帧再调整取景；基础相机动画继续沿用 Pencil2D。

编号不跟着缩放，光标跟着框转

相机内安全框左上角的 C02-k1 表示镜头与画面顺序。文字保持 16 个逻辑像素，不随缩放变大，但位置和方向跟相机框一起移动、旋转；深灰字配浅描边。

自定义缩放、旋转和调时长光标增大到 64 个逻辑像素，圆角黑色主体配白边与轻柔光，浅色和深色背景都能看清。旋转箭头随框角方向变化；文字编辑和 Windows 系统光标保留原生形式。

关键帧和镜头长度，拖的时候就能看见变化

拖画面区块边缘调整停留时间；拖镜头右下角的小方块按比例调整整段。光标上方显示帧数，相机与声音随之预览，松开才提交一次修改。按 Esc 放弃，靠近左右边缘会持续滚动。

改动若会让相机关键帧重叠，则取消本次修改。声音保持原速，不做音频变速。

选中什么，就对什么操作

• 已选中内容：Backspace / Delete 删除；没有选中内容、只指到某一帧：Backspace 新增关键帧。
• 普通删除留空；Shift+Delete 或右键「波纹删除镜头」合拢。其他未锁定轨道有交叠内容时会提示。
• Ctrl+A 选择所有未锁定镜头；Shift 单击镜头标题多选。右键可以选择本轨后续镜头，或把选中镜头关联起来。
• 拖镜头标题移动整段；放到已有镜头上采用覆盖剪辑，仅替换重叠时间，前后剩余画稿保留，Ctrl+Z 可恢复。
• 切分工具按点击帧切开实际画稿、相机和声音；抓手工具平移时间轴。

相机与声音，不只是显示用的色条

相机区可按退格增加控制点，拖动菱形改帧位，选中后 Delete 删除。声音块可拖动，拖两端裁剪，切分工具可切开声音。

「＋声音轨」先加空轨，然后把音频文件拖进镜头覆盖的区域；也可点「导入声音」。当前声音仍归属于镜头，不能作为跨多个镜头的全局音乐轨；暂时没有波形、混音或变速。

观看 1.2.0 镜头长度演示（旧布局，拖动原理保留）

这段动图来自 1.2.0。1.2.1 已将图层与剪辑合并为一个面板；请以本节新截图和文字为准。

▶ 播放↺ 重播镜头调时长演示进度

0:00

GIF 原图 ↗下载 GIF

1. 先选要落字的画稿层，再点击 T 工具或按 T。
2. 点画布上的落字位置，输入文字。可换行、改字体、像素字号和粗体，使用当前绘画颜色。
3. 看着画布上的预览，点击「放入画面」。取消不会留下文字。

确认后文字成为当前层的位图像素，能撤销、保存与导出；可用 Ctrl 整笔选择移动、缩放、旋转。目前不能重新编辑已确认的字句，也没有独立字幕轨。需要改字时撤销后重新输入。

当前操作：从镜头外的空白处拉框选镜头；从镜头内画面区块下方的空白带拉框选本镜头关键帧。Shift 加选／减选，边缘调整停留时间，拖区块移动。

选中内容时，退格或 Delete 删除选中对象；没有选中内容时，退格在鼠标指到的帧位新建关键帧。先按 Esc 可清空选择。更多操作见 统一剪辑区。

展开早期逐帧时间轴演示（1.0–1.1.3，保留供版本对照）

新增 · 鼠标指到帧位，按退格建帧

1. 把鼠标移到想添加内容的位图轨道或相机轨道。
2. 看竖向虚线停在哪一格；它现在按帧跳动，同一格内不会晃。
3. 按 Backspace（退格键），直接在这一帧创建关键帧，并切到这里。

已有关键帧时保持原样，不覆盖，也不挤动后面的帧。按 Ctrl + Z 可以撤销。鼠标放在上方时间尺时，在当前选中图层建帧；隐藏轨道、声音轨道不创建。

正在输入文字或数值、播放、弹窗操作、按笔绘画时不会抢占退格键。

▶ 播放↺ 重播关键帧直接拖动演示进度

0:00

GIF 原图 ↗下载 GIF

调整前 · 12 fps1这一张画 · 1 秒13

调整后 · 12 fps1这一张画 · 1.5 秒19

移动的实际规则

1. 直接按住关键帧拖动，第一次按下就能拖。按住两关键帧之间的延续区域，会抓取它的起始关键帧。
2. 拖动时看轮廓、目标帧号和偏移；到可视区域边缘会自动滚动。
3. 松开落下。目标已有关键帧时变红，松开取消，不会覆盖或自动挤走它。
4. 途中按 Esc 或切出窗口，可放弃这次移动。

成组调整与撤销

Ctrl 多选、Shift 连选、Alt 选择后续帧，以及空白处框选继续保留。选中后可一起拖。

移动一个关键帧不会自动把所有后续帧一起推走；要整组挪动，先选好那一组。

Ctrl + Z 撤销，Ctrl + Shift + Z 重做。绘画和移动按同一操作顺序回退，历史仍限 20 步。

位图底色位图关键帧相机底色相机关键帧

两关键帧之间的延续区颜色更深；选中高亮与播放头可能覆盖基础配色。鼠标定位竖线按帧边界跳动，单纯移动鼠标不会改变当前播放帧；按退格新建关键帧后才切到目标帧。

把按键改成顺手的

1. 打开「编辑 → 首选项 → 快捷键」，单击要修改的一行。
2. 需要清除时，双击快捷键或录入框。
3. 直接按下想绑定的键或组合，全部松开后即设置。
4. 发生冲突时只问一次。确认会移除其他功能的同一绑定；取消保留原来设置。

可以录入字母、数字、标点、单独 Alt / Ctrl / Shift，以及组合键。已经用来组成其他快捷键或参与滚轮操作的修饰键，不会在松开时再误触发一次。Windows 保留组合仍由系统优先处理。

这些暂时还没有

• 镜头文件夹、完整剧本与分镜生产管理系统
• 任意像素的套索裁切、模糊笔刷（整笔套选已在 1.1 加入）
• 尾帧停留 / 循环 / 往复轮盘
• 2D 内容补间与曲线编辑器
• GLB 三维导入与 2.5D 工作流
• ABR 和完整 Photoshop 笔刷兼容

关于顺畅与验证

轮盘文字、相机光标和时间轴底图使用缓存；套索预览局部刷新，移动关键帧不复制整幅画面。相应轮询或动画只在需要的交互期间活动。

1.0 的记录包含 58 个核心用例 / 699 条断言、100% 与 200% 缩放下各 256 项 Qt 检查，以及两套 PNG / MP4 导出与解码检查。这能帮助发现功能回归，但不能承诺所有工程绝不卡顿；实际数位板手感仍需要体验反馈。

1.2.0 已通过 81 个核心用例 / 986 条断言，100% 与 200% 显示缩放下各 368 项 Qt 界面检查；另核对了镜头叠加、84 帧导出、空白时段和音频裁切。输入检查包含合成数位笔事件，不等于实物数位板手感测试。

1.2.1：86 个核心用例／1083 条断言，开发环境 414 项界面检查，完整运行依赖在 100% 和 200% 缩放下各 414 项通过；84 帧 PNG／MP4、完整解码和音频裁切核对通过。固定 1004 镜头场景单次时间轴绘制约 1.2–1.9 毫秒；并非任意复杂工程的保证。

1.2.2：86 个核心用例／1083 条断言；开发环境与完整运行组件各 433 项 Qt 检查，后者包含 100% 和 200% 显示缩放。导出仍核对 84 帧 PNG／MP4、镜头边界和音频裁切。滚轮参数是本项目调校值，未声称与 Adobe 私有实现完全相同。

• Pencil2D v0.7.2 上游源码 ↗本项目的固定比较基线。
• Pencil2D 官方使用手册 ↗核对原有画布、图层、时间轴、相机与面板能力。
• Pencil2D 0.7.2 发布记录 ↗不把上游已存在的改进算作本项目新增。
• Blender 窗口系统手册 ↗借鉴文档导航和图文组织思路；本文不是 Blender 官方手册。

本地依据：各版本日志与验证记录。当前源码标签 hanabi-1.2.2，提交 316cdf2126e100a8d9fbc7306e87d1a175c1d7b3。对应源码随安装包提供。

HÁNABǏ Board 基于 Pencil2D，保留原作者版权与 GPL-2.0 授权。本手册保留 1.0 操作动图，整笔选择图片来自 1.1.1 控件渲染，切层按钮和逐帧定位图片来自 1.1.3 控件渲染；历史版本页中的“怎么用”跳转到现行用法。

手册整理：2026-09-18 · 使用说明适用版本：1.2.2。

1.2.0 新增剪辑截图和动图来自实际 Qt 控件渲染与合成输入。镜头结构、保存重开、撤销、逐帧导出和声音裁切有独立检查；性能数据为固定场景测量，未把模拟笔事件当成实物数位板验证。

1.2.1 新截图来自实际 Qt 控件渲染。界面检查包含镜头内外框选、空隙删除、鼠标与合成笔、文字、保存重开；测试不能代替实体数位板手感，也不代表任意体量工程都零延迟。

1.2.2 工作区截图来自真实 Qt 控件。新增检查覆盖焦点仍在画布时的悬停滚轮、相机往返后的实际像素落笔、缩略图更新、分区拖动与相机重叠选择；实体数位板手感仍需体验验证。