当前版本实际界面 · 1.0用这份手册，快速找到需要的内容
初次体验先看操作；已经用过旧版，先看更新日志。
这次更新改了什么？
点开版本时间线，看新增、优化、修复与使用入口。
02 / 与原版比哪些功能是我们加的？
逐项对照 Pencil2D，区分新增、改动、移除和保留。
03 / 跟着动图用按住时发生了什么？
暂停、重播或拖动进度，仔细看工具的响应。
第一次启动、保存和分享工程
- 完整解压程序体验包，运行「启动 HÁNABǏ Board.cmd」或 app 文件夹中的 HANABI-Board.exe。不要只拷走一个 EXE。
- 创建工程后在位图层绘画。用 Ctrl + S 保存为
.pclx，用 Ctrl + Shift + S 另存一个副本。 - 新增关键帧用 F7，复制当前关键帧用 F6；Ctrl + Return 播放 / 停止。
- 通过「文件 → 导出」输出图片序列或视频。这些能力沿用 Pencil2D；相机决定最终取景。
每一步改动，都留在这里
点击一个版本，查看当时做了什么；“怎么用”链接会带你到 1.0 的现行说明。
档案中的发布日期均为 2026-09-15；用版本先后顺序区分迭代。0.1–0.6 对应早期六次测试，内部候选改进归入 1.0。旧包和源码标签保留原编号，便于回溯；本手册不附旧版程序。
相比 Pencil2D，改了这些
先认清工具的边界，就不会把没实现的功能当成入口找。
共 20 项对照
| 类型 / 功能 | Pencil2D 0.7.2 | HÁNABǏ Board 1.0 |
|---|---|---|
| 新增套索填充 ↗ | 无本项目的套索填色工具 | D 勾画、实时预览，松开填入当前位图层；Esc 取消 |
| 新增独立 PS 式笔刷 ↗ | 原生铅笔、钢笔、笔刷等 | 另加印章式引擎和 9 类参数 / 压感控制；原生笔刷保留 |
| 新增笔刷预设库 ↗ | 无本项目的跨引擎预设库 | 保存、调用、重命名、删除，笔尖缩略图，独立于工程保存 |
| 新增自定义工具轮盘 ↗ | 无本项目的 Tab 圆钮轮盘 | 2–12 项，工具 / 预设绑定；点击或长按 Tab 扇区确认 |
| 新增独立相机工具 C ↗ | 相机层配合移动工具操作 | 明确的摄像机入口，直接选择相机层；旧移动工具仍可用 |
| 改动相机控制与光标 ↗ | 原生相机与控制框 | 外侧圆角旋转区、悬停柔光、48 逻辑像素光标、随框转向，接入撤销 |
| 改动工具短按 / 长按 ↗ | 已有抓手等临时操作 | 扩展为工具键的短按保留 / 长按返回；C 还恢复原绘画层 |
| 改动关键帧直接拖动 ↗ | 原生关键帧时间轴 | 首次按下即可拖、延续区抓取、实时落点、边缘滚动、冲突取消 |
| 改动移动与绘画混合撤销 ↗ | 原生撤销重做 | 移动与绘画按顺序进入同一历史；不复制整幅图，历史仍为 20 步 |
| 改动时间轴视觉反馈 ↗ | 原生轨道与选择 | 分层配色、加深延续区、跟随鼠标的定位线；播放头独立 |
| 改动透写台入口 ↗ | 已有洋葱皮与参数面板 | 收为时间轴小灯泡，点击浮出完整设置，外部点击收起 |
| 新增透写台自选颜色 / 吸色 ↗ | 前后帧已有着色显示 | 前后颜色独立保存，可在软件画布、色板、浮动面板内取色 |
| 改动快捷键设置 ↗ | 已有可配置快捷键 | 松键录入、双击清空、标点 / 修饰键 / 组合键，冲突只询问一次 |
| 新增浅色 / 深色外观选择 ↗ | 沿用原有界面外观 | 中性深灰贯穿主窗口与子界面，立即切换；预设列表仍为白底 |
| 改动新面板与原生停靠 ↗ | 已有浮动、停靠和窗口菜单 | 新面板接入菜单；PS 参数可滚动，不挤住时间轴调整高度 |
| 改动交互刷新与缓存 ↗ | 原生绘画 / 时间轴渲染 | 轮盘文字、相机光标与时间轴底图复用；活动结束停用相应轮询 |
| 改动品牌、版本与设置 ↗ | Pencil2D 名称与独立配置 | HÁNABǏ 名称、圆角图标、数字版本、便携包；预设与布局延续 |
| 移除矢量绘画 ↗ | 位图、矢量、声音、相机 | 移除矢量层、路径 / 曲线编辑与专用读写；旧矢量工程明确拒绝 |
| 保留无限画布 / 分层绘画 ↗ | 原生已有 | 仍使用原生画布、位图叠放、声音层、相机层，不计作新增 |
| 保留动画与工程基础 ↗ | 原生已有 | 关键帧、相机动画、透写基础、播放、PNG / 视频导出及 .pclx |
比较对象固定为项目使用的 Pencil2D v0.7.2。这里只把本分支实际实现的差异列为新增或改动。
套索填充：围到哪里，看到哪里
适合快速铺底色、画色块、填大形。快捷键 D。
三步就能用
- 选一个位图层，在颜色面板选好前景色。想保留线稿清晰，就把底色层放在线稿层下面。
- 按 D，按住鼠标或笔尖围出形状。线条会自动连回起点，包围的区域实时显色。
- 松开提交；没画好，在按住期间按 Esc 取消。已提交则用 Ctrl + Z 撤销。
预览和正式填色的区别
还按着：这是当前图层上的预览，可以取消。
已松开：颜色进入工程，可以保存、撤销和重做。
它是“画出一个填色形状”，不是选择已有像素的任意形状套索。
多一套笔刷，也留住原来的手感
原生笔刷继续使用；PS 式笔刷是独立加入的印章式绘画工具。
找到它
点工具箱的 PS 按钮，或「窗口 → PS 式笔刷 → 使用此笔刷」。默认没有占用快捷键，可以自行绑定。
- 大小
- 笔尖直径；0.10–2000，输入值支持 0.05 步进。
- 不透明度 / 流量
- 不透明度控制整笔的透明程度；流量控制每次笔尖叠加的颜料量。两者均为 0.10–100，步进 0.05。
- 硬度 / 间距
- 硬度调整边缘软硬；间距决定沿路径的笔尖疏密。
- 圆度 / 角度
- 把笔尖压扁、转向，适合做扁头或椭圆笔触。
- 压感控制大小 / 流量
- 勾选后由笔压影响对应参数。鼠标无法提供真实的力度变化。
把调好的手感存下来
- 先选原生铅笔、钢笔、笔刷、橡皮或 PS 式笔刷，调好参数。
- 打开「窗口 → 笔刷预设」，点 ＋，给它起个好记的名字。
- 以后单击预设就能恢复该工具与参数；选中后可重命名或用 − 删除。
- 轮盘也可以绑定这些预设，常用笔刷可以直接放到手边。
预设独立于工程保存，重启后仍可调用。缩略图帮助辨认笔尖，不保证与实际整条笔迹完全相同。
工具围在手边，选完继续画
快速点开，也可以按住 Tab 后用方向选。
方式 A · 打开后点击
快速按一下 Tab 再松开，轮盘留在画面上。单击一个圆钮，工具切换，轮盘收起。
适合慢慢看清工具后再选。
方式 B · 按住，松开确认
按住 Tab，先让光标碰到想选的圆钮，看到它凸起。继续留在它后方的同一扇区，松开 Tab 即选中。
不必回到圆钮上点一下；想点也可以。
什么情况下不会选中？
从没碰到圆钮就直接滑到远处、回到中心、跨出已激活的扇区、进入菜单 / 标题栏或窗口外，都会取消当前候选。按 Esc 或再按一次 Tab 可以收起。
把轮盘改成自己的顺序
- 交换位置：拖一个圆钮到另一个圆钮上，松开互换。拖到空隙或按 Esc 放弃换位，不会切工具。
- 换工具：右键圆钮，换绑工具或已保存的笔刷预设。
- 增减数量：「笔刷预设 → 设置」中配置 2–12 项、拖动列表排序，点“应用”保存；“取消”不改动。
- 回到初始布局：点“恢复默认”。1.0 默认六项；继承旧配置时可能保留以前的数量。
相机取景，现在有明确的工具
相机决定最终画面。相机层和基础相机动画原本就有，本版改的是入口、控制与反馈。
拖框内
按 C 或点小摄像机，进入相机层。拖动框内移动取景框。
拖四角方块
角上的小方块用于缩放。放大后的光标帮助你辨认命中的操作。
拖外侧圆角
外侧深灰括角悬停时发亮、变大。旋转箭头按角的方向与相机一起转。
相机操作支持撤销、重做和保存。做相机运动时，在相机层选好相应关键帧再调整取景；基础相机动画继续沿用 Pencil2D。
想让这一张多停一会儿？拖下一帧。
时间轴仍在绘画窗口里。它按关键帧和延续区工作，不是 PR 式视频片段剪辑器。
移动的实际规则
- 直接按住关键帧拖动，第一次按下就能拖。按住两关键帧之间的延续区域，会抓取它的起始关键帧。
- 拖动时看轮廓、目标帧号和偏移；到可视区域边缘会自动滚动。
- 松开落下。目标已有关键帧时变红，松开取消，不会覆盖或自动挤走它。
- 途中按 Esc 或切出窗口，可放弃这次移动。
成组调整与撤销
Ctrl 多选、Shift 连选、Alt 选择后续帧，以及空白处框选继续保留。选中后可一起拖。
移动一个关键帧不会自动把所有后续帧一起推走；要整组挪动，先选好那一组。
Ctrl + Z 撤销，Ctrl + Shift + Z 重做。绘画和移动按同一操作顺序回退，历史仍限 20 步。
两关键帧之间的延续区颜色更深；选中高亮与播放头可能覆盖基础配色。鼠标定位竖线只帮助对位置，移动鼠标不会改变当前播放帧。
需要前后帧时，点亮小灯泡
洋葱皮原本就有。本版把它收进时间轴旁的弹出面板，并加入自定义颜色与全局吸色。
打开与收起
点时间轴左侧图层按钮旁的小灯泡，设置在它上方浮出。点击面板外、Esc 或 × 收起；也可从「窗口」菜单调出。
按需要打开前、后帧
勾选前一帧 / 后一帧，设置显示数量；最小 / 最大不透明度控制远近帧的可见程度。保留“仅显示关键帧”和“在播放时显示”。
颜色，直接从软件里取
- 点前帧或后帧的色块，打开选色器；或点旁边的吸管。
- 在画布、色板、颜色面板或浮动模块上取色，松开确认。
- Esc 或右键取消。前后颜色各自保存，不会改动绘画前景色，也不会落下一笔。
短按留下，长按借用
正在画的时候，少一次切回工具，就少一次打断。
临时用一下抓手
正在用笔刷 → 按住 Space → 拖动画布 → 松开 Space → 回到笔刷。
超过约 0.2 秒的按住，或已经执行拖动，松开会恢复；短按则保留刚切换的工具。
键和笔先后松开都可以
若键先松开、笔还没抬起，会等本次拖动结束再恢复，避免多出笔迹。
输入文字或数值时不抢键。这里的短按 / 长按是工具逻辑，保存等普通命令不按此方式处理。
把按键改成顺手的
- 打开「编辑 → 首选项 → 快捷键」，单击要修改的一行。
- 需要清除时，双击快捷键或录入框。
- 直接按下想绑定的键或组合，全部松开后即设置。
- 发生冲突时只问一次。确认会移除其他功能的同一绑定；取消保留原来设置。
可以录入字母、数字、标点、单独 Alt / Ctrl / Shift，以及组合键。已经用来组成其他快捷键或参与滚轮操作的修饰键，不会在松开时再误触发一次。Windows 保留组合仍由系统优先处理。
| 用途 | 1.0 默认按键 | 用途 | 1.0 默认按键 |
|---|---|---|---|
| 套索填充 | D | 相机 | C |
| 抓手 | Space | 工具轮盘 | Tab |
| 原生笔刷 / 橡皮 | B / E | 铅笔 / 吸管 | N / I |
| 新建 / 复制关键帧 | F7 / F6 | 前 / 后一帧 | , / . |
| 保存 | Ctrl + S | 播放 / 停止 | Ctrl + Return |
| 撤销 | Ctrl + Z | 重做 | Ctrl + Shift + Z |
工作区的空间，留给当前任务
浅色是默认；深色用中性灰。所有面板仍跟随原生 Qt 工作区。
换主题
「编辑 → 首选项 → 通用 → 外观」选择浅色或深色。主窗口、时间轴、菜单、首选项与浮动面板立即切换，并保存到下次启动。
画面颜色不会随主题改变。笔刷预设列表在两种主题下都使用白纸底。
把时间轴拉高一点
拖动画布与时间轴的分隔边界调整高度；拖动面板标题栏可以浮动或重新停靠。点 × 关闭的面板，从「窗口」菜单重新打开。
PS 参数区不够高时可滚动，避免参数高度挤住时间轴。浮动、停靠和原生窗口菜单本来就有；新增面板接入同样规则。
所有界面都完全汉化了吗？
新增工具与说明优先使用中文，相机选项与状态栏补充了翻译；原生部分界面仍可能保留英文。当前不把“全覆盖汉化”列为已完成。
知道它会做什么，也知道它还没做什么
1.0 是首次内测的绘画扩展版，功能范围按实际代码与验证记录说明。
继续沿用的基础能力
无限画布、位图层叠放、声音层、相机层、原生关键帧时间轴、基础相机动画、工程保存和导出来自 Pencil2D。
保存格式沿用 .pclx；不自动转换 Storyboarder 工程。
移除了矢量绘画
矢量层、路径 / 曲线编辑与绘制、专用选项和相关读写均移除。位图直线 / 折线、相机和声音保留。
含矢量层的旧工程会被明确拒绝，不静默丢弃图层。用原版 Pencil2D 或 0.4 及更早版本打开。
这些暂时还没有
- 镜头文件夹、全局镜头时间轴、完整分镜项目系统
- 任意形状套索选择、模糊笔刷
- 尾帧停留 / 循环 / 往复轮盘
- 2D 内容补间与曲线编辑器
- GLB 三维导入与 2.5D 工作流
- ABR 和完整 Photoshop 笔刷兼容
关于顺畅与验证
轮盘文字、相机光标和时间轴底图使用缓存；套索预览局部刷新，移动关键帧不复制整幅画面。相应轮询或动画只在需要的交互期间活动。
1.0 的记录包含 58 个核心用例 / 699 条断言、100% 与 200% 缩放下各 256 项 Qt 检查，以及两套 PNG / MP4 导出与解码检查。这能帮助发现功能回归，但不能承诺所有工程绝不卡顿；实际数位板手感仍需要体验反馈。
给开发者反馈时，怎么说最有用？
写出版本号、正在用的工具、选中的图层与帧号、按下 / 松开的先后顺序，再说“希望发生什么，实际发生什么”。可附短录屏，不需要专业术语。
卡顿时补充画布大小、图层数、关键帧数、是否使用数位板以及 Windows 显示缩放比例。
这份手册依据什么整理
以保留的版本记录和当前实现为准，不把历史需求当作已完成功能。
- Pencil2D v0.7.2 上游源码 ↗本项目的固定比较基线。
- Pencil2D 官方使用手册 ↗核对原有画布、图层、时间轴、相机与面板能力。
- Pencil2D 0.7.2 发布记录 ↗不把上游已存在的改进算作本项目新增。
- Blender 窗口系统手册 ↗借鉴文档导航和图文组织思路；本文不是 Blender 官方手册。
本地依据：各版本 CHANGELOG-HANABI.md、VERSION-HISTORY.md、1.0 源码标签 hanabi-1.0 与随包验证记录。1.0 源码提交：8e49898589e2e18844f16eec2bcecb7f68e0b2a3。
HÁNABǏ Board 基于 Pencil2D，保留原作者版权与 GPL-2.0 授权。本手册中的界面图来自 1.0 控件渲染；历史版本页中的“怎么用”跳转到现行用法。
手册整理：2026-09-15 · 使用说明适用版本：1.0。