OpenKoma 是一个本地的漫画分镜编辑器，服务于快速把有图片拼成漫画页面，非常便于AIGC漫剧工作流。
如果你已经有角色图、背景图、对白素材，OpenKoma 的目标就是让你更快地完成漫画页面编排。
- 真正的斜切分镜：支持矩形、平行四边形、梯形，不只是旋转矩形。
- 非破坏裁剪：原图始终保留，显示效果只由裁剪参数驱动。
- 裁剪形状跟随分镜：手动裁剪框会对齐当前分镜的真实几何形状。
- 透明图片支持：本地 PNG / WebP / GIF / SVG / AVIF 的透明通道可保留显示。
- 多页面工作流：支持新增页面、页面排序，并按页面顺序导出 PDF。
- 本地优先存储：支持目录模式保存，也支持单文件
.openkoma.json导入导出。 - 增量撤销重做：编辑历史基于 JSON Patch 记录，适合高频迭代调整。
- 文字气泡系统：支持矩形、圆角、圆形气泡，支持横排/竖排文字与边框样式调整。
- 新建默认分镜
- 整页网格切割
- 选中单个分镜后二次切割
- 手绘拖拽创建分镜
- 分镜旋转与 5° 吸附
- 分镜四角斜切控制，支持向内/向外拖出梯形或平行四边形
- 分镜四边中点手柄，可单独推动某一条边
- 支持批量设置所有分镜的圆角和边框粗细
- 可选 16 倍数尺寸吸附，方便适配下游图像工作流
- 仅支持导入本地图片作为分镜素材
- 图片以等比
cover方式贴合分镜，避免拉伸变形 - 支持透明图片直接显示
- 非破坏裁剪：随时重新进入裁剪状态，不会改写原图
- 手动裁剪框会匹配分镜真实形状，而不是简单矩形
- 当分镜尺寸或比例变化时，裁剪参数会尽量自动重算以保持画面中心
- 新增文字对象
- 支持矩形、圆角、圆形气泡
- 背景可设为透明或纯白
- 可调边框粗细、边框颜色、字体、字号
- 支持横排与竖排文字
- 文字通过 Konva 直接渲染，导出时不会丢失
- 多页面侧栏管理
- 页面新增、删除、上下移动
- PNG 导出当前页
- PDF 按页面顺序导出整套内容
- 导出时会自动隐藏当前选中的蓝色编辑框
- 撤销 / 重做
- 键盘快捷键：
Cmd/Ctrl + Z、Cmd/Ctrl + Shift + Z、Ctrl + Y - 亮色 / 暗色主题切换
- 页面缩略预览
- 本地消息历史与状态提示
- Node.js 18+
- npm 9+
npm installnpm run dev默认地址：http://localhost:5173
下面这份路线图按“已经完成的里程碑”和“接下来要补强的方向”来整理，能更准确反映项目真实演进，而不是只列一个愿望清单。
- 建立 React + TypeScript + Zustand + Konva 的前端编辑器架构
- 完成基础画布、分镜对象、选中态、属性检查器
- 完成项目级状态管理与基础交互闭环
- 支持为分镜导入本地图片
- 建立
panel.image.original + panel.image.crop的非破坏模型 - 图片显示改为等比
cover，避免粗暴拉伸 - 手动裁剪从“重画框”演进为“直接编辑裁剪框”
- 完成撤销 / 重做
- 从整份快照历史演进到 JSON Patch 增量历史
- 支持 PNG 导出与 PDF 导出
- 导出渲染与画布编辑渲染逐步对齐
- 数据模型从单页扩展为多页
- 新增页面侧栏、缩略预览、页面排序
- PDF 导出支持按页面顺序输出
- 工具栏、检查器、导出逻辑全面切换到“当前活动页”语义
- 分镜从普通矩形升级到真正的斜切形状
- 支持平行四边形 / 梯形，而不是只靠旋转假装斜切
- 四角手柄、边中点手柄逐步完善，支持更直接地编辑真实边界
- 手动裁剪框与分镜几何形状对齐，修正了多轮尺寸偏差与渲染误差问题
- 修复透明图片场景下的命中区域问题，保证导入透明素材后仍可正常点选分镜
- “对象”能力收敛成更聚焦的“文字”能力
- 支持矩形、圆角、圆形气泡与横排 / 竖排文字
- 支持透明底与纯白底气泡
- 移除外部 AI 服务、内置 server 与远端接口依赖
- 项目重新收束为纯本地漫画分镜编辑器
OpenKoma 目前尤其适合：
- 已经有素材，想快速排成漫画页面的创作者
- 需要大量调整分镜形状和裁剪结果的漫画 / 条漫工作流
- 希望项目文件完全保留在本地的个人创作环境
- 想要一个足够轻、但比普通图片拼版工具更懂“分镜几何”的编辑器
Apache License 2.0，详见 LICENSE。