Repository navigation
Home
hyz0719 edited this page Sep 24, 2026
·
3 revisions
用图形化积木编排带 2D/3D 动画的演示——"Scratch 的手感 + PPT 的舞台"。
拖积木定义演示流程,一键全屏放映,还能导出单文件网页放映包发给任何人。

积木剧场(Jimuchang)是一款本地运行的桌面演示工具,它把两件事合在了一起:
- 演示文稿的舞台表现力——像 PPT 一样所见即所得地摆放文字、图片、图表,像专业动效工具一样做转场和动画;
- 图形化编程的流程控制力——像 Scratch 一样拖积木,用"当演示开始 → 切换场景 → 标题淡入 → 等待 → 播放粒子"这样的积木序列,定义整场演示的剧本。
适合课堂展示、项目路演、比赛答辩、教学演示等任何"想说清楚一件事"的场合。
| 理念 | 含义 |
|---|---|
| 积木即时间轴 | 不做剪辑软件式时间轴,流程顺序 = 积木顺序,"动画播完再继续"是默认语义 |
| 三层动画体系 | 元素预设入场(简单)→ 积木命令(灵活)→ 关键帧动画(自由),按需选用 |
| 单文件项目 |
.bdp 内打包全部素材,换电脑、发微信不丢资源 |
| 完全离线 | 零网络依赖、零外部服务,所有资源内置 |
| AI 可操控 | 开放本地接口,AI 助手可直接生成、修改、截图自检演示 |
文字(双击直改、全字体控制)· 图片 · 视频 · 音频(背景音乐/音效)· 形状(矩形/圆/椭圆/三角/箭头/直线)· emoji 图标 · 图表(柱状/折线/饼/环形,属性面板填数据)· 帧动画(雪碧图/序列帧)· 3D 模型(骨骼动画、镜头环绕、灯光预设)· 网页小程序(嵌入 HTML 并与积木互发消息)
| 分类 | 能力 |
|---|---|
| 事件 | 当演示开始 / 进入场景 / 按键 / 点击元素 / 收到小程序消息 |
| 场景 | 切换场景 / 下一场景 / 设置转场 |
| 元素 | 显示隐藏 / 改文字 / 移动 / 大小 / 颜色 |
| 动画 | 20 种动画(时长/延迟/缓动可调)/ 关键帧动画 / 等待 |
| 媒体 | 音效 / 背景音乐(淡入淡出)/ 视频控制 / 帧动画控制 / 刷新图表 |
| 特效 | 粒子爆发(星尘/彩带/爱心/花瓣) |
| 3D | 镜头预设 / 环绕 / 推拉 / 骨骼动画 / 灯光 / 自动旋转 |
| 高级 | 执行 JS 代码(jimu API)/ 小程序消息 |
| 内置 | 如果 / 重复 / 比较 / 运算 / 变量 / 函数(含返回值) |
- 20 种动画:淡入淡出、四方向飞入飞出、缩放、旋转、弹跳、翻转、打字机、脉冲、抖动、摇摆、呼吸、光晕…配 12 条缓动曲线
- 关键帧动画编辑器:X/Y/缩放/旋转/透明度 5 条属性轨道,打点补间、逐点缓动、试播预览
- 场景转场(8 种):淡入淡出 / 四方向推入 / 缩放 / 擦除 / 光圈展开
- 特效库:元素光效(光晕/霓虹/扫光/故障)+ 场景背景(星空/飘雪/漂浮微粒/极光)+ 粒子爆发
- 全屏放映:空格推进、←→ 切场景、Esc 退出;点击元素/按键可触发互动
- 放映细节:光标自动隐藏、提示自动淡出、进度感自然
- 导出放映包:一键生成单个 HTML 文件,浏览器双击即放、可交互、无需安装——发给老师同学就能看
程序运行时自动开启本地接口(127.0.0.1:17800),配套 MCP 服务器(23 个工具),AI 助手(opencode / Codex 等)可以:
你:用积木剧场做个介绍太阳系的演示 AI:(建场景 → 放元素 → 写积木脚本 → 截图自检 → 导出放映包)完成 ✅
| 3D 模型与骨骼动画 | 图表与特效 |
|---|---|
![]() |
![]() |
| 内置帮助页 | 浅色主题 |
|---|---|
![]() |
![]() |
界面为三栏布局:左侧积木工作区(含分类工具箱)· 右侧舞台预览与属性面板 · 底部关键帧轨道编辑器(按需弹出)。深色/浅色主题一键切换。
- Qt 6.5+(Widgets / WebEngineWidgets / WebChannel / HttpServer / WebSockets)
- CMake 3.16+、C++17 编译器(GCC 12 实测通过)
- 前端依赖已内置(Blockly / Three.js / ECharts / JSZip),无需 npm
git clone https://github.com/YanZhen-Huang/jimuchang.git
cd jimuchang
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(nproc)
./build/jimuchang- 点「示例」加载内置演示 → 点「▶ 播放」全屏看效果
- 自己做:拖积木编排流程 + 工具栏「+」添加元素 + 属性面板调细节
-
Ctrl+S存成.bdp;「更多 → 导出放映包」生成可分享的 HTML
| 文档 | 内容 |
|---|---|
| 使用文档 | 10 章完整手册:上手 / 元素 / 动画 / 积木 / 分享 / AI / FAQ |
| 技术文档 | 项目"宪法":数据模型 / 积木字典 / IR 指令集 / API 设计 |
| 开发报告 | P0~P7 各阶段验证与实现记录 |
| 层 | 技术 |
|---|---|
| 外壳 | Qt 6 C++(WebEngine 壳 + 文件/全屏桥 + QHttpServer API) |
| 积木 | Google Blockly 13 + 自定义中文积木 + 积木编译为 IR 指令 |
| 舞台 | HTML/CSS + Web Animations API(2D) |
| 3D | Three.js 0.186(GLTF 加载、骨骼动画、相机补间) |
| 图表 | ECharts 6 |
| 项目文件 | JSZip 打包的 .bdp(zip:项目 JSON + 素材) |
| 发布形态 | 全部资源经 qrc 编译进单个可执行文件,运行时零外部依赖 |
| 阶段 | 内容 |
|---|---|
| P0 | 技术验证:WebEngine / Blockly / 视频 / 截图能力 |
| P1 | 核心闭环:编辑器 / 积木 / 播放 / 项目存取 |
| P2 | 媒体与特效:音视频 / 图表 / 帧动画 / 特效库 / 撤销重做 |
| P3 | 关键帧动画编辑器 |
| P4 | 3D 子系统 + 自制程序(JS API / 小程序 / 函数积木) |
| P5 | AI 接口(HTTP API + MCP 服务器) |
| P6 | 导出单文件放映包 |
| P7 | 三轮打磨:辅助线 / 帮助页 / 浅色主题 / 右键菜单 / 性能优化 |
MIT License © 2026 YanZhen-Huang



