Vecmo

Vecmo

一款基于浏览器的矢量动态编辑器，可导出无依赖的运行时代码。

• 将动态效果导出为代码，而非视频：自包含的 JS 运行时，附带类型化的 .d.ts，而不是渲染后的视频片段。
• 原生支持 Agent：采用类型化的场景／动态文档，提供 vmactl 用于无头／实时命令操作，并有 26 个 MCP 工具，让 Agent 能够读取和编辑项目。
• GPU Look Graph 效果（颗粒、半色调、risograph、CRT、VHS、镜头）可导出为 .dctl 文件，供 DaVinci Resolve Studio 18+ 使用。

快速开始

bun install && bun run dev

/ 可打开编辑器。编辑器完全在浏览器中运行：以本地为先，此版本中的任何内容都不会与服务端通信。

检查：bun run check。构建：bun run build。此仓库未附带测试套件（参见 CONTRIBUTING.md）。

试用

1. 运行 bun run dev，然后打开 /?ref=hello-motion。
2. 选择“导出” → 动态 / 代码 → 嵌入（“动态产物”，自包含的可嵌入产物）。
3. 解压下载文件：其中包含 hello-motion.runtime.js、对应的 .d.ts、一个清单和一个演示 HTML 页面。

其他参考场景可通过 /?ref=<slug> 访问；完整列表参见 src/features/reference-scenes/model/registry.ts。

无需 GUI 的无头操作：bun run export:motion-artifact -- --ref hello-motion --out ./out 会写入相同的四个文件（结果确定；--commands plan.json 会先应用 Agent 编辑计划，--dump-documents 会为 MCP 工具输出原始场景／动态 JSON）。

示例使用方

vecmo-example — 在线地址：https://vecmo-example.pages.dev — 是一个无关的 Vite 网站，运行时只导入导出的文件（不包含 Vecmo 源码，也不使用 SDK）：以 WebGL Look Graph 作品作为主视觉、由滚动驱动的 seekProgress、调色板换肤、实测的尺寸梯度（49.8 KB / 118 KB / 198 KB gzip）、Lighthouse 桌面端 0.98／移动端 0.91、零泄漏的挂载／销毁探测，以及一轮真实的 MCP 编辑 → CLI 重新导出流程。

导出大小（实测，gzip -9）

场景	配置	大小
hello-motion	EMBED（动态产物）	48.2 KB
效果密集型参考场景（颗粒、遮罩、动态语法）	EMBED（动态产物）	115–152 KB

复现方法：bun run export:motion-artifact -- --ref <slug> --out ./out（会输出原始／gzip 字节数和层级），或者运行 bun run dev → 打开 /?ref=<slug> → 导出 → EMBED → 对压缩包内的 <slug>.runtime.js 使用 gzip。

其他导出目标：WebGL 播放器、PDF、WebM、SVG 和 DCTL（导出 DaVinci Resolve 外观）。

MCP

将仓库的 .mcp.json 添加到 Claude Code 或 Cursor；它会启动 bun run mcp:agent（scripts/vma-agent-mcp.ts）作为本地 stdio 服务，通过类型化的场景／动态文档提供 26 个工具，例如 observe_document、apply_scene_commands 和 export_artboard。对于无头或脚本化操作，bun run vmactl 无需 MCP 客户端即可直接使用相同的命令封装。完整命令参考见 docs/agent-command-catalog.md，本地中继上的实时编辑操作指南见 docs/live-mcp-agent-runbook.md（运行 bun run agent:bridge）。

范围

此仓库包含编辑器：编辑器完全在浏览器中运行，此处的任何内容都不会与服务端通信。vecmo.dev 托管服务（账户、云端项目、账单）属于独立的私有后端，不包含在内。

架构

从 docs/architecture.md 开始了解职责分层（app -> pages -> widgets -> features -> entities -> shared），并参阅 docs/codemap.md 了解各子系统的位置。

参与贡献

参见 CONTRIBUTING.md。

许可证

编辑器采用 AGPL-3.0-only。开发者层（Agent/CLI 工具包、运行时播放器控制/清单代码，以及 packages/editor-kernel）采用 MIT 许可证；确切的文件列表请参阅 REUSE.toml。你导出的所有内容——运行时 JS、WebGL 播放器、它们的 .d.ts 文件，以及场景/动作/备份文档——均附带额外的 AGPL §7 许可（Vecmo Runtime Output Exception），因此你可以将导出产物嵌入专有网站，无须为此回馈任何内容。详情请参阅：LICENSING.md。