Skip to content
hyz0719 edited this page Sep 24, 2026 · 3 revisions

积木剧场 · 简介

用图形化积木编排带 2D/3D 动画的演示——"Scratch 的手感 + PPT 的舞台"。

拖积木定义演示流程,一键全屏放映,还能导出单文件网页放映包发给任何人。

编辑界面 · 右键菜单


这是什么

积木剧场(Jimuchang)是一款本地运行的桌面演示工具,它把两件事合在了一起:

  • 演示文稿的舞台表现力——像 PPT 一样所见即所得地摆放文字、图片、图表,像专业动效工具一样做转场和动画;
  • 图形化编程的流程控制力——像 Scratch 一样拖积木,用"当演示开始 → 切换场景 → 标题淡入 → 等待 → 播放粒子"这样的积木序列,定义整场演示的剧本。

适合课堂展示、项目路演、比赛答辩、教学演示等任何"想说清楚一件事"的场合。

设计理念

理念 含义
积木即时间轴 不做剪辑软件式时间轴,流程顺序 = 积木顺序,"动画播完再继续"是默认语义
三层动画体系 元素预设入场(简单)→ 积木命令(灵活)→ 关键帧动画(自由),按需选用
单文件项目 .bdp 内打包全部素材,换电脑、发微信不丢资源
完全离线 零网络依赖、零外部服务,所有资源内置
AI 可操控 开放本地接口,AI 助手可直接生成、修改、截图自检演示

能做什么

🎬 演示元素(10 种)

文字(双击直改、全字体控制)· 图片 · 视频 · 音频(背景音乐/音效)· 形状(矩形/圆/椭圆/三角/箭头/直线)· emoji 图标 · 图表(柱状/折线/饼/环形,属性面板填数据)· 帧动画(雪碧图/序列帧)· 3D 模型(骨骼动画、镜头环绕、灯光预设)· 网页小程序(嵌入 HTML 并与积木互发消息)

🧩 积木体系(37 块中文积木)

分类 能力
事件 当演示开始 / 进入场景 / 按键 / 点击元素 / 收到小程序消息
场景 切换场景 / 下一场景 / 设置转场
元素 显示隐藏 / 改文字 / 移动 / 大小 / 颜色
动画 20 种动画(时长/延迟/缓动可调)/ 关键帧动画 / 等待
媒体 音效 / 背景音乐(淡入淡出)/ 视频控制 / 帧动画控制 / 刷新图表
特效 粒子爆发(星尘/彩带/爱心/花瓣)
3D 镜头预设 / 环绕 / 推拉 / 骨骼动画 / 灯光 / 自动旋转
高级 执行 JS 代码(jimu API)/ 小程序消息
内置 如果 / 重复 / 比较 / 运算 / 变量 / 函数(含返回值)

✨ 动画与特效

  • 20 种动画:淡入淡出、四方向飞入飞出、缩放、旋转、弹跳、翻转、打字机、脉冲、抖动、摇摆、呼吸、光晕…配 12 条缓动曲线
  • 关键帧动画编辑器:X/Y/缩放/旋转/透明度 5 条属性轨道,打点补间、逐点缓动、试播预览
  • 场景转场(8 种):淡入淡出 / 四方向推入 / 缩放 / 擦除 / 光圈展开
  • 特效库:元素光效(光晕/霓虹/扫光/故障)+ 场景背景(星空/飘雪/漂浮微粒/极光)+ 粒子爆发

🖥 放映与分享

  • 全屏放映:空格推进、←→ 切场景、Esc 退出;点击元素/按键可触发互动
  • 放映细节:光标自动隐藏、提示自动淡出、进度感自然
  • 导出放映包:一键生成单个 HTML 文件,浏览器双击即放、可交互、无需安装——发给老师同学就能看

🤖 AI 接口(特色)

程序运行时自动开启本地接口(127.0.0.1:17800),配套 MCP 服务器(23 个工具),AI 助手(opencode / Codex 等)可以:

你:用积木剧场做个介绍太阳系的演示 AI:(建场景 → 放元素 → 写积木脚本 → 截图自检 → 导出放映包)完成 ✅


界面导览

3D 模型与骨骼动画 图表与特效
3D charts
内置帮助页 浅色主题
help light

界面为三栏布局:左侧积木工作区(含分类工具箱)· 右侧舞台预览与属性面板 · 底部关键帧轨道编辑器(按需弹出)。深色/浅色主题一键切换。


快速开始

环境要求

  • 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

三步上手

  1. 点「示例」加载内置演示 → 点「▶ 播放」全屏看效果
  2. 自己做:拖积木编排流程 + 工具栏「+」添加元素 + 属性面板调细节
  3. 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